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

FILTER_STRINGC Function

Syntax

Arguments

string

A character string separated into "records" by the character string Delimiter.

sub_string

A character string to find in each "record" of the Input_List.

delimiter

A character string that separates the Input_List into multiple "records".

exclude

Logical. Optional. Default value = .F. (FALSE). .T.= The String_Array[] excludes the "records" that contain sub-string. .F. = The String_Array[] contains only the "records" that contain the Find_String.

Description

Filter in/out words that contain case sensitive sub_string from a list, default delimiter is CR-LF.

Discussion

FILTER_STRINGC() takes an Input_List that is divided into logical "records" by a Delimiter and either extracts or excludes the "records" that contain the Find_String characters anywhere within each "record" in the string. This function is typically used in Xbasic scripts. It is extremely useful for manipulating the CR-LF delimited strings that are returned by many of the Alpha Anywhere methods (such as A5.FORM_ENUM()).

Example

String = <<%a%
Red Ball
Green Ball
Yellow Bucket
Black Hat
%a%
filter_stringc(string, "Black", chr(13) + chr(10) ,.T.)
->   " Red Ball
Green Ball
Yellow Bucket"
filter_stringc(string, "black", chr(13) + chr(10) ,.T.)
->   " Red Ball
Green Ball
Yellow Bucket
Black Hat"

Limitations

The Find_String argument is case sensitive.

See Also

• List Processing Functions