関数の概要
PHPの ceil 関数は、与えられた数値を超えない最小の整数に切り上げるための関数です。小数点以下を無条件に切り上げて、指定された数値以上の最小の整数を返します。このため、数値の小数部分が0.1であっても1.9であっても、必ず次の整数値に切り上げられます。
パラメータの説明
- value
切り上げ対象の数値(float または int)を指定します。
戻り値
引数で与えた数値を超えない最小の整数を float 型で返します。たとえ整数値が与えられても、戻り値は常に浮動小数点数型となります。
使用例
基本的な使い方
<?php
echo ceil(4.2); // 出力: 5
echo ceil(7.999); // 出力: 8
echo ceil(-3.3); // 出力: -3
?>
正の値の場合、小数部分がどんなに小さくても切り上げられます。負の数の場合は数値が大きくなる向き(-3.3 → -3)に切り上げられます。
整数値の切り上げ
<?php
echo ceil(5); // 出力: 5
echo ceil(-2); // 出力: -2
?>
整数を渡した場合、元の値を変えずにそのまま返しますが、戻り値は float 型になります。
小数点以下0の値
<?php
echo ceil(3.0); // 出力: 3
echo ceil(-1.0); // 出力: -1
?>
小数点以下が0の値を渡すと、整数として扱われますが、戻り値の型は float です。
関連する関数
floor: 数値を切り捨てる関数round: 数値を四捨五入する関数intval: 浮動小数点数を整数に変換する関数(切り捨て)
まとめ
ceil 関数は、数値を常に切り上げて最小の整数を取得したい場合に便利な関数です。小数点以下がある場合は、どのような値でも次の整数に切り上げ、多くの数値計算や制御構造で役立ちます。実務でも価格の切り上げやページ番号の計算など、整数単位で処理する必要があるケースでよく使われます。
