std::copysign, std::copysignf, std::copysignl

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Numerik-Bibliothek

Allgemeine mathematische Funktionen
Mathematische Spezialfunktionen (C++17)
Mathematische Konstanten (C++20)
Grundlegende lineare Algebra-Algorithmen (C++26)
Datenparallele Typen (SIMD) (C++26)
Gleitkomma-Umgebung (C++11)
Komplexe Zahlen
Numerische Arrays (valarray)
Pseudozufallszahlengenerierung
Bit-Manipulation (C++20)
Faktoroperationen
gcd (C++17)	lcm (C++17)
Interpolationen
midpoint (C++20)	lerp (C++20)
Sättigungsarithmetik
add_sat (C++26) sub_sat (C++26) saturate_cast (C++26)	mul_sat (C++26) div_sat (C++26)
Generische numerische Operationen
iota (C++11) ranges::iota (C++23) accumulate inner_product adjacent_difference    partial_sum	reduce (C++17) transform_reduce (C++17) inclusive_scan (C++17) exclusive_scan (C++17) transform_inclusive_scan (C++17) transform_exclusive_scan (C++17)

 

Allgemeine mathematische Funktionen

Funktionen
Grundlegende Operationen
abs(int)labsllabsimaxabs (C++11)   abs(float)fabs divldivlldivimaxdiv (C++11)	fmod remainder (C++11)   remquo (C++11) fma (C++11) fmax (C++11) fmin (C++11) fdim (C++11) nannanfnanl (C++11)(C++11)(C++11)
Exponentialfunktionen
exp exp2 (C++11) expm1 (C++11)	log log10 log1p (C++11) log2 (C++11)
Potenzfunktionen
sqrt cbrt (C++11)	hypot (C++11) pow
Trigonometrische und hyperbolische Funktionen
sin cos tan asin acos atan atan2	sinh cosh tanh asinh (C++11) acosh (C++11) atanh (C++11)
Fehler- und Gammafunktionen
erf (C++11) erfc (C++11)	lgamma (C++11) tgamma (C++11)

Rundungsoperationen für Gleitkommazahlen
ceil floor roundlroundllround (C++11)(C++11)(C++11)	trunc (C++11) nearbyint (C++11) rintlrintllrint (C++11)(C++11)(C++11)
Gleitkomma-Manipulationsfunktionen
ldexp scalbnscalbln (C++11)(C++11) ilogb (C++11) logb (C++11)	frexp modf nextafternexttoward (C++11)(C++11) copysign (C++11)
Klassifizierung und Vergleich
fpclassify (C++11) isfinite (C++11) isinf (C++11) isnan (C++11) isnormal (C++11) signbit (C++11)	isgreater (C++11) isgreaterequal (C++11) isless (C++11) islessequal (C++11) islessgreater (C++11) isunordered (C++11)
Typen
div_t ldiv_t lldiv_t (C++11)	imaxdiv_t (C++11) float_t (C++11) double_t (C++11)
Makrokonstanten
HUGE_VALFHUGE_VALHUGE_VALL (C++11)(C++11) math_errhandlingMATH_ERRNOMATH_ERREXCEPT (C++11)   INFINITY (C++11) NAN (C++11)	Klassifizierung FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C++11)(C++11)(C++11)(C++11)(C++11)

 

Definiert in der Header-Datei <cmath>
	(1)
float        copysign ( float mag, float sgn ); double      copysign ( double mag, double sgn ); long double copysign ( long double mag, long double sgn );			(bis C++23)
constexpr /*Gleitkommazahl-Typ*/             copysign ( /*Gleitkommatyp*/ mag,                        /*Gleitkommatyp*/ sgn );			(seit C++23)
float        copysignf( float mag, float sgn );		(2)	(seit C++11) (constexpr seit C++23)
long double copysignl( long double mag, long double sgn );		(3)	(seit C++11) (constexpr seit C++23)
SIMD-Überladung (seit C++26)
Definiert im Header <simd>
template< class V0, class V1 > constexpr /*math-common-simd-t*/<V0, V1>             copysign ( const V0& v_mag, const V1& v_sgn );		(S)	(seit C++26)
Zusätzliche Überladungen (seit C++11)
Definiert in der Header-Datei <cmath>
template< class Integer > double        copysign ( Integer mag, Integer sgn );		(A)	(constexpr seit C++23)

1-3) Erzeugt einen Gleitkommawert mit dem Betrag von mag und dem Vorzeichen von sgn. Die Bibliothek stellt Überladungen von std::copysign für alle cv-unqualifizierten Gleitkommatypen als Parametertypen bereit.(seit C++23)

S) Die SIMD-Überladung führt ein elementweises std::copysign auf v_mag und v_sgn durch. (Siehe math-common-simd-t für dessen Definition.)

(seit C++26)

A) Zusätzliche Überladungen werden für alle ganzzahligen Typen bereitgestellt, die als double behandelt werden.

(seit C++11)

Parameter

mag, sgn

-

Gleitkomma- oder Ganzzahlwerte

Rückgabewert

Wenn keine Fehler auftreten, wird der Gleitkommawert mit dem Betrag von mag und dem Vorzeichen von sgn zurückgegeben.

Wenn mag NaN ist, wird NaN mit dem Vorzeichen von sgn zurückgegeben.

Wenn sgn -0 ist, ist das Ergebnis nur dann negativ, wenn die Implementierung das vorzeichenbehaftete Null konsistent in arithmetischen Operationen unterstützt.

Fehlerbehandlung

Diese Funktion unterliegt keinen Fehlern, die in math_errhandling spezifiziert sind.

Wenn die Implementierung IEEE-Gleitkomma-Arithmetik (IEC 60559) unterstützt,

• Der zurückgegebene Wert ist exakt (FE_INEXACT wird nie ausgelöst) und unabhängig von der aktuellen Rundungsmodus.

Anmerkungen

std::copysign ist der einzige portable Weg, das Vorzeichen eines NaN-Wertes zu manipulieren (um das Vorzeichen eines NaN zu untersuchen, kann auch std::signbit verwendet werden).

Die zusätzlichen Überladungen müssen nicht exakt wie (A) angegeben werden. Sie müssen nur ausreichen, um sicherzustellen, dass für ihr erstes Argument num1 und ihr zweites Argument num2

Wenn num1 oder num2 den Typ long double haben, dann hat std::copysign(num1, num2) die gleiche Wirkung wie std::copysign(static_cast<long double>(num1),               static_cast<long double>(num2)). Andernfalls, wenn num1 und/oder num2 den Typ double oder einen ganzzahligen Typ haben, dann hat std::copysign(num1, num2) die gleiche Wirkung wie std::copysign(static_cast<double>(num1),               static_cast<double>(num2)). Andernfalls, wenn num1 oder num2 den Typ float haben, dann hat std::copysign(num1, num2) die gleiche Wirkung wie std::copysign(static_cast<float>(num1),               static_cast<float>(num2)).

(bis C++23)

Wenn num1 und num2 arithmetische Typen haben, dann hat std::copysign(num1, num2) die gleiche Wirkung wie std::copysign(static_cast</*gemeinsamer Gleitkommatyp*/>(num1),               static_cast</*gemeinsamer Gleitkommatyp*/>(num2)), wobei /*gemeinsamer Gleitkommatyp*/ der Gleitkommatyp mit dem höchsten Gleitkomma-Konversionsrang und dem höchsten Gleitkomma-Konversions-Subrang zwischen den Typen von num1 und num2 ist. Argumente vom ganzzahligen Typ werden so betrachtet, als hätten sie den gleichen Gleitkomma-Konversionsrang wie double. Wenn kein solcher Gleitkommazahltyp mit dem höchsten Rang und Subrang existiert, dann führt die Überladungsauflösung nicht zu einem nutzbaren Kandidaten aus den bereitgestellten Überladungen.

(seit C++23)

Beispiel

Führen Sie diesen Code aus

#include <cmath>
#include <iostream>
 
int main()
{
    std::cout << std::showpos
              << "copysign(1.0,+2.0) = " << std::copysign(1.0, +2.0) << '\n'
              << "copysign(1.0,-2.0) = " << std::copysign(1.0, -2.0) << '\n'
              << "copysign(inf,-2.0) = " << std::copysign(INFINITY, -2.0) << '\n'
              << "copysign(NaN,-2.0) = " << std::copysign(NAN, -2.0) << '\n';
}

Ausgabe

copysign(1.0,+2.0) = +1
copysign(1.0,-2.0) = -1
copysign(inf,-2.0) = -inf
copysign(NaN,-2.0) = -nan

Siehe auch

abs(float)fabsfabsffabsl (C++11)(C++11)	Absolutwert eines Gleitkommawerts (\(\small{|x|}\)|x|) (Funktion)
signbit (C++11)	prüft, ob die gegebene Zahl negativ ist (Funktion)
C-Dokumentation für copysign