select_query()

Декодирование последнего события выбора

Прототип:

#include <sys/iofunc.h>
#include <sys/dispatch.h>
                                       
int select_query( select_context_t *ctp,
                  int *fd,
                  unsigned *flags,
                  int (**func)( select_context_t *ctp,
                                int fd,
                                unsigned flags,
                                void *handle ),
                  void **handle );

Аргументы:

ctp

Указатель на структуру select_context_t, определяющую контекст события, информацию о котором необходимо получить.

fd

Указатель на переменную, где функция может хранить дескриптор файла, связанный с событием.

flags

Указатель на переменную, в которой хранятся флаги, связанные с событием (см. Флаги в описании select_attach()).

func

Указатель на переменную, в которой хранится адрес функции, связанная с событием (см. Функция в описании select_attach()).

handle

Указатель на переменную, где хранятся аргументы функции func.

Библиотека:

libc

Описание:

Функция select_query() сохраняет значения последнего события выбора для контекста ctp в переменных fd, flags, func и handle.

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

В случае ошибки функция возвращает -1. Ошибка возникает, если полученное событие не принадлежит ни одному из файловых дескрипторов, прикрепленных с помощью select_attach().

Примеры:

#include <sys/dispatch.h>
#include <stdio.h>
#include <stdlib.h>
#include <fcntl.h>
                                       
int my_func( select_context_t *ctp, int fd, unsigned flags, void *handle )
{
    ...
}
                                       
int main( int argc, char **argv )
{
    dispatch_t          *dpp;
    dispatch_context_t  *ctp;
    int                 fd;
    unsigned            flag;
    void                *handle;
    select_attr_t       *attr;
    int                 (*func)( select_context_t *, int, unsigned, void * );
                                       
    if ( ( dpp = dispatch_create() ) == NULL )
    {
        fprintf( stderr, "%s: Unable to allocate dispatch handle.\n", argv[0] );
        return (EXIT_FAILURE);
    }
                                       
    if ( argc ≤ 2 || (fd = open( argv[1], O_RDWR | O_NONBLOCK )) == -1 )
    {
        exit( 0 );
    }
        
    select_attach( dpp, attr, fd, SELECT_FLAG_READ | SELECT_FLAG_REARM,
                   &my_func, NULL );
                                       
    ctp = dispatch_context_alloc( dpp );
    ...
                                       
    if ( select_query( (select_context_t *)ctp, &fd, &flag, 
                       &func, &handle ) == -1 )
    {
        fprintf( stderr, "Failed to decode last select event.\n" );
        return (1);
    }
}

Дополнительные примеры использования интерфейса диспетчера см. в разделах dispatch_create(), message_attach(), resmgr_attach() и thread_pool_create().

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

ЗОСРВ «Нейтрино»

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

Точка остановки потока

Нет

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

Нет

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

Нет

В потоке

Да

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

select_attach(), select_detach()

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