Jump to content

SomGetGlobalEnvironment: Difference between revisions

From EDM2
Created page with "This function returns a pointer to the current global Environment structure. ==Syntax== <PRE> Environment *rc; rc = somGetGlobalEnvironment(); </PRE> ==Parameters== ==..."
 
Ak120 (talk | contribs)
mNo edit summary
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
This function returns a pointer to the current global Environment structure.  
{{DISPLAYTITLE:somGetGlobalEnvironment}}
This function returns a pointer to the current global Environment structure.


==Syntax==
==Syntax==
<PRE>
Environment    *rc;
Environment    *rc;
rc = somGetGlobalEnvironment();
rc = somGetGlobalEnvironment();
</PRE>


==Parameters==
==Parameters==


==Return Code==
==Return Code==
; rc (Environment *) : A pointer to the current global Environment structure.  
;rc (Environment *): A pointer to the current global Environment structure.


==Remarks==
==Remarks==
This function returns a pointer to the current global Environment structure. This structure can be passed to methods that require an (Environment *) argument. The caller can determine if the called method has raised an exception by testing whether  
This function returns a pointer to the current global Environment structure. This structure can be passed to methods that require an (Environment *) argument. The caller can determine if the called method has raised an exception by testing whether
 
  ev->exception._major != NO_EXCEPTION
  ev->exception._major != NO_EXCEPTION
 
If an exception has been raised, the caller can retrieve the name and value of the exception using the somExceptionId and somExceptionValue methods.
If an exception has been raised, the caller can retrieve the name and value of the exception using the somExceptionId and somExceptionValue methods.  


==Example Code==
==Example Code==
Line 23: Line 20:


==Related==
==Related==
===Data Structures ===
;Data Structures
* Environment (somcorba.h)  
* Environment (somcorba.h)
===Functions===
;Functions
* somExceptionId  
*[[somExceptionId]]
* somExceptionValue  
*[[somExceptionValue]]
* somExceptionFree  
*[[somExceptionFree]]
* somSetException  
*[[somSetException]]


[[Category:SOM Kernel]]
[[Category:SOM function]]

Latest revision as of 04:54, 6 May 2020

This function returns a pointer to the current global Environment structure.

Syntax

Environment     *rc;
rc = somGetGlobalEnvironment();

Parameters

Return Code

rc (Environment *)
A pointer to the current global Environment structure.

Remarks

This function returns a pointer to the current global Environment structure. This structure can be passed to methods that require an (Environment *) argument. The caller can determine if the called method has raised an exception by testing whether

ev->exception._major != NO_EXCEPTION

If an exception has been raised, the caller can retrieve the name and value of the exception using the somExceptionId and somExceptionValue methods.

Example Code

See function somSetException.

Related

Data Structures
  • Environment (somcorba.h)
Functions