create new tag
view all tags


This subroutine determines the length of a text/alpha field.


      PASS         <text_len>                 FIELD            SHARE? Y
      PASS         <text_field>               FIELD            SHARE? N
      PASS         <len_text_field>           FIELD            SHARE? N
      *        Check for errors
      IF       --- .TEXT GET LENGTH           NE


This subroutine determines the length of a text/alpha field. The both parameters are required. If any required parameters are missing, the subroutine will CANCEL.

<text_len> returns the length of <text_field> (Required). This must be PASSed with Share "Y" to return the value.

<text_field> is the field whose length you want to determine (Required).

<len_text_field> Optional - Release 6.0 + higher only. This is a optional performance enhancement to reduce the time required to determine the length of the <text_field>. You can PASS the maximum length you expect in <text_field>. For example, if your <text_field> is 1M in size, but you know the data will never be longer than 22 characters, you can pass 22 in the field to reduce the time the it takes the engine to determine the actual length of the data. However, note that you will never get a <text_len> greater than <len_text_field>. Default value is the full length of <text_field>.

Note that if you pass a non text field in <text_field>, it will be converted to an alpha field according to the rules of the SET command, and the length of that field returned.


Read what other users have said about this page or add your own comments.

-- JeanNeron - 2012-02-09

Edit | Attach | Watch | Print version | History: r4 < r3 < r2 < r1 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r4 - 2018-03-22 - JeanNeron
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2019 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback