StringUtils (A ~ C)

String abbreviate(String str, int maxWidth)

---

문자열을 지정한 크기(maxWidth) 만큼 축소시킴

 StringUtils.abbreviate(null, *)      = null
 StringUtils.abbreviate("", 4)        = ""
 StringUtils.abbreviate("abcdefg", 6) = "abc..."
 StringUtils.abbreviate("abcdefg", 7) = "abcdefg"
 StringUtils.abbreviate("abcdefg", 8) = "abcdefg"
 StringUtils.abbreviate("abcdefg", 4) = "a..."
 StringUtils.abbreviate("abcdefg", 3) = IllegalArgumentException

String abbreviate(String str, int offset, int maxWidth)

---

문자열을 offset 만큼 띄어서 지정한 크기(maxWidth) 만큼 축소시킴

 StringUtils.abbreviate(null, *, *)                = null
 StringUtils.abbreviate("", 0, 4)                  = ""
 StringUtils.abbreviate("abcdefghijklmno", -1, 10) = "abcdefg..."
 StringUtils.abbreviate("abcdefghijklmno", 0, 10)  = "abcdefg..."
 StringUtils.abbreviate("abcdefghijklmno", 1, 10)  = "abcdefg..."
 StringUtils.abbreviate("abcdefghijklmno", 4, 10)  = "abcdefg..."
 StringUtils.abbreviate("abcdefghijklmno", 5, 10)  = "...fghi..."
 StringUtils.abbreviate("abcdefghijklmno", 6, 10)  = "...ghij..."
 StringUtils.abbreviate("abcdefghijklmno", 8, 10)  = "...ijklmno"
 StringUtils.abbreviate("abcdefghijklmno", 10, 10) = "...ijklmno"
 StringUtils.abbreviate("abcdefghijklmno", 12, 10) = "...ijklmno"
 StringUtils.abbreviate("abcdefghij", 0, 3)        = IllegalArgumentException
 StringUtils.abbreviate("abcdefghij", 5, 6)        = IllegalArgumentException

String abbreviate(String str, String abbrevMarker, int maxWidth)

---

문자열을 지정한 크기(maxWidth) 만큼 대체 문자열(abbrevMarker) 로 축소시킴

StringUtils.abbreviate(null, "...", *)      = null
 StringUtils.abbreviate("abcdefg", null, *)  = "abcdefg"
 StringUtils.abbreviate("", "...", 4)        = ""
 StringUtils.abbreviate("abcdefg", ".", 5)   = "abcd."
 StringUtils.abbreviate("abcdefg", ".", 7)   = "abcdefg"
 StringUtils.abbreviate("abcdefg", ".", 8)   = "abcdefg"
 StringUtils.abbreviate("abcdefg", "..", 4)  = "ab.."
 StringUtils.abbreviate("abcdefg", "..", 3)  = "a.."
 StringUtils.abbreviate("abcdefg", "..", 2)  = IllegalArgumentException
 StringUtils.abbreviate("abcdefg", "...", 3) = IllegalArgumentException

String abbreviate(String str, String abbrevMarker, int offset, int maxWidth)

---

문자열을 offset 만큼 띄어서 지정한 크기(maxWidth) 만큼 대체 문자열(abbrevMarker) 로 축소시킴

 StringUtils.abbreviate(null, null, *, *)                 = null
 StringUtils.abbreviate("abcdefghijklmno", null, *, *)    = "abcdefghijklmno"
 StringUtils.abbreviate("", "...", 0, 4)                  = ""
 StringUtils.abbreviate("abcdefghijklmno", "---", -1, 10) = "abcdefg---"
 StringUtils.abbreviate("abcdefghijklmno", ",", 0, 10)    = "abcdefghi,"
 StringUtils.abbreviate("abcdefghijklmno", ",", 1, 10)    = "abcdefghi,"
 StringUtils.abbreviate("abcdefghijklmno", ",", 2, 10)    = "abcdefghi,"
 StringUtils.abbreviate("abcdefghijklmno", "::", 4, 10)   = "::efghij::"
 StringUtils.abbreviate("abcdefghijklmno", "...", 6, 10)  = "...ghij..."
 StringUtils.abbreviate("abcdefghijklmno", "*", 9, 10)    = "*ghijklmno"
 StringUtils.abbreviate("abcdefghijklmno", "'", 10, 10)   = "'ghijklmno"
 StringUtils.abbreviate("abcdefghijklmno", "!", 12, 10)   = "!ghijklmno"
 StringUtils.abbreviate("abcdefghij", "abra", 0, 4)       = IllegalArgumentException
 StringUtils.abbreviate("abcdefghij", "...", 5, 6)        = IllegalArgumentException

