StringUtils (P ~ R)

String prependIfMissing(String str, CharSequence prefix, CharSequence... prefixes)

---

문자열이 접두사(prefix, prefixes) 로 시작하지 않으면 접두사(prefix, prefixes) 추가

 StringUtils.prependIfMissing(null, null) = null
 StringUtils.prependIfMissing("abc", null) = "abc"
 StringUtils.prependIfMissing("", "xyz") = "xyz"
 StringUtils.prependIfMissing("abc", "xyz") = "xyzabc"
 StringUtils.prependIfMissing("xyzabc", "xyz") = "xyzabc"
 StringUtils.prependIfMissing("XYZabc", "xyz") = "xyzXYZabc"

String prependIfMissingIgnoreCase(String str, CharSequence prefix, CharSequence... prefixes)

---

문자열이 접두사(prefix, prefixes) 로 시작하지 않으면 접두사(prefix, prefixes) 추가 (대소문자 구별 안함)

 StringUtils.prependIfMissingIgnoreCase(null, null) = null
 StringUtils.prependIfMissingIgnoreCase("abc", null) = "abc"
 StringUtils.prependIfMissingIgnoreCase("", "xyz") = "xyz"
 StringUtils.prependIfMissingIgnoreCase("abc", "xyz") = "xyzabc"
 StringUtils.prependIfMissingIgnoreCase("xyzabc", "xyz") = "xyzabc"
 StringUtils.prependIfMissingIgnoreCase("XYZabc", "xyz") = "XYZabc"

String remove(String str, char remove)

---

문자열에 제거할 글자(remove) 가 있다면 제거

 StringUtils.remove(null, *)       = null
 StringUtils.remove("", *)         = ""
 StringUtils.remove("queued", 'u') = "qeed"
 StringUtils.remove("queued", 'z') = "queued"

String remove(String str, String remove)

---

문자열에 제거할 문자열(remove) 이 있다면 제거

 StringUtils.remove(null, *)        = null
 StringUtils.remove("", *)          = ""
 StringUtils.remove(*, null)        = *
 StringUtils.remove(*, "")          = *
 StringUtils.remove("queued", "ue") = "qd"
 StringUtils.remove("queued", "zz") = "queued"

String removeEnd(String str, String remove)

---

문자열의 마지막에 제거할 문자열(remove) 이 있다면 제거

 StringUtils.removeEnd(null, *)      = null
 StringUtils.removeEnd("", *)        = ""
 StringUtils.removeEnd(*, null)      = *
 StringUtils.removeEnd("www.domain.com", ".com.")  = "www.domain.com"
 StringUtils.removeEnd("www.domain.com", ".com")   = "www.domain"
 StringUtils.removeEnd("www.domain.com", "domain") = "www.domain.com"
 StringUtils.removeEnd("abc", "")    = "abc"

String removeEndIgnoreCase(String str, String remove)

---

문자열의 마지막에 제거할 문자열(remove) 이 있다면 제거 (대소문자 구별 안함)

 StringUtils.removeEndIgnoreCase(null, *)      = null
 StringUtils.removeEndIgnoreCase("", *)        = ""
 StringUtils.removeEndIgnoreCase(*, null)      = *
 StringUtils.removeEndIgnoreCase("www.domain.com", ".com.")  = "www.domain.com"
 StringUtils.removeEndIgnoreCase("www.domain.com", ".com")   = "www.domain"
 StringUtils.removeEndIgnoreCase("www.domain.com", "domain") = "www.domain.com"
 StringUtils.removeEndIgnoreCase("abc", "")    = "abc"
 StringUtils.removeEndIgnoreCase("www.domain.com", ".COM") = "www.domain")
 StringUtils.removeEndIgnoreCase("www.domain.COM", ".com") = "www.domain")

String removeIgnoreCase(String str, String remove)

---

