Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (M)
Guardian Procedure Calls Reference Manual—522629-013
9-5
MBCS_CHAR_ Procedure
nonzero indicates that the character set is a supported MBCS, and
testmbcschar points to the first byte of a valid character of
charset MBCS. For 2-byte character sets, the returned value is the
integer value of the sixteen bits which form the multibyte character,
using byte-1 as the high order byte and byte-2 as the low order byte of
the pair. All currently supported MBCSs are 2-byte character sets.
testmbcschar input
STRING .EXT:ref:*
is an extended pointer to the first of a group of bytes to be tested for membership
in the MBCS identified by the
charset parameter. The caller is responsible for
ensuring legitimate access to all bytes of the group. All bytes are range tested for
valid membership in the specified character set. If any byte fails the range test, the
group fails and FALSE is returned. The
testmbcschar pointer is not altered by
the MBCS_CHAR_ procedure.
charset input
INT:value
identifies the MBCS to be used. If
charset is omitted or null, the default MBCS
identifier returned from the MBCS_DEFAULTCHARSET_ is used.
The following MBCSs are supported by the MBCS_CHAR_ procedure:
1 HP Kanji
9 HP Hangul
10 HP Chinese Big 5
11 HP Chinese PC
12 HP KSC5601
charinfo input, output
INT .EXT:1
on input,
charinfo specifies the number of bytes, beginning with
testmbcschar, that may be read by the MBCS_CHAR_ procedure. If charinfo
is equal to or greater than the size of a single multibyte character of the MBCS
identified by
charset, the MBCS_CHAR_ procedure tests for the presence of a
multibyte character. If the integer value supplied in
charinfo is less than the size
of a single multibyte character of the MBCS identified by
charset, no test is made
and FALSE with no error indication is returned. When omitted, it is assumed that
at least enough bytes can be read to compose a single multibyte character of the
MBCS identified by
charset. There is no null value for this parameter.
If
charinfo is returned on output, it provides the following information:
when
result is nonzero:
<0:7> contains the display size (in columns) of the multibyte character
identified by the test.