icuSources/io/unicode/ustream.h

   1 // © 2016 and later: Unicode, Inc. and others.
   2 // License & terms of use: http://www.unicode.org/copyright.html
   3 /*
   4 **********************************************************************
   5 *   Copyright (C) 2001-2014 International Business Machines
   6 *   Corporation and others.  All Rights Reserved.
   7 **********************************************************************
   8 *  FILE NAME : ustream.h
   9 *
  10 *   Modification History:
  11 *
  12 *   Date        Name        Description
  13 *   06/25/2001  grhoten     Move iostream from unistr.h
  14 ******************************************************************************
  15 */
  16
  17 #ifndef USTREAM_H
  18 #define USTREAM_H
  19
  20 #include "unicode/unistr.h"
  21
  22 #if !UCONFIG_NO_CONVERSION  // not available without conversion
  23
  24 /**
  25  * \file
  26  * \brief C++ API: Unicode iostream like API
  27  *
  28  * At this time, this API is very limited. It contains
  29  * operator<< and operator>> for UnicodeString manipulation with the
  30  * C++ I/O stream API.
  31  */
  32
  33 #if defined(__GLIBCXX__)
  34 namespace std { class type_info; } // WORKAROUND: http://llvm.org/bugs/show_bug.cgi?id=13364
  35 #endif
  36
  37 #include <iostream>
  38
  39 #if U_SHOW_CPLUSPLUS_API
  40 U_NAMESPACE_BEGIN
  41
  42 /**
  43  * Write the contents of a UnicodeString to a C++ ostream. This functions writes
  44  * the characters in a UnicodeString to an ostream. The UChars in the
  45  * UnicodeString are converted to the char based ostream with the default
  46  * converter.
  47  * @stable 3.0
  48  */
  49 U_IO_API std::ostream & U_EXPORT2 operator<<(std::ostream& stream, const UnicodeString& s);
  50
  51 /**
  52  * Write the contents from a C++ istream to a UnicodeString. The UChars in the
  53  * UnicodeString are converted from the char based istream with the default
  54  * converter.
  55  * @stable 3.0
  56  */
  57 U_IO_API std::istream & U_EXPORT2 operator>>(std::istream& stream, UnicodeString& s);
  58 U_NAMESPACE_END
  59 #endif // U_SHOW_CPLUSPLUS_API
  60
  61 #endif
  62
  63 /* No operator for UChar because it can conflict with wchar_t  */
  64
  65 #endif