LN API

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


    • Related Articles

    • ID API

      Release Date: 3/19/2019 The ID API will return the current Help ID (the current major Application program running in Elliott): MOVE "ID" TO SCREEN-PARAMETERS. PERFORM SCREEN-ROUTINE. MOVE SCREEN-ALPHA-FIELD TO MY-LOCAL-HELP-ID. In certain situations, ...

    • AP API

      AP API This API returns various values from the Shared Memory Area. For example: MOVE "AP" TO SCREEN-PARAMETERS MOVE "EDITOR" TO SCREEN-LITERAL PERFORM SCREEN-ROUTINE This returns the user’s preferred Editor in SCREEN-ALPHA-FIELD. The following ...

    • LF API

      Release Date: 9/7/2021 Versions: 8.0 and higher This API takes a filespec, like C:\WINDOWS\*.*, and returns the next file in the specified directory for each successive call. Screen Parameters Comment LF,nn Input: SCREEN-LITERAL contains the ...

    • CV API

      Release Date: 10/31/2019 This API allows the programmer to determine whether or not thie current company's .DAT files have been converted to .BTR files. Screen-Parameters: CV Check the converted status for the current company. CV,nn Check the ...

    • FN API

      FN: Format Number (New) This API call will allow the programmer to pass a numeric value in SCREEN-NUMERIC-FIELD. This field will be formatted based on type and maximum size provided, and the results will be passed back as follows: · ...