tuple_strrchrtuple_strrchrTupleStrrchrTupleStrrchrtuple_strrchr (Operator)

Name

tuple_strrchrtuple_strrchrTupleStrrchrTupleStrrchrtuple_strrchr — Backward search for characters within a string tuple.

Signature

tuple_strrchr( : : String, ToFind : Position)

Herror tuple_strrchr(const char* String, const char* ToFind, Hlong* Position)

Herror T_tuple_strrchr(const Htuple String, const Htuple ToFind, Htuple* Position)

void TupleStrrchr(const HTuple& String, const HTuple& ToFind, HTuple* Position)

HTuple HTuple::TupleStrrchr(const HTuple& ToFind) const

static void HOperatorSet.TupleStrrchr(HTuple stringVal, HTuple toFind, out HTuple position)

HTuple HTuple.TupleStrrchr(HTuple toFind)

def tuple_strrchr(string: MaybeSequence[str], to_find: MaybeSequence[str]) -> Sequence[int]

def tuple_strrchr_s(string: MaybeSequence[str], to_find: MaybeSequence[str]) -> int

Description

tuple_strrchrtuple_strrchrTupleStrrchrTupleStrrchrTupleStrrchrtuple_strrchr searches within the strings of the input tuple StringStringStringStringstringValstring for the characters of the input tuple ToFindToFindToFindToFindtoFindto_find. Both input tuples may only consist of strings. Otherwise tuple_strrchrtuple_strrchrTupleStrrchrTupleStrrchrTupleStrrchrtuple_strrchr returns an error. In any case backward search is used, i.e., every string is examined from its last to its first character. If the elements of ToFindToFindToFindToFindtoFindto_find contain more than one character, only the first character of each element is considered for searching. If StringStringStringStringstringValstring contains only one string, all the characters defined in ToFindToFindToFindToFindtoFindto_find are searched in this string. Thus, the output tuple consists of as many elements as ToFindToFindToFindToFindtoFindto_find. Whenever a searched character has been found, the position of its first occurrence gets stored in the output tuple PositionPositionPositionPositionpositionposition . If a character can not be found, -1 will be returned instead of its position (remark: the position starts at 0 for the first character of a string). If both input tuples show the same number of elements, the search is done elementwise. I.e., the first character of the first element of ToFindToFindToFindToFindtoFindto_find is searched within the first string of StringStringStringStringstringValstring, the first character of the second element of ToFindToFindToFindToFindtoFindto_find is searched within the second string of StringStringStringStringstringValstring and so on. The results of the elementwise searches are returned with PositionPositionPositionPositionpositionposition that contains as many elements as StringStringStringStringstringValstring and ToFindToFindToFindToFindtoFindto_find. If ToFindToFindToFindToFindtoFindto_find only contains one string, its first character is searched within all strings of StringStringStringStringstringValstring. Thus, in this case PositionPositionPositionPositionpositionposition consists of as many elements as StringStringStringStringstringValstring. If both input tuples contain more than one element and the number of elements differs for the input tuples, tuple_strrchrtuple_strrchrTupleStrrchrTupleStrrchrTupleStrrchrtuple_strrchr returns an error.

If either or both of the input tuples are empty, the operator returns an empty tuple.

Unicode code points versus bytes

The position references Unicode code points. One Unicode code point may be composed of multiple bytes in the UTF-8 string. If the position should reference the raw bytes of the string, this operator can be switched to byte mode with set_system('tsp_tuple_string_operator_mode','byte')set_system("tsp_tuple_string_operator_mode","byte")SetSystem("tsp_tuple_string_operator_mode","byte")SetSystem("tsp_tuple_string_operator_mode","byte")SetSystem("tsp_tuple_string_operator_mode","byte")set_system("tsp_tuple_string_operator_mode","byte"). If 'filename_encoding'"filename_encoding""filename_encoding""filename_encoding""filename_encoding""filename_encoding" is set to 'locale'"locale""locale""locale""locale""locale" (legacy), this operator always uses the byte mode.

For general information about string operations see Tuple / String Operations.

HDevelop In-line Operation

HDevelop provides an in-line operation for tuple_strrchrtuple_strrchrTupleStrrchrTupleStrrchrTupleStrrchrtuple_strrchr, which can be used in an expression in the following syntax:

Position := strrchr(String, ToFind)

Execution Information

Parameters

StringStringStringStringstringValstring (input_control)  string(-array) HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Input tuple with string(s) to examine.

ToFindToFindToFindToFindtoFindto_find (input_control)  string(-array) HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Input tuple with character(s) to search.

PositionPositionPositionPositionpositionposition (output_control)  integer(-array) HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Position of searched character(s) within the string(s).

Alternatives

tuple_strchrtuple_strchrTupleStrchrTupleStrchrTupleStrchrtuple_strchr, tuple_strstrtuple_strstrTupleStrstrTupleStrstrTupleStrstrtuple_strstr, tuple_strrstrtuple_strrstrTupleStrrstrTupleStrrstrTupleStrrstrtuple_strrstr, tuple_strlentuple_strlenTupleStrlenTupleStrlenTupleStrlentuple_strlen, tuple_substrtuple_substrTupleSubstrTupleSubstrTupleSubstrtuple_substr, tuple_str_first_ntuple_str_first_nTupleStrFirstNTupleStrFirstNTupleStrFirstNtuple_str_first_n, tuple_str_last_ntuple_str_last_nTupleStrLastNTupleStrLastNTupleStrLastNtuple_str_last_n, tuple_splittuple_splitTupleSplitTupleSplitTupleSplittuple_split, tuple_environmenttuple_environmentTupleEnvironmentTupleEnvironmentTupleEnvironmenttuple_environment

Module

Foundation