GTE

This reference topic applies to FQL v4. Go to this page for the latest FQL v10 reference topics.

 
GTE(value_1, value_2, ... )
gte(value_1, value_2, ... )
GTE(value_1, value_2, ... )
GTE(value_1, value_2, ... )
GTE(value_1, value_2, ... )
GTE(value_1, value_2, ... )

Description

The GTE function returns true if each specified value is greater than or equal to the ones following it, and false otherwise. The function takes one or more arguments; it always returns true if it has a single argument.

Types have an order of precedence. When comparing values of different types, they are ranked in the following order, from least to greatest.

  1. Number (integers and decimals: 0.5 < 1 < 1.5 < 2)

  2. Byte

  3. String

  4. Array (ordered lexically, like strings)

  5. Object (ordered lexically, like strings)

  6. Reference

  7. Timestamp

  8. Date

  9. Boolean (false < true)

  10. Null

This means that any Array is always greater than any Number.

Parameters

Parameter Type Definition and Requirements

value

Any

A value to be compared.

Returns

A Boolean value.

Examples

The following query returns true because the value 3 is greater than or equal to the value 2, and the value 2 is greater than or equal to the second value 2:

client.query(
  q.GTE(3, 2, 2)
)
.then((ret) => console.log(ret))
.catch((err) => console.error(
  'Error: [%s] %s: %s',
  err.name,
  err.message,
  err.errors()[0].description,
))
true
result = client.query(
  q.gte(3, 2, 2)
)
print(result)
True
result, err := client.Query(
	f.GTE(3, 2, 2))

if err != nil {
	fmt.Fprintln(os.Stderr, err)
} else {
	fmt.Println(result)
}
true
try
{
    Value result = await client.Query(
        GTE(3, 2, 2)
    );
    Console.WriteLine(result);
}
catch (Exception e)
{
    Console.WriteLine($"ERROR: {e.Message}");
}
BooleanV(True)
System.out.println(
    client.query(GTE(Value(3), Value(2), Value(2)))
    .get());
true
GTE(3, 2, 2)
true
Query metrics:

  •    bytesIn:  15

  •   bytesOut:  17

  • computeOps:   1

  •    readOps:   0

  •   writeOps:   0

  •  readBytes:   0

  • writeBytes:   0

  •  queryTime: 3ms

  •    retries:   0

\