@RTFetchText
Syntax
@RTFetchText(HRT1;RETNUMBER2);
Description
Returns the text portion of HRT HRT1 as TEXT, portion by portion.
At the beginning, NUMBER RETNUMBER2 must contain 0.
NUMBER RETNUMBER2 specifies the SEGMENTPOINTER.
If there is more text to retrieve, @RTFetchText returns a value other than -1 in NUMBER RETNUMBER2.
If there is no more text to retrieve, NUMBER RETNUMBER2 contains -1.
Example: @RTFetchText(HRT1;RETNUMBER2)
RETNUMBER2:=0;
WHILE(RETNUMBER2!=-1)
{
TXT:=@RTFetchText(HRT1;RETNUMBER2);
IF(!@IsError(TXT))
{
@LogReport(TXT;7);
}
}
A typical text retrieval loop for large HRT fields.
The loop is executed until NUMBER RETNUMBER2 is equal to -1.
The text portions are assigned to TEXT TXT and output.
IMPORTANT:
These text portions will usually be too large to be output to the APILOG using @LogReport.
The second parameter of @RTFetchText must not be a fixed value; it must be a variable, because it is used to return the end status.
Note : This text was machine-translated and may contain inaccuracies.