문자열에 제거할 문자열(remove) 이 있다면 제거 (대소문자 구별 안함)

 StringUtils.removeIgnoreCase(null, *)        = null
 StringUtils.removeIgnoreCase("", *)          = ""
 StringUtils.removeIgnoreCase(*, null)        = *
 StringUtils.removeIgnoreCase(*, "")          = *
 StringUtils.removeIgnoreCase("queued", "ue") = "qd"
 StringUtils.removeIgnoreCase("queued", "zz") = "queued"
 StringUtils.removeIgnoreCase("quEUed", "UE") = "qd"
 StringUtils.removeIgnoreCase("queued", "zZ") = "queued"

String removeStart(String str, String remove)

---

문자열의 첫번째에 제거할 문자열(remove) 이 있다면 제거

 StringUtils.removeStart(null, *)      = null
 StringUtils.removeStart("", *)        = ""
 StringUtils.removeStart(*, null)      = *
 StringUtils.removeStart("www.domain.com", "www.")   = "domain.com"
 StringUtils.removeStart("domain.com", "www.")       = "domain.com"
 StringUtils.removeStart("www.domain.com", "domain") = "www.domain.com"
 StringUtils.removeStart("abc", "")    = "abc"

String removeStartIgnoreCase(String str, String remove)

---

문자열의 첫번째에 제거할 문자열(remove) 이 있다면 제거 (대소문자 구별 안함)

 StringUtils.removeStartIgnoreCase(null, *)      = null
 StringUtils.removeStartIgnoreCase("", *)        = ""
 StringUtils.removeStartIgnoreCase(*, null)      = *
 StringUtils.removeStartIgnoreCase("www.domain.com", "www.")   = "domain.com"
 StringUtils.removeStartIgnoreCase("www.domain.com", "WWW.")   = "domain.com"
 StringUtils.removeStartIgnoreCase("domain.com", "www.")       = "domain.com"
 StringUtils.removeStartIgnoreCase("www.domain.com", "domain") = "www.domain.com"
 StringUtils.removeStartIgnoreCase("abc", "")    = "abc"

String repeat(char ch, int repeat)

---

지정한 횟수(repeat) 만큼 글자(ch) 를 반복하여 반환

 StringUtils.repeat('e', 0)  = ""
 StringUtils.repeat('e', 3)  = "eee"
 StringUtils.repeat('e', -2) = ""

String repeat(String str, int repeat)

---

지정한 횟수(repeat) 만큼 문자열(str) 을 반복하여 반환

 StringUtils.repeat(null, 2) = null
 StringUtils.repeat("", 0)   = ""
 StringUtils.repeat("", 2)   = ""
 StringUtils.repeat("a", 3)  = "aaa"
 StringUtils.repeat("ab", 2) = "abab"
 StringUtils.repeat("a", -2) = ""

String repeat(String str, String separator, int repeat)

---

문자열에 구분자(separator) 를 지정한 횟수(repeat) 만큼 반복하여 반환

 StringUtils.repeat(null, null, 2) = null
 StringUtils.repeat(null, "x", 2)  = null
 StringUtils.repeat("", null, 0)   = ""
 StringUtils.repeat("", "", 2)     = ""
 StringUtils.repeat("", "x", 3)    = "xxx"
 StringUtils.repeat("?", ", ", 3)  = "?, ?, ?"

String replace(String text, String searchString, String replacement)

---

문자열에 찾을 문자열(searchString) 을 대체 문자열(replacement) 로 대체하여 반환

 StringUtils.replace(null, *, *)        = null
 StringUtils.replace("", *, *)          = ""
 StringUtils.replace("any", null, *)    = "any"
 StringUtils.replace("any", *, null)    = "any"
 StringUtils.replace("any", "", *)      = "any"
 StringUtils.replace("aba", "a", null)  = "aba"
 StringUtils.replace("aba", "a", "")    = "b"
 StringUtils.replace("aba", "a", "z")   = "zbz"

String replace(String text, String searchString, String replacement, int max)

---

