[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions, Volume 1


Japanese conv Subroutines

Purpose

Translates predefined Japanese character classes.

Library

Standard C Library (libc.a)

Syntax


#include <ctype.h>
int atojis ( Character)
int Character;


int jistoa (Character)
int Character;


int _atojis (Character)
int Character;


int _jistoa (Character)
int Character;


int tojupper (Character)
int Character;


int tojlower (Character)
int Character;


int _tojupper (Character)
int Character;


int _tojlower (Character)
int Character;


int toujis (Character)
int Character;


int kutentojis (Character)
int Character;


int tojhira (Character)
int Character;


int tojkata (Character)
int Character;

Description

When running the operating system with Japanese Language Support on your system, the legal value of the Character parameter is in the range from 0 to NLCOLMAX.

The jistoa subroutine converts an SJIS ASCII equivalent to the corresponding ASCII equivalent. The atojis subroutine converts an ASCII character to the corresponding SJIS equivalent. Other values are returned unchanged.

The _jistoa and _atojis routines are macros that function like the jistoa and atojis subroutines, but are faster and have no error checking function.

The tojlower subroutine converts a SJIS uppercase letter to the corresponding SJIS lowercase letter. The tojupper subroutine converts an SJIS lowercase letter to the corresponding SJIS uppercase letter. All other values are returned unchanged.

The _tojlower and _tojupper routines are macros that function like the tojlower and tojupper subroutines, but are faster and have no error-checking function.

The toujis subroutine sets all parameter bits that are not 16-bit SJIS code to 0.

The kutentojis subroutine converts a kuten code to the corresponding SJIS code. The kutentojis routine returns 0 if the given kuten code is invalid.

The tojhira subroutine converts an SJIS katakana character to its SJIS hiragana equivalent. Any value that is not an SJIS katakana character is returned unchanged.

The tojkata subroutine converts an SJIS hiragana character to its SJIS katakana equivalent. Any value that is not an SJIS hiragana character is returned unchanged.

The _tojhira and _tojkata subroutines attempt the same conversions without checking for valid input.

For all functions except the toujis subroutine, the out-of-range parameter values are returned without conversion.

Parameters


Character Character to be converted.
Pointer Pointer to the escape sequence.
CharacterPointer Pointer to a single NLchar data type.

Implementation Specifics

These subroutines are part of Base Operating System (BOS) Runtime.

Related Information

The ctype (ctype, isalpha, isupper, islower, isdigit, isxdigit, isalnum, isspace, ispunct, isprint, isgraph, iscntrl, or isascii Subroutines) subroutine, conv (conv Subroutines) subroutine, getc, getchar, fgetc, or getw (getc, getchar, fgetc, or getw Subroutine)subroutine, getwc, fgetwc, or getwchar (getwc, fgetwc, or getwchar Subroutine) subroutine, setlocale subroutine.

List of Character Manipulation Subroutines, National Language Support, Subroutines, Example Programs, and Libraries in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]