qualifiedTypeName()
javaLib.qualifiedTypeName() システム関数は、 EGL Java™ オブジェクト・スペース内にあるオブジェクトのクラスの完全修飾名を戻します。
javaLib.qualifiedTypeName() および類似する関数が実行される EGL Java オブジェクト・スペースについて詳しくは、『Java アクセス関数』を参照してください。 EGL は、この Java アクセスのメソッドを以前のバージョンとの互換性のために保守します。新規コードの場合は、より強力な ExternalType 構文を使用してください。詳しくは、『ExternalType パーツ』を参照してください。
構文
javaLib.qualifiedTypeName(identifier javaObjId in)
returns (result STRING)
- identifier
- オブジェクト・スペース内のオブジェクトを参照する ID (大/小文字を区別)。STRING 型と代入互換性のある任意の変数または式を入力することができます。また、入力データは、後述の例で示すとおり、Java objID 型にキャストされます。 EGL は、引数値の先頭と最後から、1 バイトのブランクと 2 バイトのブランクを削除します。
- result
- 変数に戻り値を代入する場合、その変数には STRING 型との代入互換性がなければなりません。
例
以下の例では、指定された ID に関連付けられたクラス名を戻します。
myClassName = javaLib.qualifiedTypeName("myId" as "objID:java");
エラーに関する考慮事項
v60ExceptionCompatibility プログラム・プロパティーが設定されていないか、NO に設定されている場合、例外が発生すると、EGL は JavaObjectException をスローします。 その他のエラーが発生した場合は、EGL によって RuntimeException がスローされます。
v60ExceptionCompatibility プログラム・プロパティーが YES に設定されている場合、javaLib.qualifiedTypeName() の処理中にエラーが発生すると、sysVar.errorCode は次の表の値に設定されます。
| sysVar.errorCode の値 | 説明 |
|---|---|
| 00001001 | オブジェクトの値が NULL でした。 または指定された識別子がオブジェクト・スペース内にありませんでした。 |