Difference: 0LASubrTextUpperToLower (1 vs. 4)

Revision 42023-04-10 - BrianRyan

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

.TEXT UPPER TO LOWER

Line: 36 to 36
 If you don't care about conserving the original data, you can pass the same field for both <converted_field> and <original_text>.

Also see .TEXT LOWER TO UPPER.

Added:
>
>
Note: This subroutine is designed to operate on Alpha, Text, and Token fields only. The returned results are undefined if you specify any other type of field.
 

Comments:

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

Revision 32018-01-03 - JeanNeron

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

.TEXT UPPER TO LOWER

Line: 9 to 9
 
      PASS         <converted_text>           FIELD            SHARE? Y
      PASS         <original_text>            FIELD            SHARE? N
      PASS         <convert_flag>             FIELD            SHARE? N

Added:
>
>
PASS <len_original_text> FIELD SHARE? N
  GOSUB --- .TEXT UPPER TO LOWER
    • Check for errors IF --- .TEXT UPPER TO LOWER NE
Line: 30 to 31
 
  • Allwords - leave the first character of the every word upper case, convert the rest.
If not PASSed, the default value is All.
Added:
>
>
<len_original_text> Optional - Release 6.0 + higher only. This is a optional performance enhancement to reduce the time required to perform the case conversion. You can PASS the maximum length you expect in <original_text>. For example, if your <original_text> field is 1M in size, but you know the data will never be longer than 22 characters, you can pass 22 in this field. If you PASS this field and your data is longer, it will be truncated to this length.
 If you don't care about conserving the original data, you can pass the same field for both <converted_field> and <original_text>.

Also see .TEXT LOWER TO UPPER.

Revision 22012-02-10 - JeanNeron

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

.TEXT UPPER TO LOWER

Line: 19 to 19
  This subroutine converts upper case to lower case in a text/alpha field. The first 2 parameters are required. If any required parameters are missing, the subroutine will CANCEL.
Changed:
<
<
<converted_field> is the field to receive the converted <original_text> (Required). This must be PASSed with Share "Y" to return the value.
>
>
<converted_field> returns the converted <original_text> (Required). This must be PASSed with Share "Y" to return the value.
  <original_text> is are the characters you want converted (Required).

Revision 12012-02-09 - JeanNeron

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

.TEXT UPPER TO LOWER

This subroutine converts upper case to lower case in a text/alpha field.


Usage:

      PASS         <converted_text>           FIELD            SHARE? Y
      PASS         <original_text>            FIELD            SHARE? N
      PASS         <convert_flag>             FIELD            SHARE? N
      GOSUB    --- .TEXT UPPER TO LOWER
      *        Check for errors
      IF       --- .TEXT UPPER TO LOWER       NE


Description:

This subroutine converts upper case to lower case in a text/alpha field. The first 2 parameters are required. If any required parameters are missing, the subroutine will CANCEL.

<converted_field> is the field to receive the converted <original_text> (Required). This must be PASSed with Share "Y" to return the value.

<original_text> is are the characters you want converted (Required).

<convert_flag> controls how the characters will be converted (Optional). If PASSed, it must be one of:

  • All - convert every character to lower case.
  • Firstword - leave the first character of the first word upper case, convert the rest.
  • Allwords - leave the first character of the every word upper case, convert the rest.
If not PASSed, the default value is All.

If you don't care about conserving the original data, you can pass the same field for both <converted_field> and <original_text>.

Also see .TEXT LOWER TO UPPER.

Comments:

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


<--/commentPlugin-->

-- JeanNeron - 2012-02-09

 
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