Caché ObjectScript Reference
$ZZENKAKU
[Back] 
   
Server:docs2
Instance:LATEST
User:UnknownUser
 
-
Go to:
Search:    

Converts Japanese katakana characters from half-width to full-width.
Synopsis
$ZZENKAKU(expression,flag1,flag2)
Parameters
expression A string containing half-width characters. These characters may be katakana characters, Roman alphabet letters, or numbers.
flag1 Optional — A boolean flag to indicate whether conversion to full-width hiragana (0) or conversion to full-width katakana (1) is required.
flag2 Optional — A boolean flag to indicate whether voiced sound processing is required (1) or not required (0).
Description
$ZZENKAKU is a DSM-J function available in Unicode versions of Caché. It is used for converting Japanese katakana characters from half-width (hankaku) to full-width (zenkaku) characters. It also converts strings of Roman alphabet letters ("ABC") and Arabic numbers (123) from half-width to full-width.
$ZZENKAKU can, optionally, convert half-width katakana to full-width hiragana. Katakana characters are commonly used for foreign terms and foreign loan words; they can be represented as half-width or full-width characters. Hiragana characters are the more standard way of writing Japanese. Hiragana is always full-width.
If flag1 is 0, $ZZENKAKU converts printable ASCII characters to their full-width counterparts and converts half-width katakana characters to full-width hiragana characters. The default value for flag1 is 0.
If flag1 is 1, $ZZENKAKU converts printable ASCII characters to their full-width counterparts and converts half-width katakana characters to full-width katakana characters.
If flag2 is 1 and a half-width katakana character is followed by a voice sound mark or a semi-voice sound mark, then (if appropriate) $ZZENKAKU combines the half-width katakana character and the sound mark character into a target full-width hiragana or katakana character. The default value for flag2 is 1.
Note:
$ZZENKAKU can be abbreviated as $ZZ in DSM-J mode. This abbreviation cannot be used in Caché mode.
The Japanese language modes are DSM-J (language mode 6) and DTM-J (language mode 7). To determine or to change the current language mode, and for a list of available language modes, see the LanguageMode() method of the %SYSTEM.Process class.
You can set the physical cursor to use two physical spaces for a character as system-wide behavior by setting the PhysicalCursor property of the Config.NLS.Locales class.
The $WASCII function (and other $W functions) supports surrogate pairs of characters used to encode some Japanese kanji characters. For the ZFWCHARZ and ZHWKATAZ Japanese language pattern match codes, refer to Pattern Matching in Using Caché ObjectScript.
See Also