Collator getInstance(Locale) method in Java with Example

The getInstance(Locale) method of java.text.Collator class is used to get the new collator object having the desired locale.

Syntax:

public static Collator getInstance(Locale desiredLocale)

Parameter: This method takes the desired locale for which collator object has to be created.



Return Value: it provides the new collator object having the desired locale.

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

Example 1:

filter_none

edit
close

play_arrow

link
brightness_4
code

// Java program to demonstrate
// getInstance() 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_1
                = new RuleBasedCollator(simple);
  
            // Creating and initializing Collator
            // Object with Locale.UK
            // using getInstance() method
            Collator col_2
                = Collator.getInstance(Locale.UK);
  
            // display result
            if (col_1.equals(col_2))
                System.out.println(
                    col_1
                    + " is equal to "
                    + col_2);
            else
                System.out.println(
                    col_1
                    + " is not equal to "
                    + col_2);
        }
  
        catch (ClassCastException e) {
  
            System.out.println("Exception thrown : " + e);
        }
        catch (ParseException e) {
  
            System.out.println("Exception thrown : " + e);
        }
    }
}

chevron_right


Output:

java.text.RuleBasedCollator@5eb2e1c2 is not equal to java.text.RuleBasedCollator@289747d6

Example 2:

filter_none

edit
close

play_arrow

link
brightness_4
code

// Java program to demonstrate
// getInstance() method
  
import java.text.*;
import java.util.*;
import java.io.*;
  
public class GFG {
    public static void main(String[] argv)
    {
        try {
  
            // Creating and initializing Collator Object
            // with Locale.UK
            // using getInstance() method
            Collator col_1 = Collator.getInstance(Locale.UK);
  
            // Creating and initializing Collator Object
            // with Locale.US
            // using getInstance() method
            Collator col_2 = Collator.getInstance(Locale.US);
  
            // display result
            if (col_1.equals(col_2))
                System.out.println(
                    col_1
                    + " is equal to "
                    + col_2);
            else
                System.out.println(
                    col_1
                    + " is not equal to "
                    + col_2);
        }
  
        catch (ClassCastException e) {
  
            System.out.println("Exception thrown : " + e);
        }
    }
}

chevron_right


Output:

java.text.RuleBasedCollator@289747d6 is equal to java.text.RuleBasedCollator@289747d6

Reference: https://docs.oracle.com/javase/9/docs/api/java/text/Collator.html#getInstance–




My Personal Notes arrow_drop_up

Check out this Author's contributed articles.

If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.

Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.