Método ChoiceFormat format() en Java con ejemplos

El método format() de la clase java.text.ChoiceFormat se usa para obtener el generador de strings adjunto del valor de formato de un valor límite particular pasado como parámetro y el texto pasado como parámetro en este método. 
Sintaxis: 
 

public StringBuffer format(double number,
                         StringBuffer toAppendTo,
                         FieldPosition status)

Parámetro : este método toma el siguiente parámetro de la siguiente manera 
 

• número: cuál es el límite particular de elección objeto de formato para el cual se debe encontrar y agregar formato
• toAppendTo: que es el nuevo texto que se agregará con el formato
• estado: que determina si no hay un estado especial para devolver

Valor de retorno: este método devuelve el valor agregado de texto y formato en forma de objeto StringBuffer. 
Excepción: este método lanza NullPointerException si el valor de toAppendto es nulo.
A continuación se muestran los ejemplos para ilustrar el método format() :
Ejemplo 1: 
 

// Java program to demonstrate
// format() method
 
import java.text.*;
import java.util.*;
import java.io.*;
 
public class GFG {
    public static void main(String[] argv)
    {
        try {
 
            // creating and initializing ChoiceFormat
            ChoiceFormat cf1
                = new ChoiceFormat(
                    "4#wed| 5#thu | 6#fri | 7#sat");
 
            // creating and initializing StringBuffer
            StringBuffer str = new StringBuffer("Sun");
 
            // getting the required format with appended text
            // ChoiceFormat Object
            // using format() method
            StringBuffer value = cf1.format(6, str, null);
 
            // display the result
            System.out.print("Formatted text with appended value: "
                             + value.toString());
        }
        catch (NullPointerException e) {
            System.out.println("str is null");
            System.out.println("Exception thrown: " + e);
        }
    }
}

Formatted text with appended value: Sunfri 

Ejemplo 2: 
 

// Java program to demonstrate
// format() method
 
import java.text.*;
import java.util.*;
import java.io.*;
 
public class GFG {
    public static void main(String[] argv)
    {
        try {
 
            // creating and initializing ChoiceFormat
            ChoiceFormat cf1
                = new ChoiceFormat(
                    "4#wed| 5#thu | 6#fri | 7#sat");
 
            // creating and initializing StringBuffer
            StringBuffer str = null;
 
            // getting the required format with appended text
            // ChoiceFormat Object
            // using format() method
            StringBuffer value = cf1.format(6, str, null);
 
            // display the result
            System.out.print("Formatted text with appended value: "
                             + value.toString());
        }
        catch (NullPointerException e) {
            System.out.println("str is null");
            System.out.println("Exception thrown: " + e);
        }
    }
}

str is null
Exception thrown: java.lang.NullPointerException

Referencia: https://docs.oracle.com/javase/9/docs/api/java/text/ChoiceFormat.html#format-double-java.lang.StringBuffer-java.text.FieldPosition-