# Spaceship operator

For its use in SQL, see SQL Null and three-valued logic.

The spaceship operator is a binary relational operator that originated in the Perl programming language. Other languages, such as Ruby and Groovy also support the spaceship operator. It is written <=>. Unlike traditional equality operators, which will return 1 (true) or 0 (false) depending on whether the arguments are equal or unequal, the spaceship operator will return 1, 0, or −1 depending on the value of the left argument relative to the right argument. If the left argument is greater than the right argument, the operator returns 1. If the left argument is less than the right argument, the operator returns −1. If the two arguments are equal, the operator returns 0. If the two arguments cannot be compared (e.g. one of them is NaN), the operator returns undef.

As a formula:

$a\ \texttt{<=>}\ b\ \ \ = \begin{cases} -1 & \mbox{if }a < b, \\ 0 & \mbox{if }a = b, \\ 1 & \mbox{if }a > b, \\  \texttt{undef}  & \mbox{otherwise.}  \end{cases}$

The spaceship operator is primarily used for comparisons in sorting.

The spaceship operator takes its name because it looks like a small flying saucer as ASCII art. The term is now commonly used and the operator is referred by the name within the Perl documentation.

This operator is also used in ASCII-based mathematical notation to represent "less than, equal to or greater than", and is synonymous with the symbols Template:Unicode and Template:Unicode. It can be used to test if the result of a calculation is actually a number.

## Example

$a = 5 <=> 7; #$a is set to -1
$a = 7 <=> 5; #$a is set to 1
$a = 6 <=> 6; #$a is set to 0