411 REFERENCE · Wikibooks
Rebol Programming/move
Reference material by Wikibooks contributors. This retains its source identity and is not 411 news reporting.
USAGE:
MOVE source offset /part length /skip size /to
DESCRIPTION:
Move a value or span of values in a series.
MOVE is a function value.
ARGUMENTS:
source -- Source series (Type: series)
offset -- Offset to move by, or index to move to (Type: integer)
REFINEMENTS:
/part -- Move part of a series
length -- The length of the part to move (Type: integer)
/skip -- Treat the series as records of fixed size
size -- Size of each record (Type: integer)
/to -- Move to an index relative to the head of the series
(SPECIAL ATTRIBUTES)
catch
SOURCE CODE
move: func [
"Move a value or span of values in a series."
[catch]
source [series!] "Source series"
offset [integer!] "Offset to move by, or index to move to"
/part "Move part of a series"
length [integer!] "The length of the part to move"
/skip "Treat the series as records of fixed size"
size [integer!] "Size of each record"
/to {Move to an index relative to the head of the series}
][
unless length [length: 1]
if skip [
if 1 > size [throw-error 'script 'out-of-range size]
offset: either to [offset - 1 * size + 1] [offset * size]
length: length * size
]
part: copy/part source length
remove/part source length
insert either to [at head source offset] [
system/words/skip source offset
] part
]