_controlfp_s

Obtém e define a palavra de controle de ponto flutuante. Esta versão de _control87, _controlfp__control87_2 tem aprimoramentos de segurança, conforme descrito nos recursos de segurança no CRT.

Sintaxe

errno_t _controlfp_s(
    unsigned int *currentControl,
    unsigned int newControl,
    unsigned int mask
);

Parâmetros

currentControl
O valor de bit da palavra de controle atual.

newControl
Novos valores de bit da palavra de controle.

mask
Máscara para novos bits da palavra de controle a ser definida.

Valor retornado

Zero se tiver êxito ou um código de erro de valor errno.

Comentários

A função _controlfp_s é uma versão mais segura e independente de plataforma de _control87, que insere a palavra de controle de ponto flutuante no endereço armazenado em currentControl e a define usando newControl. Os bits nos valores indicam o estado do controle de ponto flutuante. O estado do controle de ponto flutuante permite que o programa altere os modos de precisão, arredondamento e infinito no pacote de matemática de ponto flutuante, dependendo da plataforma. Também é possível usar _controlfp_s para mascarar ou remover a máscara das exceções de ponto flutuante.

Se o valor de mask for igual a 0, _controlfp_s obterá a palavra de controle de ponto flutuante e armazenará o valor recuperado em currentControl.

Se mask for diferente de zero, um novo valor para a palavra de controle será definido: para qualquer bit que esteja definido (ou seja, igual a 1) em mask, o bit correspondente em new será usado para atualizar a palavra de controle. Em outras palavras, fpcntrl = ((fpcntrl & ~mask) | (newControl & mask)), em que fpcntrl é a palavra de controle de ponto flutuante. Nesse cenário, currentControl é definido com o valor após a conclusão da alteração; não é o valor antigo de bit da palavra de controle.

_controlfp_s é quase idêntico à função _control87 nas plataformas Intel (x86), x64 e ARM. Se você tiver as plataformas x86, x64 ou ARM como destino, use _control87 ou _controlfp_s.

A diferença entre _control87 e _controlfp_s está em como eles tratam valores Denormal. Para plataformas Intel (x86), x64 e ARM, _control87 pode definir e limpar a máscara de exceção DENORMAL OPERAND. _controlfp_s não modifica a máscara de exceção DENORMAL OPERAND. Este exemplo demonstra a diferença:

_control87( _EM_INVALID, _MCW_EM );
// DENORMAL is unmasked by this call.
unsigned int current_word = 0;
_controlfp_s( &current_word, _EM_INVALID, _MCW_EM );
// DENORMAL exception mask remains unchanged.

Os possíveis valores para a constante de máscara (mask) e os novos valores de controle (newControl) são mostrados na tabela Valores hexadecimais a seguir. Use as constantes portáteis listadas abaixo (_MCW_EM, _EM_INVALID e assim por diante) como argumentos para essas funções, em vez de fornecer os valores hexadecimais explicitamente.

Plataformas derivadas do Intel (x86) dão suporte a valores de entrada e saída DENORMAL no hardware. O comportamento do x86 é preservar valores DENORMAL. A plataforma ARM e as plataformas x64 que têm o suporte a SSE2 permitem que operandos e resultados DENORMAL sejam liberados ou forçados a zero. As funções _controlfp_s, _controlfp e _control87 fornecem uma máscara para alterar esse comportamento. O seguinte exemplo demonstra o uso dessa máscara:

unsigned int current_word = 0;
_controlfp_s(&current_word, _DN_SAVE, _MCW_DN);
// Denormal values preserved on ARM platforms and on x64 processors with
// SSE2 support. NOP on x86 platforms.
_controlfp_s(&current_word, _DN_FLUSH, _MCW_DN);
// Denormal values flushed to zero by hardware on ARM platforms
// and x64 processors with SSE2 support. Ignored on other x86 platforms.

Essa função é ignorada quando você usa /clr (Common Language Runtime Compilation) para compilar porque o CLR (Common Language Runtime) dá suporte apenas à precisão de ponto flutuante padrão.

No x64, somente a palavra de controle SSE2 armazenada no registro MXCSR é afetada. Não há suporte para alterar o modo infinito ou a precisão do ponto flutuante. Se a máscara de controle de precisão for usada na plataforma x64, a função gerará uma asserção e o manipulador de parâmetro inválido será invocado conforme descrito na validação de parâmetro.

