Admin: 1 revision imported

2021-02-07T06:52:17Z

1 revision imported

Admin at 12:44, 10 June 2019

2019-06-10T12:44:51Z

New page

{{infobox function
|name=PeekError
|object=[[Функции общего назначения]]
|caption=Функции работы с исключениями
|type=1
|status=2
|db=0
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция получает описание текущего исключения, собирая его из требуемых частей. Информация об исключении не удаляется из очереди исключений. Функцию можно использовать внутри блоков <code>Except ... EndTry</code> или <code>Finally ... EndTry</code>. Если при вызове функции в очереди исключений отсутствует по крайней мере одно исключение, функция возвратит пустую строку.

== Синтаксис ==
<code>
'''PeekError'''({{Optional|<Режим (INT)>{{Default|{{Eq}}15}}}}):''<Описание исключения (STRING)>''
</code>
==== Аргументы ====
* <code>''<Режим (INT)>''</code> - {{Optional}} Режим создания текста исключения. Параметр представляет собой битовую маску, состоящую из:
** бит 0 (1) (по умолчанию) -- включает в описание место исключения в программном тексте (в виде <code>(<Внутренний номер исключения> at <Строка>:<Столбец>)</code>)
** бит 1 (2) (по умолчанию) -- включает в описание информацию о типе исключения (к примеру <code>Division error</code>)
** бит 2 (4) (по умолчанию) -- включает в описание специфическую информацию об исключении (к примеру имя реквизита, который не был найден в заданном объекте, что послужило причиной исключения)
** бит 3 (8) (по умолчанию) -- включает в описание путь к модулю, внутри которого произошло исключение.
==== Возвращаемое значение ====
Возвращает описание исключения в виде UTF-16 строки.

== Примеры ==
<pre>
Message(1);
Try
Message(2);
Raise "Пользовательское исключение";
Message(3);
Finally
Message(4);
Message(PeekError(2),"!");
Message(PeekError(),"!");
EndTry;
Message(5);

//Последовательность выводит в лог следующую информацию:
//1
//2
//4
//User defined error
//(41 at 4:38) User defined error: Пользовательское исключение (AdmPanel.CustomTextExecute() (ExecuteTab))
//
//После чего исполнение программы прекращается с повторным выводом в лог информации об исключении:
//ERROR: (41 at 4:38) User defined error: Пользовательское исключение (AdmPanel.CustomTextExecute() (ExecuteTab))
</pre>

← Older revision	Revision as of 06:52, 7 February 2021
(No difference)

PeekError - Revision history

Admin: 1 revision imported

Admin at 12:44, 10 June 2019