Функция AERROR()

Создает массив переменных памяти, содержащий информацию о самой последней ошибке, связанной с Visual FoxPro, OLE или ODBC.

Синтаксис:

AERROR(ArrayName)

Параметры:
ArrayName
Задает имя для массива, создаваемого функцией AERROR().

Результат:
Числовой

Комментарии:
Функция AERROR() создает массив из шести столбцов и некоторого числа строк. Тип ошибки определяет количество строк в массиве.
В приведенной ниже таблице описывается содержимое каждого элемента, формируемое в случае ошибки Visual FoxPro. В случае ошибки Visual FoxPro массив состоит из одной строки.

Номер элемента	Описание
1		Числовой. Номер ошибки. Идентичен значению, возвращаемому функцией ERROR( ).
2		Символьный. Текст сообщения об ошибке. Идентичен значению, возвращаемому функцией MESSAGE( ).
3		Значение NULL. Однако если у ошибки есть дополнительный параметр, данный элемент содержит текст этого 
		параметра ошибки. Идентичен значению, возвращаемому функцией SYS(2018).
4		Значение NULL. Однако в соответствующих случаях содержит номер рабочей области, в которой произошла ошибка.
5		Значение NULL. Однако при ошибке триггера (ошибка 1539) содержит одно из следующих числовых значений:
		1 - Ошибка триггера добавления.2 - Ошибка триггера обновления.3 - Ошибка триггера удаления.
6		Значение NULL
7		Значение NULL

В следующей таблице описывается содержимое каждого элемента, формируемое в случае ошибки OLE с номером 1427 или 1429. В случае ошибки OLE массив состоит из одной строки.

Номер элемента	Описание
1		Числовой. Содержит 1427 или 1429.
2		Символьный. Текст сообщения об ошибке Visual FoxPro.
3		Символьный. Текст сообщения об ошибке OLE.
4		Символьный. Имя приложения, например Microsoft Excel.
5		Значение NULL либо Символьный. Содержит имя того файла справки, в котором можно найти подробную информацию 
		об ошибке, если приложение может его предоставить; в противном случае содержит значение NULL.
6		Значение NULL либо Символьный. Содержит ID контекста справки для соответствующей темы, если приложение может 
		предоставить информацию; в противном случае содержит значение NULL.
7		Числовой. Ошибка  OLE 2.0.

В следующей таблице описывается содержимое каждого элемента массива, формируемое в случае ошибки ODBC с номером 1526. В случае ошибки ODBC массив состоит из двух или более строк по одной строке на каждую ошибку ODBC.

Номер элемента	Описание
1		Числовой. Содержит число 1526.
2		Символьный. Текст сообщения об ошибке.
3		Символьный. Текст сообщения об ошибке ODBC.
4		Символьный. Текущее состояние ODBC SQL.
5		Числовой. Номер ошибки от источника данных ODBC.
6		Числовой. Дескриптор связи ODBC
7		Значение NULL

Пример

* В следующем примере команда ON ERROR используется для задания
* программы обработки ошибок errhand. Ошибка генерируется выдачей
* неправильно набранной команды (BRWS). Программа errhand с помощью
* функции AERROR( ) создает массив, содержащий информацию об ошибке,
* а затем эта информация выводится на экран.
ON ERROR DO errhand	  && errhand is the error handler procedure

BRWS  && Causes a syntax error
ON ERROR  && Restore system error handler

PROCEDURE errhand
	= AERROR(aErrorArray)  && Data from most recent error
	CLEAR
	? 'The error provided the following information'  && Display message
	FOR n = 1 TO 7  && Display all elements of the array
		? aErrorArray(n)
	ENDFOR

Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Каев Артем.