HALCON Website / HALCON Operator-Referenz / Tupel / String-Operationen
KlassenKlassenKlassenKlassen | | | | Operatoren

tuple_regexp_replacetuple_regexp_replaceTupleRegexpReplacetuple_regexp_replaceTupleRegexpReplaceTupleRegexpReplace (Operator)

Name

tuple_regexp_replacetuple_regexp_replaceTupleRegexpReplacetuple_regexp_replaceTupleRegexpReplaceTupleRegexpReplace — Ersetzen eines Teils einer Zeichenkette mit Hilfe von regulären Ausdrücken.

Signatur

tuple_regexp_replace( : : Data, Expression, Replace : Result)

Herror tuple_regexp_replace(const char* Data, const char* Expression, const char* Replace, char* Result)

Herror T_tuple_regexp_replace(const Htuple Data, const Htuple Expression, const Htuple Replace, Htuple* Result)

Herror tuple_regexp_replace(const HTuple& Data, const HTuple& Expression, const HTuple& Replace, char* Result)

Herror tuple_regexp_replace(const HTuple& Data, const HTuple& Expression, const HTuple& Replace, HTuple* Result)

void TupleRegexpReplace(const HTuple& Data, const HTuple& Expression, const HTuple& Replace, HTuple* Result)

HTuple HTuple::TupleRegexpReplace(const HTuple& Expression, const HTuple& Replace) const

void HOperatorSetX.TupleRegexpReplace(
[in] VARIANT Data, [in] VARIANT Expression, [in] VARIANT Replace, [out] VARIANT* Result)

VARIANT HTupleX.TupleRegexpReplace(
[in] VARIANT Data, [in] VARIANT Expression, [in] VARIANT Replace)

static void HOperatorSet.TupleRegexpReplace(HTuple data, HTuple expression, HTuple replace, out HTuple result)

HTuple HTuple.TupleRegexpReplace(HTuple expression, HTuple replace)

Beschreibung

tuple_regexp_replacetuple_regexp_replaceTupleRegexpReplacetuple_regexp_replaceTupleRegexpReplaceTupleRegexpReplace wendet den regulären Ausdruck ExpressionExpressionExpressionExpressionExpressionexpression auf eine oder mehrere Zeichenketten in DataDataDataDataDatadata an und ersetzt jeweils die erste dem Suchmuster entsprechende Teilzeichenkette durch ReplaceReplaceReplaceReplaceReplacereplace. Die bearbeiteten Zeichenketten werden in ResultResultResultResultResultresult zurückgegeben.

Für die Beschreibung von Syntax und Optionen des regulären Ausdrucks wird auf die Dokumentation des Operators tuple_regexp_matchtuple_regexp_matchTupleRegexpMatchtuple_regexp_matchTupleRegexpMatchTupleRegexpMatch verwiesen. Zusätzlich unterstützt der Operator tuple_regexp_replacetuple_regexp_replaceTupleRegexpReplacetuple_regexp_replaceTupleRegexpReplaceTupleRegexpReplace noch die Option 'replace_all'"replace_all""replace_all""replace_all""replace_all""replace_all", mit der bei mehrfachen Übereinstimmungen auch mehrfache Ersetzungen durchgeführt werden.

Im Ausdruck ReplaceReplaceReplaceReplaceReplacereplace kann man mit '$0'"$0""$0""$0""$0""$0" auf die dem Suchmuster entsprechende Teilzeichenkette verweisen, mit '$i'"$i""$i""$i""$i""$i" auf das Teilergebnis der i-ten Gruppe (für i <= 9), sowie mit '$$'"$$""$$""$$""$$""$$" auf das Literal '$'"$""$""$""$""$".

Parallelisierung

Parameter

DataDataDataDataDatadata (input_control)  string(-array) → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Zu bearbeitende Eingabezeichenketten

ExpressionExpressionExpressionExpressionExpressionexpression (input_control)  string(-array) → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Regulärer Ausdruck.

Defaultwert: '.*' ".*" ".*" ".*" ".*" ".*"

Wertevorschläge: '.*'".*"".*"".*"".*"".*", 'replace_all'"replace_all""replace_all""replace_all""replace_all""replace_all", 'ignore_case'"ignore_case""ignore_case""ignore_case""ignore_case""ignore_case", 'multiline'"multiline""multiline""multiline""multiline""multiline", 'dot_matches_all'"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_lf", 'newline_crlf'"newline_crlf""newline_crlf""newline_crlf""newline_crlf""newline_crlf", 'newline_cr'"newline_cr""newline_cr""newline_cr""newline_cr""newline_cr"

ReplaceReplaceReplaceReplaceReplacereplace (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Ersetzungsausdruck.

ResultResultResultResultResultresult (output_control)  string(-array) → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Bearbeitete Zeichenketten.

Beispiel (HDevelop)

tuple_regexp_replace(['img10.bmp','img11.bmp','img12.bmp'], \
                     'img(.*).bmp', 'out$1.txt', Result)
* Returns ['out10.txt','out11.txt','out12.txt']

Siehe auch

tuple_regexp_matchtuple_regexp_matchTupleRegexpMatchtuple_regexp_matchTupleRegexpMatchTupleRegexpMatch, tuple_regexp_testtuple_regexp_testTupleRegexpTesttuple_regexp_testTupleRegexpTestTupleRegexpTest, tuple_regexp_selecttuple_regexp_selectTupleRegexpSelecttuple_regexp_selectTupleRegexpSelectTupleRegexpSelect

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 11.0.5 Copyright © 1996-2015 MVTec Software GmbH