Miscellaneous

Kore provides several helper functions.

Index


kore_log

Synopsis

void kore_log(int prio, const char *fmt, ...)

Description

Output a log message via syslog.

Note that when running in the foreground these go to stdout.

Parameter Description
prio The priority of the log message (see syslog(3)).
fmt The format string.
... List of arguments.

Returns

Nothing


kore_strlcpy

Synopsis

size_t kore_strlcpy(char *dst, const char *src, const size_t length)

Description

Bounded C string copying. The result is always NUL-terminated.

Parameter Description
dst The destination buffer.
src The source C string.
length The maximum number of bytes that the destination buffer holds.

Returns

The length of the original string. If this length is equal or larger than the destination buffer then truncation of the string has occurred.


kore_strtonum

Synopsis

long long kore_strtonum(const char *str, int base, long long min, long long max, int *err)

Description

Safely convert a C string holding a number into an integer.

Parameter Description
str The C string to convert.
base The base on which to operate.
min The minimum value the converted integer is allowed to have.
max The maximum value the converted integer is allowed to have.
err A pointer to an integer that holds the error value.

Returns

Returns the converted integer. If the err parameter was set to KORE_RESULT_OK the conversion went OK otherwise there was an error and the returned value is considered garbage.


kore_strtonum64

Synopsis

u_int64_t kore_strtonum64(const char *str, int sign, int *err)

Description

Safely convert a C string holding a number to a 64-bit integer.

Parameter Description
str The C string to convert.
sign If the 64-bit integer is allowed to be signed or not.
err A pointer to an integer that holds the error value.

Returns

Returns the converted integer. If the err parameter was set to KORE_RESULT_OK the conversion went OK otherwise there was an error and the returned value is considered garbage.


kore_split_string

Synopsis

int kore_split_string(char *input, char *delim, char **out, size_t ele)

Description

Safely split a string into several elements. The out array is NULL terminated.

Parameter Description
input The string to be split up.
delim The delimiter used for splitting.
out Pointer to an array where the components are stored.
ele The number of elements that can be held in out.

Returns

The number of components.


kore_strip_chars

Synopsis

void kore_strip_chars(char *in, const char strip, char **out)

Description

Safely strip all occurrences of a certain character from a C string. The result must be freed by the caller.

Parameter Description
in The input C string.
strip The character to be stripped out of the string.
out A pointer to where the new result is stored.

Returns

Nothing


results matching ""

    No results matching ""