File: any-doc.m2

package info (click to toggle)
macaulay2 1.25.05%2Bds-2
  • links: PTS, VCS
  • area: main
  • in suites: experimental
  • size: 172,152 kB
  • sloc: cpp: 107,824; ansic: 16,193; javascript: 4,189; makefile: 3,899; lisp: 702; yacc: 604; sh: 476; xml: 177; perl: 114; lex: 65; python: 33
file content (79 lines) | stat: -rw-r--r-- 2,747 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
--- status: DRAFT
--- author(s): L. Gold
--- notes: 

document { 
     Key => any,
     Headline => "whether any elements satisfy a specified condition",
     SeeAlso =>{ "scan", "apply", "select", "all", "member"},
     Subnodes => {
	 TO (any, BasicList, Function),
	 TO (any, BasicList, BasicList, Function),
         },
     }
document { 
     Key => {(any,BasicList,Function),(any,ZZ,Function)},
     Headline => "whether any elements of a list satisfy a specified condition",
     Usage => "any(L,f)",
     Inputs => {
	  "L" => {"or ", ofClass {ZZ}, ".  If an integer is given, then the sequence ", TT "0..L-1", " is used."},
	  "f" => Function => "which returns true or false"
	  },
     Outputs => {
	  Boolean => {TO "true", " if ", TT "f", " returns true when applied to any element of ", TT "L", 
	       " and ", TO "false", " otherwise"}
	  },
     EXAMPLE lines ///
     any({1,2,3,4}, even)
     any({1,3,5,7}, even)
     any(20,n -> n == 15)
     ///,
     PARA {
	  "We can test whether a permutation has a fixed point as follows."
	  },
     EXAMPLE lines ///
     fp = x -> any(#x, i -> x#i == i);
     fp {2,3,4,0,1}
     fp {2,4,0,3,1}
     ///,
     SeeAlso => { "scan", "apply", "select", "any", "member" }
     }
document { 
     Key => (any,BasicList,BasicList,Function),
     Headline => "whether any corresponding elements of a pair of lists satisfy a condition",
     Usage => "any(v,w,f)",
     Inputs => {
	  "v" => BasicList,
	  "w" => BasicList,
	  "f" => Function => "a function of two variables that returns true or false"
	  },
     Outputs => {
	  Boolean => {TO "true", " if ", TT "f", " returns true when applied to some pair ", TT "(x,y)", " of corresponding elements of ", TT "v", " and ", TT "w", ",
	       and ", TO "false", " otherwise"}},
     EXAMPLE lines ///
	  any((1,2,3,4),(2,3,4,5), (i,j) -> i>j)
	  any((1,2,5,4),(2,3,4,5), (i,j) -> i>j)
	  any((1,2,5,4),(2,3,4,5), x -> (print x; false))
	  any((1,2,5,4),(2,3,4,5), x -> (print x; true))
	  ///,
     SeeAlso => { "scan", "apply", "select", "any", "member" }
     }
document { 
     Key => (any,HashTable,Function),
     Headline => "whether all key/value pairs in a hash table satisfy a specified condition",
     Usage => "any(H,f)",
     Inputs => {
	  "L" => HashTable,
	  "f" => Function => "which returns true or false"
	  },
     Outputs => {
	  Boolean => {TO "true", " if ", TT "f", "returns true when applied to all key/value pairs of ", TT "H",
	       " and ", TO "false", " otherwise"}
	  },
     EXAMPLE {
	  "any(hashTable{1=>5, 2=>4, 3=>3, 4=>2, 5=>1}, (a,b) -> a == b)",
	  "any(hashTable{1=>4, 2=>3, 3=>2, 4=>1}, (a,b) -> a == b)"
	  },
     Caveat => {},
     SeeAlso =>{ "scan", "apply", "select", "all", "member"}
     }