문자열에 찾을 문자열(searchString) 을 지정 횟수(max) 만큼 대체 문자열(replacement) 로 대체하여 반환

 StringUtils.replace(null, *, *, *)         = null
 StringUtils.replace("", *, *, *)           = ""
 StringUtils.replace("any", null, *, *)     = "any"
 StringUtils.replace("any", *, null, *)     = "any"
 StringUtils.replace("any", "", *, *)       = "any"
 StringUtils.replace("any", *, *, 0)        = "any"
 StringUtils.replace("abaa", "a", null, -1) = "abaa"
 StringUtils.replace("abaa", "a", "", -1)   = "b"
 StringUtils.replace("abaa", "a", "z", 0)   = "abaa"
 StringUtils.replace("abaa", "a", "z", 1)   = "zbaa"
 StringUtils.replace("abaa", "a", "z", 2)   = "zbza"
 StringUtils.replace("abaa", "a", "z", -1)  = "zbzz"

String replaceChars(String str, char searchChar, char replaceChar)

---

문자열에 찾을 글자(searchChar) 를 대체 글자(replaceChar) 로 대체하여 반환

 StringUtils.replaceChars(null, *, *)        = null
 StringUtils.replaceChars("", *, *)          = ""
 StringUtils.replaceChars("abcba", 'b', 'y') = "aycya"
 StringUtils.replaceChars("abcba", 'z', 'y') = "abcba"

String replaceChars(String str, String searchChars, String replaceChars)

---

문자열에 찾을 문자열(searchChars) 을 대체 문자열(replaceChars) 로 대체하여 반환

 StringUtils.replaceChars(null, *, *)           = null
 StringUtils.replaceChars("", *, *)             = ""
 StringUtils.replaceChars("abc", null, *)       = "abc"
 StringUtils.replaceChars("abc", "", *)         = "abc"
 StringUtils.replaceChars("abc", "b", null)     = "ac"
 StringUtils.replaceChars("abc", "b", "")       = "ac"
 StringUtils.replaceChars("abcba", "bc", "yz")  = "ayzya"
 StringUtils.replaceChars("abcba", "bc", "y")   = "ayya"
 StringUtils.replaceChars("abcba", "bc", "yzx") = "ayzya"

String replaceEach(String text, String[] searchList, String[] replacementList)

---

문자열에 찾을 문자열 배열(searchList) 을 대체 문자열 배열(replacementList) 로 대체하여 반환

  StringUtils.replaceEach(null, *, *)        = null
  StringUtils.replaceEach("", *, *)          = ""
  StringUtils.replaceEach("aba", null, null) = "aba"
  StringUtils.replaceEach("aba", new String[0], null) = "aba"
  StringUtils.replaceEach("aba", null, new String[0]) = "aba"
  StringUtils.replaceEach("aba", new String[]{"a"}, null)  = "aba"
  StringUtils.replaceEach("aba", new String[]{"a"}, new String[]{""})  = "b"
  StringUtils.replaceEach("aba", new String[]{null}, new String[]{"a"})  = "aba"
  StringUtils.replaceEach("abcde", new String[]{"ab", "d"}, new String[]{"w", "t"})  = "wcte"
  (example of how it does not repeat)
  StringUtils.replaceEach("abcde", new String[]{"ab", "d"}, new String[]{"d", "t"})  = "dcte"

String replaceEachRepeatedly(String text, String[] searchList, String[] replacementList)

---

문자열에 찾을 문자열 배열(searchList) 을 대체 문자열 배열(replacementList) 로 반복 대체하여 반환

  StringUtils.replaceEachRepeatedly(null, *, *) = null
  StringUtils.replaceEachRepeatedly("", *, *) = ""
  StringUtils.replaceEachRepeatedly("aba", null, null) = "aba"
  StringUtils.replaceEachRepeatedly("aba", new String[0], null) = "aba"
  StringUtils.replaceEachRepeatedly("aba", null, new String[0]) = "aba"
  StringUtils.replaceEachRepeatedly("aba", new String[]{"a"}, null) = "aba"
  StringUtils.replaceEachRepeatedly("aba", new String[]{"a"}, new String[]{""}) = "b"
  StringUtils.replaceEachRepeatedly("aba", new String[]{null}, new String[]{"a"}) = "aba"
  StringUtils.replaceEachRepeatedly("abcde", new String[]{"ab", "d"}, new String[]{"w", "t"}) = "wcte"
  (example of how it repeats)
  StringUtils.replaceEachRepeatedly("abcde", new String[]{"ab", "d"}, new String[]{"d", "t"}) = "tcte"
  StringUtils.replaceEachRepeatedly("abcde", new String[]{"ab", "d"}, new String[]{"d", "ab"}) = IllegalStateException

String replaceIgnoreCase(String text, String searchString, String replacement)

---

문자열에 찾을 문자열(searchString) 을 대체 문자열(replacement) 로 대체하여 반환 (대소문자 구별 안함)

 StringUtils.replaceIgnoreCase(null, *, *)        = null
 StringUtils.replaceIgnoreCase("", *, *)          = ""
 StringUtils.replaceIgnoreCase("any", null, *)    = "any"
 StringUtils.replaceIgnoreCase("any", *, null)    = "any"
 StringUtils.replaceIgnoreCase("any", "", *)      = "any"
 StringUtils.replaceIgnoreCase("aba", "a", null)  = "aba"
 StringUtils.replaceIgnoreCase("abA", "A", "")    = "b"
 StringUtils.replaceIgnoreCase("aba", "A", "z")   = "zbz"

String replaceIgnoreCase(String text, String searchString, String replacement, int max)

---

문자열에 찾을 문자열(searchString) 을 지정 횟수(max) 만큼 대체 문자열(replacement) 로 대체하여 반환 (대소문자 구별 안함)

 StringUtils.replaceIgnoreCase(null, *, *, *)         = null
 StringUtils.replaceIgnoreCase("", *, *, *)           = ""
 StringUtils.replaceIgnoreCase("any", null, *, *)     = "any"
 StringUtils.replaceIgnoreCase("any", *, null, *)     = "any"
 StringUtils.replaceIgnoreCase("any", "", *, *)       = "any"
 StringUtils.replaceIgnoreCase("any", *, *, 0)        = "any"
 StringUtils.replaceIgnoreCase("abaa", "a", null, -1) = "abaa"
 StringUtils.replaceIgnoreCase("abaa", "a", "", -1)   = "b"
 StringUtils.replaceIgnoreCase("abaa", "a", "z", 0)   = "abaa"
 StringUtils.replaceIgnoreCase("abaa", "A", "z", 1)   = "zbaa"
 StringUtils.replaceIgnoreCase("abAa", "a", "z", 2)   = "zbza"
 StringUtils.replaceIgnoreCase("abAa", "a", "z", -1)  = "zbzz"

String replaceOnce(String text, String searchString, String replacement)

---

문자열에 찾을 문자열(searchString) 을 대체 문자열(replacement) 로 한 번만 대체하여 반환

 StringUtils.replaceOnce(null, *, *)        = null
 StringUtils.replaceOnce("", *, *)          = ""
 StringUtils.replaceOnce("any", null, *)    = "any"
 StringUtils.replaceOnce("any", *, null)    = "any"
 StringUtils.replaceOnce("any", "", *)      = "any"
 StringUtils.replaceOnce("aba", "a", null)  = "aba"
 StringUtils.replaceOnce("aba", "a", "")    = "ba"
 StringUtils.replaceOnce("aba", "a", "z")   = "zba"

String replaceOnceIgnoreCase(String text, String searchString, String replacement)

---

