Programmer Guide/Command Reference/EVAL/vvset: Difference between revisions

From STX Wiki
Jump to navigationJump to search
No edit summary
No edit summary
Line 8: Line 8:
:;<var>d</var>: index increment (default=1)
:;<var>d</var>: index increment (default=1)
:;<var>n</var>: number of values to replace (default=<code>nrow(''x'')</code>)
:;<var>n</var>: number of values to replace (default=<code>nrow(''x'')</code>)
;Result 1: The result ''r'' is copy of the vector ''x''. All elements ''r''[''o''+''i''*''d''] (''i'' = 0..''n''-1) are replaced by the value ''y''.
;Result 1: The result ''r'' is copy of the vector ''x''. All elements ''r''[''o''+''i''*''d''] (with: ''i'' = 0..''n''-1) are replaced by the value ''y''.
----
----
;Usage 2: '''<code>vvset(<var>x</var> , <var>y</var> {, <var>o</var> {, <var>d</var>}})</code>'''
;Usage 2: '''<code>vvset(<var>x</var> , <var>y</var> {, <var>o</var> {, <var>d</var>}})</code>'''
Line 15: Line 15:
:;<var>o</var>: starting index, 0 <= o < <code>nrow(''x'')</code> (default=0)
:;<var>o</var>: starting index, 0 <= o < <code>nrow(''x'')</code> (default=0)
:;<var>d</var>: index increment (default=1)
:;<var>d</var>: index increment (default=1)
;Result 2: The result ''r'' is copy of the vector ''x''. All elements ''r''[''o''+''i''*''d''] (''i'' = 0..nrow(''y'')-1) are replaced by the value ''y''[''i''].
;Result 2: The result ''r'' is copy of the vector ''x''. All elements ''r''[''o''+''i''*''d''] (with: ''i'' = 0..nrow(''y'')-1) are replaced by the value ''y''[''i''].
----
----
The function failes if an index value is out of bounds.
The function failes if an index value is out of bounds.

Revision as of 08:57, 6 April 2011

Create a copy of the vector x and replace elements.


Usage 1
vvset(x , y {, o {, d, n}}})
x
source vector
y
replace value
o
starting index, 0 <= o < nrow(x) (default=0)
d
index increment (default=1)
n
number of values to replace (default=nrow(x))
Result 1
The result r is copy of the vector x. All elements r[o+i*d] (with: i = 0..n-1) are replaced by the value y.

Usage 2
vvset(x , y {, o {, d}})
x
source vector
y
replace vector
o
starting index, 0 <= o < nrow(x) (default=0)
d
index increment (default=1)
Result 2
The result r is copy of the vector x. All elements r[o+i*d] (with: i = 0..nrow(y)-1) are replaced by the value y[i].

The function failes if an index value is out of bounds.

See also
vv, vvget, vvcat, vmcol, vmrow, vsubn, vsubc

Example:

#a := eval fill(10,0,1)
#b := eval vvset($#a, -1, 1, 2, 5) 
// -> #b = { 0 , -1 , 2 , -1 , 4 , -1 , 6 , -1 , 8 , -1 }
#c := eval vvset($#b, fill(4, 9, -3), 6, 1)
// -> #c = { 0 , -1 , 2 , -1 , 4 , -1 , 9 , 6 , 3 , 0 }

<function list>

Navigation menu

Personal tools