help/inverse

   1 NAME
   2     inverse - inverse of value
   3
   4 SYNOPSIS
   5     inverse(x)
   6
   7 TYPES
   8     If x is an object of type xx, the function xx_inv has to have
   9     been defined; any conditions on x and the nature of the returned
  10     value will depend on the definition of xx_inv.
  11
  12     For non-object x:
  13
  14     x           nonzero number (real or complex) or nonsingular matrix
  15
  16     return      number or matrix
  17
  18 DESCRIPTION
  19     For real or complex x, inverse(x) returns the value of 1/x.
  20
  21     If x is a nonsingular n x n matrix and its elements are numbers or
  22     objects for which the required arithmetic operations are defined,
  23     inverse(x) returns the matrix m for which m * x = x * m = the unit
  24     n x n matrix.  The inverse m will have the same index limits as x.
  25
  26 EXAMPLE
  27     > print inverse(5/4), inverse(-2/7), inverse(3 + 4i)
  28     .8 -3.5 .12-.16i
  29
  30     > mat A[2,2] = {2,3,5,7}
  31     > print inverse(A)
  32
  33     mat [2,2] (4 elements, 4 nonzero):
  34         [0,0] = -7
  35         [0,1] = 3
  36         [1,0] = 5
  37         [1,1] = -2
  38
  39 LIMITS
  40     none
  41
  42 LINK LIBRARY
  43     void invertvalue(VALUE *x, VALUE *vres)
  44     NUMBER *qinv(NUMBER *x)
  45     COMPLEX *cinv(COMPLEX *x)
  46     MATRIX *matinv(MATRIX *x)
  47
  48 SEE ALSO
  49