Функции работы со словарем базы данных

7.7.6Функции работы со словарем базы данных

7.7.6.1Получить список терминов словаря, начиная с данного. (H)

db_name – имя базы данных

ΤΕΡΜ – поисковый термин

num_terms – число возвращаемых терминов. Если данный параметр 0, то возвращаются MAX_POSTINGS_IN_PACKETтерминов.

ВОЗВРАТ

список строк в следующей последовательности:

Далее следуют строки в следующем формате:

ЧИСЛО ССЫЛОК # ТЕРМИН СЛОВАРЯ

КОММЕНТАРИЙ

Число терминов меньше запрашиваемого, если обнаружен конец словаря.

Варианты кодов возврата, если термин не найден следующие:

TERM_NOT_EXISTS = -202;

TERM_LAST_IN_LIST = -203;

TERM_FIRST_IN_LIST = -204;

ПРИМЕР ПРОТОКОЛА

7.7.6.2Получить список терминов словаря, начиная с данного и форматировать записи, соответствующие 1-й ссылке каждого термина из этого списка. (H)

db_name – имя базы данных.

ΤΕΡΜ – поисковый термин.

num_terms – число возвращаемых терминов. Если данный параметр 0, то возвращаются MAX_POSTINGS_IN_PACKETтерминов.

format – есть 5 вариантов определить формат:

• 
  1-й вариант – строка формата;
  
• 
  2-й вариант – имя файла формата расположенного на сервере по 10 пути для базы данных db_name, предваряемого символом @ (например @brief) ;
  
• 
  3-й вариант – символ @ - в этом случае производится ОПТИМИЗИРОВАННОЕ форматирование, имя формата определяется видом записи;
  
• 
  4-й вариант – символ * - в этом случае производится форматирование как ВЫБОР ПОЛЯ, соответствующего 1-й ссылке каждого термина (например для ссылки в виде 1.200.2.3 берется 2-е[осс] повторение 200-го[метка] поля).
  
• 
  5-й вариант – пустая строка. В этом случае возвращается только список терминов.
  

ВОЗВРАТ

В 1-й строке – код возврата, который определяется тем, найден ли заданный термин TERM в словаре – если найден код возврата – ZERO, если нет – число меньше 0. Далее следуют строки в следующем формате

Число ссылок #30

Ссылка#30TERMi#30результат_форматирования

ИЛИ

ТЕРМИН СЛОВАРЯ (если задан пустой формат)

Результат_форматирования – это строка, в которой заменены разделители #10#13 на #30#31.

7.7.6.3Получить список терминов словаря, начиная с данного в обратном порядке. (P)

ПАРАМЕТРЫ

db_name – имя базы данных

ΤΕΡΜ – поисковый термин

num_terms – число возвращаемых терминов. Если данный параметр 0, то возвращаются MAX_POSTINGS_IN_PACKETтерминов.

ВОЗВРАТ

список строк в следующей последовательности:

В 1-й строке – код возврата, который определяется тем, найден ли заданный термин TERM в словаре – если найден код возврата – ZERO, если нет – число меньше 0.

Далее следуют строки в следующем формате:

Число ссылок # Термин словаря

КОММЕНТАРИЙ

Число терминов меньше запрашиваемого, если обнаружен конец словаря.

Функция парная к irbis_client_nextTRM.

ПРИМЕР ПРОТОКОЛА

	ЗАПРОС		ВОЗВРАТ
1	Код команды	P	Код команды	P
2	АРМ	R	Идентификатор	463302
3	Код команды	P	Номер команды	82
4	Идентификатор	463302
5	Номер команды	82
6
7
8
9
10
	Db_name	IBIS		-202
	term	K=		2#JR=2003
	Num_terms	6		3#JR=2002
				1#JR=2001
				1#JR=1992
				2#JR=1990
				1#JR=1989

7.7.6.4Получить список терминов словаря в обратном порядке, начиная с данного и форматировать записи соответствующие 1-й ссылке каждого термина из этого списка. (P)

ПАРАМЕТРЫ

db_name – имя базы данных

ΤΕΡΜ – поисковый термин

num_terms – число возвращаемых терминов. Если данный параметр 0, то возвращаются MAX_POSTINGS_IN_PACKET терминов.

format – есть 5 вариантов определить формат:

• 
  1-й вариант – строка формата;
  
• 
  2-й вариант – имя файла формата расположенного на сервере по 10 пути для базы данных db_name, предваряемого символом @ (например @brief) ;
  
• 
  3-й вариант – символ @ - в этом случае производится ОПТИМИЗИРОВАННОЕ форматирование, имя формата определяется видом записи;
  
