pe_factory_coderanges_linunit

Creates a list of code ranges for the predefined linear units

Usage syntax

const PE_CODERANGES_T * pe_factory_coderanges_linunit (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 *linu_ranges;
int num, i;

linu_ranges = pe_factory_coderanges_linunit();
num = linu_ranges->numranges;

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