Update ICU to 54.1 step 1

source/i18n/unicode/uspoof.h

 /*
 ***************************************************************************
-* Copyright (C) 2008-2013, International Business Machines Corporation
+* Copyright (C) 2008-2014, International Business Machines Corporation
 * and others. All Rights Reserved.
 ***************************************************************************
 *   file name:  uspoof.h
 *   encoding:   US-ASCII
 *   tab size:   8 (not used)
 *   indentation:4
 *
 *   created on: 2008Feb13
 *   created by: Andy Heninger
 *
@@ skipping 205 matching lines @@
       * for conformance to any particular syntax for identifiers.
       */
     USPOOF_INVISIBLE                =  32,
 
     /** Check that an identifier contains only characters from a specified set
       * of acceptable characters.  See uspoof_setAllowedChars() and
       * uspoof_setAllowedLocales().
       */
     USPOOF_CHAR_LIMIT               =  64,
 
-#ifndef U_HIDE_DRAFT_API
    /**
      * Check that an identifier does not include decimal digits from
      * more than one numbering system.
      * 
-     * @draft ICU 51
+     * @stable ICU 51
      */
     USPOOF_MIXED_NUMBERS            = 128,
-#endif /* U_HIDE_DRAFT_API */
 
    /**
      * Enable all spoof checks.
      * 
      * @stable ICU 4.6
      */
     USPOOF_ALL_CHECKS               = 0xFFFF,
 
-#ifndef U_HIDE_DRAFT_API
     /**
       * Enable the return of auxillary (non-error) information in the
       * upper bits of the check results value. 
       *
       * If this "check" is not enabled, the results of uspoof_check() will be zero when an
       * identifier passes all of the enabled checks.
       *
       * If this "check" is enabled, (uspoof_check() & USPOOF_ALL_CHECKS) will be zero
       * when an identifier passes all checks.
       *
-      * @draft ICU 51
+      * @stable ICU 51
       */
     USPOOF_AUX_INFO                  = 0x40000000
-#endif /* U_HIDE_DRAFT_API */
 
     } USpoofChecks;
     
     
-#ifndef U_HIDE_DRAFT_API
     /**
      * Constants from UAX #39 for use in setRestrictionLevel(), and
      * for returned identifier restriction levels in check results.
-     * @draft ICU 51
+     * @stable ICU 51
      */
     typedef enum URestrictionLevel {
         /**
          * Only ASCII characters: U+0000..U+007F
          * 
-         * @draft ICU 51
+         * @stable ICU 51
          */
         USPOOF_ASCII = 0x10000000,
+#ifndef U_HIDE_DRAFT_API
+        /**
+          * All characters in each identifier must be from a single script.
+          *
+          * @draft ICU 53
+          */
+        USPOOF_SINGLE_SCRIPT_RESTRICTIVE = 0x20000000,
+#endif /* U_HIDE_DRAFT_API */
         /**
          * All characters in each identifier must be from a single script, or from the combinations: Latin + Han +
          * Hiragana + Katakana; Latin + Han + Bopomofo; or Latin + Han + Hangul. Note that this level will satisfy the
          * vast majority of Latin-script users; also that TR36 has ASCII instead of Latin.
          * 
-         * @draft ICU 51
+         * @stable ICU 51
          */
-        USPOOF_HIGHLY_RESTRICTIVE = 0x20000000,
+        USPOOF_HIGHLY_RESTRICTIVE = 0x30000000,
         /**
          * Allow Latin with other scripts except Cyrillic, Greek, Cherokee Otherwise, the same as Highly Restrictive
          * 
-         * @draft ICU 51
+         * @stable ICU 51
          */
-        USPOOF_MODERATELY_RESTRICTIVE = 0x30000000,
+        USPOOF_MODERATELY_RESTRICTIVE = 0x40000000,
         /**
          * Allow arbitrary mixtures of scripts. Otherwise, the same as Moderately Restrictive.
          * 
-         * @draft ICU 51
+         * @stable ICU 51
          */
-        USPOOF_MINIMALLY_RESTRICTIVE = 0x40000000,
+        USPOOF_MINIMALLY_RESTRICTIVE = 0x50000000,
         /**
          * Any valid identifiers, including characters outside of the Identifier Profile.
          * 
-         * @draft ICU 51
+         * @stable ICU 51
          */
-        USPOOF_UNRESTRICTIVE = 0x50000000
+        USPOOF_UNRESTRICTIVE = 0x60000000,
+#ifndef U_HIDE_DRAFT_API
+        /**
+          * Mask for selecting the Restriction Level bits from the return value of uspoof_check().
+          * 
+          * @draft ICU 53
+          */
+         USPOOF_RESTRICTION_LEVEL_MASK = 0x7F000000 
+#endif /* U_HIDE_DRAFT_API */
     } URestrictionLevel;
