TLcdLonLatParser (LuciadFusion API documentation)

java.lang.Object
- com.luciad.util.TLcdLonLatParser

All Implemented Interfaces:

ILcdParser
```
public class TLcdLonLatParser
extends Object
implements ILcdParser
```
This ILcdParser parses various string formats for longitude/latitude ordinates. The following formats are recognized:
- dd°mm'ss",ddd°mm'ss"
- dd°mm'ss.ss",ddd°mm'ss.ss"
- ddNdddE
- ddmmNdddmmE
- ddmmssNdddmmssE
- dd.ddddNdd.dddddE
- ddmm.mmmmNdddmm.mmmmE
- ddmmss.ssssNdddmmss.ssssE
- xx.x°,xxx.x°
- xx.xx°,xxx.xx°
- xx.xxx°,xxx.xxx°
- xx.xxxx°,xxx.xxxx°
- xx.xxxxx°,xxx.xxxxx°
- xx.xxxxxx°,xxx.xxxxxx°
In these formats, 'd' and 'x' stand for a digit of the degrees, 'm' stands for a digit of the minutes, and 's' stands for a digit of the seconds. Parts of the numbers may be left out, as long as they remain unambiguous. The latitude hemisphere qualifications can be 'N' or 'S', and the longitude hemisphere qualifications can be 'E' or 'W' (all case-insensitive). If the an input strings contains just a single double, it is interpreted as degrees.
The ranges of the input strings are not validated. Input like 306075N will be converted to 31 degrees, 1 minute, and 15 seconds North.
See Also:

TLcdLonLatPointFormat

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`DEC_DEG_1` Deprecated. The pattern property is not used.
`static String`	`DEC_DEG_2` Deprecated. The pattern property is not used.
`static String`	`DEC_DEG_3` Deprecated. The pattern property is not used.
`static String`	`DEC_DEG_4` Deprecated. The pattern property is not used.
`static String`	`DEC_DEG_5` Deprecated. The pattern property is not used.
`static String`	`DEC_DEG_6` Deprecated. The pattern property is not used.
`static String`	`DEFAULT` Deprecated. The pattern property is not used.
`static String`	`DEFAULT2` Deprecated. The pattern property is not used.
`static int`	`LATCOORD` Deprecated. The mode property is not used.
`static int`	`LONCOORD` Deprecated. The mode property is not used.
`static String`	`NSWE` Deprecated. The pattern property is not used.
`static String`	`NSWE2` Deprecated. The pattern property is not used.

Constructor Summary

Constructors
Constructor and Description
`TLcdLonLatParser()` Creates a new TLcdLonLatParser.
`TLcdLonLatParser(int aMode)` Deprecated. Use the constructor without parameters.
`TLcdLonLatParser(String aPattern)` Deprecated. Use the constructor without parameters.

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`int`	`getMode()` Deprecated. The mode property is not used. This method always returns -1.
`double`	`latddmmssAsDouble(String aString)` Parses the given String as a latitude ordinate.
`double`	`londdmmssAsDouble(String aString)` Parses the given String as a longitude ordinate.
`double`	`londdmmssAsDouble(String aString, int aDegFieldSize)` Deprecated. Use `ordinateAsDouble(String)`.
`double`	`ordinateAsDouble(String aString)` Parses the given String as a longitude or latitude ordinate.
`Object`	`parse(String aString)` Parses the given String as a longitude or latitude ordinate.
`Object`	`parse(String aString, int aMode)` Deprecated. Use the method `parse(String)`.
`void`	`setMode(int aNewMode)` Deprecated. The mode property is not used. This method has an empty implementation.
`void`	`setPattern(String aNewPattern)` Deprecated. The pattern property is not used.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - LATCOORD
```
public static final int LATCOORD
```
    Deprecated. The mode property is not used.
    
    Mode property for latitude coordinates.
    
    See Also:
    
    Constant Field Values
  - LONCOORD
```
public static final int LONCOORD
```
    Deprecated. The mode property is not used.
    
    Mode property for longitude coordinates.
    
    See Also:
    
    Constant Field Values
  - DEFAULT
```
public static final String DEFAULT
```
    Deprecated. The pattern property is not used.
    
    Default pattern : dd°mm'ss",ddd°mm'ss" .
    
    See Also:
    
    Constant Field Values
  - DEFAULT2
```
public static final String DEFAULT2
```
    Deprecated. The pattern property is not used.
    
    Default pattern 2: dd°mm'ss.ss",ddd°mm'ss.ss" .
    
    See Also:
    
    Constant Field Values
  - NSWE
```
public static final String NSWE
```
    Deprecated. The pattern property is not used.
    
    NSWE pattern: ddmmssNdddmmssE .
    
    See Also:
    
    Constant Field Values
  - NSWE2
```
public static final String NSWE2
```
    Deprecated. The pattern property is not used.
    
    NSWE pattern 2: ddmmss.ssssNdddmmss.ssssE .
    
    See Also:
    
    Constant Field Values
  - DEC_DEG_1
```
public static final String DEC_DEG_1
```
    Deprecated. The pattern property is not used.
    
    Decimal degrees pattern 1: xx.x°,xxx.x° .
    
    See Also:
    
    Constant Field Values
  - DEC_DEG_2
```
public static final String DEC_DEG_2
```
    Deprecated. The pattern property is not used.
    
    Decimal degrees pattern 2: xx.xx°,xxx.xx° .
    
    See Also:
    
    Constant Field Values
  - DEC_DEG_3
