Class ByteString

The ByteString class represents a bag of bytes. A ByteString may have '\0' values embedded within it. It may also have data that is not valid as utf-8. The ByteString class currently does not support any primitive operations.

Create a new ByteString of a given size.

byte is used to populate the returned ByteString. By default, it is \0.

• ValueError if size <= 0.

Call fn for each Byte within the given ByteString.

Attempt to transform the given ByteString into a String. The action taken depends on the value of encode.

If encode is "error", then invalid utf-8 or embedded '\0' values within self will result in None.

Replaces a section of self, starting at index, with the contents of bytes.

If a negative index is given, it is treated as an offset from the end of self, with -1 being considered the last element.

If start and stop are provided, only the section between them in bytes will be used (if only start is provided, the section will include the remainder of self). They may also be negative.

This method returns self, so that it can be chained with others.

• IndexError if index is out of range for self.
• IndexError if either start or stop are out of range for bytes, or if start is larger than stop.
• IndexError if the section to replace extends out of range.
• ValueError if bytes is empty (nothing to replace with).

Return the number of Byte values within self.

Create a new ByteString copying a section of self from start to stop.

If a negative index is given, it is treated as an offset from the end of self, with -1 being considered the last element.

On error, this generates an empty ByteString. Error conditions are:

• Either start or stop is out of range.
• The start is larger than the stop (reversed).