String - Maple Programming Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Programming : Data Types : Strings : String

String

construct a string from expressions

 

Calling Sequence

Parameters

Description

Examples

Compatibility

Calling Sequence

String( a, b, c, ... )

Parameters

a, b, c, ...

-

any expressions

Description

• 

The String function concatenates zero or more expressions into a single string. Unlike the cat function, String always returns a single string, never a name, unevaluated concatenation (||), or sequence.

• 

Each argument that is already a string (i.e. of type string) is appended to the result unchanged.

• 

Arguments that are of type Array with one dimension and a datatype of integer[1] (i.e. bytes) are treated as character arrays, with each entry appended to the result as a single character. If a zero valued entry is encountered, the remaining entries are skipped. This is analogous to how strings are generally used in the C and C++ (and many other) programming languages.

(The reverse transformation, converting a string into such an Array, can be easily accomplished by passing a string to the Array function, for example, Array("This is a string.").)

• 

All other arguments, x, are first converted into a 1D Maple language representation in the same form that would be produced by sprintf("%a",x), and the resulting string is appended to the result.

• 

If called with no arguments, String returns the empty string, "".

Examples

The returned value is always a string.

String

(1)

Stringa,b

ab

(2)

String1+1=,1+1

1+1=2

(3)

One-dimensional arrays of integer[1] are interpreted as strings.

hiArray72,101,108,108,111,datatype=integer1

hi72101108108111

(4)

Stringhi

Hello

(5)

All other expressions are converted into strings.

Stringx+y2

y^2+x

(6)

Stringa,1..5

a1 .. 5

(7)

Stringf,c

f()c

(8)

Stringhi,, ,world!

Hello, world!

(9)

Compatibility

• 

The String command was introduced in Maple 2019.

• 

For more information on Maple 2019 changes, see Updates in Maple 2019.

See Also

cat

length

sprintf

String

StringTools:-FormatMessage

substring