下载
中文
注册

Clone

函数功能

原型1:

将Tensor进行深拷贝,返回拷贝后得到的Tensor。

  • 如果Tensor在Host侧,拷贝过程均为同步操作。
  • 如果Tensor在DVPP或Device侧,则需根据“stream”参数传入决定同步或异步操作, Tensor所在的Device需与stream所在的Device一致。

原型2:

将Tensor进行指定区域深拷贝,将src的区域内容拷贝到被赋值张量的区域,要求:

  • src和被赋值Tensor均不能为空,被赋值Tensor的长宽尺寸为[64, 4096],src的最大高度不超过“1048576”,src总尺寸(N*H*W*C)不超过“6710886”
  • src和被赋值Tensor包含相同高宽的引用区域(ReferRect),且均不为0,ReferRect宽度不超过“1920”
  • src和被赋值Tensor数据类型支持uint8、float16,且类型需一致。
  • src和被赋值Tensor仅支持NHWCHWCHW形状的Tensor(通道数为1或3,N为1),两者维度和通道数均需相等。
  • src和被赋值Tensor需要在DVPP或Device侧。
  • src和被赋值所在的Device需与stream所在的Device一致。

函数原型

// 原型1
Tensor Clone(AscendStream stream=AscendStream::DefaultStream()) const;
// 原型2
APP_ERROR Clone(const Tensor &src, AscendStream &stream = AscendStream::DefaultStream());

参数说明

参数名

输入/输出

说明

src

输入

将src的引用指定区域赋值给执行该方法的张量的引用区域。

stream

输入

AscendStream类型,默认值为AscendStream::DefaultStream()。当参数值为默认值时,接口为同步操作,其他情况下,接口为异步操作。

返回参数说明

原型1:

数据结构

说明

Tensor

Tensor类,请参见Tensor

原型2:

数据结构

说明

APP_ERROR

程序执行返回的错误码,请参考APP_ERROR说明