Operator Reference

HALCON Operator Reference / Tuple / String Operations
ClassesClasses | | Operators

tuple_strlentuple_strlenTupleStrlenTupleStrlentuple_strlen (Operator)

tuple_strlentuple_strlenTupleStrlenTupleStrlentuple_strlen — Determine the length of every string within a tuple of strings.

Signature

tuple_strlen( : : T1 : Length)

Herror tuple_strlen(const char* T1, Hlong* Length)

Herror T_tuple_strlen(const Htuple T1, Htuple* Length)

void TupleStrlen(const HTuple& T1, HTuple* Length)

HTuple HTuple::TupleStrlen() const

static void HOperatorSet.TupleStrlen(HTuple t1, out HTuple length)

HTuple HTuple.TupleStrlen()

def tuple_strlen(t1: MaybeSequence[str]) -> Sequence[int]

def tuple_strlen_s(t1: MaybeSequence[str]) -> int

Description

tuple_strlentuple_strlenTupleStrlenTupleStrlentuple_strlen checks the length of every string within the input tuple T1T1T1t1t1 and returns the length of each string with the output tuple LengthLengthLengthlengthlength. All elements of T1T1T1t1t1 may only consist of strings. Otherwise tuple_strlentuple_strlenTupleStrlenTupleStrlentuple_strlen returns an error.

If the input tuple is empty, the operator returns an empty tuple.

Unicode code points versus bytes

The string length references Unicode code points. One Unicode code point may be composed of multiple bytes in the UTF-8 string. If the length 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")set_system("tsp_tuple_string_operator_mode","byte"). If 'filename_encoding'"filename_encoding""filename_encoding""filename_encoding""filename_encoding" is set to '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_strlentuple_strlenTupleStrlenTupleStrlentuple_strlen, which can be used in an expression in the following syntax:

Length := strlen(T1)

Execution Information

  • Multithreading type: independent (runs in parallel even with exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Processed without parallelization.

Parameters

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

Input tuple.

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

Lengths of the single strings of the input tuple.

Alternatives

tuple_strstrtuple_strstrTupleStrstrTupleStrstrtuple_strstr, tuple_strrstrtuple_strrstrTupleStrrstrTupleStrrstrtuple_strrstr, tuple_strchrtuple_strchrTupleStrchrTupleStrchrtuple_strchr, tuple_strrchrtuple_strrchrTupleStrrchrTupleStrrchrtuple_strrchr, tuple_substrtuple_substrTupleSubstrTupleSubstrtuple_substr, tuple_str_first_ntuple_str_first_nTupleStrFirstNTupleStrFirstNtuple_str_first_n, tuple_str_last_ntuple_str_last_nTupleStrLastNTupleStrLastNtuple_str_last_n, tuple_splittuple_splitTupleSplitTupleSplittuple_split, tuple_environmenttuple_environmentTupleEnvironmentTupleEnvironmenttuple_environment

See also

tuple_is_stringtuple_is_stringTupleIsStringTupleIsStringtuple_is_string

Module

Foundation

ClassesClasses | | Operators