diff options
| author | Alejandro Colomar <alx.manpages@gmail.com> | 2022-09-09 14:15:08 +0200 |
|---|---|---|
| committer | Alejandro Colomar <alx.manpages@gmail.com> | 2022-09-09 14:15:08 +0200 |
| commit | 96e72ec1fbadd13cbcbc2b263540e4f5e9e09d7c (patch) | |
| tree | 70686b943e33a6e939ad265acb7ddfef70b91f32 /man/man3/mbsinit.3 | |
| parent | 8f4ed6463206e8ede815c72085c7305dafc2e4fc (diff) | |
| download | man-pages-96e72ec1fbadd13cbcbc2b263540e4f5e9e09d7c.tar.gz | |
Revert "src.mk, All pages: Move man* to man/"
This reverts commit 70ac1c4785fc1e158ab2349a962dba2526bf4fbc.
Link: <https://lore.kernel.org/linux-man/YxcV4h+Xn7cd6+q2@pevik/T/>
Reported-by: Petr Vorel <pvorel@suse.cz>
Reported-by: Jakub Wilk <jwilk@jwilk.net>
Cc: Stefan Puiu <stefan.puiu@gmail.com>
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Diffstat (limited to 'man/man3/mbsinit.3')
| -rw-r--r-- | man/man3/mbsinit.3 | 117 |
1 files changed, 0 insertions, 117 deletions
diff --git a/man/man3/mbsinit.3 b/man/man3/mbsinit.3 deleted file mode 100644 index 5ba22cf432..0000000000 --- a/man/man3/mbsinit.3 +++ /dev/null @@ -1,117 +0,0 @@ -.\" Copyright (c) Bruno Haible <haible@clisp.cons.org> -.\" -.\" SPDX-License-Identifier: GPL-2.0-or-later -.\" -.\" References consulted: -.\" GNU glibc-2 source code and manual -.\" Dinkumware C library reference http://www.dinkumware.com/ -.\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html -.\" ISO/IEC 9899:1999 -.\" -.TH MBSINIT 3 2021-03-22 "Linux man-pages (unreleased)" -.SH NAME -mbsinit \- test for initial shift state -.SH LIBRARY -Standard C library -.RI ( libc ", " \-lc ) -.SH SYNOPSIS -.nf -.B #include <wchar.h> -.PP -.BI "int mbsinit(const mbstate_t *" ps ); -.fi -.SH DESCRIPTION -Character conversion between the multibyte representation and the wide -character representation uses conversion state, of type -.IR mbstate_t . -Conversion of a string uses a finite-state machine; when it is interrupted -after the complete conversion of a number of characters, it may need to -save a state for processing the remaining characters. -Such a conversion -state is needed for the sake of encodings such as ISO-2022 and UTF-7. -.PP -The initial state is the state at the beginning of conversion of a string. -There are two kinds of state: the one used by multibyte to wide character -conversion functions, such as -.BR mbsrtowcs (3), -and the one used by wide -character to multibyte conversion functions, such as -.BR wcsrtombs (3), -but they both fit in a -.IR mbstate_t , -and they both have the same -representation for an initial state. -.PP -For 8-bit encodings, all states are equivalent to the initial state. -For multibyte encodings like UTF-8, EUC-*, BIG5, or SJIS, the wide character -to multibyte conversion functions never produce non-initial states, but the -multibyte to wide-character conversion functions like -.BR mbrtowc (3) -do -produce non-initial states when interrupted in the middle of a character. -.PP -One possible way to create an -.I mbstate_t -in initial state is to set it to zero: -.PP -.in +4n -.EX -mbstate_t state; -memset(&state, 0, sizeof(state)); -.EE -.in -.PP -On Linux, the following works as well, but might generate compiler warnings: -.PP -.in +4n -.EX -mbstate_t state = { 0 }; -.EE -.in -.PP -The function -.BR mbsinit () -tests whether -.I *ps -corresponds to an -initial state. -.SH RETURN VALUE -.BR mbsinit () -returns nonzero if -.I *ps -is an initial state, or if -.I ps -is NULL. -Otherwise, it returns 0. -.SH ATTRIBUTES -For an explanation of the terms used in this section, see -.BR attributes (7). -.ad l -.nh -.TS -allbox; -lbx lb lb -l l l. -Interface Attribute Value -T{ -.BR mbsinit () -T} Thread safety MT-Safe -.TE -.hy -.ad -.sp 1 -.SH STANDARDS -POSIX.1-2001, POSIX.1-2008, C99. -.SH NOTES -The behavior of -.BR mbsinit () -depends on the -.B LC_CTYPE -category of the -current locale. -.SH SEE ALSO -.BR mbrlen (3), -.BR mbrtowc (3), -.BR mbsrtowcs (3), -.BR wcrtomb (3), -.BR wcsrtombs (3) |