public class Vector3DFormat extends VectorFormat<Euclidean3D>
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;1}" and " { 1 ; 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 |
---|
Vector3DFormat()
Create an instance with default settings.
|
Vector3DFormat(NumberFormat format)
Create an instance with a custom number format for components.
|
Vector3DFormat(String prefix,
String suffix,
String separator)
Create an instance with custom prefix, suffix and separator.
|
Vector3DFormat(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<Euclidean3D> vector,
StringBuffer toAppendTo,
FieldPosition pos)
Formats a
Vector3D object to produce a string. |
static Vector3DFormat |
getInstance()
Returns the default 3D vector format for the current locale.
|
static Vector3DFormat |
getInstance(Locale locale)
Returns the default 3D vector format for the given locale.
|
Vector3D |
parse(String source)
Parses a string to produce a
Vector3D object. |
Vector3D |
parse(String source,
ParsePosition pos)
Parses a string to produce a
Vector3D object. |
format, format, getAvailableLocales, getFormat, getPrefix, getSeparator, getSuffix, parseCoordinates
public Vector3DFormat()
The instance uses the default prefix, suffix and separator: "{", "}", and "; " and the default number format for components.
public Vector3DFormat(NumberFormat format)
format
- the custom format for components.public Vector3DFormat(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 Vector3DFormat(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 Vector3DFormat getInstance()
public static Vector3DFormat getInstance(Locale locale)
locale
- the specific locale used by the format.public StringBuffer format(Vector<Euclidean3D> vector, StringBuffer toAppendTo, FieldPosition pos)
Vector3D
object to produce a string.format
in class VectorFormat<Euclidean3D>
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 Vector3D parse(String source) throws MathIllegalStateException
Vector3D
object.parse
in class VectorFormat<Euclidean3D>
source
- the string to parseVector3D
object.MathIllegalStateException
- if the beginning of the specified string
cannot be parsed.public Vector3D parse(String source, ParsePosition pos)
Vector3D
object.parse
in class VectorFormat<Euclidean3D>
source
- the string to parsepos
- input/ouput parsing parameter.Vector3D
object.Copyright © 2016 Hipparchus.org. All rights reserved.