NAME¶

libclocale.h — Library to support cross-platform C locale functions

SYNOPSIS¶

#include <libclocale.h>

Support functions

const char *


libclocale_get_version(
void);

int


libclocale_initialize(
const char *domain_name,
libclocale_error_t **error);

Codepage functions

int


libclocale_codepage_get(
int *codepage,
libclocale_error_t **error);

int


libclocale_codepage_set(
int codepage,
libclocale_error_t **error);

int


libclocale_codepage_copy_from_string(
int *codepage,
const char *string,
size_t string_length,
uint32_t feature_flags,
libclocale_error_t **error);

Available when compiled with wide character string support:

int


libclocale_codepage_copy_from_string_wide(
int *codepage,
const wchar_t *string,
size_t string_length,
uint32_t feature_flags,
libclocale_error_t **error);

Locale functions

int


libclocale_locale_get_codepage(
int *codepage,
libclocale_error_t **error);

int


libclocale_locale_get_decimal_point(
int *decimal_point,
libclocale_error_t **error);

DESCRIPTION¶

The libclocale_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 see <libclocale.h>.

ENVIRONMENT¶

None

FILES¶

None

NOTES¶

libclocale can be compiled with wide character support (wchar_t).

To compile libclocale with wide character support use: ./configure --enable-wide-character-type
or define: _UNICODE
or UNICODE
during compilation.

LIBCLOCALE_WIDE_CHARACTER_TYPE
in libclocale/features.h can be used to determine if libclocale was compiled with wide character support.

SEE ALSO¶

<libclocale.h>

AUTHORS¶

Joachim Metz <joachim.metz@gmail.com>

BUGS¶

Please report bugs of any kind on the project issue tracker: https://github.com/libyal/libclocale/issues

COPYRIGHT¶

Copyright (C) 2010-2026, 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.