LN API

Release Date: 5/17/17

LN: Length of String
The LN API allows the developer to pass a string with a maximum length of 4000 bytes. The system will determine the position of the last non-space character in the string and pass the position back through SCREEN-NUMERIC-FIELD.
Using this API call is faster than using a traditional loop that reads from the end of a string.

Screen-Parameters:
LN

Passing Variables:
Screen-Menu - Move the string to be evaluated to Screen-Menu before performing Screen-Routine.
Screen-Numeric-Field - Maximum length of the string being passed. If Screen-Numeric-Field is zero, the maximum length of 4000 is used when determining the length.

Return Values:
Screen-Numeric-Field - The length of the field will be returned in Screen-Numeric-Field.

Example:

In this example, a string with a maximum of 2048 characters will be examined.

MOVE PARSE-RECORD TO SCREEN-MENU.
MOVE 2048 TO SCREEN-NUMERIC-FIELD.
MOVE "LN" TO SCREEN-PARAMETERS.
PERFORM SCREEN-ROUTINE.
MOVE SCREEN-NUMERIC-FIELD TO LAST-POS.

Programs Modified: SCREEN.WS, SCREEN.PL, BIDSCRN.PL, CALLSCN.CBL, NWSMSCRN.CBL
CLS

Feedback and Knowledge Base