String abbreviateMiddle(String str, String middle, int length)

---

문자열을 지정한 길이(length)로 축소, 축소된 문자열에 지정한 문자열(middle) 삽입

 StringUtils.abbreviateMiddle(null, null, 0)      = null
 StringUtils.abbreviateMiddle("abc", null, 0)      = "abc"
 StringUtils.abbreviateMiddle("abc", ".", 0)      = "abc"
 StringUtils.abbreviateMiddle("abc", ".", 3)      = "abc"
 StringUtils.abbreviateMiddle("abcdef", ".", 4)     = "ab.f"

String appendIfMissing(String str, CharSequence suffix, CharSequence... suffixes)

---

마지막 단어(suffixes)가 없다면 추가할 단어(suffix)를 문자열에 추가

 StringUtils.appendIfMissing(null, null, null) = null
 StringUtils.appendIfMissing("abc", null, null) = "abc"
 StringUtils.appendIfMissing("", "xyz", null) = "xyz"
 StringUtils.appendIfMissing("abc", "xyz", new CharSequence[]{null}) = "abcxyz"
 StringUtils.appendIfMissing("abc", "xyz", "") = "abc"
 StringUtils.appendIfMissing("abc", "xyz", "mno") = "abcxyz"
 StringUtils.appendIfMissing("abcxyz", "xyz", "mno") = "abcxyz"
 StringUtils.appendIfMissing("abcmno", "xyz", "mno") = "abcmno"
 StringUtils.appendIfMissing("abcXYZ", "xyz", "mno") = "abcXYZxyz"
 StringUtils.appendIfMissing("abcMNO", "xyz", "mno") = "abcMNOxyz"

String appendIfMissingIgnoreCase(String str, CharSequence suffix, CharSequence... suffixes)

---

마지막 단어(suffixes)가 없다면 추가할 단어(suffix)를 문자열에 추가(대소문자 구별 없음)

 StringUtils.appendIfMissingIgnoreCase(null, null, null) = null
 StringUtils.appendIfMissingIgnoreCase("abc", null, null) = "abc"
 StringUtils.appendIfMissingIgnoreCase("", "xyz", null) = "xyz"
 StringUtils.appendIfMissingIgnoreCase("abc", "xyz", new CharSequence[]{null}) = "abcxyz"
 StringUtils.appendIfMissingIgnoreCase("abc", "xyz", "") = "abc"
 StringUtils.appendIfMissingIgnoreCase("abc", "xyz", "mno") = "axyz"
 StringUtils.appendIfMissingIgnoreCase("abcxyz", "xyz", "mno") = "abcxyz"
 StringUtils.appendIfMissingIgnoreCase("abcmno", "xyz", "mno") = "abcmno"
 StringUtils.appendIfMissingIgnoreCase("abcXYZ", "xyz", "mno") = "abcXYZ"
 StringUtils.appendIfMissingIgnoreCase("abcMNO", "xyz", "mno") = "abcMNO"

String capitalize(String str)

---

문자열의 첫 글자를 대문자로 변환

 StringUtils.capitalize(null)  = null
 StringUtils.capitalize("")    = ""
 StringUtils.capitalize("cat") = "Cat"
 StringUtils.capitalize("cAt") = "CAt"
 StringUtils.capitalize("'cat'") = "'cat'"

 

 

String center(String str, int size)

---

문자열에 지정한 크기(size) 만큼 공백 추가 (오른쪽, 왼쪽 순으로 추가)

 StringUtils.center(null, *)   = null
 StringUtils.center("", 4)     = "    "
 StringUtils.center("ab", -1)  = "ab"
 StringUtils.center("ab", 4)   = " ab "
 StringUtils.center("abcd", 2) = "abcd"
 StringUtils.center("a", 4)    = " a  "

