aboutsummaryrefslogtreecommitdiff
path: root/stdlib/source/documentation/lux/data/collection/array.lux
blob: b806af2a407e00aab8c187c79c117249b4e04a6a (plain)
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
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
(.require
 [library
  [lux (.except)
   ["$" documentation]
   [data
    ["[0]" text (.only \n)
     ["%" \\format (.only format)]]]
   [meta
    ["[0]" code]]]]
 [\\library
  ["[0]" /]])

(def .public documentation
  (.List $.Documentation)
  (list ($.module /._
                  "")

        ($.definition /.nominal)
        ($.definition /.equivalence)
        ($.definition /.monoid)
        ($.definition /.functor)
        ($.definition /.mix)
        ($.definition /.every?)
        ($.definition /.any?)

        ($.definition (/.Array it)
          "Mutable arrays.")

        ($.definition /.empty
          "An empty array of the specified size."
          ($.example (empty size)))

        ($.definition /.size
          ""
          ($.example (size array)))

        ($.definition /.item
          ""
          ($.example (item index array)))

        ($.definition /.has!
          "Mutate the array by writing a value to the specified index."
          ($.example (has! index value array)))

        ($.definition /.lacks!
          "Mutate the array by deleting the value at the specified index."
          ($.example (lacks! index array)))

        ($.definition /.has?
          ""
          ($.example (has? index array)))

        ($.definition /.revised!
          "Mutate the array by updating the value at the specified index."
          ($.example (revised! index transform array)))

        ($.definition /.upsert!
          (format "Mutate the array by updating the value at the specified index."
                  \n "If there is no value, update and write the default value given.")
          ($.example (upsert! index default transform array)))

        ($.definition /.copy!
          "Writes the contents of one array into the other."
          ($.example (copy! length src_start src_array dest_start dest_array)))

        ($.definition /.occupancy
          "Finds out how many cells in an array are occupied."
          ($.example (occupancy array)))

        ($.definition /.vacancy
          "Finds out how many cells in an array are vacant."
          ($.example (vacancy array)))

        ($.definition /.only!
          "Delete every item of the array that fails to satisfy the predicate."
          ($.example (only! p xs)))

        ($.definition /.example
          "Yields the first item in the array that satisfies the predicate."
          ($.example (example p xs)))

        ($.definition /.example'
          "Just like 'example', but with access to the index of each value."
          ($.example (example' p xs)))

        ($.definition /.clone
          "Yields a shallow clone of the array."
          ($.example (clone xs)))

        ($.definition /.of_list
          ""
          ($.example (of_list xs)))

        ($.definition /.list
          (format "Yields a list with every non-empty item in the array."
                  \n "Can use the optional default value when encountering an empty cell in the array.")
          ($.example (list {.#None} array))
          ($.example (list {.#Some default} array)))
        ))