ICU-62107.0.1.tar.gz

[apple/icu.git] / icuSources / io / unicode / ustream.h

diff --git a/icuSources/io/unicode/ustream.h b/icuSources/io/unicode/ustream.h
index e620da13b728ff578d2f13fdbe9d6f9dcb90f8d2..f185c453f8fa2cae8c1a9653b7adeddbc258c990 100644 (file)
--- a/icuSources/io/unicode/ustream.h
+++ b/icuSources/io/unicode/ustream.h
@@ -1,6 +1,8 @@
+// © 2016 and later: Unicode, Inc. and others.
+// License & terms of use: http://www.unicode.org/copyright.html
 /*
 **********************************************************************
-*   Copyright (C) 2001-2004, International Business Machines
+*   Copyright (C) 2001-2014 International Business Machines
 *   Corporation and others.  All Rights Reserved.
 **********************************************************************
 *  FILE NAME : ustream.h
@@ -11,36 +13,50 @@
 *   06/25/2001  grhoten     Move iostream from unistr.h
 ******************************************************************************
 */
-   
+
 #ifndef USTREAM_H
 #define USTREAM_H
 
 #include "unicode/unistr.h"
 
+#if !UCONFIG_NO_CONVERSION  // not available without conversion
 
 /**
- * Write the contents of a UnicodeString to an ostream. This functions writes
- * the characters in a UnicodeString to an ostream. The UChars in the
- * UnicodeString are truncated to char, leading to undefined results with
- * anything not in the Latin1 character set.
+ * \file
+ * \brief C++ API: Unicode iostream like API
+ *
+ * At this time, this API is very limited. It contains
+ * operator<< and operator>> for UnicodeString manipulation with the
+ * C++ I/O stream API.
  */
-#if U_IOSTREAM_SOURCE >= 199711
+
+#if defined(__GLIBCXX__)
+namespace std { class type_info; } // WORKAROUND: http://llvm.org/bugs/show_bug.cgi?id=13364
+#endif
+
 #include <iostream>
 
+#if U_SHOW_CPLUSPLUS_API
 U_NAMESPACE_BEGIN
+
+/**
+ * Write the contents of a UnicodeString to a C++ ostream. This functions writes
+ * the characters in a UnicodeString to an ostream. The UChars in the
+ * UnicodeString are converted to the char based ostream with the default
+ * converter.
+ * @stable 3.0
+ */
 U_IO_API std::ostream & U_EXPORT2 operator<<(std::ostream& stream, const UnicodeString& s);
 
+/**
+ * Write the contents from a C++ istream to a UnicodeString. The UChars in the
+ * UnicodeString are converted from the char based istream with the default
+ * converter.
+ * @stable 3.0
+ */
 U_IO_API std::istream & U_EXPORT2 operator>>(std::istream& stream, UnicodeString& s);
 U_NAMESPACE_END
-
-#elif U_IOSTREAM_SOURCE >= 198506
-#include <iostream.h>
-
-U_NAMESPACE_BEGIN
-U_IO_API ostream & U_EXPORT2 operator<<(ostream& stream, const UnicodeString& s);
-
-U_IO_API istream & U_EXPORT2 operator>>(istream& stream, UnicodeString& s);
-U_NAMESPACE_END
+#endif // U_SHOW_CPLUSPLUS_API
 
 #endif