File: positions-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 (43 lines) | stat: -rw-r--r-- 1,140 bytes parent folder | download | duplicates (5)
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
-- Status: rewritten July 2018
-- Author: Lily Silverstein

doc///
 Key
  positions
  (positions, VisibleList, Function)
  (positions, MutableList, Function)
 Headline
  which elements of a list satisfy a condition
 Usage
  positions(A, f)
 Inputs
  A: VisibleList
  f: Function
 Outputs
  p: List
   the list of indices {\tt i} such that {\tt f(A#i)} is true
 Description
  Text
   The indices are listed in ascending order. If no element satisfies the condition, an empty list is returned.
  Example
   positions((10,20,43,105,6,93), odd)
   positions((10,20,43,105,6,93), i -> i<0)
   positions(100..110, isPrime)
  Text
   To find the first or last index of an element satisfying the condition, see @TO position@. To return the 
   elements, rather than their indices, see @TO select@. The function @TO number@ counts the
   number of elements satisfying the condition.
  Example
   position((10,20,43,105,6), odd)  
   position((10,20,43,105,6), odd, Reverse => true)
   select((10,20,43,105,6), odd)
   number((10,20,43,105,6), odd)
 SeeAlso
  minPosition
  maxPosition
  number
  position
  select
  take
  "lists and sequences"
///