Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

OSS Library Calls (a - d) btowc(3)
NAME
btowc - Converts single-byte characater to wide-character
LIBRARY
H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll
SYNOPSIS
#include <wchar.h>
#include <stdio.h> /* optional except for POSIX.1 */
wint_t btowc(int c);
PARAMETERS
c The character to be evaluated and converted.
DESCRIPTION
The btowc( ) function determines whether the character c is a valid one-byte character. If c is a
valid one-byte character, the btowc( ) function converts the character to a wide-character.
RETURN VALUES
The btowc( ) function returns one of these values:
[WEOF] The c parameter has the value EOF or if c, as an unsigned character, is not a
valid one-byte character.
A wide-character representation of c
If c is a valid one-byte character, the btowc( ) function returns a wide-character
representation of c.
ERRORS
No errors are returned.
RELATED INFORMATION
Functions: wctob(3).
STANDARDS CONFORMANCE
The behavior of this function conforms to the ISO/IEC 9899:1999 standard.
527187-017 Hewlett-Packard Company 1−59