Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (M)
Guardian Procedure Calls Reference Manual—522629-013
9-53
MBCS_TRIMFRAGMENT_ Procedure
Parameters
bytestring input
STRING .EXT:ref:*
is a pointer to a buffer containing a text string which may contain any mixture of 1-
byte and MBCS characters. The content of the
bytestring pointer is not altered
by the trim operation.
bytecount input, output
INT .EXT:ref:1
on input, is an integer variable containing the length in bytes of the text string
bytestring.
on output, is an integer variable containing the length in bytes of the text string
bytestring. The output value will be less than the input value when a multibyte
character fragment has been found and trimmed from the text string.
charset input
INT:value
identifies the multibyte character set (MBCS) to be used. If
charset is omitted or
null, the MBCS returned from the MBCS_DEFAULTCHARSET_ procedure is used.
This procedure 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 supported by this procedure.
charinfo output
INT .EXT:ref:1
indicates the cause of failure of the requested test. This procedure may return an
indication that the specified character set is not recognized (-2), or of missing
required parameters (file-system error 29).
Related Programming Manual
For programming information about the MBCS_TRIMFRAGMENT_ procedure, refer to
the
Guardian Programmer’s Guide.