Java – String getChars() method

In this article, we will discuss how to convert String into character array using String’s getChars() method

1. String’s getChars(int srcBegin, int srcEnd, char dst[], int dstBegin) method:

  • This String method is used to copy string into destination character array
  • Parameters:
    • srcBegin      –> index of the 1st character in the string to copy
    • srcEnd         –> index after the last character in the string to copy (i.e.; srcEnd-1)
    • dst[]            –> the destination array
    • dstBegin      –> the start offset in the destination array

1.1 Method Signature:

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

1.2 Returns:

  • Return type of this method void,
  • but copies from invoking string into destination character array (provided in the method signature/prototype)

1.3 Throws:

  • IndexOutOfBoundException: throws this exception for following cases,
    • srcBegin < 0 i.e.; srcBegin is negative
    • srcBegin > srcEnd
    • srcEnd > length of the invoking string
    • dstBegin is negative i.e.; dstBegin < 0
    • dstBegin+(srcEnd-srcBegin) is larger than dst.length

2. Examples on getChars() method:

  • Sample Java program to convert string into character array &
  • finally copying the conversion into destination character array

StringGetCharsMethod.java

package in.bench.resources.string.methods;

public class StringGetCharsMethod {

	public static void main(String[] args) {

		// sample string literal
		String srcString = "BenchResources.Net has "
				+ "lot of Java tutorials";
		System.out.println("Sample string : " + srcString);

		// target character array
		char[] targetCharArr = new char[14];

		// copy from(start, end) index of src-String
		// into dest char-array
		srcString.getChars(30, 44, targetCharArr, 0);

		// printing to console
		System.out.print("\nValue inside character array : " );
		System.out.println(targetCharArr);
	}
}

Output:

Sample string : BenchResources.Net has lot of Java tutorials

Value inside character array : Java tutorials

Related Articles:

References:

Happy Coding !!
Happy Learning !!

Java - String hashCode() method
Java - String getBytes() method