문자열에 찾을 문자열(searchString) 을 대체 문자열(replacement) 로 한 번만 대체하여 반환 (대소문자 구별 안함)

 StringUtils.replaceOnceIgnoreCase(null, *, *)        = null
 StringUtils.replaceOnceIgnoreCase("", *, *)          = ""
 StringUtils.replaceOnceIgnoreCase("any", null, *)    = "any"
 StringUtils.replaceOnceIgnoreCase("any", *, null)    = "any"
 StringUtils.replaceOnceIgnoreCase("any", "", *)      = "any"
 StringUtils.replaceOnceIgnoreCase("aba", "a", null)  = "aba"
 StringUtils.replaceOnceIgnoreCase("aba", "a", "")    = "ba"
 StringUtils.replaceOnceIgnoreCase("aba", "a", "z")   = "zba"
 StringUtils.replaceOnceIgnoreCase("FoOFoofoo", "foo", "") = "Foofoo"

String reverse(String str)

---

문자열을 반대로 반환

 StringUtils.reverse(null)  = null
 StringUtils.reverse("")    = ""
 StringUtils.reverse("bat") = "tab"

String reverseDelimited(String str, char separatorChar)

---

문자열을 구분자(separatorChar) 기준으로 반대로 반환

 StringUtils.reverseDelimited(null, *)      = null
 StringUtils.reverseDelimited("", *)        = ""
 StringUtils.reverseDelimited("a.b.c", 'x') = "a.b.c"
 StringUtils.reverseDelimited("a.b.c", ".") = "c.b.a"

String right(String str, int len)

---

문자열에서 오른쪽 기준으로 지정한 길이(len) 만큼 반환

 StringUtils.right(null, *)    = null
 StringUtils.right(*, -ve)     = ""
 StringUtils.right("", *)      = ""
 StringUtils.right("abc", 0)   = ""
 StringUtils.right("abc", 2)   = "bc"
 StringUtils.right("abc", 4)   = "abc"

String rightPad(String str, int size)

---

문자열에 오늘쪽 기준으로 지정한 크기(size) 만큼 공백 추가

 StringUtils.rightPad(null, *)   = null
 StringUtils.rightPad("", 3)     = "   "
 StringUtils.rightPad("bat", 3)  = "bat"
 StringUtils.rightPad("bat", 5)  = "bat  "
 StringUtils.rightPad("bat", 1)  = "bat"
 StringUtils.rightPad("bat", -1) = "bat"

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

---

문자열에 오늘쪽 기준으로 지정한 크기(size) 만큼 글자(padChar) 추가

 StringUtils.rightPad(null, *, *)     = null
 StringUtils.rightPad("", 3, 'z')     = "zzz"
 StringUtils.rightPad("bat", 3, 'z')  = "bat"
 StringUtils.rightPad("bat", 5, 'z')  = "batzz"
 StringUtils.rightPad("bat", 1, 'z')  = "bat"
 StringUtils.rightPad("bat", -1, 'z') = "bat"

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

---

문자열에 오늘쪽 기준으로 지정한 크기(size) 만큼 문자열(padStr) 추가

 StringUtils.rightPad(null, *, *)      = null
 StringUtils.rightPad("", 3, "z")      = "zzz"
 StringUtils.rightPad("bat", 3, "yz")  = "bat"
 StringUtils.rightPad("bat", 5, "yz")  = "batyz"
 StringUtils.rightPad("bat", 8, "yz")  = "batyzyzy"
 StringUtils.rightPad("bat", 1, "yz")  = "bat"
 StringUtils.rightPad("bat", -1, "yz") = "bat"
 StringUtils.rightPad("bat", 5, null)  = "bat  "
 StringUtils.rightPad("bat", 5, "")    = "bat  "

String rotate(String str, int shift)

---

문자열을 지정한 횟수 만큼 이동

 StringUtils.rotate(null, *)        = null
 StringUtils.rotate("", *)          = ""
 StringUtils.rotate("abcdefg", 0)   = "abcdefg"
 StringUtils.rotate("abcdefg", 2)   = "fgabcde"
 StringUtils.rotate("abcdefg", -2)  = "cdefgab"
 StringUtils.rotate("abcdefg", 7)   = "abcdefg"
 StringUtils.rotate("abcdefg", -7)  = "abcdefg"
 StringUtils.rotate("abcdefg", 9)   = "fgabcde"
 StringUtils.rotate("abcdefg", -9)  = "cdefgab"