Aleph-w 3.0
A C++ Library for Data Structures and Algorithms
Loading...
Searching...
No Matches
ah_stdc++_utils.H
Go to the documentation of this file.
1
2/*
3 Aleph_w
4
5 Data structures & Algorithms
6 version 2.0.0b
7 https://github.com/lrleon/Aleph-w
8
9 This file is part of Aleph-w library
10
11 Copyright (c) 2002-2026 Leandro Rabindranath Leon
12
13 Permission is hereby granted, free of charge, to any person obtaining a copy
14 of this software and associated documentation files (the "Software"), to deal
15 in the Software without restriction, including without limitation the rights
16 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
17 copies of the Software, and to permit persons to whom the Software is
18 furnished to do so, subject to the following conditions:
19
20 The above copyright notice and this permission notice shall be included in all
21 copies or substantial portions of the Software.
22
23 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
24 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
25 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
26 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
27 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
28 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
29 SOFTWARE.
30*/
31
32
71# ifndef AH_STDC_UTILS_H
72# define AH_STDC_UTILS_H
73
74# include <exception>
75# include <stdexcept>
76# include <ah-errors.H>
77
78namespace Aleph
79{
80
104template <typename Container, typename Iterator>
105inline void verify_container_and_iterator(const Container& container,
106 const Iterator& itor)
107{
108 ah_domain_error_if(not itor.verify(container))
109 << "Iterator does not belong to the specified container";
110}
111
136template <typename Iterator>
137inline void verify_iterators(const Iterator& itor1, const Iterator& itor2)
138{
140 << "Iterators do not belong to the same container";
141}
142
162template <typename Container, typename Iterator>
163inline void verify_container_and_iterators(const Container& container,
164 const Iterator& itor_container,
165 const Iterator& itor1,
166 const Iterator& itor2)
167{
170
171 // Ensure destination iterator is from a different container than source range
173 << "Destination and source iterators reference the same container";
174}
175
197template <typename Container, typename Iterator>
198inline void verify_container_and_iterators(const Container& container,
199 const Iterator& itor1,
200 const Iterator& itor2)
201{
204}
205
206} // namespace Aleph
207
208# endif // AH_STDC_UTILS_H
Exception handling system with formatted messages for Aleph-w.
#define ah_domain_error_if(C)
Throws std::domain_error if condition holds.
Definition ah-errors.H:522
Main namespace for Aleph-w library functions.
Definition ah-arena.H:89
void verify_container_and_iterators(const Container &container, const Iterator &itor_container, const Iterator &itor1, const Iterator &itor2)
Verifies container-iterator relationships with distinctness check.
void verify_iterators(const Iterator &itor1, const Iterator &itor2)
Verifies that two iterators belong to the same container.
void verify_container_and_iterator(const Container &container, const Iterator &itor)
Verifies that an iterator belongs to a specific container.
DynList< T > maps(const C &c, Op op)
Classic map operation.