ICU-62141.0.1.tar.gz

[apple/icu.git] / icuSources / common / unicode / utext.h

diff --git a/icuSources/common/unicode/utext.h b/icuSources/common/unicode/utext.h
index e5f0c8cfce18421f76ae381f505983f9400b53bd..817306062e367199f9c05aa8646954188ef197b9 100644 (file)
--- a/icuSources/common/unicode/utext.h
+++ b/icuSources/common/unicode/utext.h
@@ -1,3 +1,5 @@
+// © 2016 and later: Unicode, Inc. and others.
+// License & terms of use: http://www.unicode.org/copyright.html

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


@@ -6,7 +8,7 @@
 *
 *******************************************************************************
 *   file name:  utext.h
 *
 *******************************************************************************
 *   file name:  utext.h

-*   encoding:   US-ASCII
+*   encoding:   UTF-8

 *   tab size:   8 (not used)
 *   indentation:4
 *
 *   tab size:   8 (not used)
 *   indentation:4
 *


@@ -142,7 +144,7 @@
 #include "unicode/rep.h"
 #include "unicode/unistr.h"
 #include "unicode/chariter.h"
 #include "unicode/rep.h"
 #include "unicode/unistr.h"
 #include "unicode/chariter.h"

-#endif
+#endif // U_SHOW_CPLUSPLUS_API

 
 
 U_CDECL_BEGIN
 
 
 U_CDECL_BEGIN


@@ -198,7 +200,7 @@ U_DEFINE_LOCAL_OPEN_POINTER(LocalUTextPointer, UText, utext_close);
 
 U_NAMESPACE_END
 
 
 U_NAMESPACE_END
 

-#endif
+#endif // U_SHOW_CPLUSPLUS_API

 
 /**
  * Open a read-only UText implementation for UTF-8 strings.
 
 /**
  * Open a read-only UText implementation for UTF-8 strings.


@@ -304,9 +306,9 @@ utext_openReplaceable(UText *ut, icu::Replaceable *rep, UErrorCode *status);
  * @stable ICU 3.4
  */
 U_STABLE UText * U_EXPORT2
  * @stable ICU 3.4
  */
 U_STABLE UText * U_EXPORT2

-utext_openCharacterIterator(UText *ut, icu::CharacterIterator *ic, UErrorCode *status);
+utext_openCharacterIterator(UText *ut, icu::CharacterIterator *ci, UErrorCode *status);

 
 

-#endif
+#endif // U_SHOW_CPLUSPLUS_API

 
 
 /**
 
 
 /**


@@ -387,7 +389,7 @@ utext_equals(const UText *a, const UText *b);
 
 /*****************************************************************************
  *
 
 /*****************************************************************************
  *

- *   Functions to work with the text represeted by a UText wrapper
+ *   Functions to work with the text represented by a UText wrapper

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


@@ -431,7 +433,7 @@ utext_isLengthExpensive(const UText *ut);
  *
  * The iteration position will be set to the start of the returned code point.
  *
  *
  * The iteration position will be set to the start of the returned code point.
  *

- * This function is roughly equivalent to the the sequence
+ * This function is roughly equivalent to the sequence

  *    utext_setNativeIndex(index);
  *    utext_current32();
  * (There is a subtle difference if the index is out of bounds by being less than zero - 
  *    utext_setNativeIndex(index);
  *    utext_current32();
  * (There is a subtle difference if the index is out of bounds by being less than zero - 


@@ -590,7 +592,7 @@ U_STABLE void U_EXPORT2
 utext_setNativeIndex(UText *ut, int64_t nativeIndex);
 
 /**
 utext_setNativeIndex(UText *ut, int64_t nativeIndex);
 
 /**

- * Move the iterator postion by delta code points.  The number of code points
+ * Move the iterator position by delta code points.  The number of code points

  * is a signed number; a negative delta will move the iterator backwards,
  * towards the start of the text.
  * <p>
  * is a signed number; a negative delta will move the iterator backwards,
  * towards the start of the text.
  * <p>


@@ -609,7 +611,7 @@ U_STABLE UBool U_EXPORT2
 utext_moveIndex32(UText *ut, int32_t delta);
 
 /**
 utext_moveIndex32(UText *ut, int32_t delta);
 
 /**

- * Get the native index of the character preceeding the current position.
+ * Get the native index of the character preceding the current position.

  * If the iteration position is already at the start of the text, zero
  * is returned.
  * The value returned is the same as that obtained from the following sequence,
  * If the iteration position is already at the start of the text, zero
  * is returned.
  * The value returned is the same as that obtained from the following sequence,


@@ -626,7 +628,7 @@ utext_moveIndex32(UText *ut, int32_t delta);
  *   native index of the character most recently returned from utext_next().
  *
  * @param ut the text to be accessed
  *   native index of the character most recently returned from utext_next().
  *
  * @param ut the text to be accessed

- * @return the native index of the character preceeding the current index position,
+ * @return the native index of the character preceding the current index position,

  *         or zero if the current position is at the start of the text.
  * @stable ICU 3.6
  */
  *         or zero if the current position is at the start of the text.
  * @stable ICU 3.6
  */


@@ -653,10 +655,10 @@ utext_getPreviousNativeIndex(UText *ut);
  * @param  ut    the UText from which to extract data.
  * @param  nativeStart the native index of the first character to extract.\
  *               If the specified index is out of range,
  * @param  ut    the UText from which to extract data.
  * @param  nativeStart the native index of the first character to extract.\
  *               If the specified index is out of range,

