company logo

Value :: operator- - Minus operator

The operation is provided as binary (subtraction) and unary (negation) operation.

Return value:  Value handle ( odaba::Value  )

A value handle refers to a (usually) opened value. Invalid value handles may cause an exception.

Implementation overview

Implementation details

  1. Negate value
    odaba::Value Value  :: operator- (  )

    The operation provides the negation of a value. The operation is an unary operation returning the result in the data format of the operand (calling object). The operation behaves differently for different data types of operand.

    1. Numbers (INT, REAL)
    2. The operation builds the negation of the value (multiplying by -1) and returns the result with the data type of the operand.

    3. Boolean (LOGICAL)

    The operation returns true, when the value is false and false otherwise (not).

    For all other data types for the left hand operand, the function throws an exception.

  2. to list
  3. Subtract values
    odaba::Value Value  :: operator- ( odaba::Value &cValue )

    The operation provides the result of subtracting two values. The operation is an ordinary binary operation returning the result in the data format of the left operand (calling object). The operation behaves differently for different data types of the left operand.

    1. Numbers (INT, REAL)
    2. The operation builds the difference between the participating operands and returns the result with the data type of the first operand.

    3. Text (STRING, CHAR, CCHAR)
    4. The second operand is converted into text which is searched and removed from the text in the first operand.

    5. Boolean (LOGICAL)
    6. The second operand is converted into a Boolean value and the result is true, when exactly one of the operands is true (exclusive or).

    7. Date
    8. The second operator is converted into an integer number and subtracted as number of days to the date value in the first operand.

    9. Time
    10. The second operator is converted into an integer number and subtracted as number of hundredth seconds to the date value in the first operand.

    11. DateTime
    12. The second operator is converted into an integer number and subtracted as number of hundredth seconds to the timestamp value in the first operand.

    13. Other

    For all other data types for the left hand operand, the function throws an exception.

    • cValue - Value handle

      A value handle refers to a (usually) opened value. Invalid value handles may cause an exception.

  4. to list