• 
  4-й вариант – символ * - в этом случае производится форматирование как ВЫБОР ПОЛЯ, соответствующего 1-й ссылке каждого термина (например для ссылки в виде 1.200.2.3 берется 2-е[осс] повторение 200-го[метка] поля).
  
• 
  5-й вариант – пустая строка. В этом случае возвращается только список терминов.
  

При любом варианте перед форматированием сервер проделывает следующую операцию - в любом формате специальное сочетание символов вида *** (3 звездочки) заменяется на значение метки поля, взятого из 1-й ссылки для данного термина (например, для ссылки 1.200.1.1 формат вида v*** будет заменен на v200).

ВОЗВРАТ

список строк в следующей последовательности:

В 1-й строке – код возврата, который определяется тем, найден ли заданный термин TERM в словаре – если найден код возврата – ZERO, если нет – число меньше 0. Далее следуют строки в следующем формате

ЧИСЛО ССЫЛОК #30

Ссылка#30TERMi#30результат_форматирования

ИЛИ

ТЕРМИН СЛОВАРЯ (если задан пустой формат)

КОММЕНТАРИЙ

Результат_форматирования – это строка, в которой заменены разделители #10#13 на #30#31. Функция парная к irbis_client_nextTRMgroup.

ПРИМЕР ПРОТОКОЛА

	ЗАПРОС		ВОЗВРАТ
1	Код команды	P	Код команды	P
2	АРМ	R	Идентификатор	463302
3	Код команды	P	Номер команды	76
4	Идентификатор	463302
5	Номер команды	73
6
7
8
9
10
	Db_name	IBIS		-202
	Term	K=		2#83#8#1#1 JR=2003 Автомобильные дороги : Ежемес. ил. произв.-мас. журн. для специалистов предприятий и орг. дор. хоз-ва России и стран СНГ. - Журнал выходит с 1927г.
	Num_terms	6		3#83#8#3#2 JR=2002 Автомобильные дороги : Ежемес. ил. произв.-мас. журн. для специалистов предприятий и орг. дор. хоз-ва России и стран СНГ. - Журнал выходит с 1927г.
	format	@brief		1#49#8#1#1 JR=2001 Сибирский математический журнал. Сер.1 : Алгебра. - Журнал
				1#38#8#1#1 JR=1992 Revue Roumaine of Physique. - Журнал
				2#26#8#1#1 JR=1990 Компьютер-Пресс : Обозрение зарубежной прессы. - Журнал выходит с 1989г.
				1#26#8#3#2 JR=1989 Компьютер-Пресс : Обозрение зарубежной прессы. - Журнал выходит с 1989г.

7.7.6.5Получить список ссылок для данного термина (I)

ПАРАМЕТРЫ

db_name – имя базы данных

ΤΕΡΜ – поисковый термин

num_postings – число возвращаемых ссылок. Если данный параметр 0, то возвращаются MAX_POSTINGS_IN_PACKET ссылок.

first_posting – возможно 2 варианта значений для данного параметра:

• 
  1-й вариант – число больше 0. Это номер 1-й возвращаемой ссылки из общего списка ссылок данного термина;
  
• 
  2-й вариант – если равно 0, то возвращается только число ссылок данного термина.
  

ВОЗВРАТ

список строк в следующей последовательности:

В 1-й строке – код возврата, который определяется тем, найден ли заданный термин TERM в словаре – если найден код возврата – ZERO, если нет – число меньше 0.

Если термин найден в словаре и ИМЕЕТ ССЫЛКИ (не удален), далее следуют строки в следующем формате:

MFN#TAG#OCC#CNT, например:

0

1#200#1#1

3#200#1#1

ПРИМЕР ПРОТОКОЛА

	ЗАПРОС		ВОЗВРАТ
1	Код команды	I	Код команды	I
2	АРМ	R	Идентификатор	463302
3	Код команды	I	Номер команды	90
4	Идентификатор	463302
5	Номер команды	90
6
7
8
9
10
	Db_name	IBIS		0
	Num_postings	1		1#19#1200#1#3
	First_posting	0
	Term	K=ACTING

7.7.6.6Получить список первых ссылок для списка терминов (I)

ПАРАМЕТРЫ

db_name – имя базы данных

TERMList – список терминов

ВОЗВРАТ

список строк в следующей последовательности:

В 1-й строке – код возврата, который определяется тем, найден ли первый термин из заданного списка TERMList в словаре – если найден код возврата – ZERO, если нет – число меньше 0. Если термин ИМЕЕТ ССЫЛКИ (не удален) далее следуют строки в следующем формате:

