提供一種方法，根據是否存在適當命名的標記方法來檢查某些類別是否像其他類別一樣運作。

提供與 SomeClass 相同介面的類別可以定義一個名為 acts_like_some_class? 的標記方法，向 acts_like?(:some_class) 的呼叫者發出其相容性的信號。

例如，Active Support 擴展了 Date 以定義 acts_like_date? 方法，並擴展了 Time 以定義 acts_like_time?。因此，開發人員可以呼叫 x.acts_like?(:time) 和 x.acts_like?(:date) 來測試鴨子類型相容性，並且能夠像 Time 一樣運作的類別也可以定義 acts_like_time? 方法來進行互操作。

請注意，標記方法只需要存在即可。它不會被呼叫，因此它的主體或返回值無關緊要。

範例：提供與 String 相同介面的類別

此類別可以定義

class Stringish
  def acts_like_string?
  end
end

然後用戶端程式碼可以透過這種方式查詢鴨子類型安全性

Stringish.new.acts_like?(:string) # => true

如果物件是 false、空值或空白字串，則該物件為空白。例如，nil、空字串、' '、[]、{} 和 false 都是空白。

這簡化了

!address || address.empty?

到

address.blank?

@return [true, false]

如果物件可複製，則返回物件的深層副本。如果它不可複製，則返回 self。

object = Object.new
dup    = object.deep_dup
dup.instance_variable_set(:@a, 1)

object.instance_variable_defined?(:@a) # => false
dup.instance_variable_defined?(:@a)    # => true

您可以安全地複製這個物件嗎？

方法物件為 False；否則為 True。

如果此物件包含在參數中，則返回 true。

當參數是 Range 時，使用 #cover? 正確處理開放範圍內的包含檢查。否則，參數必須是任何響應 #include? 的物件。用法

characters = ["Konata", "Kagami", "Tsukasa"]
"Konata".in?(characters) # => true

對於非 Range 參數，如果參數不響應 #include?，則會拋出 ArgumentError。

返回一個具有字串鍵的雜湊，將不帶「@」的實體變數名稱映射到其對應的值。

class C
  def initialize(x, y)
    @x, @y = x, y
  end
end

C.new(0, 1).instance_values # => {"x" => 0, "y" => 1}

返回一個包含「@」的實體變數名稱字串陣列。

class C
  def initialize(x, y)
    @x, @y = x, y
  end
end

C.new(0, 1).instance_variable_names # => ["@y", "@x"]

如果接收者存在則返回接收者，否則返回 nil。 object.presence 等效於

object.present? ? object : nil

例如，像這樣的东西

state   = params[:state]   if params[:state].present?
country = params[:country] if params[:country].present?
region  = state || country || 'US'

變成

region = params[:state].presence || params[:country].presence || 'US'

@return [Object]

如果接收者包含在參數中，則返回接收者，否則返回 nil。參數必須是任何響應 #include? 的物件。用法

params[:bucket_type].presence_in %w( project calendar )

如果參數不響應 #include?，則會拋出 ArgumentError。

@return [Object]

如果物件不是空白，則該物件存在。

@return [true, false]

to_s 的別名。

使用給定的 key 作為參數名稱，將物件轉換為適用於 URL 查詢字串的字串。

呼叫名稱作為第一個參數的公開方法，就像 public_send 一樣，不同的是，如果接收者沒有響應它，則呼叫返回 nil 而不是引發異常。

定義此方法是為了能夠編寫

@person.try(:name)

而不是

@person.name if @person

可以鏈式呼叫 try

@person.try(:spouse).try(:name)

而不是

@person.spouse.name if @person && @person.spouse

如果接收者沒有響應該方法，try 也將返回 nil

@person.try(:non_existing_method) # => nil

而不是

@person.non_existing_method if @person.respond_to?(:non_existing_method) # => nil

當在 nil 上呼叫 try 時，無論它是否響應該方法，都會返回 nil

nil.try(:to_i) # => nil, rather than 0

如果被呼叫，參數和程式碼塊將被轉發到該方法

