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:

// 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);
        }
    }
}

Output:

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

Example 2:

// 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);
        }
    }
}

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–