1 .\" This file is part of the Public Domain C Library " "PDCLib).
2 .\" Permission is granted to use" "modify" "and / or redistribute at will.
10 .Nd wide character & wide character string manipulation
18 header provides functions for manipulating wide character strings" "for
19 converting between wide characters and multibyte character sets" "for
20 manipulating wide character strings" "and for wide character oriented input and
23 .Ss Types & Definitions
28 shall be defined as in
33 shall be defined as an integral type capable of representing any wide character
34 in the implementation defined encoding. The type
36 shall be defined as an integral type capable of representing any wide character
37 in the implementation defined encoding" "plus the distinct value given by
39 which evaluates to a constant expression of type
41 which does not correspond to any character in the implementation defined
42 character set. The macros
46 shall be defined as in
51 shall be a complete non-array object type used for the storage of the state of
52 a multibyte to wide character conversion.
56 shall be defined as an incomplete type" "a full definition of wich can be found
60 .Ss Wide Character String Handling Functions
61 .Fn "wchar_t *wcscpy" "wchar_t *restrict s1" "const wchar_t *restrict s2"
63 .Fn "wchar_t *wcsncpy" "wchar_t *restrict s1" "const wchar_t *restrict s2" "size_t n"
65 .Fn "wchar_t *wmemcpy" "wchar_t *restrict s1" "const wchar_t *restrict s2" "size_t n"
67 .Fn "wchar_t *wmemmove" "wchar_t *s1" "const wchar_t *s2" "size_t n"
69 .Fn "wchar_t *wcscat" "wchar_t *restrict s1" "const wchar_t *restrict s2"
71 .Fn "wchar_t *wcsncat" "wchar_t *restrict s1" "const wchar_t *restrict s2" "size_t n"
73 .Fn "int wcscmp" "const wchar_t *s1" "const wchar_t *s2"
75 .Fn "int wcscoll" "const wchar_t *s1" "const wchar_t *s2"
77 .Fn "int wcsncmp" "const wchar_t *s1" "const wchar_t *s2" "size_t n"
79 .Fn "size_t wcsxfrm" "wchar_t *restrict s1" "const wchar_t *restrict s2" "size_t n"
81 .Fn "int wmemcmp" "const wchar_t *s1" "const wchar_t *s2" "size_t n"
83 .Fn "wchar_t *wcschr" "const wchar_t *s" "wchar_t c"
85 .Fn "size_t wcscspn" "const wchar_t *s1" "const wchar_t *s2"
87 .Fn "wchar_t *wcspbrk" "const wchar_t *s1" "const wchar_t *s2"
89 .Fn "wchar_t *wcsrchr" "const wchar_t *s" "wchar_t c"
91 .Fn "size_t wcsspn" "const wchar_t *s1" "const wchar_t *s2"
93 .Fn "wchar_t *wcsstr" "const wchar_t *s1" "const wchar_t *s2"
95 .Fn "wchar_t *wcstok" "wchar_t *restrict s1" "const wchar_t *restrict s2" "wchar_t **restrict ptr"
97 .Fn "wchar_t *wmemchr" "const wchar_t *s" "wchar_t c" "size_t n"
99 .Fn "size_t wcslen" "const wchar_t *s"
101 .Fn "wchar_t *wmemset" "wchar_t *s" "wchar_t c" "size_t n"
103 .Ss Wide Character String Formatting
104 .Fn "int swprintf" "wchar_t *restrict s" "size_t n" "const wchar_t *restrict format" "..."
106 .Fn "int swscanf" "const wchar_t *restrict s" "const wchar_t *restrict format" "..."
108 .Fn "int vswprintf" "wchar_t *restrict s" "size_t n" "const wchar_t *restrict format" "va_list arg"
110 .Fn "int vswscanf" "const wchar_t *restrict s" "const wchar_t *restrict format" "va_list arg"
112 .Fn "size_t wcsftime" "wchar_t *restrict s" "size_t maxsize" "const wchar_t *restrict format" "const struct tm *restrict timeptr"
114 .Ss Wide Character Input and Output
115 .Fn "int fwprintf" "FILE *restrict stream" "const wchar_t *restrict format" "..."
117 .Fn "int fwscanf" "FILE *restrict stream" "const wchar_t *restrict format" "..."
119 .Fn "int vfwprintf" "FILE *restrict stream" "const wchar_t *restrict format" "va_list arg"
121 .Fn "int vfwscanf" "FILE *restrict stream" "const wchar_t *restrict format" "va_list arg"
123 .Fn "int vwprintf" "const wchar_t *restrict format" "va_list arg"
125 .Fn "int vwscanf" "const wchar_t *restrict format" "va_list arg"
127 .Fn "int wprintf" "const wchar_t *restrict format" "..."
129 .Fn "int wscanf" "const wchar_t *restrict format" "..."
131 .Fn "wint_t fgetwc" "FILE *stream"
133 .Fn "wchar_t *fgetws" "wchar_t *restrict s" "int n" "FILE *restrict stream"
135 .Fn "wint_t fputwc" "wchar_t c" "FILE *stream"
137 .Fn "int fputws" "const wchar_t *restrict s" "FILE *restrict stream"
139 .Fn "int fwide" "FILE *stream" "int mode"
141 .Fn "wint_t getwc" "FILE *stream"
143 .Fn "wint_t getwchar" "void"
145 .Fn "wint_t putwc" "wchar_t c" "FILE *stream"
147 .Fn "wint_t putwchar" "wchar_t c"
149 .Fn "wint_t ungetwc" "wint_t c" "FILE *stream"
151 .Ss Wide Character String Parsing
152 .Fn "double wcstod" "const wchar_t *restrict nptr" "wchar_t **restrict endptr"
154 .Fn "float wcstof" "const wchar_t *restrict nptr" "wchar_t **restrict endptr"
156 .Fn "long double wcstold" "const wchar_t *restrict nptr" "wchar_t **restrict endptr"
158 .Fn "long int wcstol" "const wchar_t *restrict nptr" "wchar_t **restrict endptr" "int base"
160 .Fn "long long int wcstoll" "const wchar_t *restrict nptr" "wchar_t **restrict endptr" "int base"
162 .Fn "unsigned long int wcstoul" "const wchar_t *restrict nptr" "wchar_t **restrict endptr" "int base"
164 .Fn "unsigned long long int wcstoull" "const wchar_t *restrict nptr" "wchar_t **restrict endptr" "int base"
166 .Ss Character Set Conversion
167 .Fn "wint_t btowc" "int c"
169 .Fn "int wctob" "wint_t c"
171 .Fn "int mbsinit" "const mbstate_t *ps"
173 .Fn "size_t mbrlen" "const char *restrict s" "size_t n" "mbstate_t *restrict ps"
175 .Fn "size_t mbrtowc" "wchar_t *restrict pwc" "const char *restrict s" "size_t n" "mbstate_t *restrict ps"
177 .Fn "size_t wcrtomb" "char *restrict s" "wchar_t wc" "mbstate_t *restrict ps"
179 .Fn "size_t mbsrtowcs" "wchar_t *restrict dst" "const char **restrict src" "size_t len" "mbstate_t *restrict ps"
181 .Fn "size_t wcsrtombs" "char *restrict dst" "const wchar_t **restrict src" "size_t len" "mbstate_t *restrict ps"
projects / pdclib / blob