Character Set Functions

To use the functions defined in this section, you should include the header file <X11/Xmu/CharSet.h> and link against the libXmu or libXmuu library.

Warning

The functions in this section are deprecated because they don't work in most locales now supported by X11; most platforms provide alternatives in their system libraries.

void XmuCopyISOLatin1Lowered(char *dst, const char *src);

void XmuCopyISOLatin1Lowered(char *dst, const char *src);

dst	returns the string copy
src	specifies the string to copy

This function copies a null terminated string from src to dst (including the null), changing all Latin-1 uppercase letters to lowercase. The string is assumed to be encoded using ISO 8859-1.

Note that like strcpy the caller is responsible for ensuring the size of dst is at least as large as the size of src.

void XmuNCopyISOLatin1Lowered(char *dst, const char *src, int size);

void XmuNCopyISOLatin1Lowered(char *dst, const char *src, int size);

dst	returns the string copy
src	specifies the string to copy
size	maximum number of characters (including the null terminator) to write to dst

This function copies up to size - 1 characters of a null terminated string from src to dst, and terminates it with a null, changing all Latin-1 uppercase letters to lowercase. The string is assumed to be encoded using ISO 8859-1.

void XmuCopyISOLatin1Uppered(char *dst, const char *src);

void XmuCopyISOLatin1Uppered(char *dst, const char *src);

dst	returns the string copy
src	specifies the string to copy

This function copies a null terminated string from src to dst (including the null), changing all Latin-1 lowercase letters to uppercase. The string is assumed to be encoded using ISO 8859-1.

Note that like strcpy the caller is responsible for ensuring the size of dst is at least as large as the size of src.

void XmuNCopyISOLatin1Uppered(char *dst, const char *src, int size);

void XmuNCopyISOLatin1Uppered(char *dst, const char *src, int size);

dst	returns the string copy
src	specifies the string to copy
size	maximum number of characters (including the null terminator) to write to dst

This function copies up to size - 1 characters of a null terminated string from src to dst, and terminates it with a null, changing all Latin-1 lowercase letters to uppercase. The string is assumed to be encoded using ISO 8859-1.

int XmuCompareISOLatin1(const char *first, const char *second);

int XmuCompareISOLatin1(const char *first, const char *second);

first	specifies a string to compare
second	specifies a string to compare

This function compares two null terminated Latin-1 strings, ignoring case differences, and returns an integer greater than, equal to, or less than 0, according to whether first is lexicographically greater than, equal to, or less than second. The two strings are assumed to be encoded using ISO 8859-1.