instance method `first`

Ruby on Rails 7.0.10

Since v3.0.20

Available in: v3.0.20 v3.1.12 v3.2.22.5 v4.0.13 v4.1.16 v4.2.9 v5.2.8.1 v6.0.6 v6.1.7.10 v7.0.10 v7.1.6 v7.2.3 v8.0.4 v8.1.2

Compare with:

first(limit = 1)

Returns the first character. If a limit is supplied, returns a substring from the beginning of the string until it reaches the limit value. If the given limit is greater than or equal to the string length, returns a copy of self.

str = "hello"
str.first    # => "h"
str.first(1) # => "h"
str.first(2) # => "he"
str.first(0) # => ""
str.first(6) # => "hello"

Parameters

limit opt = 1

Source

# File activesupport/lib/active_support/core_ext/string/access.rb, line 78
  def first(limit = 1)
    self[0, limit] || raise(ArgumentError, "negative limit")
  end

Defined in activesupport/lib/active_support/core_ext/string/access.rb line 78 · View on GitHub · Improve this page · Find usages on GitHub

Defined in String

Signature

Parameters