ExtensionType 类

ExtensionType 类

方法

ExtensionType 类继承自 DataType，但也定义了特定于扩展类型的额外方法。

• $storage_type()：返回用于存储值的底层 DataType。

• $storage_id()：返回与 $storage_type() 对应的 Type 标识符。

• $extension_name()：返回扩展名称。

• $extension_metadata()：以 raw() 向量形式返回扩展元数据的序列化版本。

• $extension_metadata_utf8()：以 UTF-8 编码字符串形式返回扩展元数据的序列化版本。

• $WrapArray(array)：将存储 Array 包装到具有此扩展类型的 ExtensionArray 中。

此外，子类可以覆盖以下方法来自定义扩展类的行为。

• $deserialize_instance()：当新的 ExtensionType 初始化时调用此方法，负责解析和验证序列化的 extension_metadata（一个 raw() 向量），以便 R6 ExtensionType 子类的字段和/或方法可以检查其内容。实现还必须检查 storage_type 以确保它与扩展类型兼容。

• $as_vector(extension_array)：将 Array 或 ChunkedArray 转换为 R 向量。当对 ExtensionArray 对象调用 as.vector() 时，当包含 ExtensionArray 的 RecordBatch 转换为 data.frame() 时，或者当 ChunkedArray（例如，Table 中的列）转换为 R 向量时，将调用此方法。默认方法返回转换后的存储数组。

• $ToString() 返回一个字符串表示形式，当打印此类型或此类型的数组时，该字符串表示形式将打印到控制台。