gis_data_raw_map_select_object()

Выбор объекта в текущей карте разделяемой области памяти по индексу.

Прототип:

#include <gis/gis_raw.h>
   
int gis_data_raw_map_select_object( gis_data_raw_context_t ctx, uint32_t index );

Аргументы:

ctx

Контекст gis_data_raw_context_t.

index

Последовательный индекс объекта в карте.

Библиотека:

gishelper

Описание:

Функция выбирает объект в текущей карте разделяемой области памяти по указанному индексу.

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

EOK

Успешное завершение.

EINVAL

Некорректный указатель на контекст.

EBADFD

Некорректный указатель на разделяемую область памяти.

EFAULT

Некорректный указатель на текущую карту в разделяемой области памяти.

ENXIO

Некорректный указатель на текущий объект

EDOM

Не выбран текущий объект

EIO

Индекс объекта превышает количество объектов в карте

EAGAIN

Достигнут последний объект в карте.

ENOTSUP

Функция не поддерживается в ПК ЦКИ, начиная с версии 1.2 включительно. См. gis_data_raw_map_select_next_object().

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

gis_core_connection_t          connection;
gis_core_request_parameters_t  map;
gis_data_raw_context_t         raw_ctx;
gis_core_link_init( &connection );
gis_core_link_connect( &connection, 777 );
gis_core_databuffer_attach( &connection );
gis_core_request_parameters_init( &map );
gis_core_databuffer_data_request( &connection, &map, 1 );
gis_data_raw_ctx_alloc( &raw_ctx );
gis_data_raw_ctx_import_databuffer( raw_ctx );
gis_core_map_list_t map_list;
gis_core_map_list_init( &map_list );
gis_core_request_maps_list( &connection, &map, GIS_CORE_DRIVERS_SXF_LOCAL, &map_list );
gis_data_raw_select_map( raw_ctx, GIS_CORE_DRIVERS_SXF_LOCAL, map_list.entry_list[0].id );
 
if ( gis_data_raw_map_select_object( raw_ctx, 12 ) != EOK ) {
    printf( "gis_data_raw_map_select_object() failed\n" );
    gis_data_raw_ctx_free( &raw_ctx );
      gis_core_map_list_free( &map_list );
      gis_core_databuffer_detach();
      gis_core_link_destroy( &connection, true );
    return 1;
}
gis_core_class_code_t cc = gis_data_raw_object_get_class_code( raw_ctx );
printf( "%d\n", (int)cc );
 
gis_data_raw_ctx_free( &raw_ctx );
gis_core_map_list_free( &map_list );
gis_core_databuffer_detach();
gis_core_link_destroy( &connection, true );

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

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

Безопасность использования

Обработчик прерываний

Нет

Обработчик сигналов

Нет

В потоке

Нет

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

gis_data_raw_context_t, gis_data_raw_map_select_next_object()

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