# Spaceship operator

The spaceship operator, written <=>, is a binary relational operator that originated in the Perl programming language. Other languages, such as Ruby and Groovy, also support the spaceship operator. 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}$

In Perl, the <=> operator only performs numeric comparisons. For string-based comparison, the analogous cmp operator is used instead.

In other languages (like PHP and C) the <=> operator is not needed for numbers because one can simply do b - a. Rather than returning exactly 1 (or -1), this will return a value greater (or less) than 0. But for those languages this doesn't matter and works fine.

The spaceship operator is primarily used for comparisons in sorting.

The spaceship operator takes its name because it resembles Darth Vader's fighter from Star Wars Episode IV: A New Hope [1]. 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 and . 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