［Dart / Flutter］数値を指定した範囲内に収める clamp(lowerLimit, upperLimit)

clamp()メソッドは数値を特定の範囲を超えないように制限する方法を提供します。

構文　指定範囲内に収める

num result = value.clamp(lowerLimit, upperLimit);

変数
value（num型）：範囲に収めたい数値。
引数
lowerLimit（num型）：数値の下限値。
upperLimit（num型）：数値の上限値。
戻り値
result（num型）：指定した範囲内に収められた数値。

clamp()メソッドは、valueがlowerLimitより小さい場合はlowerLimitに、upperLimitより大きい場合はupperLimitに変更し、それ以外の場合はそのままの値を返します。

利用場面

ユーザーからの入力を特定の範囲に制限する必要がある時。
計算結果が特定の範囲内に収まるように制限する時。

int value = 15;
int minValue = 10;
int maxValue = 20;

int clampedValue = value.clamp(minValue, maxValue); // 結果は15

value = 5;
clampedValue = value.clamp(minValue, maxValue); // 結果は10（最小値）

value = 25;
clampedValue = value.clamp(minValue, maxValue); // 結果は20（最大値）

メリット

シンプルで直感的な構文。
数値を効率的に特定の範囲に制限する。

特定の範囲に数値を制限する必要がある場合、このメソッドはとでも便利です。