pe_factory_coderanges_verttran

Creates a list of code ranges for the predefined vertical transformations

Usage syntax

const PE_CODERANGES_T * pe_factory_coderanges_verttran (void);

Parameters
NA
Description

Each predefined object has a code or ID. Any particular object will have a code in a specific range. For instance, one of the code ranges for spheroids is 6000-6999.

The function returns the following structure:

struct pe_coderanges_t
{
int numranges; /* number of entries in the ranges structure */
const PE_RANGE_T * ranges; /* range entries
*/
} PE_CODERANGES_T;

In turn, the ranges structure is:

struct pe_range_t
{
int min_code; /* starting code in this range */
int max_code; /* ending code in this range */
char auth_name[PE_NAME_MAX]; /* authority name */
char auth_ver[PE_NAME_MAX]; /* authority version */
} PE_RANGE_T;

Returns

On success, returns the structure; on failure, returns a null pointer

Examples

const PE_CODERANGES_T *verttran_ranges;
int num, i;

verttran_ranges = pe_factory_coderanges_verttran();
num = verttran_ranges->numranges;

for ( i=0; i<num; i++ )
{
printf("%8s\t%8s\n",verttran_ranges->ranges[i].auth_name,verttran_ranges->ranges[i].auth_ver);
printf("%d - %d\n",verttran_ranges->ranges[i].min_code,verttran_ranges->ranges[i].max_code);
}