Source-Changes-HG archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

[src/trunk]: src/lib/libc/locale - add btowc.3 / wctob.3.



details:   https://anonhg.NetBSD.org/src/rev/66d7b2c1b088
branches:  trunk
changeset: 543739:66d7b2c1b088
user:      tshiozak <tshiozak%NetBSD.org@localhost>
date:      Mon Mar 03 08:24:58 2003 +0000

description:
- add btowc.3 / wctob.3.
- fix an unappropriate comment in wctob.c

diffstat:

 lib/libc/locale/Makefile.inc |   6 +-
 lib/libc/locale/btowc.3      |  83 ++++++++++++++++++++++++++++++++++++++++++++
 lib/libc/locale/wctob.3      |  83 ++++++++++++++++++++++++++++++++++++++++++++
 lib/libc/locale/wctob.c      |   6 +-
 4 files changed, 172 insertions(+), 6 deletions(-)

diffs (223 lines):

diff -r def3a296beaf -r 66d7b2c1b088 lib/libc/locale/Makefile.inc
--- a/lib/libc/locale/Makefile.inc      Mon Mar 03 07:39:53 2003 +0000
+++ b/lib/libc/locale/Makefile.inc      Mon Mar 03 08:24:58 2003 +0000
@@ -1,5 +1,5 @@
 #      from: @(#)Makefile.inc  5.1 (Berkeley) 2/18/91
-#      $NetBSD: Makefile.inc,v 1.41 2003/03/03 07:39:54 tshiozak Exp $
+#      $NetBSD: Makefile.inc,v 1.42 2003/03/03 08:24:58 tshiozak Exp $
 
 # locale sources
 .PATH: ${ARCHDIR}/locale ${.CURDIR}/locale
@@ -29,9 +29,9 @@
 SRCS+= ___runetype_mb.c _wctrans.c iswctype.c multibyte_c90.c \
        multibyte_amd1.c rune.c runeglue.c runetable.c setrunelocale.c
 .endif
-MAN+=  iswalnum.3 towlower.3 mblen.3 mbrlen.3 mbrtowc.3 mbsinit.3 \
+MAN+=  btowc.3 iswalnum.3 towlower.3 mblen.3 mbrlen.3 mbrtowc.3 mbsinit.3 \
        mbsrtowcs.3 mbstowcs.3 mbtowc.3 wcrtomb.3 wcsrtombs.3 wcstombs.3 \
-       wctomb.3
+       wctob.3 wctomb.3
 
 
 MLINKS+=iswalnum.3 iswalpha.3 iswalnum.3 iswblank.3 \
