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 картографического фреймворка