使用 ActionScript String 对象

在本机函数中，输入参数可与 ActionScript String 类对象相对应。所有本机函数参数均为 FREObject 类型。因此，若要使用 ActionScript String 参数，您应获取 FREObject 参数的 ActionScript String 值。可将该值存储在对应的 C 字符串变量中。使用 C API 函数 FREGetObjectAsUTF8() ：

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

调用 FREGetObjectAsUTF8() 后，ActionScript String 值将位于 value 参数中， length 参数以字节为单位指示值字符串的长度。

如果输出参数或返回值与 ActionScript String 类对象对应，则应使用 C API 创建 ActionScript String 对象。应在 C 字符串变量中提供指向 FREObject 变量的指针和字符串值以及以字节为单位的长度。运行时将创建 ActionScript String 对象并设置与其对应的 FREObject 变量。使用 C API 函数 FRENewObjectFromUTF8() ：

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

value 参数字符串值必须采用 UTF-8 编码，并包括 null 终止符。

注：任何 C API 函数的所有字符串参数均采用 UTF-8 编码并包括 null 终止符。