andmap - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


andmap

determine whether a predicate is true of all operands of an expression

ormap

determine whether a predicate is true of some operands of an expression

xormap

determine whether a predicate is true of an odd number of operands of an expression

 

Calling Sequence

Parameters

Description

Thread Safety

Examples

Compatibility

Calling Sequence

andmap(p, expr, ...)

ormap(p, expr, ...)

xormap(p, expr, ...)

Parameters

p

-

predicate returning either true or false

expr

-

expression

...

-

(optional) other arguments to pass to p

Description

• 

The procedures andmap, ormap, and xormap determine whether a predicate p returns true for all, some, or an odd number of operands respectively of an expression expr.

• 

For a table, Vector, Matrix, or Array, p is applied to each entry.

• 

If expr is atomic, andmap(p, expr, ...), ormap(p, expr, ...), and xormap(p, expr, ...) are equivalent to p(expr, ... ).

• 

In general, andmap(p, expr, ...) returns true if p(opnd, ...) is true for all operands opnd of expr, returns false if any call to p returns false, and returns FAIL when calls to p lead to at least one FAIL result and no false results.

• 

Similarly, ormap(p, expr, ...) returns false if p(opnd, ...) is false for all operands opnd of expr, true when any call to p returns true, and FAIL when calls to p lead to at least one FAIL result and no true results.

• 

Invoking xormap(p, expr, ...) returns true if p(opnd, ...) is true for an odd number of operands opnd of expr and all other calls to p yield false. If any call to p returns FAIL, then xormap returns FAIL.

• 

Each of andmap, ormap, and xormap have short-circuit ("McCarthy") semantics, which means that an answer is returned as soon as it cannot change. The predicate only evaluates the operands of the expression expr until the result can be determined (false for andmap, true for ormap, and FAIL for xormap). The order in which the operands are examined, and thus which are examined, is not specified. You should not rely on side effects of the predicate p.

• 

Since strings are atomic expressions in Maple, you cannot map a procedure over a string using andmap, ormap, or xormap. However, the StringTools package contains the exports AndMap and OrMap that provide this functionality.

Thread Safety

• 

The andmap and ormap commands are thread safe as of Maple 15, provided that evaluating the expression p is thread safe.

• 

The xormap command is thread safe as of Maple 2021, provided that evaluating the expression p is thread safe.

• 

For more information on thread safety, see index/threadsafe.

Examples

andmaptype,1,2,3,4,5,integer

true

(1)

ormaptype,1,2,3,4,5,integer

true

(2)

xormaptype,1,2,3,4,5,integer

true

(3)

andmaptype,1,2,3,4,5,even

false

(4)

ormaptype,1,2,3,4,5,even

true

(5)

xormaptype,1,2,3,4,5,even

false

(6)

andmapisprime,2,3,5,7

true

(7)

andmapisprime,2,3,5,8

false

(8)

ormapisprime,2,3,5,8

true

(9)

ttablea=1,b=2,c=3:

andmaptype,evalt,1,integer

true

(10)

andmaptype,evalt,1,even

false

(11)

ormaptype,evalt,1,even

true

(12)

eexpandIntrandpolyx,x

e7x5ⅆx+22x4ⅆx55x3ⅆx94x2ⅆx+87xⅆx561ⅆx

(13)

andmaphastype,e,specfuncanything,Int

true

(14)

This examples illustrates a technique for quickly destructuring a record.

RecordSlots := proc( r::record )
      if not type( [ args[ 2 .. nargs ] ], 'list( symbol )' ) then
              error "arguments after the first must be of type `symbol'"
      end if;
      andmap( e -> member( cat( e ), r, e ), [ args[ 2 .. nargs ] ] )
end proc:

rRecorda=2,b=3,c=Array1..5

rRecorda=2,b=3,c=00000

(15)

RecordSlotsr,a,b,c

true

(16)

a,b,c

2,3,00000

(17)

andmapa`if`a<0&comma;FAIL&comma;amod7=0&comma;7&comma;14

true

(18)

andmapa`if`a<0&comma;FAIL&comma;amod7=0&comma;7&comma;14&comma;7

FAIL

(19)

andmapa`if`a<0&comma;FAIL&comma;amod7=0&comma;7&comma;14&comma;7&comma;3

false

(20)

ormapa`if`a<0&comma;FAIL&comma;amod7=0&comma;7&comma;14&comma;7

true

(21)

ormapa`if`a<0&comma;FAIL&comma;amod7=0&comma;1&comma;3

false

(22)

ormapa`if`a<0&comma;FAIL&comma;amod7=0&comma;1&comma;3&comma;5

FAIL

(23)

xormapa`if`a<0&comma;FAIL&comma;amod7=0&comma;7&comma;14&comma;7

FAIL

(24)

xormapa`if`a<0&comma;FAIL&comma;amod7=0&comma;1&comma;3

false

(25)

xormapa`if`a<0&comma;FAIL&comma;amod7=0&comma;1&comma;3&comma;7

true

(26)

xormapa`if`a<0&comma;FAIL&comma;amod7=0&comma;1&comma;3&comma;7&comma;5

FAIL

(27)

Compatibility

• 

The andmap and ormap commands were updated in Maple 2017.

• 

The xormap command was introduced in Maple 2021.

• 

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

See Also

andseq

curry

map

op

orseq

rcurry

select

spec_eval_rules

StringTools

StringTools[AndMap]

StringTools[OrMap]

type/atomic

xorseq