Operator Reference

HALCON Operator Reference / Tuple / Comparison
ClassesClasses | | Operators

tuple_greater_equaltuple_greater_equalTupleGreaterEqualTupleGreaterEqualtuple_greater_equal (Operator)

tuple_greater_equaltuple_greater_equalTupleGreaterEqualTupleGreaterEqualtuple_greater_equal — Test whether a tuple is greater or equal to another tuple.

Signature

tuple_greater_equal( : : T1, T2 : Greatereq)

Herror tuple_greater_equal(const Hlong T1, const Hlong T2, Hlong* Greatereq)

Herror T_tuple_greater_equal(const Htuple T1, const Htuple T2, Htuple* Greatereq)

void TupleGreaterEqual(const HTuple& T1, const HTuple& T2, HTuple* Greatereq)

HTuple HTuple::TupleGreaterEqual(const HTuple& T2) const

static void HOperatorSet.TupleGreaterEqual(HTuple t1, HTuple t2, out HTuple greatereq)

HTuple HTuple.TupleGreaterEqual(HTuple t2)

def tuple_greater_equal(t1: MaybeSequence[Union[int, float, str]], t2: MaybeSequence[Union[int, float, str]]) -> int

Description

tuple_greater_equaltuple_greater_equalTupleGreaterEqualTupleGreaterEqualtuple_greater_equal tests whether the input tuple T1T1T1t1t1 is greater or equal to T2T2T2t2t2. A tuple T1T1T1t1t1 is said to be greater or equal to a tuple T2T2T2t2t2, if T1T1T1t1t1 is not less than T2T2T2t2t2. A tuple T1T1T1t1t1 is said to be less than a tuple T2T2T2t2t2, if T1T1T1t1t1 has been found to be less when comparing it elementwise to T2T2T2t2t2 or if the first min(|T1|,|T2|) elements are equal and T1T1T1t1t1 has got less elements than T2T2T2t2t2.

With the elementwise comparison, the elements of T1T1T1t1t1 and T2T2T2t2t2 are compared one by one. If the two elements are equal, the next pair of elements will be examined. If the element of T1T1T1t1t1 is greater than that from T2T2T2t2t2, the result is 1 and the comparison will be aborted. If the element of T1T1T1t1t1 is less than that from T2T2T2t2t2, the result is 0 and the comparison will be aborted. If all elements have been tested and if all were equal, the result is 1.

As a precondition for comparing the tuples elementwise two corresponding elements must either both be (integer or floating point) numbers or both be strings. Otherwise tuple_greater_equaltuple_greater_equalTupleGreaterEqualTupleGreaterEqualtuple_greater_equal returns an error.

Exception: Empty input tuples

If one input tuple is empty and the other is not, the tuple that is not empty is considered greater than the empty one.

HDevelop In-line Operation

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

Greatereq := T1 >= T2

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)  tuple(-array) → HTupleMaybeSequence[Union[int, float, str]]HTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)

Input tuple 1.

T2T2T2t2t2 (input_control)  tuple(-array) → HTupleMaybeSequence[Union[int, float, str]]HTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)

Input tuple 2.

GreatereqGreatereqGreatereqgreatereqgreatereq (output_control)  integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Result of the comparison of the input tuples.

Alternatives

tuple_greatertuple_greaterTupleGreaterTupleGreatertuple_greater, tuple_lesstuple_lessTupleLessTupleLesstuple_less, tuple_less_equaltuple_less_equalTupleLessEqualTupleLessEqualtuple_less_equal, tuple_equaltuple_equalTupleEqualTupleEqualtuple_equal, tuple_not_equaltuple_not_equalTupleNotEqualTupleNotEqualtuple_not_equal, tuple_equal_elemtuple_equal_elemTupleEqualElemTupleEqualElemtuple_equal_elem, tuple_not_equal_elemtuple_not_equal_elemTupleNotEqualElemTupleNotEqualElemtuple_not_equal_elem, tuple_less_elemtuple_less_elemTupleLessElemTupleLessElemtuple_less_elem, tuple_greater_elemtuple_greater_elemTupleGreaterElemTupleGreaterElemtuple_greater_elem, tuple_less_equal_elemtuple_less_equal_elemTupleLessEqualElemTupleLessEqualElemtuple_less_equal_elem, tuple_greater_equal_elemtuple_greater_equal_elemTupleGreaterEqualElemTupleGreaterEqualElemtuple_greater_equal_elem

Module

Foundation

ClassesClasses | | Operators