方法 (Methods)

方法 (Methods)

方法定义 (Method definitions)

• 函数要接参数的时候就用括号, 不用参数时就不用写括号了。 下面是正确的例子.[link]

   def some_method
     #  body omitted
   end

   def some_method_with_parameters(arg1, arg2)
     #  body omitted
   end

• 不要用默认参数，用一个选项 hash 来做这个事。[link]

  #  错误
  def obliterate(things, gently = true, except = [], at = Time.now)
    ...
  end

  #  正确
  def obliterate(things, options = {})
    default_options = {
      :gently => true, #  obliterate with soft-delete
      :except => [], #  skip obliterating these things
      :at => Time.now, #  don't obliterate them until later
    }
    options.reverse_merge!(default_options)

    ...
  end

• 避免定义单行函数，虽然有些人喜欢这样写，但是这样容易引起一些奇怪的问题
  [link]

  #  错误
  def too_much; something; something_else; end

  #  正确
  def some_method
    #  body
  end

方法调用 (Method calls)

应该用 圆括号 的情况：

• 如果方法会返回值。
  [link]

  #  错误
  @current_user = User.find_by_id 1964192

  #  正确
  @current_user = User.find_by_id(1964192)

• 如果第一个参数需要圆括号。[link]

  #  错误
  put! (x + y) % len, value

  #  正确
  put!((x + y) % len, value)

• 方法名和左括号之间永远不要放空格。[link]

  #  错误
  f (3 + 2) + 1

  #  正确
  f(3 + 2) + 1

• 对于不用接收参数的方法， 忽略圆括号 。[link]

  #  错误
  nil?()

  #  正确
  nil?

• 如果方法不返回值 (或者我们不关心返回值)，那么带不带括号都行。
  (如果参数会导致代码多于一行， 建议加个括号比较有可读性)
  [link]

  #  okay
  render(:partial => 'foo')

  #  okay
  render :partial => 'foo'

不论什么情况:

• 如果一个方法的最后一个参数接收 hash， 那么不需要 { } 。
  [link]

  #  错误
  get '/v1/reservations', { :id => 54875 }

  #  正确
  get '/v1/reservations', :id => 54875