MPD: util/StringBuffer.hxx Source File

MPD 0.20.18

StringBuffer.hxx
Go to the documentation of this file.
1 /*
2 * Copyright (C) 2010-2017 Max Kellermann <max.kellermann@gmail.com>
3 *
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
6 * are met:
7 *
8 * - Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 *
11 * - Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the
14 * distribution.
15 *
16 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
17 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
18 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
19 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
20 * FOUNDATION OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
22 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
23 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
25 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
26 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
27 * OF THE POSSIBILITY OF SUCH DAMAGE.
28 */
29
30 #ifndef STRING_BUFFER_HPP
31 #define STRING_BUFFER_HPP
32
33 #include <array>
34
38 template<typename T, size_t CAPACITY>
39 class BasicStringBuffer {
40 public:
41 typedef T value_type;
42 typedef T &reference;
43 typedef T *pointer;
44 typedef const T *const_pointer;
45 typedef const_pointer const_iterator;
46 typedef size_t size_type;
47
48 static constexpr value_type SENTINEL = '\0';
49
50 protected:
51 std::array<value_type, CAPACITY> the_data;
52
53 public:
54 constexpr size_type capacity() const {
55 return CAPACITY;
56 }
57
58 constexpr bool empty() const {
59 return front() == SENTINEL;
60 }
61
62 void clear() {
63 the_data[0] = SENTINEL;
64 }
65
66 constexpr const_pointer c_str() const {
67 return &the_data.front();
68 }
69
70 pointer data() {
71 return &the_data.front();
72 }
73
74 constexpr value_type front() const {
75 return c_str()[0];
76 }
77
81 value_type operator[](size_type i) const {
82 return the_data[i];
83 }
84
88 reference operator[](size_type i) {
89 return the_data[i];
90 }
91
92 constexpr const_iterator begin() const {
93 return the_data;
94 }
95
96 constexpr const_iterator end() const {
97 return the_data + capacity();
98 }
99
100 constexpr operator const_pointer() const {
101 return c_str();
102 }
103 };
104
105 template<size_t CAPACITY>
106 class StringBuffer : public BasicStringBuffer<char, CAPACITY> {};
107
108 #endif
BasicStringBuffer::clear
void clear()
Definition: StringBuffer.hxx:62
BasicStringBuffer::front
constexpr value_type front() const
Definition: StringBuffer.hxx:74
BasicStringBuffer::SENTINEL
static constexpr value_type SENTINEL
Definition: StringBuffer.hxx:48
BasicStringBuffer::end
constexpr const_iterator end() const
Definition: StringBuffer.hxx:96
BasicStringBuffer::operator[]
value_type operator[](size_type i) const
Returns one character.
Definition: StringBuffer.hxx:81
BasicStringBuffer::operator[]
reference operator[](size_type i)
Returns one writable character.
Definition: StringBuffer.hxx:88
BasicStringBuffer::c_str
constexpr const_pointer c_str() const
Definition: StringBuffer.hxx:66
BasicStringBuffer::value_type
T value_type
Definition: StringBuffer.hxx:41
BasicStringBuffer::empty
constexpr bool empty() const
Definition: StringBuffer.hxx:58
BasicStringBuffer
A statically allocated string buffer.
Definition: StringBuffer.hxx:39
BasicStringBuffer::begin
constexpr const_iterator begin() const
Definition: StringBuffer.hxx:92
StringBuffer
Definition: AudioFormat.hxx:30
BasicStringBuffer::const_pointer
const T * const_pointer
Definition: StringBuffer.hxx:44
BasicStringBuffer::the_data
std::array< value_type, CAPACITY > the_data
Definition: StringBuffer.hxx:51
BasicStringBuffer::size_type
size_t size_type
Definition: StringBuffer.hxx:46
BasicStringBuffer::pointer
T * pointer
Definition: StringBuffer.hxx:43
BasicStringBuffer::data
pointer data()
Definition: StringBuffer.hxx:70
BasicStringBuffer::reference
T & reference
Definition: StringBuffer.hxx:42
BasicStringBuffer::capacity
constexpr size_type capacity() const
Definition: StringBuffer.hxx:54
BasicStringBuffer::const_iterator
const_pointer const_iterator
Definition: StringBuffer.hxx:45