No x86, _controlfp_s afeta as palavras de controle para o x87 e o SSE2, se presente. É possível que as duas palavras de controle sejam mutuamente inconsistentes (devido a uma chamada anterior a __control87_2, por exemplo); caso haja uma inconsistência entre as duas palavras de controle, _controlfp_s definirá o sinalizador EM_AMBIGUOUS em currentControl. É um aviso de que a palavra de controle retornada pode não representar o estado de ambas as palavras de controle de ponto flutuante com precisão.

Se a máscara não estiver definida corretamente, essa função gerará uma exceção de parâmetro inválida, conforme descrito na validação de parâmetro. Se a execução puder continuar, essa função retornará EINVAL e definirá errno como EINVAL.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, consulte o estado global no CRT.

Plataformas arm

• Não há suporte para alterar o modo infinito ou a precisão do ponto flutuante. Se a máscara de controle de precisão for usada na plataforma x64, a função gerará uma asserção e o manipulador de parâmetro inválido será invocado, conforme descrito na validação de parâmetro.
• No ARM32 (descontinuado), o Windows não dá suporte a exceções fp.
• No ARM64, desmascarar o todo _MCW_EM ou qualquer bit dele (_EM_INEXACT, _EM_UNDERFLOW, , _EM_OVERFLOW_EM_ZERODIVIDEe _EM_INVALID) altere corretamente o registro FPCR. As exceções de ponto flutuante geradas por funções matemáticas padrão, como a operação inválida, std::acossão isentas desse comportamento e podem ser ignoradas ou geradas corretamente dependendo do registro FPCR. Para obter mais informações, consulte Visão geral das Convenções da ABI ARM32.
• No ARM64EC, o Windows captura exceções de ponto flutuante do processador e as desabilita no registro FPCR. Isso garante um comportamento consistente entre diferentes variantes do processador.

Mascarar constantes e valores

Para a máscara _MCW_EM, limpá-la define a exceção, o que permite a exceção de hardware; defini-la oculta a exceção. Se ocorrer um _EM_UNDERFLOW ou _EM_OVERFLOW, nenhuma exceção de hardware será gerada até que a próxima instrução de ponto flutuante seja executada. Para gerar uma exceção de hardware imediatamente após _EM_UNDERFLOW ou _EM_OVERFLOW, chame a instrução FWAIT MASM.

Requisitos

Para obter mais informações de compatibilidade, consulte Compatibilidade.

Exemplo

// crt_contrlfp_s.c
// processor: x86
// This program uses _controlfp_s to output the FP control
// word, set the precision to 24 bits, and reset the status to
// the default.

#include <stdio.h>
#include <float.h>
#pragma fenv_access (on)

int main( void )
{
    double a = 0.1;
    unsigned int control_word;
    int err;

    // Show original FP control word and do calculation.
    err = _controlfp_s(&control_word, 0, 0);
    if ( err ) /* handle error here */;

    printf( "Original: 0x%.4x\n", control_word );
    printf( "%1.1f * %1.1f = %.15e\n", a, a, a * a );

    // Set precision to 24 bits and recalculate.
    err = _controlfp_s(&control_word, _PC_24, MCW_PC);
    if ( err ) /* handle error here */;

    printf( "24-bit:   0x%.4x\n", control_word );
    printf( "%1.1f * %1.1f = %.15e\n", a, a, a * a );

    // Restore default precision-control bits and recalculate.
    err = _controlfp_s(&control_word, _CW_DEFAULT, MCW_PC);
    if ( err ) /* handle error here */;

    printf( "Default:  0x%.4x\n", control_word );
    printf( "%1.1f * %1.1f = %.15e\n", a, a, a * a );
}

Original: 0x9001f
0.1 * 0.1 = 1.000000000000000e-002
24-bit:   0xa001f
0.1 * 0.1 = 9.999999776482582e-003
Default:  0x9001f
0.1 * 0.1 = 1.000000000000000e-002

Confira também

Suporte a matemática e ponto flutuante
_clear87, _clearfp
_status87, , _statusfp_statusfp2
_control87, , _controlfp__control87_2