Операционная система ЗОСРВ «Нейтрино» > Руководство разработчика > Основные принципы системной разработки > Запуск системы, быстрая активация устройств > Построение встраиваемых систем > API библиотек libipl и libstartup > as_find()

as_find()

Поиск заданного элемента в разделе asinfo системной страницы

Прототип:

#include <sys/startup.h>
    
unsigned as_find( unsigned start,
                  ... );

Аргументы:

start: AS_NULL_OFF или начальная позиция для поиска заданного элемента.

Описание:

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

При первом вызове функции следует указывать для start значение AS_NULL_OFF. Если обнаруженный элемент не является искомым, значение, которое возвращено первым вызовом as_find(), используется в качестве параметра start второго вызова. Последующий поиск начинается с позиции, в которой завершился предыдущий. Можно выполнять поиск любое количество раз (передавая третьему вызову значение параметра start, возвращенное вторым вызовом, и т.д.). Искомый элемент идентифицируется последовательностью параметров char *, которые следуют за параметром start и завершаются нулевым символом. Последняя строка перед нулевым символом является именем самого нижнего элемента, участвующего в поиске; строка, предшествующая этой строке — именем элемента, который является владельцем самого нижнего элемента, и т.д.

Например, следующий вызов ищет первый элемент с именем "foobar":

item_off = as_find( AS_NULL_OFF, "foobar", NULL );

Следующий вызов ищет первый элемент с именем "foobar", владельцем которого является элемент "sam":

item_off = as_find( AS_NULL_OFF, "sam", "foobar", NULL );

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

≠AS_NULL_OFF: Cмещение искомой записи относительно начала раздела.
AS_NULL_OFF: Запрошенный элемент отсутствует.

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

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

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

as_add(), as_add_containing(), as_default(), as_find_containing(), as_info2off(), as_off2info(), as_set_checker(), as_set_priority(), init_asinfo(), struct asinfo_entry, struct syspage_entry

Построение встраиваемых систем, Типизированная память

Предыдущий раздел: перейти