File: pack-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 (46 lines) | stat: -rw-r--r-- 1,037 bytes parent folder | download | duplicates (4)
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
-- Status: rewritten July 2018
-- Author: Lily Silverstein

doc///
 Key
  pack
  (pack, BasicList, ZZ)
  (pack, ZZ, BasicList)
  (pack, String, ZZ)
  (pack, ZZ, String)
 Headline
  pack elements of a list or string into several shorter lists or strings
 Usage
  pack(A, n)
  pack(n, A)
 Inputs
  A: {BasicList,String}
  n: ZZ
   how many elements of {\tt A} to put in each new list or string
 Outputs
  L: List
   a list of lists or strings, with the elements of {\tt A} taken {\tt n} at a time.
 Description
  Text
   The commands {\tt pack(A, n)} and {\tt pack(n, A)} produce identical results.
  Example
   pack(a..l, 3)
   pack(3, a..l)
   pack("Hello world!", 4)
   pack(4, "Hello world!")
  Text
   If {\tt n} doesn't divide the length of {\tt A}, the last list will have fewer
   than {\tt n} elements.
  Example
   pack(a..m, 3)
  Text
   {\tt pack} and @TO mingle@ can be used together to take a transpose of lists
  Example
   pack(2, mingle(a..m, 0..12))
 SeeAlso
  mingle
  sort
  sublists
  take
  "lists and sequences"
///