La fonction constrain() d’Arduino permet de limiter la valeur d’une variable à une plage déterminée. Cela peut être utile lorsque vous voulez garantir que la valeur d’une variable reste dans une plage spécifique pour éviter des erreurs dans votre code.

La syntaxe de la fonction constrain() est la suivante :

constrain(value, min, max);

• value est la valeur à limiter.
• min est la valeur minimale autorisée pour value.
• max est la valeur maximale autorisée pour value.

La fonction constrain() retourne la valeur de value si elle se trouve déjà entre les bornes min et max. Si value est inférieure à min, la fonction retourne min. Si value est supérieure à max, la fonction retourne max.

Exemple d’utilisation de la fonction constrain()

void setup() {
  pinMode(9, OUTPUT);
}

void loop() {
  int brightness = analogRead(A0);
  int minBrightness = 50;
  int maxBrightness = 200;
  
  brightness = constrain(brightness, minBrightness, maxBrightness);
  
  digitalWrite(9, brightness);
  
  delay(100);
}

Dans ce sketch, la fonction setup() configure le pin 9 en sortie. La fonction loop() est appelée en boucle à chaque tour du programme.

La variable brightness est initialisée en lisant la valeur sur le port analogique A0. Les variables minBrightness et maxBrightness sont initialisées à 50 et 200 respectivement. La fonction constrain() est appelée avec ces variables en tant qu’arguments pour limiter la valeur de brightness à la plage de 50 à 200.

Enfin, la fonction analogWrite() est utilisée pour contrôler la luminosité d’un LED connecté au pin 9 en utilisant la valeur de brightness et le programme est temporisé pendant 100 millisecondes à l’aide de la fonction delay().

Exemples d’utilisation de la fonction constrain()

1. Limiter la valeur d’une variable à une plage spécifique. Par exemple, vous pouvez utiliser constrain() pour s’assurer que la valeur d’une variable qui représente la luminosité d’un écran ne dépasse pas une certaine limite supérieure ou inférieure pour éviter de brûler les pixels.
2. Contrôler les entrées d’un capteur. Par exemple, si vous utilisez un capteur de température qui peut renvoyer des valeurs extrêmement élevées ou basses, vous pouvez utiliser constrain() pour limiter ces valeurs à une plage plausible.
3. Réguler les sorties d’un moteur ou d’un servomoteur. Par exemple, vous pouvez utiliser constrain() pour limiter la vitesse d’un moteur à une certaine limite inférieure et supérieure pour éviter de surcharger le moteur.