devn00b
/
EQ2EMu


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238
							<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
<link rel="stylesheet" href="../../../../boost.css" type="text/css"/>
<link rel="stylesheet" href="ublas.css" type="text/css" />
<script type="text/javascript" src="js/jquery-1.3.2.min.js" async="async" ></script>
<script type="text/javascript" src="js/jquery.toc-gw.js" async="async" ></script>
<script type="text/x-mathjax-config">
MathJax.Hub.Config({
      jax: ["input/TeX", "output/HTML-CSS"],
      extensions: ["tex2jax.js"],
      "HTML-CSS": { preferredFont: "TeX", availableFonts: ["STIX","TeX"], scale: "80" },
      tex2jax: { 
      	inlineMath: [ ["$", "$"], ["\\(","\\)"] ], 
      	displayMath: [ ["$$","$$"], ["\\[", "\\]"] ], 
      	processEscapes: true, 
      	ignoreClass: "tex2jax_ignore|dno" },
      TeX: { noUndefined: { attributes: { mathcolor: "red", mathbackground: "#FFEEEE", mathsize: "90%" } } },
      messageStyle: "none"
    });
</script>    
<script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js"></script>

<title>Strides</title>
</head>
<body>
<h1><img src="../../../../boost.png" align="middle" />Strides</h1>
<div class="toc" id="toc"></div>
<h2><a name="extents"></a>basic_strides&lt;size_type, format_type&gt;</h2>
<h4>Description</h4>
<p>The template class <code>basic_strides</code> contains weights for a given storage format in order to map multi-indices to scalar memory indices for <a href=
"../tensor.html#tensor">tensor</a> instances.</p>

<h4>Example</h4>
<pre>
#include &lt;boost/numeric/ublas/tensor/strides.hpp&gt;

int main () {
    <b>using namespace</b> boost::numeric::ublas;
    <b>auto</b> wf = strides&lt;first_order&gt;(shape{4,3,2});
    for (<b>auto</b> i = 0u; i &lt; wf.size(); ++i)
        std::cout &lt;&lt; wf.at(i) &lt;&lt; std::endl;    
        // 1,4,12
        
    <b>auto</b> wl = strides&lt;first_order&gt;(shape{4,3,2});
    for (<b>auto</b> i = 0u; i &lt; wl.size(); ++i)
        std::cout &lt;&lt; wl.at(i) &lt;&lt; std::endl;    
        // 6,2,1        
}
</pre>
<h4>Definition</h4>
<p>Defined in the header tensor/strides.hpp.</p>

<h4>Public base classes</h4>
<p>None.</p>

<h4>Specialization</h4>
<p><code><b>template</b>&lt;<b>class</b> format_t&gt;<br><b>using</b> strides = basic_strides&lt;std::size_t,format_t&gt;</code></p>


<h4>Template parameters</h4>
<table border="1" style="font-size:100%" summary="parameters">
<tbody style="font-size:100%">
<tr>
<th>Parameter</th>
<th>Description</th>
</tr>
<tr>
<td><code>size_type</code></td>
<td>Unsigned integer type.</td>
</tr>
</tbody>
</table>

<h4>Member types</h4>
<table border="1" style="font-size:100%" summary="members">
<tbody style="font-size:100%" >
<tr>
<th>Member type</th>
<th>Description</th>
</tr>
<tr>
<td><code>value_type</code></td>
<td>Type <code>size_type</code> of the strides.</td>
</tr>
<tr>
<td><code>size_type</code></td>
<td>Unsigned integer such as <code>std::size_t</code>.</td>
</tr>
<tr>
<td><code>reference</code></td>
<td>Reference type which is <code>value_type&</code>.</td>
</tr>
<tr>
<td><code>const_reference</code></td>
<td>Constant reference type which is <code>const value_type&</code>.</td>
</tr>
<tr>
<td><code>pointer</code></td>
<td>Pointer type which is <code>value_type*</code>.</td>
</tr>
<tr>
<td><code>const_pointer</code></td>
<td>Constant pointer type which is <code>const value_type*</code>.</td>
</tr>
<tr>
<td><code>layout_type</code></td>
<td>Layout type which can be either <code>boost::numeric::ublas::first_order</code> or <code>boost::numeric::ublas::last_order</code>.</td>
</tr>

