Insert - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Mozilla Firefox.

Online Help

All Products    Maple    MapleSim


StringTools

  

Insert

  

insert a string into another

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

Insert( s, position, t )

Parameters

s

-

string; Maple string

t

-

string; Maple string

position

-

non-negative integer; position in s at which to insert t

Description

• 

The Insert(s, position, t) command inserts a string t into the string s at position. The value of position must be an integer in the range 0..length⁡s. Position 0 is the position before the first character of s; position 1 is the position after the first character of s; position 2 is the position after the second character of s; and so on. Thus, Insert( s, 0, t ) is equivalent to cat⁡t,s, while Insert( s, length( s ), t ) is equivalent to cat⁡s,t.

• 

All of the StringTools package commands treat strings as (null-terminated) sequences of 8-bit (ASCII) characters.  Thus, there is no support for multibyte character encodings, such as unicode encodings.

Examples

> 

with⁡StringTools:

> 

Insert⁡abcd,0,=

=abcd

(1)
> 

Insert⁡abcd,1,=

a=bcd

(2)
> 

Insert⁡abcd,2,=

ab=cd

(3)
> 

Insert⁡abcd,3,=

abc=d

(4)
> 

Insert⁡abcd,4,=

abcd=

(5)
> 

Insert⁡abcd,5,=

Error, (in StringTools:-Insert) string index `5' out of range

> 

Insert⁡,0,Foo

Foo

(6)
> 

seq⁡Insert⁡abc,n,,n=0..length⁡abc

abc

(7)

See Also

string

StringTools