Latitude/Longitude Format Conversions

:Associate with "Latitude/Longitude Format Conversions" More...

Functions
GEOMLIBEXPORT MISTRING	ConvertDegsToString (double value, DEGTOSTRFLAGS flags)
GEOMLIBEXPORT char *	ConvertDegsToString (char *string, double value, DEGTOSTRFLAGS flags)
GEOMLIBEXPORT bool	ConvertStringToDegs (const char *string, double *value)
GEOMLIBEXPORT void	ConvLatLonToString (double degrees, char *string, DMSTYPE desttype, CONVDMSFLAGS flags)
double	ConvLatLonValue (double value, DMSTYPE srctype)
GEOMLIBEXPORT double	ConvLatLonValue (const void *srcbuf, DMSTYPE srctype, void *destbuf, DMSTYPE desttype, CONVDMSFLAGS flags)
GEOMLIBEXPORT double	ConvStringToLatLon (const char *string, DMSTYPE srctype, CONVDMSFLAGS flags=CONVDMSFLAG_None)
GEOMLIBEXPORT const char **	GetLatLonNames (void)
GEOMLIBEXPORT DMSTYPE	GetLatLonType (int index)
GEOMLIBEXPORT ERRVALUE	GetLatLonTypeList (SIMPLE_ARRAY< DMSTYPEANDNAME > &types)

---

Detailed Description

:Associate with "Latitude/Longitude Format Conversions"

---

Function Documentation

GEOMLIBEXPORT MISTRING ConvertDegsToString	(	double	value,
		DEGTOSTRFLAGS	flags
	)

Convert Latitude or Longitude value to MISTRING.

Returns:

MISTRING containing converted value.

See also:

ConvLatLonToString, ConvertStringToDegs

Parameters:

value	Value to convert in degrees
flags	Flags defining format

GEOMLIBEXPORT char* ConvertDegsToString	(	char *	string,
		double	value,
		DEGTOSTRFLAGS	flags
	)

Convert Latitude or Longitude value to char* string.

Returns:

Pointer to string

See also:

ConvLatLonToString, ConvertStringToDegs

Parameters:

string	String to hold result
value	Value to convert in degrees
flags	Flags defining format

GEOMLIBEXPORT bool ConvertStringToDegs	(	const char *	string,
		double *	value
	)

Convert Latitude or Longitude string to decimal degrees.

Returns:

true if successful, false if not

This function automatically recognizes the following formats:

D ddd mm ss.sss D indicates direction (N, S, E or W) D ddd mm.mmmm and can be anywhere in the string D ddd.ddddd

[-]ddd mm ss.sss Sign (+ or -) is optional [-]ddd mm.mmmm Negative values indicate West and South [-]ddd.ddddd Do not type brackets []

See also:

ConvertStringToLatLon, ConvertDegsToString

GEOMLIBEXPORT void ConvLatLonToString	(	double	degrees,
		char *	string,
		DMSTYPE	desttype,
		CONVDMSFLAGS	flags
	)

Convert Latitude/Longitude value to string.

See also:

ConvertDegsToString, ConvStringToLatLon

Parameters:

degrees	Value to convert
string	String to hold result
desttype	Destination format
flags	CONVDMS_OUT_...

double ConvLatLonValue	(	double	value,
		DMSTYPE	srctype
	)			[inline]

Convert double-precision value to decimal degrees.

Returns:

Converted value in degrees.

Parameters:

value	Value to convert
srctype	Source format

Definition at line 251 of file latlonfm.h.

GEOMLIBEXPORT double ConvLatLonValue	(	const void *	srcbuf,
		DMSTYPE	srctype,
		void *	destbuf,
		DMSTYPE	desttype,
		CONVDMSFLAGS	flags
	)

Convert value to decimal degrees and/or another LatLon format.

Returns:

Converted value in degrees.

Parameters:

srcbuf	Pointer to source value, flags determine data type
srctype	Source format
destbuf	Pointer to destination location, NULL if not needed
desttype	Destination format
flags	Flags for input and output type

GEOMLIBEXPORT double ConvStringToLatLon	(	const char *	string,
		DMSTYPE	srctype,
		CONVDMSFLAGS	flags = CONVDMSFLAG_None
	)

Convert string to decimal degrees.

Returns:

Converted value in degrees.

See also:

ConvertStringToDegs, ConvLatLonToString

Parameters:

string	String to convert
srctype	String format
flags	None presently used

GEOMLIBEXPORT const char** GetLatLonNames

(

void

)

Retrieve list of built-in latitude-longitude string formats.

Returns:

NULL-terminated array of strings containing format names.

Deprecated:

Use GetLatLonTypeList

GEOMLIBEXPORT DMSTYPE GetLatLonType

(

int

index

)

Get latitude-longitude format conversion type for given index.

See also:

ConvLatLonValue, ConvLatLonToString, ConvStringToLatLon

Deprecated:

Use GetLatLonTypeList

GEOMLIBEXPORT ERRVALUE GetLatLonTypeList

(

SIMPLE_ARRAY< DMSTYPEANDNAME > &

types

)

Retrieve list of built-in latitude-longitude string formats.

See also:

ConvLatLonValue, ConvLatLonToString, ConvStringToLatLon

---