ORTValue

Objective-C

@interface ORTValue : NSObject

Swift

class ORTValue : NSObject

ORT value 封装了运行时用作模型输入或输出的数据。

  • 不可用

    声明

    Objective-C

    - (instancetype)init NS_UNAVAILABLE;

  • 创建一个张量类型的值。张量数据由调用者分配。

    声明

    Objective-C

    - (nullable instancetype)
    initWithTensorData:(nonnull NSMutableData *)tensorData
           elementType:(ORTTensorElementDataType)elementType
                 shape:(nonnull NSArray<NSNumber *> *)shape
                 error:(NSError *_Nullable *_Nullable)error;

    Swift

    init(tensorData: NSMutableData, elementType: ORTTensorElementDataType, shape: [NSNumber]) throws

    参数

    tensorData

    张量数据。
    elementType

    张量元素数据类型。
    shape

    张量形状。
    error

    发生错误时设置的可选错误信息。

    返回值

    实例，如果发生错误则为 nil。

  • 创建一个字符串张量类型的值。字符串数据将被复制到此 ORTValue 实例拥有的缓冲区中。

    从 1.16 版本开始可用。

    声明

    Objective-C

    - (nullable instancetype)
    initWithTensorStringData:(nonnull NSArray<NSString *> *)tensorStringData
                       shape:(nonnull NSArray<NSNumber *> *)shape
                       error:(NSError *_Nullable *_Nullable)error;

    Swift

    init(tensorStringData: [String], shape: [NSNumber]) throws

    参数

    tensorStringData

    张量字符串数据。
    shape

    张量形状。
    error

    发生错误时设置的可选错误信息。

    返回值

    实例，如果发生错误则为 nil。

  • 获取类型信息。

    声明

    Objective-C

    - (nullable ORTValueTypeInfo *)typeInfoWithError:
    (NSError *_Nullable *_Nullable)error;

    Swift

    func typeInfo() throws -> ORTValueTypeInfo

    参数

    error

    发生错误时设置的可选错误信息。

    返回值

    类型信息，如果发生错误则为 nil。

  • 获取张量类型和形状信息。这假设该值为张量。

    声明

    Objective-C

    - (nullable ORTTensorTypeAndShapeInfo *)tensorTypeAndShapeInfoWithError:
    (NSError *_Nullable *_Nullable)error;

    Swift

    func tensorTypeAndShapeInfo() throws -> ORTTensorTypeAndShapeInfo

    参数

    error

    发生错误时设置的可选错误信息。

    返回值

    张量类型和形状信息，如果发生错误则为 nil。

  • 获取张量数据。这假设该值为张量。

    这直接返回值的底层数据，而不是其副本。内存的生命周期可能与此值相关联，例如，如果它是由 ORT 分配的。另一方面，如果值是用用户提供的数据创建的，则内存的生命周期与值无关。

    声明

    Objective-C

    - (nullable NSMutableData *)tensorDataWithError:
    (NSError *_Nullable *_Nullable)error;

    Swift

    func tensorData() throws -> NSMutableData

    参数

    error

    发生错误时设置的可选错误信息。

    返回值

    张量数据，如果发生错误则为 nil。

  • 获取张量字符串数据。这假设该值为字符串张量。

    这返回值的底层字符串数据的副本。

    从 1.16 版本开始可用。

    声明

    Objective-C

    - (nullable NSArray<NSString *> *)tensorStringDataWithError:
    (NSError *_Nullable *_Nullable)error;

    Swift

    func tensorStringData() throws -> [String]

    参数

    error

    发生错误时设置的可选错误信息。

    返回值

    张量字符串数据的副本，如果发生错误则为 nil。