====== commons-lang3 ======
<WRAP left notice 80%>
  * description : commons-lang3 와 관련된 내용
  * author      : 주레피
  * email       : dhan@repia.com
  * lastupdate  : 2020-03-24
</WRAP>
<WRAP clear/>

===== MavanRepository =====
<code xml>
<!-- https://mvnrepository.com/artifact/org.apache.commons/commons-lang3 -->
<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-lang3</artifactId>
    <version>3.8</version>
</dependency>
</code>
[[https://mvnrepository.com/artifact/org.apache.commons/commons-lang3/3.8|MVN Repository]]

===== StringEscapeUtils =====
<do 2020-05-31 천호동밤안개, >StringEscapeUtils</do>



===== StringUtils =====
>StringUtils.abbreviate (문자열, 표시할 문자 수) 
긴 문자열을 원하는 만큼만 보여주고 나머지는 말줄임표로 생략해준다.\\
표시할 문자 수는 4 이상이어야 한다.\\
표시할 문자 수는 자동으로 붙는 말줄임표 ... (3자) 를 포함한 수이다.
<code java>
String abbreviate = StringUtils.abbreviate("ShowMeTheMoney", 7); 
System.out.println(abbreviate); 
//출력결과 : Show... 
</code>
\\
>StringUtils.appendIfMissing (문자열, 추가할단어, 마지막단어)
문자열의 마지막단어가 지정한 문자와 다를경우, 추가할단어를 붙여준다.
<code java>
String appendIfMissing1 = StringUtils.appendIfMissing("ShowMeTheMoney", "-From.Choi", "Money"); 
System.out.println(appendIfMissing1); 
//출력결과 : ShowMeTheMoney 

String appendIfMissing2 = StringUtils.appendIfMissing("ShowMeTheMoney", "-From.Choi", "test"); 
System.out.println(appendIfMissing2); 
//출력결과 : ShowMeTheMoney-From.Choi 
</code>
\\
>StringUtils.appendIfMissingIgnoreCase (문자열, 추가할단어, 마지막단어)
StringUtils.appendIfMissing 과 같지만 대소문자를 구분하지 않는다.
<code java>
String appendIfMissingIgnoreCase = StringUtils.appendIfMissingIgnoreCase("ShowMeTheMoney", "-From.Choi", "money"); 
System.out.println(appendIfMissingIgnoreCase); 
//출력결과 : ShowMeTheMoney 
</code>
\\
>StringUtils.capitalize (문자열)
문자열의 첫문자를 대문자로 변환한다.
<code java>
String capitalize = StringUtils.capitalize("aaa"); 
System.out.println(capitalize); 
//출력결과 : Aaa 
</code>
\\
>StringUtils.chomp (문자열)
문자열 마지막에 개행문자 \n, \r, \r\n 이 있을 경우 제거한다.
<code java>
String chomp = StringUtils.chomp("sss\n"); 
System.out.println(chomp); 
//출력결과 : sss 
</code>
\\
>StringUtils.chomp (문자열, 제거할문자)
문자열 마지막에 제거할문자가 있을 경우 제거한다.
<code java>
String chomp = StringUtils.chomp("sss#","#"); 
System.out.println(chomp); 
//출력결과 : sss 
</code>
\\
>StringUtils.chop (문자열)
문자열의 마지막 문자 하나를 제거한다.
<code java>
String chop = StringUtils.chop("sss"); 
System.out.println(chop); 
//출력결과 : ss 
</code>
\\
>StringUtils.center (문자열, 글자수)
문자열 글자수를 지정한 글자수와 비교해 부족한 만큼 공백이 추가된다.\\ 
문자열을 중심으로 오른쪽, 왼쪽 번갈아가며 추가된다.
<code java>
String center = StringUtils.center("sss", 5); 
System.out.println("'" + center + "'");
//출력결과 : ' sss '
</code>
\\
>StringUtils.center (문자열, 글자수, 추가단어)
문자열 글자수를 지정한 글자수와 비교해 부족한 만큼 추가단어가 붙는다.\\ 
문자열을 중심으로 오른쪽, 왼쪽 번갈아가며 추가된다.
<code java>
String center = StringUtils.center("sss", 6, "#");
System.out.println(center); 
//출력결과 : #sss##
</code>
\\
>StringUtils.compare (문자열, 비교문자열)
두 문자열을 십진수로 변환 후 두 값의 차(-)를 출력한다.
<code java>
//'가', '나' 의 십진수 변환 값
System.out.println((int) '가'); 
System.out.println((int) '나'); 
//출력결과 : 44032 
//출력결과 : 45208 

int compare1 = StringUtils.compare("가", "나");
System.out.println(compare1);
//출력결과 : -1176
int compare2 = StringUtils.compare("나", "가");
System.out.println(compare2);
//출력결과 : 1176
</code>
\\
>StringUtils.compareIgnoreCase (문자열, 비교문자열)
StringUtils.compare 과 같지만 대소문자를 구분하지 않는다.
<code java>
//'a', 'A' 의 십진수 변환 값
System.out.println((int) 'a');
System.out.println((int) 'A');
//출력결과 : 97
//출력결과 : 65 

int compareIgnoreCase = StringUtils.compareIgnoreCase("A", "a"); 
System.out.println(compareIgnoreCase); 
//출력결과 : 0 
</code>
\\
>StringUtils.contains (문자열, 비교문자열)
문자열안에 비교문자열이 포함되어 있으면 'true'를 반환한다.
<code java>
boolean contains = StringUtils.contains("Hello", "el");
System.out.println(contains);
//출력결과 : true 
</code>
\\
>StringUtils.containsIgnoreCase (문자열, 비교문자열)
StringUtils.contains 과 같지만 대소문자를 구분하지 않는다.
<code java>
boolean containsIgnoreCase = StringUtils.containsIgnoreCase("HELLO", "he");
System.out.println(containsIgnoreCase); 
//출력결과 : true 
</code>
\\
>StringUtils.containsAny (문자열, 비교문자열1, 비교문자열2, ...)
문자열안에 여러개의 비교문자열 중 하나라도 포함되어있으면 'true'를 반환한다.
<code java>
boolean containsAny = StringUtils.containsAny("안녕하세요", "가", "나", "녕"); 
System.out.println(containsAny); 
//출력결과 : true 
</code>
\\
>StringUtils.containsNone (문자열, 비교문자열)
문자열안에 비교문자열의 문자 중 하나라도 포함되어있으면 'false'를 반환한다.
<code java>
boolean containsNone = StringUtils.containsNone("hello", "h"); 
System.out.println(containsNone); 
//출력결과 : false 

boolean containsNone = StringUtils.containsNone("hello", "aaah"); 
System.out.println(containsNone); 
//출력결과 : false 
</code>
\\
>StringUtils.containsOnly (문자열, 비교문자열)
문자열안에 비교문자열이 모두 포함되어있을때만 'true'를 반환한다.
<code java>
boolean containsOnly = StringUtils.containsOnly("hello", "olleh");
System.out.println(containsOnly);
//출력결과 : true

boolean containsOnly2 = StringUtils.containsOnly("hello", "hell");
System.out.println(containsOnly2);
//출력결과 : false 
</code>
\\
>StringUtils.containsWhitespace (문자열)
문자열안에 공백이 포함되어 있으면 'true'를 반환한다.
<code java>
boolean containsWhitespace = StringUtils.containsWhitespace("안녕 하세요");
System.out.println(containsWhitespace);
//출력결과 : true 
</code>
\\
>StringUtils.countMatches (문자열, 비교문자열)
문자열안에 비교문자열과 같은 문자열이 있으면 1, 없다면 0 을 반환한다.
<code java>
int countMatches = StringUtils.countMatches("ABCD", "A");
System.out.println(countMatches);
//출력결과 : 1 

int countMatches2 = StringUtils.countMatches("ABCD", "AB");
System.out.println(countMatches2);
//출력결과 : 1

int countMatches3 = StringUtils.countMatches("ABCD", "AC");
System.out.println(countMatches3);
//출력결과 : 0
</code>
\\
>StringUtils.defaultIfBlank (문자열, 대체문자열)
문자열이 space(띄어쓰기), 공백, null 로만 이루어져있을 경우 대체문자열을 반환한다.
<code java>
String defaultIfBlank1 = StringUtils.defaultIfBlank(null, "A");
System.out.println(defaultIfBlank1);
//출력결과 : A

String defaultIfBlank2 = StringUtils.defaultIfBlank("", "A");
System.out.println(defaultIfBlank2);
//출력결과 : A

String defaultIfBlank3 = StringUtils.defaultIfBlank("  ", "A");
System.out.println(defaultIfBlank3);
//출력결과 : A
</code>
\\
>StringUtils.defaultIfEmpty (문자열, 대체문자열)
문자열이 공백, null 로만 이루어져있을 경우 대체문자열을 반환한다.
<code java>
String defaultIfEmpty1 = StringUtils.defaultIfEmpty(null, "B");
System.out.println(defaultIfEmpty1);
//출력결과 : B         
               
String defaultIfEmpty2 = StringUtils.defaultIfEmpty("", "B");  
System.out.println(defaultIfEmpty2);  
//출력결과 : B   
                      
String defaultIfEmpty3 = StringUtils.defaultIfEmpty("  ", "B");
System.out.println(defaultIfEmpty3);                           
//출력결과 : 없음
</code>
\\
>StringUtils.defaultString (문자열, 대체문자열)
문자열이 null 로만 이루어져있을 경우 대체문자열을 반환한다.
<code java>
String defaultString1 = StringUtils.defaultString(null, "C"); 
System.out.println(defaultString1);  
//출력결과 : C   
              
String defaultString2 = StringUtils.defaultString("", "C");   
System.out.println(defaultString2);  
//출력결과 : 없음   
                  
String defaultString3 = StringUtils.defaultString("  ", "C"); 
System.out.println(defaultString3);
//출력결과 : 없음                       
</code>
\\
>StringUtils.deleteWhitespace (문자열)
문자열에 공백이 있을 경우 제거한다.
<code java>
String deleteWhitespace = StringUtils.deleteWhitespace("안녕  하세요"); 
System.out.println(deleteWhitespace); 
//출력결과 : 안녕하세요 
</code>
\\
>StringUtils.difference (문자열1, 문자열2)
두 문자열을 비교하여 문자열2에서 다른 문자부터 이후를 전부 반환한다.
<code java>
String difference = StringUtils.difference("레피아입니다.", "레피아랍니다."); 
System.out.println(difference); 
//출력결과 : 랍니다.
</code>
\\
>StringUtils.endsWith (문자열, 비교문자열)
문자열의 마지막 문자와 비교문자열을 비교하여 같다면 'true', 다르면 'false'를 반환한다.
<code java>
boolean endsWith = StringUtils.endsWith("안녕하세요.", "."); 
System.out.println(endsWith); 
//출력결과 : true

boolean endsWith = StringUtils.endsWith("안녕하세요", "."); 
System.out.println(endsWith); 
//출력결과 : false
</code>
\\
>StringUtils.endsWithAny (문자열, 비교문자열1, 비교문자열2, ...)
StringUtils.endsWith 와 같지만 비교문자열을 여러개 쓸 수 있다.\\
여러개의 비교문자열 중 하나라도 문자열의 마지막 문자와 같다면 'true'를 반환한다.
<code java>
boolean endsWithAny = StringUtils.endsWithAny("AAA", "a");
System.out.println(endsWithAny); 
//출력결과 : false 

boolean endsWithAny = StringUtils.endsWithAny("AAA", "a", "A");
System.out.println(endsWithAny); 
//출력결과 : true 
</code>
\\
>StringUtils.endsWithIgnoreCase (문자열, 비교문자열)
StringUtils.endsWith 와 같지만 대소문자를 구분하지 않는다.
<code java>
boolean endsWithIgnoreCase = StringUtils.endsWithIgnoreCase("BBB", "b"); 
System.out.println(endsWithIgnoreCase); 
//출력결과 : true 
</code>
\\
>StringUtils.equals (문자열1, 문자열2)
두 문자열을 비교하여 완전히 같다면 'true'를 반환한다.
<code java>
boolean equals = StringUtils.equals("abcd", "abcd"); 
System.out.println(equals); 
//출력결과 : true 

boolean equals = StringUtils.equals("abcd", "Abcd"); 
System.out.println(equals); 
//출력결과 : false
</code>
\\
>StringUtils.equalsIgnoreCase (문자열, 비교문자열)
StringUtils.equals 와 같지만 대소문자를 구분하지 않는다.
<code java>
boolean equalsIgnoreCase = StringUtils.equalsIgnoreCase("abcd", "Abcd"); 
System.out.println(equalsIgnoreCase);  
//출력결과 : true 
</code>
\\
>StringUtils.equalsAny (문자열, 비교문자열1, 비교문자열2, ...)
StringUtils.equals 와 같지만 비교문자열을 여러개 쓸 수 있다.\\
여러개의 비교문자열 중 하나라도 문자열과 완전히 같다면 'true'를 반환한다.
<code java>
boolean equalsAny = StringUtils.equalsAny("abcd", "a", "ab", "abcd");
System.out.println(equalsAny);
//출력결과 : true 
</code>
\\
>StringUtils.equalsAnyIgnoreCase (문자열, 비교문자열1, 비교문자열2, ...)
StringUtils.equalsAny 와 같지만 대소문자를 구분하지 않는다.
<code java>
boolean equalsAnyIgnoreCase = StringUtils.equalsAnyIgnoreCase("abc", "abcde", "ABC");
System.out.println(equalsAnyIgnoreCase); 
//출력결과 : true
</code>
\\
>StringUtils.firstNonBlank (문자열1, 문자열2, 문자열3, ...)
여러개의 문자열 중 null, 공백, space(띄어쓰기)를 제외한 첫번째 문자열을 반환한다.\\
StringUtils v.3.8 부터 사용할 수 있다.
<code java>
String firstNonBlank = StringUtils.firstNonBlank(null, "", " ", "first", "second"); 
System.out.println(firstNonBlank); 
//출력결과 : first
</code>
\\
>StringUtils.getCommonPrefix (문자열1, 문자열2, 문자열3, ...)
모든 문자열에서 공통된 첫부분을 반환한다.
<code java>
String getCommonPrefix = StringUtils.getCommonPrefix("a", "ab", "abc");
System.out.println(getCommonPrefix); 
//출력결과 : a
</code>
\\
>StringUtils.getDigits (문자열)
문자열에서 숫자만 반환한다.
<code java>
String getDigits = StringUtils.getDigits("123한글English  456"); 
System.out.println(getDigits); 
//출력결과 : 123456 
</code>
\\
>StringUtils.indexOf (문자열, 찾을문자열)
문자열에서 왼쪽부터 찾아서 첫번째로 찾을문자열이 위치한 인덱스를 반환한다.\\
첫번째 문자의 인덱스는 0 이다.\\
문자열에 찾을문자열이 없는 경우 -1 을 반환한다.
<code java>
int indexOf1 = StringUtils.indexOf("abc", "b"); 
System.out.println(indexOf1); 
//출력결과 : 1 

int indexOf2 = StringUtils.indexOf("abc", "z"); 
System.out.println(indexOf2); 
//출력결과 : -1
</code>
\\
>StringUtils.indexOfIgnoreCase (문자열, 찾을문자열) \\
StringUtils.indexOf 와 같지만 대소문자를 구분하지 않는다.
<code java>
int indexOfIgnoreCase = StringUtils.indexOfIgnoreCase("abs", "A"); 
System.out.println(indexOfIgnoreCase); 
//출력결과 : 0 
</code>
\\
>StringUtils.indexOfAny (문자열, 찾을문자열1, 찾을문자열2, ...)
StringUtils.indexOf 와 같지만 찾을문자열을 여러개 쓸 수 있다.
<code java>
int indexOfAny = StringUtils.indexOfAny("안녕하세요", "가", "나", "하", "세");
System.out.println(indexOfAny); 
//출력결과 : 2
</code>
\\
>StringUtils.indexOfAnyBut (문자열, 찾을문자열)
문자열에서 왼쪽부터 찾아서 첫번째로 찾을문자열이 없는 인덱스를 반환한다.\\
첫번째 문자의 인덱스는 0 이다.
<code java>
int indexOfAnyBut = StringUtils.indexOfAnyBut("안녕하세요", "안");
System.out.println(indexOfAnyBut); 
//출력결과 : 1
</code>
\\
>StringUtils.indexOfDifference (문자열1, 문자열2)
두 문자열을 비교해 달라지는 부분의 인덱스를 반환한다.\\
첫번째 문자의 인덱스는 0 이다.
<code java>
int indexOfDifference = StringUtils.indexOfDifference("안녕하세요", "안녕하시오"); 
System.out.println(indexOfDifference); 
//출력결과 : 3 
</code>
\\
===== Ref =====
  * [[https://bigstupid.tistory.com/40|StringUtils]]

{{tag>주레피 eleven stringutils commonslang commonslang3}}