- *               it will be pinned to to be within 0 <= index <= textLength
+ *               it will be pinned to be within 0 <= index <= textLength

  * @param  nativeLimit the native string index of the position following the last
  *               character to extract.  If the specified index is out of range,
  * @param  nativeLimit the native string index of the position following the last
  *               character to extract.  If the specified index is out of range,

- *               it will be pinned to to be within 0 <= index <= textLength.
+ *               it will be pinned to be within 0 <= index <= textLength.

  *               nativeLimit must be >= nativeStart.
  * @param  dest  the UChar (UTF-16) buffer into which the extracted text is placed
  * @param  destCapacity  The size, in UChars, of the destination buffer.  May be zero
  *               nativeLimit must be >= nativeStart.
  * @param  dest  the UChar (UTF-16) buffer into which the extracted text is placed
  * @param  destCapacity  The size, in UChars, of the destination buffer.  May be zero


@@ -766,7 +768,7 @@ utext_extract(UText *ut,
   */
 #define UTEXT_SETNATIVEINDEX(ut, ix)                       \
     { int64_t __offset = (ix) - (ut)->chunkNativeStart; \
   */
 #define UTEXT_SETNATIVEINDEX(ut, ix)                       \
     { int64_t __offset = (ix) - (ut)->chunkNativeStart; \

-      if (__offset>=0 && __offset<=(int64_t)(ut)->nativeIndexingLimit) { \
+      if (__offset>=0 && __offset<(int64_t)(ut)->nativeIndexingLimit && (ut)->chunkContents[__offset]<0xdc00) { \

           (ut)->chunkOffset=(int32_t)__offset; \
       } else { \
           utext_setNativeIndex((ut), (ix)); } }
           (ut)->chunkOffset=(int32_t)__offset; \
       } else { \
           utext_setNativeIndex((ut), (ix)); } }


@@ -904,7 +906,7 @@ utext_copy(UText *ut,
   *  Caution:  freezing a UText will disable changes made via the specific
   *   frozen UText wrapper only; it will not have any effect on the ability to
   *   directly modify the text by bypassing the UText.  Any such backdoor modifications
   *  Caution:  freezing a UText will disable changes made via the specific
   *   frozen UText wrapper only; it will not have any effect on the ability to
   *   directly modify the text by bypassing the UText.  Any such backdoor modifications

-  *   are always an error while UText access is occuring because the underlying
+  *   are always an error while UText access is occurring because the underlying

   *   text can get out of sync with UText's buffering.
   *  </p>
   *
   *   text can get out of sync with UText's buffering.
   *  </p>
   *


@@ -1052,7 +1054,7 @@ UTextAccess(UText *ut, int64_t nativeIndex, UBool forward);
  * be NUL-terminated if there is sufficient space in the destination buffer.
  *
  * @param  ut            the UText from which to extract data.
  * be NUL-terminated if there is sufficient space in the destination buffer.
  *
  * @param  ut            the UText from which to extract data.

- * @param  nativeStart   the native index of the first characer to extract.
+ * @param  nativeStart   the native index of the first character to extract.

  * @param  nativeLimit   the native string index of the position following the last
  *                       character to extract.
  * @param  dest          the UChar (UTF-16) buffer into which the extracted text is placed
  * @param  nativeLimit   the native string index of the position following the last
  *                       character to extract.
  * @param  dest          the UChar (UTF-16) buffer into which the extracted text is placed


@@ -1209,7 +1211,7 @@ UTextClose(UText *ut);
 struct UTextFuncs {
     /**
      *   (public)  Function table size, sizeof(UTextFuncs)
 struct UTextFuncs {
     /**
      *   (public)  Function table size, sizeof(UTextFuncs)

-     *             Intended for use should the table grow to accomodate added
+     *             Intended for use should the table grow to accommodate added

      *             functions in the future, to allow tests for older format
      *             function tables that do not contain the extensions.
      *
      *             functions in the future, to allow tests for older format
      *             function tables that do not contain the extensions.
      *


@@ -1343,7 +1345,7 @@ typedef struct UTextFuncs UTextFuncs;
 struct UText {
     /**
      *     (private)  Magic.  Used to help detect when UText functions are handed
 struct UText {
     /**
      *     (private)  Magic.  Used to help detect when UText functions are handed

-     *                        invalid or unitialized UText structs.
+     *                        invalid or uninitialized UText structs.

      *                        utext_openXYZ() functions take an initialized,
      *                        but not necessarily open, UText struct as an
      *                        optional fill-in parameter.  This magic field
      *                        utext_openXYZ() functions take an initialized,
      *                        but not necessarily open, UText struct as an
      *                        optional fill-in parameter.  This magic field


@@ -1365,7 +1367,7 @@ struct UText {
 
 
     /**
 
 
     /**

-      *  Text provider properties.  This set of flags is maintainted by the
+      *  Text provider properties.  This set of flags is maintained by the

       *                             text provider implementation.
       *  @stable ICU 3.4
       */
       *                             text provider implementation.
       *  @stable ICU 3.4
       */


@@ -1450,7 +1452,7 @@ struct UText {
     void          *pExtra;
 
     /**
     void          *pExtra;
 
     /**

-     * (protected) Pointer to string or text-containin object or similar.
+     * (protected) Pointer to string or text-containing object or similar.

      * This is the source of the text that this UText is wrapping, in a format
      *  that is known to the text provider functions.
      * @stable ICU 3.4
      * This is the source of the text that this UText is wrapping, in a format
      *  that is known to the text provider functions.
      * @stable ICU 3.4