Interstage Application Server リファレンスマニュアル（API編）

1.11.3 CORBA_xx_alloc()

名前

　CORBA_xx_alloc　− データ型のメモリ領域の獲得

形式

　#include <orb.h>
　CORBA_short              *CORBA_short_alloc( ) ;
　CORBA_long               *CORBA_long_alloc( ) ;
　CORBA_unsigned_short     *CORBA_unsigned_short_alloc( ) ;
　CORBA_unsigned_long      *CORBA_unsigned_long_alloc( ) ;
　CORBA_long_long          *CORBA_long_long_alloc( ) ;
　CORBA_float              *CORBA_float_alloc( ) ;
　CORBA_double             *CORBA_double_alloc( ) ;
　CORBA_long_double        *CORBA_long_double_alloc( ) ;
　CORBA_char               *CORBA_char_alloc( ) ;
　CORBA_wchar              *CORBA_wchar_alloc( ) ;
　CORBA_boolean            *CORBA_boolean_alloc( ) ;
　CORBA_octet              *CORBA_octet_alloc( ) ;
　CORBA_enum               *CORBA_enum_alloc( ) ;
　CORBA_any                *CORBA_any_alloc( ) ;
　CORBA_string             CORBA_string_alloc( CORBA_unsigned_long len );
　CORBA_wstring            CORBA_wstring_alloc( CORBA_unsigned_long len );
　CORBA_string             *CORBA_string_ptr_alloc( ) ;
　CORBA_wstring            *CORBA_wstring_ptr_alloc( ) ;
　CORBA_Object             CORBA_Object_alloc( ) ;

機能説明

　CORBA_string_alloc()およびCORBA_wstring_alloc()は、lenで指定された文字数+1バイトの文字列領域を獲得し、文字列の先頭ポインタを返します。
　CORBA_string_ptr_alloc()およびCORBA_wstring_ptr_alloc()は、それぞれCORBA_stringとCORBA_wstringのポインタの格納領域を獲得し、そのアドレスを返します。
　それ以外のCORBA_xx_alloc()については、各データ型xxのサイズの領域を獲得して、そのアドレスを返します。

　ここで獲得した領域を解放する場合は、CORBA_free()を使用します。

復帰値

　正常終了した場合は、獲得した領域のアドレスが返されます。
　異常終了した場合は、NULLが返されます。

注意事項

　CORBA_ORB_init()を呼び出していない場合、常にNULLが返されます。