c_cpp/etc/calc/help/assign

   1 NAME
   2     =
   3
   4 SYNOPSIS
   5     a = b
   6     a = {e_1, e_2, ...[ { ... } ] }
   7
   8 TYPES
   9     a                   lvalue, current value a structure in { } case
  10
  11     b                   expression
  12
  13     e_0, e_1, ...       expressions, blanks, or initializer lists
  14
  15
  16     return              lvalue (a)
  17
  18 DESCRIPTION
  19     Here an lvalue is either a simple variable specified by an identifier,
  20     or an element of an existing structure specified by one or more
  21     qualifiers following an identifier.
  22
  23     An initializer list is a comma-separated list enclosed in braces as in
  24
  25                 {e_0, e_1, ... }
  26
  27     where each e_i is an expression, blank or initializer list.
  28
  29     a = b evaluates b, assigns its value to a, and returns a.
  30
  31     a = {e_0, e_1, ... } where the e_i are expressions or blanks,
  32     requires the current value of a to be a matrix, list
  33     or object with at least as many elements as listed e_i.  Each non-blank
  34     e_i is evaluated and its value is assigned to a[[i]]; elements a[[i]]
  35     corresponding to blank e_i are unchanged.
  36
  37     If, in a = {e_0, e_1, ...}, e_i is an initializer list, as in
  38     {e_i_0, e_1_1, ...}, the corresponding a[[i]] is to be a matrix, list
  39     or object with at least as many elements as listed e_i_j.  Depending on
  40     whether e_i_j is an expression, blank, or initializer list, one, no, or
  41     possibly more than one assignment, is made to a[[i]][[j]] or, if
  42     relevant and possible, its elements.
  43
  44     In simple assignments, = associates from right to left so that, for
  45     example,
  46
  47                 a = b = c
  48
  49     has the effect of a = (b = c) and results in assigning the value of c
  50     to both a and b.  The expression (a = b) = c is acceptable, but has the
  51     effect of a = b; a = c; in which the first assignment is superseded by
  52     the second.
  53
  54     In initializations, = { ...} associates from left to right so that,
  55     for example,
  56
  57                 a = {e_0, ... } = {v_0, ...}
  58
  59     first assigns e_0, ... to the elements of a, and then assigns v_0, ...
  60     to the result.
  61
  62     If there are side effects in the evaluations involved in executing a = b,
  63     it should be noted that the order of evaluations is: first the address
  64     for a, then the value of b, and finally the assignment.  For example if
  65     A is a matrix and i = 0, then the assignment in A[i++] = A[i] is
  66     that of A[0] = A[1].
  67
  68     If, in execution of a = b, a is changed by the evaluation of b, the
  69     value of b may be stored in an unintended or inaccessible location.  For
  70     example,
  71                 mat A[2]= {1,2};
  72                 A[0] = (A = 3);
  73
  74     results in the value 3 being stored not only as the new value for A
  75     but also at the now unnamed location earlier used for A[0].
  76
  77
  78 EXAMPLE
  79     ; b = 3+1
  80     ; a = b
  81     ; print a, b
  82     4 4
  83
  84     ; obj point {x,y}
  85     ; mat A[3] = {1, list(2,3), obj point = {4,5}}
  86
  87     ; A[1][[0]] = 6; A[2].x = 7
  88     ; print A[1]
  89
  90     list (2 elements, 2 nonzero):
  91         [[0]] = 6
  92         [[1]] = 3
  93
  94     ; print A[2]
  95     obj point {7, 5}
  96
  97     ; A = {A[2], , {9,10}}
  98     ; print A[0]
  99     obj point {7, 5}
 100
 101     ; print A[2]
 102     obj point {9, 10}
 103
 104     ; A = {, {2}}
 105     print A[1]
 106
 107     list (2 elements, 2 nonzero):
 108         [[0]] = 2
 109         [[1]] = 3
 110
 111 LIMITS
 112     none
 113
 114 LINK LIBRARY
 115     none
 116
 117 SEE ALSO
 118     swap, quomod
 119
 120 ## Copyright (C) 1999  Landon Curt Noll
 121 ##
 122 ## Calc is open software; you can redistribute it and/or modify it under
 123 ## the terms of the version 2.1 of the GNU Lesser General Public License
 124 ## as published by the Free Software Foundation.
 125 ##
 126 ## Calc is distributed in the hope that it will be useful, but WITHOUT
 127 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
 128 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
 129 ## Public License for more details.
 130 ##
 131 ## A copy of version 2.1 of the GNU Lesser General Public License is
 132 ## distributed with calc under the filename COPYING-LGPL.  You should have
 133 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
 134 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 135 ##
 136 ## @(#) $Revision: 30.1 $
 137 ## @(#) $Id: assign,v 30.1 2007/03/16 11:10:42 chongo Exp $
 138 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/assign,v $
 139 ##
 140 ## Under source code control:   1995/05/11 21:03:23
 141 ## File existed as early as:    1995
 142 ##
 143 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
 144 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/