pe_geogcs_to_string_ext

Creates an extended string representation of a geographic coordinate system.

Usage syntax

void pe_geogcs_to_string_ext (PE_GEOGCS geogcs, int mode, char buffer[PE_BUFFER_MAX]);

Parameters
geogcs The geogcs object
mode The mode of the string representation
buffer The string representation of the object
Description

This function creates an extended string representation of a geographic coordinate system object.

The values for the mode parameter are:

   PE_STR_AUTH_NONE   0  /* No authority information */
   PE_STR_AUTH_TOP    1  /* Only include authority information for the top-level object */
   PE_STR_AUTH_ALL    2  /* Include authority information for all objects */

In pe_geogcs_to_string_ext, the GEOGCS is considered the top-level object. Thus, any subobjects like the DATUM and SPHEROID would not include authority information if the mode is set to PE_STR_AUTH_TOP.

Returns

None

Examples

Mode is set to PE_STR_AUTH_ALL:

GEOGCS["GCS_Deutsches_Hauptdreiecksnetz",DATUM["D_Deutsches_Hauptdreiecksnetz",SPHEROID["Bessel_1841",6377397.155,299.1528128,AUTHORITY["EPSG",7004]],AUTHORITY["EPSG",6314]],PRIMEM["Greenwich",0.0,AUTHORITY["EPSG",8901]],UNIT["Degree",0.0174532925199433,AUTHORITY["EPSG",9102]],AUTHORITY["EPSG",4314]]

Mode is set to PE_STR_AUTH_TOP:

GEOGCS["GCS_Deutsches_Hauptdreiecksnetz",DATUM["D_Deutsches_Hauptdreiecksnetz",SPHEROID["Bessel_1841",6377397.155,299.1528128]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433],AUTHORITY["EPSG",4314]]