Syntax


FC / FCHANGE

from-string   to-string

[ start-column [ end-column ] ]

[ PREFIX | SUFFIX | WORD | CHAR ]

[ C ] [ Q ] [ T ]

[ LEFT | RIGHT ]

[ TRUNC ]

[ color-selection-criteria]

[ color-change-request]

[ DS | CS ]

[ ? ]


Operands


from-string

The search string you want to change

to-string

The string you want to replace from-string

start-column

Left column of a range (with end-column) within which the from-string value must be found. If no end-column operand, then the from-string operand must be found starting in start-column.

end-column

Right column of a range (with start-column) within which the from-string value must be found.

C

Q

T

C         - Locate the search string within a defined Comment string.

Q        - Locate the search string within a defined Quoted literal string.

T        - Locate the search string within plain text (i.e. Not in a Comment or Quoted string.

You may enter more than 1 of C Q or T to customize the selection. They are tested in an OR relationship.


These three operands require a valid Profile with Colorization active.

ALL

ALL is automatically assumed for FCHANGE, whether ALL is specified or not.

LEFT

LEFT causes the search-string to be found at most once in any given line. Where the search-string occurs more than once in the same line, only the left-most occurrence of search-string is changed, and any other instances on that same line are unchanged.

RIGHT

RIGHT causes the search-string to be found at most once in any given line. Where the search-string occurs more than once in the same line, only the right-most occurrence of search-string is changed, and any other instances on that same line are unchanged.

TRUNC

TRUNC will cause the remainder of the line, following the replacement CHANGE string, to be deleted (truncated).

PREFIX

Locates from-string at the beginning of a word.

WORD

Locates from-string when it is delimited on both sides by blanks or other non-Word characters.

CHAR

Locates from-string regardless of what precedes or follows it.

SUFFIX

Locates from-string at the end of a word.

color-selection-criteria

A request for selection based on the highlight color of the from-string. The full syntax and allowable operands which make up a color-selection-criteria  are discussed in "Color Selection Criteria Specification".

color-change-request

A request can also be made to highlight the string following completion of the command. The full syntax and allowable operands which make up a color-change-request  are discussed in "Color Change Request Specification".

CS | DS

Specifies the Column Shift / Data Shift mode for this particular CHANGE command. See Effect of CHANGE/ALIGN Command on Column-Dependent Data for the significance of this operand. If not specified, the default CS/DS value for this file's Profile will be used.

 

Abbreviations and Aliases


FCHANGE can also be spelled as FC

PREFIX can also be spelled as PRE or PFX

SUFFIX can also be spelled as SUF or SFX

WORDS can also be spelled as WORD

CHARS can also be spelled as CHAR

 

Description


You can use the FCHANGE command to change one string to another in all displayed files in an FM Display. Many of the normal CHANGE operands may be used. e.g. to restrict the column boundaries within which it operates, along with other characteristics of the string searched for. 


See the normal CHANGE command for a further discussion of what the various operands can do, along with examples.