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_log *	log_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

enum 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

file	La ruta hacia el archivo donde se van a generar los logs
process_name	El nombre a ser mostrado en los logs
is_active_console	Si lo que se loguea debe mostrarse por consola
level	El 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

level

El 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