_matherr
Обрабатывает математические ошибки.
int _matherr(
struct _exception *except
);
Параметры
- except
Указатель на структуру, содержащую сведения об ошибке.
Возвращаемое значение
_matherr возвращает значение 0 в случае ошибки или ненулевое значение в случае успеха. Если _matherr возвращает значение 0, может отобразиться сообщение об ошибке, и errno будет равно соответствующему значению ошибки. Если _matherr возвращает ненулевое значение, сообщение об ошибке не появляется, и errno остается неизменным.
Дополнительные сведения о кодах возврата см. в разделе _doserrno, errno, _sys_errlist and _sys_nerr.
Заметки
Функция _matherr обрабатывает ошибки, создаваемые функциями математических библиотек для чисел с плавающей точкой. Эти функции вызывают _matherr в случае возникновения ошибки.
Для специальной обработки ошибок можно задать другое определение _matherr. При использовании динамически связанной версия библиотеки времени выполнения языка C (Msvcr90.dll), можно заменить процедуру _matherr по умолчанию на исполняемый файл клиента с определенной пользователем версией. Однако нельзя заменить процедуру _matherr по умолчанию в клиенте библиотеки DLL Msvcr90.dll.
При возникновении ошибки в математической процедуре _matherr вызывается с указателем на структуру типа _exception (указанной в Math.h) в качестве аргумента. Структура _exception содержит следующие элементы.
int type
Тип исключения.char *name
Имя функции, в которой возникла ошибка.double arg1, arg2
Первый и второй (если он есть) аргументы функции.double retval
Значение, возвращаемое функцией.
type определяет тип математической ошибки. Это одно из следующих значений, определенных в Math.h.
_DOMAIN
Ошибка домена аргумента._SING
Сингулярность аргумента._OVERFLOW
Ошибка переполнения диапазона._PLOSS
Частичная потеря значимости._TLOSS
Полная потеря значимости._UNDERFLOW
Результат слишком мал для представления. (Данное условие в настоящий момент не поддерживается.)
Элемент структуры name является указателем на строку, завершающуюся нуль-символом и содержащую имя функции, которая вызвала ошибку. Элементы структуры arg1 и arg2 определяют значения, вызвавшие ошибку. (Если указан только один аргумент, он хранится в arg1).
Возвращаемое значение по умолчанию для данной ошибки равно retval. Если изменить возвращаемое значение, оно должно определять, действительно ли произошла ошибка.
Требования
Подпрограмма |
Обязательный заголовок |
|---|---|
_matherr |
<math.h> |
Дополнительные сведения о совместимости см. в разделе Совместимость во введении.
Библиотеки
Все версии библиотек времени выполнения C.
Пример
// crt_matherr.c
/* illustrates writing an error routine for math
* functions. The error function must be:
* _matherr
*/
#include <math.h>
#include <string.h>
#include <stdio.h>
int main()
{
/* Do several math operations that cause errors. The _matherr
* routine handles _DOMAIN errors, but lets the system handle
* other errors normally.
*/
printf( "log( -2.0 ) = %e\n", log( -2.0 ) );
printf( "log10( -5.0 ) = %e\n", log10( -5.0 ) );
printf( "log( 0.0 ) = %e\n", log( 0.0 ) );
}
/* Handle several math errors caused by passing a negative argument
* to log or log10 (_DOMAIN errors). When this happens, _matherr
* returns the natural or base-10 logarithm of the absolute value
* of the argument and suppresses the usual error message.
*/
int _matherr( struct _exception *except )
{
/* Handle _DOMAIN errors for log or log10. */
if( except->type == _DOMAIN )
{
if( strcmp( except->name, "log" ) == 0 )
{
except->retval = log( -(except->arg1) );
printf( "Special: using absolute value: %s: _DOMAIN "
"error\n", except->name );
return 1;
}
else if( strcmp( except->name, "log10" ) == 0 )
{
except->retval = log10( -(except->arg1) );
printf( "Special: using absolute value: %s: _DOMAIN "
"error\n", except->name );
return 1;
}
}
printf( "Normal: " );
return 0; /* Else use the default actions */
}
Output
Special: using absolute value: log: _DOMAIN error
log( -2.0 ) = 6.931472e-001
Special: using absolute value: log10: _DOMAIN error
log10( -5.0 ) = 6.989700e-001
Normal: log( 0.0 ) = -1.#INF00e+000
Эквивалент в .NET Framework
Неприменимо. Для вызова стандартной функции C используйте PInvoke. Дополнительные сведения см. в разделе Примеры вызовов неуправляемого кода.