View source for Programmer Guide/Command Reference/EVAL/vvset

{{DISPLAYTITLE:{{SUBPAGENAME}}}}
Create a copy of the vector ''x'' and replace elements.
----
;Usage 1: '''<code>vvset(<var>x</var> , <var>y</var> {, <var>o</var> {, <var>d</var>, <var>n</var>}}})</code>'''
:;<var>x</var>: source vector
:;<var>y</var>: replace value (scalar)
:;<var>o</var>: starting index, 0 <= o < <code>nrow(''x'')</code> (default=0)
:;<var>d</var>: index increment (default=1)
:;<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 <code>''r''[''o''+''i''*''d'']</code> (with: <code>''i'' = 0..''n''-1</code>) are replaced by the value <code>''y''</code>.
----
;Usage 2: '''<code>vvset(<var>x</var> , <var>y</var> {, <var>o</var> {, <var>d</var>}})</code>'''
:;<var>x</var>: source vector
:;<var>y</var>: replace vector
:;<var>o</var>: starting index, 0 <= o < <code>nrow(''x'')</code> (default=0)
:;<var>d</var>: index increment (default=1)
;Result 2: The result ''r'' is copy of the vector ''x''. All elements <code>''r''[''o''+''i''*''d'']</code> (with: <code>''i'' = 0..nrow(''y'')-1</code>) are replaced by the value <code>''y''[''i'']</code>.
----
The function failes if an index value is out of bounds.

;See also: [[Programmer_Guide/Command_Reference/EVAL/vv|vv]], [[Programmer_Guide/Command_Reference/EVAL/vvget|vvget]], [[Programmer_Guide/Command_Reference/EVAL/vvcat|vvcat]], [[Programmer_Guide/Command_Reference/EVAL/vmcol|vmcol]], [[Programmer_Guide/Command_Reference/EVAL/vmrow|vmrow]], [[Programmer_Guide/Command_Reference/EVAL/vsubn|vsubn]], [[Programmer_Guide/Command_Reference/EVAL/vsubc|vsubc]]

Example:
<pre>
#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 }
// reverse vector indeces
#arev := eval vvset($#a, $#a, $#a[], -1)
// -> #arev = { 9 , 8 , 7 , 6 , 5 , 4 , 3 , 2 , 1 , 0 }
</pre>

[[Programmer_Guide/Command_Reference/EVAL#Functions|<function list>]]