diff --git a/README.md b/README.md index ca751072..7dad4c6e 100644 --- a/README.md +++ b/README.md @@ -1998,7 +1998,8 @@ Struct ```python from struct import pack, unpack - = pack('', [, ...]) # Packages arguments. Can raise struct.error. + + = pack('', [, ...]) # Packs objects according to format string. = unpack('', ) # Use iter_unpack() to get iterator of tuples. ``` @@ -2054,23 +2055,19 @@ from array import array Memory View ----------- -* **A sequence object that points to the memory of another bytes-like object.** -* **Each element can reference a single or multiple consecutive bytes, depending on format.** -* **Order and number of elements can be changed with slicing.** -* **Casting only works between char and other types and uses system's sizes.** -* **Byte order is always determined by the system.** +**A sequence object that points to the memory of another bytes-like object. Each element can reference a single or multiple consecutive bytes, depending on format. Order and number of elements can be changed with slicing.** ```python = memoryview() # Immutable if bytes, else mutable. = [index] # Returns an int or a float. - = [] # Mview with rearranged elements. - = .cast('') # Casts memoryview to the new format. -.release() # Releases memory buffer of target object. + = [] # Returns mview with rearranged elements. + = .cast('') # Only works between b/B/c and other types. +.release() # Releases memory buffer of the base object. ``` ```python = bytes() # Returns a new bytes object. - = .join() # Joins mviews using bytes object as sep. + = .join() # Joins mviews using bytes as a separator. = array('', ) # Treats mview as a sequence of numbers. .write() # Writes mview to the binary file. ``` @@ -2088,11 +2085,14 @@ Deque ```python from collections import deque +``` + +```python = deque() # Also `maxlen=None`. .appendleft() # Opposite element is dropped if full. -.extendleft() # Collection gets reversed. - = .popleft() # Raises IndexError if empty. +.extendleft() # Passed collection gets reversed. .rotate(n=1) # Rotates elements to the right. + = .popleft() # Raises IndexError if empty. ``` diff --git a/index.html b/index.html index 5640f250..3dbf04f2 100644 --- a/index.html +++ b/index.html @@ -54,7 +54,7 @@
- +
@@ -1648,7 +1648,8 @@
  • Module that performs conversions between a sequence of numbers and a bytes object.
  • System’s type sizes, byte order, and alignment rules are used by default.
    • from struct import pack, unpack
-<bytes> = pack('<format>', <el_1> [, ...])  # Packages arguments. Can raise struct.error.
+
+<bytes> = pack('<format>', <el_1> [, ...])  # Packs objects according to format string.
 <tuple> = unpack('<format>', <bytes>)       # Use iter_unpack() to get iterator of tuples.
    @@ -1695,22 +1696,16 @@

    Format

    <bytes> = bytes(<array>) # Converts array to a bytes object. <file>.write(<array>) # Writes array to the binary file. -

    #Memory View

      -
    • A sequence object that points to the memory of another bytes-like object.
      • -
    • Each element can reference a single or multiple consecutive bytes, depending on format.
      • -
    • Order and number of elements can be changed with slicing.
      • -
    • Casting only works between char and other types and uses system's sizes.
      • -
    • Byte order is always determined by the system.
      • -
    <mview> = memoryview(<bytes/bytearray/array>)  # Immutable if bytes, else mutable.
+
    #Memory View
    A sequence object that points to the memory of another bytes-like object. Each element can reference a single or multiple consecutive bytes, depending on format. Order and number of elements can be changed with slicing.
    <mview> = memoryview(<bytes/bytearray/array>)  # Immutable if bytes, else mutable.
 <real>  = <mview>[index]                       # Returns an int or a float.
-<mview> = <mview>[<slice>]                     # Mview with rearranged elements.
-<mview> = <mview>.cast('<typecode>')           # Casts memoryview to the new format.
-<mview>.release()                              # Releases memory buffer of target object.
+<mview> = <mview>[<slice>]                     # Returns mview with rearranged elements.
+<mview> = <mview>.cast('<typecode>')           # Only works between b/B/c and other types.
+<mview>.release()                              # Releases memory buffer of the base object.
 
    
 
 
 
    <bytes> = bytes(<mview>)                       # Returns a new bytes object.
-<bytes> = <bytes>.join(<coll_of_mviews>)       # Joins mviews using bytes object as sep.
+<bytes> = <bytes>.join(<coll_of_mviews>)       # Joins mviews using bytes as a separator.
 <array> = array('<typecode>', <mview>)         # Treats mview as a sequence of numbers.
 <file>.write(<mview>)                          # Writes mview to the binary file.
 
    
@@ -1719,14 +1714,15 @@ 
    Format
    # Returns hex pairs. Accepts `sep=<str>`.

    #Deque

    A thread-safe list with efficient appends and pops from either side. Pronounced "deck".

    from collections import deque
-<deque> = deque(<collection>)                  # Also `maxlen=None`.
-<deque>.appendleft(<el>)                       # Opposite element is dropped if full.
-<deque>.extendleft(<collection>)               # Collection gets reversed.
-<el> = <deque>.popleft()                       # Raises IndexError if empty.
-<deque>.rotate(n=1)                            # Rotates elements to the right.
    +
    <deque> = deque(<collection>)                  # Also `maxlen=None`.
+<deque>.appendleft(<el>)                       # Opposite element is dropped if full.
+<deque>.extendleft(<collection>)               # Passed collection gets reversed.
+<deque>.rotate(n=1)                            # Rotates elements to the right.
+<el> = <deque>.popleft()                       # Raises IndexError if empty.
+

    #Threading

    CPython interpreter can only run a single thread at a time. Using multiple threads won't result in a faster execution, unless at least one of the threads contains an I/O operation.

    from threading import Thread, Timer, RLock, Semaphore, Event, Barrier
 from concurrent.futures import ThreadPoolExecutor, as_completed
    @@ -2936,7 +2932,7 @@

    Format