Friday, February 13, 2026
HomeLanguagesJavaRuleBasedCollator getCollationElementIterator(String) method in Java

RuleBasedCollator getCollationElementIterator(String) method in Java

The getCollationElementIterator() method of java.text.RuleBasedCollator class is used to get the object of collation element iterator for the given string. 

Syntax:

public CollationElementIterator
       getCollationElementIterator(String source)

Parameter: This method accepts the string object as a parameter. 

Return Value: This method returns the object of collation element iterator for the given string. 

Below are the examples to illustrate the getCollationElementIterator() method: 

Example 1: 

Java




// Java program to demonstrate
// getCollationElementIterator() method
 
import java.text.*;
import java.util.*;
import java.io.*;
 
public class GFG {
    public static void main(String[] argv)
    {
        try {
 
            // Creating and initializing
            // new simple rule
            String simple
                = "< a < b < c < d";
 
            // Creating and initializing
            // new RuleBasedCollator Object
            RuleBasedCollator col
                = new RuleBasedCollator(simple);
 
            // Creating and initializing
            // the String Object
            String str = "ABABCC";
 
            // getting CollationElementIterator Object
            // for the given String
            // using getCollationElementIterator() method
            CollationElementIterator key
                = col.getCollationElementIterator(str);
 
            // display result
            System.out.println("CollationElementIterator is : "
                               + key);
        }
 
        catch (ClassCastException e) {
 
            System.out.println("Exception thrown : " + e);
        }
        catch (ParseException e) {
 
            System.out.println("Exception thrown : " + e);
        }
    }
}


Output:

CollationElementIterator is : java.text.CollationElementIterator@7d4991ad

Example 2: 

Java




// Java program to demonstrate
// getCollationElementIterator() method
 
import java.text.*;
import java.util.*;
import java.io.*;
 
public class GFG {
    public static void main(String[] argv)
    {
        try {
 
            // Creating and initializing
            // new simple rule
            String simple
                = "< a < b & a < c";
 
            // Creating and initializing
            // new RuleBasedCollator Object
            RuleBasedCollator col
                = new RuleBasedCollator(simple);
 
            // Creating and initializing the String Object
            String str = "GEeks";
 
            // getting CollationElementIterator Object
            // for the given String
            // using getCollationElementIterator() method
            CollationElementIterator key
                = col.getCollationElementIterator(str);
 
            // display result
            System.out.println("CollationElementIterator is : "
                               + key);
        }
 
        catch (ClassCastException e) {
 
            System.out.println("Exception thrown : " + e);
        }
        catch (ParseException e) {
 
            System.out.println("Exception thrown : " + e);
        }
    }
}


Output:

CollationElementIterator is : java.text.CollationElementIterator@7d4991ad

Reference: https://docs.oracle.com/javase/9/docs/api/java/text/RuleBasedCollator.html#getCollationElementIterator-java.lang.String-

RELATED ARTICLES

1 COMMENT

Most Popular

Dominic
32499 POSTS0 COMMENTS
Milvus
128 POSTS0 COMMENTS
Nango Kala
6878 POSTS0 COMMENTS
Nicole Veronica
12000 POSTS0 COMMENTS
Nokonwaba Nkukhwana
12092 POSTS0 COMMENTS
Shaida Kate Naidoo
7011 POSTS0 COMMENTS
Ted Musemwa
7248 POSTS0 COMMENTS
Thapelo Manthata
6962 POSTS0 COMMENTS
Umr Jansen
6953 POSTS0 COMMENTS