object GetFirstSelectedObj ( )

Return Value: The first item in a multi selection, or the current object if only one is selected. 

Arguments: none

VERY IMPORTANT: DO NOT keep an object between calls to a script function, there is no guarantee that the object will still be there the next time the function is called. For example:

int someFunc( )
{
     static object obj = GetObject("Camera");
     // do something with obj
}

If the object "Camera" is deleted between calls to this function very bad things will happen. It is better to pass the Camera object as a variable to the function.