1  // <string> Forward declarations -*- C++ -*-
       2  
       3  // Copyright (C) 2001-2023 Free Software Foundation, Inc.
       4  //
       5  // This file is part of the GNU ISO C++ Library.  This library is free
       6  // software; you can redistribute it and/or modify it under the
       7  // terms of the GNU General Public License as published by the
       8  // Free Software Foundation; either version 3, or (at your option)
       9  // any later version.
      10  
      11  // This library is distributed in the hope that it will be useful,
      12  // but WITHOUT ANY WARRANTY; without even the implied warranty of
      13  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      14  // GNU General Public License for more details.
      15  
      16  // Under Section 7 of GPL version 3, you are granted additional
      17  // permissions described in the GCC Runtime Library Exception, version
      18  // 3.1, as published by the Free Software Foundation.
      19  
      20  // You should have received a copy of the GNU General Public License and
      21  // a copy of the GCC Runtime Library Exception along with this program;
      22  // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
      23  // <http://www.gnu.org/licenses/>.
      24  
      25  /** @file bits/stringfwd.h
      26   *  This is an internal header file, included by other library headers.
      27   *  Do not attempt to use it directly. @headername{string}
      28   */
      29  
      30  //
      31  // ISO C++ 14882: 21 Strings library
      32  //
      33  
      34  #ifndef _STRINGFWD_H
      35  #define _STRINGFWD_H 1
      36  
      37  #pragma GCC system_header
      38  
      39  #include <bits/c++config.h>
      40  #include <bits/memoryfwd.h>
      41  
      42  namespace std _GLIBCXX_VISIBILITY(default)
      43  {
      44  _GLIBCXX_BEGIN_NAMESPACE_VERSION
      45  
      46    /**
      47     *  @defgroup strings Strings
      48     *
      49     *  @{
      50    */
      51  
      52    template<class _CharT>
      53      struct char_traits;
      54  
      55    template<> struct char_traits<char>;
      56  
      57    template<> struct char_traits<wchar_t>;
      58  
      59  #ifdef _GLIBCXX_USE_CHAR8_T
      60    template<> struct char_traits<char8_t>;
      61  #endif
      62  
      63  #if __cplusplus >= 201103L
      64    template<> struct char_traits<char16_t>;
      65    template<> struct char_traits<char32_t>;
      66  #endif
      67  
      68  _GLIBCXX_BEGIN_NAMESPACE_CXX11
      69  
      70    template<typename _CharT, typename _Traits = char_traits<_CharT>,
      71             typename _Alloc = allocator<_CharT> >
      72      class basic_string;
      73  
      74  _GLIBCXX_END_NAMESPACE_CXX11
      75  
      76    /// A string of @c char
      77    typedef basic_string<char>    string;   
      78  
      79    /// A string of @c wchar_t
      80    typedef basic_string<wchar_t> wstring;   
      81  
      82  #ifdef _GLIBCXX_USE_CHAR8_T
      83    /// A string of @c char8_t
      84    typedef basic_string<char8_t> u8string;
      85  #endif
      86  
      87  #if __cplusplus >= 201103L
      88    /// A string of @c char16_t
      89    typedef basic_string<char16_t> u16string; 
      90  
      91    /// A string of @c char32_t
      92    typedef basic_string<char32_t> u32string; 
      93  #endif
      94  
      95    /** @}  */
      96  
      97  _GLIBCXX_END_NAMESPACE_VERSION
      98  } // namespace std
      99  
     100  #endif	// _STRINGFWD_H