diff -r def3a296beaf -r 66d7b2c1b088 lib/libc/locale/btowc.3
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/lib/libc/locale/btowc.3   Mon Mar 03 08:24:58 2003 +0000
@@ -0,0 +1,83 @@
+.\" $NetBSD: btowc.3,v 1.1 2003/03/03 08:24:58 tshiozak Exp $
+.\"
+.\" Copyright (c)2003 Citrus Project,
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.Dd March 3, 2003
+.Dt BTOWC 3
+.Os
+.\" ----------------------------------------------------------------------
+.Sh NAME
+.Nm btowc
+.Nd convert a single byte character to a wide character
+.\" ----------------------------------------------------------------------
+.Sh LIBRARY
+.Lb libc
+.\" ----------------------------------------------------------------------
+.Sh SYNOPSIS
+.Fd #include \*[Lt]wchar.h\*[Gt]
+.Ft wint_t
+.Fn btowc "int c"
+.\" ----------------------------------------------------------------------
+.Sh DESCRIPTION
+The
+.Fn btowc
+function converts a single byte character
+.Fa c
+in the initial shift state of the current locale to a corresponding
+wide character.
+.Pp
+The behaviour of the
+.Fn btowc
+is affected by LC_CTYPE category of the current locale.
+.\" ----------------------------------------------------------------------
+.Sh RETURN VALUES
+The
+.Fn btowc
+returns:
+.Bl -tag -width 012345678901
+.It WEOF
+if
+.Fa c
+is EOF or if (unsigned char)
+.Fa c
+does not correspond to a valid single byte character representation.
+.It (otherwise)
+a wide character corresponding to
+.Fa c .
+.El
+.\" ----------------------------------------------------------------------
+.Sh ERRORS
+No errors are defined.
+.\" ----------------------------------------------------------------------
+.Sh SEE ALSO
+.Xr wctob 3 ,
+.Xr mbrtowc 3 ,
+.Xr setlocale 3
+.\" ----------------------------------------------------------------------
+.Sh STANDARDS
+The
+.Fn btowc
+function conforms to
+.St -isoC-amd1 .
diff -r def3a296beaf -r 66d7b2c1b088 lib/libc/locale/wctob.3
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/lib/libc/locale/wctob.3   Mon Mar 03 08:24:58 2003 +0000
@@ -0,0 +1,83 @@
+.\" $NetBSD: wctob.3,v 1.1 2003/03/03 08:24:59 tshiozak Exp $
+.\"
+.\" Copyright (c)2003 Citrus Project,
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.Dd March 3, 2003
+.Dt WCTOB 3
+.Os
+.\" ----------------------------------------------------------------------
+.Sh NAME
+.Nm wctob
+.Nd convert a wide character to a single byte character
+.\" ----------------------------------------------------------------------
+.Sh LIBRARY
+.Lb libc
+.\" ----------------------------------------------------------------------
+.Sh SYNOPSIS
+.Fd #include \*[Lt]wchar.h\*[Gt]
+.Ft int
+.Fn wctob "wint_t wc"
+.\" ----------------------------------------------------------------------
+.Sh DESCRIPTION
+The
+.Fn wctob
+function converts a wide character
+.Fa wc
+to a corresponding single byte character in the initial shift state of
+the current locale.
+.Pp
+The behaviour of the
+.Fn wctob
+is affected by LC_CTYPE category of the current locale.
+.\" ----------------------------------------------------------------------
+.Sh RETURN VALUES
+The
+.Fn wctob
+returns:
+.Bl -tag -width 012345678901
+.It EOF
+if
+.Fa wc
+is WEOF or if
+.Fa wc
+does not correspond to a valid single byte character representation.
+.It (otherwise)
+a single byte character corresponding to
+.Fa wc .
+.El
+.\" ----------------------------------------------------------------------
+.Sh ERRORS
+No errors are defined.
+.\" ----------------------------------------------------------------------
+.Sh SEE ALSO
+.Xr btowc 3 ,
+.Xr wcrtomb 3 ,
+.Xr setlocale 3
+.\" ----------------------------------------------------------------------
+.Sh STANDARDS
+The
+.Fn wctob
+function conforms to
+.St -isoC-amd1 .
diff -r def3a296beaf -r 66d7b2c1b088 lib/libc/locale/wctob.c
--- a/lib/libc/locale/wctob.c   Mon Mar 03 07:39:53 2003 +0000
+++ b/lib/libc/locale/wctob.c   Mon Mar 03 08:24:58 2003 +0000
@@ -1,4 +1,4 @@
-/*     $NetBSD: wctob.c,v 1.1 2003/03/03 07:39:55 tshiozak Exp $       */
+/*     $NetBSD: wctob.c,v 1.2 2003/03/03 08:25:00 tshiozak Exp $       */
 
 /*-
  * Copyright (c)2003 Citrus Project,
@@ -28,7 +28,7 @@
 
 #include <sys/cdefs.h>
 #if defined(LIBC_SCCS) && !defined(lint)
-__RCSID("$NetBSD: wctob.c,v 1.1 2003/03/03 07:39:55 tshiozak Exp $");
+__RCSID("$NetBSD: wctob.c,v 1.2 2003/03/03 08:25:00 tshiozak Exp $");
 #endif /* LIBC_SCCS and not lint */
 
 #include "namespace.h"
@@ -39,7 +39,7 @@
 #include <limits.h>
 
 /*
- * convert a single byte character to a corresponding wide character.
+ * convert a wide character to a corresponding single byte character.
  */
 int
 wctob(wc)



Home | Main Index | Thread Index | Old Index