Esta página também está disponível em outros 2 idiomas.

constrain()

[Math]

Descrição

Restringe um número a ficar dentro de um intervalo.

Sintaxe

constrain(x, a, b)

Parâmetros

x: o número a se restringir, qualquer tipo de dado

a: o extremo inferior do intervalo, qualquer tipo de dado

b: o extremo superior do intervalo, qualquer tipo de dado

Retorna

x: se x está entre a e b

a: se x é menor que a

b: se x é maior que b

Código de Exemplo

O código limita os valores de uma variável com a leitura de um sensor entre 10 e 150.

sensVal = constrain(sensVal, 10, 150);  // limita os valores entre 10 e 150

Notas e Advertências

Por causa da forma como a função constrain() é implementada, evite usar outras funções dentro dos parênteses, pois isso pode levar a resultados incorretos.

Esse código gerará resultados incorretos:

int constrainedInput = constrain(Serial.parseInt(), minimumValue, maximumValue);   // evite isso

Faça essa forma:

int input = Serial.parseInt();  // manter outras operações fora da função constrain()
int constrainedInput = constrain(input, minimumValue, maximumValue);

Ver Também