Java String getChars()

The Java String class getChars() method copies the content of this string into a specified char array. There are four arguments passed in the getChars() method. The signature of the getChars() method is given below:

Signature

public void getChars(int srcBeginIndex, int srcEndIndex, char[] destination, int dstBeginIndex)  

Parameters

int srcBeginIndex: The index from where copying of characters is started.

int srcEndIndex: The index which is next to the last character that is getting copied.

Char[] destination: The char array where characters from the string that invokes the getChars() method is getting copied.

int dstEndIndex: It shows the position in the destination array from where the characters from the string will be pushed.

Returns

It doesn't return any value.

Exception Throws

The method throws StringIndexOutOfBoundsException when any one or more than one of the following conditions holds true.

If srcBeginIndex is less than zero.
If srcBeginIndex is greater than srcEndIndex.
If srcEndIndex is greater than the size of the string that invokes the method
If dstEndIndex is is less than zero.
If dstEndIndex + (srcEndIndex - srcBeginIndex) is greater than the size of the destination array.

Internal implementation

The signature or syntax of string getChars() method is given below:

void getChars(char dst[], int dstBegin) {  
        // copies value from 0 to dst - 1
        System.arraycopy(value, 0, dst, dstBegin, value.length);  
    }  

Java String getChars() Method Example

FileName: StringGetCharsExample.java

public class StringGetCharsExample{
public static void main(String args[]){
 String str = new String("hello javatpoint how r u");
      char[] ch = new char[10];
      try{
         str.getChars(6, 16, ch, 0);
         System.out.println(ch);
      }catch(Exception ex){System.out.println(ex);}
}}

Test it Now

Output:

javatpoint

Java String getChars() Method Example 2

The method throws an exception if index value exceeds array range. Let's see an example.

FileName: StringGetCharsExample2.java

public class StringGetCharsExample2 {
	public static void main(String[] args) {
		String str = new String("Welcome to Javatpoint");
		char[] ch  = new char[20];
		try {
			str.getChars(1, 26, ch, 0);
			System.out.println(ch);
		} catch (Exception e) {
			System.out.println(e);
		}
	}
}

Output:

java.lang.StringIndexOutOfBoundsException: offset 10, count 14, length 20

Java String getChars() Method Example 3

The getChars() method does not copy anything into the char array, provided the value of srcBeginIndex and srcEndIndex are the same. It is because the getChars() method copies from the srcBeginIndex index to srcEndIndex - 1 index. As srcBeginIndex is equal to srcEndIndex; therefore, srcEndIndex - 1 is less than srcBeginIndex. Therefore, the getChars() method copies nothing. The following example confirms the same.

FileName: StringGetCharsExample3.java

public class StringGetCharsExample3 
{
// main method
public static void main(String argvs[])
{
String str = "Welcome to JavaTpoint!";

// creating a char arry of size 25
char[] chArr = new char[25];  

// start and end indices are same
int srcBeginIndex = 11;
int srcEndIndex = 11;
int dstBeginIndex = 2;

try
{  
// invoking the method getChars()
str.getChars(srcBeginIndex, srcEndIndex, chArr, dstBeginIndex);  
System.out.println(chArr);  
}
catch(Exception excpn)
{
System.out.println(excpn);
}
System.out.println("The getChars() method prints nothing as start and end indices are equal.");  
}
}

Output:

The getChars() method prints nothing as start and end indices are equal.

Next TopicJava String indexOf()

← prev next →

Latest Courses

We provides tutorials and interview questions of all technology like java tutorial, android, java frameworks

Contact info

G-13, 2nd Floor, Sec-3, Noida, UP, 201301, India

[email protected].

Python

AI, ML and Data Science

Java

B.Tech and MCA

Web Technology

Software Testing

Technical Interview

Java Interview

Web Interview

Database Interview

Company Interviews

Java Tutorial

Control Statements

Java Object Class

Java Inheritance

Java Polymorphism

Java Abstraction

Java Encapsulation

Java Array

Java OOPs Misc

Java String

Java String Methods

Java Regex

Exception Handling

Java Inner Class

Java Multithreading

Java Synchronization

Java Networking

Java Applet

Java Reflection

Java Conversion

Java JDBC

RMI

Internationalization

Java Array Class

Java AtomicInteger Class

Java AtomicLong Methods

Java Authenticator

Java BigDecimal class

Big Integer Class

Java Boolean class

Java Byte Class

Java Class

Java Collections class

Java Compiler Class

CopyOnWriteArrayList

Java Math Methods

LinkedBlockingDeque

Java Long class

LinkedTransferQueue

Java List

Java MulticastSocket

Java Number Class

Java Phaser Class

ArrayList Methods

Java Thread Methods

Java Projects

Java Programs

Java Misc

Java Date Class

Java ListIterator Class

Java NIO Tutorial

HttpURLConnection

Java Deque

Java HttpCookie Class

Java URL class

Java List Methods

Java Vector class

Java Collection Methods

Java Socket Class

Java Executors

Java ConcurrentHashMap

Java ConcurrentLinkedQueue

Java String getChars()

Signature

Parameters

Returns

Exception Throws

Internal implementation

Java String getChars() Method Example