Skip to content

Most visited

Recently visited

Added in API level 1


public interface Formattable


Classes that handle custom formatting for the 's' specifier of Formatter should implement the Formattable interface. It gives basic control over formatting objects.

See also:


Public methods

abstract void formatTo(Formatter formatter, int flags, int width, int precision)

Formats the object using the specified Formatter.

Public methods


Added in API level 1
void formatTo (Formatter formatter, 
                int flags, 
                int width, 
                int precision)

Formats the object using the specified Formatter.

formatter Formatter: the Formatter to use.
flags int: the flags applied to the output format, which is a bitmask that is any combination of FormattableFlags.LEFT_JUSTIFY, FormattableFlags.UPPERCASE, and FormattableFlags.ALTERNATE. If no such flag is set, the output is formatted by the default formatting of the implementation.
width int: the minimum number of characters that should be written to the output. If the length of the converted value is less than width Additional space characters (' ') are added to the output if the as needed to make up the difference. These spaces are added at the beginning by default unless the flag FormattableFlags.LEFT_JUSTIFY is set, which denotes that padding should be added at the end. If width is -1, then minimum length is not enforced.
precision int: the maximum number of characters that can be written to the output. The length of the output is trimmed down to this size before the width padding is applied. If the precision is -1, then maximum length is not enforced.
IllegalFormatException if any of the parameters is not supported.
This site uses cookies to store your preferences for site-specific language and display options.


This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.