|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).|
$ZZENKAKU converts 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 is only available in Unicode versions of Caché.
$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.
$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.
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.
The following example returns the half-with katakana characters “a”, “me”, “ri”, ka” (America):
The following example converts these half-with katakana characters to the corresponding full-width katakana characters:
The following examples both convert these half-with katakana characters to the corresponding full-width hiragana characters. Note that $ZZENKAKU converts from katakana to hiragana by default: