StringUtils (S ~ U)

String[] split(String str)

---

문자열의 공백을 기준으로 나눠 문자열 배열 반환

 StringUtils.split(null)       = null
 StringUtils.split("")         = []
 StringUtils.split("abc def")  = ["abc", "def"]
 StringUtils.split("abc  def") = ["abc", "def"]
 StringUtils.split(" abc ")    = ["abc"]

String[] split(String str, char separatorChar)

---

지정한 글자(separatorChar) 를 기준으로 나눠 문자열 배열 반환

 StringUtils.split(null, *)         = null
 StringUtils.split("", *)           = []
 StringUtils.split("a.b.c", '.')    = ["a", "b", "c"]
 StringUtils.split("a..b.c", '.')   = ["a", "b", "c"]
 StringUtils.split("a:b:c", '.')    = ["a:b:c"]
 StringUtils.split("a b c", ' ')    = ["a", "b", "c"]

String[] split(String str, String separatorChars)

---

지정한 문자열(separatorChars) 을 기준으로 나눠 문자열 배열 반환

 StringUtils.split(null, *)         = null
 StringUtils.split("", *)           = []
 StringUtils.split("abc def", null) = ["abc", "def"]
 StringUtils.split("abc def", " ")  = ["abc", "def"]
 StringUtils.split("abc  def", " ") = ["abc", "def"]
 StringUtils.split("ab:cd:ef", ":") = ["ab", "cd", "ef"]

String[] split(String str, String separatorChars, int max)

---

지정한 문자열(separatorChars) 을 기준으로 지정한 크기만큼(max) 나눠 문자열 배열 반환

 StringUtils.split(null, *, *)            = null
 StringUtils.split("", *, *)              = []
 StringUtils.split("ab cd ef", null, 0)   = ["ab", "cd", "ef"]
 StringUtils.split("ab   cd ef", null, 0) = ["ab", "cd", "ef"]
 StringUtils.split("ab:cd:ef", ":", 0)    = ["ab", "cd", "ef"]
 StringUtils.split("ab:cd:ef", ":", 2)    = ["ab", "cd:ef"]

String[] splitByCharacterType(String str)

---

문자열을 동일한 문자열(대소문자, 숫자, 기호 등) 기준으로 나눠 문자열 배열 반환

 StringUtils.splitByCharacterType(null)         = null
 StringUtils.splitByCharacterType("")           = []
 StringUtils.splitByCharacterType("ab de fg")   = ["ab", " ", "de", " ", "fg"]
 StringUtils.splitByCharacterType("ab   de fg") = ["ab", "   ", "de", " ", "fg"]
 StringUtils.splitByCharacterType("ab:cd:ef")   = ["ab", ":", "cd", ":", "ef"]
 StringUtils.splitByCharacterType("number5")    = ["number", "5"]
 StringUtils.splitByCharacterType("fooBar")     = ["foo", "B", "ar"]
 StringUtils.splitByCharacterType("foo200Bar")  = ["foo", "200", "B", "ar"]
 StringUtils.splitByCharacterType("ASFRules")   = ["ASFR", "ules"]

String[] splitByCharacterTypeCamelCase(String str)

---

문자열을 동일한 문자열(숫자, 기호 등) 기준으로 나눠 문자열 배열 반환 (대소문자 동일)

 StringUtils.splitByCharacterTypeCamelCase(null)         = null
 StringUtils.splitByCharacterTypeCamelCase("")           = []
 StringUtils.splitByCharacterTypeCamelCase("ab de fg")   = ["ab", " ", "de", " ", "fg"]
 StringUtils.splitByCharacterTypeCamelCase("ab   de fg") = ["ab", "   ", "de", " ", "fg"]
 StringUtils.splitByCharacterTypeCamelCase("ab:cd:ef")   = ["ab", ":", "cd", ":", "ef"]
 StringUtils.splitByCharacterTypeCamelCase("number5")    = ["number", "5"]
 StringUtils.splitByCharacterTypeCamelCase("fooBar")     = ["foo", "Bar"]
 StringUtils.splitByCharacterTypeCamelCase("foo200Bar")  = ["foo", "200", "Bar"]
 StringUtils.splitByCharacterTypeCamelCase("ASFRules")   = ["ASF", "Rules"]

String[] splitByWholeSeparator(String str, String separator)

---

지정한 문자열(separatorChars) 을 기준으로 나눠 문자열 배열 반환

 StringUtils.splitByWholeSeparator(null, *)               = null
 StringUtils.splitByWholeSeparator("", *)                 = []
 StringUtils.splitByWholeSeparator("ab de fg", null)      = ["ab", "de", "fg"]
 StringUtils.splitByWholeSeparator("ab   de fg", null)    = ["ab", "de", "fg"]
 StringUtils.splitByWholeSeparator("ab:cd:ef", ":")       = ["ab", "cd", "ef"]
 StringUtils.splitByWholeSeparator("ab-!-cd-!-ef", "-!-") = ["ab", "cd", "ef"]

String[] splitByWholeSeparator(String str, String separator, int max)

---

지정한 문자열(separatorChars) 을 기준으로 지정한 크기만큼(max) 나눠 문자열 배열 반환

 StringUtils.splitByWholeSeparator(null, *, *)               = null
 StringUtils.splitByWholeSeparator("", *, *)                 = []
 StringUtils.splitByWholeSeparator("ab de fg", null, 0)      = ["ab", "de", "fg"]
 StringUtils.splitByWholeSeparator("ab   de fg", null, 0)    = ["ab", "de", "fg"]
 StringUtils.splitByWholeSeparator("ab:cd:ef", ":", 2)       = ["ab", "cd:ef"]
 StringUtils.splitByWholeSeparator("ab-!-cd-!-ef", "-!-", 5) = ["ab", "cd", "ef"]
 StringUtils.splitByWholeSeparator("ab-!-cd-!-ef", "-!-", 2) = ["ab", "cd-!-ef"]

String[] splitByWholeSeparatorPreserveAllTokens(String str, String separator)

---

지정한 문자열(separatorChars) 을 기준으로 나눠 문자열 배열 반환

 StringUtils.splitByWholeSeparatorPreserveAllTokens(null, *)               = null
 StringUtils.splitByWholeSeparatorPreserveAllTokens("", *)                 = []
 StringUtils.splitByWholeSeparatorPreserveAllTokens("ab de fg", null)      = ["ab", "de", "fg"]
 StringUtils.splitByWholeSeparatorPreserveAllTokens("ab   de fg", null)    = ["ab", "", "", "de", "fg"]
 StringUtils.splitByWholeSeparatorPreserveAllTokens("ab:cd:ef", ":")       = ["ab", "cd", "ef"]
 StringUtils.splitByWholeSeparatorPreserveAllTokens("ab-!-cd-!-ef", "-!-") = ["ab", "cd", "ef"]

String[] splitByWholeSeparatorPreserveAllTokens(String str, String separator, int max)

---

지정한 문자열(separatorChars) 을 기준으로 지정한 크기만큼(max) 나눠 문자열 배열 반환

 StringUtils.splitByWholeSeparatorPreserveAllTokens(null, *, *)               = null
 StringUtils.splitByWholeSeparatorPreserveAllTokens("", *, *)                 = []
 StringUtils.splitByWholeSeparatorPreserveAllTokens("ab de fg", null, 0)      = ["ab", "de", "fg"]
 StringUtils.splitByWholeSeparatorPreserveAllTokens("ab   de fg", null, 0)    = ["ab", "", "", "de", "fg"]
 StringUtils.splitByWholeSeparatorPreserveAllTokens("ab:cd:ef", ":", 2)       = ["ab", "cd:ef"]
 StringUtils.splitByWholeSeparatorPreserveAllTokens("ab-!-cd-!-ef", "-!-", 5) = ["ab", "cd", "ef"]
 StringUtils.splitByWholeSeparatorPreserveAllTokens("ab-!-cd-!-ef", "-!-", 2) = ["ab", "cd-!-ef"]

String[] splitPreserveAllTokens(String str)

---

문자열의 공백을 기준으로 나눠 문자열 배열 반환

 StringUtils.splitPreserveAllTokens(null)       = null
 StringUtils.splitPreserveAllTokens("")         = []
 StringUtils.splitPreserveAllTokens("abc def")  = ["abc", "def"]
 StringUtils.splitPreserveAllTokens("abc  def") = ["abc", "", "def"]
 StringUtils.splitPreserveAllTokens(" abc ")    = ["", "abc", ""]

String[] splitPreserveAllTokens(String str, char separatorChar)

---

지정한 글자(separatorChar) 를 기준으로 나눠 문자열 배열 반환

 StringUtils.splitPreserveAllTokens(null, *)         = null
 StringUtils.splitPreserveAllTokens("", *)           = []
 StringUtils.splitPreserveAllTokens("a.b.c", '.')    = ["a", "b", "c"]
 StringUtils.splitPreserveAllTokens("a..b.c", '.')   = ["a", "", "b", "c"]
 StringUtils.splitPreserveAllTokens("a:b:c", '.')    = ["a:b:c"]
 StringUtils.splitPreserveAllTokens("a\tb\nc", null) = ["a", "b", "c"]
 StringUtils.splitPreserveAllTokens("a b c", ' ')    = ["a", "b", "c"]
 StringUtils.splitPreserveAllTokens("a b c ", ' ')   = ["a", "b", "c", ""]
 StringUtils.splitPreserveAllTokens("a b c  ", ' ')   = ["a", "b", "c", "", ""]
 StringUtils.splitPreserveAllTokens(" a b c", ' ')   = ["", a", "b", "c"]
 StringUtils.splitPreserveAllTokens("  a b c", ' ')  = ["", "", a", "b", "c"]
 StringUtils.splitPreserveAllTokens(" a b c ", ' ')  = ["", a", "b", "c", ""]

String[] splitPreserveAllTokens(String str, String separatorChars)

---

지정한 문자열(separatorChar) 을 기준으로 나눠 문자열 배열 반환

 StringUtils.splitPreserveAllTokens(null, *)           = null
 StringUtils.splitPreserveAllTokens("", *)             = []
 StringUtils.splitPreserveAllTokens("abc def", null)   = ["abc", "def"]
 StringUtils.splitPreserveAllTokens("abc def", " ")    = ["abc", "def"]
 StringUtils.splitPreserveAllTokens("abc  def", " ")   = ["abc", "", def"]
 StringUtils.splitPreserveAllTokens("ab:cd:ef", ":")   = ["ab", "cd", "ef"]
 StringUtils.splitPreserveAllTokens("ab:cd:ef:", ":")  = ["ab", "cd", "ef", ""]
 StringUtils.splitPreserveAllTokens("ab:cd:ef::", ":") = ["ab", "cd", "ef", "", ""]
 StringUtils.splitPreserveAllTokens("ab::cd:ef", ":")  = ["ab", "", cd", "ef"]
 StringUtils.splitPreserveAllTokens(":cd:ef", ":")     = ["", cd", "ef"]
 StringUtils.splitPreserveAllTokens("::cd:ef", ":")    = ["", "", cd", "ef"]
 StringUtils.splitPreserveAllTokens(":cd:ef:", ":")    = ["", cd", "ef", ""]

String[] splitPreserveAllTokens(String str, String separatorChars, int max)

---

 StringUtils.splitPreserveAllTokens(null, *, *)            = null
 StringUtils.splitPreserveAllTokens("", *, *)              = []
 StringUtils.splitPreserveAllTokens("ab de fg", null, 0)   = ["ab", "cd", "ef"]
 StringUtils.splitPreserveAllTokens("ab   de fg", null, 0) = ["ab", "cd", "ef"]
 StringUtils.splitPreserveAllTokens("ab:cd:ef", ":", 0)    = ["ab", "cd", "ef"]
 StringUtils.splitPreserveAllTokens("ab:cd:ef", ":", 2)    = ["ab", "cd:ef"]
 StringUtils.splitPreserveAllTokens("ab   de fg", null, 2) = ["ab", "  de fg"]
 StringUtils.splitPreserveAllTokens("ab   de fg", null, 3) = ["ab", "", " de fg"]
 StringUtils.splitPreserveAllTokens("ab   de fg", null, 4) = ["ab", "", "", "de fg"]

boolean startsWith(CharSequence str, CharSequence prefix)

---

문자열이 시작 문자열(prefix) 로 시작하는지 확인

 StringUtils.startsWith(null, null)      = true
 StringUtils.startsWith(null, "abc")     = false
 StringUtils.startsWith("abcdef", null)  = false
 StringUtils.startsWith("abcdef", "abc") = true
 StringUtils.startsWith("ABCDEF", "abc") = false

boolean startsWithAny(CharSequence sequence, CharSequence... searchStrings)

---

문자열이 시작 문자열(prefix) 로 시작하는지 확인 (시작 문자열이 열러가지가 될 수 있음)

 StringUtils.startsWithAny(null, null)      = false
 StringUtils.startsWithAny(null, new String[] {"abc"})  = false
 StringUtils.startsWithAny("abcxyz", null)     = false
 StringUtils.startsWithAny("abcxyz", new String[] {""}) = true
 StringUtils.startsWithAny("abcxyz", new String[] {"abc"}) = true
 StringUtils.startsWithAny("abcxyz", new String[] {null, "xyz", "abc"}) = true
 StringUtils.startsWithAny("abcxyz", null, "xyz", "ABCX") = false
 StringUtils.startsWithAny("ABCXYZ", null, "xyz", "abc") = false

boolean startsWithIgnoreCase(CharSequence str, CharSequence prefix)

---

문자열이 시작 문자열(prefix) 로 시작하는지 확인 (대소문자 구별 안함)

 StringUtils.startsWithIgnoreCase(null, null)      = true
 StringUtils.startsWithIgnoreCase(null, "abc")     = false
 StringUtils.startsWithIgnoreCase("abcdef", null)  = false
 StringUtils.startsWithIgnoreCase("abcdef", "abc") = true
 StringUtils.startsWithIgnoreCase("ABCDEF", "abc") = true

String strip(String str)

---

문자열의 앞, 뒤 공백 제거

 StringUtils.strip(null)     = null
 StringUtils.strip("")       = ""
 StringUtils.strip("   ")    = ""
 StringUtils.strip("abc")    = "abc"
 StringUtils.strip("  abc")  = "abc"
 StringUtils.strip("abc  ")  = "abc"
 StringUtils.strip(" abc ")  = "abc"
 StringUtils.strip(" ab c ") = "ab c"

String strip(String str, String stripChars)

---

문자열에 지정한 문자열(stripChars) 을 앞, 뒤로 제거

 StringUtils.strip(null, *)          = null
 StringUtils.strip("", *)            = ""
 StringUtils.strip("abc", null)      = "abc"
 StringUtils.strip("  abc", null)    = "abc"
 StringUtils.strip("abc  ", null)    = "abc"
 StringUtils.strip(" abc ", null)    = "abc"
 StringUtils.strip("  abcyx", "xyz") = "  abc"

String stripAccents(String input)

---

문자열의 악센트(accent) 제거

 StringUtils.stripAccents(null)                = null
 StringUtils.stripAccents("")                  = ""
 StringUtils.stripAccents("control")           = "control"
 StringUtils.stripAccents("éclair")     = "eclair"

String[] stripAll(String... strs)

---

문자열의 앞, 뒤 공백 제거 후 문자열 배열로 반환

 StringUtils.stripAll(null)             = null
 StringUtils.stripAll([])               = []
 StringUtils.stripAll(["abc", "  abc"]) = ["abc", "abc"]
 StringUtils.stripAll(["abc  ", null])  = ["abc", null]

String[] stripAll(String[] strs, String stripChars)

---

문자열에 지정한 문자열(stripChars) 을 앞, 뒤로 제거 후 문자열 배열로 반환

 StringUtils.stripAll(null, *)                = null
 StringUtils.stripAll([], *)                  = []
 StringUtils.stripAll(["abc", "  abc"], null) = ["abc", "abc"]
 StringUtils.stripAll(["abc  ", null], null)  = ["abc", null]
 StringUtils.stripAll(["abc  ", null], "yz")  = ["abc  ", null]
 StringUtils.stripAll(["yabcz", null], "yz")  = ["abc", null]

String stripEnd(String str, String stripChars)

---

문자열에 지정한 문자열(stripChars) 을 뒤에만 제거

 StringUtils.stripEnd(null, *)          = null
 StringUtils.stripEnd("", *)            = ""
 StringUtils.stripEnd("abc", "")        = "abc"
 StringUtils.stripEnd("abc", null)      = "abc"
 StringUtils.stripEnd("  abc", null)    = "  abc"
 StringUtils.stripEnd("abc  ", null)    = "abc"
 StringUtils.stripEnd(" abc ", null)    = " abc"
 StringUtils.stripEnd("  abcyx", "xyz") = "  abc"
 StringUtils.stripEnd("120.00", ".0")   = "12"

String stripStart(String str, String stripChars)

---

문자열에 지정한 문자열(stripChars) 을 앞에만 제거

 StringUtils.stripStart(null, *)          = null
 StringUtils.stripStart("", *)            = ""
 StringUtils.stripStart("abc", "")        = "abc"
 StringUtils.stripStart("abc", null)      = "abc"
 StringUtils.stripStart("  abc", null)    = "abc"
 StringUtils.stripStart("abc  ", null)    = "abc  "
 StringUtils.stripStart(" abc ", null)    = "abc "
 StringUtils.stripStart("yxabc  ", "xyz") = "abc  "

String stripToEmpty(String str)

---

문자열의 앞, 뒤 공백 제거 (null, "", " " 입력 시 "" 반환)

 StringUtils.stripToEmpty(null)     = ""
 StringUtils.stripToEmpty("")       = ""
 StringUtils.stripToEmpty("   ")    = ""
 StringUtils.stripToEmpty("abc")    = "abc"
 StringUtils.stripToEmpty("  abc")  = "abc"
 StringUtils.stripToEmpty("abc  ")  = "abc"
 StringUtils.stripToEmpty(" abc ")  = "abc"
 StringUtils.stripToEmpty(" ab c ") = "ab c"

String stripToNull(String str)

---

문자열의 앞, 뒤 공백 제거 (null, "", " " 입력 시 null 반환)

 StringUtils.stripToNull(null)     = null
 StringUtils.stripToNull("")       = null
 StringUtils.stripToNull("   ")    = null
 StringUtils.stripToNull("abc")    = "abc"
 StringUtils.stripToNull("  abc")  = "abc"
 StringUtils.stripToNull("abc  ")  = "abc"
 StringUtils.stripToNull(" abc ")  = "abc"
 StringUtils.stripToNull(" ab c ") = "ab c"

String substring(String str, int start)

---

시작 위치(start) 부터 문자열 반환

 StringUtils.substring(null, *)   = null
 StringUtils.substring("", *)     = ""
 StringUtils.substring("abc", 0)  = "abc"
 StringUtils.substring("abc", 2)  = "c"
 StringUtils.substring("abc", 4)  = ""
 StringUtils.substring("abc", -2) = "bc"
 StringUtils.substring("abc", -4) = "abc"

String substring(String str, int start, int end)

---

시작위치(start) 부터 끝 위치(end) 까지 문자열 반환

 StringUtils.substring(null, *, *)    = null
 StringUtils.substring("", * ,  *)    = "";
 StringUtils.substring("abc", 0, 2)   = "ab"
 StringUtils.substring("abc", 2, 0)   = ""
 StringUtils.substring("abc", 2, 4)   = "c"
 StringUtils.substring("abc", 4, 6)   = ""
 StringUtils.substring("abc", 2, 2)   = ""
 StringUtils.substring("abc", -2, -1) = "b"
 StringUtils.substring("abc", -4, 2)  = "ab"

String substringAfter(String str, String separator)

---

구분자(separator) 다음 문자열 반환

 StringUtils.substringAfter(null, *)      = null
 StringUtils.substringAfter("", *)        = ""
 StringUtils.substringAfter(*, null)      = ""
 StringUtils.substringAfter("abc", "a")   = "bc"
 StringUtils.substringAfter("abcba", "b") = "cba"
 StringUtils.substringAfter("abc", "c")   = ""
 StringUtils.substringAfter("abc", "d")   = ""
 StringUtils.substringAfter("abc", "")    = "abc"

String substringAfterLast(String str, String separator)

---

끝에서부터 구분자(separator) 다음 문자열 반환

 StringUtils.substringAfterLast(null, *)      = null
 StringUtils.substringAfterLast("", *)        = ""
 StringUtils.substringAfterLast(*, "")        = ""
 StringUtils.substringAfterLast(*, null)      = ""
 StringUtils.substringAfterLast("abc", "a")   = "bc"
 StringUtils.substringAfterLast("abcba", "b") = "a"
 StringUtils.substringAfterLast("abc", "c")   = ""
 StringUtils.substringAfterLast("a", "a")     = ""
 StringUtils.substringAfterLast("a", "z")     = ""

String substringBefore(String str, String separator)

---

구분자(separator) 이전 문자열 반환

 StringUtils.substringBefore(null, *)      = null
 StringUtils.substringBefore("", *)        = ""
 StringUtils.substringBefore("abc", "a")   = ""
 StringUtils.substringBefore("abcba", "b") = "a"
 StringUtils.substringBefore("abc", "c")   = "ab"
 StringUtils.substringBefore("abc", "d")   = "abc"
 StringUtils.substringBefore("abc", "")    = ""
 StringUtils.substringBefore("abc", null)  = "abc"

String substringBeforeLast(String str, String separator)

---

끝에서부터 구분자(separator) 이전 문자열 반환

 StringUtils.substringBeforeLast(null, *)      = null
 StringUtils.substringBeforeLast("", *)        = ""
 StringUtils.substringBeforeLast("abcba", "b") = "abc"
 StringUtils.substringBeforeLast("abc", "c")   = "ab"
 StringUtils.substringBeforeLast("a", "a")     = ""
 StringUtils.substringBeforeLast("a", "z")     = "a"
 StringUtils.substringBeforeLast("a", null)    = "a"
 StringUtils.substringBeforeLast("a", "")      = "a"

String substringBetween(String str, String tag)

---

지정 문자열(tag) 사이 문자열 반환

 StringUtils.substringBetween(null, *)            = null
 StringUtils.substringBetween("", "")             = ""
 StringUtils.substringBetween("", "tag")          = null
 StringUtils.substringBetween("tagabctag", null)  = null
 StringUtils.substringBetween("tagabctag", "")    = ""
 StringUtils.substringBetween("tagabctag", "tag") = "abc"

String substringBetween(String str, String open, String close)

---

시작 문자열(open) 과 끝 문자열(close) 사이 문자열 반환

 StringUtils.substringBetween("wx[b]yz", "[", "]") = "b"
 StringUtils.substringBetween(null, *, *)          = null
 StringUtils.substringBetween(*, null, *)          = null
 StringUtils.substringBetween(*, *, null)          = null
 StringUtils.substringBetween("", "", "")          = ""
 StringUtils.substringBetween("", "", "]")         = null
 StringUtils.substringBetween("", "[", "]")        = null
 StringUtils.substringBetween("yabcz", "", "")     = ""
 StringUtils.substringBetween("yabcz", "y", "z")   = "abc"
 StringUtils.substringBetween("yabczyabcz", "y", "z")   = "abc"

String[] substringsBetween(String str, String open, String close)

---

시작 문자열(open) 과 끝 문자열(close) 사이 문자열을 문자열 배열로 반환

 StringUtils.substringsBetween("[a][b][c]", "[", "]") = ["a","b","c"]
 StringUtils.substringsBetween(null, *, *)            = null
 StringUtils.substringsBetween(*, null, *)            = null
 StringUtils.substringsBetween(*, *, null)            = null
 StringUtils.substringsBetween("", "[", "]")          = []

String swapCase(String str)

---

문자열의 대문자를 소문자로, 소문자는 대문자로 변경하여 반환

 StringUtils.swapCase(null)                 = null
 StringUtils.swapCase("")                   = ""
 StringUtils.swapCase("The dog has a BONE") = "tHE DOG HAS A bone"

int[] toCodePoints(CharSequence str)

---

문자열을 code points 배열로 반환

 StringUtils.toCodePoints(null)   =  null
 StringUtils.toCodePoints("")     =  []  // empty array

String toEncodedString(byte[] bytes, Charset charset)

---

byte 배열을 지정한 charset 으로 encoding 후 반환

String trim(String str)

---

문자열의 앞, 뒤 공백 제거

 StringUtils.trim(null)          = null
 StringUtils.trim("")            = ""
 StringUtils.trim("     ")       = ""
 StringUtils.trim("abc")         = "abc"
 StringUtils.trim("    abc    ") = "abc"

String trimToEmpty(String str)

---

문자열의 앞, 뒤 공백 제거 (null, "", " " 입력 시 "" 반환)

 StringUtils.trimToEmpty(null)          = ""
 StringUtils.trimToEmpty("")            = ""
 StringUtils.trimToEmpty("     ")       = ""
 StringUtils.trimToEmpty("abc")         = "abc"
 StringUtils.trimToEmpty("    abc    ") = "abc"

String trimToNull(String str)

---

 StringUtils.trimToNull(null)          = null
 StringUtils.trimToNull("")            = null
 StringUtils.trimToNull("     ")       = null
 StringUtils.trimToNull("abc")         = "abc"
 StringUtils.trimToNull("    abc    ") = "abc"

String truncate(String str, int maxWidth)

---

지정한 길이(maxWith) 만큼 문자열 자름

 StringUtils.truncate(null, 0)       = null
 StringUtils.truncate(null, 2)       = null
 StringUtils.truncate("", 4)         = ""
 StringUtils.truncate("abcdefg", 4)  = "abcd"
 StringUtils.truncate("abcdefg", 6)  = "abcdef"
 StringUtils.truncate("abcdefg", 7)  = "abcdefg"
 StringUtils.truncate("abcdefg", 8)  = "abcdefg"
 StringUtils.truncate("abcdefg", -1) = throws an IllegalArgumentException

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

---

지정한 위치(offset) 에서 부터 길이(maxWith) 만큼 문자열 자름

 StringUtils.truncate(null, 0, 0) = null
 StringUtils.truncate(null, 2, 4) = null
 StringUtils.truncate("", 0, 10) = ""
 StringUtils.truncate("", 2, 10) = ""
 StringUtils.truncate("abcdefghij", 0, 3) = "abc"
 StringUtils.truncate("abcdefghij", 5, 6) = "fghij"
 StringUtils.truncate("raspberry peach", 10, 15) = "peach"
 StringUtils.truncate("abcdefghijklmno", 0, 10) = "abcdefghij"
 StringUtils.truncate("abcdefghijklmno", -1, 10) = throws an IllegalArgumentException
 StringUtils.truncate("abcdefghijklmno", Integer.MIN_VALUE, 10) = "abcdefghij"
 StringUtils.truncate("abcdefghijklmno", Integer.MIN_VALUE, Integer.MAX_VALUE) = "abcdefghijklmno"
 StringUtils.truncate("abcdefghijklmno", 0, Integer.MAX_VALUE) = "abcdefghijklmno"
 StringUtils.truncate("abcdefghijklmno", 1, 10) = "bcdefghijk"
 StringUtils.truncate("abcdefghijklmno", 2, 10) = "cdefghijkl"
 StringUtils.truncate("abcdefghijklmno", 3, 10) = "defghijklm"
 StringUtils.truncate("abcdefghijklmno", 4, 10) = "efghijklmn"
 StringUtils.truncate("abcdefghijklmno", 5, 10) = "fghijklmno"
 StringUtils.truncate("abcdefghijklmno", 5, 5) = "fghij"
 StringUtils.truncate("abcdefghijklmno", 5, 3) = "fgh"
 StringUtils.truncate("abcdefghijklmno", 10, 3) = "klm"
 StringUtils.truncate("abcdefghijklmno", 10, Integer.MAX_VALUE) = "klmno"
 StringUtils.truncate("abcdefghijklmno", 13, 1) = "n"
 StringUtils.truncate("abcdefghijklmno", 13, Integer.MAX_VALUE) = "no"
 StringUtils.truncate("abcdefghijklmno", 14, 1) = "o"
 StringUtils.truncate("abcdefghijklmno", 14, Integer.MAX_VALUE) = "o"
 StringUtils.truncate("abcdefghijklmno", 15, 1) = ""
 StringUtils.truncate("abcdefghijklmno", 15, Integer.MAX_VALUE) = ""
 StringUtils.truncate("abcdefghijklmno", Integer.MAX_VALUE, Integer.MAX_VALUE) = ""
 StringUtils.truncate("abcdefghij", 3, -1) = throws an IllegalArgumentException
 StringUtils.truncate("abcdefghij", -2, 4) = throws an IllegalArgumentException

String uncapitalize(String str)

---

첫 글자가 대문자인 경우 소문자로 변환

 StringUtils.uncapitalize(null)  = null
 StringUtils.uncapitalize("")    = ""
 StringUtils.uncapitalize("cat") = "cat"
 StringUtils.uncapitalize("Cat") = "cat"
 StringUtils.uncapitalize("CAT") = "cAT"

String unwrap(String str, char wrapChar)

---

문자열에 지정한 글자(wrapChar) 로 감싸진 부분이 있다면 해당 부분을 풀어서 반환

 StringUtils.unwrap(null, null)         = null
 StringUtils.unwrap(null, '\0')         = null
 StringUtils.unwrap(null, '1')          = null
 StringUtils.unwrap("\'abc\'", '\'')    = "abc"
 StringUtils.unwrap("AABabcBAA", 'A')  = "ABabcBA"
 StringUtils.unwrap("A", '#')           = "A"
 StringUtils.unwrap("#A", '#')          = "#A"
 StringUtils.unwrap("A#", '#')          = "A#"

String unwrap(String str, String wrapToken)

---

문자열에 지정한 문자열(wrapToken) 로 감싸진 부분이 있다면 해당 부분을 풀어서 반환

 StringUtils.unwrap(null, null)         = null
 StringUtils.unwrap(null, "")           = null
 StringUtils.unwrap(null, "1")          = null
 StringUtils.unwrap("\'abc\'", "\'")    = "abc"
 StringUtils.unwrap("\"abc\"", "\"")    = "abc"
 StringUtils.unwrap("AABabcBAA", "AA")  = "BabcB"
 StringUtils.unwrap("A", "#")           = "A"
 StringUtils.unwrap("#A", "#")          = "#A"
 StringUtils.unwrap("A#", "#")          = "A#"

String upperCase(String str)

---

문자열을 대문자로 변환

 StringUtils.upperCase(null)  = null
 StringUtils.upperCase("")    = ""
 StringUtils.upperCase("aBc") = "ABC"

String upperCase(String str, Locale locale)

---

문자열을 대문자로 변환 (Locale 지정)

 StringUtils.upperCase(null, Locale.ENGLISH)  = null
 StringUtils.upperCase("", Locale.ENGLISH)    = ""
 StringUtils.upperCase("aBc", Locale.ENGLISH) = "ABC"