Minus operator.

Unary form:

Binary form:

In its first, unary version the - operator expects one signed integer, unsigned integer, floating-point or point operand and results in the value of this operand with its sign inverted. Precisely, an operand with a positive value will become negative and a negative operand will become positive.

Applied on a signed or unsigned integer operand, the operation always results in an int32 value. Applied on a floating-point operand, the operation always results in a float value. Finally, when applied on a point operand, the operation results in a point value. Please note, performing the operation on a point operand, negates the x and y point elements individually. For example:

In its second version, the - operator calculates an arithmetic difference between the left and the right operand. If used with two signed integer operands, the resulting data type is always int32. In all other cases, the operation results in the unsigned uint32 value. For example:

In its third version, the - operator calculates an arithmetic difference between the left and the right floating-point operand. The resulting data type of the operation is always a float. For example:

In its fourth version, the - operator calculates an arithmetic difference between the left and the right point operand. The operation is performed individually for the x and y point elements. The subtraction of two point operands can be considered as a translation of the point in the left operand by a negative offset specified in the right operand. The resulting data type of the operation is always a point. For example:

In its fifth version, the - operator translates the left rectangle operand by an offset specified in the right point operand. During the operation, the x and y point elements are subtracted from the corresponding coordinates of the rectangle's top-left and bottom-right corners. The resulting data type of the operation is always a rect. For example:

In its sixth version, the - operator calculates an arithmetic difference between the left and the right color operand. The operation is performed individually for every red, green, blue and alpha color components by respecting the lower limit of the value range 0 .. 255. The resulting data type of the operation is always a color. For example:

In its seventh version, the - operator calculates an arithmetic difference between the codes of the left and the right character operand. Please note, in Chora all characters are handled as 16-bit UNICODE entities - they are represented as 16-bit UNICODE numbers. The resulting data type of the operation is always a int32. For example:

In its eighth version, the - operator determines the difference between the left and the right styles operand. Please note, styles operands can be considered as collections containing multiple elements you can individually include or exclude. Thus, the - operation results in a new styles value including all elements available in the left but not in the right operand. The resulting data type of the operation is always styles. For example:

In its ninth version, the - operator determines the difference between the left and the right user-defined set operand. Please note, set operands can be considered as collections containing multiple elements you can individually include or exclude. Thus, the - operation results in a new set value including all elements available in the left but not in the right operand. The resulting data type of the operation corresponds to the data type of the operands. For example: