Ruby - 陣列

array & other_array

返回一個新陣列，其中包含兩個陣列共有的元素，沒有重複。

array * int [或] array * str

返回一個新陣列，該陣列透過連線 self 的 int 個副本構建而成。對於字串引數，等效於 self.join(str)。

array + other_array

返回一個新陣列，該陣列透過將兩個陣列連線在一起以生成第三個陣列來構建。

array - other_array

返回一個新陣列，它是原始陣列的副本，刪除了也出現在 other_array 中的任何專案。

array <=> other_array

將 str 與 other_str 進行比較，返回 -1（小於）、0（等於）或 1（大於）。比較區分大小寫。

array | other_array

透過連線 array 和 other_array 返回一個新陣列，刪除重複項。

array << obj

將給定物件推送到 array 的末尾。此表示式返回陣列本身，因此可以將多個追加連結在一起。

array <=> other_array

如果此陣列小於、等於或大於 other_array，則返回一個整數（-1、0 或 +1）。

array == other_array

如果兩個陣列包含相同數量的元素，並且每個元素都等於（根據 Object.==）另一個數組中的對應元素，則這兩個陣列相等。

array[index] [或] array[start, length] [或]

array[range] [或] array.slice(index) [或]

array.slice(start, length) [或] array.slice(range)

返回 index 處的元素，或返回從 start 開始並繼續 length 個元素的子陣列，或返回由 range 指定的子陣列。負索引從陣列的末尾反向計數（-1 是最後一個元素）。如果索引（或起始索引）超出範圍，則返回 nil。

array[index] = obj [或]

array[start, length] = obj 或 an_array 或 nil [或]

array[range] = obj 或 an_array 或 nil

設定 index 處的元素，或替換從 start 開始並繼續 length 個元素的子陣列，或替換由 range 指定的子陣列。如果索引大於陣列的當前容量，則陣列會自動增長。負索引將從陣列的末尾反向計數。如果 length 為零，則插入元素。如果在第二種和第三種形式中使用 nil，則從 self 中刪除元素。

array.abbrev(pattern = nil)

計算 self 中字串的一組明確的縮寫。如果傳遞了一個模式或一個字串，則只考慮與模式匹配或以字串開頭的字串。

array.assoc(obj)

搜尋一個元素也是陣列的陣列，使用 obj.== 將 obj 與每個包含陣列的第一個元素進行比較。返回第一個匹配的包含陣列，如果未找到匹配項則返回 nil。

array.at(index)

返回 index 處的元素。負索引從 self 的末尾開始計數。如果索引超出範圍，則返回 nil。

array.clear

從 array 中刪除所有元素。

array.collect { |item| block } [或]

array.map { |item| block }

為 self 的每個元素呼叫一次 block。建立一個新陣列，其中包含 block 返回的值。

array.collect! { |item| block } [或]

array.map! { |item| block }

為 self 的每個元素呼叫一次 block，用 block 返回的值替換該元素。

array.compact

返回 self 的副本，其中所有 nil 元素都已刪除。

array.compact!

從 array 中刪除 nil 元素。如果未進行任何更改，則返回 nil。

array.concat(other_array)

將 other_array 中的元素附加到 self。

array.delete(obj) [或]

array.delete(obj) { block }

刪除 self 中等於 obj 的專案。如果未找到該專案，則返回 nil。如果給出了可選的程式碼 block，則如果未找到該專案，則返回 block 的結果。

array.delete_at(index)

刪除指定 index 處的元素，返回該元素，如果索引超出範圍則返回 nil。

array.delete_if { |item| block }

刪除 self 的每個元素，對於這些元素，block 的計算結果為 true。

array.each { |item| block }

為 self 中的每個元素呼叫一次 block，並將該元素作為引數傳遞。

array.each_index { |index| block }

與 Array#each 相同，但傳遞元素的 index 而不是元素本身。

array.empty?

如果 self 陣列不包含任何元素，則返回 true。

array.eql?(other)

