17.16.5.39 NEXTIF

Description: Compares the values designated by the expressions in comparison using the operator designated by comparison-operator. If the comparison is true, the next data record is merged into the current merge document. (Merge fields that follow the NEXTIF in the main document are replaced by values from the next data record rather than the current data record.) If the comparison is false, the next data record is merged into a new merge document.

[Note: comparison-operator can be any one of the six relational and equality operators specified for operator (17.16.3.3). end note]

A NEXTIF fields shall not be used in a footnote, an endnote, annotation, a header, a footer, or a data source. A
NEXTIF field shall not be nested within any field.

If comparison-operator is = or <>, the right-hand expression operand can contain a question mark (?) to represent any single character, or an asterisk (*) to represent any string of characters. The expression shall be enclosed in quotation marks so that it is compared as a character string.

Field Value: None.

Switches: None.

Syntax: