Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (M)

Guardian Procedure Calls Reference Manual—522629-013

9-34

MBCS_REPLACEBLANK_ Procedure

Summary

Syntax for C Programmers

Sytax 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 1-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

Sytax for TAL Programmers

Parameters

bytestring input

STRING .EXT:ref:*

#include <cextdecs(MBCS_REPLACEBLANK_)>

void MBCS_REPLACEBLANK_ ( char *bytestring

,short bytecount

,[ short charset ]

,[ short *charinfo ] );

CALL MBCS_REPLACEBLANK_ ( bytestring ! i

,bytecount ! i

,[ charset ] ! i

,[ charinfo ] ); ! i,o