PEAR Manual
Prev |  | Next

# satellite_caught_exception

satellite_caught_exception -- See if an exception was caught from the previous function

## Description

``bool satellite_caught_exception` ()`

Warning
This function is EXPERIMENTAL. That means, that the behaviour of this function, the function name, in concreto ANYTHING documented here can change in a future release of this package WITHOUT NOTICE. Be warned, and use this function at your own risk.

This function returns `TRUE` if an exception has been caught.

Example 1. Sample IDL file
    /* ++?????++ Out of Cheese Error. Redo From Start. */
    exception OutOfCheeseError {
        int parameter;
    }

    interface AnotherInterface {
        void AskWhy() raises (OutOfCheeseError);
    }

Example 2. PHP code for handling CORBA exceptions
    <?php
    $obj = new OrbitObject ($ior);

    $obj->AskWhy();

    if (satellite_caught_exception()) {
        if ("IDL:OutOfCheeseError:1.0" == satellite_exception_id()) {
            $exception = satellite_exception_value();
            echo $exception->parameter;
        }
    }
    ?>

Prev | Home | Next
OrbitStruct | Up | satellite_exception_id