tuple_gen_consttuple_gen_constTupleGenConstTupleGenConst (Operator)
Name
tuple_gen_consttuple_gen_constTupleGenConstTupleGenConst
— Generate a tuple of a specific length and initialize its elements.
Signature
Description
tuple_gen_consttuple_gen_constTupleGenConstTupleGenConstTupleGenConst
generates a new tuple in NewtupleNewtupleNewtupleNewtuplenewtuple
.
The input parameter LengthLengthLengthLengthlength
determines the number of elements
for the new tuple. Thus, LengthLengthLengthLengthlength
may only consist of a single number.
If LengthLengthLengthLengthlength
contains a floating point number, this may only
represent an integer value (without fraction).
The data type and value of each element of the new generated tuple is
determined by the input parameter ConstConstConstConstconstVal
that may only
consist of a single element. All elements in NewtupleNewtupleNewtupleNewtuplenewtuple
have got the same data type and value as the single element in
ConstConstConstConstconstVal
.
Exception: Empty input tupless
If any of the input tuples is empty, an exception is raised.
HDevelop In-line Operation
HDevelop provides an in-line operation for tuple_gen_consttuple_gen_constTupleGenConstTupleGenConstTupleGenConst
,
which can be used in an expression in the following syntax:
Newtuple := gen_tuple_const(Length, Const)
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
LengthLengthLengthLengthlength
(input_control) number →
HTupleHTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)
Length of tuple to generate.
ConstConstConstConstconstVal
(input_control) tuple →
HTupleHTupleHtuple (integer / real / string / handle) (int / long / double / string / HHandle) (Hlong / double / HString / HHandle) (Hlong / double / char* / handle)
Constant for initializing the tuple elements.
NewtupleNewtupleNewtupleNewtuplenewtuple
(output_control) tuple(-array) →
HTupleHTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
New Tuple.
Alternatives
tuple_str_bit_selecttuple_str_bit_selectTupleStrBitSelectTupleStrBitSelectTupleStrBitSelect
,
tuple_selecttuple_selectTupleSelectTupleSelectTupleSelect
,
tuple_str_first_ntuple_str_first_nTupleStrFirstNTupleStrFirstNTupleStrFirstN
,
tuple_str_last_ntuple_str_last_nTupleStrLastNTupleStrLastNTupleStrLastN
,
tuple_concattuple_concatTupleConcatTupleConcatTupleConcat
,
tuple_inserttuple_insertTupleInsertTupleInsertTupleInsert
,
tuple_replacetuple_replaceTupleReplaceTupleReplaceTupleReplace
,
tuple_gen_sequencetuple_gen_sequenceTupleGenSequenceTupleGenSequenceTupleGenSequence
See also
tuple_randtuple_randTupleRandTupleRandTupleRand
Module
Foundation