昇腾社区首页
中文
注册
开发者
下载

GetFeatureByIndice接口

API定义

APP_ERROR GetFeatureByIndice(int64_t count, const int64_t *indices, int64_t *labels = nullptr, void *features = nullptr, FeatureAttr *attributes = nullptr, ExtraValAttr *extraVal = nullptr) const;

功能描述

按照位置来获取底库特征。

输入

int64_t count:待获取的特征数量。

const int64_t *indices:待获取的特征在底库中的位置。

输出

int64_t *labels:待获取的特征对应的label。

void *features:待获取的特征向量。

FeatureAttr *attributes:待获取的特征时空属性。

ExtraValAttr *extraVal:待获取的特征额外属性。

返回值

APP_ERROR:调用返回状态,具体请参见接口调用返回值参考

约束说明

  • “count”单次取值在[1, 1e6]区间。
  • “indices”长度为count,否则可能出现越界读写错误并引起程序崩溃。值需大于等于0,小于底库数量。
  • “labels”“nullptr”时表示不用获取,或者长度为count * 向量维度dim,否则可能出现越界读写错误并引起程序崩溃。
  • “features”“nullptr”时表示不用获取,或者长度为count * 向量维度dim,否则可能出现越界读写错误并引起程序崩溃。
  • “attributes”“nullptr”时表示不用获取,或者长度为count,否则可能出现越界读写错误并引起程序崩溃。
  • “extraVal”“nullptr”时表示不用获取,或者长度为count,否则可能出现越界读写错误并引起程序崩溃。