Documentaciónlistar_con_patron(wildcard)

listar_con_patron(wildcard)\texttt{listar\_con\_patron}(wildcard)

Nombre

listar_con_patron - Busca archivos en la carpeta actual que coincidan con un patron.

Sinopsis

ret = archivos.listar_con_patron(wildcard)

Descripcion

Busca archivos en la carpeta actual que coincidan con un patron (wildcard) y retorna la lista de nombres encontrados junto con la cantidad total.

Que hace: Recibe un patron compatible con comodines, por ejemplo "*.dat", "*.txt" o "datos_*.csv", lista los archivos que coinciden dentro del directorio de ejecucion y devuelve una TABLA con:

  • cant: cantidad de archivos encontrados
  • lista: vector de STRING con los nombres de archivos

Para que puede usarse:

  • Buscar familias de archivos por prefijo o sufijo.
  • Recorrer archivos de datos antes de procesarlos.
  • Implementar seleccion simple por patron.

Comportamiento

  • Acepta los comodines "*" y "?".
  • Usa LISTAR_ARCHIVOS() sobre el directorio actual.
  • Retorna {cant = ..., lista = ...}.

Funciones API relacionadas

  • archivos.listar_con_extension()
  • archivos.buscar_en_archivo()

Parámetros

ParámetroTipoDescripción
wildcardSTRINGPatron de busqueda. Admite los comodines "*" (cualquier secuencia) y "?" (un caracter).

Valor de retorno

TABLA - {cant = <NUMERICO>, lista = <VECTOR STRING>}.

Ejemplo

ejemplo.blox
// ---  Lee el directorio filtrando el wildcard <patron>
//
// 		ret = archivos.listar_con_paton(patron)
//
// 		ret es una tabla con 2 campos
// 		<cant>	    total de archivos con wilcard <patron>
// 		<lista> 	un vectorstr donde se copiaron las lineas de archivos 
//					con wilcard <patron>
//


INCLUIR "archivos.api"

FUNCION PRINCIPAL
INICIO

	STRING lista[], patron
	NUMERICO  cant, i
	TABLA ret


	patron = "aa*.txt"
	ret = archivos.listar_con_patron(patron)

	i = 1
	MIENTRAS (i < ret[1].cant) HACER
		IMPRIMIR("- ", ret[1].lista[i])
		IMPRIMIR("\n")
		i = i + 1
	FIN_MIENTRAS

FINAL