wcrtomb.3 (58d38e25205c6ee5ef0796ffa2cd8e2ca6c6e7f3) wcrtomb.3 (279062fae149e105dae7c28b638d49ba5715725d)
1.\" Copyright (c) 2002 Tim J. Robbins
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.

--- 9 unchanged lines hidden (view full) ---

18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.\" $FreeBSD$
1.\" Copyright (c) 2002 Tim J. Robbins
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.

--- 9 unchanged lines hidden (view full) ---

18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.\" $FreeBSD$
26.\"
26.Dd August 15, 2002
27.Dt WCRTOMB 3
28.Os
29.Sh NAME
30.Nm wcrtomb
31.Nd "convert a wide-character code to a character (restartable)"
32.Sh LIBRARY
33.Lb libc

--- 29 unchanged lines hidden (view full) ---

63.Ft mbstate_t
64argument,
65.Fa ps ,
66is used to keep track of the shift state.
67If it is
68.Dv NULL ,
69.Fn wcrtomb
70uses an internal, static
27.Dd August 15, 2002
28.Dt WCRTOMB 3
29.Os
30.Sh NAME
31.Nm wcrtomb
32.Nd "convert a wide-character code to a character (restartable)"
33.Sh LIBRARY
34.Lb libc

--- 29 unchanged lines hidden (view full) ---

64.Ft mbstate_t
65argument,
66.Fa ps ,
67is used to keep track of the shift state.
68If it is
69.Dv NULL ,
70.Fn wcrtomb
71uses an internal, static
71.Ft mbstate_t
72.Vt mbstate_t
72object.
73.Sh RETURN VALUES
74The
75.Fn wcrtomb
76functions returns the length (in bytes) of the multibyte sequence
77needed to represent
78.Fa wc ,
79or
73object.
74.Sh RETURN VALUES
75The
76.Fn wcrtomb
77functions returns the length (in bytes) of the multibyte sequence
78needed to represent
79.Fa wc ,
80or
80.No ( Ns
81.Ft size_t Ns
82.No ) Ns \&-1
81.Po Vt size_t Pc Ns \-1
83if
84.Fa wc
85is not a valid wide character code.
86.Sh ERRORS
87The
88.Fn wcrtomb
89function will fail if:
90.Bl -tag -width Er

--- 16 unchanged lines hidden ---
82if
83.Fa wc
84is not a valid wide character code.
85.Sh ERRORS
86The
87.Fn wcrtomb
88function will fail if:
89.Bl -tag -width Er

--- 16 unchanged lines hidden ---