Documentaciónlistar_con_extension(ext)

listar_con_extension(ext)\texttt{listar\_con\_extension}(ext)

Nombre

listar_con_extension - Lista los archivos de la carpeta actual que coinciden con una extension dada.

Sinopsis

ret = archivos.listar_con_extension(ext)

Descripcion

Lista los archivos de la carpeta actual que coinciden con una extension dada (patron "*." + ext) y retorna la lista junto con la cantidad encontrada.

Que hace: Construye el patron "*." + ext, llama a LISTAR_ARCHIVOS() para llenar el vector archivos con los nombres encontrados y retorna una TABLA con:

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

Para que puede usarse:

  • Enumerar archivos por tipo.
  • Automatizar procesos por lote.
  • Mostrar contenido disponible para que el usuario elija un archivo.

Comportamiento

  • Construye un patron del tipo "*." + ext.
  • Usa LISTAR_ARCHIVOS() para obtener coincidencias.
  • Retorna {cant = ..., lista = ...}.

Funciones API relacionadas

  • archivos.listar_con_patron()
  • archivos.buscar_en_archivo()

Parámetros

ParámetroTipoDescripción
extSTRINGExtension a filtrar, sin el punto. Ejemplo: "txt", "png", "api".

Valor de retorno

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

Ejemplo

ejemplo.blox
INCLUIR "archivos.api"

FUNCION PRINCIPAL
INICIO

	STRING    lista[100], ext
	NUMERICO  cant, i
	TABLA ret


	ext   = "txt"
	ret   = archivos.listar_con_extension(ext)
    cant  = ret.cant 
    lista = ret.lista

    DEPURAR(lista)

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


FINAL```