Function: -

- is a function defined in data.c.

Signature

(- &optional NUMBER-OR-MARKER &rest MORE-NUMBERS-OR-MARKERS)

Documentation

Negate number or subtract numbers or markers and return the result.

With one arg, negates it. With more than one arg, subtracts all but the first from the first.

Other relevant functions are documented in the number group.

View in manual

Probably introduced at or before Emacs version 1.12.

Shortdoc

;; number
(- 3 2)
    => 1
  (- 6 3 2)
    => 1

Source Code

// Defined in /usr/src/emacs/src/data.c
{
  if (nargs == 0)
    return make_fixnum (0);
  Lisp_Object a = check_number_coerce_marker (args[0]);
  if (nargs == 1)
    {
      if (FIXNUMP (a))
	return make_int (-XFIXNUM (a));
      if (FLOATP (a))
	return make_float (-XFLOAT_DATA (a));
      mpz_neg (mpz[0], *xbignum_val (a));
      return make_integer_mpz ();
    }
  return arith_driver (Asub, nargs, args, a);
}