ЧИСЛО ССЫЛОК ИЛИ 0, если термин не найден #30

1-я ссылка из списка ссылок в виде: MFN#TAG#OCC#CNT

ИЛИ

Пустая строка если термин не найден

ПРИМЕР ПРОТОКОЛА

	ЗАПРОС		ВОЗВРАТ
1	Код команды	I	Код команды	I
2	АРМ	R	Идентификатор	463302
3	Код команды	I	Номер команды	100
4	Идентификатор	463302
5	Номер команды	100
6
7
8
9
10
		IBIS		0
		0		1#19#1200#1#3
		0		2#19#1200#1#6
		K=ACTING
		K=ALGEBRAS

7.7.6.7Получить список ссылок для данного термина и форматировать записи им соответствующие. (I)

ПАРАМЕТРЫ

db_name – имя базы данных

ΤΕΡΜ – поисковый термин

num_postings – число возвращаемых ссылок. Если данный параметр 0, то возвращаются MAX_POSTINGS_IN_PACKET ссылок.

first_posting – возможно 2 варианта значений для данного параметра:

• 
  1-й вариант – число больше 0. Это номер 1-й возвращаемой ссылки из общего списка ссылок данного термина;
  
• 
  2-й вариант – если равно 0, то возвращается только число ссылок данного термина и первая ссылка (если есть). Форматирование игнорируется.
  

format – есть 5 вариантов определить формат:

• 
  1-й вариант – строка формата;
  
• 
  2-й вариант – имя файла формата расположенного на сервере по 10 пути для базы данных db_name, предваряемого символом @ (например @brief) ;
  
• 
  3-й вариант – символ @ - в этом случае производится ОПТИМИЗИРОВАННОЕ форматирование, имя формата определяется видом записи;
  
• 
  4-й вариант – символ * - в этом случае производится форматирование как ВЫБОР ПОЛЯ, соответствующего 1-й ссылке каждого термина (например для ссылки в виде 1.200.2.3 берется 2-е[осс] повторение 200-го[метка] поля).
  
• 
  5-й вариант – пустая строка. В этом случае возвращается только список терминов.
  

При любом варианте перед форматированием сервер проделывает следующую операцию - в любом формате специальное сочетание символов вида *** (3 звездочки) заменяется на значение метки поля, взятого из 1-й ссылки для данного термина (например, для ссылки 1.200.1.1 формат вида v*** будет заменен на v200).

ВОЗВРАТ

Возвращается 2 списка:

formatlist – список результатов форматирования записей, соответствующим ссылкам данного термина TERM (если найден). В Objects списка сохраняется MFN форматированной записи. Результат_форматирования – это строка, в которой заменены разделители #10#13 на #30#31.

answer – Список ссылок. В 1-й строке – код возврата, который определяется тем, найден ли заданный термин TERM в словаре: если найден – ZERO, если нет – число меньше 0. Если термин найден в словаре и ИМЕЕТ ССЫЛКИ (не удален), далее идут строки в следующем формате: MFN#TAG#OCC#CNT (см. irbis_client_posting).

ПРИМЕР ПРОТОКОЛА

	ЗАПРОС		ВОЗВРАТ
1	Код команды	I	Код команды	I
2	АРМ	R	Идентификатор	463302
3	Код команды	I	Номер команды	107
4	Идентификатор	463302
5	Номер команды	107
6
7
8
9
10
		IBIS		0
		6		19#1200#1#6#Bryant R.M. Cyclic groups acting on Lie algebras [Text], 1994. - 5,6 p.
		1		19#1922#1#6#Bryant R.M. Cyclic groups acting on Lie algebras [Text], 1994. - 5,6 p.
		@brief
		K=ALGEBRAS

7.7.6.8Актуализация записи (F)

ПАРАМЕТРЫ

db_name – имя базы данных

MFN – mfn записи, которую необходимо актуализировать. Если =0, то актуализируются все неактуализированные записи БД.

ВОЗВРАТ

ZERO если успех. Иначе код ошибки.

ПРИМЕР ПРОТОКОЛА

	ЗАПРОС		ВОЗВРАТ
1	Код команды	F	Код команды	I
2	АРМ	C	Идентификатор	463302
3	Код команды	F	Номер команды	107
4	Идентификатор	463302
5	Номер команды	107
6
7
8
9
10
	Db_name	IBIS		0
	mfn	5

жүктеу/скачать 6.79 Mb.

Достарыңызбен бөлісу: