• *AVERAGE Function
• *COUNT Function
• *counter Function
• *FOR_EACH Function
• *LINE_INSERT Function
• *LINE_REMOVE Function
• *LINE_REPLACE Function
• *MAX Function
• *MIN Function
• *PATTERN_EXTRACT Function
• *PATTERN_LOOKUP Function
• *PATTERN_LOOKUPI Function
• *REMOVE_DUPLICATES Function
• *REMOVE_DUPLICATESI Function
• *REVERSE_WORDS Function
• *TOTAL Function
• *WORD Function
• *WORD_INSERT Function
• *WORD_REMOVE Function
• *WORD_REPLACE Function
• *WORDI Function
• a5_arguments_dbflist Function
• a5_autocomplete_list Function
• a5_define_parameters Function
• a5_get_parameters Function
• a5_get_writeable_drives Function
• a5_getaddinsinstalled Function
• a5_progresslist Function
• a5_window_list Function
• COMMA_TO_CRLF Function
• COUNTRIESOFWORLD Function
• COUNTRYLOOKUP Function
• CRLF_TO_COMMA Function
• CSTATE Function
• CSTATE_ABREVLOOKUP Function
• CSTATES Function
• EXTRACT_ALL_STRINGS Function
• FILTER_STRING_MULTI Function
• FILTER_STRING_SMATCH Function
• FILTER_STRINGC Function
• INLIST2 Function
• inlistn Function
• IS_ONE_OF Function
• keylist_filtered_build Function
• POS_FROM_WORD_NUMBER Function
• REGION_FROM_AREACODE Function
• REMOVE_BLANK_LINES Function
• SortList_On_ReferenceList Function
• TAGGED_PATTERN Function
• UniqueNameGet Function
• WORD_CHANGE Function
• WORD_DUPLICATES Function
• WORD_EVALUATE Function
• WORD_EXISTS Function
• WORD_EXISTS_C Function
• WORD_i Function
• WORD_MOVE Function
• WORD_NUM Function
• WORD_NUMBER_GET Function
• WORD_REMOVE Function
• WORD_REPLACE Function
• WORD_SUBTRACT Function
• WORD_SUBTRACTC Function
• WORD_TAGGED_PATTERN Function

WORD_SUBTRACT Function

Syntax

Arguments

WordsCharacter

The list of words or entries to examine.

Exclude_WordsCharacter

A CR-LF delimited list of word(s) to remove.

DelimiterCharacter

Default = whitespace (e.g. a space, tab, CR-LF). The character string that separates words or entries.

Returns

New_ListCharacter

Returns all words not included in the exclude list.

Description

Returns Words that are not in the exclude list.

Discussion

WORD_SUBTRACT() removes one or more words from a list of words or entries, ignoring case. The words to remove are specified as a CR-LF delimited list. WORD_SUBTRACT() is often used to remove one list of CR-LF delimited words from another list of CR-LF delimited words.

dim list1 as c =<<%str%
one two three four
%str%

dim list2 as c =<<%str%
one
two
three
four
%str%

dim removelist as c =<<%str%
one
two
%str%

In the first case, the delimiter of list1 is assumed to be a whitespace character, and the words are removed. In the second case, the delimiter of list1 is specified to be CR-LF, so no words are removed.

? word_subtract(list1, removelist)
= three four

? word_subtract(list1, removelist, crlf() )
= one two three four

In both cases, the operation succeeds because list2 is delimited by CR-LF, which is a whitespace character.

? word_subtract(list2, removelist)
= three
four

? word_subtract(list2, removelist, crlf())
= three
four

See Also

• List Processing Functions
• Character Replacement Functions