String center(String str, int size, char padChar)

---

문자열에 지정한 크기(size) 만큼 글자(padChar) 로 추가

 StringUtils.center(null, *, *)     = null
 StringUtils.center("", 4, ' ')     = "    "
 StringUtils.center("ab", -1, ' ')  = "ab"
 StringUtils.center("ab", 4, ' ')   = " ab "
 StringUtils.center("abcd", 2, ' ') = "abcd"
 StringUtils.center("a", 4, ' ')    = " a  "
 StringUtils.center("a", 4, 'y')    = "yayy"

String center(String str, int size, String padStr)

---

문자열에 지정한 크기(size) 만큼 문자열(padStr) 로 추가

 StringUtils.center(null, *, *)     = null
 StringUtils.center("", 4, " ")     = "    "
 StringUtils.center("ab", -1, " ")  = "ab"
 StringUtils.center("ab", 4, " ")   = " ab "
 StringUtils.center("abcd", 2, " ") = "abcd"
 StringUtils.center("a", 4, " ")    = " a  "
 StringUtils.center("a", 4, "yz")   = "yayz"
 StringUtils.center("abc", 7, null) = "  abc  "
 StringUtils.center("abc", 7, "")   = "  abc  "

String chomp(String str)

---

문자열의 마지막 개행문자(new line) 제거

 StringUtils.chomp(null)          = null
 StringUtils.chomp("")            = ""
 StringUtils.chomp("abc \r")      = "abc "
 StringUtils.chomp("abc\n")       = "abc"
 StringUtils.chomp("abc\r\n")     = "abc"
 StringUtils.chomp("abc\r\n\r\n") = "abc\r\n"
 StringUtils.chomp("abc\n\r")     = "abc\n"
 StringUtils.chomp("abc\n\rabc")  = "abc\n\rabc"
 StringUtils.chomp("\r")          = ""
 StringUtils.chomp("\n")          = ""
 StringUtils.chomp("\r\n")        = ""

String chop(String str)

---

문자열의 마지막 글자 제거

 StringUtils.chop(null)          = null
 StringUtils.chop("")            = ""
 StringUtils.chop("abc \r")      = "abc "
 StringUtils.chop("abc\n")       = "abc"
 StringUtils.chop("abc\r\n")     = "abc"
 StringUtils.chop("abc")         = "ab"
 StringUtils.chop("abc\nabc")    = "abc\nab"
 StringUtils.chop("a")           = ""
 StringUtils.chop("\r")          = ""
 StringUtils.chop("\n")          = ""
 StringUtils.chop("\r\n")        = ""

int compare(String str1, String str2)

---

두 문자열을 십진수로 변환 후 비교 결과값 반환

 StringUtils.compare(null, null)   = 0
 StringUtils.compare(null , "a")   < 0
 StringUtils.compare("a", null)    > 0
 StringUtils.compare("abc", "abc") = 0
 StringUtils.compare("a", "b")     < 0
 StringUtils.compare("b", "a")     > 0
 StringUtils.compare("a", "B")     > 0
 StringUtils.compare("ab", "abc")  < 0

int compare(String str1, String str2, boolean nullIsLess)

---

두 문자열을 십진수로 변환 후 비교 결과값 반환(인자가 null 일 경우 null 이 아닌 경우와 비교시 크고, 작음을 설정)

 StringUtils.compare(null, null, *)     = 0
 StringUtils.compare(null , "a", true)  < 0
 StringUtils.compare(null , "a", false) > 0
 StringUtils.compare("a", null, true)   > 0
 StringUtils.compare("a", null, false)  < 0
 StringUtils.compare("abc", "abc", *)   = 0
 StringUtils.compare("a", "b", *)       < 0
 StringUtils.compare("b", "a", *)       > 0
 StringUtils.compare("a", "B", *)       > 0
 StringUtils.compare("ab", "abc", *)    < 0

int compareIgnoreCase(String str1, String str2)

---