如果 array 和 other 是同一個物件，或者都是具有相同內容的陣列，則返回 true。

array.fetch(index) [或]

array.fetch(index, default) [或]

array.fetch(index) { |index| block }

嘗試返回 position index 處的元素。如果 index 超出陣列範圍，則第一種形式丟擲 IndexError 異常，第二種形式返回 default，第三種形式返回呼叫 block 的值，並將 index 傳入其中。index 的負值從陣列的末尾開始計數。

array.fill(obj) [或]

array.fill(obj, start [, length]) [或]

array.fill(obj, range) [或]

array.fill { |index| block } [或]

array.fill(start [, length] ) { |index| block } [或]

array.fill(range) { |index| block }

前三種形式將 self 的選定元素設定為 obj。nil 的起始位置等效於零。nil 的長度等效於 self.length。後三種形式使用 block 的值 fill 陣列。block 會傳遞要填充的每個元素的絕對索引。

array.first [或]

array.first(n)

返回陣列的第一個元素或前 n 個元素。如果陣列為空，則第一種形式返回 nil，第二種形式返回一個空陣列。

array.flatten

返回一個新陣列，它是此陣列的一維展平（遞迴）。

array.flatten!

就地展平 array。如果未進行任何修改，則返回 nil。（陣列不包含任何子陣列。）

array.frozen?

如果 array 被凍結（或在排序時暫時被凍結），則返回 true。

array.hash

計算 array 的雜湊碼。兩個內容相同的陣列將具有相同的雜湊碼。

array.include?(obj)

如果 obj 出現在 self 中，則返回 true，否則返回 false。

array.index(obj)

返回 self 中第一個與 obj 相等的（==）物件的 index。如果未找到匹配項，則返回 nil。

array.indexes(i1, i2, ... iN) [或]

array.indices(i1, i2, ... iN)

此方法在最新版本的 Ruby 中已棄用，因此請使用 Array#values_at。

array.indices(i1, i2, ... iN) [或]

array.indexes(i1, i2, ... iN)

此方法在最新版本的 Ruby 中已棄用，因此請使用 Array#values_at。

array.insert(index, obj...)

在具有給定 index（可以為負數）的元素之前插入給定的值。

array.inspect

建立 array 的可列印版本。

array.join(sep = $,)

返回一個字串，該字串透過將陣列的每個元素轉換為字串並用 sep 分隔來建立。

array.last [或] array.last(n)

返回 self 的最後一個元素。如果陣列 empty，則第一種形式返回 nil。

array.length

返回 self 中的元素數量。可以為零。

array.map { |item| block } [或]

array.collect { |item| block }

為 self 的每個元素呼叫一次 block。建立一個包含 block 返回的值的 新 陣列。

array.map! { |item| block } [或]

array.collect! { |item| block }

為 array 的每個元素呼叫一次 block，用 block 返回的值替換該元素。

array.nitems

返回 self 中非 nil 元素的數量。可以為零。

array.pack(aTemplateString)

根據 TemplateString 中的指令將陣列的內容打包成二進位制序列。指令 A、a 和 Z 後面可以跟著一個計數，表示結果欄位的寬度。其餘指令也可以帶一個計數，表示要轉換的陣列元素的數量。如果計數是星號 (*)，則會轉換所有剩餘的陣列元素。任何指令後面仍然可以跟著下劃線 (_) 以使用指定型別的底層平臺的本機大小；否則，它們使用平臺無關的大小。模板字串中的空格將被忽略。

array.pop

移除array的最後一個元素並返回它，如果array為空則返回nil。

array.push(obj, ...)

將給定的 obj 推送到（追加到）此陣列的末尾。此表示式返回陣列本身，因此可以將多個追加操作連結在一起。

array.rassoc(key)

搜尋元素也是陣列的陣列。使用 == 將key與每個包含陣列的第二個元素進行比較。返回第一個匹配的包含陣列。

array.reject { |item| block }

