Commons Library  1.7.0
Estructuras de datos | Enumeraciones | Funciones
Referencia del Archivo log.h

#include <commons/log.h> Más...

Ir al código fuente de este archivo.

Estructuras de datos

struct  t_log
 Manejo de logs. Inicializar con log_create() Más...
 

Enumeraciones

enum  t_log_level {
  LOG_LEVEL_TRACE , LOG_LEVEL_DEBUG , LOG_LEVEL_INFO , LOG_LEVEL_WARNING ,
  LOG_LEVEL_ERROR
}
 

Funciones

t_loglog_create (char *file, char *process_name, bool is_active_console, t_log_level level)
 Crea una instancia de logger. Más...
 
void log_destroy (t_log *logger)
 Destruye una instancia de logger. Más...
 
void log_trace (t_log *logger, const char *message,...)
 Loguea un mensaje con el siguiente formato [TRACE] hh:mm:ss:mmmm PROCESS_NAME/(PID:TID): MESSAGE Más...
 
void log_debug (t_log *logger, const char *message,...)
 Loguea un mensaje con el siguiente formato [DEBUG] hh:mm:ss:mmmm PROCESS_NAME/(PID:TID): MESSAGE Más...
 
void log_info (t_log *logger, const char *message,...)
 Loguea un mensaje con el siguiente formato [INFO] hh:mm:ss:mmmm PROCESS_NAME/(PID:TID): MESSAGE Más...
 
void log_warning (t_log *logger, const char *message,...)
 Loguea un mensaje con el siguiente formato [WARNING] hh:mm:ss:mmmm PROCESS_NAME/(PID:TID): MESSAGE Más...
 
void log_error (t_log *logger, const char *message,...)
 Loguea un mensaje con el siguiente formato [ERROR] hh:mm:ss:mmmm PROCESS_NAME/(PID:TID): MESSAGE Más...
 
char * log_level_as_string (t_log_level level)
 Convierte un t_log_level a su representacion en string. Más...
 
t_log_level log_level_from_string (char *level)
 Convierte un string a su representacion en t_log_level. Más...
 

Descripción detallada

#include <commons/log.h>

Documentación de las enumeraciones

◆ t_log_level

Valores de enumeraciones
LOG_LEVEL_TRACE 

Loguea todos los mensajes.

LOG_LEVEL_DEBUG 

Loguea solo mensajes de log_debug en adelante.

LOG_LEVEL_INFO 

Loguea solo mensajes de log_info en adelante.

LOG_LEVEL_WARNING 

Loguea solo mensajes de log_warning en adelante.

LOG_LEVEL_ERROR 

Loguea solo mensajes de log_error.

Documentación de las funciones

◆ log_create()

t_log* log_create ( char *  file,
char *  process_name,
bool  is_active_console,
t_log_level  level 
)

Crea una instancia de logger.

Parámetros
fileLa ruta hacia el archivo donde se van a generar los logs
process_nameEl nombre a ser mostrado en los logs
is_active_consoleSi lo que se loguea debe mostrarse por consola
levelEl nivel de detalle máximo a loguear (ver definición de t_log_level)
Devuelve
Retorna una instancia de logger, o NULL en caso de error. Debe ser liberada con log_destroy()
Nota
Se debe tener en cuenta que:
  • si file ya existe, se escribirá al final del archivo
  • si file no existe, se creará un nuevo archivo en el directorio indicado
  • si el directorio hacia file no existe, se producirá un error
  • si file es NULL, no se escribirá en ningún archivo

◆ log_destroy()

void log_destroy ( t_log logger)

Destruye una instancia de logger.

◆ log_trace()

void log_trace ( t_log logger,
const char *  message,
  ... 
)

Loguea un mensaje con el siguiente formato [TRACE] hh:mm:ss:mmmm PROCESS_NAME/(PID:TID): MESSAGE

◆ log_debug()

void log_debug ( t_log logger,
const char *  message,
  ... 
)

Loguea un mensaje con el siguiente formato [DEBUG] hh:mm:ss:mmmm PROCESS_NAME/(PID:TID): MESSAGE

◆ log_info()

void log_info ( t_log logger,
const char *  message,
  ... 
)

Loguea un mensaje con el siguiente formato [INFO] hh:mm:ss:mmmm PROCESS_NAME/(PID:TID): MESSAGE

◆ log_warning()

void log_warning ( t_log logger,
const char *  message,
  ... 
)

Loguea un mensaje con el siguiente formato [WARNING] hh:mm:ss:mmmm PROCESS_NAME/(PID:TID): MESSAGE

◆ log_error()

void log_error ( t_log logger,
const char *  message,
  ... 
)

Loguea un mensaje con el siguiente formato [ERROR] hh:mm:ss:mmmm PROCESS_NAME/(PID:TID): MESSAGE

◆ log_level_as_string()

char* log_level_as_string ( t_log_level  level)

Convierte un t_log_level a su representacion en string.

Parámetros
levelEl nivel de log a convertir
Devuelve
"TRACE", "DEBUG", "INFO", "WARNING" o "ERROR"

◆ log_level_from_string()

t_log_level log_level_from_string ( char *  level)

Convierte un string a su representacion en t_log_level.

Parámetros
level"TRACE", "DEBUG", "INFO", "WARNING" o "ERROR"
Devuelve
El nivel de log correspondiente, o -1 en caso de no ser un nivel de log válido