Memoryview

README.md

@@ -1957,18 +1957,21 @@ Memory View
 
 ```python
 <mview> = memoryview(<bytes/bytearray/array>)
-<num>   = <mview>[<index>]                     # Can be int or float.
+<num>   = <mview>[<index>]                     # Returns an int or a float.
 <mview> = <mview>[<slice>]                     # Mview with rearranged elements.
 <mview> = <mview>.cast('<typecode>')           # Casts a memoryview to a new format.
 <mview>.release()                              # Releases the object's memory buffer.
 ```
 
 ```python
-<bin_file>.write(<mview>)
+<bin_file>.write(<mview>)                      # Writes mview to a binary file.
-<bytes> = bytes(<mview>)                       # Or: <mview>.tobytes()
+<bytes> = bytes(<mview>)                       # Creates a new bytes object.
 <bytes> = <bytes>.join(<coll_of_mviews>)       # Joins mviews using bytes object as sep.
-<list>  = list(<mview>)                        # Returns numbers. Or: <mview>.tolist()
+```
-<str>   = str(<mview>, 'utf-8')                # Or: <bytes>.decode('utf-8')
+```python
+<list>  = list(<mview>)                        # Returns list of ints or floats.
+<str>   = str(<mview>, 'utf-8')
 <int>   = int.from_bytes(<mview>, byteorder='big|little', signed=False)
 '<hex>' = <mview>.hex()
 ```

index.html

@@ -1734,18 +1734,19 @@ db = connector.connect(host=<str>, user=<str>, password=<str>,
 <li><strong>Each element can reference a single or multiple consecutive bytes, depending on format.</strong></li>
 <li><strong>Order and number of elements can be changed with slicing.</strong></li>
 </ul><pre><code class="python language-python hljs">&lt;mview&gt; = memoryview(&lt;bytes/bytearray/array&gt;)
-&lt;num&gt;   = &lt;mview&gt;[&lt;index&gt;]                     <span class="hljs-comment"># Can be int or float.</span>
+&lt;num&gt;   = &lt;mview&gt;[&lt;index&gt;]                     <span class="hljs-comment"># Returns an int or a float.</span>
 &lt;mview&gt; = &lt;mview&gt;[&lt;slice&gt;]                     <span class="hljs-comment"># Mview with rearranged elements.</span>
 &lt;mview&gt; = &lt;mview&gt;.cast(<span class="hljs-string">'&lt;typecode&gt;'</span>)           <span class="hljs-comment"># Casts a memoryview to a new format.</span>
 &lt;mview&gt;.release()                              <span class="hljs-comment"># Releases the object's memory buffer.</span>
 </code></pre></div>
 
 
-<pre><code class="python language-python hljs">&lt;bin_file&gt;.write(&lt;mview&gt;)
+<pre><code class="python language-python hljs">&lt;bin_file&gt;.write(&lt;mview&gt;)                      <span class="hljs-comment"># Writes mview to a binary file.</span>
-&lt;bytes&gt; = bytes(&lt;mview&gt;)                       <span class="hljs-comment"># Or: &lt;mview&gt;.tobytes()</span>
+&lt;bytes&gt; = bytes(&lt;mview&gt;)                       <span class="hljs-comment"># Creates a new bytes object.</span>
 &lt;bytes&gt; = &lt;bytes&gt;.join(&lt;coll_of_mviews&gt;)       <span class="hljs-comment"># Joins mviews using bytes object as sep.</span>
-&lt;list&gt;  = list(&lt;mview&gt;)                        <span class="hljs-comment"># Returns numbers. Or: &lt;mview&gt;.tolist()</span>
+</code></pre>
-&lt;str&gt;   = str(&lt;mview&gt;, <span class="hljs-string">'utf-8'</span>)                <span class="hljs-comment"># Or: &lt;bytes&gt;.decode('utf-8')</span>
+<pre><code class="python language-python hljs">&lt;list&gt;  = list(&lt;mview&gt;)                        <span class="hljs-comment"># Returns list of ints or floats.</span>
+&lt;str&gt;   = str(&lt;mview&gt;, <span class="hljs-string">'utf-8'</span>)
 &lt;int&gt;   = int.from_bytes(&lt;mview&gt;, byteorder=<span class="hljs-string">'big|little'</span>, signed=<span class="hljs-keyword">False</span>)
 <span class="hljs-string">'&lt;hex&gt;'</span> = &lt;mview&gt;.hex()
 </code></pre>