wchar.h
Overview
Related Modules:
Description:
Declares commonly used functions related to wide characters.
You can use functions provided in this file to perform operations such as reading, writing, comparing, concatenating, copying, and searching wide characters.
Since:
1.0
Version:
1.0
Summary
Functions
wcscpy (wchar_t dest, const wchar_t src) |
Copies the wide characters pointed to by src to the wide character array pointed to by dest, including the terminating null character ‘\0’. . |
wcsncpy (wchar_t dest, const wchar_t src, size_t n) |
Copies the first n wide characters pointed to by src to the wide character array pointed to by dest. |
wcscat (wchar_t dest, const wchar_t src) |
Appends a copy of the wide characters pointed to by src to the end of the wide character array pointed to by dest and adds a terminating null character ‘\0’. |
wcsncat (wchar_t dest, const wchar_t src, size_t n) |
Appends a copy of the first n wide characters pointed to by src to the end of the wide characters pointed to by dest and adds a terminating null character ‘\0’. |
wcscmp (const wchar_t s1, const wchar_t s2) |
Compares each character in the string pointed to by s1 with that in the string pointed to by s2 in ASCII-code order. |
wcsncmp (const wchar_t s1, const wchar_t s2, size_t n) |
Compares the first n characters in the string pointed to by s1 with those in the string pointed to by s2 in ASCII-code order. |
wcscoll (const wchar_t ws1, const wchar_t ws2) |
Compares the wide characters in the string pointed to by ws1 with those in the string pointed to by ws2 based on the specified locale LC_COLLATE. |
wcsxfrm (wchar_t s1, const wchar_t s2, size_t n) |
Compares the first n wide characters in the string pointed to by s1 with those in the string pointed to by s2. |
wcschr (const wchar_t wcs, wchar_t wc) |
Locates the first occurrence of the wide character pointed to by wc in the wide character string pointed to by wcs. |
wcsrchr (const wchar_t wcs, wchar_t wc) |
Locates the last occurrence of the wide character pointed to by wc in the wide character string pointed to by wcs. |
Scans the wide character string pointed to by wcs for any wide characters specified in reject and obtains the number of unmatched characters in wcs. |
|
Scans the wide character string pointed to by wcs for any wide characters specified in reject and obtains the number matched characters in wcs. |
|
Scans the wide character string pointed to by wcs for any wide characters specified in accept and obtains the first occurrence of the matched character. |
|
wcstok (wchar_t wcs, const wchar_t delim, wchar_t **ptr) |
Splits a wide character string pointed to by wcs into tokens using the given delimiter. |
wcslen (const wchar_t s) |
Calculates the length of a wide character string pointed to by s. |
wcswcs (const wchar_t haystack, const wchar_t needle) |
Searches the wide character string pointed to by dest for the first occurrence of the wide character string pointed to by src. |
wmemchr (const wchar_t s, wchar_t c, size_t n) |
Searches for the first position of the matched wide character within the specified number of characters in a wide character string. |
wmemcmp (const wchar_t lhs, const wchar_t rhs, size_t count) |
Compares the first count characters in the string pointed to by lhs with the first count characters in the string pointed to by rhs. |
wmemcpy (wchar_t dest, const wchar_t src, size_t count) |
Copies count successive characters from the wide character array pointed to by src to the wide character array pointed to by dest. |
wmemmove (wchar_t dest, const wchar_t src, size_t count) |
Copies count successive characters from the wide character array pointed to by src to the wide character array pointed to by dest (with possible array overlapping). |
wmemset (wchar_t dest, wchar_t ch, size_t count) |
Fills count characters specified by ch to the wide character array pointed to by dest. |
btowc (int c) |
Converts a single-byte character c into its wide-character representation. |
wctob (wint_t c) |
Converts a wide character c into its single-byte representation. |
mbsinit (const mbstate_t ps) |
Checks whether the mbstate_t object pointed to by ps is in the initial state. |
wcrtomb (char s, wchar_t wc, mbstate_t ps) |
Converts the wide character specified by wc into a character string and stores the string to the beginning of the character array pointed to by s. |
mbrlen (const char s, size_t n, mbstate_t ps) |
Determines the number of bytes in a character string pointed to by s. |
mbsrtowcs (wchar_t dest, const char src, size_t len, mbstate_t ps) |
Converts a multi-byte character string with a length of len into a wide character string. |
wcsrtombs (char dest, const wchar_t src, size_t len, mbstate_t ps) |
|
wcstof (const wchar_t str, wchar_t endptr) |
Converts a wide character string pointed to by str into a floating-point value and assigns the next character in str after the floating-point value to endptr. |
wcstod (const wchar_t *str, wchar_t endptr) |
Converts a wide character string pointed to by str into a double value and assigns the next character in str after the double value to endptr. |
wcstold (const wchar_t str, wchar_t **endptr) |
Converts a wide character string pointed to by str into a long double value and assigns the next character in str after the long double value to endptr. |
wcstol (const wchar_t str, wchar_t endptr, int base) |
Converts a wide character string pointed to by str into a long value. |
wcstoul (const wchar_t *str, wchar_t endptr, int base) |
Converts a wide character string pointed to by str into an unsigned long value of a specified base. |
wcstoll (const wchar_t str, wchar_t **endptr, int base) |
Converts a wide character string pointed to by str into a long long value of a specified base. |
wcstoull (const wchar_t str, wchar_t endptr, int base) |
Converts a wide character string pointed to by str into an unsigned long long value of a specified base. |
wprintf (const wchar_t format,…) |
|
swprintf (wchar_t wcs, size_t maxlen, const wchar_t format,…) |
|
vwprintf (const wchar_t format, va_list args) |
Prints formatted data from a variable argument list to the standard output (stdout). |
vfwprintf (FILE stream, const wchar_t *format, isoc_va_list args) |
Prints formatted data from a variable argument list specified by args to a specified file stream. |
vswprintf (wchar_t wcs, size_t maxlen, const wchar_t format, __isoc_va_list args) |
Prints formatted data from a variable argument list specified by args to a specified string. |
wscanf (const wchar_t format,…) |
Reads formatted data from the standard input (stdin) and stores it based on the wide string format into the locations pointed to by the variable arguments. |
Reads formatted data from a specified stream and stores it based on the wide string format into the locations pointed to by the variable arguments. |
|
swscanf (const wchar_t ws, const wchar_t format,…) |
Reads data from a wide character string pointed to by ws and stores it based on the wide string format into the locations pointed to by the variable arguments. |
vwscanf (const wchar_t format, va_list arg) |
Reads data from the stdin and stores it based on the wide string format into the locations pointed to by the elements in the variable argument list identified by arg. |
Reads data from a specified file stream and stores it based on the wide string format into the locations pointed to by the elements in the variable argument list identified by arg. |
|
vswscanf (const wchar_t ws, const wchar_t format, va_list arg) |
Reads data from a string pointed to by ws and stores it based on the wide string format into the locations pointed to by the elements in the variable argument list identified by arg. |
Reads the first wide character from a specified file stream. |
|
getwchar (void) |
|
putwchar (wchar_t wc) |
|
Writes a wide string pointed to by ws to a specified file stream. |
|
mbrtowc (wchar_t pwc, const char s, size_t n, mbstate_t ps) |
Converts a multi-byte character string with a length of n into a wide character string. |
mbsnrtowcs (wchar_t dest, const char src, size_t nwc, size_t len, mbstate_t ps) |
Converts a multi-byte character string with a length of n into a wide character string that can hold a total of nwc wide characters. |
wcsnrtombs (char dest, const wchar_t *src, size_t nwc, size_t len, mbstate_t ps) |
Converts nwc wide characters in the string pointed to by src into a character string. |
wcsdup (const wchar_t s) |
Copies a specified wide character string to a newly allocated buffer. |
wcsnlen (const wchar_t s, size_t maxlen) |
Calculates the length of a wide character string pointed to by s. |
wcpcpy (wchar_t dest, const wchar_t src) |
Copies the wide characters (including the terminating null character ‘\0’) pointed to by src to the wide character array pointed to by dest. |
wcpncpy (wchar_t dest, const wchar_t src, size_t n) |
Copies n wide characters (including the terminating null character ‘\0’) pointed to by src to the wide character array pointed to by dest. |
wcscasecmp (const wchar_t s1, const wchar_t s2) |
Compares the wide characters in the string pointed to by s1 with those in the string pointed to by s2, with their case differences ignored. |
wcscasecmp_l (const wchar_t s1, const wchar_t s2, locale_t locale) |
Compares the wide characters in the string pointed to by s1 with those in the string pointed to by s2 based on the specified locale environment, with their case differences ignored. |
wcsncasecmp (const wchar_t s1, const wchar_t s2, size_t n) |
Compares a maximum of n wide characters in the string pointed to by s1 with those in the string pointed to by s2, with their case differences ignored. |
wcsncasecmp_l (const wchar_t s1, const wchar_t s2, size_t n, locale_t locale) |
Compares a maximum of n wide characters in the string pointed to by s1 with those in the string pointed to by s2 based on the specified locale environment, with their case differences ignored. |
wcscoll_l (const wchar_t s1, const wchar_t s2, locale_t locale) |
Compares wide characters in the string pointed to by s1 with those in the string pointed to by s2 based on the specified locale environment. |
wcsftime (wchar_t restrict wcs, size_t n, const wchar_t *restrict f, const struct tm __restrict tm) |
Converts the date and time in the tm structure to a wide character string. |
wcsxfrm_l (wchar_t s1, const wchar_t *s2, size_t n, locale_t locale) |
Compares the first n wide characters in the string pointed to by s1 with those in the string pointed to by s2 based on the specified locale environment. |