mbsinit man page on Tru64

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
Tru64 logo
[printable version]

mbsinit(3)							    mbsinit(3)

NAME
       mbsinit - Determine whether a multibyte-character string is in the ini‐
       tial conversion state

SYNOPSIS
       #include <wchar.h>

       int mbsinit(
	       const mbstate_t *ps );

LIBRARY
       Standard C Library (libc)

STANDARDS
       Interfaces documented on this reference page conform to industry	 stan‐
       dards as follows:

       mbsinit(): XSH5.0

       Refer  to  the  standards(5)  reference page for more information about
       industry standards and associated tags.

PARAMETERS
       Points to an mbstate_t object, which describes the conversion state  of
       the  current  character in the string being converted. The initial con‐
       version state for conversion in either direction	 (multibyte  to	 wide-
       character  format  or  the reverse) corresponds to the beginning of the
       character's multibyte encoding sequence in the initial shift  state  as
       defined by the LC_TYPE category of the current locale.

DESCRIPTION
       The  mbsinit()  function	 determines whether the sequence of characters
       being converted is in the initial conversion state; that is, the	 func‐
       tion  determines whether the multibyte encoding for the current charac‐
       ter in this sequence is in the initial shift state as  defined  by  the
       LC_TYPE	category of the current locale. The application can use a zero
       return, which indicates that the character sequence is not  in  initial
       conversion state, to initiate a conversion operation.

       Use  this  function  along  with	 the  restartable conversion functions
       (mbrlen, mbrtowc, wcrtomb, mbsrtowcs,  wcsrtombs)  to  convert  between
       multibyte-character and wide-character format. Only restartable conver‐
       sion functions use an  mbstate_t	 parameter,  such  as  ps.  Therefore,
       results	are  undefined	when restartable and nonrestartable conversion
       functions operate on the same arrays of characters during a  conversion
       operation.  Results  are also undefined when ps is first altered by any
       of the restartable conversion functions and then used by	 another  call
       in  any	of the following ways: With a different sequence of characters
       In the reverse conversion direction Under a different LC_CTYPE  setting
       than on earlier function calls

RESTRICTIONS
       [Tru64  UNIX]  The  mbsinit() function and restartable versions of con‐
       version routines are functional only when used with locales  that  sup‐
       port  shift  state  encoding.  Currently, the operating system does not
       provide any locales that use shift state	 encoding  and	the  mbsinit()
       function	 returns  a  nonzero value only to indicate that *ps is a null
       pointer.

RETURN VALUES
       The mbsinit() function returns a nonzero value if *ps is a null pointer
       or  ps  describes  an initial conversion state; otherwise, the function
       returns zero.

SEE ALSO
       Functions: mblen(3), mbstowcs(3), mbtowc(3), wcstombs(3), wctomb(3)

       Files: locale(4)

								    mbsinit(3)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Tru64

List of man pages available for Tru64

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net