FREGetObjectAsUTF8()

AIR 3.0 以降

使用方法

FREResult FREGetObjectAsUTF8(FREObject object, uint32_t* length, const uint8_t** value);

パラメーター

object
FREObject。

length
uint32_t へのポインター。 length の値は、 value 配列のバイト数です。length には null 終端文字が含まれます。length は、FREObject 変数が表す ActionScript String 変数の長さに対応します。

value
uint8_t 配列へのポインター。関数は、FREObject 変数が表す ActionScript String 変数の文字を使用して、この配列に値を入力します。この文字列では UTF-8 エンコーディングを使用し、null 終端文字を含めます。

戻り値

FREResult。戻り値には、以下が含まれます(ただし、これらに限定されません)。

FRE_OK
関数が成功し、 value および length パラメーターが正しく設定されています。

FRE_TYPE_MISMATCH
FREObject パラメーターには、ActionScript String 値が含まれていません。

FRE_INVALID_OBJECT
FREObject パラメーターが無効です。

FRE_INVALID_ARGUMENT
value または length パラメーターは NULL です。

FRE_WRONG_THREAD
ランタイムにネイティブ拡張関数に対する未実行の呼び出しがあるスレッドとは別のスレッドから、メソッドが呼び出されました。

説明

uint8_t 配列の値を ActionScript String オブジェクトの文字列値に設定するには、この関数を呼び出します。

value パラメーターに返される文字列について、次のことを考慮してください。

  • 文字列は変更できません。

  • 文字列が有効なのは、ランタイムが呼び出したネイティブ拡張関数が完了するまでの間だけです。

  • 他の C API 関数を呼び出すと、文字列は無効になります。

したがって、後で文字列を操作する場合または文字列にアクセスする場合は、すぐに独自に作成した配列に文字列をコピーしてください。