E/S Estándar

Todos los procesos disponen de canales de entrada y salida por defecto, sin necesidad de crearlos explícitamente.

Funciones

• Utiliza bstd_printf para escribir texto en las salida estándar.
• Utiliza bstd_read para leer bytes desde la entrada estándar.

Cada proceso en ejecución tiene tres canales de comunicación estándar:

• stdin: entrada de datos. El proceso leerá datos que le llegan desde el exterior.
• stdout: salida de datos. El proceso escribirá resultados en este canal.
• stderr: salida de errores. El proceso escribirá en este canal información referente a errores.

Es como tener tres archivos perpetuamente abiertos donde el programa puede leer y escribir sin límites. Cuando ejecutamos un proceso desde la Consola o el Terminal, stdin se conecta automáticamente al teclado y stdout/stderr a la pantalla (Figura 1). No obstante, estos canales estándar se pueden redirigir para usar archivos como fuentes de entrada o destinos de salida:

1
2
3

dir > out.txt
ls > out.txt
sort < out.txt

En este fragmento de código, el resultado del comando dir (ls en Unix) se ha redirigido al archivo out.txt, por lo que no veremos nada por pantalla. Por otro lado, el comando sort no espera la entrada del usuario por el teclado. Simplemente la toma del archivo out.txt, ordenando sus líneas. Por tanto, siempre que escribamos aplicaciones en línea de comandos, deberemos utilizar convenientemente estos canales estándar sin hacer presunciones desde donde viene o hacia donde va la información tratada por la aplicación.

bstd_sprintf ()

Escribe una cadena con formato del printf en un búfer de memoria.

uint32_t
bstd_sprintf(char_t *str,
             const uint32_t size,
             const char_t *format,
             ...);

Retorna

El número de bytes escritos, sin incluir el carácter nulo '\0'.

Observaciones

Es una función segura y no escribirá más de size bytes. Para obtener el tamaño necesario de str, llamar a esta función con str=NULL y size=0.

bstd_vsprintf ()

Igual que bstd_sprintf pero con la lista de argumentos ya resuelta.

uint32_t
bstd_vsprintf(char_t *str,
              const uint32_t size,
              const char_t *format,
              va_list args);

Retorna

El número de bytes escritos, sin incluir el carácter nulo '\0'.

Observaciones

Es una función segura y no escribirá más de size bytes.

bstd_printf ()

Escribe una cadena con formato en la salida estándar (stdout). Es equivalente a la función printf de la librería estándar.

uint32_t
bstd_printf(const char_t *format,
            ...);

Retorna

El número de bytes escritos en stdout.

bstd_eprintf ()

Escribe una cadena con formato en la salida de error (stderr).

uint32_t
bstd_eprintf(const char_t *format,
             ...);

Retorna

El número de bytes escritos en stderr.

bstd_writef ()

Escribe una cadena C UTF 8 en la salida estándar (stdout).

uint32_t
bstd_writef(const char_t *str);

Retorna

El número de bytes escritos en stdout.

bstd_ewritef ()

Escribe una cadena C UTF 8 en la salida de error (stderr).

uint32_t
bstd_ewritef(const char_t *str);

Retorna

El número de bytes escritos en stderr.

bstd_read ()

Lee datos desde la entrada estándar stdin.

bool_t
bstd_read(byte_t *data,
          const uint32_t size,
          uint32_t *rsize);

Retorna

TRUE si se han leído datos. FALSE si ha ocurrido algún error.

Observaciones

Standard stream implementa funciones de alto nivel para lectura/escritura en canales estándar.

bstd_write ()

Escribe datos en la salida estándar stdout.

bool_t
bstd_write(const byte_t *data,
           const uint32_t size,
           uint32_t *wsize);

Retorna

TRUE si se han escrito datos. FALSE si ha ocurrido algún error.

Observaciones

Standard stream implementa funciones de alto nivel para lectura/escritura en canales estándar.

bstd_ewrite ()

Escribe datos en la salida de error stderr.

bool_t
bstd_ewrite(const byte_t *data,
            const uint32_t size,
            uint32_t *wsize);

Retorna

TRUE si se han escrito datos. FALSE si ha ocurrido algún error.

Observaciones

Standard stream implementa funciones de alto nivel para lectura/escritura en canales estándar.

bstd_abort ()

Termina de forma abrupta la ejecución del programa.

void
bstd_abort(void);

Observaciones

No se liberan recursos ni se realiza un cierre controlado. El único caso donde se justifica su uso es salir del programa tras detectar un error irrecuperable (p.e NULL pointer).

bstd_debug_break ()

Detiene la ejecución del programa en el punto donde se encuentra la función y devuelve el control de depurador para que podamos inspeccionar la pila, variables, etc.

void
bstd_debug_break(void);