doc/crop.txt

   1 PREV: concatenating.txt                        NEXT: infix_specifics.txt
   2
   3 Cropping Structures
   4
   5
   6 Intended for use with the |cat| function, crop can do some powerful
   7 things. Crop accepts a number and the data structure from which you want
   8 to crop.
   9
  10 Start by initializing some variables.
  11
  12 ------------------------------------------------------------------------
  13
  14  store("A", vcat(cat(3,5,7) cat(2,4,6) 2))
  15
  16                 (store "A" (vcat (cat 3 5 7) (cat 2 4 6) 2))
  17
  18       [3 5 7]
  19  ==>  [2 4 6]
  20       [2 2 2]
  21
  22 ------------------------------------------------------------------------
  23
  24  store("u", vcat(1,2,3))
  25
  26                 (store "u" (vcat 1 2 3))
  27
  28  ==>  (1, 2, 3)
  29
  30 ------------------------------------------------------------------------
  31
  32  crop(2,A)
  33                 (crop 2 A)
  34
  35       [3 5]
  36  ==>  [2 4]
  37       [2 2]
  38
  39 Get the 2 left columns /A/.
  40
  41 ------------------------------------------------------------------------
  42
  43  vcrop(A,2)
  44                 (vcrop A 2)
  45
  46       [3 5 7]
  47  ==>  [2 4 6]
  48
  49 Get the bottom 2 rows of /A/.
  50
  51 ------------------------------------------------------------------------
  52
  53  crop(A,1)
  54                 (crop A 1)
  55
  56  ==>  (7, 6, 2)
  57
  58 Only one column vector cropped from the right of /A/,
  59 it is automatically transformed into a vector.
  60
  61 ------------------------------------------------------------------------
  62
  63  vcrop(1,u)
  64                 (vcrop 1 u)
  65
  66  ==>  1
  67
  68 Like the previous example, only one element is cropped from vector /u/
  69 so it is returned as a plain number.
  70
  71 NOTE: To get this effect, you must use vcrop instead of crop.
  72
  73 ------------------------------------------------------------------------
  74
  75  vcrop(1,u)
  76                 (vcrop 1 u)
  77
  78  ==>  (1, 2, 3)
  79
  80 Using crop on a vector just returns it.
  81
  82 ------------------------------------------------------------------------
  83  vim:ft=:expandtab:tw=72: