ICU-59173.0.1.tar.gz

[apple/icu.git] / icuSources / common / cstr.h

diff --git a/icuSources/common/cstr.h b/icuSources/common/cstr.h
index 7c64aee89170ab8534acb7e0d0fa7566601a925c..c33f487ea121cd18ce472d328f6be4ef4e3be75d 100644 (file)
--- a/icuSources/common/cstr.h
+++ b/icuSources/common/cstr.h
@@ -1,7 +1,9 @@
+// © 2016 and later: Unicode, Inc. and others.
+// License & terms of use: http://www.unicode.org/copyright.html

 /*
 ******************************************************************************
 *
 /*
 ******************************************************************************
 *

-*   Copyright (C) 2015, International Business Machines
+*   Copyright (C) 2016, International Business Machines

 *   Corporation and others.  All Rights Reserved.
 *
 ******************************************************************************
 *   Corporation and others.  All Rights Reserved.
 *
 ******************************************************************************


@@ -19,13 +21,16 @@
 #include "charstr.h"
 
 /**
 #include "charstr.h"
 
 /**

- * ICU-internal class CStr, a small helper class to facilitate passing UnicodStrings
+ * ICU-internal class CStr, a small helper class to facilitate passing UnicodeStrings

  * to functions needing (const char *) strings, such as printf().
  *
  * It is intended primarily for use in debugging or in tests. Uses platform 
  * default code page conversion, which will do the best job possible,
  * but may be lossy, depending on the platform.
  *
  * to functions needing (const char *) strings, such as printf().
  *
  * It is intended primarily for use in debugging or in tests. Uses platform 
  * default code page conversion, which will do the best job possible,
  * but may be lossy, depending on the platform.
  *

+ * If no other conversion is available, use invariant conversion and substitue
+ * '?' for non-invariant characters.
+ *

  * Example Usage:
  *   UnicodeString s = whatever;
  *   printf("%s", CStr(s)());
  * Example Usage:
  *   UnicodeString s = whatever;
  *   printf("%s", CStr(s)());