HALCON Reference Manual 10.0.2
Table of Contents / Tuple / String Operations ClassesClassesClasses | | | Operators

tuple_regexp_selecttuple_regexp_selecttuple_regexp_selectTupleRegexpSelectTupleRegexpSelect (Operator)

Name

tuple_regexp_selecttuple_regexp_selecttuple_regexp_selectTupleRegexpSelectTupleRegexpSelect — Selects tuple elements matching a regular expression.

Signature

tuple_regexp_select( : : Data, Expression : Selection)

Herror tuple_regexp_select(const char* Data, const char* Expression, char* Selection)

Herror T_tuple_regexp_select(const Htuple Data, const Htuple Expression, Htuple* Selection)

Herror tuple_regexp_select(const HTuple& Data, const HTuple& Expression, char* Selection)

Herror tuple_regexp_select(const HTuple& Data, const HTuple& Expression, HTuple* Selection)

void HOperatorSetX.TupleRegexpSelect(
[in] VARIANT Data, [in] VARIANT Expression, [out] VARIANT* Selection)

VARIANT HTupleX.TupleRegexpSelect(
[in] VARIANT Data, [in] VARIANT Expression)

static void HOperatorSet.TupleRegexpSelect(HTuple data, HTuple expression, out HTuple selection)

HTuple HTuple.TupleRegexpSelect(HTuple expression)

Description

tuple_regexp_selecttuple_regexp_selecttuple_regexp_selectTupleRegexpSelectTupleRegexpSelect applies the regular expression in ExpressionExpressionExpressionExpressionexpression to one or more input strings in DataDataDataDatadata, and returns the matching string elements in SelectionSelectionSelectionSelectionselection. This is convenient, e.g., for filtering a list of files obtained using the operator list_fileslist_fileslist_filesListFilesListFiles.

Please refer to the documentation of tuple_regexp_matchtuple_regexp_matchtuple_regexp_matchTupleRegexpMatchTupleRegexpMatch for syntax and options of regular expressions. Additionally, tuple_regexp_selecttuple_regexp_selecttuple_regexp_selectTupleRegexpSelectTupleRegexpSelect supports the option 'invert_match'"invert_match""invert_match""invert_match""invert_match", which causes those input strings to be selected which do not match the regular expression.

Parallelization

Parameters

DataDataDataDatadata (input_control)  string(-array) → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Input strings to match.

ExpressionExpressionExpressionExpressionexpression (input_control)  string(-array) → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Regular expression.

Default value: '.*' ".*" ".*" ".*" ".*"

Suggested values: '.*'".*"".*"".*"".*", 'invert_match'"invert_match""invert_match""invert_match""invert_match", 'ignore_case'"ignore_case""ignore_case""ignore_case""ignore_case", 'multiline'"multiline""multiline""multiline""multiline", 'dot_matches_all'"dot_matches_all""dot_matches_all""dot_matches_all""dot_matches_all", 'newline_lf'"newline_lf""newline_lf""newline_lf""newline_lf", 'newline_crlf'"newline_crlf""newline_crlf""newline_crlf""newline_crlf", 'newline_cr'"newline_cr""newline_cr""newline_cr""newline_cr"

SelectionSelectionSelectionSelectionselection (output_control)  string(-array) → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Matching strings

Example (HDevelop)

tuple_regexp_select (['.','..','mydir','a.png','b.txt','c.bmp','d.dat'], \
                     '.(bmp|png)', Result)
* Returns ['a.png','c.bmp']

tuple_regexp_select (Files, ['training','invert_match'], Matches)
* Returns all file names that do *not* contain the string 'training'

Alternatives

tuple_selecttuple_selecttuple_selectTupleSelectTupleSelect

See also

tuple_regexp_matchtuple_regexp_matchtuple_regexp_matchTupleRegexpMatchTupleRegexpMatch, tuple_regexp_replacetuple_regexp_replacetuple_regexp_replaceTupleRegexpReplaceTupleRegexpReplace, tuple_regexp_testtuple_regexp_testtuple_regexp_testTupleRegexpTestTupleRegexpTest

Module

Foundation

Table of Contents / Tuple / String Operations ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH