1 USING: help.markup help.syntax
2 kernel kernel.private prettyprint sequences.private sequences ;
5 ARTICLE: "arrays-unsafe" "Unsafe array operations"
6 "These two words are used internally by the Factor implementation. User code should never need to call them; instead use " { $link nth } " and " { $link set-nth } "."
12 ARTICLE: "arrays" "Arrays"
13 "The " { $vocab-link "arrays" } " vocabulary implements fixed-size mutable sequences which support the " { $link "sequence-protocol" } "."
15 "The " { $vocab-link "arrays" } " vocabulary only includes words for creating new arrays. To access and modify array elements, use " { $link "sequences" } " in the " { $vocab-link "sequences" } " vocabulary."
17 "Array literal syntax is documented in " { $link "syntax-arrays" } ". Resizable arrays also exist and are known as " { $link "vectors" } "."
19 "Arrays form a class of objects:"
24 "Creating new arrays:"
29 "Creating an array from several elements on the stack:"
36 "The class of two-element arrays:"
38 "Arrays can be accessed without bounds checks in a pointer unsafe way."
39 { $subsections "arrays-unsafe" } ;
44 { $description "The class of fixed-length arrays. See " { $link "syntax-arrays" } " for syntax and " { $link "arrays" } " for general information." } ;
46 HELP: <array> ( n elt -- array )
47 { $values { "n" "a non-negative integer" } { "elt" "an initial element" } { "array" "a new array" } }
48 { $description "Creates a new array with the given length and all elements initially set to " { $snippet "elt" } "." } ;
51 { $values { "seq" "a sequence" } { "array" array } }
52 { $description "Outputs a freshly-allocated array with the same elements as a given sequence." } ;
55 { $values { "x" object } { "array" array } }
56 { $description "Create a new array with one element." } ;
58 { 1array 2array 3array 4array } related-words
61 { $values { "x" object } { "y" object } { "array" array } }
62 { $description "Create a new array with two elements, with " { $snippet "x" } " appearing first." } ;
65 { $values { "x" object } { "y" object } { "z" object } { "array" array } }
66 { $description "Create a new array with three elements, with " { $snippet "x" } " appearing first." } ;
69 { $values { "w" object } { "x" object } { "y" object } { "z" object } { "array" array } }
70 { $description "Create a new array with four elements, with " { $snippet "w" } " appearing first." } ;
72 HELP: resize-array ( n array -- newarray )
73 { $values { "n" "a non-negative integer" } { "array" array } { "newarray" "a new array" } }
74 { $description "Creates a new array of " { $snippet "n" } " elements. The contents of the existing array are copied into the new array; if the new array is shorter, only an initial segment is copied, and if the new array is longer the remaining space is filled in with "{ $link f } "." } ;
77 { $class-description "The class of two-element arrays, known as pairs." } ;