LOGC_LOGARRAY(3) User Manuals LOGC_LOGARRAY(3)NAME
logc_logArray, logc_logArrayBasic, logc_logArrayWarning, logc_logArray‐
Info, logc_logArrayFine, logc_logArrayFinest - nglogc data array log‐
ging
SYNOPSIS
#include <nglogc/log.h>
logc_error_t
logc_logArray(
uint16_t ident, logc_logLevel_t level, const char* desc, const
uint8_t* array, size_t len
);
logc_error_t
logc_logBasic(
uint16_t ident, const char* desc, const uint8_t* array, size_t len
);
logc_error_t
logc_logWarning(
uint16_t ident, const char* desc, const uint8_t* array, size_t len
);
logc_error_t
logc_logInfo(
uint16_t ident, const char* desc, const uint8_t* array, size_t len
);
logc_error_t
logc_logFine(
uint16_t ident, const char* desc, const uint8_t* array, size_t len
);
logc_error_t
logc_logFinest(
uint16_t ident, const char* desc, const uint8_t* array, size_t len
);
DESCRIPTION
The functions in the logc_logArray() family are used for data array
logging. The array is printed as hexadecimal. The function logc_logAr‐
ray() has an logc_logLevel_t argument for the log level of the state‐
ment. The rest of the functions logc_logArrayBasic(), logc_logArray‐
Warning(), logc_logArrayInfo(), logc_logArrayFine() and logc_logAr‐
rayFinest() have the log level in their name and can be also controlled
by define switches.
The functions logc_logArrayFine() and logc_logArrayFinest() are dis‐
abled per default and must be enabled with a define switch to use. See
logc_defines(3).
Parameters
ident
Identifier of the logger which must be registered first.
level
The log level of the statement. Could be LOG_BASIC, LOG_WARNING,
LOG_INFO, LOG_FINE or LOG_FINEST. Only used for logc_logArray()
function. The other functions have the log level in their name.
desc
Description string of the data array.
array
data array, printed in hexadecimal.
len
Length of the array.
Return value
Upon successful return, these functions return LOG_ERR_OK which is an
uint32_t type and has the decimal value 0. In error cases these errors
can be returned: LOG_ERR_NULL the format string is a NULL pointer.
LOG_ERR_NOT_FOUND invalid logger ID. LOG_ERR_LEVEL log message is not
processed because of the log level of the logger.
BUG REPORT
For bugreporting write a mail to ebrosius@netgarage.org or use the
issues tracker on the project hosting site
http://code.google.com/p/nglogc
COPYRIGHT
nglogc is free software: you can redistribute it and/or modify it under
the terms of the GNU Lesser Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your
option) any later version.
AUTHOR
Dennis Krzyzaniak <ebrosius@netgarage.org>
SEE ALSOlogc_logError(3), logc_log(3), logc_logEnter(3), logc_logger(3),
logc_defines(3), the project site http://netgarage.org
Linux October 2009 LOGC_LOGARRAY(3)