返回一個新陣列，其中包含array中塊不為true的項。

array.reject! { |item| block }

刪除array中塊計算結果為true的元素，但如果未進行任何更改則返回nil。等同於 Array#delete_if。

array.replace(other_array)

用other_array的內容替換array的內容，必要時進行截斷或擴充套件。

array.reverse

返回一個新陣列，其中包含array的元素，順序相反。

array.reverse!

就地反轉array。

array.reverse_each {|item| block }

與 Array#each 相同，但以相反的順序遍歷array。

array.rindex(obj)

返回array中最後一個與 obj 相等的物件的索引。如果未找到匹配項，則返回nil。

array.select {|item| block }

呼叫塊，將array中的連續元素傳遞給它，並返回一個數組，其中包含塊返回true值的那些元素。

array.shift

返回self的第一個元素並將其移除（將所有其他元素向下移動一個位置）。如果陣列為空，則返回nil。

array.size

返回array的長度（元素數量）。length 的別名。

array.slice(index) [或] array.slice(start, length) [或]

array.slice(range) [或] array[index] [或]

array[start, length] [或] array[range]

返回index處的元素，或返回從start開始並繼續length個元素的子陣列，或返回由range指定的子陣列。負索引從陣列末尾反向計數（-1 是最後一個元素）。如果index（或起始索引）超出範圍，則返回nil。

array.slice!(index) [或] array.slice!(start, length) [或]

array.slice!(range)

刪除由index（可選地帶長度）或range給出的元素。返回刪除的物件、子陣列或nil（如果index超出範圍）。

array.sort [或] array.sort { | a,b | block }

返回透過對 self 進行排序建立的新陣列。

array.sort! [或] array.sort! { | a,b | block }

對 self 進行排序。

array.to_a

返回self。如果在Array的子類上呼叫，則將接收方轉換為 Array 物件。

array.to_ary

返回 self。

array.to_s

返回 self.join。

array.transpose

假設 self 是一個數組的陣列，並轉置行和列。

array.uniq

透過移除array中的重複值返回一個新陣列。

array.uniq!

從self中移除重複元素。如果未進行任何更改（即未找到重複項），則返回nil。

array.unshift(obj, ...)

將物件新增到陣列的前面，其他元素向上移動一個位置。

array.values_at(selector,...)

返回一個數組，其中包含 self 中與給定selector（一個或多個）相對應的元素。選擇器可以是整數索引或範圍。

array.zip(arg, ...) [或]

array.zip(arg, ...){ | arr | block }

將任何引數轉換為陣列，然後將array的元素與每個引數中的對應元素合併。

@

移動到絕對位置。

A

ASCII 字串（空格填充，計數為寬度）。

a

ASCII 字串（空字元填充，計數為寬度）。

B

字串（降序位順序）。

b

位字串（升序位順序）。

C

無符號字元。

c

字元。

D, d

雙精度浮點數，本機格式。

E

雙精度浮點數，小端位元組序。

e

單精度浮點數，小端位元組序。

F, f

單精度浮點數，本機格式。

G

雙精度浮點數，網路（大端）位元組序。

g

單精度浮點數，網路（大端）位元組序。

H

十六進位制字串（高位位元組優先）。

h

十六進位制字串（低位位元組優先）。

I

無符號整數。

i

整數。

L

無符號長整數。

l

長整數。

M

帶引號的可列印字串，MIME 編碼（參見 RFC 2045）。

m

Base64 編碼的字串。

N

長整數，網路（大端）位元組序。

n

短整數，網路（大端）位元組序。

P

指向結構的指標（定長字串）。

p

指向空字元終止字串的指標。

Q, q

64 位數字。

S

無符號短整數。

s

短整數。

U

UTF-8。

u

UU 編碼的字串。

V

長整數，小端位元組序。

v

短整數，小端位元組序。

w

BER 壓縮整數 \fnm。

X

後退一個位元組。

x

空位元組。

Z

與 a 相同，但使用 * 新增空字元。