두 문자열을 십진수로 변환 후 비교 결과값 반환(대소문자 비교 안함)

 StringUtils.compareIgnoreCase(null, null)   = 0
 StringUtils.compareIgnoreCase(null , "a")   < 0
 StringUtils.compareIgnoreCase("a", null)    > 0
 StringUtils.compareIgnoreCase("abc", "abc") = 0
 StringUtils.compareIgnoreCase("abc", "ABC") = 0
 StringUtils.compareIgnoreCase("a", "b")     < 0
 StringUtils.compareIgnoreCase("b", "a")     > 0
 StringUtils.compareIgnoreCase("a", "B")     < 0
 StringUtils.compareIgnoreCase("A", "b")     < 0
 StringUtils.compareIgnoreCase("ab", "ABC")  < 0

int compareIgnoreCase(String str1, String str2, boolean nullIsLess)

---

두 문자열을 십진수로 변환 후 비교 결과값 반환(인자가 null 일 경우 null 이 아닌 경우와 비교시 크고, 작음을 설정, 대소문자 비교 안함)

 StringUtils.compareIgnoreCase(null, null, *)     = 0
 StringUtils.compareIgnoreCase(null , "a", true)  < 0
 StringUtils.compareIgnoreCase(null , "a", false) > 0
 StringUtils.compareIgnoreCase("a", null, true)   > 0
 StringUtils.compareIgnoreCase("a", null, false)  < 0
 StringUtils.compareIgnoreCase("abc", "abc", *)   = 0
 StringUtils.compareIgnoreCase("abc", "ABC", *)   = 0
 StringUtils.compareIgnoreCase("a", "b", *)       < 0
 StringUtils.compareIgnoreCase("b", "a", *)       > 0
 StringUtils.compareIgnoreCase("a", "B", *)       < 0
 StringUtils.compareIgnoreCase("A", "b", *)       < 0
 StringUtils.compareIgnoreCase("ab", "abc", *)    < 0

boolean contains(CharSequence seq, CharSequence searchSeq)

---

문자열에 비교할 문자열(searchSeq)이 있는지 확인

 StringUtils.contains(null, *)     = false
 StringUtils.contains(*, null)     = false
 StringUtils.contains("", "")      = true
 StringUtils.contains("abc", "")   = true
 StringUtils.contains("abc", "a")  = true
 StringUtils.contains("abc", "z")  = false

boolean contains(CharSequence seq, int searchChar)

---

문자열에 비교할 글자(searchChar)가 있는지 확인

 StringUtils.contains(null, *)    = false
 StringUtils.contains("", *)      = false
 StringUtils.contains("abc", 'a') = true
 StringUtils.contains("abc", 'z') = false

boolean containsAny(CharSequence cs, char... searchChars)

---

문자열에 비교할 문자들이 하나라도 있는지 확인

 StringUtils.containsAny(null, *)                = false
 StringUtils.containsAny("", *)                  = false
 StringUtils.containsAny(*, null)                = false
 StringUtils.containsAny(*, [])                  = false
 StringUtils.containsAny("zzabyycdxx",['z','a']) = true
 StringUtils.containsAny("zzabyycdxx",['b','y']) = true
 StringUtils.containsAny("zzabyycdxx",['z','y']) = true
 StringUtils.containsAny("aba", ['z'])           = false

