ORTValue

Objective-C

@interface ORTValue : NSObject

Swift

class ORTValue : NSObject

ORT 值封裝了在執行時作為模型輸入或輸出使用的資料。

  • 不可用

    宣告

    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。