• *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_SUBTRACTC Function

Syntax

Arguments

WordsCharacter

A CR-LF delimited list of words or entries to examine.

Exclude_WordsCharacter

The word(s) to find.

DelimiterCharacter

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

Returns

New_ListCharacter

Returns all words not included in the exclude list.

Description

Returns Words (case sensitive) that are not in the exclude list.

Discussion

WORD_SUBTRACTC() removes all of the words or entries in a list of of words using a case-sensitive comparison. The words to remove are defined as a CR-LF delimited list. The WORD_SUBTRACTC() function is typically 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
three
four
%str%

In the first case, the delimiter of list1 is assumed to be a whitespace character, so the operation succeeds. In the second case, where the delimiter of list1 is specified to be CR-LF, the operation fails.

? word_subtractc(list1, removelist)
= ONE THREE

? word_subtractc(list1, removelist, crlf())
= ONE two THREE four

In both cases, the operation succeeds because list2 is delimited by CR-LF characters.

? word_subtractc(list2, removelist)
= TWO
FOUR

? word_subtractc(list2, removelist, crlf())
= TWO
FOUR

See Also

• List Processing Functions
• Character Replacement Functions