Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Standard C Library Functionsbtowc(3C)


NAME

 btowc - single-byte to wide-character conversion

SYNOPSIS

 
#include <stdio.h>
#include <wchar.h>
wint_t btowc(int c);

DESCRIPTION

 

The btowc() function determines whether c constitutes a valid (one-byte) character in the initial shift state.

The behavior of this function is affected by the LC_CTYPE category of the current locale. See environ(5).

RETURN VALUES

 

The btowc() function returns WEOF if c has the value EOF or if (unsigned char)c does not constitute a valid (one-byte) character in the initial shift state. Otherwise, it returns the wide-character representation of that character.

ERRORS

 

No errors are defined.

ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelMT-Safe with exceptions

SEE ALSO

 

setlocale(3C), wctob(3C), attributes(5), environ(5)

NOTES

 

The btowc() function can be used safely in multithreaded applications, as long as setlocale(3C) is not being called to change the locale.


SunOS 5.9Go To TopLast Changed 3 Feb 1998

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.