String (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.lang
클래스 String

java.lang.Object 
  java.lang.String

모든 구현된 인터페이스:: Serializable, CharSequence, Comparable <String >

public final class String
extends Object
implements Serializable, Comparable <String >, CharSequence
extends Object
implements Serializable, Comparable <String >, CharSequence

String 클래스는 캐릭터 라인을 나타냅니다. Java 프로그램내의 「abc」등의 리터럴 캐릭터 라인은 모두, 이 클래스의 인스턴스로서 실행됩니다.

캐릭터 라인은 정수입니다. 이 값을 작성한 뒤로 변경은 할 수 없습니다. 캐릭터 라인 버퍼는 가변 캐릭터 라인을 지원 합니다. 캐릭터 라인 객체는 불변이기 때문에 공용할 수 있습니다 . 예를 들어


 String str = "abc";

는 다음과 같습니다.


 char data[] = {'a', 'b', 'c'}; String str = new String(data);

캐릭터 라인이 어떻게 사용될까에 임해서, 또한 예를 나타냅니다.


 System.out.println("abc"); String cde = "cde"; System.out.println("abc" + cde); String c = "abc". substring(2,3); String d = cde.substring(1, 2);

String 클래스에는 캐릭터 라인의 각각의 문자를 테스트하는 메서드나, 캐릭터 라인의 비교, 캐릭터 라인의 검색, 부분 캐릭터 라인의 추출 및 문자를 모두 대문자 또는 소문자로 변환한 캐릭터 라인의 카피 작성등을 실시하는 메서드가 있습니다. 케이스 매핑은, Character 클래스에서 지정되는 Unicode 표준 버전에 근거하고 있습니다.

Java 언어는 캐릭터 라인 연결 연산자 ( + ) 및 그 외의 객체로부터 캐릭터 라인에의 변환에 대한 특별한 지원를 제공합니다. 캐릭터 라인 연결은 StringBuilder (또는 StringBuffer) 클래스와 그 append 메서드를 사용해 구현되고 있습니다. 캐릭터 라인 변환은 Object에 의해 정의된 toString 메서드를 사용해 구현되어 Java 클래스 모두에 의해 상속됩니다. 캐릭터 라인 연결 및 캐릭터 라인 변환에 대한자세한 내용은 Gosling, Joy 및 Steele 에 한 「Java 언어 사양」을 참조하십시오.

외로 지정이 없는 경우, null 인수를 생성자, 또는 이 클래스의 메서드에 건네주면 NullPointerException을 발생시킵니다.

String는 「보조 문자」를 「사로 게이트 페어」로 표현하는 UTF-16 형식의 캐릭터 라인을 나타냅니다 (자세한 것은, Character 클래스의 「Unicode 문자 표현」의 섹션을 참조). char 코드 단위를 참조하는 인덱스치입니다. 따라서, 보조 문자는 String 2개의 위치를 사용합니다.

String 클래스는 Unicode 코드 단위 (char값)를 취급하는 메서드 외에 Unicode 코드 포인트 (문자)를 취급하는 메서드를 제공합니다.

도입된 버전 :: JDK1. 0
관련 항목:: Object.toString(), StringBuffer, StringBuilder, Charset, 직렬화 된 형식

필드 개요
`static Comparator <String >`	`CASE_INSENSITIVE_ORDER` `compareToIgnoreCase`인 경우와 같이 `String` 객체를 순서 붙이는 Comparator 입니다.

생성자 개요
`String ()` 새롭게 생성된 `String` 객체를 초기화해, 비어있는 문자 순서를 나타내도록 합니다.
`String (byte[] bytes)` 플랫폼의 디폴트 캐릭터셋를 사용해, 지정된 바이트 배열을 복호화 하는 것에의해 새로운 `String`를 구축합니다.
`String (byte[] ascii, int hibyte)` 추천하지 않습니다. 이 메서드에서는 바이트로부터 문자에의 변환이 올바르게 행해지지 않습니다. JDK 1. 1 이후에서는 바이트로부터 문자에의 변환에는 인수로서 캐릭터셋의 이름을 취하는 `String` 생성자, 또는 플랫폼의 디폴트 캐릭터셋를 사용하는 `String` 생성자 사용이 추천 됩니다.
`String (byte[] bytes, int offset, int length)` 플랫폼의 디폴트 캐릭터셋를 사용해, 지정된 바이트 부분 배열을 복호화 하는 것에의해 새로운 `String`를 구축합니다.
`String (byte[] ascii, int hibyte, int offset, int count)` 추천하지 않습니다. 이 메서드에서는 바이트로부터 문자에의 변환이 올바르게 행해지지 않습니다. JDK 1. 1 이후에서는 바이트로부터 문자에의 변환에는 인수로서 캐릭터셋의 이름을 취하는 `String` 생성자, 또는 플랫폼의 디폴트 캐릭터셋를 사용하는 `String` 생성자 사용이 추천 됩니다.
`String (byte[] bytes, int offset, int length, String charsetName)` 지정된 캐릭터셋를 사용해, 지정된 바이트 부분 배열을 복호화 하는 것에의해 새로운 `String`를 구축합니다.
`String (byte[] bytes, String charsetName)` 지정된 캐릭터셋를 사용해, 지정된 바이트 배열을 복호화 하는 것에의해 새로운 `String`를 구축합니다.
`String (char[] value)` 새로운 `String`를 할당해, 이것이 문자 배열 인수에 현재 포함되어 있는 문자 순서를 나타내도록 합니다.
`String (char[] value, int offset, int count)` 문자 배열 인수의 부분 배열로부터 되는 문자를 포함한 새로운 `String`를 할당합니다.
`String (int[] codePoints, int offset, int count)` Unicode 코드 포인트 배열 인수의 부분 배열로부터 되는 문자를 포함한 새로운 `String`를 할당합니다.
`String (String original)` 새롭게 생성된 `String` 객체를 초기화해, 인수와 같은 문자 순서를 나타내도록 합니다.
`String (StringBuffer buffer)` 캐릭터 라인 버퍼 인수에 현재 포함되어 있는 캐릭터 라인을 가지는 새로운 캐릭터 라인을 구축합니다.
`String (StringBuilder builder)` 캐릭터 라인 빌더 인수에 현재 포함되어 있는 캐릭터 라인을 가지는 새로운 캐릭터 라인을 할당합니다.

메서드 개요
`char`	`charAt (int index)` 지정된 인덱스 위치에 있는 `char`값을 리턴합니다.
`int`	`codePointAt (int index)` 지정된 인덱스 위치의 문자 (Unicode 코드 포인트)를 리턴합니다.
`int`	`codePointBefore (int index)` 지정된 인덱스의 이전 문자 (Unicode 코드 포인트)를 리턴합니다.
`int`	`codePointCount (int beginIndex, int endIndex)` 이 `String` 지정된 텍스트 범위의 Unicode 코드 포인트의 수를 리턴합니다.
`int`	`compareTo (String anotherString)` 2개의 캐릭터 라인을 사전적으로 비교합니다.
`int`	`compareToIgnoreCase (String str)` 대문자와 소문자의 구별없이, 2개의 캐릭터 라인을 사전적으로 비교합니다.
`String`	`concat (String str)` 지정된 캐릭터 라인을 이 캐릭터 라인의 마지막에 연결합니다.
`boolean`	`contains (CharSequence s)` 이 캐릭터 라인이 지정된 char값 의 순서를 포함한 경우에 한정해 true를 리턴합니다.
`boolean`	`contentEquals (CharSequence cs)` 이 `String`가 지정된 순서와 같은 char값 의 순서를 나타내는 경우에만, `true`가 리턴됩니다 .
`boolean`	`contentEquals (StringBuffer sb)` 이 `String`가 지정된 `StringBuffer`와 같은 문자 순서를 나타내는 경우에만, `true`가 리턴됩니다 .
`static String`	`copyValueOf (char[] data)` 지정된 배열내의 문자 순서를 나타내는 String를 리턴합니다.
`static String`	`copyValueOf (char[] data, int offset, int count)` 지정된 배열내의 문자 순서를 나타내는 String를 리턴합니다.
`boolean`	`endsWith (String suffix)` 이 캐릭터 라인이, 지정된 접미말로 끝날지 어떨지를 판정합니다.
`boolean`	`equals (Object anObject)` 이 캐릭터 라인과 지정된 객체를 비교합니다.
`boolean`	`equalsIgnoreCase (String anotherString)` 이 `String`와 다른 `String`를 비교합니다.
`static String`	`format (Locale l, String format, Object ... args)` 지정된 로케일, 서식 캐릭터 라인 및 인수를 사용해, 포맷된 캐릭터 라인을 리턴합니다.
`static String`	`format (String format, Object ... args)` 지정된 서식의 캐릭터 라인과 인수를 사용해, 서식 첨부 캐릭터 라인을 리턴합니다.
`byte[]`	`getBytes ()` 플랫폼의 디폴트 캐릭터셋를 사용해 이 `String`를 바이트 순서에 encode 해, 결과를 새로운 바이트 배열에 포함합니다.
`void`	`getBytes (int srcBegin, int srcEnd, byte[] dst, int dstBegin)` 추천하지 않습니다. 이 메서드에서는 문자로부터 바이트에의 변환이 올바르게 행해지지 않습니다. JDK 1. 1 에서는 문자로부터 바이트에의 변환에는 플랫폼의 디폴트 캐릭터셋를 사용하는 `getBytes()` 메서드의 사용이 추천 됩니다.
`byte[]`	`getBytes (String charsetName)` 지정된 캐릭터셋를 사용해 이 `String`를 바이트 순서에 encode 해, 결과를 새로운 바이트 배열에 포함합니다.
`void`	`getChars (int srcBegin, int srcEnd, char[] dst, int dstBegin)` 이 캐릭터 라인으로부터, 카피처의 문자 배열에 문자를 카피합니다.
`int`	`hashCode ()` 이 캐릭터 라인의 해시 코드를 리턴합니다.
`int`	`indexOf (int ch)` 이 캐릭터 라인내에서 지정된 문자가 최초로 출현하는 위치의 인덱스를 리턴합니다.
`int`	`indexOf (int ch, int fromIndex)` 이 캐릭터 라인내에서 지정된 인덱스로부터 검색을 개시해, 지정된 문자가 최초로 출현하는 위치의 인덱스를 리턴합니다.
`int`	`indexOf (String str)` 이 캐릭터 라인내에서 지정된 부분 캐릭터 라인이 최초로 출현하는 위치의 인덱스를 리턴합니다.
`int`	`indexOf (String str, int fromIndex)` 지정된 인덱스 이후로 지정된 부분 캐릭터 라인이 이 캐릭터 라인내에서 최초로 출현하는 위치의 인덱스를 리턴합니다.
`String`	`intern ()` 캐릭터 라인 객체의 정 준표현을 리턴합니다.
`int`	`lastIndexOf (int ch)` 이 캐릭터 라인내에서 지정된 문자가 마지막에 출현하는 위치의 인덱스를 리턴합니다.
`int`	`lastIndexOf (int ch, int fromIndex)` 이 캐릭터 라인내에서 지정된 문자가 마지막에 출현하는 위치의 인덱스를 리턴합니다 (검색은 지정된 인덱스로부터 시작되어 선두 방향에 행해진다).
`int`	`lastIndexOf (String str)` 이 캐릭터 라인내에서 지정된 부분 캐릭터 라인이 제일 오른쪽으로 출현하는 위치의 인덱스를 리턴합니다.
`int`	`lastIndexOf (String str, int fromIndex)` 이 캐릭터 라인내에서 지정된 부분 캐릭터 라인이 마지막에 출현하는 위치의 인덱스를 리턴합니다 (검색은 지정된 인덱스로부터 시작되어 선두 방향에 행해진다).
`int`	`length ()` 이 캐릭터 라인의 길이를 리턴합니다.
`boolean`	`matches (String regex)` 이 캐릭터 라인이, 지정된 정규 표현과 일치할지 어떨지를 판정합니다.
`int`	`offsetByCodePoints (int index, int codePointOffset)` `codePointOffset` 코드 포인트에 의해 지정된 `index`로 부터 오프셋(offset)가 설정된, 이 `String` 내의 인덱스를 리턴합니다.
`boolean`	`regionMatches (boolean ignoreCase, int toffset, String other, int ooffset, int len)` 2개의 캐릭터 라인 영역이 동일한지 어떤지를 판정합니다.
`boolean`	`regionMatches (int toffset, String other, int ooffset, int len)` 2개의 캐릭터 라인 영역이 동일한지 어떤지를 판정합니다.
`String`	`replace (char oldChar, char newChar)` 이 캐릭터 라인내에 있는 모든 `oldChar`를 `newChar`에 치환한 결과 생성되는 새로운 캐릭터 라인을 리턴합니다.
`String`	`replace (CharSequence target, CharSequence replacement)` 리터럴 타겟 순서에 일치하는 이 캐릭터 라인의 부분 캐릭터 라인을 지정된 리터럴 치환 순서에 옮겨놓습니다.
`String`	`replaceAll (String regex, String replacement)` 지정된 정규 표현에 일치하는 이 캐릭터 라인의 각 부분 캐릭터 라인에 대해, 지정된 치환을 실행합니다.
`String`	`replaceFirst (String regex, String replacement)` 지정된 정규 표현에 일치하는 이 캐릭터 라인의 최초의 부분 캐릭터 라인에 대해, 지정된 치환을 실행합니다.
`String []`	`split (String regex)` 이 캐릭터 라인을 지정된 regular expression에 일치하는 위치에서 분할합니다.
`String []`	`split (String regex, int limit)` 이 캐릭터 라인을 지정된 정규 표현에 일치하는 위치에서 분할합니다.
`boolean`	`startsWith (String prefix)` 이 캐릭터 라인이, 지정된 접두사로 시작될지 어떨지를 판정합니다.
`boolean`	`startsWith (String prefix, int toffset)` 이 캐릭터 라인의 지정된 인덱스 이후의 부분 캐릭터 라인이, 지정된 접두사로 시작될지 어떨지를 판정합니다.
`CharSequence`	`subSequence (int beginIndex, int endIndex)` 이 순서의 서브 순서인 새로운 문자 순서를 리턴합니다.
`String`	`substring (int beginIndex)` 이 캐릭터 라인의 부분 캐릭터 라인인 새로운 캐릭터 라인을 리턴합니다.
`String`	`substring (int beginIndex, int endIndex)` 이 캐릭터 라인의 부분 캐릭터 라인인 새로운 캐릭터 라인을 리턴합니다.
`char[]`	`toCharArray ()` 이 캐릭터 라인을 새로운 문자 배열로 변환합니다.
`String`	`toLowerCase ()` 디폴트 로케일의 규칙을 사용해, 이 `String` 내의 모든 문자를 소문자로 변환합니다.
`String`	`toLowerCase (Locale locale)` 지정된 `Locale` 규칙을 사용해, 이 `String` 내의 모든 캐릭터 라인을 소문자로 변환합니다.
`String`	`toString ()` 이 객체 (이미 캐릭터 라인이다) 자신이 리턴됩니다 .
`String`	`toUpperCase ()` 디폴트 로케일의 규칙을 사용해, 이 `String` 내의 모든 문자를 대문자로 변환합니다.
`String`	`toUpperCase (Locale locale)` 지정된 `Locale` 규칙을 사용해, 이 `String` 내의 모든 캐릭터 라인을 대문자로 변환합니다.
`String`	`trim ()` 캐릭터 라인의 복사본을 리턴합니다.
`static String`	`valueOf (boolean b)` `boolean`인수의 캐릭터 라인 표현을 리턴합니다.
`static String`	`valueOf (char c)` `char`인수의 캐릭터 라인 표현을 리턴합니다.
`static String`	`valueOf (char[] data)` `char` 배열 인수의 캐릭터 라인 표현을 리턴합니다.
`static String`	`valueOf (char[] data, int offset, int count)` `char` 배열 인수의 특정의 부분 배열의 캐릭터 라인 표현을 리턴합니다.
`static String`	`valueOf (double d)` `double`인수의 캐릭터 라인 표현을 리턴합니다.
`static String`	`valueOf (float f)` `float`인수의 캐릭터 라인 표현을 리턴합니다.
`static String`	`valueOf (int i)` `int`인수의 캐릭터 라인 표현을 리턴합니다.
`static String`	`valueOf (long l)` `long`인수의 캐릭터 라인 표현을 리턴합니다.
`static String`	`valueOf (Object obj)` `Object`인수의 캐릭터 라인 표현을 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드
`clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

필드의 상세

CASE_INSENSITIVE_ORDER

public static final Comparator <String > CASE_INSENSITIVE_ORDER

compareToIgnoreCase인 경우와 같이 String 객체를 순서 붙이는 Comparator 입니다. 이 컴퍼레이터는 직렬화 가능합니다.

이 Comparator는 로케일을 고려하지 않기 때문에 일부의 로케일에서는 올바른 순서에 늘어놓을 수 없는 것이 있습니다. java.text 패키지는 로케일에 의존된 늘어놓고 바꾸고를 실시하기 위해서 「조합 기능」을 제공하고 있습니다.

도입된 버전 :: 1.2
관련 항목:: Collator.compare(String, String)

생성자 상세

String

public String()

새롭게 생성된 String 객체를 초기화해, 비어있는 문자 순서를 나타내도록 합니다. String는 불변이므로 이 생성자를 사용할 필요는 없습니다.

String

public String(String  original)

새롭게 생성된 String 객체를 초기화해, 인수와 같은 문자 순서를 나타내도록 합니다. 즉, 새롭게 작성된 캐릭터 라인은 인수 캐릭터 라인의 카피가 됩니다. String는 불변이므로original 명시적인 카피가 필요하지 않은 한, 이 생성자를 사용할 필요는 없습니다.

파라미터:: original - String

String

public String(char[] value)

새로운 String를 할당해, 이것이 문자 배열 인수에 현재 포함되어 있는 문자 순서를 나타내도록 합니다. 문자 배열의 내용이 복사됩니다. 카피 후에 문자 배열이 변경되어도, 새롭게 작성된 캐릭터 라인에는 영향을 주지 않습니다.

파라미터:: value - 캐릭터 라인의 초기값

String

public String(char[] value,
              int offset,
              int count)

문자 배열 인수의 부분 배열로부터 되는 문자를 포함한 새로운 String를 할당합니다. 인수 offset는 부분 배열의 선두의 문자의 인덱스이며, 인수 count는 부분 배열의 길이를 지정합니다. 부분 배열의 내용이 복사됩니다. 카피 후에 문자 배열이 변경되어도, 새롭게 작성된 캐릭터 라인에는 영향을 주지 않습니다.

파라미터:: value - 캐릭터 라인의 소스인 배열; offset - 초기 오프셋(offset); count - 길이
예외:: IndexOutOfBoundsException - offset 및 count인수 인덱스에 한 캐릭터 라인이 value 배열의 범위외가 되는 경우

String

public String(int[] codePoints,
              int offset,
              int count)

Unicode 코드 포인트 배열 인수의 부분 배열로부터 되는 문자를 포함한 새로운 String를 할당합니다. 인수 offset는 부분 배열의 선두의 코드 포인트의 인덱스이며, 인수 count는 부분 배열의 길이를 지정합니다. 부분 배열의 내용은, char에 변환됩니다. 카피 후에 int 배열이 변경되어도, 새롭게 작성된 캐릭터 라인에는 영향을 주지 않습니다.

파라미터:: codePoints - Unicode 코드 포인트의 소스인 배열; offset - 초기 오프셋(offset); count - 길이
예외:: IllegalArgumentException - codePoints로 무효인 Unicode 코드 포인트가 발견되었을 경우; IndexOutOfBoundsException - offset 및 count인수 인덱스에 한 캐릭터 라인이 codePoints 배열의 범위외가 되는 경우
도입된 버전 :: 1.5

String

@Deprecated 
public String(byte[] ascii,
                         int hibyte,
                         int offset,
                         int count)

추천하지 않습니다. 이 메서드에서는 바이트로부터 문자에의 변환이 올바르게 행해지지 않습니다. JDK 1. 1 이후에서는 바이트로부터 문자에의 변환에는 인수로서 캐릭터셋의 이름을 취하는 String 생성자, 또는 플랫폼의 디폴트 캐릭터셋를 사용하는 String 생성자 사용이 추천 됩니다.

8 비트 정수값 배열의 부분 배열에 의해 구축되는 새로운 String를 할당합니다.

인수 offset는 부분 배열의 선두의 바이트의 인덱스이며, 인수 offset는 부분 배열의 길이를 지정합니다.

부분 배열의 각 byte는 상기 메서드로 지정되는 char에 변환됩니다.

파라미터:: ascii - 캐릭터 라인에 변환되는 바이트; hibyte - 16 비트의 각 Unicode 캐릭터 라인의 상위 8 비트; offset - 초기 오프셋(offset); count - 길이
예외:: IndexOutOfBoundsException - 인수 offset 또는 count이 무효인 경우
관련 항목:: String(byte[], int), String(byte[], int, int, java.lang.String), String(byte[], int, int), String(byte[], java.lang.String), String(byte[])

String

@Deprecated 
public String(byte[] ascii,
                         int hibyte)

8 비트 정수값 의 배열로부터 되는 문자를 가지는 새로운 String를 할당합니다. 그 결과적으로 생성되는 캐릭터 라인의 각각의 문자 c는 아래와 같은 바이트 배열내의 대응하는 요소 b 로부터 구성됩니다.


 c == (char)(((hibyte & 0xff) << 8) | (b & 0xff))

파라미터:: ascii - 캐릭터 라인에 변환되는 바이트; hibyte - 16 비트의 각 Unicode 캐릭터 라인의 상위 8 비트
관련 항목:: String(byte[], int, int, java.lang.String), String(byte[], int, int), String(byte[], java.lang.String), String(byte[])

String

public String(byte[] bytes,
              int offset,
              int length,
              String  charsetName)
       throws UnsupportedEncodingException

지정된 캐릭터셋를 사용해, 지정된 바이트 부분 배열을 복호화 하는 것에의해 새로운 String를 구축합니다. 새로운 String 길이는 캐릭터셋에 의해 변화하기 위해, 부분 배열장과 일치하지 않는 것이 있습니다.

지정된 캐릭터셋로 지정된 바이트가 무효인 경우, 이 생성자 동작은 지정되지 않습니다. 복호화 처리를 보다 강력하게 제어할 필요가 있는 경우, CharsetDecoder 클래스를 사용할 필요가 있습니다.

파라미터:: bytes - 캐릭터 라인에 복호화 되는 바이트; offset - 복호화 되는 선두 바이트의 인덱스; length - 복호화 하는 바이트수; charsetName - 지원하는 charset 이름
예외:: UnsupportedEncodingException - 지정된 캐릭터셋가 지원 되어 있지 않은 경우; IndexOutOfBoundsException - offset 인수와 length 인수의 인덱스 문자가 bytes 배열의 범위외의 경우
도입된 버전 :: JDK1. 1

String

public String(byte[] bytes,
              String  charsetName)
       throws UnsupportedEncodingException

지정된 캐릭터셋를 사용해, 지정된 바이트 배열을 복호화 하는 것에의해 새로운 String를 구축합니다. 새로운 String 길이는 캐릭터셋에 의해 변화하기 위해, 바이트 배열장과 일치하지 않는 것이 있습니다.

파라미터:: bytes - 캐릭터 라인에 복호화 되는 바이트; charsetName - 지원하는 charset 이름
예외:: UnsupportedEncodingException - 지정된 캐릭터셋가 지원 되어 있지 않은 경우
도입된 버전 :: JDK1. 1

String

public String(byte[] bytes,
              int offset,
              int length)

플랫폼의 디폴트 캐릭터셋를 사용해, 지정된 바이트 부분 배열을 복호화 하는 것에의해 새로운 String를 구축합니다. 새로운 String 길이는 캐릭터셋에 의해 변화하기 위해, 부분 배열장과 일치하지 않는 것이 있습니다.

지정된 바이트가 디폴트의 캐릭터셋로 무효인 경우, 이 생성자 동작은 지정되지 않습니다. 복호화 처리를 보다 강력하게 제어할 필요가 있는 경우, CharsetDecoder 클래스를 사용할 필요가 있습니다.

파라미터:: bytes - 캐릭터 라인에 복호화 되는 바이트; offset - 복호화 되는 선두 바이트의 인덱스; length - 복호화 하는 바이트수
예외:: IndexOutOfBoundsException - offset인수와 length인수의 인덱스 문자가 bytes 배열의 범위외의 경우
도입된 버전 :: JDK1. 1

String

public String(byte[] bytes)

플랫폼의 디폴트 캐릭터셋를 사용해, 지정된 바이트 배열을 복호화 하는 것에의해 새로운 String를 구축합니다. 새로운 String 길이는 캐릭터셋에 의해 변화하기 위해, 바이트 배열장과 일치하지 않는 것이 있습니다.

파라미터:: bytes - 캐릭터 라인에 복호화 되는 바이트
도입된 버전 :: JDK1. 1

String

public String(StringBuffer  buffer)

캐릭터 라인 버퍼 인수에 현재 포함되어 있는 캐릭터 라인을 가지는 새로운 캐릭터 라인을 구축합니다. 캐릭터 라인 버퍼의 내용이 복사됩니다. 카피 후에 캐릭터 라인 버퍼가 변경되어도, 새롭게 작성된 캐릭터 라인에는 영향을 주지 않습니다.

파라미터:: buffer - StringBuffer

String

public String(StringBuilder  builder)

캐릭터 라인 빌더 인수에 현재 포함되어 있는 캐릭터 라인을 가지는 새로운 캐릭터 라인을 할당합니다. 캐릭터 라인 빌더 의 내용이 복사됩니다. 카피 후에 캐릭터 라인 빌더가 변경되어도, 새롭게 작성된 캐릭터 라인에는 영향을 주지 않습니다.

이 생성자를 사용하면, StringBuilder로 이행하기 쉬워집니다. toString 메서드를 사용해 캐릭터 라인 빌더 로부터 캐릭터 라인을 얻는 것은 처리가 고속으로 되므로 일반적으로 추천 되고 있습니다.

파라미터:: builder - StringBuilder
도입된 버전 :: 1.5

메서드의 상세

length

public int length()

이 캐릭터 라인의 길이를 리턴합니다. 길이는 캐릭터 라인내의 16 비트 Unicode 문자의 수에 동일해집니다.

정의:: 인터페이스 CharSequence 내의 length

반환값:: 이 객체에 의해 나타내지는 문자 순서의 길이

charAt

public char charAt(int index)

지정된 인덱스 위치에 있는 char값을 리턴합니다. 인덱스는 0 으로부터 length() - 1 범위가 됩니다. 배열의 인덱스부의 경우와 같이, 순서의 최초의 char값의 인덱스는 0, 다음의 문자의 인덱스는 1 으로 계속됩니다.

인덱스로 지정된 char값이 사로 게이트의 경우, 사로 게이트값이 리턴됩니다 .

정의:: 인터페이스 CharSequence 내의 charAt

파라미터:: index - char값의 인덱스
반환값:: 캐릭터 라인내의 지정된 인덱스 위치에 있는 char값. 최초의 char값의 인덱스가 0 이 된다
예외:: IndexOutOfBoundsException - index인수가 잘못된 값, 또는 캐릭터 라인의 길이 이상인 경우

codePointAt

public int codePointAt(int index)

지정된 인덱스 위치의 문자 (Unicode 코드 포인트)를 리턴합니다. 인덱스는 char값 (Unicode 코드 단위)를 참조해, 범위는 0 ~ length() - 1 입니다.

지정된 인덱스로 지정된 char값이 상위 사로 게이트 범위에 있는 경우, 거기에 계속되는 인덱스는 이String 길이 미만입니다. 또, 이후의 인덱스의 char값이 하위 사로 게이트 범위에 있는 경우, 이 사로 게이트 페어에 대응하는 보조 코드 포인트가 리턴됩니다 . 그렇지 않은 경우, 지정된 인덱스에 있는 char값이 리턴됩니다 .

파라미터:: index - char값의 인덱스
반환값:: 지정된 index에 있는 문자의 코드 포인트치
예외:: IndexOutOfBoundsException - index인수가 잘못된 값, 또는 캐릭터 라인의 길이 이상인 경우
도입된 버전 :: 1.5

codePointBefore

public int codePointBefore(int index)

지정된 인덱스의 이전 문자 (Unicode 코드 포인트)를 리턴합니다. 인덱스는 char값 (Unicode 코드 단위)를 참조해, 범위는 1 ~ length 입니다.

(index - 1) 위치의 char값이 하위 사로 게이트의 범위에 있는 경우, (index - 2)가 부가 아닌 경우, (index - 2) 위치의 char값이 상위 사로 게이트의 범위에 있는 경우, 사로 게이트 페어의 보조 코드 포인트값이 리턴됩니다 . index - 1 위치의 char값이 페어로 되어 있지 않은 하위 또는 상위 사로 게이트의 경우, 사로 게이트값이 리턴됩니다 .

파라미터:: index - 리턴된 코드 포인트에 계속되는 인덱스
반환값:: 지정된 인덱스의 전에 있는 Unicode 코드 포인트치
예외:: IndexOutOfBoundsException - index인수가 1 미만인지, 또는 이 캐릭터 라인의 길이보다 큰 값의 경우
도입된 버전 :: 1.5

codePointCount

public int codePointCount(int beginIndex,
                          int endIndex)

이 String 지정된 텍스트 범위의 Unicode 코드 포인트의 수를 리턴합니다. 텍스트 범위는 지정된 beginIndex로 부터 인덱스 endIndex - 1 위치의 char 까지입니다. 따라서, 텍스트 범위의 길이 (char 간)는 endIndex-beginIndex 입니다. 텍스트 범위내에서 페어로 되어 있지 않은 사로 게이트는 각각개의 코드 포인트로서 셀 수 있습니다.

파라미터:: beginIndex - 텍스트 범위내의 최초의 char에 의 인덱스; endIndex - 텍스트 범위내의 마지막 char 뒤의 인덱스
반환값:: 지정된 텍스트 범위내의 Unicode 코드 포인트의 수
예외:: IndexOutOfBoundsException - beginIndex가 잘못된 값 인 경우, endIndex가 이 String 길이보다 큰 경우, 혹은 beginIndex가 endIndex 보다 큰 경우
도입된 버전 :: 1.5

offsetByCodePoints

public int offsetByCodePoints(int index,
                              int codePointOffset)

codePointOffset 코드 포인트에 의해 지정된 index로 부터 오프셋(offset)가 설정된, 이 String 내의 인덱스를 리턴합니다. index와 codePointOffset에 의해 지정된 텍스트 범위내에서 페어로 되어 있지 않은 사로 게이트는 각각개의 코드 포인트로서 셀 수 있습니다.

파라미터:: index - 오프셋(offset)에의 인덱스; codePointOffset - 코드 포인트내의 오프셋(offset)
반환값:: 이 String 내의 인덱스
예외:: IndexOutOfBoundsException - index가 잘못된 값, 또는 이String 길이보다 큰 경우, codePointOffset이 정의 값이며 index로 부터 시작되는 부분 캐릭터 라인이 가지는 코드 포인트수가 codePointOffset 코드 포인트수보다 적은 경우, 또는 codePointOffset이 잘못된 값 으로 index 전의 부분 캐릭터 라인이 가지는 값이 codePointOffset 코드 포인트의 절대치보다 작은 경우
도입된 버전 :: 1.5

getChars

public void getChars(int srcBegin,
                     int srcEnd,
                     char[] dst,
                     int dstBegin)

이 캐릭터 라인으로부터, 카피처의 문자 배열에 문자를 카피합니다.

카피되는 최초의 문자의 인덱스는 srcBegin, 카피되는 마지막 문자의 인덱스는 srcEnd-1 입니다. 따라서, 카피되는 문자수는 srcEnd-srcBegin가 됩니다. 문자는 dst 부분 배열에 복사됩니다. 시점의 인덱스는 dstBegin로 종점의 인덱스는 다음과 같이 됩니다.


 dstbegin + (srcEnd-srcBegin) - 1

파라미터:

srcBegin - 카피 대상 캐릭터 라인내의 최초의 문자의 인덱스

srcEnd - 카피 대상 캐릭터 라인내의 마지막 문자의 뒤의 인덱스

dst - 전송처 배열

dstBegin - 카피처의 배열내에서의 개시 좌표

예외:

IndexOutOfBoundsException - 다음의 어떤 것인가에 들어맞는 경우

srcBegin가 부
srcBegin가 srcEnd 보다 크다
srcEnd가 이 캐릭터 라인의 길이보다 크다
dstBegin가 부
dstBegin+(srcEnd-srcBegin)가 dst.length 보다 크다

getBytes

@Deprecated 
public void getBytes(int srcBegin,
                                int srcEnd,
                                byte[] dst,
                                int dstBegin)

추천하지 않습니다. 이 메서드에서는 문자로부터 바이트에의 변환이 올바르게 행해지지 않습니다. JDK 1. 1 에서는 문자로부터 바이트에의 변환에는 플랫폼의 디폴트 캐릭터셋를 사용하는 getBytes() 메서드의 사용이 추천 됩니다.

이 캐릭터 라인으로부터, 전송처의 바이트 배열에 문자를 카피합니다. 각 바이트는 대응하는 문자의 하위 8 비트를 받습니다. 각 문자의 상위 8 비트는 카피되지 않고, 전송 될 것은 없습니다.

카피되는 최초의 문자의 인덱스는 srcBegin, 카피되는 마지막 문자의 인덱스는 srcEnd-1 입니다. 따라서, 카피되는 문자수는 srcEnd-srcBegin가 됩니다. 문자는 바이트에 변환되어 dst 부분 배열에 복사됩니다. 시점의 인덱스가 dstBegin로 종점의 인덱스는 다음과 같이 됩니다.


 dstbegin + (srcEnd-srcBegin) - 1

파라미터:

srcBegin - 카피 대상 캐릭터 라인내의 최초의 문자의 인덱스

srcEnd - 카피 대상 캐릭터 라인내의 마지막 문자의 뒤의 인덱스

dst - 전송처 배열

dstBegin - 카피처의 배열내에서의 개시 좌표

예외:

IndexOutOfBoundsException - 다음의 어떤 것인가에 들어맞는 경우

srcBegin가 부
srcBegin가 srcEnd 보다 크다
srcEnd가 이 캐릭터 라인의 길이보다 크다
dstBegin가 부
dstBegin+(srcEnd-srcBegin)가 dst.length 보다 크다

getBytes

public byte[] getBytes(String  charsetName)
                throws UnsupportedEncodingException

지정된 캐릭터셋를 사용해 이 String를 바이트 순서에 encode 해, 결과를 새로운 바이트 배열에 포함합니다.

지정된 캐릭터셋로 이 캐릭터 라인을 encode 할 수 없는 경우, 이 메서드의 동작은 지정되지 않습니다. encode 처리를 보다 강력하게 제어할 필요가 있는 경우, CharsetEncoder 클래스를 사용할 필요가 있습니다.

파라미터:: charsetName - 지원하는 charset 이름
반환값:: 결과의 바이트 배열
예외:: UnsupportedEncodingException - 지정된 캐릭터셋가 지원 되어 있지 않은 경우
도입된 버전 :: JDK1. 1

getBytes

public byte[] getBytes()

플랫폼의 디폴트 캐릭터셋를 사용해 이 String를 바이트 순서에 encode 해, 결과를 새로운 바이트 배열에 포함합니다.

디폴트의 캐릭터셋로 이 캐릭터 라인을 encode 할 수 없는 경우, 이 메서드의 동작은 지정되지 않습니다. encode 처리를 보다 강력하게 제어할 필요가 있는 경우, CharsetEncoder 클래스를 사용할 필요가 있습니다.

반환값:: 결과의 바이트 배열
도입된 버전 :: JDK1. 1

equals

public boolean equals(Object  anObject)

이 캐릭터 라인과 지정된 객체를 비교합니다. 인수가 null이 아니고, 이 객체와 같은 문자 순서를 나타내는 String 객체인 경우에만, 결과는 true가 됩니다.

오버라이드(override):: 클래스 Object 내의 equals

파라미터:: anObject - 이 String 라고 비교되는 객체
반환값:: String 가 동일한 경우는 true, 그렇지 않은 경우는 false
관련 항목:: compareTo(java.lang.String), equalsIgnoreCase(java.lang.String)

contentEquals

public boolean contentEquals(StringBuffer  sb)

이 String가 지정된 StringBuffer와 같은 문자 순서를 나타내는 경우에만, true가 리턴됩니다 .

파라미터:: sb - 비교 대상의 StringBuffer
반환값:: 이 String가 지정된 StringBuffer와 같은 문자 순서를 나타내는 경우에게만 true, 그렇지 않은 경우는 false
예외:: NullPointerException - sb가 null인 경우
도입된 버전 :: 1.4

contentEquals

public boolean contentEquals(CharSequence  cs)

이 String가 지정된 순서와 같은 char값 의 순서를 나타내는 경우에만, true가 리턴됩니다 .

파라미터:: cs - 비교 대상의 순서
반환값:: 이 String가 지정된 순서와 같은 char값 의 순서를 나타내는 경우에만, true. 그렇지 않은 경우는 false
예외:: NullPointerException - cs가 null인 경우
도입된 버전 :: 1.5

equalsIgnoreCase

public boolean equalsIgnoreCase(String  anotherString)

이 String와 다른 String를 비교합니다. 대문자와 소문자는 구별되지 않습니다. 길이가 같아, 2개의 캐릭터 라인내의 대응하는 문자가 대문자와 소문자의 구별없이 동일한 경우, 2개의 캐릭터 라인은 대문자와 소문자의 구별없이 동일하다고 보여집니다.

다음의 어떤 것인가에 해당하는 경우에 c1와 c2 라고 하는 2개의 문자는 대문자와 소문자의 구별없이 동일하다고 보여집니다.

2개의 문자가 동일하다 (== 연산자에 한 비교)
Character.toUpperCase(char) 메서드를 각각의 문자에 적용하는과 같은 결과가 된다
Character.toLowerCase(char) 메서드를 각각의 문자에 적용하는과 같은 결과가 된다

파라미터:: anotherString - 이 String 라고 비교되는 String
반환값:: 인수가 null이 아니고 String가 동일한 경우는 true. 그렇지 않은 경우는 false
관련 항목:: equals(Object), Character.toLowerCase(char), Character.toUpperCase(char)

compareTo

public int compareTo(String  anotherString)

2개의 캐릭터 라인을 사전적으로 비교합니다. 비교는 캐릭터 라인내의 각각의 문자의 Unicode코드에 근거해 행해집니다. 이 String 객체에 의해 나타내지는 문자 순서가 인수 캐릭터 라인에 의해 나타내지는 문자 순서와 사전적으로 비교됩니다. 이 String 객체가 사전적으로 인수 캐릭터 라인보다 전에 있는 경우는 결과는 부의 정수가 됩니다. 이 String 객체가 사전적으로 인수 캐릭터 라인의 뒤에 있는 경우, 결과는 정의 정수가 됩니다. 캐릭터 라인이 동일한 경우, 결과는 0 이 됩니다. equals(Object) 메서드가 true를 돌려줄 때, compareTo는 0을 리턴합니다.

사전적의 순서의 정의를 나타냅니다. 2개의 캐릭터 라인이 다른 경우, 양쪽 모두의 캐릭터 라인에 대해서 유효한 인덱스에 위치하는 문자가 다른지, 2개의 캐릭터 라인의 길이가 다르든가 혹은 그 양쪽 모두가 해당합니다. 1개 이상의 인덱스의 위치에 있는 문자가 다른 경우는 이 중의 가장 작은 인덱스를 k 로 하면, < 연산자를 사용해 「보다 작다」값으로 판정되는 위치 k에 있는 문자를 가지는 캐릭터 라인이, 이제(이미 ) 한편의 캐릭터 라인보다 사전적으로 전이 됩니다. 이 경우compareTo는 2개의 캐릭터 라인으로 위치 k에 있는 2개의 문자의 값의 차이를 리턴합니다. 이것은 다음의 식에서 나타내지는 값이 됩니다.

 this.charAt(k) -anotherString.charAt(k)

유효한 모든 인덱스 위치에 있어서의 문자가 같은 경우는 짧은 (분)편의 캐릭터 라인이 사전적으로 전이 됩니다. 이 경우는 compareTo는 캐릭터 라인의 길이의 차이를 리턴합니다. 이것은 다음의 식에서 나타내지는 값이 됩니다.

 this.length() -anotherString.length()

정의:: 인터페이스 Comparable <String > 내의 compareTo

파라미터:: anotherString - 비교 대상의 String
반환값:: 인수 캐릭터 라인이 이 캐릭터 라인에 동일한 경우는 값 0. 이 캐릭터 라인이 캐릭터 라인 인수보다 사전적으로 작은 경우는 0 보다 작은 값. 이 캐릭터 라인이 캐릭터 라인 인수보다 사전적으로 큰 경우는 0 보다 큰 값

compareToIgnoreCase

public int compareToIgnoreCase(String  str)

대문자와 소문자의 구별없이, 2개의 캐릭터 라인을 사전적으로 비교합니다. 이 메서드는 캐릭터 라인의 정규화 버전 으로 compareTo를 호출해 얻을 수 있던 부호를 가지는 정수를 리턴합니다. 여기에서는 각 문자로 Character.toLowerCase(Character.toUpperCase(character))를 호출하는 것으로 대문자와 소문자의 차이가 없어집니다.

이 메서드는 로케일을 고려하지 않기 때문에 일부의 로케일에서는 올바른 순서에 늘어놓을 수 없는 것이 있습니다. java.text 패키지는 로케일에 의존된 늘어놓고 바꾸고를 실시하기 위해서 「조합 기능」을 제공하고 있습니다.

파라미터:: str - 비교 대상의 String
반환값:: 대문자와 소문자의 구별없이, 지정된 String가 이 String 보다 큰 경우는 부의 정수, 같은 경우는 0, 작은 경우는 정의 정수
도입된 버전 :: 1.2
관련 항목:: Collator.compare(String, String)

regionMatches

public boolean regionMatches(int toffset,
                             String  other,
                             int ooffset,
                             int len)

2개의 캐릭터 라인 영역이 동일한지 어떤지를 판정합니다.

이 String 객체의 부분 캐릭터 라인이, 인수 other 부분 캐릭터 라인이라고 비교됩니다. 이러한 부분 캐릭터 라인이 같은 문자 순서를 나타내는 경우, 결과는 true가 됩니다. 이 비교 대상 String 객체의 부분 캐릭터 라인은 인덱스 toffset로 부터 시작되어, 길이는 len 입니다. 비교의 대상이 되는 other 부분 캐릭터 라인은 인덱스 ooffset로 부터 시작되어, 길이는 len 입니다. 아래의 어떤 것인가에 해당하는 경우에만, 결과는 false가 됩니다.

toffset가 부이다
ooffset가 부이다
toffset+len가 이 String 객체의 길이보다 크다
ooffset+len가 인수 other 길이보다 크다
len 보다 작고, 부가 아닌 정수 k (예: this.charAt(toffset+k) ! = other.charAt(ooffset+k))가 있다

파라미터:: toffset - 이 캐릭터 라인내의 부분 영역의 개시 오프셋(offset); other - 캐릭터 라인 인수; ooffset - 캐릭터 라인 인수내의 부분 영역의 개시 오프셋(offset); len - 비교 대상의 문자수
반환값:: 이 캐릭터 라인의 지정된 부분 영역이 캐릭터 라인 인수의 지정된 부분 영역과 완전하게 일치하는 경우는 true. 그렇지 않은 경우는 false

regionMatches

public boolean regionMatches(boolean ignoreCase,
                             int toffset,
                             String  other,
                             int ooffset,
                             int len)

2개의 캐릭터 라인 영역이 동일한지 어떤지를 판정합니다.

이 String 객체의 부분 캐릭터 라인이, 인수 other 부분 캐릭터 라인이라고 비교됩니다. 이러한 부분 캐릭터 라인이 같은 문자 순서를 나타내는 경우, 결과는 true가 됩니다. ignoreCase가 true인 경우에만, 대문자와 소문자가 구별되지 않습니다. 비교의 대상이 되는 String 객체의 부분 캐릭터 라인은 인덱스 toffset로 부터 시작되어, 길이는 len 입니다. 비교의 대상이 되는 other 부분 캐릭터 라인은 인덱스 ooffset로 부터 시작되어, 길이는 len 입니다. 아래의 어떤 것인가에 해당하는 경우에만, 결과는 false가 됩니다.

toffset가 부이다
ooffset가 부이다
toffset+len가 이 String 객체의 길이보다 크다
ooffset+len가 인수 other 길이보다 크다
ignoreCase가 false 이며, len 보다 작고, 부가 아닌, 다음과 같은 정수 k가 있다
```
 this.charAt(toffset+k) ! = other.charAt(ooffset+k)
```

ignoreCase가 true 이며, len 보다 작고, 부가 아닌, 다음과 같은 정수 k가 있다

 Character.toLowerCase(this.charAt(toffset+k)) ! = Character.toLowerCase(other.charAt(ooffset+k))

및

 Character.toUpperCase(this.charAt(toffset+k)) ! = Character.toUpperCase(other.charAt(ooffset+k))

파라미터:: ignoreCase - true인 경우, 문자의 비교 시에 대문자와 소문자는 구별되지 않는; toffset - 이 캐릭터 라인내의 부분 영역의 개시 오프셋(offset); other - 캐릭터 라인 인수; ooffset - 캐릭터 라인 인수내의 부분 영역의 개시 오프셋(offset); len - 비교 대상의 문자수
반환값:: 이 캐릭터 라인의 지정된 부분 영역이 캐릭터 라인 인수의 지정된 부분 영역과 일치하는 경우는 true, 그렇지 않은 경우는 false. 일치했을 경우에 대문자와 소문자가 구별되고 있을지 어떨지는 인수 ignoreCase에 의해 정해진다

startsWith

public boolean startsWith(String  prefix,
                          int toffset)

이 캐릭터 라인의 지정된 인덱스 이후의 부분 캐릭터 라인이, 지정된 접두사로 시작될지 어떨지를 판정합니다.

파라미터:

prefix - 접두사

toffset - 캐릭터 라인의 비교를 개시하는 위치

반환값:

인수에 의해 나타내지는 문자 순서가 인덱스 toffset로 시작되는 이 객체의 부분 캐릭터 라인의 접두사인 경우는 true, 그렇지 않은 경우는 false. toffset이 잘못된 값 의 경우, 혹은 String 객체의 길이보다 큰 경우, 결과는 false. 그렇지 않은 경우는 결과는 다음의 식의 결과와 같은

 this.substring(toffset). startsWith(prefix)

startsWith

public boolean startsWith(String  prefix)

이 캐릭터 라인이, 지정된 접두사로 시작될지 어떨지를 판정합니다.

파라미터:: prefix - 접두사
반환값:: 인수에 의해 나타내지는 문자 순서, 이 캐릭터 라인에 의해 나타내지는 문자 순서의 접두사인 경우는 true, 그렇지 않은 경우는 false. 인수가 비어있는 캐릭터 라인의 경우나, equals(Object) 메서드에 한 판정에 대해 이 String 객체에 동일한 경우에도 true가 리턴된
도입된 버전 :: 1. 0

endsWith

public boolean endsWith(String  suffix)

이 캐릭터 라인이, 지정된 접미말로 끝날지 어떨지를 판정합니다.

파라미터:: suffix - 접미말
반환값:: 인수에 의해 나타내지는 문자 순서가 이 객체에 의해 나타내지는 문자 순서의 접미말인 경우는 true, 그렇지 않은 경우는 false. 인수가 비어있는 캐릭터 라인의 경우나, String 객체가 equals(Object) 메서드에 한 판정에 대해 이 String 객체에 동일한 경우에도, 결과는 true가 된다

hashCode

public int hashCode()

이 캐릭터 라인의 해시 코드를 리턴합니다. String 해시 코드는 다음의 방법으로 계산합니다.

 s[0]*31^(n-1) + s[1]*31^(n-2) + ... + s[n-1]

int 산술을 사용합니다. s[i]는 캐릭터 라인의 i 번째의 문자, n는 캐릭터 라인의 길이, ^는 나무승을 나타냅니다. 비어있는 캐릭터 라인의 해시치는 0 입니다.

오버라이드(override):: 클래스 Object 내의 hashCode

반환값:: 이 객체의 해시 코드값
관련 항목:: Object.equals(java.lang.Object), Hashtable

indexOf

public int indexOf(int ch)

이 캐릭터 라인내에서 지정된 문자가 최초로 출현하는 위치의 인덱스를 리턴합니다. 값 ch를 가지는 문자가 이 String 객체에 의해 나타내지는 문자 순서내에 있는 경우, 최초로 출현하는 위치의 인덱스 (Unicode 코드 단위)가 리턴됩니다 . 0 ~ 0xFFFF 범위의 ch값의 경우, 다음의 식이 true가 되는 것 같은 최소값 k가 리턴됩니다 .

 this.charAt(k) == ch

ch가 다른 값의 경우, 다음의 식이 true가 되는 것 같은 최소값 k 입니다.

 this.codePointAt(k) == ch

해당하는 문자가 이 캐릭터 라인내에 없는 경우는 -1 이 리턴됩니다 .

파라미터:: ch - 문자 (Unicode 코드 포인트)
반환값:: 이 객체에 의해 나타내지는 문자 순서내에서 지정된 문자가 최초로 출현하는 위치의 인덱스. 문자가 없는 경우는 -1

indexOf

public int indexOf(int ch,
                   int fromIndex)

이 캐릭터 라인내에서 지정된 인덱스로부터 검색을 개시해, 지정된 문자가 최초로 출현하는 위치의 인덱스를 리턴합니다.

값 ch를 가지는 문자가 이 String 객체에 의해 나타내지는 문자 순서의 fromIndex 보다 큰가 같은 인덱스 위치에 있는 경우, 해당하는 최초의 인덱스가 리턴됩니다 . ch값이 0 ~ 0xFFFF 범위에 있는 경우, 다음의 식이 true가 되는 것 같은 최소값 k가 리턴됩니다 .

 (this.charAt(k) == ch) && (k >= fromIndex)

ch가 다른 값의 경우, 다음의 식이 true가 되는 것 같은 최소값 k 입니다.

 (this.codePointAt(k) == ch) && (k >= fromIndex)

해당하는 문자가 이 캐릭터 라인내 또는 위치 fromIndex 이후에 없는 경우는 -1 이 리턴됩니다 .

fromIndex값에 대해서 제약은 없습니다. 잘못된 값 의 경우는 0인 경우와 같은 결과가 되어, 이 캐릭터 라인 전체가 검색됩니다. 이 캐릭터 라인의 길이보다 큰 경우는 이 캐릭터 라인의 길이에 동일한 경우와 같은 결과가 되어, -1가 리턴됩니다 .

모든 인덱스는 char값 (Unicode 코드 단위)로 지정됩니다.

파라미터:: ch - 문자 (Unicode 코드 포인트); fromIndex - 검색 개시 위치의 인덱스
반환값:: 이 객체에 의해 나타내지는 캐릭터 라인으로 지정된 문자가 fromIndex와 같은가 이것보다 큰 인덱스 위치에 있는 경우는 최초로 출현한 위치의 인덱스. 문자가 없는 경우는 -1

lastIndexOf

public int lastIndexOf(int ch)

이 캐릭터 라인내에서 지정된 문자가 마지막에 출현하는 위치의 인덱스를 리턴합니다. ch값이 0 ~ 0xFFFF 범위에 있는 경우, 리턴된 인덱스 (Unicode 코드 단위)는 다음의 식에 해당하는 최대값 k 입니다.

 this.charAt(k) == ch

ch가 다른 값의 경우, 다음의 식에 해당하는 최대값 k 입니다.

 this.codePointAt(k) == ch

해당하는 문자가 이 캐릭터 라인내에 없는 경우는 -1 이 리턴됩니다 . String 검색은 마지막 문자로부터 시작되어 선두 방향에 행해집니다.

파라미터:: ch - 문자 (Unicode 코드 포인트)
반환값:: 이 객체에 의해 나타내지는 문자 순서내에서 지정된 문자가 마지막에 출현하는 위치의 인덱스. 문자가 없는 경우는 -1

lastIndexOf

public int lastIndexOf(int ch,
                       int fromIndex)

이 캐릭터 라인내에서 지정된 문자가 마지막에 출현하는 위치의 인덱스를 리턴합니다 (검색은 지정된 인덱스로부터 시작되어 선두 방향에 행해진다). ch값이 0 ~ 0xFFFF 범위에 있는 경우, 리턴된 인덱스는 다음의 식에 해당하는 최대값 k 입니다.

 (this.charAt(k) == ch) && (k <= fromIndex)

ch가 다른 값의 경우, 다음의 식에 해당하는 최대값 k 입니다.

 (this.codePointAt(k) == ch) && (k <= fromIndex)

해당하는 문자가 이 캐릭터 라인내 또는 위치 fromIndex 이전에 없는 경우는 -1 이 리턴됩니다 .

모든 인덱스는 char값 (Unicode 코드 단위)로 지정됩니다.

파라미터:: ch - 문자 (Unicode 코드 포인트); fromIndex - 검색을 개시하는 인덱스. fromIndex값에 대해서 제약은 없다. 이 캐릭터 라인의 길이와 같은가 이것보다 큰 경우는 이 캐릭터 라인의 길이보다 1 작은 경우와 같은 결과가 되어, 이 캐릭터 라인 전체가 검색된다. 잘못된 값 의 경우는 -1인 경우와 같은 결과가 되어,-1가 리턴된다
반환값:: 이 객체에 의해 나타내지는 문자 순서내에서 지정된 문자가 fromIndex와 같은가 이것보다 작은 인덱스 위치에 마지막에 출현하는 위치의 인덱스. 지정된 문자가 그 위치보다 전에 없는 경우는 -1

indexOf

public int indexOf(String  str)

이 캐릭터 라인내에서 지정된 부분 캐릭터 라인이 최초로 출현하는 위치의 인덱스를 리턴합니다. 리턴된 정수는

 this.startsWith(str, k)

가 true가 되는 것 같은 최소값 k 입니다.

파라미터:: str - 임의의 캐릭터 라인
반환값:: 캐릭터 라인 인수가 이 객체내의 부분 캐릭터 라인인 경우는 해당하는 최초의 부분 캐릭터 라인의 최초의 문자의 인덱스. 부분 캐릭터 라인이 없는 경우는 -1

indexOf

public int indexOf(String  str,
                   int fromIndex)

지정된 인덱스 이후로 지정된 부분 캐릭터 라인이 이 캐릭터 라인내에서 최초로 출현하는 위치의 인덱스를 리턴합니다. 리턴된 정수는 다음의 식이 true가 되는 것 같은 최소값 k가 됩니다.

 k >= Math.min(fromIndex, str.length()) && this.startsWith(str, k)

이러한 k 값이 존재하지 않는 경우,-1가 리턴됩니다 .

파라미터:: str - 검색 대상의 부분 캐릭터 라인; fromIndex - 검색 개시 위치의 인덱스
반환값:: 지정된 인덱스로부터 검색을 개시해, 최초로 지정된 부분 캐릭터 라인이 출현하는 이 캐릭터 라인내의 인덱스

lastIndexOf

public int lastIndexOf(String  str)

이 캐릭터 라인내에서 지정된 부분 캐릭터 라인이 제일 오른쪽으로 출현하는 위치의 인덱스를 리턴합니다. 비어있는 캐릭터 라인 「」의 제일 오른쪽으로 출현한 위치가this.length() 라고 보여집니다. 리턴된 인덱스는

 this.startsWith(str, k)

식이 true가 되는 것 같은 최대값 k 입니다.

파라미터:: str - 검색 대상의 부분 캐릭터 라인
반환값:: 캐릭터 라인 인수가 이 객체내의 부분 캐릭터 라인으로서 1회 이상 출현하는 경우는 해당하는 마지막 부분 캐릭터 라인의 최초의 문자의 인덱스. 부분 캐릭터 라인으로서 출현하지 않는 경우는 -1

lastIndexOf

public int lastIndexOf(String  str,
                       int fromIndex)

이 캐릭터 라인내에서 지정된 부분 캐릭터 라인이 마지막에 출현하는 위치의 인덱스를 리턴합니다 (검색은 지정된 인덱스로부터 시작되어 선두 방향에 행해진다). 리턴된 정수는 다음을 채우는 최대값 k가 됩니다.

 k <= Math.min(fromIndex, str.length()) && this.startsWith(str, k)

이러한 k 값이 존재하지 않는 경우,-1가 리턴됩니다 .

파라미터:: str - 검색 대상의 부분 캐릭터 라인; fromIndex - 검색 개시 위치의 인덱스
반환값:: 이 캐릭터 라인내에서 지정된 부분 캐릭터 라인이 마지막에 출현하는 위치의 인덱스

substring

public String  substring(int beginIndex)

이 캐릭터 라인의 부분 캐릭터 라인인 새로운 캐릭터 라인을 리턴합니다. 부분 캐릭터 라인은 지정된 인덱스로 시작되어, 이 캐릭터 라인의 끝까지가 됩니다.

례:

 "unhappy". substring(2) returns "happy" "Harbison". substring(3) returns "bison" "emptiness". substring(9) returns "" (an empty string)

파라미터:: beginIndex - 개시 인덱스 (이 값을 포함한다)
반환값:: 지정된 부분 캐릭터 라인
예외:: IndexOutOfBoundsException - beginIndex가 잘못된 값 의 경우, 혹은 이 String 객체의 길이보다 큰 경우

substring

public String  substring(int beginIndex,
                        int endIndex)

이 캐릭터 라인의 부분 캐릭터 라인인 새로운 캐릭터 라인을 리턴합니다. 부분 캐릭터 라인은 지정된 beginIndex로 부터 시작되어, 인덱스 endIndex - 1에 있는 문자까지입니다. 따라서, 부분 캐릭터 라인의 길이는 endIndex-beginIndex가 됩니다.

례:

 "hamburger". substring(4, 8) returns "urge" "smiles". substring(1, 5) returns "mile"

파라미터:: beginIndex - 개시 인덱스 (이 값을 포함한다); endIndex - 종료 인덱스 (이 값을 포함하지 않는다)
반환값:: 지정된 부분 캐릭터 라인
예외:: IndexOutOfBoundsException - beginIndex가 잘못된 값 인 경우, endIndex가 이 String 객체의 길이보다 큰 경우, 혹은 beginIndex가 endIndex 보다 큰 경우

subSequence

public CharSequence  subSequence(int beginIndex,
                                int endIndex)

이 순서의 서브 순서인 새로운 문자 순서를 리턴합니다.

다음의 폼의 메서드 호출은,

 str.subSequence(begin,  end)

다음의 호출과 정확하게 같은 동작이 됩니다.

 str.substring(begin,  end)

이 메서드 정의에의해 String 클래스가 CharSequence 인터페이스를 구현 가능하게 됩니다.

정의:: 인터페이스 CharSequence 내의 subSequence

파라미터:: beginIndex - 개시 인덱스 (이 값을 포함한다); endIndex - 종료 인덱스 (이 값을 포함하지 않는다)
반환값:: 지정된 서브 순서
예외:: IndexOutOfBoundsException - beginIndex 또는 endIndex가 잘못된 값 의 경우, endIndex 값이 length() 보다 큰 경우, beginIndex 값이 startIndex 보다 큰 경우
도입된 버전 :: 1.4

concat

public String  concat(String  str)

지정된 캐릭터 라인을 이 캐릭터 라인의 마지막에 연결합니다.

인수 캐릭터 라인의 길이가 0인 경우는 이 String 객체가 리턴됩니다 . 그렇지 않은 경우는 이 String 객체에 의해 나타내지는 캐릭터 라인과 인수 캐릭터 라인에 의해 나타내지는 캐릭터 라인을 연결한 것을 나타내는 새로운 String 객체가 생성됩니다.

례:

 "cares". concat("s") returns "caress" "to". concat("get"). concat("her") returns "together"

파라미터:: str - 이 String 마지막에 연결되는 String
반환값:: 이 객체의 캐릭터 라인의 뒤에 캐릭터 라인 인수로 나타내지는 문자를 연결한 것을 나타내는 캐릭터 라인

replace

public String  replace(char oldChar,
                      char newChar)

이 캐릭터 라인내에 있는 모든 oldChar를 newChar에 치환한 결과 생성되는 새로운 캐릭터 라인을 리턴합니다.

문자 oldChar가 이 String 객체에 의해 나타내지는 캐릭터 라인내에 없는 경우는 이 String 객체에의 참조가 리턴됩니다 . 그렇지 않은 경우는 이 String 객체에 의해 나타내지는 캐릭터 라인과 같은 캐릭터 라인을 나타내는 새로운 String 객체가 생성됩니다. 다만, 캐릭터 라인내의 oldChar는 모두 newChar에 치환됩니다.

례:

 "mesquite in your cellar". replace('e', 'o') returns "mosquito in your collar" "the war of baronets". replace('r', 'y') returns "the way of bayonets" "sparring with a purple porpoise". replace('p', 't') returns "starring with a turtle tortoise" "JonL". replace('q', 'x') returns "JonL" (no change)

파라미터:: oldChar - 이전의 문자; newChar - 새로운 문자
반환값:: 이 캐릭터 라인내의 모든 oldChar를 newChar에 치환하는 것에 의해 생성된 캐릭터 라인

matches

public boolean matches(String  regex)

이 캐릭터 라인이, 지정된 정규 표현과 일치할지 어떨지를 판정합니다.

이 폼의 메서드 호출 str. matches(regex)에 서는 다음의 식과 정확하게 같은 결과를 얻을 수 있습니다.

Pattern . matches (regex, str)

파라미터:: regex - 이 캐릭터 라인과의 일치를 판정하는 정규 표현
반환값:: 이 캐릭터 라인이 지정된 정규 표현과 일치하는 경우에만, true가 리턴된다
예외:: PatternSyntaxException - 정규 표현의 구문이 무효인 경우
도입된 버전 :: 1.4
관련 항목:: Pattern

contains

public boolean contains(CharSequence  s)

이 캐릭터 라인이 지정된 char값 의 순서를 포함한 경우에 한정해 true를 리턴합니다.

파라미터:: s - 검색하는 순서
반환값:: 이 캐릭터 라인이 s를 포함한 경우는 true. 그렇지 않은 경우는 false
예외:: NullPointerException - s가 null인 경우
도입된 버전 :: 1.5

replaceFirst

public String  replaceFirst(String  regex,
                           String  replacement)

지정된 정규 표현에 일치하는 이 캐릭터 라인의 최초의 부분 캐릭터 라인에 대해, 지정된 치환을 실행합니다.

이 폼의 메서드 호출 str. replaceFirst(regex, repl)에 서는 다음의 식과 정확하게 같은 결과를 얻을 수 있습니다.

Pattern . compile (regex). matcher (str). replaceFirst (repl)

파라미터:: regex - 이 캐릭터 라인과의 일치를 판정하는 정규 표현
반환값:: 결과적으로 얻을 수 있는 String
예외:: PatternSyntaxException - 정규 표현의 구문이 무효인 경우
도입된 버전 :: 1.4
관련 항목:: Pattern

replaceAll

public String  replaceAll(String  regex,
                         String  replacement)

지정된 정규 표현에 일치하는 이 캐릭터 라인의 각 부분 캐릭터 라인에 대해, 지정된 치환을 실행합니다.

이 폼의 메서드 호출 str. replaceAll(regex, repl)에 서는 다음의 식과 정확하게 같은 결과를 얻을 수 있습니다.

Pattern . compile (regex). matcher (str). replaceAll (repl)

파라미터:: regex - 이 캐릭터 라인과의 일치를 판정하는 정규 표현
반환값:: 결과적으로 얻을 수 있는 String
예외:: PatternSyntaxException - 정규 표현의 구문이 무효인 경우
도입된 버전 :: 1.4
관련 항목:: Pattern

replace

public String  replace(CharSequence  target,
                      CharSequence  replacement)

리터럴 타겟 순서에 일치하는 이 캐릭터 라인의 부분 캐릭터 라인을 지정된 리터럴 치환 순서에 옮겨놓습니다. 치환은 캐릭터 라인의 선두로부터 시작되어 종단까지 진행됩니다. 예를 들어 캐릭터 라인 「aaa」의 「aa」를 「b」에 치환하면, 결과는 「ab」가 아니고, 「ba」입니다.

파라미터:: target - 치환되는 char값 의 순서; replacement - char값 의 치환 순서
반환값:: 결과의 캐릭터 라인
예외:: NullPointerException - target 또는 replacement이 null인 경우
도입된 버전 :: 1.5

split

public String [] split(String  regex,
                      int limit)

이 캐릭터 라인을 지정된 정규 표현에 일치하는 위치에서 분할합니다.

이 캐릭터 라인의 각 부분 캐릭터 라인을 포함한 메서드에 의해 리턴된 배열은 지정된 식에 일치하는 다른 부분 캐릭터 라인, 또는 그 캐릭터 라인의 최후로 종료합니다. 배열내의 부분 캐릭터 라인의 순서는 이 캐릭터 라인내에서 출현하는 순서가 됩니다. 입력된 어느 부분과도 식이 일치하지 않는 경우, 배열은개의 요소 (즉, 이 캐릭터 라인)만을 보관 유지합니다.

limit 파라미터는 이 패턴의 적용 회수, 즉, 리턴된 배열의 길이를 제어합니다. 제한 n가 제로보다 큰 경우, 이 패턴은 n - 1회아래의 회수가 적용되어 배열의 길이는 n 이하가 됩니다. 배열의 마지막 엔트리에는 마지막에 성냥 한 단락 문자 이후의 입력 순서가 모두 포함됩니다. n가 잘못된 값 의 경우, 이 패턴의 적용 회수와 배열의 길이는 제한되지 않습니다. n가 제로의 경우, 이 패턴의 적용 회수와 배열의 길이는 제한됩니다만, 후속의 비어있는 캐릭터 라인은 파기됩니다.

예를 들어 다음의 파라미터가 지정되었을 경우의, 캐릭터 라인 「boo:and:foo」의 결과를 나타냅니다.

정규 표현 제한 결과

: 2 { "boo", "and:foo" }

: 5 { "boo", "and", "foo" }

: -2 { "boo", "and", "foo" }

o 5 { "b", "", ":and:f", "", "" }

o -2 { "b", "", ":and:f", "", "" }

o 0 { "b", "", ":and:f" }

정규 표현	제한	결과
:	2	`{ "boo", "and:foo" }`
:	5	`{ "boo", "and", "foo" }`
:	-2	`{ "boo", "and", "foo" }`
o	5	`{ "b", "", ":and:f", "", "" }`
o	-2	`{ "b", "", ":and:f", "", "" }`
o	0	`{ "b", "", ":and:f" }`

이 폼의 메서드 호출 str. split(regex, n)에 서는 다음의 식과 정확하게 같은 결과를 얻을 수 있습니다.

Pattern . compile (regex). split (str, n)

파라미터:: regex - 정규 표현의 단락; limit - 결과의의해 귀의치 (상기를 참조)
반환값:: 이 캐릭터 라인이 지정된 정규 표현에 일치하는 위치에서 분할해 계산된 캐릭터 라인의 배열
예외:: PatternSyntaxException - 정규 표현의 구문이 무효인 경우
도입된 버전 :: 1.4
관련 항목:: Pattern

split

public String [] split(String  regex)

이 캐릭터 라인을 지정된 regular expression에 일치하는 위치에서 분할합니다.

이 메서드의 동작은 2개의 인수를 취하는 split 메서드를, 지정된 식 및 인수 제한 제로를 지정해 호출했을 경우와 같게 됩니다. 이 때문에 말미의 공문자열은 결과의 배열에 포함되지 않습니다.

예를 들어 다음의 식을 지정했을 경우의, 캐릭터 라인 「boo:and:foo」의 결과를 나타냅니다.

정규 표현 결과

: { "boo", "and", "foo" }

o { "b", "", ":and:f" }

정규 표현	결과
:	`{ "boo", "and", "foo" }`
o	`{ "b", "", ":and:f" }`

파라미터:: regex - 정규 표현의 단락
반환값:: 이 캐릭터 라인이 지정된 정규 표현에 일치하는 위치에서 분할해 계산된 캐릭터 라인의 배열
예외:: PatternSyntaxException - 정규 표현의 구문이 무효인 경우
도입된 버전 :: 1.4
관련 항목:: Pattern

toLowerCase

public String  toLowerCase(Locale  locale)

지정된 Locale 규칙을 사용해, 이 String 내의 모든 캐릭터 라인을 소문자로 변환합니다. 케이스 매핑은, Character 클래스에서 지정된 Unicode 사양 버전에 근거하고 있습니다. 케이스 매핑은 항상 1:1 문자 매핑이 된다고는 할 수 없기 때문에 결과의 String가 원의 String와 길이가 다른 경우가 있습니다.

소문자의 매핑예를, 다음의 겉(표)에 나타냅니다.

로케일의 언어 코드	대문자	소문자	설명
tr (터키어)	\u0130	\u0069	상에점이 붙은 대문자의 I -> 소문자의 i
tr (터키어)	\u0049	\u0131	대문자의 I -> 점이 없는 소문자의 i
(모두)	French Fries	french fries	String 내의 문자 모든 것을 소문자에 변환
(모두)			String 내의 문자 모든 것을 소문자에 변환

파라미터:: locale - 이 로케일의 대문자와 소문자 변환 규칙을 사용한다
반환값:: 소문자에 변환되는 String
도입된 버전 :: 1.1
관련 항목:: toLowerCase(), toUpperCase(), toUpperCase(Locale)

toLowerCase

public String  toLowerCase()

디폴트 로케일의 규칙을 사용해, 이 String 내의 모든 문자를 소문자로 변환합니다. 이것은, toLowerCase(Locale.getDefault()) 호출과 등가가 됩니다.

반환값:: 소문자에 변환되는 String
관련 항목:: toLowerCase(Locale)

toUpperCase

public String  toUpperCase(Locale  locale)

지정된 Locale 규칙을 사용해, 이 String 내의 모든 캐릭터 라인을 대문자로 변환합니다. 케이스 매핑은, Character 클래스에서 지정된 Unicode 사양 버전에 근거하고 있습니다. 케이스 매핑은 항상 1:1 문자 매핑이 된다고는 할 수 없기 때문에 결과의 String가 원의 String와 길이가 다른 경우가 있습니다.

로케일 존 및 1:M 케이스 매핑의 예를, 다음의 겉(표)에 나타냅니다.

로케일의 언어 코드	소문자	대문자	설명
tr (터키어)	\u0069	\u0130	소문자의 i -> 상에점이 붙은 대문자의 I
tr (터키어)	\u0131	\u0049	점이 없는 소문자의 i -> 대문자의 I
(모두)	\u00df	\u0053 \u0053	소문자의 샤프 s -> SS 2 문자
(모두)	Fahrvergnügen	FAHRVERGNÜGEN

파라미터:: locale - 이 로케일의 대문자와 소문자 변환 규칙을 사용한다
반환값:: 대문자에 변환된 String
도입된 버전 :: 1.1
관련 항목:: toUpperCase(), toLowerCase(), toLowerCase(Locale)

toUpperCase

public String  toUpperCase()

디폴트 로케일의 규칙을 사용해, 이 String 내의 모든 문자를 대문자로 변환합니다. 이 메서드는 toUpperCase(Locale.getDefault())와 등가가 됩니다.

반환값:: 대문자에 변환된 String
관련 항목:: toUpperCase(Locale)

trim

public String  trim()

캐릭터 라인의 복사본을 리턴합니다. 선두와 마지막 공백은 생략 됩니다.

이 String 객체가 비어있는 캐릭터 라인을 나타내는 경우, 혹은 이 String 객체에 의해 나타내지는 문자 순서의 최초와 마지막 문자의 코드가 어느쪽이나 「\u0020」(공백 문자)보다 큰 경우는 이 String 객체에의 참조가 리턴됩니다 .

캐릭터 라인내에 「\u0020」보다 큰 코드의 문자가 없는 경우는 비어있는 캐릭터 라인을 나타내는 새로운 String 객체가 생성되어 리턴됩니다 .

예를 들어, k가 캐릭터 라인내의 최초의 문자의 인덱스이며, 「\u0020」보다 큰 코드값을 가져, m가 캐릭터 라인내의 마지막 문자의 인덱스이며, 「\u0020」보다 큰 코드값을 가지는 경우는 인덱스 k에 있는 문자로 시작되어, 인덱스 m에 있는 문자로 끝나는 이 캐릭터 라인의 부분 캐릭터 라인을 나타내는 새로운 String 객체가 생성됩니다. 즉, 이것은 this.substring(k, m+1) 결과와 같습니다.

이 메서드는 캐릭터 라인의 선두와 최후로부터 (상기로 정의된) 공백을 잘라내기 위해서 사용할 수 있습니다.

반환값:: 이 캐릭터 라인의 선두와 마지막 공백을 삭제한 카피, 또는 이 캐릭터 라인 (선두와 마지막에 공백이 존재하지 않는 경우)

toString

public String  toString()

이 객체 (이미 캐릭터 라인이다) 자신이 리턴됩니다 .

정의:: 인터페이스 CharSequence 내의 toString
오버라이드(override):: 클래스 Object 내의 toString

반환값:: 캐릭터 라인 자신

toCharArray

public char[] toCharArray()

이 캐릭터 라인을 새로운 문자 배열로 변환합니다.

반환값:: 새롭게 할당할 수 있었던 문자 배열. 길이는 이 캐릭터 라인의 길이와 같아, 내용은 이 캐릭터 라인에 의해 나타내지는 문자 순서가 포함되도록 초기화되고 있다

format

public static String  format(String  format,
                            Object ... args)

지정된 서식의 캐릭터 라인과 인수를 사용해, 서식 첨부 캐릭터 라인을 리턴합니다.

항상 사용되는 로케일은, Locale.getDefault() 에 의해 리턴된 로케일입니다.

파라미터:: format - 서식 캐릭터 라인; args - 서식 캐릭터 라인의 서식 지시자에 의해 참조되는 인수. 서식 지시자보다 인수가 많은 경우, 여분의 인수는 무시된다. 인수의 수는 변동해, 제로의 경우도 있다. 인수의 최대값는 「The Java Virtual Machine Specification」로 정의되고 있는 Java 배열의 최대 차원에 의해 제한된다. null 인수에서의 동작은, 변환에 응해 다르다
반환값:: 포맷된 캐릭터 라인
예외:: IllegalFormatException - 서식 캐릭터 라인이, 부정한 구문, 소정의 인수와 호환성이 없는 서식 지시자, 서식 캐릭터 라인에게 줄 수 있던 부적절한 인수, 혹은 다른 부정한 조건을 포함한 경우. 생각되는 모든 서식 에러의 사양에 대해서는 포매터 클래스 사양의 「상세」의 섹션을 참조; NullPointerException - format가 null인 경우
도입된 버전 :: 1.5
관련 항목:: Formatter

format

public static String  format(Locale  l,
                            String  format,
                            Object ... args)

지정된 로케일, 서식 캐릭터 라인 및 인수를 사용해, 포맷된 캐릭터 라인을 리턴합니다.

파라미터:: l - 서식 설정시에 적용하는 locale . l가 null인 경우, 지역 대응은 적용되지 않는; format - 서식 캐릭터 라인; args - 서식 캐릭터 라인의 서식 지시자에 의해 참조되는 인수. 서식 지시자보다 인수가 많은 경우, 여분의 인수는 무시된다. 인수의 수는 변동해, 제로의 경우도 있다. 인수의 최대값는 「The Java Virtual Machine Specification」로 정의되고 있는 Java 배열의 최대 차원에 의해 제한된다. null 인수에서의 동작은, 변환에 응해 다르다
반환값:: 포맷된 캐릭터 라인
예외:: IllegalFormatException - 서식 캐릭터 라인이, 부정한 구문, 소정의 인수와 호환성이 없는 서식 지시자, 서식 캐릭터 라인에게 줄 수 있던 부적절한 인수, 혹은 다른 부정한 조건을 포함한 경우. 생각되는 모든 서식 에러의 사양에 대해서는 포매터 클래스 사양의 「상세」의 섹션을 참조; NullPointerException - format가 null인 경우
도입된 버전 :: 1.5
관련 항목:: Formatter

valueOf

public static String  valueOf(Object  obj)

Object인수의 캐릭터 라인 표현을 리턴합니다.

파라미터:: obj - Object
반환값:: 인수가 null인 경우는 「null」에 동일한 캐릭터 라인. 그렇지 않은 경우는 obj.toString()값
관련 항목:: Object.toString()

valueOf

public static String  valueOf(char[] data)

char 배열 인수의 캐릭터 라인 표현을 리턴합니다. 문자 배열의 내용이 복사됩니다. 카피 후에 그 문자가 변경되어도, 새롭게 작성된 캐릭터 라인에는 영향을 주지 않습니다.

파라미터:: data - char 배열
반환값:: 문자 배열 인수에 포함되고 있는 동일 순서의 문자군을 나타내는 새롭게 할당할 수 있었던 캐릭터 라인

valueOf

public static String  valueOf(char[] data,
                             int offset,
                             int count)

char 배열 인수의 특정의 부분 배열의 캐릭터 라인 표현을 리턴합니다.

offset인수는 부분 배열의 최초의 문자의 인덱스를 나타냅니다. count인수는 부분 배열의 길이를 나타냅니다. 부분 배열의 내용이 복사됩니다. 카피 후에 문자 배열이 변경되어도, 새롭게 작성된 캐릭터 라인에는 영향을 주지 않습니다.

파라미터:: data - 문자 배열; offset - String값에의 초기 오프셋(offset); count - String값의 길이
반환값:: 문자 배열 인수의 부분 배열에 포함되고 있는 문자 순서를 나타내는 캐릭터 라인
예외:: IndexOutOfBoundsException - offset이 잘못된 값 의 경우, count이 잘못된 값 의 경우, 혹은 offset+count이 data.length 보다 큰 경우

copyValueOf

public static String  copyValueOf(char[] data,
                                 int offset,
                                 int count)

지정된 배열내의 문자 순서를 나타내는 String를 리턴합니다.

파라미터:: data - 문자 배열; offset - 부분 배열의 초기 오프셋(offset); count - 부분 배열의 길이
반환값:: 문자 배열내의 지정된 부분 배열의 문자가 포함되고 있는 String

copyValueOf

public static String  copyValueOf(char[] data)

지정된 배열내의 문자 순서를 나타내는 String를 리턴합니다.

파라미터:: data - 문자 배열
반환값:: 문자 배열의 문자가 포함되고 있는 String

valueOf

public static String  valueOf(boolean b)

boolean인수의 캐릭터 라인 표현을 리턴합니다.

파라미터:: b - boolean
반환값:: 인수가 true인 경우는 「true」에 동일한 캐릭터 라인. 그렇지 않은 경우는 「false」에 동일한 캐릭터 라인

valueOf

public static String  valueOf(char c)

char인수의 캐릭터 라인 표현을 리턴합니다.

파라미터:: c - char
반환값:: 개의 문자로서 인수 c가 포함된, 길이 1 캐릭터 라인

valueOf

public static String  valueOf(int i)

int인수의 캐릭터 라인 표현을 리턴합니다.

이 표현은개의 인수를 가지는 Integer.toString 메서드에 의해 리턴된 것과 완전히 같습니다.

파라미터:: i - int
반환값:: int인수의 캐릭터 라인 표현
관련 항목:: Integer.toString(int, int)

valueOf

public static String  valueOf(long l)

long인수의 캐릭터 라인 표현을 리턴합니다.

이 표현은개의 인수를 가지는 Long.toString 메서드에 의해 리턴된 것과 완전히 같습니다.

파라미터:: l - long
반환값:: long인수의 캐릭터 라인 표현
관련 항목:: Long.toString(long)

valueOf

public static String  valueOf(float f)

float인수의 캐릭터 라인 표현을 리턴합니다.

이 표현은개의 인수를 가지는 Float.toString 메서드에 의해 리턴된 것과 완전히 같습니다.

파라미터:: f - float
반환값:: float인수의 캐릭터 라인 표현
관련 항목:: Float.toString(float)

valueOf

public static String  valueOf(double d)

double인수의 캐릭터 라인 표현을 리턴합니다.

이 표현은개의 인수를 가지는 Double.toString 메서드에 의해 리턴된 것과 완전히 같습니다.

파라미터:: d - double
반환값:: double인수의 캐릭터 라인 표현
관련 항목:: Double.toString(double)

intern

public String  intern()

캐릭터 라인 객체의 정 준표현을 리턴합니다.

캐릭터 라인의 풀은 초기에는 빈 상태에서 클래스 String에 의해 프라이빗에 보관 유지됩니다.

intern 메서드가 불려 갔을 때에 equals(Object) 메서드에 의해 이 String 객체에 동일하면 판정되는 캐릭터 라인이 풀에 이미 있었을 경우는 풀내의 해당하는 캐릭터 라인이 리턴됩니다 . 그렇지 않은 경우는 이 String 객체가 풀에 추가되어 이 String 객체에의 참조가 리턴됩니다 .

이 때문에 임의의 2개의 캐릭터 라인 s와 t에 대해서는 s.equals(t)가 true인 경우에게만, s.intern() == t.intern()는 true가 됩니다.

모든 리터럴 캐릭터 라인 및 캐릭터 라인치 정수식이 보관 유지됩니다. 캐릭터 라인 리터럴은, 「Java 언어 사양」의 §3. 10.5 로 정의되고 있습니다.

반환값:: 이 캐릭터 라인과 같은 내용이지만, 일의의 캐릭터 라인의 풀로부터의 것임이 보증되고 있는 캐릭터 라인

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.lang 클래스 String

CASE_INSENSITIVE_ORDER

String

String

String

String

String

String

String

String

String

String

String

String

String

length

charAt

codePointAt

codePointBefore

codePointCount

offsetByCodePoints

getChars

getBytes

getBytes

getBytes

equals

contentEquals

contentEquals

equalsIgnoreCase

compareTo

compareToIgnoreCase

regionMatches

regionMatches

startsWith

startsWith

endsWith

hashCode

indexOf

indexOf

lastIndexOf

lastIndexOf

indexOf

indexOf

lastIndexOf

lastIndexOf

substring

substring

subSequence

concat

replace

matches

contains

replaceFirst

replaceAll

replace

split

split

toLowerCase

toLowerCase

toUpperCase

toUpperCase

trim

toString

toCharArray

format

format

valueOf

valueOf

valueOf

copyValueOf

copyValueOf

valueOf

valueOf

valueOf

valueOf

valueOf

valueOf

intern

java.lang
클래스 String