D3 Reference Manual

Index | Help

Поиск по страницам

Разделы / С-функции / _CP_key

_CP_key

key (функциональность оператора FlashBASIC)

int _CP_key(CPSTR* string1, int expression,
 CPSTR** string2, CPSTR** string3, int* value)

Эквивалентна следующему оператору FlashBASIC:

key(string1, string2, string3)

Из C доступен дополнительный параметр "value", который возвращает текущее значение ключа, если ключ многозначен (multi-valued).

В случае ошибки эта функция возвращает "-1". Код ошибки содержится в _CP_errno. Если оператор "key" недействителен, переменная _CP_errno содержит PE_ILL_KEY. Если неправилен указатель "root", переменная _CP_errno содержит PE_NOTROOT.

Примеры:

Следующий пример получает первый идентификатор записи, где атрибут 1 равен "a".

CPSTR * n = _CP_mkstr("myfile");
CPSTR * a = _CP_mkstr("a1");
CPSTR * op = _CP_mkstr("n");
CPSTR * k = _CP_mkstr("a");
CPSTR * i = _CP_str_null;
int r,dummy;
_CP_root(n,a,&r);
_CP_key(op,r,&k,&i,&dummy);