1 Star 0 Fork 5.1K

睿凡 / docs

forked from OpenHarmony / docs 
加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
wchar-h.md 62.75 KB
一键复制 编辑 原始数据 按行查看 历史
wenjun 提交于 2020-09-08 10:08 . add OpenHarmony 1.0 baseline

wchar.h

Overview

Related Modules:

UTILS

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

Function Name

Description

wcscpy (wchar_t *dest, const wchar_t *src)

wchar_t * 

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)

wchar_t * 

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)

wchar_t * 

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)

wchar_t * 

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)

int 

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)

int 

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)

int 

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)

size_t 

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)

wchar_t * 

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)

wchar_t * 

Locates the last occurrence of the wide character pointed to by wc in the wide character string pointed to by wcs.

wcscspn (const wchar_t *wcs, const wchar_t *accept)

size_t 

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.

wcsspn (const wchar_t *wcs, const wchar_t *accept)

size_t 

Scans the wide character string pointed to by wcs for any wide characters specified in reject and obtains the number matched characters in wcs.

wcspbrk (const wchar_t *wcs, const wchar_t *accept)

wchar_t * 

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)

wchar_t * 

Splits a wide character string pointed to by wcs into tokens using the given delimiter.

wcslen (const wchar_t *s)

size_t 

Calculates the length of a wide character string pointed to by s.

wcswcs (const wchar_t *haystack, const wchar_t *needle)

wchar_t * 

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)

wchar_t * 

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)

int 

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)

wchar_t * 

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)

wchar_t * 

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)

wchar_t * 

Fills count characters specified by ch to the wide character array pointed to by dest.

btowc (int c)

wint_t 

Converts a single-byte character c into its wide-character representation.

wctob (wint_t c)

int 

Converts a wide character c into its single-byte representation.

mbsinit (const mbstate_t *ps)

int 

Checks whether the mbstate_t object pointed to by ps is in the initial state.

wcrtomb (char *s, wchar_t wc, mbstate_t *ps)

size_t 

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)

size_t 

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)

size_t 

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)

size_t 

Converts a wide character string into a multi-byte string.

wcstof (const wchar_t *str, wchar_t **endptr)

float 

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)

double 

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)

long double 

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)

long 

Converts a wide character string pointed to by str into a long value.

wcstoul (const wchar_t *str, wchar_t **endptr, int base)

unsigned long 

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)

long long 

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)

unsigned long long 

Converts a wide character string pointed to by str into an unsigned long long value of a specified base.

fwide (FILE *stream, int mode)

int 

Sets and determines the orientation of the file stream.

wprintf (const wchar_t *format,...)

int 

Prints formatted data to the standard output (stdout).

fwprintf (FILE *__restrict fp, const wchar_t *__restrict fmt,...)

int 

Prints wide character strings to a specified file stream.

swprintf (wchar_t *wcs, size_t maxlen, const wchar_t *format,...)

int 

Prints formatted data to a specified string.

vwprintf (const wchar_t *format, va_list args)

int 

Prints formatted data from a variable argument list to the standard output (stdout).

vfwprintf (FILE *stream, const wchar_t *format, __isoc_va_list args)

int 

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)

int 

Prints formatted data from a variable argument list specified by args to a specified string.

wscanf (const wchar_t *format,...)

int 

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.

fwscanf (FILE *stream, const wchar_t *format,...)

int 

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,...)

int 

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)

int 

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.

vfwscanf (FILE *stream, const wchar_t *format, va_list arg)

int 

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)

int 

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.

fgetwc (FILE *stream)

wint_t 

Reads a wide character from a specified file stream.

getwc (FILE *stream)

wint_t 

Reads the first wide character from a specified file stream.

getwchar (void)

wint_t 

Reads a wide character from the stdin.

fputwc (wchar_t wc, FILE *stream)

wint_t 

Writes a wide character wc to a specified file stream.

putwc (wchar_t wc, FILE *stream)

wint_t 

Writes a wide character wc to a specified file stream.

putwchar (wchar_t wc)

wint_t 

Writes a wide character wc to the stdout.

fgetws (wchar_t *ws, int n, FILE *stream)

wchar_t * 

Reads wide characters from a specified file stream.

fputws (const wchar_t *ws, FILE *stream)

int 

Writes a wide string pointed to by ws to a specified file stream.

ungetwc (wint_t ch, FILE *stream)

wint_t 

Pushes a character back into a specified file stream.

mbrtowc (wchar_t *pwc, const char *s, size_t n, mbstate_t *ps)

size_t 

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)

size_t 

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)

size_t 

Converts nwc wide characters in the string pointed to by src into a character string.

wcsdup (const wchar_t *s)

wchar_t * 

Copies a specified wide character string to a newly allocated buffer.

wcsnlen (const wchar_t *s, size_t maxlen)

size_t 

Calculates the length of a wide character string pointed to by s.

wcpcpy (wchar_t *dest, const wchar_t *src)

wchar_t * 

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)

wchar_t * 

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)

int 

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)

int 

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)

int 

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)

int 

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)

int 

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)

size_t 

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)

size_t 

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.

1
https://gitee.com/lcpsky/docs.git
git@gitee.com:lcpsky/docs.git
lcpsky
docs
docs
master

搜索帮助