NAME¶

libcstring.h — Library to support cross-platform C string functions

LIBRARY¶

library “libcstring”

SYNOPSIS¶

#include <libcstring.h>

Support functions
const char *
libcstring_get_version(void);

Narrow character string functions
size_t
libcstring_narrow_string_length(const char *string);

int
libcstring_narrow_string_compare(const char *string1, const char *string2, size_t size);

int
libcstring_narrow_string_compare_no_case(const char *string1, const char *string2, size_t size);

char *
libcstring_narrow_string_copy(char *destination, const char *source, size_t size);

char *
libcstring_narrow_string_search_character(const char *string, int character, size_t size);

char *
libcstring_narrow_string_search_character_reverse(const char *string, int character, size_t size);

char *
libcstring_narrow_string_search_character_reverse(const char *string, const char *substring, size_t size);

int
libcstring_narrow_string_snprintf(char *target, size_t size, ...);

int
libcstring_narrow_string_sscanf(char *string, const char *format, ...);

Wide character string functions
size_t
libcstring_wide_string_length(const wchar_t *string);

int
libcstring_wide_string_compare(const wchar_t *string1, const wchar_t *string2, size_t size);

int
libcstring_wide_string_compare_no_case(const wchar_t *string1, const wchar_t *string2, size_t size);

wchar_t *
libcstring_wide_string_copy(wchar_t *destination, const wchar_t *source, size_t size);

wchar_t *
libcstring_wide_string_search_character(const wchar_t *string, wchar_t character, size_t size);

wchar_t *
libcstring_wide_string_search_character_reverse(const wchar_t *string, wchar_t character, size_t size);

wchar_t *
libcstring_wide_string_search_character_reverse(const wchar_t *string, const wchar_t *substring, size_t size);

int
libcstring_wide_string_snwprintf(wchar_t *target, size_t size, ...);

int
libcstring_wide_string_vsnwprintf(wchar_t *string, const wchar_t *format, ...);

System (character) string functions
int
libcstring_system_string_compare(const libcstring_system_character_t *string1, const libcstring_system_character_t *string2, size_t size);

int
libcstring_system_string_compare_no_case(const libcstring_system_character_t *string1, const libcstring_system_character_t *string2, size_t size);

libcstring_system_character_t *
libcstring_system_string_copy(libcstring_system_character_t *destination, const libcstring_system_character_t *source, size_t size);

size_t
libcstring_system_string_length(const libcstring_system_character_t *string);

libcstring_system_character_t *
libcstring_system_string_search_character(const libcstring_system_character_t *string, libcstring_system_character_t character, size_t size);

libcstring_system_character_t *
libcstring_system_string_search_character_reverse(const libcstring_system_character_t *string, libcstring_system_character_t character, size_t size);

libcstring_system_character_t *
libcstring_system_string_search_character_reverse(const libcstring_system_character_t *string, const libcstring_system_character_t *substring, size_t size);

int
libcstring_system_string_sprintf(libcstring_system_character_t *target, size_t size, ...);

int
libcstring_system_string_vsprintf(libcstring_system_character_t *string, const libcstring_system_character_t *format, ...);

DESCRIPTION¶

The libcstring_get_version() function is used to retrieve the library version.

RETURN VALUES¶

Most of the functions return NULL or -1 on error, dependent on the return type. For the actual return values refer to libcstring.h

ENVIRONMENT¶

None

FILES¶

None

BUGS¶

Please report bugs of any kind to <joachim.metz@gmail.com> or on the project website: https://github.com/libyal/libcstring/

AUTHOR¶

These man pages were written by Joachim Metz.

COPYRIGHT¶

Copyright (C) 2010-2015, Joachim Metz <joachim.metz@gmail.com>. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO¶

the libcstring.h include file