multibyte.3 (bc0b3a180015087b0d8d3a1e4e4f881271d209f0) multibyte.3 (8b8109275c1a583e96171df08e3136151c02279e)
1.\" Copyright (c) 2002, 2003 Tim J. Robbins. All rights reserved.
1.\" Copyright (c) 2002-2004 Tim J. Robbins. All rights reserved.
2.\" Copyright (c) 1993
3.\" The Regents of the University of California. All rights reserved.
4.\"
5.\" This code is derived from software contributed to Berkeley by
6.\" Donn Seeley of BSDI.
7.\"
8.\" Redistribution and use in source and binary forms, with or without
9.\" modification, are permitted provided that the following conditions

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

31.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
32.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
33.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34.\" SUCH DAMAGE.
35.\"
36.\" @(#)multibyte.3 8.1 (Berkeley) 6/4/93
37.\" $FreeBSD$
38.\"
2.\" Copyright (c) 1993
3.\" The Regents of the University of California. All rights reserved.
4.\"
5.\" This code is derived from software contributed to Berkeley by
6.\" Donn Seeley of BSDI.
7.\"
8.\" Redistribution and use in source and binary forms, with or without
9.\" modification, are permitted provided that the following conditions

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

31.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
32.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
33.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34.\" SUCH DAMAGE.
35.\"
36.\" @(#)multibyte.3 8.1 (Berkeley) 6/4/93
37.\" $FreeBSD$
38.\"
39.Dd December 7, 2003
39.Dd April 8, 2004
40.Dt MULTIBYTE 3
41.Os
42.Sh NAME
43.Nm multibyte
44.Nd multibyte and wide character manipulation functions
45.Sh LIBRARY
46.Lb libc
47.Sh SYNOPSIS

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

113and the character with value 0
114(the null byte)
115is recognized as the multibyte character string terminator.
116Null bytes are not permitted within multibyte characters.
117.Pp
118The C library provides the following functions for dealing with
119multibyte characters:
120.Bl -column "Description"
40.Dt MULTIBYTE 3
41.Os
42.Sh NAME
43.Nm multibyte
44.Nd multibyte and wide character manipulation functions
45.Sh LIBRARY
46.Lb libc
47.Sh SYNOPSIS

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

113and the character with value 0
114(the null byte)
115is recognized as the multibyte character string terminator.
116Null bytes are not permitted within multibyte characters.
117.Pp
118The C library provides the following functions for dealing with
119multibyte characters:
120.Bl -column "Description"
121.It Sy "Function Description"
121.It Sy "Function Description"
122.It "mblen get number of bytes in a character"
123.It "mbrlen get number of bytes in a character (restartable)"
124.It "mbrtowc convert a character to a wide-character code (restartable)"
125.It "mbsrtowcs convert a character string to a wide-character string (restartable)"
126.It "mbstowcs convert a character string to a wide-character string"
127.It "mbtowc convert a character to a wide-character code"
128.It "wcrtomb convert a wide-character code to a character (restartable)"
129.It "wcstombs convert a wide-character string to a character string"

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

139.Xr gb18030 5 ,
140.Xr gb2312 5 ,
141.Xr gbk 5 ,
142.Xr mskanji 5 ,
143.Xr utf2 5 ,
144.Xr utf8 5
145.Sh STANDARDS
146These functions conform to
122.It "mblen get number of bytes in a character"
123.It "mbrlen get number of bytes in a character (restartable)"
124.It "mbrtowc convert a character to a wide-character code (restartable)"
125.It "mbsrtowcs convert a character string to a wide-character string (restartable)"
126.It "mbstowcs convert a character string to a wide-character string"
127.It "mbtowc convert a character to a wide-character code"
128.It "wcrtomb convert a wide-character code to a character (restartable)"
129.It "wcstombs convert a wide-character string to a character string"

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

139.Xr gb18030 5 ,
140.Xr gb2312 5 ,
141.Xr gbk 5 ,
142.Xr mskanji 5 ,
143.Xr utf2 5 ,
144.Xr utf8 5
145.Sh STANDARDS
146These functions conform to
147.St -isoC
148and
149.St -isoC-99
150as documented in their individual manual pages.
151.Sh BUGS
152The current implementation does not support shift states.
147.St -isoC-99 .