概要

CORBA::ORB::object_to_string オペレーションによって生成された文字列を変換し、対応するオブジェクト・リファレンスを返します。

C++ バインディング

Object string_to_object ( in string str );

引数

説明

このオペレーションは、CORBA::ORB::object_to_string オペレーションによって生成された文字列を変換するためにアプリケーションで使用され、対応するオブジェクト・リファレンスを返します。

確実に ORB でオブジェクト・リファレンスの文字列形式を認識できるようにするには、文字列を生成する際にその ORB の object_to_string オペレーションを使用する必要があります。string_to_object オペレーションでは、IOR の URL、corbaloc、corbalocs、および corbanames の各形式をオブジェクト・リファレンスに変換できます。変換に失敗した場合、string_to_object オペレーションによって、次のいずれかのマイナー・コードの BAD_PARAM 標準例外が発生します。

ORB に完全準拠する場合、obj がオブジェクトの有効なリファレンスであり、2 つのオペレーションが同じ ORB で実行されると、string_to_object(object_to_string(obj)) は同じオブジェクトの有効なリファレンスを返します。ORB がサポートする IOP に完全準拠する場合は、2 つのオペレーションが異なる ORB で実行されても設定は同じままになります。

戻り値

オブジェクト・リファレンスを返します。

関連項目

CORBA::ORB::object_to_string