binutils-gdb/gdbsupport/reference-to-pointer-iterator.h
Andrew Burgess 1d506c26d9 Update copyright year range in header of all files managed by GDB
This commit is the result of the following actions:

  - Running gdb/copyright.py to update all of the copyright headers to
    include 2024,

  - Manually updating a few files the copyright.py script told me to
    update, these files had copyright headers embedded within the
    file,

  - Regenerating gdbsupport/Makefile.in to refresh it's copyright
    date,

  - Using grep to find other files that still mentioned 2023.  If
    these files were updated last year from 2022 to 2023 then I've
    updated them this year to 2024.

I'm sure I've probably missed some dates.  Feel free to fix them up as
you spot them.
2024-01-12 15:49:57 +00:00

101 lines
3.1 KiB
C++

/* An iterator wrapper that yields pointers instead of references.
Copyright (C) 2021-2024 Free Software Foundation, Inc.
This file is part of GDB.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>. */
#ifndef GDBSUPPORT_REFERENCE_TO_POINTER_ITERATOR_H
#define GDBSUPPORT_REFERENCE_TO_POINTER_ITERATOR_H
/* Wrap an iterator that yields references to objects so that it yields
pointers to objects instead.
This is useful for example to bridge the gap between iterators on intrusive
lists, which yield references, and the rest of GDB, which for legacy reasons
expects to iterate on pointers. */
template <typename IteratorType>
struct reference_to_pointer_iterator
{
using self_type = reference_to_pointer_iterator;
using value_type = typename IteratorType::value_type *;
using reference = typename IteratorType::value_type *&;
using pointer = typename IteratorType::value_type **;
using iterator_category = typename IteratorType::iterator_category;
using difference_type = typename IteratorType::difference_type;
/* Construct a reference_to_pointer_iterator, passing args to the underlying
iterator. */
template <typename... Args>
reference_to_pointer_iterator (Args &&...args)
: m_it (std::forward<Args> (args)...)
{}
/* Create a past-the-end iterator.
Assumes that default-constructing an underlying iterator creates a
past-the-end iterator. */
reference_to_pointer_iterator ()
{}
/* Need these as the variadic constructor would be a better match
otherwise. */
reference_to_pointer_iterator (reference_to_pointer_iterator &) = default;
reference_to_pointer_iterator (const reference_to_pointer_iterator &) = default;
reference_to_pointer_iterator (reference_to_pointer_iterator &&) = default;
reference_to_pointer_iterator &operator= (const reference_to_pointer_iterator &) = default;
reference_to_pointer_iterator &operator= (reference_to_pointer_iterator &&) = default;
value_type operator* () const
{ return &*m_it; }
self_type &operator++ ()
{
++m_it;
return *this;
}
self_type &operator++ (int)
{
m_it++;
return *this;
}
self_type &operator-- ()
{
--m_it;
return *this;
}
self_type &operator-- (int)
{
m_it--;
return *this;
}
bool operator== (const self_type &other) const
{ return m_it == other.m_it; }
bool operator!= (const self_type &other) const
{ return m_it != other.m_it; }
private:
/* The underlying iterator. */
IteratorType m_it;
};
#endif /* GDBSUPPORT_REFERENCE_TO_POINTER_ITERATOR_H */