ICU 58 SpoofChecker API Changes

Transcription

1 ICU 58 SpoofChecker API Changes This is a proposal for changes to the SpoofChecker API in Java and C++. The changes are intended to reflect the most recent version of UTS 39. SpoofChecker API Changes, Java / Single script confusable test. When testing whether two identifiers are confusable, report that they are if both are from the same script and they are visually confusable. Note: this test is not applicable to a check of a single ICU 4.6 / public static final int SINGLE_SCRIPT_CONFUSABLE = 1; / Mixed script confusable test. <p>when checking a single identifier, report a problem if the identifier contains multiple scripts, and is also confusable with some other identifier in a single script. <p>when testing whether two identifiers are confusable, report that they are if the two IDs are visually confusable, and and at least one contains characters from more than one ICU 4.6 / public static final int MIXED_SCRIPT_CONFUSABLE = 2; / Whole script confusable test. <p>when checking a single identifier, report a problem if The identifier is of a single script, and there exists a confusable identifier in another script. <p>when testing whether two Identifiers are confusable, report that they are if each is of a single script, the scripts of the two identifiers are different, and the identifiers are visually ICU 4.6 / public static final int WHOLE_SCRIPT_CONFUSABLE = 4; / When performing the two string {@link SpoofChecker#areConfusable} test, this flag in the return value indicates that the two strings are visually confusable and that they are from the same script, according to UTS 39 section ICU 4.6 / public static final int SINGLE_SCRIPT_CONFUSABLE = 1; / When performing the two string {@link SpoofChecker#areConfusable} test, this flag in the return value indicates that the two strings are visually confusable and that they are not from the same script, according to UTS 39 section ICU 4.6 / public static final int MIXED_SCRIPT_CONFUSABLE = 2; / When performing the two string {@link SpoofChecker#areConfusable} test, this flag in the return value indicates that the two strings are visually confusable and that they are not from the same script but both of them are single script strings, according to UTS 39 section ICU 4.6 / public static final int WHOLE_SCRIPT_CONFUSABLE = 4; / Enable this flag in "setchecks" to turn on all types of confusables. You may set the checks to some subset of SINGLE_SCRIPT_CONFUSABLE, MIXED_SCRIPT_CONFUSABLE, or WHOLE_SCRIPT_CONFUSABLE to make {@link SpoofChecker#areConfusable} return only those types of confusables. <p>note: if you wish to use {@link SpoofChecker#getSkeleton}, it is required that you enable at least one of the CONFUSABLE flags. / public static final int CONFUSABLE = SINGLE_SCRIPT_CONFUSABLE MIXED_SCRIPT_CONFUSABLE WHOLE_SCRIPT_CONFUSABLE; / Any Case Modifier for confusable identifier tests. <p>when specified, consider all characters, of any case, when looking for confusables. If ANY_CASE is not specified, identifiers being checked are assumed to have been case folded, and upper case conusable characters will not be ICU 4.6 / public static final int ANY_CASE = 8; / Check that an identifier is no looser than the specified RestrictionLevel. The default if this is not called This API is ICU internal only. / public static final int RESTRICTION_LEVEL = 16; / Check that an identifier does not This API is ICU internal only. / / This API is deprecated and no longer affects the behavior of ICU 58 This API was deprecated in UTS 39 revision 11 and is no longer used. / public static final int ANY_CASE = 8; / Check that an identifier satisfies the requirements for the restriction level specified in {@link SpoofChecker.Builder#setRestrictionLevel}. The default restriction level is ICU 58 / public static final int RESTRICTION_LEVEL = 16; / Check that an identifier does not mix numbers from different numbering systems. For more information, see UTS 39 section ICU 58 /

2 public static final int MIXED_NUMBERS = 128; public static final int MIXED_NUMBERS = 128; / Specify the source form of the spoof data Spoof Checker. The inputs correspond to the Unicode data file s 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 confusables the Reader of confusable characters definitions, as found in file confusables.txt from confusableswholescript the Reader of whole script confusables definitions, as found in the file xonfusableswholescript.txt from ParseException To report syntax errors in the ICU 4.6 / public Builder setdata(reader confusables, Reader confusableswholescript ) throws ParseException, java.io.ioexception { / Set the loosest restriction level allowed. The default if this is not called is HIGHLY_RESTRICTIVE. This method also sets restrictionlevel The loosest restriction level self This API is ICU internal only. / public Builder setrestrictionlevel(restrictionlevel restrictionlevel) { / The numerics found in the string, if MIXED_NUMBERS was set; This API is ICU internal only. / public UnicodeSet numerics; / The restriction level that the text meets, if RESTRICTION_LEVEL is set; This API is ICU internal only. / public RestrictionLevel restrictionlevel; / Get the "skeleton" for an identifier string. Skeletons are a transformation of the input string; Two strings are confusable if their skeletons are identical. See Unicode UAX 39 for additional information. Using skeletons directly makes it possible to quickly check whether an identifier is confusable with any of some large set of existing identifiers, by creating an efficiently searchable collection of the skeletons. Skeletons are computed using the algorithm and data describe in Unicode UAX 39. The latest proposed update, UAX 39 Version 8 draft 1, says "the tables SL, SA, and ML were still problematic, and discouraged from use in [Uniocde] 7.0. They were thus removed from version 8.0" In light of this, the default mapping data included with ICU 55 uses the / Specify the source form of the spoof data Spoof Checker. The inputs correspond to the Unicode data file confusables.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 confusables the Reader of confusable characters definitions, as found in file confusables.txt from ParseException To report syntax errors in the ICU 58 / public Builder setdata(reader confusables) throws ParseException, IOException { //... } / Deprecated as of ICU 58; use {@link SpoofChecker.Builder#setData(Reader confusables)} confusables the Reader of confusable characters definitions, as found in file confusables.txt from confusableswholescript No longer ParseException To report syntax errors in the ICU 58 / public Builder setdata(reader confusables, Reader confusableswholescript) throws ParseException, IOException { setdata(confusables); return this; } / Set the loosest restriction level allowed. The default if this is not called is MODERATELY_RESTRICTIVE. This method also enables the RESTRICTION_LEVEL restrictionlevel The loosest restriction level ICU 58 / public Builder setrestrictionlevel(restrictionlevel restrictionlevel) { / The numerics found in the string, if MIXED_NUMBERS was set; otherwise ICU 58 / public UnicodeSet numerics; / The restriction level that the text meets, if RESTRICTION_LEVEL is set; otherwise ICU 58 / public RestrictionLevel restrictionlevel; / Get the "skeleton" for an identifier string. Skeletons are a transformation of the input string; Two strings are confusable if their skeletons are identical. See Unicode UAX 39 for additional information. Using skeletons directly makes it possible to quickly check whether an identifier is confusable with any of some large set of existing identifiers, by creating an efficiently searchable collection of the skeletons. Skeletons are computed using the algorithm and data describe d in Unicode UAX str The input string whose skeleton will be The output skeleton ICU 58 /

3 Unicode 7 MA (Multi script Any case) table data for the other type options (Single Script, Any Case), (Single Script, Lower Case) and (Multi Script, Lower type The type of skeleton, corresponding to which of the Unicode confusable data tables to use. The default is Mixed Script, Lowercase. Allowed options are SINGLE_SCRIPT_CONFUSABLE and ANY_CASE_CONFUSABLE. The two flags may be id The input identifier whose skeleton will be The output skeleton ICU 4.6 / public String getskeleton(int type, String id) { public String getskeleton(charsequence str) { //... } / Calls {@link SpoofChecker#getSkeleton(CharSequence id)}. Starting with ICU 55, the "type" parameter has been ignored, and starting with ICU 58, the parameter has been type No longer supported. Prior to ICU 55, was used to specify the mapping table SL, SA, ML, or id The input identifier whose skeleton will be The output skeleton ICU 58 / public String getskeleton(int type, CharSequence id) { return getskeleton(id); } SpoofChecker API Changes, C++ typedef enum USpoofChecks { typedef enum USpoofChecks { / Enable this flag in {@link uspoof_setchecks} to turn on all types of confusables. You may set the checks to some subset of SINGLE_SCRIPT_CONFUSABLE, MIXED_SCRIPT_CONFUSABLE, or WHOLE_SCRIPT_CONFUSABLE to make {@link uspoof_areconfusable} return only those types of confusables. <p>note: if you wish to use {@link uspoof_getskeleton}, it is required that you enable at least one of the CONFUSABLE uspoof_getskeleton / USPOOF_CONFUSABLE = 7, / Single script confusable test. When testing whether two identifiers are confusable, report that they are if both are from the same script and they are visually confusable. Note: this test is not applicable to a check of a single identifier. / USPOOF_SINGLE_SCRIPT_CONFUSABLE = 1, / Mixed script confusable test. When checking a single identifier, report a problem if the identifier contains multiple scripts, and is confusable with some other identifier in a single script When testing whether two identifiers are confusable, report that they are if the two IDs are visually confusable, and at least one contains characters from more than one script. / USPOOF_MIXED_SCRIPT_CONFUSABLE = 2, / Whole script confusable test. When checking a single identifier, report a problem if The identifier is of a single script, and there exists a confusable identifier in another script. When testing whether two identifiers are confusable, report that they are if each is of a single script, the scripts of the two identifiers are different, and the identifiers are visually confusable. / USPOOF_WHOLE_SCRIPT_CONFUSABLE = 4, / Any Case Modifier for confusable identifier tests. If specified, consider all characters, of any case, when looking for confusables. If USPOOF_ANY_CASE is not specified, identifiers being checked are assumed to have been case folded. Upper case confusable characters will not be checked. Selects between Lower Case Confusable and Any Case Confusable. / USPOOF_ANY_CASE = 8, / Check that an identifier is no looser than the specified RestrictionLevel. / When performing the two string {@link uspoof_areconfusable} test, this flag in the return value indicates that the two strings are visually confusable and that they are not from the same script, according to UTS 39 section uspoof_areconfusable / USPOOF_SINGLE_SCRIPT_CONFUSABLE = 1, / When performing the two string {@link uspoof_areconfusable} test, this flag in the return value indicates that the two strings are visually confusable and that they are not from the same script, according to UTS 39 section uspoof_areconfusable / USPOOF_MIXED_SCRIPT_CONFUSABLE = 2, / When performing the two string {@link uspoof_areconfusable} test, this flag in the return value indicates that the two strings are visually confusable and that they are not from the same script but both of them are single script strings, according to UTS 39 section uspoof_areconfusable / USPOOF_WHOLE_SCRIPT_CONFUSABLE = 4, #ifndef U_HIDE_DEPRECATED_API / This flag is deprecated and no longer affects the behavior of ICU 58 This API was deprecated in UTS 39 revision 11 and is no longer used. / USPOOF_ANY_CASE = 8, #endif / U_HIDE_DEPRECATED_API / / Check that an identifier is no looser than the specified RestrictionLevel.

4 The default if uspoof_setrestrictionlevel() is not called is HIGHLY_RESTRICTIVE. If USPOOF_AUX_INFO is enabled the actual restriction level of the identifier being tested will also be returned by ICU 51 / USPOOF_RESTRICTION_LEVEL = 16, The default if {@link uspoof_setrestrictionlevel} is not called is MODERATELY_RESTRICTIVE. If USPOOF_AUX_INFO is enabled the actual restriction level of the identifier being tested will also be returned by ICU 51 / USPOOF_RESTRICTION_LEVEL = 16, struct USpoofCheckResult; typedef struct USpoofCheckResult USpoofCheckResult; / Create a USpoofCheckResult, used by the {@link uspoof_check} class of functions to return information about the identifier. Information includes: <ul> <li>a bitmask of the checks that failed</li> <li>the identifier's restriction level (UTS 39 section 5.2)</li> <li>the set of numerics in the string (UTS 39 section 5.3)</li> status The error code, set if this function encounters a the newly created ICU 58 / U_STABLE USpoofCheckResult U_EXPORT2 uspoof_opencheckresult(uerrorcode status); / Close a USpoofCheckResult, freeing any memory that was being held by its checkresult The instance of USpoofCheckResult to ICU 58 / U_STABLE void U_EXPORT2 uspoof_closecheckresult(uspoofcheckresult checkresult); #if U_SHOW_CPLUSPLUS_API U_NAMESPACE_BEGIN / \class LocalUSpoofCheckResultPointer "Smart pointer" class, closes a USpoofCheckResult via {@link uspoof_closecheckresult}. For most methods see the LocalPointerBase base ICU 58 / U_DEFINE_LOCAL_OPEN_POINTER(LocalUSpoofCheckResultPointer, USpoofCheckResult, uspoof_closecheckresult); U_NAMESPACE_END #endif / Gets the bitmask of failing checks from a checkresult The instance of An integer value with bits set for any potential or spoofing issues detected. The bits are defined by enum USpoofChecks. (returned_value & USPOOF_ALL_CHECKS) will be zero if the input string passes all of the enabled ICU 58 / uspoof_getcheckresultchecks(const USpoofCheckResult checkresult, UErrorCode status); / Gets the URestrictionLevel from a checkresult The instance of The restriction level contained in the ICU 58 / U_STABLE URestrictionLevel U_EXPORT2 uspoof_getcheckresultrestrictionlevel(const USpoofCheckResult checkresult, UErrorCode status); / Gets the set of numerics from a USpoofCheckResult. Ownership of the returned USet remains with the USpoofCheckResult.

5 @param checkresult The instance of The set of numerics contained in the ICU 58 / U_STABLE const USet U_EXPORT2 uspoof_getcheckresultnumerics(const USpoofCheckResult checkresult, UErrorCode status); / Get the "skeleton" for an identifier. Skeletons are a transformation of the input identifier; Two identifiers are confusable if their skeletons are identical. See Unicode UAX #39 for additional information. Using skeletons directly makes it possible to quickly check whether an identifier is confusable with any of some large set of existing identifiers, by creating an efficiently searchable collection of the sc The type The type of skeleton, corresponding to which of the Unicode confusable data tables to use. The default is Mixed Script, Lowercase. Allowed options are USPOOF_SINGLE_SCRIPT_CONFUSABLE and USPOOF_ANY_CASE. The two flags may be id The input identifier whose skeleton will be length The length of the input identifier, expressed in 16 bit UTF 16 code units, or 1 if the string is zero dest The output buffer, to receive the skeleton destcapacity The length of the output buffer, in 16 bit units. The destcapacity may be zero, in which case the function will return the actual length of the status The error code, set if an error occurred while perform the The length of the skeleton string. The returned length is always that of the complete skeleton, even when the supplied buffer is too small (or of zero ICU 4.2 / uspoof_getskeleton(const USpoofChecker sc, uint32_t type, const UChar id, int32_t length, UChar dest, int32_t destcapacity, UErrorCode status); / Open a Spoof Checker from the source form of the spoof data. 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 confusables a pointer to the confusable characters definitions, as found in file confusables.txt from confusableslen The length of the confusables text, or 1 if the input string is zero confusableswholescript a pointer to the whole script confusables definitions, as found in the file confusableswholescript.txt from confusableswholescriptlen The length of the whole script confusables text, or 1 if the input string is zero errtype In the event of an error in the input, indicates which of the input files contains the error. The value is one of USPOOF_SINGLE_SCRIPT_CONFUSABLE or USPOOF_WHOLE_SCRIPT_CONFUSABLE, or zero if no errors are pe In the event of an error in the input, receives the position in the input text (line, offset) of the status an in/out ICU UErrorCode. Among the possible errors is U_PARSE_ERROR, which is used to report syntax errors in the A spoof checker that uses the rules from the input ICU 4.2 / U_STABLE USpoofChecker U_EXPORT2 uspoof_openfromsource(const char confusables, int32_t confusableslen, const char confusableswholescript, int32_t confusableswholescriptlen, int32_t errtype, UParseError pe, UErrorCode / Get the "skeleton" for an identifier. Skeletons are a transformation of the input identifier; Two identifiers are confusable if their skeletons are identical. See Unicode UAX #39 for additional information. Using skeletons directly makes it possible to quickly check whether an identifier is confusable with any of some large set of existing identifiers, by creating an efficiently searchable collection of the sc The type No longer used; you may pass any number. Originally, controlled which of the Unicode confusable data tables to ICU id The input identifier whose skeleton will be length The length of the input identifier, expressed in 16 bit UTF 16 code units, or 1 if the string is zero dest The output buffer, to receive the skeleton destcapacity The length of the output buffer, in 16 bit units. The destcapacity may be zero, in which case the function will return the actual length of the status The error code, set if an error occurred while perform the The length of the skeleton string. The returned length is always that of the complete skeleton, even when the supplied buffer is too small (or of zero ICU uspoof_areconfusable / uspoof_getskeleton(const USpoofChecker sc, uint32_t type, const UChar id, int32_t length, UChar dest, int32_t destcapacity, UErrorCode status); / Open a Spoof Checker from the source form of the spoof data. The input corresponds to the Unicode data file confusables.txt as described in Unicode UAX #39. The syntax of the source data is as described in UAX #39 for this file, and the content of this file is acceptable input. The character encoding of the (char ) input text is UTF confusables a pointer to the confusable characters definitions, as found in file confusables.txt from confusableslen The length of the confusables text, or 1 if the input string is zero confusableswholescript Deprecated in ICU 58. No longer confusableswholescriptlen Deprecated in ICU 58. No longer errtype In the event of an error in the input, indicates which of the input files contains the error. The value is one of USPOOF_SINGLE_SCRIPT_CONFUSABLE or USPOOF_WHOLE_SCRIPT_CONFUSABLE, or zero if no errors are pe In the event of an error in the input, receives the position in the input text (line, offset) of the status an in/out ICU UErrorCode. Among the possible errors is U_PARSE_ERROR, which is used to report syntax errors in the A spoof checker that uses the rules from the input ICU 4.2 / U_STABLE USpoofChecker U_EXPORT2 uspoof_openfromsource(const char confusables, int32_t confusableslen, const char confusableswholescript, int32_t confusableswholescriptlen, int32_t errtype, UParseError pe, UErrorCode status);

6 status); C++ Option A: New uspoof_check functions to take a CheckResult parameter / Check the specified string for possible issues. The text to be checked will typically be an identifier of some sort. The set of checks to be performed is specified with uspoof_setchecks(). This version of {@link uspoof_check} accepts a USpoofCheckResult, which returns additional information about the identifier. For more information, see {@link sc The id The identifier to be checked for possible issues, in UTF 16 checkresult An instance of USpoofCheckResult to be filled with details about the identifier. Can be status The error code, set if an error occurred while perform the check. Spoofing or issues detected with the input not reported here, but through the function's TRUE if the identifier failed any checks; FALSE ICU 58 / U_STABLE UBool U_EXPORT2 uspoof_checkwithcheckresult(const USpoofChecker sc, const UChar id, int32_t length, USpoofCheckResult checkresult, UErrorCode status); / Check the specified string for possible issues. The text to be checked will typically be an identifier of some sort. The set of checks to be performed is specified with uspoof_setchecks(). This version of {@link uspoof_check} accepts a USpoofCheckResult, which returns additional information about the identifier. For more information, see {@link sc The id A identifier to be checked for possible issues, in UTF8 length the length of the string to be checked, or 1 if the string is zero checkresult An instance of USpoofCheckResult to be filled with details about the identifier. Can be status The error code, set if an error occurred while perform the check. Spoofing or issues detected with the input not reported here, but through the function's TRUE if the identifier failed any checks; FALSE ICU 58 / U_STABLE UBool U_EXPORT2 uspoof_checkutf8withcheckresult(const USpoofChecker sc, const char id, int32_t length, USpoofCheckResult checkresult, UErrorCode status); #if U_SHOW_CPLUSPLUS_API / Check the specified string for possible issues. The text to be checked will typically be an identifier of some sort. The set of checks to be performed is specified with sc The id A identifier to be checked for possible checkresult An instance of USpoofCheckResult to be filled with details about the identifier. Can be status The error code, set if an error occurred while perform the check. Spoofing or issues detected with the input not reported here, but through the function's TRUE if the identifier failed any checks; FALSE ICU 58 / U_STABLE UBool U_EXPORT2 uspoof_checkunicodestringwithcheckresult(const USpoofChecker sc, const icu::unicodestring &id,

7 USpoofCheckResult checkresult, UErrorCode status); #endif C++ Option B: Re brand deprecated "position" parameter on existing uspoof_check functions The change can be made binary compatible with previous versions. The first int sized piece of memory associated with a USpoofCheckResult can be a special unique byte sequence that the function can use to determine with reasonable accuracy if the caller passed in an int32_t or a USpoofCheckResult. / Check the specified string for possible issues. The text to be checked will typically be an identifier of some sort. The set of checks to be performed is specified with sc The id The identifier to be checked for possible issues, in UTF 16 length the length of the string to be checked, expressed in 16 bit UTF 16 code units, or 1 if the string is zero position Deprecated in ICU 51. Always returns zero. Originally, an out parameter for the index of the first string position that failed a check. This parameter may be status The error code, set if an error occurred while perform the check. Spoofing or issues detected with the input not reported here, but through the function's An integer value with bits set for any potential or spoofing issues detected. The bits are defined by enum USpoofChecks. (returned_value & USPOOF_ALL_CHECKS) will be zero if the input string passes all of the enabled ICU 4.2 / uspoof_check(const USpoofChecker sc, const UChar id, int32_t length, int32_t position, UErrorCode status); / Check the specified string for possible issues. The text to be checked will typically be an identifier of some sort. The set of checks to be performed is specified with sc The id A identifier to be checked for possible issues, in UTF8 length the length of the string to be checked, or 1 if the string is zero position Deprecated in ICU 51. Always returns zero. Originally, an out parameter for the index of the first string position that failed a check. This parameter may be status The error code, set if an error occurred while perform the check. Spoofing or issues detected with the input not reported here, but through the function's return If the input contains invalid UTF 8 sequences, a status of U_INVALID_CHAR_FOUND will be An integer value with bits set for any potential or spoofing issues detected. The bits are defined by enum USpoofChecks. (returned_value & USPOOF_ALL_CHECKS) will be zero if the input string passes all of the enabled ICU 4.2 / uspoof_checkutf8(const USpoofChecker sc, const char id, int32_t length, int32_t position, UErrorCode status); #if U_SHOW_CPLUSPLUS_API / Check the specified string for possible issues. The text to be checked will typically be an identifier of some sort. The set of checks to be performed is specified with sc The USpoofChecker / Check the specified string for possible issues. The text to be checked will typically be an identifier of some sort. The set of checks to be performed is specified with sc The id The identifier to be checked for possible issues, in UTF 16 length the length of the string to be checked, expressed in 16 bit UTF 16 code units, or 1 if the string is zero checkresult An instance of {@link USpoofCheckResult} to be populated with details about this identifier. This parameter may be status The error code, set if an error occurred while perform the check. Spoofing or issues detected with the input not reported here, but through the function's An integer value with bits set for any potential or spoofing issues detected. The bits are defined by enum USpoofChecks. (returned_value & USPOOF_ALL_CHECKS) will be zero if the input string passes all of the enabled ICU 58 / uspoof_check(const USpoofChecker sc, const UChar id, int32_t length, USpoofCheckResult checkresult, UErrorCode status); / Check the specified string for possible issues. The text to be checked will typically be an identifier of some sort. The set of checks to be performed is specified with sc The id A identifier to be checked for possible issues, in UTF8 length the length of the string to be checked, or 1 if the string is zero checkresult An instance of {@link USpoofCheckResult} to be populated with details about this identifier. This parameter may be status The error code, set if an error occurred while perform the check. Spoofing or issues detected with the input not reported here, but through the function's return If the input contains invalid UTF 8 sequences, a status of U_INVALID_CHAR_FOUND will be An integer value with bits set for any potential or spoofing issues detected. The bits are defined by enum USpoofChecks. (returned_value & USPOOF_ALL_CHECKS) will be zero if the input string passes all of the enabled ICU 58 / uspoof_checkutf8(const USpoofChecker sc, const char id, int32_t length, USpoofCheckResult checkresult, UErrorCode status); #if U_SHOW_CPLUSPLUS_API / Check the specified string for possible issues. The text to be checked will typically be an identifier of some sort. The set of checks to be performed is specified with sc The id A identifier to be checked for possible checkresult An instance of {@link USpoofCheckResult} to be

8 @param id A identifier to be checked for possible position Deprecated in ICU 51. Always returns zero. Originally, an out parameter for the index of the first string position that failed a check. This parameter may be status The error code, set if an error occurred while perform the check. Spoofing or issues detected with the input not reported here, but through the function's An integer value with bits set for any potential or spoofing issues detected. The bits are defined by enum USpoofChecks. (returned_value & USPOOF_ALL_CHECKS) will be zero if the input string passes all of the enabled ICU 4.2 / uspoof_checkunicodestring(const USpoofChecker sc, const icu::unicodestring &id, int32_t position, UErrorCode status); populated with details about this identifier. This parameter may be status The error code, set if an error occurred while perform the check. Spoofing or issues detected with the input not reported here, but through the function's An integer value with bits set for any potential or spoofing issues detected. The bits are defined by enum USpoofChecks. (returned_value & USPOOF_ALL_CHECKS) will be zero if the input string passes all of the enabled ICU 58 / uspoof_checkunicodestring(const USpoofChecker sc, const icu::unicodestring &id, USpoofCheckResult checkresult, UErrorCode status); #endif #endif