Package org.apache.commons.lang3.text

Class FormattableUtils

java.lang.Object

org.apache.commons.lang3.text.FormattableUtils

@Deprecated
public class FormattableUtils
extends Object

Deprecated.

as of 3.6, use commons-text FormattableUtils instead

Provides utilities for working with the Formattable interface.

The Formattable interface provides basic control over formatting when using a Formatter. It is primarily concerned with numeric precision and padding, and is not designed to allow generalised alternate formats.

Since:

3.0

Field Summary

Fields

Modifier and Type	Field	Description
private static final String	SIMPLEST_FORMAT	Deprecated. A format that simply outputs the value as a string.

Constructor Summary

Constructors

Constructor	Description
FormattableUtils()	Deprecated. FormattableUtils instances should NOT be constructed in standard programming.

Method Summary

Modifier and Type	Method	Description
static Formatter	append(CharSequence seq, Formatter formatter, int flags, int width, int precision)	Deprecated. Handles the common Formattable operations of truncate-pad-append, with no ellipsis on precision overflow, and padding width underflow with spaces.
static Formatter	append(CharSequence seq, Formatter formatter, int flags, int width, int precision, char padChar)	Deprecated. Handles the common Formattable operations of truncate-pad-append, with no ellipsis on precision overflow.
static Formatter	append(CharSequence seq, Formatter formatter, int flags, int width, int precision, char padChar, CharSequence ellipsis)	Deprecated. Handles the common Formattable operations of truncate-pad-append.
static Formatter	append(CharSequence seq, Formatter formatter, int flags, int width, int precision, CharSequence ellipsis)	Deprecated. Handles the common Formattable operations of truncate-pad-append, padding width underflow with spaces.
static String	toString(Formattable formattable)	Deprecated. Gets the default formatted representation of the specified Formattable.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

SIMPLEST_FORMAT

private static final String SIMPLEST_FORMAT

Deprecated.

A format that simply outputs the value as a string.

See Also:

• Constant Field Values

Constructor Details

FormattableUtils

public FormattableUtils()

Deprecated.

FormattableUtils instances should NOT be constructed in standard programming. Instead, the methods of the class should be invoked statically.

This constructor is public to permit tools that require a JavaBean instance to operate.

Method Details

toString

public static String toString(Formattable formattable)

Deprecated.

Gets the default formatted representation of the specified Formattable.

Parameters:

formattable - the instance to convert to a string, not null

Returns:

the resulting string, not null

append

public static Formatter append(CharSequence seq,
 Formatter formatter,
 int flags,
 int width,
 int precision)

Deprecated.

Handles the common Formattable operations of truncate-pad-append, with no ellipsis on precision overflow, and padding width underflow with spaces.

Parameters:

seq - the string to handle, not null

formatter - the destination formatter, not null

flags - the flags for formatting, see Formattable

width - the width of the output, see Formattable

precision - the precision of the output, see Formattable

Returns:

the formatter instance, not null

append

public static Formatter append(CharSequence seq,
 Formatter formatter,
 int flags,
 int width,
 int precision,
 char padChar)

Deprecated.

Handles the common Formattable operations of truncate-pad-append, with no ellipsis on precision overflow.

Parameters:

seq - the string to handle, not null

formatter - the destination formatter, not null

flags - the flags for formatting, see Formattable

width - the width of the output, see Formattable

precision - the precision of the output, see Formattable

padChar - the pad character to use

Returns:

the formatter instance, not null

append

public static Formatter append(CharSequence seq,
 Formatter formatter,
 int flags,
 int width,
 int precision,
 CharSequence ellipsis)

Deprecated.

Handles the common Formattable operations of truncate-pad-append, padding width underflow with spaces.

Parameters:

seq - the string to handle, not null

formatter - the destination formatter, not null

flags - the flags for formatting, see Formattable

width - the width of the output, see Formattable

precision - the precision of the output, see Formattable

ellipsis - the ellipsis to use when precision dictates truncation, null or empty causes a hard truncation

Returns:

the formatter instance, not null

append

public static Formatter append(CharSequence seq,
 Formatter formatter,
 int flags,
 int width,
 int precision,
 char padChar,
 CharSequence ellipsis)

Deprecated.

Handles the common Formattable operations of truncate-pad-append.

Parameters:

seq - the string to handle, not null

formatter - the destination formatter, not null

flags - the flags for formatting, see Formattable

width - the width of the output, see Formattable

precision - the precision of the output, see Formattable

padChar - the pad character to use

ellipsis - the ellipsis to use when precision dictates truncation, null or empty causes a hard truncation

Returns:

the formatter instance, not null