Examples of org.apache.sis.measure.RangeFormat

• org.apache.sis.measure.RangeFormat
  kipedia.org/wiki/ISO_31-11">ISO 31-11 standard, except that the minimal and maximal values are separated by the " {@code …}" character instead than coma. More specifically, the format is defined as below:

  • If the range {@linkplain Range#isEmpty() is empty}, then the range is represented by " {@code} ".
  • Otherwise if the {@linkplain Range#getMinValue() minimal value} is equals to the{@linkplain Range#getMaxValue() maximal value}, then that single value is formatted inside braces as in " {@code} value}}".
  • Otherwise the minimal and maximal values are formatted inside bracket or parenthesis, depending on whether each endpoint is inclusive or exclusive:
    • " {@code [min … max]}" if both endpoints are inclusive (closed interval);
    • " {@code (min … max)}" if both endpoints are exclusive (open interval);
    • or a mix of both styles if an endpoint is inclusive while the other is exclusive.
    The " {@code ∞}" symbol is used in place of {@code min} or {@code max} for unbounded ranges.

  If the range to format is an instance of {@link MeasurementRange}, then the {@linkplain Unit unit of measurement} is appended except for empty ranges.{@section Lenient parsing}At parsing time, the above formatting rules are relaxed as below:

  • Empty ranges can be represented by " {@code []}"or " {@code ()}" in addition to the standard " {@code} ".
  • The braces are optional for singleton values, i.e. " {@code value}" is accepted as well as " {@code} value}}".

  {@section Range type and type of range elements}The kind of ranges created by the {@link #parse(String) parse(…)} methods is determinedby the type of range elements:

  • If the elements type is assignable to {@link Date}, then the {@code parse(…)} methodswill create {@code Range} objects.
  • If the elements type is assignable to {@link Number}, then:
    • If the text to parse contains a {@linkplain Unit unit of measurement}, then the {@code parse(…)} methods will create {@link MeasurementRange} objects.
    • Otherwise the {@code parse(…)} methods will create {@link NumberRange} objects.

  @author Martin Desruisseaux (Geomatys) @since 0.3 (derived from geotk-3.06) @version 0.3 @module @see Range#toString() @see Wikipedia: ISO 31-11

Related Classes of org.apache.sis.measure.RangeFormat