Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (M)
Guardian Procedure Calls Reference Manual—522629-013
9-24
MBCS_FORMAT_CRT_FIELD_ Procedure
Syntax for TAL Programmers
Parameters
error-code returned value
INT
returns a procedure error code.
0 Successful completion of the translation
-1 Source string translation incomplete, ran out of destination buffer area or ran
out of space in the screen field
-2 Unknown terminal type specified
-3 Invalid source string length
-4 Invalid character in Kanji-only source string
-5 Control string parameter too long
29 Required parameter missing
source-string input, output
INT(32) .EXT:ref:1
is the address of an extended address pointer to the source text string to be
formatted. Upon return from the format function, this pointer points to the first
unformatted byte in the source string. When the entire source string has been
formatted, this pointer points to the position beyond the last byte of the source
string.
destination-string input, output
INT(32) .EXT:ref:1
is the address of an extended address pointer to the location to receive the
formatted text string. Upon return from the format function, this pointer points to
the first unfilled byte in the destination string.
error-code := MBCS_FORMAT_CRT_FIELD_
( source-string ! i,o
,destination-string ! i,o
,source-length ! i
,maximum-length ! i
,intermediate ! i
,terminal-type ! i
,last-column, ! i
,max-data-size ! i,o
,screen-start-col ! i,o
,[ shift-to-MBCS ] ! i
,[ shift-to-one-byte ] ! i
,[ startmode ] ); ! i