AIPS NRAO AIPS HELP file for LENGTH in 31DEC24



As of Fri Apr 19 16:10:24 2024


LENGTH: Function verb to return actual current length of string

INPUTS

          NO adverbs.  Instead, LENGTH takes one argument
                     LENGTH (string)
          where string is any scalar string.  The character
          position of the last non-blank character in string is
          returned on the stack.  Note: LENGTH ('    ') is 0.

HELP SECTION

LENGTH
Type:  Verb      (function: leaves results on the stack)
Use:   To obtain the character position of the last non-blank
       character in a string adverb.  LENGTH requires 1
       immediate argument as
                     LENGTH (string)
       where string is any scalar string.  Examples:
            LENGTH ('  CALIB')    is  7.0.
            SUBSTR (OUTNAME, 1, LENGTH (OUTNAME)) is the
       current OUTNAME string stripped of trailing blanks and
       might be used in a procedure as
            IF LENG(OUTN) <= 8 THEN;
               OUTN = SUBSTR (OUTN, 1, LENG(OUTN)) !! ' CAL'
               END
Adverbs:   none.

EXPLAIN SECTION


AIPS