</tbody>
</table>


<h4>Member Functions</h4>
<table border="1" summary="members functions">
<tbody>
<tr>
<th>Member Function</th>
<th>Description</th>
</tr>
<tr>
<td><code>basic_strides ()</code></td>
<td>Constructs an empty instance of <code>basic_strides</code>.</td>
</tr>
<tr>
<td><code>basic_strides (basic_extents&lt;value_type&gt; const& be)</code></td>
<td>Constructs an instance based on the tensor extents specified by <code>be</code>.</td>
</tr>
<tr>
<td><code>basic_strides (std::vector&lt;value_type&gt; const& v)</code></td>
<td>Constructs an instance copying the content of <code>v</code>.</td>
</tr>
<tr>
<td><code>basic_strides (std::vector&lt;value_type&gt; && v)</code></td>
<td>Constructs an instance moving the content of <code>v</code>.</td>
</tr>
<tr>
<td><code>basic_strides (basic_strides const& other)</code></td>
<td>Constructs an instance from <code>other</code> copying its elements.</td>
</tr>
<tr>
<td><code>basic_strides (basic_strides && other)</code></td>
<td>Constructs an instance from <code>other</code> by moving its elements.</td>
</tr>
<tr>
<td><code>basic_strides& operator= (basic_strides other)</code></td>
<td>Assigns the elements of <code>other</code> to this instance.</td>
</tr>
<tr>
<td><code>const_pointer data() const</code></td>
<td>Returns a <code>const_pointer</code> to the first element.</td>
</tr>
<tr>
<td><code>const_reference operator[](size_type i) const</code></td>
<td>Returns a <code>const_reference</code> to the <code>i</code>-th element.</td>
</tr>
<tr>
<td><code>const_reference at(size_type i) const</code></td>
<td>Returns a <code>const_reference</code> to the <code>i</code>-th element.</td>
</tr>
<tr>
<td><code>bool empty()</code></td>
<td>Returns true if the container has no elements.</td>
</tr>
<tr>
<td><code>size_type size() const</code></td>
<td>Returns the number of elements.</td>
</tr>
<tr>
<td><code>void clear()</code></td>
<td>Erases all elements.</td>
</tr>
<tr>
<td><code>bool operator==(basic_strides const& b) const</code></td>
<td>Returns true if all elements are equal.</td>
</tr>
<tr>
<td><code>bool operator!=(basic_strides const& b) const</code></td>
<td>Returns true if some elements are not equal.</td>
</tr>
<tr>
<td><code>const_iterator begin() const</code></td>
<td>Returns an <code>const_iterator</code> pointing to the first element.</td>
</tr>
<tr>
<td><code>const_iterator end() const</code></td>
<td>Returns a <code>const_iterator</code> pointing to an element passed the last element.</td>
</tr>
<tr>
<td><code>std::vector&lt;size_type&gt; base() const</code></td>
<td>Returns the private member sequence container holding all elements.</td>
</tr>
</tbody>
</table>


<h4>Non-Member Functions</h4>
<table border="1" summary="members functions">
<tbody>
<tr>
<th>Function</th>
<th>Description</th>
</tr>
<tr>
<td><code>access(std::vector&lt;size_type&gt; const& i, strides&lt;layout_type&gt; w)</code></td>
<td>Returns relative memory location depending on the multi-index vector <code>i</code> and strides <code>w</code>.</td>
</tr>
<tr>
<td><code>access(size_type sum, strides&lt;layout_type&gt; w, size_type i, size_types ... is)</code></td>
<td>Returns relative memory location depending on the indices <code>i</code>, <code>is ... </code> and stride vector <code>w</code> (recursive function).</td>
</tr>
</tbody>
</table>


<hr />
<p>
Copyright (&copy;) 2018 Cem Bassoy<br />
   Use, modification and distribution are subject to the
   Boost Software License, Version 1.0.
   (See accompanying file LICENSE_1_0.txt
   or copy at <a href="http://www.boost.org/LICENSE_1_0.txt">
      http://www.boost.org/LICENSE_1_0.txt
   </a>).
</p>
<script type="text/javascript">
(function($) {
    $('#toc').toc();
})(jQuery);
</script>
</body>
</html>