PCMSGetMatch

Syntax

int PCMSGetMatch(Trip trip, int index, char *buffer, int bufSize)

Parameters

• Trip trip – Handle to a trip.
• int index – The index of the matched location.
• char *buffer – The buffer where location name will be deposited.
• int bufSize – The number of bytes in the buffer.

Description

Gets a location name from a list of matches created using the PCMSLookup function.

Return Values

Returns the number of characters in the actual place name.

Sample Code

char buffer[255];

/* Lookup all cities that match */
matches = PCMSLookup(trip, "PRI*, NJ", 0);
printf ("%d matching cities to 'PRI*, NJ'\n", matches);

/* Show all the matching cities. Note: You could use variable ‘matches’ below instead, since PCMSNumMatches() == matches. */
for (i = 0; i < PCMSNumMatches(trip); i++)
{
  PCMSGetMatch(trip, i, buffer, 25);
  printf ("[%s]\n", buffer);
}

Supported Since: PC*Miler|Connect 12

Category: Geocoding