123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204 |
- /* RAII wrapper for buildargv
- Copyright (C) 2021 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_BUILDARGV_H
- #define GDBSUPPORT_BUILDARGV_H
- #include "libiberty.h"
- /* A wrapper for an array of char* that was allocated in the way that
- 'buildargv' does, and should be freed with 'freeargv'. */
- class gdb_argv
- {
- public:
- /* A constructor that initializes to NULL. */
- gdb_argv ()
- : m_argv (NULL)
- {
- }
- /* A constructor that calls buildargv on STR. STR may be NULL, in
- which case this object is initialized with a NULL array. */
- explicit gdb_argv (const char *str)
- : m_argv (NULL)
- {
- reset (str);
- }
- /* A constructor that takes ownership of an existing array. */
- explicit gdb_argv (char **array)
- : m_argv (array)
- {
- }
- gdb_argv (const gdb_argv &) = delete;
- gdb_argv &operator= (const gdb_argv &) = delete;
- gdb_argv &operator= (gdb_argv &&other)
- {
- freeargv (m_argv);
- m_argv = other.m_argv;
- other.m_argv = nullptr;
- return *this;
- }
- gdb_argv (gdb_argv &&other)
- {
- m_argv = other.m_argv;
- other.m_argv = nullptr;
- }
- ~gdb_argv ()
- {
- freeargv (m_argv);
- }
- /* Call buildargv on STR, storing the result in this object. Any
- previous state is freed. STR may be NULL, in which case this
- object is reset with a NULL array. If buildargv fails due to
- out-of-memory, call malloc_failure. Therefore, the value is
- guaranteed to be non-NULL, unless the parameter itself is
- NULL. */
- void reset (const char *str)
- {
- char **argv = buildargv (str);
- freeargv (m_argv);
- m_argv = argv;
- }
- /* Return the underlying array. */
- char **get ()
- {
- return m_argv;
- }
- const char * const * get () const
- {
- return m_argv;
- }
- /* Return the underlying array, transferring ownership to the
- caller. */
- ATTRIBUTE_UNUSED_RESULT char **release ()
- {
- char **result = m_argv;
- m_argv = NULL;
- return result;
- }
- /* Return the number of items in the array. */
- int count () const
- {
- return countargv (m_argv);
- }
- /* Index into the array. */
- char *operator[] (int arg)
- {
- gdb_assert (m_argv != NULL);
- return m_argv[arg];
- }
- /* Return the arguments array as an array view. */
- gdb::array_view<char *> as_array_view ()
- {
- return gdb::array_view<char *> (this->get (), this->count ());
- }
- gdb::array_view<const char * const> as_array_view () const
- {
- return gdb::array_view<const char * const> (this->get (), this->count ());
- }
- /* Append arguments to this array. */
- void append (gdb_argv &&other)
- {
- int size = count ();
- int argc = other.count ();
- m_argv = XRESIZEVEC (char *, m_argv, (size + argc + 1));
- for (int argi = 0; argi < argc; argi++)
- {
- /* Transfer ownership of the string. */
- m_argv[size++] = other.m_argv[argi];
- /* Ensure that destruction of OTHER works correctly. */
- other.m_argv[argi] = nullptr;
- }
- m_argv[size] = nullptr;
- }
- /* Append arguments to this array. */
- void append (const gdb_argv &other)
- {
- int size = count ();
- int argc = other.count ();
- m_argv = XRESIZEVEC (char *, m_argv, (size + argc + 1));
- for (int argi = 0; argi < argc; argi++)
- m_argv[size++] = xstrdup (other.m_argv[argi]);
- m_argv[size] = nullptr;
- }
- /* The iterator type. */
- typedef char **iterator;
- /* Return an iterator pointing to the start of the array. */
- iterator begin ()
- {
- return m_argv;
- }
- /* Return an iterator pointing to the end of the array. */
- iterator end ()
- {
- return m_argv + count ();
- }
- bool operator!= (std::nullptr_t)
- {
- return m_argv != NULL;
- }
- bool operator== (std::nullptr_t)
- {
- return m_argv == NULL;
- }
- private:
- /* The wrapped array. */
- char **m_argv;
- };
- #endif /* GDBSUPPORT_BUILDARGV_H */
|