The OutOfBoundsException class


استثنا ایجاد شده در صورتی که مقدار کلید صحیح نباشد

Class synopsis

OutOfBoundsException extends RuntimeException {
/* Inherited methods */
final public string Exception::getMessage ( void )
final public int Exception::getCode ( void )
final public string Exception::getFile ( void )
final public int Exception::getLine ( void )
final public array Exception::getTrace ( void )
final public string Exception::getTraceAsString ( void )
public string Exception::__toString ( void )
final private void Exception::__clone ( void )
add a note add a note

User Contributed Notes 4 notes

Jacob V. Rasmussen
1 year ago
OutOfRangeException is for Integers out of range.
OutOfBoundsException is for key values, not found in the target array.

Editor's note: This is incorrect; OutOfRangeException has *nothing* to do with Integer ranges. I decided to keep this highly voted comment even though it is wrong for education's sake.
evguenia dot chagnon at gmail dot com
3 months ago
class MyDynamicTastyPie implements ArrayAccess{
    private $_pointeur = 0;
    private $_array = ['strawberry slice','white chocolate','nuts'];
    public function offsetExists($key){
        return isset($this->_array[$key]);
    public function offsetGet($key){
        if ($key > count($this->_array)){
            throw new OutOfBoundsException('Your tasty pie doesn\'t contain so slices');
        return $this->_array[$key];
    public function offsetSet($key, $value){
        $this->_array[$key] =$value;
    public function offsetUnset($key){
    public function addSlice($slice){
        $this->_array[] = $slice;

try {
    $myDynamicTastyPie = new MyDynamicTastyPie();
    $myDynamicTastyPie->addSlice('Black chocolate cream decoration');
    echo $myDynamicTastyPie[7];
catch(OutOfBoundsException $e){
    echo 'Here is your OutOfBoundsException!';
sricharan dot krishnan at gmail dot com
9 months ago
An example where an OutOfBoundsException can occur:
Lets say post a certain division process, we wish to access a value in an Array [provided ofcourse if the result value of the division is within the size of the Array]..

    if ($iNum2 == 0){
        throw new Exception("Division by Zero");
    $iResult = $iNum1 / $iNum2;
    echo ("Division result is: ".($iResult)."<br/>");
catch (Exception $e){
    echo ("Division by Zero is not possible.".($e)."<br/>");

$rg_Array = array(1,2,3,4);

    if ($iResult > sizeof($rg_Array)- 1){
        throw new Exception("Exceeding key values");
echo ("Capturing value from \$rg_Array post Division process:".($rg_Array[$iResult])."<br/>");
catch (Exception $e){
    echo ("Value of Division result is out of bounds for the array.".($e)."<br/>");
2 years ago
i wish i know what's the difference between
OutOfRangeException and OutOfBoundsException lol
To Top