constrain()

constrain()はマクロ関数です。範囲内の数値を制限します。

書式

constrain(x, a, b)

引数

x：制約する数

a：範囲の下端

b：範囲の上端

戻り値

x：xがaとbの間にある場合

a：xがaより小さい場合

b：xがbより大きい場合

利用例

code:sample.ino

// limits range of sensor values to between 10 and 150:

sensVal = constrain(sensVal, 10, 150);

constrain(x, a, b)を利用する場合、カッコ内で他の関数の使用は避けてください。結果が正しくない可能性があります。

マクロ関数のため引数の評価の順番が、通常の関数と異なる場合があります。

code:sample.ino

constrain(x,a++,b); // avoid this - yields incorrect results

constrain(x,a,b); // use this instead-

a++; // keep other math outside constrain()

Arduinoとの互換性

constrain(x, a, b)のMaple(Arduino STM32)バージョンはArduinoと互換性があります。