add!

Next: zero? Up: AbelianMonoid Previous: Contents Index

add!

$\begin{usage} add!(x, y) \end{usage}$

Signature

add!: (%, %) $\to$ %

$\begin{params} {\em x} & \% & An element of the monoid (to be destroyed)\\ {\em y} & \% & An element of the monoid to be added to x\\\end{params}$

$\begin{retval} Returns the sum $x + y$, where the storage used by x is allowed to be destroyed or reused, so x is lost after this call. \end{retval}$

$\begin{remarks} This function may cause x to be destroyed, so do not use it unl... ...arily copying their arguments and can thus create memory aliases. \end{remarks}$

Manuel Bronstein 2000-12-13