Lichen

Annotated lib/__builtins__/buffer.py

217:e5aa9e58703e
2016-11-23 Paul Boddie Automatically convert non-buffer, non-string objects to strings for appending.
paul@6 1
#!/usr/bin/env python
paul@6 2
paul@6 3
"""
paul@6 4
Buffer object.
paul@6 5
paul@206 6
Copyright (C) 2015, 2016 Paul Boddie <paul@boddie.org.uk>
paul@6 7
paul@6 8
This program is free software; you can redistribute it and/or modify it under
paul@6 9
the terms of the GNU General Public License as published by the Free Software
paul@6 10
Foundation; either version 3 of the License, or (at your option) any later
paul@6 11
version.
paul@6 12
paul@6 13
This program is distributed in the hope that it will be useful, but WITHOUT
paul@6 14
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
paul@6 15
FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
paul@6 16
details.
paul@6 17
paul@6 18
You should have received a copy of the GNU General Public License along with
paul@6 19
this program.  If not, see <http://www.gnu.org/licenses/>.
paul@6 20
"""
paul@6 21
paul@206 22
from native import _list_init, _list_append, _list_concat, _buffer_str
paul@206 23
paul@6 24
class buffer(object):
paul@206 25
paul@206 26
    "A buffer, used to build strings."
paul@206 27
paul@209 28
    def __init__(self, args=None, size=0):
paul@206 29
paul@206 30
        "Initialise a buffer from the given 'args' or the given 'size'."
paul@206 31
paul@209 32
        if args is not None:
paul@209 33
            n = len(args)
paul@209 34
        elif isinstance(size, int):
paul@209 35
            n = size
paul@209 36
        else:
paul@209 37
            raise TypeError(size)
paul@209 38
paul@209 39
        self.__data__ = _list_init(n)
paul@206 40
paul@206 41
        # Append all arguments in string form to the buffer.
paul@206 42
paul@206 43
        if args:
paul@206 44
            for arg in args:
paul@206 45
                _list_append(self, str(arg))
paul@206 46
paul@206 47
    def append(self, s):
paul@206 48
paul@206 49
        "Append 's' to the buffer."
paul@206 50
paul@206 51
        if isinstance(s, buffer):
paul@206 52
            _list_concat(self, s)
paul@206 53
        elif isinstance(s, string):
paul@206 54
            _list_append(self, s)
paul@206 55
        else:
paul@217 56
            _list_append(self, str(s))
paul@206 57
paul@206 58
    def __str__(self):
paul@206 59
paul@206 60
        "Return a string representation."
paul@206 61
paul@206 62
        return _buffer_str(self)
paul@6 63
paul@6 64
# vim: tabstop=4 expandtab shiftwidth=4