-#endif /* U_HIDE_DRAFT_API */
 
 /**
  *  Create a Unicode Spoof Checker, configured to perform all 
  *  checks except for USPOOF_LOCALE_LIMIT and USPOOF_CHAR_LIMIT.
  *  Note that additional checks may be added in the future,
  *  resulting in the changes to the default checking behavior.
  *
  *  @param status  The error code, set if this function encounters a problem.
  *  @return        the newly created Spoof Checker
  *  @stable ICU 4.2
  */
 U_STABLE USpoofChecker * U_EXPORT2
 uspoof_open(UErrorCode *status);
 
 
 /**
- * Open a Spoof checker from its serialized from, stored in 32-bit-aligned memory.
+ * Open a Spoof checker from its serialized form, stored in 32-bit-aligned memory.
  * Inverse of uspoof_serialize().
  * The memory containing the serialized data must remain valid and unchanged
  * as long as the spoof checker, or any cloned copies of the spoof checker,
  * are in use.  Ownership of the memory remains with the caller.
  * The spoof checker (and any clones) must be closed prior to deleting the
  * serialized data.
  *
  * @param data a pointer to 32-bit-aligned memory containing the serialized form of spoof data
  * @param length the number of bytes available at data;
  *               can be more than necessary
  * @param pActualLength receives the actual number of bytes at data taken up by the data;
  *                      can be NULL
  * @param pErrorCode ICU error code
  * @return the spoof checker.
  *
  * @see uspoof_open
  * @see uspoof_serialize
  * @stable ICU 4.2
  */
 U_STABLE USpoofChecker * U_EXPORT2
 uspoof_openFromSerialized(const void *data, int32_t length, int32_t *pActualLength,
                           UErrorCode *pErrorCode);
 
 /**
   * Open a Spoof Checker from the source form of the spoof data.
-  * The Three inputs correspond to the Unicode data files confusables.txt
-  * confusablesWholeScript.txt and xidmdifications.txt as described in
-  * Unicode UAX #39.  The syntax of the source data is as described in UAX #39 for
+  * The two inputs correspond to the Unicode data files confusables.txt
+  * and confusablesWholeScript.txt as described in Unicode UAX #39.
+  * The syntax of the source data is as described in UAX #39 for
   * these files, and the content of these files is acceptable input.
   *
   * The character encoding of the (char *) input text is UTF-8.
   *
   * @param confusables a pointer to the confusable characters definitions,
   *                    as found in file confusables.txt from unicode.org.
   * @param confusablesLen The length of the confusables text, or -1 if the
   *                    input string is zero terminated.
   * @param confusablesWholeScript
   *                    a pointer to the whole script confusables definitions,
@@ skipping 81 matching lines @@
  * @param status   The error code, set if this function encounters a problem.
  * @return         The set of checks that this spoof checker will perform.
  *                 The value is a bit set, obtained by OR-ing together
  *                 values from enum USpoofChecks.
  * @stable ICU 4.2
  *
  */
 U_STABLE int32_t U_EXPORT2
 uspoof_getChecks(const USpoofChecker *sc, UErrorCode *status);
 
-#ifndef U_HIDE_DRAFT_API
 /**
   * Set the loosest restriction level allowed. The default if this function 
   * is not called is HIGHLY_RESTRICTIVE.
   * Calling this function also enables the RESTRICTION_LEVEL check.
   * @param restrictionLevel The loosest restriction level allowed.
   * @see URestrictionLevel
-  * @draft ICU 51
+  * @stable ICU 51
   */
-U_DRAFT void U_EXPORT2
+U_STABLE void U_EXPORT2
 uspoof_setRestrictionLevel(USpoofChecker *sc, URestrictionLevel restrictionLevel);
 
 
 /**
   * Get the Restriction Level that will be tested if the checks include RESTRICTION_LEVEL.
   *
   * @return The restriction level
   * @see URestrictionLevel
-  * @draft ICU 51
+  * @stable ICU 51
   */
-U_DRAFT URestrictionLevel U_EXPORT2
+U_STABLE URestrictionLevel U_EXPORT2
 uspoof_getRestrictionLevel(const USpoofChecker *sc);
