名前
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が返されます。