[LANG-704] New methods for StringUtils class: equalsAny and equalsAnyIgnoreCase

• Type: New Feature
• Status: Closed
• Priority: Minor
• Resolution: Duplicate
• Fix Version/s: Review Patch
• Component/s: lang.*
• Labels: StringUtils

Environment

N/A - it is a feature request.

• Assignee: Unassigned
• Reporter: Rafal Glowinski
• Created: 07/Jun/11 06:53
• Updated: 06/Nov/15 13:59
• Resolved: 06/Nov/15 13:59

Description

It would be very good if the StringUtils class provided 2 methods for testing String equality with more than one value at a time.
Methods could be written as follows:

StringUtils.java

    /**
     * Verifies if the tested string is equal with any of the provided strings.
     * This method is null safe and case sensitive.
     * 
     * @param str Tested string
     * @param any Strings to be tested against.
     * @return true if tested string is equal to any of the provided strings. false otherwise.
     */
    public static boolean equalsWithAny(String str, String... any) {
        if (str == null) {
            return false;
        }
        
        if (any == null) {
            return false;
        }
        
        for (String s : any) {
            if (str.equals(s)) {
                return true;
            }
        }
        
        return false;
    }
    
    /**
     * Verifies if the tested string is equal with any of the provided strings.
     * This method is null safe and case insensitive.
     * 
     * @param str Tested string
     * @param any Strings to be tested against.
     * @return true if tested string is equal to any of the provided strings. false otherwise.
     */    
    public static boolean equalsWithAnyIgnoreCase(String str, String... any) {
        if (str == null) {
            return false;
        }
        
        if (any == null) {
            return false;
        }
        
        for (String s : any) {
            if (str.equalsIgnoreCase(s)) {
                return true;
            }
        }
        
        return false;
    }

Issue Links

• is duplicated by: LANG-1169 Add a StringUtils method to compare a string to multiple strings