_fpieee_flt

Artigo
06/09/2015

Invoca um manipulador de armadilha definido pelo usuário para exceções de ponto flutuante IEEE.

int _fpieee_flt( 
   unsigned long excCode,
   struct _EXCEPTION_POINTERS *excInfo,
   int handler(_FPIEEE_RECORD *) 
);

Parâmetros

excCode
Código da exceção.
excInfo
Ponteiro para a estrutura de informações da exceção do Windows NT.
handler
Ponteiro para a rotina de armadilha- manipulador do IEEE do usuário.

Valor de retorno

O valor de retorno de _fpieee_flt é o valor retornado por handler. Como tal, a rotina de filtro IEEE pode ser usada na cláusula FROM de um mecanismo estruturado de (SEH) manipulação de exceções gerais.

Comentários

A função de _fpieee_flt invoca um manipulador de armadilha definido pelo usuário para exceções de ponto flutuante IEEE e fornecê-lo com todas as informações relevantes. Esta rotina serve como um filtro de exceção no mecanismo, que invoca seu próprio manipulador de exceção IEEE quando necessário.

A estrutura de _FPIEEE_RECORD , definida em Fpieee.h, contém informações que pertencem a uma exceção de ponto flutuante IEEE. Essa estrutura é passada para o manipulador de armadilha definida pelo usuário por _fpieee_flt.

campo de _FPIEEE_RECORD	Descrição
unsigned int RoundingMode, unsigned int Precision	Esses campos contiverem informações sobre o ambiente de ponto flutuante na exceção.
unsigned int Operation	Indica o tipo de operação que causou a armadilha. Se o tipo for uma comparação (_FpCodeCompare), você pode fornecer um dos valores especiais de _FPIEEE_COMPARE_RESULT (conforme definido em Fpieee.h) no campo de Result.Value . O tipo de conversão (_FpCodeConvert) indica que a armadilha durante uma operação de ponto flutuante de conversão. Você pode assistir Operand1 e Result tipos para determinar o tipo de conversão que está sendo tentada.
_FPIEEE_VALUE Operand1, _FPIEEE_VALUE Operand2, _FPIEEE_VALUE Result	Essas estruturas indica os tipos e os valores de resultado dos operandos e propõe: OperandValid Sinalizador que indica se o valor de resposta é válido. Format Tipo de dados do valor correspondente. O tipo de formato pode ser retornado se o valor correspondente não é válido. Value Valor de dados do resultado ou do operando.
_FPIEEE_EXCEPTION_FLAGS Cause, _FPIEEE_EXCEPTION_FLAGS Enable, _FPIEEE_EXCEPTION_FLAGS Status	o _FPIEEE_EXCEPTION_FLAGS contém um campo de bit pelo tipo de exceção de ponto flutuante. Há uma correspondência entre esses campos e os argumentos usados para mascarar as exceções fornecidas a _controlfp. O significado de cada bit exato depende do contexto: Cause Cada bit do conjunto específico que indica a exceção foi gerada. Enable Cada bit do conjunto indica que a exceção específica estiver desmascarada atualmente. Status Cada bit do conjunto indica que a exceção específica está pendente no momento. Isso inclui as exceções que não foram gerados como foram mascaradas por _controlfp.

Durante as exceções que são desabilitadas são gerados quando você habilita as. Isso pode resultar em um comportamento indefinido ao usar _fpieee_flt como um filtro de exceção. Sempre chamada _clearfp antes de habilitar as exceções de ponto flutuante.

Requisitos

Função	Cabeçalho necessário
_fpieee_flt	<fpieee.h>

Para obter mais informações sobre compatibilidade, consulte Compatibilidade na Introdução.

Exemplo

// crt_fpieee.c
// This program demonstrates the implementation of
// a user-defined floating-point exception handler using the
// _fpieee_flt function.

#include <fpieee.h>
#include <excpt.h>
#include <float.h>
#include <stddef.h>

int fpieee_handler( _FPIEEE_RECORD * );

int fpieee_handler( _FPIEEE_RECORD *pieee )
{
   // user-defined ieee trap handler routine:
   // there is one handler for all 
   // IEEE exceptions

   // Assume the user wants all invalid 
   // operations to return 0.

   if ((pieee->Cause.InvalidOperation) && 
       (pieee->Result.Format == _FpFormatFp32)) 
   {
        pieee->Result.Value.Fp32Value = 0.0F;

        return EXCEPTION_CONTINUE_EXECUTION;
   }
   else
      return EXCEPTION_EXECUTE_HANDLER;
}

#define _EXC_MASK    \
    _EM_UNDERFLOW  + \
    _EM_OVERFLOW   + \
    _EM_ZERODIVIDE + \
    _EM_INEXACT

int main( void )
{
   // ...

   __try {
      // unmask invalid operation exception
      _controlfp_s(NULL, _EXC_MASK, _MCW_EM); 

      // code that may generate 
      // fp exceptions goes here
   }
   __except ( _fpieee_flt( GetExceptionCode(),
                GetExceptionInformation(),
                fpieee_handler ) ){

      // code that gets control 

      // if fpieee_handler returns
      // EXCEPTION_EXECUTE_HANDLER goes here

   }

   // ...
}

Equivalência do .NET Framework

Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de chamadas de plataformas.

Consulte também

Referência

Suporte de ponto flutuante

_control87, _controlfp, __control87_2

_controlfp_s

Partilhar via