1  /* Shared escaped string class.
       2     Copyright (C) 1999-2023 Free Software Foundation, Inc.
       3  
       4  This file is part of GCC.
       5  
       6  GCC is free software; you can redistribute it and/or modify it under
       7  the terms of the GNU General Public License as published by the Free
       8  Software Foundation; either version 3, or (at your option) any later
       9  version.
      10  
      11  GCC is distributed in the hope that it will be useful, but WITHOUT ANY
      12  WARRANTY; without even the implied warranty of MERCHANTABILITY or
      13  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
      14  for more details.
      15  
      16  You should have received a copy of the GNU General Public License
      17  along with GCC; see the file COPYING3.  If not see
      18  <http://www.gnu.org/licenses/>.  */
      19  
      20  #ifndef GCC_ESCAPED_STRING_H
      21  #define GCC_ESCAPED_STRING_H
      22  
      23  #include <cstdlib>
      24  
      25  /* A class to handle converting a string that might contain
      26     control characters, (eg newline, form-feed, etc), into one
      27     in which contains escape sequences instead.  */
      28  
      29  class escaped_string
      30  {
      31   public:
      32    escaped_string () { m_owned = false; m_str = NULL; };
      33    ~escaped_string () { if (m_owned) free (m_str); }
      34    operator const char *() const { return m_str; }
      35    void escape (const char *);
      36   private:
      37    escaped_string(const escaped_string&) {}
      38    escaped_string& operator=(const escaped_string&) { return *this; }
      39    char *m_str;
      40    bool  m_owned;
      41  };
      42  
      43  #endif /* ! GCC_ESCAPED_STRING_H */