KlassenKlassenKlassenKlassen | | | | Operatoren

tuple_substrtuple_substrTupleSubstrtuple_substrTupleSubstrTupleSubstr (Operator)

Name

tuple_substrtuple_substrTupleSubstrtuple_substrTupleSubstrTupleSubstr — Ausschneiden von Zeichen ab Position „n1“ bis einschließlich „n2“ aus einem Stringtupel.

Signatur

tuple_substr( : : String, Position1, Position2 : Substring)

Herror tuple_substr(const char* String, const Hlong Position1, const Hlong Position2, char* Substring)

Herror T_tuple_substr(const Htuple String, const Htuple Position1, const Htuple Position2, Htuple* Substring)

Herror tuple_substr(const HTuple& String, const HTuple& Position1, const HTuple& Position2, char* Substring)

Herror tuple_substr(const HTuple& String, const HTuple& Position1, const HTuple& Position2, HTuple* Substring)

void TupleSubstr(const HTuple& String, const HTuple& Position1, const HTuple& Position2, HTuple* Substring)

HTuple HTuple::TupleSubstr(const HTuple& Position1, const HTuple& Position2) const

void HOperatorSetX.TupleSubstr(
[in] VARIANT String, [in] VARIANT Position1, [in] VARIANT Position2, [out] VARIANT* Substring)

VARIANT HTupleX.TupleSubstr(
[in] VARIANT String, [in] VARIANT Position1, [in] VARIANT Position2)

static void HOperatorSet.TupleSubstr(HTuple stringVal, HTuple position1, HTuple position2, out HTuple substring)

HTuple HTuple.TupleSubstr(HTuple position1, HTuple position2)

Beschreibung

tuple_substrtuple_substrTupleSubstrtuple_substrTupleSubstrTupleSubstr schneidet aus jedem String des Eingabetupels StringStringStringStringStringstringVal alle Zeichen beginnend mit dem Zeichen an der Position „n1“ bis einschließlich zur Position „n2“ aus und liefert sie als einen neuen String in dem Ausgabetupel SubstringSubstringSubstringSubstringSubstringsubstring zurück. Die Zahlen „n1“ und „n2“ werden hierbei durch das zweite und dritte Eingabetupel Position1Position1Position1Position1Position1position1 und Position2Position2Position2Position2Position2position2 definiert, das jeweils die gleiche Länge haben muss. Enthalten Position1Position1Position1Position1Position1position1 und Position2Position2Position2Position2Position2position2 nur jeweils ein Element, so legt dieses Element die Zahlen „n1“ und „n2“ für alle Strings von StringStringStringStringStringstringVal fest. Beinhalten Position1Position1Position1Position1Position1position1 und Position2Position2Position2Position2Position2position2 genauso viele Elemente wie StringStringStringStringStringstringVal, so legen die jeweils ersten Elemente von Position1Position1Position1Position1Position1position1 und Position2Position2Position2Position2Position2position2 die Zahlen „n1“ und „n2“ für den ersten String von StringStringStringStringStringstringVal fest. Die zweiten Elemente von Position1Position1Position1Position1Position1position1 und Position2Position2Position2Position2Position2position2 legen dann die Zahlen „n1“ und „n2“ für den zweiten String von StringStringStringStringStringstringVal fest und so weiter. Enthalten Position1Position1Position1Position1Position1position1 und Position2Position2Position2Position2Position2position2 mehr als ein Element und besteht StringStringStringStringStringstringVal nur aus einem String, so werden aus diesem String mehrere Segmente ausgeschnitten, deren Länge durch die Elemente von Position1Position1Position1Position1Position1position1 und Position2Position2Position2Position2Position2position2 festgelegt sind. Beinhalten alle Eingabetupel mehr als ein Element und unterscheiden sie sich gleichzeitig in der Anzahl der Elemente, so bricht tuple_substrtuple_substrTupleSubstrtuple_substrTupleSubstrTupleSubstr mit einer Fehlermeldung ab.

Sonderfall: Leere Eingabetupel

Falls StringStringStringStringStringstringVal ein leeres Tupel ist, gibt der Operator ein leeres Tupel zurück. Falls StringStringStringStringStringstringVal nicht leer ist und Position1Position1Position1Position1Position1position1 und/oder Position2Position2Position2Position2Position2position2 leere Tupel sind, wird eine Fehlermeldung angezeigt.

HDevelop Inline-Operation

HDevelop unterstützt eine Inline-Operation für tuple_substrtuple_substrTupleSubstrtuple_substrTupleSubstrTupleSubstr, die innerhalb eines Ausdrucks in der folgenden Syntax verwendet werden kann:

Substring := String{Position1:Position2}

Parallelisierung

Parameter

StringStringStringStringStringstringVal (input_control)  string(-array) HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Eingabetupel mit zu untersuchenden Strings.

Position1Position1Position1Position1Position1position1 (input_control)  number(-array) HTupleHTupleHTupleVARIANTHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double) (Hlong / double) (Hlong / double)

Eingabetupel mit den Start-Positionen „n1“.

Position2Position2Position2Position2Position2position2 (input_control)  number(-array) HTupleHTupleHTupleVARIANTHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double) (Hlong / double) (Hlong / double)

Eingabetupel mit den End-Positionen „n2“.

SubstringSubstringSubstringSubstringSubstringsubstring (output_control)  string(-array) HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Alle Zeichen von den Positionen „n1“ bis „n2“ für alle Eingabestrings.

Alternativen

tuple_str_first_ntuple_str_first_nTupleStrFirstNtuple_str_first_nTupleStrFirstNTupleStrFirstN, tuple_str_last_ntuple_str_last_nTupleStrLastNtuple_str_last_nTupleStrLastNTupleStrLastN, tuple_strstrtuple_strstrTupleStrstrtuple_strstrTupleStrstrTupleStrstr, tuple_strrstrtuple_strrstrTupleStrrstrtuple_strrstrTupleStrrstrTupleStrrstr, tuple_strlentuple_strlenTupleStrlentuple_strlenTupleStrlenTupleStrlen, tuple_strchrtuple_strchrTupleStrchrtuple_strchrTupleStrchrTupleStrchr, tuple_strrchrtuple_strrchrTupleStrrchrtuple_strrchrTupleStrrchrTupleStrrchr, tuple_splittuple_splitTupleSplittuple_splitTupleSplitTupleSplit, tuple_environmenttuple_environmentTupleEnvironmenttuple_environmentTupleEnvironmentTupleEnvironment

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren