Guardian Procedure Calls Reference Manual

MBCS_REPLACEBLANK_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Related Programming Manual
Summary
The MBCS_REPLACEBLANK_ procedure replaces nonstandard blanks.
Within multibyte character sets, there are usually characters defined that have a blank display
attribute of the same width as the other multibyte characters of the same character set. Since these
characters do not have an internal representation that is recognized by HP subsystems as blanks,
they cannot be used as word separators or delimiters in the same manner as the one-byte space
character.
HP recommends that multibyte strings of blanks be used instead of normally defined multibyte
character blanks. It is not possible to guarantee that this recommendation will always be followed,
so it is also recommended that data be processed to replace the multibyte blanks of the current
character set with blank strings of equivalent length. This procedure allows callers to replace the
normally-defined multibyte blank characters with equivalent-sized strings of blank (%H20) characters.
Syntax for C Programmers
#include <cextdecs(MBCS_REPLACEBLANK_)>
void MBCS_REPLACEBLANK_ ( char *bytestring
,short bytecount
,[ short charset ]
,[ short *charinfo ] );
Syntax for TAL Programmers
CALL MBCS_REPLACEBLANK_ ( bytestring ! i
,bytecount ! i
,[ charset ] ! i
,[ charinfo ] ); ! i,o
Parameters
bytestring
input
STRING .EXT:ref:*
is a pointer to a buffer containing a properly formed text string that may contain any mixture
of one-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 (page 826).) 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.
MBCS_REPLACEBLANK_ Procedure 811