mbtowc man page on Ultrix

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

mbtowc(3int)							  mbtowc(3int)

Name
       mbtowc - converts a single multibyte character into a character of type
       wchar_t

Syntax
       #include <stdlib.h>

       int mbtowc (pwc, s, n)
       wchar_t *pwc;
       const char *s;
       size_t n;

Arguments
       pwc     The pwc argument is a pointer to the resulting object  of  type
	       wchar_t.

       s       The s argument is a pointer to a multibyte character.

       n       The  n argument is the maximum number of bytes of object s that
	       are examined.

Description
       If s is not a null pointer, the function determines the number of bytes
       that  comprise the multibyte character pointed to by s.	It then deter‐
       mines the character code for the value (of type	wchar_t)  that	corre‐
       sponds to that multibyte character (the value of the code corresponding
       to the null character is zero). If the multibyte character is valid and
       pwc  is	not a null pointer, the function stores the code in the object
       pointed to by pwc.  At most n bytes of the array pointed to  by	s  are
       examined.   This	 function  is affected by the LC_CTYPE category of the
       current locale.

Return Values
       If s is a null pointer, the function returns a zero value.  If s is not
       a null pointer, the function returns:

	  ·  0, if s points to the null character

	  ·  The number of bytes that comprise the converted multibyte charac‐
	     ter, if the next n or fewer bytes form a valid multibyte  charac‐
	     ter

	  ·  -	-1, if the next n or fewer bytes do not form a valid multibyte
	     character

       In no case is the value returned greater than n or  the	value  of  the
       MB_CUR_MAX macro.

See Also
       mblen(3int),	mbstowcs(3int),	    setlocale(3int),	 wctomb(3int),
       wcstombs(3int)

								  mbtowc(3int)
[top]

List of man pages available for Ultrix

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