Difference: 0LASubrTextGetLength (1 vs. 4)

Revision 42018-03-22 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPXRuntimeSubroutineAPI"

.TEXT GET LENGTH

Line: 22 to 22
  <text_field> is the field whose length you want to determine (Required).
Changed:
<
<		<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>.
>
>		<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.

Comments:

Revision 32018-01-02 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPXRuntimeSubroutineAPI"

.TEXT GET LENGTH

Line: 8 to 8
 

Usage: 

      PASS         <text_len>                 FIELD            SHARE? Y
      PASS         <text_field>               FIELD            SHARE? N
Added:
>
>		 PASS <len_text_field> FIELD SHARE? N
  GOSUB --- .TEXT GET LENGTH
    • Check for errors IF --- .TEXT GET LENGTH NE
Line: 21 to 22
  <text_field> is the field whose length you want to determine (Required).
Added:
>
>		<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>.
 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.

Comments:

Revision 22012-02-10 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPXRuntimeSubroutineAPI"

.TEXT GET LENGTH

Line: 17 to 17
  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.
Changed:
<
<		<text_len> is the length of <text_field> (Required). This must be PASSed with Share "Y" to return the value.
>
>		<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).

Revision 12012-02-09 - JeanNeron

Line: 1 to 1
Added:
>
>
META TOPICPARENT name="APPXRuntimeSubroutineAPI"

.TEXT GET LENGTH

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


Usage: 

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

Description:

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> is 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).

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.

Comments:

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


<--/commentPlugin-->

-- JeanNeron - 2012-02-09

View topic | History: r4 < r3 < r2 < r1 | More topic actions...
 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback