Tags:
create new tag
view all tags

.TEXT CREATE PAD

This subroutine fills a field with a single character.


Usage:

      PASS         <text_field>               FIELD            SHARE? Y
      PASS         <pad_char>                 FIELD            SHARE? N
      PASS         <pad_length>               FIELD            SHARE? N
      GOSUB    --- .TEXT CREATE PAD
      *        Check for errors
      IF       --- .TEXT CREATE PAD           NE


Description:

This subroutine fills a field with a single character. The first 2 parameters are required. If any required parameters are missing, the subroutine will CANCEL.

<text_field> is the field you want filled with <pad_char> (Required). This must be PASSed with Share "Y" to return the value.

<pad_char> is the character to fill with (Required).

<pad_length> is the number of characters to place into <text_field> (Optional). The default is to fill the entire field.

Note that this does not append the <pad_char> to <text_field>, it completely replaces any existing data in <text_field>.

Release 6.0 & higher support text fields up to 1M in size.

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.


-- JeanNeron - 2012-02-09

Edit | Attach | Watch | Print version | History: r3 < r2 < r1 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r3 - 2023-04-10 - BrianRyan
 
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