@posts.try(:each_slice, 2) do |a, b|
  ...
end

簽名中的參數數量必須匹配。如果物件響應該方法，則嘗試呼叫，並且在參數不匹配的情況下仍然會引發 ArgumentError。

如果在沒有參數的情況下呼叫 try，它會將接收者傳遞給給定的程式碼塊，除非它是 nil

@person.try do |p|
  ...
end

您也可以在不接受參數的情況下使用程式碼塊呼叫 try，並且程式碼塊將被 instance_eval'ed

@person.try { upcase.truncate(50) }

另請注意，try 定義在 Object 上。因此，它不適用於祖先中沒有 Object 的類別的實體，例如 BasicObject 的直接子類別。

與 try 相同，但如果接收者不是 nil 且未實現嘗試的方法，則會引發 NoMethodError 異常。

"a".try!(:upcase) # => "A"
nil.try!(:upcase) # => nil
123.try!(:upcase) # => NoMethodError: undefined method `upcase' for 123:Integer

在程式碼塊周圍設定和還原公開屬性。

client.timeout # => 5
client.with(timeout: 1) do |c|
  c.timeout # => 1
end
client.timeout # => 5

接收者會被傳遞給提供的程式碼塊。

這個方法是常見的 begin/ensure 模式的一種簡寫。

old_value = object.attribute
begin
  object.attribute = new_value
  # do things
ensure
  object.attribute = old_value
end

只要讀取和寫入方法都是公開的，它就可以用於任何物件。

一種將重複程式碼從傳遞給一系列方法呼叫的選項中提取出來的優雅方法。在區塊中呼叫的每個方法，以區塊變數作為接收者，都會將其選項與提供的預設 options 雜湊 或類似 雜湊 的物件合併。在區塊變數上呼叫的每個方法都必須將選項雜湊作為其最後一個參數。

沒有 with_options，這段程式碼包含重複的部分

class Account < ActiveRecord::Base
  has_many :customers, dependent: :destroy
  has_many :products,  dependent: :destroy
  has_many :invoices,  dependent: :destroy
  has_many :expenses,  dependent: :destroy
end

使用 with_options，我們可以移除重複的部分

class Account < ActiveRecord::Base
  with_options dependent: :destroy do |assoc|
    assoc.has_many :customers
    assoc.has_many :products
    assoc.has_many :invoices
    assoc.has_many :expenses
  end
end

它也可以與明確的接收者一起使用

I18n.with_options locale: user.locale, scope: 'newsletter' do |i18n|
  subject i18n.t :subject
  body    i18n.t :body, user_name: user.name
end

當您沒有傳遞明確的接收者時，它會在合併選項的上下文中執行整個區塊

class Account < ActiveRecord::Base
  with_options dependent: :destroy do
    has_many :customers
    has_many :products
    has_many :invoices
    has_many :expenses
  end
end

with_options 也可以巢狀使用，因為呼叫會轉發給它的接收者。

注意：除了自身的預設值之外，每個巢狀層級還會合併繼承的預設值。

class Post < ActiveRecord::Base
  with_options if: :persisted?, length: { minimum: 50 } do
    validates :content, if: -> { content.present? }
  end
end

程式碼等效於

validates :content, length: { minimum: 50 }, if: -> { content.present? }

因此，if 鍵的繼承預設值會被忽略。

注意：您不能在 with_options 內隱式呼叫類別方法。您可以改用類別名稱來存取這些方法

class Phone < ActiveRecord::Base
  enum :phone_number_type, { home: 0, office: 1, mobile: 2 }

  with_options presence: true do
    validates :phone_number_type, inclusion: { in: Phone.phone_number_types.keys }
  end
end

當省略區塊參數時，會返回裝飾後的 物件 實例

module MyStyledHelpers
  def styled
    with_options style: "color: red;"
  end
end

styled.link_to "I'm red", "/"
# => <a href="/" style="color: red;">I'm red</a>

styled.button_tag "I'm red too!"
# => <button style="color: red;">I'm red too!</button>