Cuando trabajamos con secuencias de datos en Zig, a menudo necesitamos localizar la posición de un elemento que pertenezca a un conjunto de posibles valores. La función std.mem.indexOfAny simplifica este escenario al devolver la posición del primer elemento de una cadena (o slice) que coincida con cualquiera de los valores proporcionados. En este artículo exploraremos su firma, parámetros, casos de uso típicos y algunos consejos de rendimiento.
¿Qué es std.mem.indexOfAny?
std.mem.indexOfAny es una función genérica de la biblioteca estándar de Zig que permite buscar la primera aparición de cualquier valor de un conjunto dentro de una secuencia. Su firma general es:
pub fn indexOfAny(comptime T: type, slice: []const T, targets: []const T) ?usize
– T: tipo de los elementos de la secuencia (p. ej., u8, i32).
– slice: la secuencia donde se realizará la búsqueda.
– targets: la lista de valores a buscar.
– ?usize: el índice (desde 0) del primer elemento encontrado o null si ninguno coincide.
Parámetros y valor de retorno
- slice: Slice de tipo
Tque contiene los datos a inspeccionar. - targets: Slice de tipo
Tcon los posibles valores a comparar. - Retorno: Un
?usize; si la búsqueda es exitosa, devuelve la posición del primer coincidencia; de lo contrario, devuelvenull.
Ejemplo práctico: buscar vocales en una cadena
Supongamos que queremos localizar la primera vocal en una cadena.
const std = @import("std");
// El texto donde haremos la búsqueda
const texto = "¡Hola, Zig! ¿Cómo estás?";
// Conjunto de vocales a buscar (tanto minúsculas como mayúsculas)
const vocales = "aeiouAEIOU";
// Usamos std.mem.indexOfAny para encontrar la posición de la primera vocal
const indice = std.mem.indexOfAny(u8, texto, vocales);
// Mostrar el resultado en consola
if (indice) |pos| {
// Si se encontró una vocal, imprimimos su posición y carácter
std.debug.print("Primera vocal en posición {d}: '{c}'\n", .{ pos, texto[pos] });
} else {
// Si no se encontró ninguna vocal
std.debug.print("No se encontraron vocales en el texto.\n", .{});
}
Comentarios línea por línea:
const std = @import("std");– Importamos el módulo estándar.const texto = "¡Hola, Zig! ¿Cómo estás?";– Declaramos la cadena a analizar.const vocales = "aeiouAEIOU";– Creamos un slice que contiene todas las vocales.const indice = std.mem.indexOfAny(u8, texto, vocales);– Llamada a la función: buscamos cualquier carácter devocalesentexto.if (indice) |pos| { ... }– Manejo del valor opcional. Siindiceesnull, el bloqueelsese ejecutará.std.debug.print("Primera vocal en posición {d}: '{c}'\n", .{ pos, texto[pos] });– Imprimimos la posición y el carácter encontrado.std.debug.print("No se encontraron vocales en el texto.\n", .{});– Mensaje alternativo cuando no hay coincidencias.
Uso con tipos distintos al de bytes
La función es genérica y puede emplearse con cualquier tipo, por ejemplo, con enteros.
const std = @import("std");
// Slice de números enteros
const numeros = &[_]i32{ 3, 7, 12, 5, 9 };
// Conjunto de valores que buscamos
const objetivo = &[_]i32{ 5, 9 };
// Buscar el primer número que
