X-Git-Url: https://pd.if.org/git/?p=pdclib;a=blobdiff_plain;f=man3%2Fmbsinit.3;h=8c8e5443fd7c1827a699ab2b741d6c645c7a6dd9;hp=7e84ae11a68fed1f6cb8992d1c4685db093fa6a8;hb=abc15df6b9fae3374d24c7cf5c3ab94c605b2a6d;hpb=8894c921674bb116d0a7b8f23a55311e7a768019 diff --git a/man3/mbsinit.3 b/man3/mbsinit.3 index 7e84ae1..8c8e544 100644 --- a/man3/mbsinit.3 +++ b/man3/mbsinit.3 @@ -1,58 +1,58 @@ -.\" This file is part of the Public Domain C Library (PDCLib). -.\" Permission is granted to use, modify, and / or redistribute at will. -.\" -.Dd -.Dt MBSINIT 3 -.Os -.\" -.Sh NAME -.Nm mbsinit -.Nd determines multibyte conversion state -.\" -.Sh SYNOPSIS -.In wchar.h -.Fn "int mbsinit" "const mbstate_t *ps" -.In xlocale.h -.Fn "int mbsinit_l" "const mbstate_t *ps" "locale_t loc" -.\" -.Sh DESCRIPTION -.Fn mbsinit -and -.Fn mbsinit_l -shall return a nonzero value if the multibyte converison state pointed to by -.Va ps -corresponds to an initial conversion state. The interpretation of -.Va *ps -is locale dependent; the only guarantee is that an -.Vt mbstate_t -object initialized to zero shall correspond to an initial conversion state. If -.Va ps -is -.Dv NULL , -then a nonzero value shall be returned. -.\" -.Pp -The locale used for -.Fn mbsinit -shall be the currently active locale; either the current thread locale as set by -.Xr uselocale 3 -if one has been specified, or otherwise the global locale controlled by -.Xr setlocale 3 . -The locale used by -.Fn mbsinit_l -is that specified by -.Va loc . -.\" -.Sh SEE ALSO -.Xr mbrtowc 3 -.Xr wcrtomb 3 -.Xr setlocale 3 -.Xr uselocale 3 -.\" -.Sh STANDARDS -.Fn mbsinit -is first defined in -.St -isoC-amd1 ; -.Fn mbsinit_l -is a nonstandard extension originating in Darwin. See +.\" This file is part of the Public Domain C Library (PDCLib). +.\" Permission is granted to use, modify, and / or redistribute at will. +.\" +.Dd +.Dt MBSINIT 3 +.Os +.\" +.Sh NAME +.Nm mbsinit +.Nd determines multibyte conversion state +.\" +.Sh SYNOPSIS +.In wchar.h +.Fn "int mbsinit" "const mbstate_t *ps" +.In xlocale.h +.Fn "int mbsinit_l" "const mbstate_t *ps" "locale_t loc" +.\" +.Sh DESCRIPTION +.Fn mbsinit +and +.Fn mbsinit_l +shall return a nonzero value if the multibyte converison state pointed to by +.Va ps +corresponds to an initial conversion state. The interpretation of +.Va *ps +is locale dependent; the only guarantee is that an +.Vt mbstate_t +object initialized to zero shall correspond to an initial conversion state. If +.Va ps +is +.Dv NULL , +then a nonzero value shall be returned. +.\" +.Pp +The locale used for +.Fn mbsinit +shall be the currently active locale; either the current thread locale as set by +.Xr uselocale 3 +if one has been specified, or otherwise the global locale controlled by +.Xr setlocale 3 . +The locale used by +.Fn mbsinit_l +is that specified by +.Va loc . +.\" +.Sh SEE ALSO +.Xr mbrtowc 3 +.Xr wcrtomb 3 +.Xr setlocale 3 +.Xr uselocale 3 +.\" +.Sh STANDARDS +.Fn mbsinit +is first defined in +.St -isoC-amd1 ; +.Fn mbsinit_l +is a nonstandard extension originating in Darwin. See .Xr xlocale.h 3 \ No newline at end of file