FT_DSP.gitlink.net/master/html/functionlib/dsplib/tensorlistreserve.html

180 lines
14 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html class="writer-html5" lang="zh-CN" data-content_root="../../">
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Tensorlistreserve &mdash; MindSpore Signal+ 使用手册 alpha 文档</title>
<link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=03e43079" />
<link rel="stylesheet" type="text/css" href="../../_static/css/theme.css?v=e59714d7" />
<link rel="stylesheet" type="text/css" href="../../_static/table.css?v=72b86d3e" />
<script src="../../_static/jquery.js?v=5d32c60e"></script>
<script src="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
<script src="../../_static/documentation_options.js?v=406e4f49"></script>
<script src="../../_static/doctools.js?v=9bcbadda"></script>
<script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../../_static/translations.js?v=beaddf03"></script>
<script src="../../_static/table.js?v=99ed15ba"></script>
<script src="../../_static/js/theme.js"></script>
<link rel="index" title="索引" href="../../genindex.html" />
<link rel="search" title="搜索" href="../../search.html" />
<link rel="next" title="Tensorlistsetitem" href="tensorlistsetitem.html" />
<link rel="prev" title="Tensorlistgetitem" href="tensorlistgetitem.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="../../index.html" class="icon icon-home">
MindSpore Signal+ 使用手册
</a>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
<input type="text" name="q" placeholder="搜索文档" aria-label="搜索文档" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="导航菜单">
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../quickstart/index.html">快速入门</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../appdevelop/index.html">应用开发示例</a></li>
<li class="toctree-l1"><a class="reference internal" href="../index.html">算子库支持</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../refdoc/index.html">参考资料</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="移动版导航菜单" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../../index.html">MindSpore Signal+ 使用手册</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="页面导航">
<ul class="wy-breadcrumbs">
<li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
<li class="breadcrumb-item"><a href="../index.html">算子库支持</a></li>
<li class="breadcrumb-item"><a href="dsplib_index.html">DSP Library C API Reference</a></li>
<li class="breadcrumb-item active">Tensorlistreserve</li>
<li class="wy-breadcrumbs-aside">
<a href="../../_sources/functionlib/dsplib/tensorlistreserve.rst.txt" rel="nofollow"> 查看页面源码</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="tensorlistreserve">
<h1>Tensorlistreserve<a class="headerlink" href="#tensorlistreserve" title="Link to this heading"></a></h1>
<p>为张量列表TensorList预分配指定数量和形状的张量空间。该算子用于初始化TensorList结构设置其内部张量的形状信息和TensorList本身的形状。</p>
<p>该算子不区分具体的数据类型主要负责设置TensorList的元数据信息。</p>
<dl class="simple">
<dt>输入:</dt><dd><ul class="simple">
<li><p><strong>num_elements</strong> - TensorList中包含的张量数量int类型</p></li>
<li><p><strong>element_shape</strong> - 每个张量的形状数组int*类型表示TensorList中每个张量的维度信息。</p></li>
<li><p><strong>shape_size</strong> - 每个张量的形状大小int类型即element_shape数组的长度。</p></li>
<li><p><strong>tensor_list_c_element_shape_size</strong> - 输出参数用于存储TensorList内部每个张量的形状大小int*类型)。</p></li>
<li><p><strong>tensor_list_c_element_shape</strong> - 输出参数用于存储TensorList内部每个张量的形状int*类型)。</p></li>
<li><p><strong>tensor_c_shape_size</strong> - 输出参数用于存储TensorList本身的形状大小int*类型)。</p></li>
<li><p><strong>tensor_c_shape</strong> - 输出参数用于存储TensorList本身的形状int*类型)。</p></li>
</ul>
</dd>
<dt>输出:</dt><dd><ul class="simple">
<li><p><strong>tensor_list_c_element_shape_size</strong> - 被设置为shape_size的值。</p></li>
<li><p><strong>tensor_list_c_element_shape</strong> - 被填充为element_shape的值。</p></li>
<li><p><strong>tensor_c_shape_size</strong> - 被设置为1表示TensorList本身是一个1维结构。</p></li>
<li><p><strong>tensor_c_shape</strong> - 被设置为num_elements表示TensorList包含num_elements个张量。</p></li>
</ul>
</dd>
<dt>支持平台:</dt><dd><p><code class="docutils literal notranslate"><span class="pre">FT78NE</span></code>
<code class="docutils literal notranslate"><span class="pre">MT7004</span></code></p>
</dd>
</dl>
<div class="admonition note">
<p class="admonition-title">备注</p>
<ul class="simple">
<li><p>该算子不区分具体的数据类型主要操作TensorList的元数据</p></li>
<li><p>TensorList中的每个张量必须具有相同的形状element_shape</p></li>
<li><p>调用前需要确保tensor_list_c_element_shape和tensor_c_shape指向的内存空间足够大</p></li>
</ul>
</div>
<p><strong>函数定义:</strong></p>
<dl class="c function">
<dt class="sig sig-object c" id="c.Tensorlistreserve">
<span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">Tensorlistreserve</span></span></span><span class="sig-paren">(</span><span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="n"><span class="pre">num_elements</span></span>, <span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="n"><span class="pre">element_shape</span></span>, <span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="n"><span class="pre">shape_size</span></span>, <span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="n"><span class="pre">tensor_list_c_element_shape_size</span></span>, <span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="n"><span class="pre">tensor_list_c_element_shape</span></span>, <span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="n"><span class="pre">tensor_c_shape_size</span></span>, <span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="n"><span class="pre">tensor_c_shape</span></span><span class="sig-paren">)</span><a class="headerlink" href="#c.Tensorlistreserve" title="Link to this definition"></a><br /></dt>
<dd></dd></dl>
<p><strong>C调用示例</strong></p>
<div class="highlight-c notranslate"><div class="highlight"><pre><span></span><span class="linenos"> 1</span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;stdio.h&gt;</span>
<span class="linenos"> 2</span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;tensorlistreserve.h&gt;</span>
<span class="linenos"> 3</span>
<span class="linenos"> 4</span><span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">argc</span><span class="p">,</span><span class="w"> </span><span class="kt">char</span><span class="o">*</span><span class="w"> </span><span class="n">argv</span><span class="p">[])</span><span class="w"> </span><span class="p">{</span>
<span class="linenos"> 5</span><span class="w"> </span><span class="c1">// 参数设置</span>
<span class="linenos"> 6</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">num_elements</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">3</span><span class="p">;</span><span class="w"> </span><span class="c1">// TensorList包含3个张量</span>
<span class="linenos"> 7</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">element_shape</span><span class="p">[]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{</span><span class="mi">4</span><span class="p">,</span><span class="w"> </span><span class="mi">5</span><span class="p">};</span><span class="w"> </span><span class="c1">// 每个张量的形状为[4, 5]</span>
<span class="linenos"> 8</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">shape_size</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">2</span><span class="p">;</span><span class="w"> </span><span class="c1">// element_shape数组长度为2</span>
<span class="linenos"> 9</span>
<span class="linenos">10</span><span class="w"> </span><span class="c1">// 输出参数</span>
<span class="linenos">11</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">tensor_list_c_element_shape_size</span><span class="p">;</span>
<span class="linenos">12</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">tensor_list_c_element_shape</span><span class="p">[</span><span class="mi">2</span><span class="p">];</span><span class="w"> </span><span class="c1">// 空间大小应至少为shape_size</span>
<span class="linenos">13</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">tensor_c_shape_size</span><span class="p">;</span>
<span class="linenos">14</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">tensor_c_shape</span><span class="p">;</span>
<span class="linenos">15</span>
<span class="linenos">16</span><span class="w"> </span><span class="c1">// 调用算子</span>
<span class="hll"><span class="linenos">17</span><span class="w"> </span><span class="n">Tensorlistreserve</span><span class="p">(</span><span class="n">num_elements</span><span class="p">,</span><span class="w"> </span><span class="n">element_shape</span><span class="p">,</span><span class="w"> </span><span class="n">shape_size</span><span class="p">,</span>
</span><span class="hll"><span class="linenos">18</span><span class="w"> </span><span class="o">&amp;</span><span class="n">tensor_list_c_element_shape_size</span><span class="p">,</span>
</span><span class="hll"><span class="linenos">19</span><span class="w"> </span><span class="n">tensor_list_c_element_shape</span><span class="p">,</span>
</span><span class="hll"><span class="linenos">20</span><span class="w"> </span><span class="o">&amp;</span><span class="n">tensor_c_shape_size</span><span class="p">,</span>
</span><span class="linenos">21</span><span class="w"> </span><span class="o">&amp;</span><span class="n">tensor_c_shape</span><span class="p">);</span>
<span class="linenos">22</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
<span class="linenos">23</span><span class="p">}</span>
</pre></div>
</div>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="页脚">
<a href="tensorlistgetitem.html" class="btn btn-neutral float-left" title="Tensorlistgetitem" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> 上一页</a>
<a href="tensorlistsetitem.html" class="btn btn-neutral float-right" title="Tensorlistsetitem" accesskey="n" rel="next">下一页 <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; 版权所有 2025 - 2026, NUDT-674。</p>
</div>
利用 <a href="https://www.sphinx-doc.org/">Sphinx</a> 构建,使用的
<a href="https://github.com/readthedocs/sphinx_rtd_theme">主题</a>
<a href="https://readthedocs.org">Read the Docs</a> 开发.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>