85 lines
2.9 KiB
Markdown
85 lines
2.9 KiB
Markdown
|
# Number
|
||
|
|
|
||
|
|
An integer number. #docs #Number #var
|
||
|
|
|
||
|
|
### @parent js/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](/microbit/reference/variables/var) and the [assignment operator](/microbit/reference/variables/assign) `:=` to declare a *local* number variable. Like this:
|
||
|
|
|
||
|
|
```
|
||
|
|
let number1 = 2
|
||
|
|
let number2 = 2
|
||
|
|
```
|
||
|
|
|
||
|
|
To declare a *global* number variable, see [global variables](/microbit/js/data).
|
||
|
|
|
||
|
|
### Arithmetic operators
|
||
|
|
|
||
|
|
The following arithmetic operators work on numbers and return a [Number](/microbit/reference/types/number):
|
||
|
|
|
||
|
|
* addition: `1 + 3`
|
||
|
|
* subtraction: `1 - 3 `
|
||
|
|
* multiplication: `3 * 2`
|
||
|
|
* integer division: `7 / 3`
|
||
|
|
* modulo is available through the [math library](/microbit/js/math)
|
||
|
|
|
||
|
|
### Relational operators
|
||
|
|
|
||
|
|
The following relational operators work on numbers and return a [Boolean](/microbit/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](/microbit/reference/basic/show-number) function displays a number on the [LED screen](/microbit/device/screen). For example, this code displays the number 42:
|
||
|
|
|
||
|
|
```
|
||
|
|
basic.showNumber(42, 100)
|
||
|
|
```
|
||
|
|
|
||
|
|
### 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](/microbit/reference/led/brightness)) and stores the value in a variable named `brightness`:
|
||
|
|
|
||
|
|
```
|
||
|
|
let brightness = led.brightness()
|
||
|
|
```
|
||
|
|
|
||
|
|
### Math functions
|
||
|
|
|
||
|
|
The [math library](/microbit/js/math) includes math related functions. In the [Touch Develop editor](/microbit/js/editor), click `math` on the Code Keyboard to see the math functions. For example, the `mod` function returns the modulus (division of one number by another number):
|
||
|
|
|
||
|
|
```
|
||
|
|
number1 = math.mod(4, 3)
|
||
|
|
```
|
||
|
|
|
||
|
|
### Convert a number to a string
|
||
|
|
|
||
|
|
The `to string` function converts a Number into a [String](/microbit/reference/types/string). The following code converts `number1` to a string and stores the string in the `str` variable:
|
||
|
|
|
||
|
|
```
|
||
|
|
let str = number1.toString()
|
||
|
|
```
|
||
|
|
|
||
|
|
### Bit-level manipulation
|
||
|
|
|
||
|
|
The [bits library](/microbit/js/bits) includes functions for bit-level manipulation of integers. In the [Touch Develop editor](/microbit/js/editor), click `bits` on the Code Keyboard to see these functions.
|
||
|
|
|
||
|
|
### Lessons
|
||
|
|
|
||
|
|
[counter](/microbit/lessons/counter), [love meter](/microbit/lessons/love-meter), [flipping bird](/microbit/lessons/flipping-bird), [catch the egg game](/microbit/lessons/catch-the-egg-game)
|
||
|
|
|
||
|
|
### See also
|
||
|
|
|
||
|
|
[math library](/microbit/js/math), [var](/microbit/reference/variables/var), [bits library](/microbit/js/bits), [Boolean](/microbit/reference/types/boolean), [show number](/microbit/reference/basic/show-number)
|
||
|
|
|