Definition: | sequence res = insert(sequence src, object what, integer index) |
Description: |
Insert an object into a sequence as a new element at a given location.
target: the sequence to insert into what: the object to insert index: the position in target where what should appear Returns a sequence, which is target with one more element at index, which is what. |
Comments: |
The length of the returned sequence is always length(src) + 1.
Inserting a sequence into a string returns a dword-sequence, which is no longer a string. This routine, defined in builtins\pseqc.e, is simply src = src[1..index-1] & '0' & src[index..length(src)]; src[index] = what; return src
and is provided only for compatibility with OpenEuphoria.
|
Example: |
s = insert("John Doe", " Middle", 5) -- s is {'J','o','h','n'," Middle",' ','D','o','e'} s = insert({10,30,40}, 20, 2) -- s is {10,20,30,40} |