File: drop-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 (42 lines) | stat: -rw-r--r-- 1,048 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
-- Status: rewritten July 2018
-- Author: Lily Silverstein

doc ///
 Key
  drop
  (drop, BasicList, ZZ)
  (drop, BasicList, List)
 Headline
  drop some elements from a list or sequence
 Usage
  drop(L, i)
  drop(L, {j,k})
 Inputs
  L: BasicList
  i: ZZ
  j: ZZ
  k: ZZ
 Outputs
  L2: BasicList
   the list or sequence obtained by dropping the first {\tt i} elements of {\tt L},
   (if {\tt i} positive), or the last {\tt i} elements of {\tt L} (if {\tt i} negative), or, if given the
   pair {\tt j,k}, the list or sequence obtained by dropping the elements of {\tt L} with indices {\tt j} through {\tt k}
 Description
  Example
   drop({a,b,c,d,e,f,g}, 3)
   drop({a,b,c,d,e,f,g}, -3)
   drop({a,b,c,d,e,f,g}, {1,3})
   drop({a,b,c,d,e,f,g}, {2,2})    
  Text
   The pair {\tt \{j,k\}} must be given with both entries non-negative, and $j\le k$. Otherwise the original list is returned.
  Example
   drop({a,b,c,d,e,f,g}, {3,1})
   drop({a,b,c,d,e,f,g}, {4,-1})
 SeeAlso
  take
  delete
  position
  positions
  select
  "lists and sequences"
///