Close
Close window
andmap - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Mozilla Firefox.
Maplesoft logo
Maplesoft logo

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

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 .


Download Help Document

AltStyle によって変換されたページ (->オリジナル) /