Método MessageFormat formatToCharacterIterator() en Java con ejemplo

El método formatToCharacterIterator() de la clase java.text.MessageFormat se utiliza para formatear una array de objetos e insertarlos en el patrón del objeto de formato de mensaje.
Sintaxis: 
 

public AttributedCharacterIterator formatToCharacterIterator(Object arguments)

Parámetro : este método toma una array de objetos como un parámetro sobre el cual se realizará el formateo.
Valor devuelto: este método devuelve un iterador de carácter de atributo que describirá el valor formateado.
Excepción: este método lanza NullPointerException si el argumento es nulo.
A continuación se muestran los ejemplos para ilustrar el método formatToCharacterIterator() :
Ejemplo 1: 
 

// Java program to demonstrate
// formatToCharacterIterator() method
 
import java.text.*;
import java.util.*;
import java.io.*;
 
public class GFG {
    public static void main(String[] argv)
    {
        try {
            // creating and initializing new MessageFormat Object
            MessageFormat mf
                = new MessageFormat("{0, number, #}, {0, number, #.##}, {0, number}");
 
            // Creating and initializing an array of type Double
            // to be formated
            Object[] objs = { new Double(4.234567) };
 
            // Formatting an array of object
            // using formatToCharacterIterator() method
            CharacterIterator str = mf.formatToCharacterIterator(objs);
 
            // display the result
            System.out.print("formatted array : ");
            System.out.print(str.first());
            for (int i = 0; i <= str.getEndIndex() - 2; i++)
                System.out.print(str.next());
        }
        catch (NullPointerException e) {
            System.out.println("pattern is null ");
            System.out.println("Exception thrown : " + e);
        }
    }
}

formatted array : 4, 4.23, 4.235

Ejemplo 2: 
 

// Java program to demonstrate
// formatToCharacterIterator() method
 
import java.text.*;
import java.util.*;
import java.io.*;
 
public class GFG {
    public static void main(String[] argv)
    {
        try {
            // creating and initializing new MessageFormat Object
            MessageFormat mf
                = new MessageFormat("{0, number, #}, {0, number, #.##}, {0, number}");
 
            // Creating and initializing an array of type Double
            // to be formated
            Object[] objs = { new Double(4.234567) };
 
            // Formatting an array of object
            // using formatToCharacterIterator() method
            CharacterIterator str = mf.formatToCharacterIterator(null);
 
            // display the result
            System.out.print("formatted array : ");
            System.out.print(str.first());
            for (int i = 0; i <= str.getEndIndex() - 2; i++)
                System.out.print(str.next());
        }
        catch (NullPointerException e) {
            System.out.println("argument is null ");
            System.out.println("Exception thrown : " + e);
        }
    }
}

argument is null 
Exception thrown : java.lang.NullPointerException: formatToCharacterIterator must be passed non-null object

Referencia: https://docs.oracle.com/javase/9/docs/api/java/text/MessageFormat.html#formatToCharacterIterator-java.lang.Object-