next up previous contents index
Next: imag,real Up: Complex Previous: conjugate   Contents   Index


copy!


Usage

copy!(z,x,y)


Signature

copy!: (%, R, R) $\to$ %


Parameter Type Description
z % a complex
x, y R real and imaginary parts


Description

Replaces z by $x + y \sqrt{-1}$ and return z, where the storage used by z is allowed to be destroyed or reused, so z is lost after this call.


Remarks

This call may cause z to be destroyed, so do not use it unless z has been locally allocated, and is guaranteed not to share space with other elements. Some functions are not necessarily copying their arguments and can thus create memory aliases.


See Also

copy!



Manuel Bronstein 2004-06-28