pxt-calliope/docs/reference/types/number.md
2016-04-18 08:33:09 -07:00

62 lines
2.0 KiB
Markdown

# Number
An integer number.
### @parent blocks/language
A *Number* is an integer such as `42` or `-42`. More precisely, a *Number* is a signed 32-bit integer (two's complement).
### Declare a number variable
Use the [var statement](/reference/variables/var) and the [assignment operator](/reference/variables/assign) declare a *local* number variable. Like this:
![](/static/mb/blocks/number-0.png)
### Arithmetic operators
The following arithmetic operators work on numbers and return a [Number](/reference/types/number):
* addition: `1 + 3`
* subtraction: `1 - 3 `
* multiplication: `3 * 2`
* integer division: `7 / 3`
* modulo is available through the [math library](/reference/math)
### Relational operators
The following relational operators work on numbers and return a [Boolean](/reference/types/boolean):
* equality: `(3 + 1) = 4`
* inequality: `3 != 4`
* less or equal than: `3 <= 4`
* less than: `3 < 4`
* greater or equal than : `4 >= 3`
* greater than: `4 > 3`
### Show number
The [show number](/reference/basic/show-number) function displays a number on the [LED screen](/device/screen). For example, this code displays the number 42:
![](/static/mb/blocks/number-1.png)
### Functions that return a number
Some functions return a number, which you can store in a variable. For example the following code gets the display brightness (using the [brightness function](/reference/led/brightness)) and stores the value in a variable named `brightness`:
![](/static/mb/blocks/number-2.png)
### Math functions
The [math library](/reference/math) includes math related functions. In the [Block Editor](/blocks/editor), click `math` on the Code Keyboard to see the math functions. For example, the `absolute` function returns the returns the absolute value of input parameter `x`:
![](/static/mb/blocks/number-3.png)
### Lessons
[game counter](/lessons/game-counter), [love meter](/lessons/love-meter)
### See also
[math library](/reference/math), [var](/reference/variables/var), [Boolean](/reference/types/boolean), [show number](/reference/basic/show-number)