Security News

### JSR Working Group Kicks Off with Ambitious Roadmap and Plans for Open Governance

At its inaugural meeting, the JSR Working Group outlined plans for an open governance model and a roadmap to enhance JavaScript package management.

Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More →

@stdlib/math-base-special-copysign

Advanced tools

Return a double-precision floating-point number with the magnitude of x and the sign of y.

@stdlib/math-base-special-copysign is a utility for copying the sign of a number to another number. This can be useful in various mathematical computations where the sign of a number needs to be manipulated or transferred.

Copying the sign of a number

This feature allows you to copy the sign of one number to another. In this example, the sign of `y` (-2.0) is copied to `x` (3.14), resulting in -3.14.

```
const copysign = require('@stdlib/math-base-special-copysign');
const x = 3.14;
const y = -2.0;
const result = copysign(x, y);
console.log(result); // -3.14
```

mathjs is a comprehensive math library for JavaScript and Node.js. It provides a wide range of mathematical functions, including the ability to manipulate the sign of numbers using the `math.sign` function. However, it is more feature-rich and general-purpose compared to @stdlib/math-base-special-copysign.

lodash is a popular utility library that provides various functions for common programming tasks, including mathematical operations. While lodash does not have a direct equivalent to `copysign`, it offers a wide range of utilities that can be used to achieve similar results through custom implementations.

We believe in a future in which the web is a preferred environment for numerical computation. To help realize this future, we've built stdlib. stdlib is a standard library, with an emphasis on numerical and scientific computation, written in JavaScript (and C) for execution in browsers and in Node.js.

The library is fully decomposable, being architected in such a way that you can swap out and mix and match APIs and functionality to cater to your exact preferences and use cases.

When you use stdlib, you can be absolutely certain that you are using the most thorough, rigorous, well-written, studied, documented, tested, measured, and high-quality code out there.

To join us in bringing numerical computing to the web, get started by checking us out on GitHub, and please consider financially supporting stdlib. We greatly appreciate your continued support!

Return a double-precision floating-point number with the magnitude of

`x`

and the sign of`y`

.

```
npm install @stdlib/math-base-special-copysign
```

```
var copysign = require( '@stdlib/math-base-special-copysign' );
```

Returns a double-precision floating-point number with the magnitude of `x`

and the sign of `y`

.

```
var z = copysign( -3.14, 10.0 );
// returns 3.14
z = copysign( 3.14, -1.0 );
// returns -3.14
z = copysign( 1.0, -0.0 );
// returns -1.0
z = copysign( -3.14, -0.0 );
// returns -3.14
z = copysign( -0.0, 1.0 );
// returns 0.0
```

- According to the IEEE754 standard, a
`NaN`

has a biased exponent equal to`2047`

, a significand greater than`0`

, and a sign bit equal to**either**`1`

**or**`0`

. In which case,`NaN`

may not correspond to just one but many binary representations. Accordingly, care should be taken to ensure that`y`

is**not**`NaN`

; otherwise, behavior may be indeterminate.

```
var randu = require( '@stdlib/random-base-randu' );
var copysign = require( '@stdlib/math-base-special-copysign' );
var x;
var y;
var z;
var i;
// Generate random double-precision floating-point numbers `x` and `y` and copy the sign of `y` to `x`...
for ( i = 0; i < 100; i++ ) {
x = (randu()*100.0) - 50.0;
y = (randu()*10.0) - 5.0;
z = copysign( x, y );
console.log( 'x: %d, y: %d => %d', x, y, z );
}
```

```
#include "stdlib/math/base/special/copysign.h"
```

Returns a double-precision floating-point number with the magnitude of `x`

and the sign of `y`

.

```
double v = stdlib_base_copysign( -3.14, 10.0 );
// returns 3.14
double v = stdlib_base_copysign( 3.14, -1.0 );
// returns -3.14
```

The function accepts the following arguments:

**x**:`[in] double`

number from which to derive a magnitude.**y**:`[in] double`

number from which to derive a sign.

```
double stdlib_base_copysign( const double x, const double y );
```

```
#include "stdlib/math/base/special/copysign.h"
#include <stdio.h>
int main( void ) {
const double x[] = { 3.14, -3.14, 0.0, 0.0/0.0 };
double y;
int i;
for ( i = 0; i < 4; i++ ) {
y = stdlib_base_copysign( x[ i ], -3.0 );
printf( "copysign(%lf, %lf) = %lf\n", x[ i ], -3.0, y );
}
}
```

`@stdlib/math-base/special/flipsign`

: return a double-precision floating-point number with the magnitude of x and the sign of x*y.

This package is part of stdlib, a standard library for JavaScript and Node.js, with an emphasis on numerical and scientific computing. The library provides a collection of robust, high performance libraries for mathematics, statistics, streams, utilities, and more.

For more information on the project, filing bug reports and feature requests, and guidance on how to develop stdlib, see the main project repository.

See LICENSE.

Copyright © 2016-2024. The Stdlib Authors.

0.2.2 (2024-07-28)

<section class="commits">`2777e4b`

-**bench:**resolve lint errors in benchmarks*(by Athan Reines)*`41d41e9`

-**test:**include trailing newlines in Julia-generated JSON fixtures*(by Philipp Burckhardt)*`9ed7d0e`

-**chore:**add missing trailing newlines*(by Philipp Burckhardt)*

A total of 2 people contributed to this release. Thank you to the following contributors:

- Athan Reines
- Philipp Burckhardt

FAQs

Return a double-precision floating-point number with the magnitude of x and the sign of y.

The npm package @stdlib/math-base-special-copysign receives a total of **283,829** weekly downloads. As such, @stdlib/math-base-special-copysign popularity was classified as **popular**.

We found that @stdlib/math-base-special-copysign demonstrated a **healthy** version release cadence and project activity because the last version was released less than a year ago. It has **0 open source maintainers** collaborating on the project.

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Security News

At its inaugural meeting, the JSR Working Group outlined plans for an open governance model and a roadmap to enhance JavaScript package management.

By Sarah Gooding - Nov 05, 2024

Security News

Research

An advanced npm supply chain attack is leveraging Ethereum smart contracts for decentralized, persistent malware control, evading traditional defenses.

By Kush Pandya, Philipp Burckhardt, Kirill Boychenko, Orlando Barrera - Oct 31, 2024

Security News

Research

Attackers are impersonating Sindre Sorhus on npm with a fake 'chalk-node' package containing a malicious backdoor to compromise developers' projects.

By Kirill Boychenko - Oct 31, 2024