convert/global - Maple Programming Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Programming : Data Types : Conversion : convert/global

convert/global

convert an expression to a global name

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

convert(e, '`global`', opts)

Parameters

e

-

any Maple object

opts

-

equation(s) of the form option=value where option is one of expression, assign, reset, or unique; specify options for the conversion

Description

• 

The convert(e, `global`) function converts any local symbols in the expression e to global symbols.

• 

Note that, because the name global is a Maple keyword, it must be enclosed in backquotes, as demonstrated by the examples below.

• 

The opts argument can contain one or more of the following equations that set how symbols are converted to globals.

  

 

  

assign = truefalse

  

If this option is set to true, then if a local variable is assigned, the global will be assigned to the same object.

  

 

  

expression = truefalse

  

If this option is set to true, then the entire expression will be converted into a global variable and all other options will be ignored.

  

 

  

reset = truefalse

  

If this option is set to true, then any new globals generated by the option unique will be reset, otherwise, on subsequent calls, the attached integers will grow in size. This option is only useful in conjunction with the option unique.

  

 

  

unique = truefalse

  

If this option is set to true, then if two local variables have the same appearance, they will be converted to different global variables by appending digits to the end of subsequent global variable.

Examples

assign x, y, z to three locals: a, a, and b

xconverta,'`local`'

xa

(1)

yconverta,'`local`'

ya

(2)

zconvertb,'`local`'

zb

(3)

convertx+y+z,'`global`'

2a+b

(4)

convertx+y+z,'`global`',unique

a+a0+b

(5)

assign a procedure to the local a

assign(x, proc(s) sin(s) + s end);

fconvertx,`global`

fa

(6)

f3.2

a3.2

(7)

fconvertx,`global`,assign

fa

(8)

f3.2

3.141625857

(9)

convertx+y+z,'`global`',unique

a1+a2+b0

(10)

convertx+y+z,'`global`',unique,reset

a0+a1+b

(11)

symconvertx+y+z,'`global`',expression

syma+a+b

(12)

typesym,symbol

true

(13)

See Also

convert

convert/local

convert/symbol

name

procedure

type/name

type/symbol

 


Download Help Document

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam