Syntax


WORD


Operands


None


Description


The WORD line command will insert a WORD line display into the edit file. This line will contain the current list of characters which are considered valid Word characters when SPFLite is searching for strings with a FIND, CHANGE or similar command, and a WORD, PREFIX or SUFFIX search option is used. The characters are used to determine the boundaries of these strings, as follows:


    • A WORD string consists of WORD characters with a non-WORD character (delimiter) on both the left side and the right side


    • A PREFIX string consists of WORD characters with a non-WORD character (delimiter) on the left side and a valid WORD character on the right side.


    • A SUFFIX string consists of WORD characters with a non-WORD character (delimiter) on the right side and a valid WORD character on the left side.


Note also:


    • A CHARS string disregards whether the string is or is not delimited by non-WORD characters
    • A blank is always considered a non-WORD character
    • The physical beginning and end of a line are always considered to be non-WORD delimiters, as if the line were preceded and followed by a blank character


Some languages extend the allowable characters which make up a 'word' to include special characters such as '_' (underscore). The WORD support allows you to customize the set of characters that are considered as valid characters to better support such languages. 


For example, if you are editing a "C" program file which allows underscores in names, the underscore is a letter-like character and not a delimiter. To successfully find "C" words in such files, you would add the underscore to the list of characters in the WORD line. Likewise, many IBM mainframe languages use $ # and @ as letter characters.


Since this set of valid word characters will vary by language, SPFLite retains the WORD setting by file type in the PROFILE. It automatically selects and uses the WORD characters (whether the standard ones, or as modified by you) each time you edit a file of that type.


To display the word delimiters (=WORD>) line:  


    1. Type WORD in the line command area of any unflagged line.  
    2. Press Enter.
    3. The word-delimiter line is displayed.



The delimiter line looks like this:



You may also enter the primary command PROFILE with no operands. One of the Profile lines displayed will be the =WORD> line.


    1. Modify the characters on the WORD line to meet your needs.   Full details of WORD syntax are available in Working with Word and Delimiter Characters.


 "Note that the function automatically includes all international language characters which fall logically into the upper (A-Z) and lower (a-z) case character ranges.  

To exclude these characters from these ranges, code the PROFILE WORD string like this: A-Y Z a-y z


    1. If you want the default set of characters restored, simply blank the entire line. You might want to do that if you made a mistake and want to start over with the standard WORD characters.
    2. Press Enter.
    3. The new word characters are now in effect.


To remove the WORD line from the panel:  

    1. You can either type D in the line command area that contains the =WORD> flag or type RESET on the Command line. 
    2. Press Enter.
    3. The =WORD> line is removed from the display. Deleting the =WORD> line does not remove or change the WORD definition in any way; it simply stops displaying the line.


A note about using TF/TFF and TM/TMM to format text


The Text Flow command TF/TFF and the Text Margin command TM/TMM use a simplified definition of "words". For formatting purposes, a "word" is any string delimited by blanks or by the beginning or end of a line. It is not necessary to change the definition of the WORD string for these commands to work correctly.

Created with the Personal Edition of HelpNDoc: Effortlessly Create Encrypted, Password-Protected PDFs