Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (M)
Guardian Procedure Calls Reference Manual522629-013
9-26
MBCS_FORMAT_CRT_FIELD_ Procedure
screen-start-col input, output
INT .EXT:ref:1
on input, contains the starting column on the current line of the screen where the
first displayable data character may appear.
on output, contains an integer which represents the sum of the
screen-start-
col and the displayable length of the data inserted into the field by the translate
function.
shift-to-MBCS input
STRING .EXT:ref:*
is an optional pointer to a string containing the escape, control, or other string to be
used to indicate a shift to a multibyte character set in the destination text string.
This string must always be in HP internal format (not EBCDIC), regardless of the
final form of the destination string. When not supplied, a default string is used by
the format routine (for Fujitsu terminals, it is [%H88, null]).
shift-to-one-byte input
STRING .EXT:ref:*
is an optional pointer to a string containing the escape, control, or other string to be
used to indicate a shift to a 1-byte character set in the destination text string. This
string must always be in HP internal format (not EBCDIC), regardless of the final
form of the destination string. When not supplied, a default string is used by the
format routine (for Fujitsu terminals, it is [%H89, null]).
startmode input
INT:value
specifies the optional start mode of the formatting operation. When this parameter
has a value of 1, the formatting operation begins in the 1-byte mode. When this
parameter has a value of 2, the formatting operation begins in the 2-byte (MBCS)
mode. If any other value is specified, or if this parameter is not used, the starting
mode is determined from the source string content. This parameter can be used to
force a start in MBCS mode for a string that begins with double spaces. This is the
only known ambiguous condition that might require the use of this parameter.
Consideration
Determining the size of the destination buffer is the responsibility of the calling
procedure.