Documentaciónarchivo_a_str(archivo)

archivo_a_str(archivo)\texttt{archivo\_a\_str}(archivo)

Nombre

archivo_a_str - Lee un archivo completo y retorna su contenido como un unico STRING.

Sinopsis

todo = archivos.archivo_a_str(archivo)

Descripcion

Lee un archivo completo y retorna su contenido como un unico STRING.

Que hace: Abre el archivo en modo lectura (r). Si la apertura es exitosa, lee el archivo completo y retorna su contenido. Si no puede abrir el archivo, informa el problema y retorna un string vacio.

Para que puede usarse:

  • Cargar templates, prompts, configuraciones o textos grandes.
  • Leer un archivo json, csv o de codigo para luego parsearlo o procesarlo.
  • Comparar contenido, buscar patrones o enviar el texto a otras funciones.

Comportamiento

  • Abre el archivo en lectura.
  • Usa LEER_TODO() para obtener el contenido completo.
  • Cierra el archivo si la apertura fue exitosa.
  • Retorna un STRING con el contenido o vacio en caso de error.

Funciones API relacionadas

  • archivos.archivo_a_vectorstr()
  • archivos.archivo_a_vector()
  • archivos.str_a_archivo()
  • archivos.buscar_en_archivo()

Parámetros

ParámetroTipoDescripción
archivoSTRINGNombre o ruta del archivo a leer.

Valor de retorno

STRING - Contenido completo del archivo.

Ejemplo

ejemplo.blox

INCLUIR "archivos.api"
INCLUIR "tablas.api"
INCLUIR "strings.api"

FUNCION leer_archivo(archivo)

FUNCION PRINCIPAL INICIO
    
    STRING arch
    TABLA tabla
    NUMERICO cant

    arch = archivos.archivo_a_str("_____comandos.json")

    JSON_A_TABLA(arch, tabla)
    cant = tabla.dim
    IMPRIMIR("\nSon ", cant:0, "registros...\n")

    tablas.imprimir(tabla)

FINAL