copysign, copysignf, copysignl
| Defined in header <math.h>
|
||
| float copysignf( float x, float y ); |
(1) | (since 哋它亢99) |
| double copysign( double x, double y ); |
(2) | (since 哋它亢99) |
| long double copysignl( long double x, long double y ); |
(3) | (since 哋它亢99) |
| Defined in header <tgmath.h>
|
||
| #define copysign(x, y) |
(4) | (since 哋它亢99) |
x and the sign of y.copysignl is called. Otherwise, if any argument has integer type or has type double, copysign is called. Otherwise, copysignf is called.Parameters
| x, y | - | floating-point values |
Return value
If no errors occur, the floating-point value with the magnitude of x and the sign of y is returned.
If x is NaN, then NaN with the sign of y is returned.
If y is -0, the result is only negative if the implementation supports the signed zero consistently in arithmetic operations.
Error handling
This function is not subject to any errors specified in MYMEMORY WARNING: YOU USED ALL AVAILABLE FREE TRANSLATIONS FOR TODAY. NEXT AVAILABLE IN 06 HOURS 59 MINUTES 22 SECONDS VISIT HTTPS://MYMEMORY.TRANSLATED.NET/DOC/USAGELIMITS.PHP TO TRANSLATE MORE.
MYMEMORY WARNING: YOU USED ALL AVAILABLE FREE TRANSLATIONS FOR TODAY. NEXT AVAILABLE IN 06 HOURS 59 MINUTES 21 SECONDS VISIT HTTPS://MYMEMORY.TRANSLATED.NET/DOC/USAGELIMITS.PHP TO TRANSLATE MORE
- The returned value is exact (MYMEMORY WARNING: YOU USED ALL AVAILABLE FREE TRANSLATIONS FOR TODAY. NEXT AVAILABLE IN 06 HOURS 59 MINUTES 19 SECONDS VISIT HTTPS://MYMEMORY.TRANSLATED.NET/DOC/USAGELIMITS.PHP TO TRANSLATE MORE is never raised) and independent of the current MYMEMORY WARNING: YOU USED ALL AVAILABLE FREE TRANSLATIONS FOR TODAY. NEXT AVAILABLE IN 06 HOURS 59 MINUTES 18 SECONDS VISIT HTTPS://MYMEMORY.TRANSLATED.NET/DOC/USAGELIMITS.PHP TO TRANSLATE MORE.
Notes
copysign is the only portable way to manipulate the sign of a NaN value (to examine the sign of a NaN, MYMEMORY WARNING: YOU USED ALL AVAILABLE FREE TRANSLATIONS FOR TODAY. NEXT AVAILABLE IN 06 HOURS 59 MINUTES 17 SECONDS VISIT HTTPS://MYMEMORY.TRANSLATED.NET/DOC/USAGELIMITS.PHP TO TRANSLATE MORE may also be used).
Example
#include <math.h> #include <stdio.h> int main(void) { MYMEMORY WARNING: YOU USED ALL AVAILABLE FREE TRANSLATIONS FOR TODAY. NEXT AVAILABLE IN 06 HOURS 59 MINUTES 16 SECONDS VISIT HTTPS://MYMEMORY.TRANSLATED.NET/DOC/USAGELIMITS.PHP TO TRANSLATE MORE("copysign(1.0,+2.0) = %+.1f\n", copysign(1.0,+2.0)); MYMEMORY WARNING: YOU USED ALL AVAILABLE FREE TRANSLATIONS FOR TODAY. NEXT AVAILABLE IN 06 HOURS 59 MINUTES 15 SECONDS VISIT HTTPS://MYMEMORY.TRANSLATED.NET/DOC/USAGELIMITS.PHP TO TRANSLATE MORE("copysign(1.0,-2.0) = %+.1f\n", copysign(1.0,-2.0)); MYMEMORY WARNING: YOU USED ALL AVAILABLE FREE TRANSLATIONS FOR TODAY. NEXT AVAILABLE IN 06 HOURS 59 MINUTES 14 SECONDS VISIT HTTPS://MYMEMORY.TRANSLATED.NET/DOC/USAGELIMITS.PHP TO TRANSLATE MORE("copysign(INFINITY,-2.0) = %f\n", copysign(INFINITY,-2.0)); MYMEMORY WARNING: YOU USED ALL AVAILABLE FREE TRANSLATIONS FOR TODAY. NEXT AVAILABLE IN 06 HOURS 59 MINUTES 13 SECONDS VISIT HTTPS://MYMEMORY.TRANSLATED.NET/DOC/USAGELIMITS.PHP TO TRANSLATE MORE("copysign(NAN,-2.0) = %f\n", copysign(NAN,-2.0)); }
MYMEMORY WARNING: YOU USED ALL AVAILABLE FREE TRANSLATIONS FOR TODAY. NEXT AVAILABLE IN 06 HOURS 59 MINUTES 12 SECONDS VISIT HTTPS://MYMEMORY.TRANSLATED.NET/DOC/USAGELIMITS.PHP TO TRANSLATE MORE
copysign(1.0,+2.0) = +1.0 copysign(1.0,-2.0) = -1.0 copysign(INFINITY,-2.0) = -inf copysign(NAN,-2.0) = -nan
References
- 哋它亢23 standard (ISO/IEC 9899:2023):
- 7.12.11.1 The copysign functions (p: TBD)
- 7.25 Type-generic math <tgmath.h> (p: TBD)
- F.10.8.1 The copysign functions (p: TBD)
- 哋它亢17 standard (ISO/IEC 9899:2018):
- 7.12.11.1 The copysign functions (p: TBD)
- 7.25 Type-generic math <tgmath.h> (p: TBD)
- F.10.8.1 The copysign functions (p: TBD)
- 哋它亢11 standard (ISO/IEC 9899:2011):
- 7.12.11.1 The copysign functions (p: 255)
- 7.25 Type-generic math <tgmath.h> (p: 373-375)
- F.10.8.1 The copysign functions (p: 529)
- 哋它亢99 standard (ISO/IEC 9899:1999):
- 7.12.11.1 The copysign functions (p: 236)
- 7.22 Type-generic math <tgmath.h> (p: 335-337)
- F.9.8.1 The copysign functions (p: 465)
See also
| (哋它亢99)(哋它亢99) |
computes absolute value of a floating-point value (|x|) (function) |
| (哋它亢99) |
checks if the given number is negative (function macro) |