Index:

[ ] new & * + -- << <=> == === [ ] [ ]= | assoc at clear collect collect! compact compact! concat delete delete_at delete_if each each_index empty? eql? fill first flatten flatten! include? index indexes indices join last length map! nitems pack pop push rassoc reject! replace reverse reverse! reverse_each rindex shift size slice slice! sort sort! to_a to_ary to_s uniq uniq! unshift

---

Arrays are ordered, integer-indexed collections of any object. Array indexing starts at 0, as in C or Java. A negative index is assumed relative to the end of the array---that is, an index of -1 indicates the last element of the array, -2 is the next to last element in the array, and so on. Returns a new array populated with the given objects. Equivalent to the operator form Array.[]( ... ). Returns a new array, optionally with a size and initial value (that is, anInteger references to the same anObject). Set Intersection---Returns a new array containing elements common to the two arrays, with no duplicates. Repetition---With a String argument, equivalent to arr.join(aString). Otherwise, returns a new array built by concatenating the anInteger copies of arr. Concatenation---Returns a new array built by concatenating the two arrays together to produce a third array. Set Difference---Returns a new array that is a copy of the original array, removing any items that also appear in anOtherArray and duplicated items. Append---Pushes the given object on to the end of this array. This expression returns the array itself, so several appends may be chained together. See also Array#push . Comparison---Returns an integer -1, 0, or +1 if this array is less than, equal to, or greater than anOtherArray. Each object in each array is compared (using <=>). If any value isn't equal, then that inequality is the return value. If all the values found are equal, then the return is based on a comparison of the array lengths. Thus, two arrays are ``equal'' according to Array#<=> if and only if they have the same length and the value of each element is equal to the value of the corresponding element in the other array. Equality---Two arrays are equal if they contain the same number of elements and if each element is equal to (according to Object#== ) the corresponding element in the other array. Case Equality---Equality as evaluated by case expressions. For arrays, this is the same as Array#== . Element Reference---Returns the element at index anInteger, or returns a subarray starting at index start and continuing for length elements, or returns a subarray specified by aRange. Negative indices count backward from the end of the array (-1 is the last element). Returns nil if any indices are out of range. Element Assignment---Sets the element at index anInteger, or replaces a subarray starting at index start and continuing for length elements, or replaces a subarray specified by aRange. If anInteger is greater than the current capacity of the array, the array grows automatically. A negative anInteger will count backward from the end of the array. Inserts elements if length is zero. If subArray is nil, deletes elements from arr. An IndexError is raised if a negative index points past the beginning of the array. See also Array#push , Array#unshift . Set Union---Returns a new array by joining this array with anOtherArray, removing duplicates. Searches through an array whose elements are also arrays comparing anObject with the first element of each contained array using anObject .== . Returns the first contained array that matches (that is, the first associated array), or nil if no match is found. See also Array#rassoc . Returns the element at index anInteger. A negative index counts from the end of arr. Returns nil if the index is out of range. See also Array#[] . ( Array#at is slightly faster than Array#[] , as it does not accept ranges and so on.) Removes all elements from arr. Returns a new array by invoking block once for every element, passing each element as a parameter to block. The result of block is used as the given element in the new array. See also Array#collect! . Invokes block once for each element of arr, replacing the element with the value returned by block. See also Array#collect . Returns a new array based on the arr with all nil elements removed. Same as Array#compact , but modifies the receiver in place. Returns nil if no changes were made. Appends the elements in anOtherArray to arr. Deletes items from the self that are equal to anObject. If the item is not found, returns nil. If the optional code block is given, returns the result of block if the item is not found. Deletes the element at the specified index, returning that element, or nil if the index is out of range. See also Array#slice! . Deletes every element of arr for which block evaluates to true. Calls block once for each element in arr, passing that element as a parameter. produces: Same as Array#each , but passes the index of the element instead of the element itself. produces: Returns true if arr array contains no elements. An array is equal to another array if the lengths are equal and each corresponding element is equal (according to Object#eql? ). See also Array#<=> . eql? is used for Hash comparison. Sets the selected elements of arr (which may be the entire array) to anObject. A start of nil is equivalent to zero. A length of nil is equivalent to arr.length. Returns the first element of the array. If the array is empty, returns nil. Returns a new array that is a one-dimensional flattening of this array (recursively). That is, for every element that is an array, extract its elements into the new array. Same as Array#flatten , but modifies the receiver in place. Returns nil if no modifications were made (i.e., arr contains no subarrays.) Returns true if the given object is present in arr (that is, if any object == anObject), false otherwise. Returns the index of the first object in arr such that the object == anObject. Returns nil if no match is found. Returns a new array consisting of elements at the given indices. May insert nil for indices out of range. Synonym for Array#indexes . Returns a string created by converting each element of the array to a string, separated by aSepString. Returns the last element of arr. If the array is empty, returns nil. Returns the number of elements in arr. May be zero. Synonym for Array#collect! . Returns the number of non-nil elements in arr. May be zero. Packs the contents of arr into a binary sequence according to the directives in aTemplateString (see Table 22.1 on page 285). Directives ``A,'' ``a,'' and ``Z'' may be followed by a count, which gives the width of the resulting field. The remaining directives also may take a count, indicating the number of array elements to convert. If the count is an asterisk (``*''), all remaining array elements will be converted. Any of the directives ``sSiIlL'' may be followed by an underscore (``_'') to use the underlying platform's native size for the specified type; otherwise, they use a platform-independent size. Spaces are ignored in the template string. See also String#unpack on page 378. Removes the last element from arr and returns it, or nil if the array is empty (as with a stack). Appends the given argument(s) to the end of arr (as with a stack). Searches through the array whose elements are also arrays. Compares key with the second element of each contained array using ==. Returns the first contained array that matches. See also assoc. Equivalent to Array#delete_if , but returns nil if no changes were made. Replaces the contents of arr with the contents of anOtherArray, truncating or expanding if necessary. Returns a new array using arr's elements in reverse order. Same as reverse, but returns nil if arr is unchanged (arr .length is zero or one). Same as Array#each , but traverses arr in reverse order. produces: Returns the index of the last object in arr such that the object == anObject. Returns nil if no match is found. Returns the first element of arr and removes it (shifting all other elements down by one). Returns nil if the array is empty. Synonym for Array#length . Synonym for Array#[ ] . Deletes the element(s) given by an index (optionally with a length) or by a range. Returns the deleted object, subarray, or nil if the index is out of range. Equivalent to: Returns a new array created by sorting arr. Comparisons for the sort will be done using the <=> operator or using an optional code block. The block implements a comparison between a and b, returning -1, 0, or +1. Same as Array#sort , but modifies the receiver in place. arr is effectively frozen while a sort is in progress. Returns arr. Synonym for Array#to_a . Returns arr .join. Returns a new array by removing duplicate values in arr. Same as Array#uniq , but modifies the receiver in place. Returns nil if no changes are made (that is, no duplicates are found). Prepends anObject to the front of arr, and shifts all other elements up one.

---

Extracted from the book "Programming Ruby - The Pragmatic Programmer's Guide"
Copyright © 2001 by Addison Wesley Longman, Inc. This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/)). Distribution of substantively modified versions of this document is prohibited without the explicit permission of the copyright holder. Distribution of the work or derivative of the work in any standard (paper) book form is prohibited unless prior permission is obtained from the copyright holder.