public class Vector2DFormat extends VectorFormat<Euclidean2D>
The prefix and suffix "{" and "}" and the separator "; " can be replaced by any user-defined strings. The number format for components can be configured.
White space is ignored at parse time, even if it is in the prefix, suffix or separator specifications. So even if the default separator does include a space character that is used at format time, both input string "{1;1}" and " { 1 ; 1 } " will be parsed without error and the same vector will be returned. In the second case, however, the parse position after parsing will be just after the closing curly brace, i.e. just before the trailing space.
Note: using "," as a separator may interfere with the grouping separator
of the default NumberFormat
for the current locale. Thus it is advised
to use a NumberFormat
instance with disabled grouping in such a case.
DEFAULT_PREFIX, DEFAULT_SEPARATOR, DEFAULT_SUFFIX
Constructor and Description |
---|
Vector2DFormat()
Create an instance with default settings.
|
Vector2DFormat(NumberFormat format)
Create an instance with a custom number format for components.
|
Vector2DFormat(String prefix,
String suffix,
String separator)
Create an instance with custom prefix, suffix and separator.
|
Vector2DFormat(String prefix,
String suffix,
String separator,
NumberFormat format)
Create an instance with custom prefix, suffix, separator and format
for components.
|
Modifier and Type | Method and Description |
---|---|
StringBuffer |
format(Vector<Euclidean2D> vector,
StringBuffer toAppendTo,
FieldPosition pos)
Formats a
Vector object to produce a string. |
static Vector2DFormat |
getInstance()
Returns the default 2D vector format for the current locale.
|
static Vector2DFormat |
getInstance(Locale locale)
Returns the default 2D vector format for the given locale.
|
Vector2D |
parse(String source)
Parses a string to produce a
Vector object. |
Vector2D |
parse(String source,
ParsePosition pos)
Parses a string to produce a
Vector object. |
format, format, getAvailableLocales, getFormat, getPrefix, getSeparator, getSuffix, parseCoordinates
public Vector2DFormat()
The instance uses the default prefix, suffix and separator: "{", "}", and "; " and the default number format for components.
public Vector2DFormat(NumberFormat format)
format
- the custom format for components.public Vector2DFormat(String prefix, String suffix, String separator)
prefix
- prefix to use instead of the default "{"suffix
- suffix to use instead of the default "}"separator
- separator to use instead of the default "; "public Vector2DFormat(String prefix, String suffix, String separator, NumberFormat format)
prefix
- prefix to use instead of the default "{"suffix
- suffix to use instead of the default "}"separator
- separator to use instead of the default "; "format
- the custom format for components.public static Vector2DFormat getInstance()
public static Vector2DFormat getInstance(Locale locale)
locale
- the specific locale used by the format.public StringBuffer format(Vector<Euclidean2D> vector, StringBuffer toAppendTo, FieldPosition pos)
Vector
object to produce a string.format
in class VectorFormat<Euclidean2D>
vector
- the object to format.toAppendTo
- where the text is to be appendedpos
- On input: an alignment field, if desired. On output: the
offsets of the alignment fieldpublic Vector2D parse(String source) throws MathParseException
Vector
object.parse
in class VectorFormat<Euclidean2D>
source
- the string to parseVector
object.MathParseException
- if the beginning of the specified string
cannot be parsed.public Vector2D parse(String source, ParsePosition pos)
Vector
object.parse
in class VectorFormat<Euclidean2D>
source
- the string to parsepos
- input/output parsing parameter.Vector
object.Copyright © 2003–2016 The Apache Software Foundation. All rights reserved.