boolean containsAny(CharSequence cs, CharSequence... searchCharSequences

---

문자열에 비교할 문자열이 하나라도 있는지 확인

 StringUtils.containsAny(null, *)            = false
 StringUtils.containsAny("", *)              = false
 StringUtils.containsAny(*, null)            = false
 StringUtils.containsAny(*, [])              = false
 StringUtils.containsAny("abcd", "ab", null) = true
 StringUtils.containsAny("abcd", "ab", "cd") = true
 StringUtils.containsAny("abc", "d", "abc")  = true

boolean containsAny(CharSequence cs, CharSequence searchChars)

---

문자열에 비교할 문자열이 하나라도 있는지 확인

 StringUtils.containsAny(null, *)               = false
 StringUtils.containsAny("", *)                 = false
 StringUtils.containsAny(*, null)               = false
 StringUtils.containsAny(*, "")                 = false
 StringUtils.containsAny("zzabyycdxx", "za")    = true
 StringUtils.containsAny("zzabyycdxx", "by")    = true
 StringUtils.containsAny("zzabyycdxx", "zy")    = true
 StringUtils.containsAny("zzabyycdxx", "\tx")   = true
 StringUtils.containsAny("zzabyycdxx", "$.#yF") = true
 StringUtils.containsAny("aba","z")             = false

boolean containsIgnoreCase(CharSequence str, CharSequence searchStr)

---

문자열에 비교할 문자열(searchSeq)이 있는지 확인(대소문자 구별 안함)

 StringUtils.containsIgnoreCase(null, *) = false
 StringUtils.containsIgnoreCase(*, null) = false
 StringUtils.containsIgnoreCase("", "") = true
 StringUtils.containsIgnoreCase("abc", "") = true
 StringUtils.containsIgnoreCase("abc", "a") = true
 StringUtils.containsIgnoreCase("abc", "z") = false
 StringUtils.containsIgnoreCase("abc", "A") = true
 StringUtils.containsIgnoreCase("abc", "Z") = false

boolean containsNone(CharSequence cs, char... searchChars)

---

contains 와 반대

 StringUtils.containsNone(null, *)       = true
 StringUtils.containsNone(*, null)       = true
 StringUtils.containsNone("", *)         = true
 StringUtils.containsNone("ab", '')      = true
 StringUtils.containsNone("abab", 'xyz') = true
 StringUtils.containsNone("ab1", 'xyz')  = true
 StringUtils.containsNone("abz", 'xyz')  = false

boolean containsNone(CharSequence cs, String invalidChars)

---

contains 와 반대

 StringUtils.containsNone(null, *)       = true
 StringUtils.containsNone(*, null)       = true
 StringUtils.containsNone("", *)         = true
 StringUtils.containsNone("ab", "")      = true
 StringUtils.containsNone("abab", "xyz") = true
 StringUtils.containsNone("ab1", "xyz")  = true
 StringUtils.containsNone("abz", "xyz")  = false

boolean containsOnly(CharSequence cs, char... valid)

---

문자열에 비교할 글자들(valid) 이 모두 포함되는지 확인

 StringUtils.containsOnly(null, *)       = false
 StringUtils.containsOnly(*, null)       = false
 StringUtils.containsOnly("", *)         = true
 StringUtils.containsOnly("ab", '')      = false
 StringUtils.containsOnly("abab", 'abc') = true
 StringUtils.containsOnly("ab1", 'abc')  = false
 StringUtils.containsOnly("abz", 'abc')  = false

boolean containsOnly(CharSequence cs, String validChars)

---

문자열에 비교할 문자열(validChars) 이 모두 포함되는지 확인

 StringUtils.containsOnly(null, *)       = false
 StringUtils.containsOnly(*, null)       = false
 StringUtils.containsOnly("", *)         = true
 StringUtils.containsOnly("ab", "")      = false
 StringUtils.containsOnly("abab", "abc") = true
 StringUtils.containsOnly("ab1", "abc")  = false
 StringUtils.containsOnly("abz", "abc")  = false

boolean containsWhitespace(CharSequence seq)

---

문자열에 공백이 있는지 확인

int countMatches(CharSequence str, char ch)

---

문자열에 비교할 글자(ch)가 있으면 1씩 증가하여 반환

 StringUtils.countMatches(null, *)       = 0
 StringUtils.countMatches("", *)         = 0
 StringUtils.countMatches("abba", 0)  = 0
 StringUtils.countMatches("abba", 'a')   = 2
 StringUtils.countMatches("abba", 'b')  = 2
 StringUtils.countMatches("abba", 'x') = 0

int countMatches(CharSequence str, CharSequence sub)

---

문자열에 비교할 문자열(sub)이 있으면 1씩 증가하여 반환

 StringUtils.countMatches(null, *)       = 0
 StringUtils.countMatches("", *)         = 0
 StringUtils.countMatches("abba", null)  = 0
 StringUtils.countMatches("abba", "")    = 0
 StringUtils.countMatches("abba", "a")   = 2
 StringUtils.countMatches("abba", "ab")  = 1
 StringUtils.countMatches("abba", "xxx") = 0