```
public static final String DEC_DEG_3
```
    Deprecated. The pattern property is not used.
    
    Decimal degrees pattern 3: xx.xxx°,xxx.xxx° .
    
    See Also:
    
    Constant Field Values
  - DEC_DEG_4
```
public static final String DEC_DEG_4
```
    Deprecated. The pattern property is not used.
    
    Decimal degrees pattern 4: xx.xxxx°,xxx.xxxx° .
    
    See Also:
    
    Constant Field Values
  - DEC_DEG_5
```
public static final String DEC_DEG_5
```
    Deprecated. The pattern property is not used.
    
    Decimal degrees pattern 5: xx.xxxxx°,xxx.xxxxx° .
    
    See Also:
    
    Constant Field Values
  - DEC_DEG_6
```
public static final String DEC_DEG_6
```
    Deprecated. The pattern property is not used.
    
    Decimal degrees pattern 6: xx.xxxxxx°,xxx.xxxxxx° .
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - TLcdLonLatParser
```
public TLcdLonLatParser()
```
    Creates a new TLcdLonLatParser.
  - TLcdLonLatParser
```
public TLcdLonLatParser(int aMode)
```
    Deprecated. Use the constructor without parameters.
    
    Creates a new TLcdLonLatParser with format pattern NSWE and the given mode.
    
    Parameters:
    
    aMode - the mode: LONCOORD or LATCOORD.
  - TLcdLonLatParser
```
public TLcdLonLatParser(String aPattern)
```
    Deprecated. Use the constructor without parameters.
    
    Creates a new TLcdLonLatParser with the given format pattern and mode LATCOORD.
    
    Parameters:
    
    aPattern - the pattern.
- Method Detail
  - setPattern
```
public void setPattern(String aNewPattern)
```
    Deprecated. The pattern property is not used.
    
    The pattern property is not used. This method has an empty implementation.
    
    Parameters:
    
    aNewPattern - the new pattern.
  - setMode
```
public void setMode(int aNewMode)
```
    Deprecated. The mode property is not used. This method has an empty implementation.
    
    The property mode is not used. This method has an empty implementation.
    
    Parameters:
    
    aNewMode - the new mode: LONCOORD or LATCOORD.
    
    See Also:
    
    getMode()
  - getMode
```
public int getMode()
```
    Deprecated. The mode property is not used. This method always returns -1.
    
    Returns -1. The property mode is not used.
    
    Returns:
    
    always -1
    
    See Also:
    
    setMode(int)
  - parse
```
public Object parse(String aString)
```
    Parses the given String as a longitude or latitude ordinate.
    
    Specified by:
    
    parse in interface ILcdParser
    
    Parameters:
    
    aString - the String to be parsed.
    
    Returns:
    
    the resulting ordinate, represented as a new Double, or null, when the String passed could not be interpreted as an ordinate.
  - parse
```
public Object parse(String aString,
                    int aMode)
```
    Deprecated. Use the method parse(String).
    
    The mode parameter is disregarded. Use the method parse(String).
    
    Parameters:
    
    aMode - not taken into account.
    
    aString - the String to be parsed.
    
    Returns:
    
    the resulting ordinate, represented as a new Double, or null if the parsing failed.
  - latddmmssAsDouble
```
public double latddmmssAsDouble(String aString)
```
    Parses the given String as a latitude ordinate. This method calls ordinateAsDouble(String).
    
    Parameters:
    
    aString - the String to be parsed.
    
    Returns:
    
    the resulting latitude ordinate.
    
    Throws:
    
    NumberFormatException - if the String is not in a longitude or latitude format that can be parsed.
  - londdmmssAsDouble
```
public double londdmmssAsDouble(String aString)
```
    Parses the given String as a longitude ordinate. This method calls ordinateAsDouble(String).
    
    Parameters:
    
    aString - the String to be parsed.
    
    Returns:
    
    the resulting longitude ordinate.
    
    Throws:
    
    NumberFormatException - if the String is not in a longitude or latitude format that can be parsed.
  - londdmmssAsDouble
```
public double londdmmssAsDouble(String aString,
                                int aDegFieldSize)
```
    Deprecated. Use ordinateAsDouble(String).
    
    Parses the given String as a longitude ordinate.
    
    Parameters:
    
    aString - the String to be parsed.
    
    aDegFieldSize - value in [1,2,3]: 3 means the pattern is dddmmss[EW] (e.g. 0031645E), 2 means the pattern is ddmmss[EW] (e.g. 031645E), 1 means the pattern is dmmss[EW] (e.g. 31645E).
    
    Returns:
    
    the resulting longitude ordinate.
  - ordinateAsDouble
```
public double ordinateAsDouble(String aString)
                        throws NumberFormatException
```
    Parses the given String as a longitude or latitude ordinate.
    
    Parameters:
    
    aString - the String to be parsed.
    
    Returns:
    
    the parsed ordinate.
    
    Throws:
    
    NumberFormatException - if the String is not in a longitude or latitude format that can be parsed.

LuciadFusionClass TLcdLonLatParser

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

LATCOORD

LONCOORD

DEFAULT

DEFAULT2

NSWE

NSWE2

DEC_DEG_1

DEC_DEG_2

DEC_DEG_3

DEC_DEG_4

DEC_DEG_5

DEC_DEG_6

Constructor Detail

TLcdLonLatParser

TLcdLonLatParser

TLcdLonLatParser

Method Detail

setPattern

setMode

getMode

parse

parse

latddmmssAsDouble

londdmmssAsDouble

londdmmssAsDouble

ordinateAsDouble