gis_core_map_list_get_entry()

Получение информации о доступной карте по ее идентификатору.

Прототип:

#include <gis/gishelper.h>
gis_core_map_information_t *gis_core_map_list_get_entry( gis_core_map_list_t *map_list, uint32_t map_id );

Аргументы:

map_list
Список доступных карт gis_core_map_list_t, сформированный функцией gis_core_request_maps_list().
map_id
Идентификатор карты.

Библиотека:

gishelper

Описание:

Функция производит поиск карты в списке доступных map_list и возвращает указатель на информационную структуру карты gis_core_map_information_t по уникальному идентификатору карты map_id.

Возвращаемое значение:

!NULL
Успешное завершение - возвращаемое значение соответствует указателю на информационную структуру карты с идентификатором map_id.
NULL
Возникла ошибка или map_list указывает на NULL.

Примеры использования:

gis_core_connection_t connection;
gis_core_link_init( &connection );
gis_core_link_connect( &connection, 777 );
gis_core_request_parameters_t map_desc;
gis_core_request_parameters_init( &map_desc );
gis_core_map_list_t map_list;
gis_core_map_list_init( &map_list );
if ( gis_core_request_maps_list( &connection, &map_desc, GIS_CORE_DRIVERS_SXF_LOCAL, &map_list ) != EOK ) {
printf( "gis_core_request_maps_list() failed\n" );
return 1;
}
gis_core_map_information_t *map_information;
map_information = gis_core_map_list_get_entry( &map_list, 0 );
if ( map_information->id == 0 &&
map_information->scale_denominator == 200000 &&
map_information->object_count == 8589 )
{
printf( "Correct\n" );
}
else
{
printf( "Incorrect map parameters: %d %d %d", map_information->id, map_information->scale_denominator, map_information->object_count );
return 1;
}
gis_core_map_list_free( &map_list );
gis_core_link_destroy( &connection, true );

Классификация:

ПК ЦКИ для ЗОСРВ «Нейтрино»

Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

gis_core_map_information_t, gis_core_map_list_t gis_core_map_list_free()




Предыдущий раздел: Описание API картографического фреймворка