Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (M)
Guardian Procedure Calls Reference Manual—522629-013
9-35
MBCS_REPLACEBLANK_ Procedure
is a pointer to a buffer containing a properly formed text string that may contain any
mixture of 1-byte and MBCS characters. A properly formed text string may not
begin with the second or subsequent byte of an MBCS character or end with any
byte of a MBCS character other than the last. (See the MBCS_TRIMFRAGMENT_
procedure.) The contents of the
bytestring pointer are not altered by the shift
operation.
bytecount input
INT:value
is an integer variable containing the length in bytes of the text string
bytestring.
charset input
INT:value
identifies the multibyte character set (MBCS) to be used. If
charset is omitted or
null, the default MBCS from the MBCS_DEFAULTCHARSET_ procedure is used.
MBCS_REPLACEBLANK_ does not examine or validate the character set
identification but simply passes it on to the MBCS_CHAR_ procedure. All MBCSs
supported by the MBCS_CHAR_ procedure are inherently supported by this
procedure. This procedure replaces different multibyte character pairs depending
on the
charset value.
charinfo input, output
INT .EXT:ref:1
indicates the cause of failure of the requested test. This procedure returns file-
system error 29 to indicate missing required parameters; other error indications are
passed back from the MBCS_CHAR_ procedure. See the MBCS_CHAR_
procedure description for returned values and interpretations. Upon return of an
error from the MBCS_CHAR_ procedure, the operation is aborted and processing
is returned to the caller.
Considerations
Except for the HP Hangul data format, none of the supported internal MBCS data
formats use character definitions that include single-byte values of %H20 in
combination with other values to form multibyte characters. In other words, with the
exception of HP Hangul, none of the characters of the supported internal multibyte
charset Character Becomes
HP Kanji %H8140 %H2020
HP Hangul %HFC20 %H2020
HP Chinese Big 5
%HA140 %H2020
HP Chinese PC
%H8140 %H2020
HP KSC5601
%HA1A1 %H2020