2016-03-26 00:47:20 +01:00
# out of bounds
The behavior of functions whose parameter values are out of bounds.
2016-11-01 18:42:42 +01:00
Many of the @boardname @ functions have parameters. If a parameter is an unexpected value, the parameter is considered *out of bounds* .
2016-03-26 00:47:20 +01:00
2016-04-13 17:27:45 +02:00
For example, the [plot ](/reference/led/plot ) function has two parameters:
2016-03-26 00:47:20 +01:00
2017-09-07 22:42:08 +02:00
## syntax
2016-03-26 00:47:20 +01:00
2016-04-16 00:53:20 +02:00
```sig
led.plot(0,0)
2016-03-26 00:47:20 +01:00
```
2017-09-07 22:42:08 +02:00
## parameters
2016-03-26 00:47:20 +01:00
* x - the *x coordinate* or horizontal position (0, 1, 2, 3, 4)
* y - the *y coordinate* or vertical position (0, 1, 2, 3, 4)
2017-09-07 22:42:08 +02:00
## out of bounds
2016-03-26 00:47:20 +01:00
here's an example of code with an out of bounds parameter (the *x* and *y* parameters are outside the expected range of 0-4):
2016-04-16 00:53:20 +02:00
```blocks
2016-03-26 00:47:20 +01:00
led.plot(9, -21)
```
2017-09-07 22:42:08 +02:00
## what happens?
2016-03-26 00:47:20 +01:00
Typically, when a parameter supplied to a function is out of bounds that function does nothing (as if the function never executed). So, in the above case, the LED screen will not change.
2017-09-07 22:42:08 +02:00
## return value
2016-03-26 00:47:20 +01:00
If you call the `point` function with an out of bounds parameter, the function returns `false` :
2016-04-16 00:53:20 +02:00
```blocks
2016-03-26 00:47:20 +01:00
let on = led.point(5, -5)
```