From kido@vnet.IBM.COM Mon Mar 15 02:56:16 1993 Received: from vnet.IBM.COM ([192.239.48.4]) by dkuug.dk with SMTP id AA28998 (5.65c8/IDA-1.4.4j for ); Mon, 15 Mar 1993 02:56:16 +0100 Message-Id: <199303150156.AA28998@dkuug.dk> Received: from YMTVM8 by vnet.IBM.COM (IBM VM SMTP V2R2) with BSMTP id 4001; Sun, 14 Mar 93 20:55:36 EST Date: Mon, 15 Mar 93 10:55:58 JST From: "Akio Kido" To: sc22wg15@dkuug.dk, sc22wg20@dkuug.dk, XoJIG@xopen.co.uk, sig-international@osf.org, uojlg-bse@uiap.ui.org, efischer@donald.aix.kingston.ibm.com Subject: MSE 4.5.1.mm X-Charset: ASCII X-Char-Esc: 29 .SK .H 2 "Extended multibyte and wide character utilities \*(Cw\fP" .H 3 Introduction .P The header .Cf declares five data types, one tag, one macro and many functions.\*F .FS See ``future library directions'' (4.6.1). .FE .P The types declared are .Cf wchar_t and .Cf size_t (both described in \*(AC subclause 7.1.6), .Cb mbstate_t .Ce which is a nonarray object type that can hold the conversion state information necessary to convert between sequences of multibyte characters and wide characters, .Cb wctype_t .Ce which is a scalar type that can hold values which represent locale-specific character classification, and .Cb wint_t .Ce which is an integral type that can hold any .Cf wchar_t value as well as at least one value that does not correspond to any member of the extended character set. (See .Cf WEOF below.) .P The tag .Cf tm is declared as naming an incomplete structure type, the contents of which are described in \*(AC subclause 7.12.1. .P The macro defined is .Cb WEOF .Ce which expands to a constant expression of type .Cf wint_t whose value does not correspond to any member of the extended character set.\*F\ .FS The value of the macro .Cf WEOF may differ from that of .Cf EOF and need not be negative. .FE It is returned by several functions to indicate .IR end-of-file , that is, no more input from a stream. .P The functions declared are grouped as follows: .DL .LI Functions that provide wide character classification and case conversion; .LI Functions that perform input and output of wide characters, or multibyte characters, or both; .LI Functions that provide wide string numeric conversion; .LI Functions that perform general wide string manipulation; .LI A function for wide string date and time conversion; and .LI Functions that provide extended capabilities for conversion between multibyte and wide character sequences. .LE .P The identifiers with external linkage listed in this subclause (4.5) are reserved for use as identifiers with external linkage only if at least one inclusion of .Cf occurs in one or more of the translation units that constitute the program.\*F .FS This behavior differs from those identifiers with external linkage associated with the headers listed in and referenced by \*(AC subclauses 7.1.2 and 7.1.3, which are always reserved. .FE