_fpieee_flt

[アーティクル]
06/09/2015

IEEE 浮動小数点例外用のユーザー定義トラップハンドラーを呼び出します。

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

パラメーター

excCode
例外コード。
excInfo
Windows NT 例外情報構造体へのポインター。
handler
ユーザーの IEEE トラップハンドラールーチンへのポインター。

戻り値

_fpieee_flt の戻り値は、handler によって返される値です。そのため、構造化例外処理 (SEH) 機構の except 句で IEEE フィルタールーチンが使用される場合があります。

解説

_fpieee_flt 関数は、IEEE 浮動小数点例外用のユーザー定義トラップハンドラーを呼び出し、このハンドラーにすべての関連情報を渡します。このルーチンは SEH 機構の例外フィルターとして機能し、必要に応じて独自の IEEE 例外ハンドラーが呼び出されます。

Fpieee.h で定義されている _FPIEEE_RECORD 構造体には、IEEE 浮動小数点例外に関する情報が含まれています。この構造体は、_fpieee_flt によってユーザー定義トラップハンドラーに渡されます。

_FPIEEE_RECORD フィールド	説明
unsigned int RoundingMode, unsigned int Precision	これらのフィールドには、例外発生時の浮動小数点環境に関する情報が含まれています。
unsigned int Operation	トラップを発生させた操作の種類を示します。種類が比較 (_FpCodeCompare) の場合は、Result.Value フィールドに特別な _FPIEEE_COMPARE_RESULT 値 (Fpieee.h 内で定義) のいずれかを指定できます。変換の種類 (_FpCodeConvert) は、浮動小数点変換の操作中にトラップが発生したことを示します。 Operand1 と Result の種類を確認して、試行された変換の種類を判断できます。
_FPIEEE_VALUE Operand1, _FPIEEE_VALUE Operand2, _FPIEEE_VALUE Result	これらの構造体は、提案された結果とオペランドの型と値を示しています。 OperandValid 応答の値が有効であるかどうかを示すフラグ。 Format 対応する値のデータ型。対応する値が有効でなくても、形式の種類が返されることがあります。 Value 結果またはオペランドのデータ値。
_FPIEEE_EXCEPTION_FLAGS Cause, _FPIEEE_EXCEPTION_FLAGS Enable, _FPIEEE_EXCEPTION_FLAGS Status	_FPIEEE_EXCEPTION_FLAGS には、浮動小数点例外の種類ごとに 1 つのビットフィールドが含まれています。これらのフィールドと、_controlfp に指定される例外をマスクするために使用される引数との間には対応関係があります。各ビットの正確な意味はコンテキストに依存します。 Cause 設定されている各ビットは、発生した特定の例外を示します。 Enable 設定されている各ビットは、特定の例外が現在はマスクされていないことを示します。 Status 設定されている各ビットは、特定の例外が現在は保留中であることを示します。これには発生しなかった例外が含まれます。それらが _controlfp によってマスクされるためです。

無効になっている保留中の例外は、有効にされたときに発生します。このため、_fpieee_flt を例外フィルターとして使用した場合に、未定義の動作が生じることがあります。浮動小数点例外を有効にする前に、常に _clearfp を呼び出してください。

必要条件

関数	必須ヘッダー
_fpieee_flt	<fpieee.h>

互換性の詳細については、「C ランタイムライブラリ」の「互換性」を参照してください。

使用例

// 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

   }

   // ...
}

同等の .NET Framework 関数

使用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

次の方法で共有

_fpieee_flt

パラメーター

戻り値

解説

必要条件

使用例

同等の .NET Framework 関数

参照

関連項目

その他のリソース