c_cpp/etc/calc/help/swap

   1 NAME
   2     swap - swap values of two variables
   3
   4 SYNOPSIS
   5     swap(x,y)
   6
   7 TYPES
   8     x, y        lvalues, any type
   9
  10     return      null value
  11
  12 DESCRIPTION
  13    swap(x,y) assigns the value of x to a temporary location, temp say,
  14    assigns the value of x to y, and then assigns the value at temp to y.
  15
  16    swap(x,y) should not be used if the current value of one of the
  17    variables is a component of the value of the other; for example, after:
  18
  19          A = list(1,2,3); swap(A, A[[1]]);
  20
  21    A will have the value 2, but a three-member list remains in memory
  22    with no method within calc of recalling the list or freeing the
  23    memory used.
  24
  25 EXAMPLE
  26    ; x = 3/4; y = "abc"; print x, y, swap(x,y), x, y
  27    .75 abc  abc .75
  28
  29    ; A = list(1,2,3); mat B[3] = {4,5,6}; swap(A[[1]], B[1]); print A[[1]], B[1]
  30    5 2
  31
  32 LIMITS
  33     none
  34
  35 LINK LIBRARY
  36     none
  37
  38 SEE ALSO
  39     assign
  40
  41 ## Copyright (C) 1999  Landon Curt Noll
  42 ##
  43 ## Calc is open software; you can redistribute it and/or modify it under
  44 ## the terms of the version 2.1 of the GNU Lesser General Public License
  45 ## as published by the Free Software Foundation.
  46 ##
  47 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  48 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  49 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  50 ## Public License for more details.
  51 ##
  52 ## A copy of version 2.1 of the GNU Lesser General Public License is
  53 ## distributed with calc under the filename COPYING-LGPL.  You should have
  54 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  55 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  56 ##
  57 ## @(#) $Revision: 30.1 $
  58 ## @(#) $Id: swap,v 30.1 2007/03/16 11:10:42 chongo Exp $
  59 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/swap,v $
  60 ##
  61 ## Under source code control:   1995/12/18 12:34:58
  62 ## File existed as early as:    1995
  63 ##
  64 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  65 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/