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

Syntax

Arguments

string

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

pattern

A character string to find in each "record" of the Input_List. Can include the '*' and '? ' wildcard characters.

delimiter

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

exclude

Logical. Optional. The default value for Exclude_Flag is .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 match (using smatch) the pattern, default delimiter is CR-LF.

Discussion

FILTER_STRING_SMATCH() 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()). NOTE : FILTER_STRING_SMATCH() is not case sensitive.

Example

list = <<%a%
Alpha Software
The Alpha Project
Project Alpha
%a%
? filter_string(list, "alpha", crlf() )
=   Alpha Software
The Alpha Project
Project Alpha
? filter_string_smatch(list, "alpha", crlf() )
= ""
? filter_string_smatch(list, "alpha*", crlf() )
= Alpha Software
? filter_string_smatch(list, "*alpha", crlf() )
= Project Alpha
? filter_string_smatch(list, "*alpha*", crlf() )
= Alpha Software
The Alpha Project
Project Alpha

See Also

• List Processing Functions