Functions¶

ssize_t elektraMemcpy (Key **array1, Key **array2, size_t size)
Internal Methods for Elektra. ssize_t elektraMemmove (Key **array1, Key **array2, size_t size)
Copies the key array2 into where array1 points. int elektraStrCmp (const char *s1, const char *s2)
Compare Strings. int elektraStrCaseCmp (const char *s1, const char *s2)
Compare Strings ignoring case. int elektraMemCaseCmp (const char *s1, const char *s2, size_t size)
Compare two memory regions but make cmp chars uppercase before comparison. int elektraRealloc (void **buffer, size_t size)
Reallocate Storage in a save way. void * elektraMalloc (size_t size)

Allocate memory for Elektra. " void * elektraCalloc (size_t size)
Allocate memory for Elektra. void elektraFree (void *ptr)
Free memory of Elektra or its backends. char * elektraStrDup (const char *s)
Copy string into new allocated memory. char * elektraStrNDup (const char *s, size_t l)
Copy buffer into new allocated memory. size_t elektraStrLen (const char *s)
Calculates the length in bytes of a string. char * elektraFormat (const char *format,...)
Does string formatting in fresh allocated memory. char * elektraVFormat (const char *format, va_list arg_list)
Does string formatting in fresh allocated memory. int elektraValidateKeyName (const char *name, size_t size)
Validates whether the supplied keyname is valid.

void* elektraCalloc (size_t size)¶

Allocate memory for Elektra. Memory will be set to 0.

Parameters:

See also:

char* elektraFormat (const char * format, ...)¶

Does string formatting in fresh allocated memory.

Parameters:

Returns:

void elektraFree (void * ptr)¶

Free memory of Elektra or its backends.

Parameters:

If ptr is NULL, no operation is performed.

See also:

void* elektraMalloc (size_t size)¶

Allocate memory for Elektra.

if ((buffer = elektraMalloc (length)) == 0) {


        // here comes the failure handler


        // no allocation happened here, so don't use buffer
#if DEBUG


        fprintf (stderr, "Allocation error");
#endif


        // return with error
}

Parameters:

This function is compatible to ANSI-C elektraMalloc

See also:

int elektraMemCaseCmp (const char * s1, const char * s2, size_t size)¶

Compare two memory regions but make cmp chars uppercase before comparison.

Parameters:

Returns:

Return values:

Returns:

ssize_t elektraMemcpy (Key ** array1, Key ** array2, size_t size)¶

Internal Methods for Elektra. To use them:

#include <kdbinternal.h>

There are some areas where libraries have to reimplement some basic functions to archive support for non-standard systems, for testing purposes or to provide a little more convenience. Copies the key array2 into where array1 points. It copies size elements.

Overlapping is prohibited, use elektraMemmove() instead.

Parameters:

Return values:

Returns:

ssize_t elektraMemmove (Key ** array1, Key ** array2, size_t size)¶

Copies the key array2 into where array1 points. It copies size elements.

Overlapping is ok. If they do not overlap consider elektraMemcpy() instead.

Parameters:

Return values:

Returns:

int elektraRealloc (void ** buffer, size_t size)¶

Reallocate Storage in a save way.

if (elektraRealloc ((void **) & buffer, new_length) < 0) {


        // here comes the failure handler


        // you can still use the old buffer
#if DEBUG


        fprintf (stderr, "Reallocation error0);
#endif


        elektraFree (buffer);


        buffer = 0;


        // return with error
}

Parameters:

Return values:

int elektraStrCaseCmp (const char * s1, const char * s2)¶

Compare Strings ignoring case.

Parameters:

Returns:

Return values:

Returns:

int elektraStrCmp (const char * s1, const char * s2)¶

Compare Strings.

Parameters:

Returns:

Return values:

Returns:

char* elektraStrDup (const char * s)¶

Copy string into new allocated memory. You need to free the memory yourself.

Note:

Parameters:

Returns:

Precondition:

See also:

size_t elektraStrLen (const char * s)¶

Calculates the length in bytes of a string. This function differs from strlen() because it is Unicode and multibyte chars safe. While strlen() counts characters and ignores the final NULL, elektraStrLen() count bytes including the ending NULL.

It must not be used to search for / in the name, because it does not consider escaping. Instead use the unescaped name.

See also:

Parameters:

Returns:

char* elektraStrNDup (const char * s, size_t l)¶

Copy buffer into new allocated memory. You need to free the memory yourself.

This function also works with \0 characters in the buffer. The length is taken as given, it must be correct.

Returns:

Parameters:

int elektraValidateKeyName (const char * name, size_t size)¶

Validates whether the supplied keyname is valid. The function looks for tangling escape characters in the end and for a minimum length.

Does not check for valid namespaces

Precondition:

Parameters:

Return values:

char* elektraVFormat (const char * format, va_list arg_list)¶

Does string formatting in fresh allocated memory.

Parameters:

Returns: