StormByte-Database 3.0.0
C++26 database module of the StormByte suite
Loading...
Searching...
No Matches
rows.hxx
Go to the documentation of this file.
1/*
2 * Copyright (C) 2024-2026 David C. Manuelda (StormBytePP)
3 *
4 * This file is part of StormByte-Database.
5 *
6 * StormByte-Database original source is dual-licensed:
7 *
8 * 1. GNU Lesser General Public License v3.0 (or later)
9 * You may redistribute and/or modify this file under the terms of the
10 * GNU Lesser General Public License as published by the Free Software
11 * Foundation, either version 3 of the License, or (at your option)
12 * any later version.
13 *
14 * 2. Commercial license
15 * Alternatively, this file may be used under the terms of a commercial
16 * license agreement with the copyright holder
17 * (David C. Manuelda <StormByte@gmail.com>).
18 *
19 * Both licenses apply only to original StormByte-Database source in this
20 * repository. They do not cover other StormByte modules or any third-party
21 * material shipped with this repository (including everything under
22 * thirdparty/, and in particular the bundled StormByte-Logger tree and
23 * the PostgreSQL, MariaDB and SQLite trees), which remain under their own
24 * licenses.
25 *
26 * Neither license grants any patent rights. Any patent licenses required
27 * to use this software or third-party components must be obtained separately
28 * from the patent holders.
29 *
30 * StormByte-Database is distributed in the hope that it will be useful,
31 * but WITHOUT ANY WARRANTY; without even the implied warranty of
32 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
33 * GNU Lesser General Public License for more details.
34 *
35 * You should have received a copy of the GNU Lesser General Public License
36 * version 3 along with StormByte-Database. If not, see
37 * <https://www.gnu.org/licenses/lgpl-3.0.html>.
38 *
39 * SPDX-License-Identifier: LGPL-3.0-or-later OR LicenseRef-StormByte-Commercial
40 */
41
42#pragma once
43
45#include <StormByte/safe/vector.hxx>
46#include <StormByte/size.hxx>
47
48#include <iterator>
49
54namespace StormByte {
59 namespace Database {
65 public:
66 using value_type = Row;
68 using reference = Row&;
69 using const_reference = const Row&;
70 using pointer = Row*;
71 using const_pointer = const Row*;
72 using iterator = pointer;
76
80 Rows() noexcept;
81
85 Rows(const Rows &other);
86
90 Rows(Rows &&other) noexcept;
91
95 ~Rows() noexcept;
96
100 Rows &operator=(const Rows &other);
101
105 Rows &operator=(Rows &&other) noexcept;
106
112 bool operator==(const Rows &other) const;
113
119 bool operator!=(const Rows &other) const;
120
125 iterator begin() noexcept;
126
131 const_iterator begin() const noexcept;
132
137 iterator end() noexcept;
138
143 const_iterator end() const noexcept;
144
149 const_iterator cbegin() const noexcept;
150
155 const_iterator cend() const noexcept;
156
162
168
174
179 const_reverse_iterator rend() const noexcept;
180
186
192
197 StormByte::Size size() const noexcept;
198
203 bool empty() const noexcept;
204
211 Row &operator[](StormByte::Size index);
212
219 const Row &operator[](StormByte::Size index) const;
220
225 void add(const Row &row);
226
231 void add(Row &&row);
232
238 bool has_item(const Row &row) const;
239
244 StormByte::Size Count() const noexcept;
245
246 private:
247 StormByte::Safe::Vector<Row> m_results;
248 };
249 }
250}
251
Abstract backend.
Definition database.hxx:73
One result row: ordered NamedValues with lookup by column name.
Definition row.hxx:69
bool has_item(const Row &row) const
Search for an equal row.
Rows() noexcept
Default constructor.
pointer iterator
Mutable pointer iterator.
Definition rows.hxx:72
void add(const Row &row)
Append a copy of a row.
Row value_type
Row value type.
Definition rows.hxx:66
reverse_iterator rbegin() noexcept
Mutable reverse begin.
StormByte::Size Count() const noexcept
Number of rows.
const_pointer const_iterator
Read-only pointer iterator.
Definition rows.hxx:73
const_reverse_iterator crend() const noexcept
Read-only reverse end.
StormByte::Safe::Vector< Row >::const_reverse_iterator const_reverse_iterator
Read-only reverse iterator.
Definition rows.hxx:75
const_iterator cend() const noexcept
Read-only end pointer.
iterator end() noexcept
Mutable end pointer.
reverse_iterator rend() noexcept
Mutable reverse end.
iterator begin() noexcept
Mutable begin pointer.
const Row & const_reference
Read-only row reference.
Definition rows.hxx:69
const_iterator cbegin() const noexcept
Read-only begin pointer.
StormByte::Safe::Vector< Row >::reverse_iterator reverse_iterator
Mutable reverse iterator.
Definition rows.hxx:74
Row * pointer
Mutable row pointer.
Definition rows.hxx:70
StormByte::Size size_type
Row count and index type.
Definition rows.hxx:67
Row & reference
Mutable row reference.
Definition rows.hxx:68
bool empty() const noexcept
Whether the collection has no rows.
const Row * const_pointer
Read-only row pointer.
Definition rows.hxx:71
const_reverse_iterator crbegin() const noexcept
Read-only reverse begin.
StormByte::Size size() const noexcept
Row count.
std::reverse_iterator< const_iterator > const_reverse_iterator
std::reverse_iterator< iterator > reverse_iterator
STORMBYTE_DECLARE_MAYBE_SAFE(StormByte::Logger::Exception)
Database module of the StormByte suite.
Root namespace of the StormByte C++ suite.
#define STORMBYTE_DATABASE_PUBLIC
Definition visibility.h:54