-#endif /* U_HIDE_DRAFT_API */
 
 /**
  * Limit characters that are acceptable in identifiers being checked to those 
  * normally used with the languages associated with the specified locales.
  * Any previously specified list of locales is replaced by the new settings.
  *
  * A set of languages is determined from the locale(s), and
  * from those a set of acceptable Unicode scripts is determined.
  * Characters from this set of scripts, along with characters from
  * the "common" and "inherited" Unicode Script categories
@@ skipping 471 matching lines @@
   * @stable ICU 4.2
   */   
 U_I18N_API icu::UnicodeString & U_EXPORT2
 uspoof_getSkeletonUnicodeString(const USpoofChecker *sc,
                                 uint32_t type,
                                 const icu::UnicodeString &id,
                                 icu::UnicodeString &dest,
                                 UErrorCode *status);
 #endif   /* U_SHOW_CPLUSPLUS_API */
 
-
-#ifndef U_HIDE_DRAFT_API
 /**
   * Get the set of Candidate Characters for Inclusion in Identifiers, as defined
   * in Unicode UAX #31, http://www.unicode.org/reports/tr31/#Table_Candidate_Characters_for_Inclusion_in_Identifiers
   *
   * The returned set is frozen. Ownership of the set remains with the ICU library; it must not
   * be deleted by the caller.
   *
   * @param status The error code, set if a problem occurs while creating the set.
   *
-  * @draft ICU 51
+  * @stable ICU 51
   */
-U_DRAFT const USet * U_EXPORT2
+U_STABLE const USet * U_EXPORT2
 uspoof_getInclusionSet(UErrorCode *status);
 
 /**
   * Get the set of characters from Recommended Scripts for Inclusion in Identifiers, as defined
   * in Unicode UAX #31, http://www.unicode.org/reports/tr31/#Table_Recommended_Scripts
   *
   * The returned set is frozen. Ownership of the set remains with the ICU library; it must not
   * be deleted by the caller.
   *
   * @param status The error code, set if a problem occurs while creating the set.
   *
-  * @draft ICU 51
+  * @stable ICU 51
   */
-U_DRAFT const USet * U_EXPORT2
+U_STABLE const USet * U_EXPORT2
 uspoof_getRecommendedSet(UErrorCode *status);
 
 #if U_SHOW_CPLUSPLUS_API
 
 /**
   * Get the set of Candidate Characters for Inclusion in Identifiers, as defined
   * in Unicode UAX #31, http://www.unicode.org/reports/tr31/#Table_Candidate_Characters_for_Inclusion_in_Identifiers
   *
   * The returned set is frozen. Ownership of the set remains with the ICU library; it must not
   * be deleted by the caller.
   *
   * @param status The error code, set if a problem occurs while creating the set.
   *
-  * @draft ICU 51
+  * @stable ICU 51
   */
-U_DRAFT const icu::UnicodeSet * U_EXPORT2
+U_STABLE const icu::UnicodeSet * U_EXPORT2
 uspoof_getInclusionUnicodeSet(UErrorCode *status);
 
 /**
   * Get the set of characters from Recommended Scripts for Inclusion in Identifiers, as defined
   * in Unicode UAX #31, http://www.unicode.org/reports/tr31/#Table_Recommended_Scripts
   *
   * The returned set is frozen. Ownership of the set remains with the ICU library; it must not
   * be deleted by the caller.
   *
   * @param status The error code, set if a problem occurs while creating the set.
   *
-  * @draft ICU 51
+  * @stable ICU 51
   */
-U_DRAFT const icu::UnicodeSet * U_EXPORT2
+U_STABLE const icu::UnicodeSet * U_EXPORT2
 uspoof_getRecommendedUnicodeSet(UErrorCode *status);
 
 #endif /* U_SHOW_CPLUSPLUS_API */
-#endif /* U_HIDE_DRAFT_API */
 
 /**
  * Serialize the data for a spoof detector into a chunk of memory.
  * The flattened spoof detection tables can later be used to efficiently
  * instantiate a new Spoof Detector.
  *
  * The serialized spoof checker includes only the data compiled from the
  * Unicode data tables by uspoof_openFromSource(); it does not include 
  * include any other state or configuration that may have been set.
  *
@@ skipping 12 matching lines @@
  */
 U_STABLE int32_t U_EXPORT2
 uspoof_serialize(USpoofChecker *sc,
                  void *data, int32_t capacity,
                  UErrorCode *status);
 
 
 #endif
 
 #endif   /* USPOOF_H */