Ruby 1.9 compat: special-case String access methods to not depend on #chars

git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@8538 5ecf4fe2-1ee6-0310-87b1-e25e094e27de
This commit is contained in:
Jeremy Kemper 2008-01-03 02:43:19 +00:00
parent 6a6367d7d2
commit 2ae55ca0b9

@ -1,56 +1,80 @@
module ActiveSupport #:nodoc: module ActiveSupport #:nodoc:
module CoreExtensions #:nodoc: module CoreExtensions #:nodoc:
module String #:nodoc: module String #:nodoc:
# Makes it easier to access parts of a string, such as specific characters and substrings. if RUBY_VERSION < '1.9'
module Access # Makes it easier to access parts of a string, such as specific characters and substrings.
# Returns the character at the +position+ treating the string as an array (where 0 is the first character). module Access
# # Returns the character at the +position+ treating the string as an array (where 0 is the first character).
# Examples: #
# "hello".at(0) # => "h" # Examples:
# "hello".at(4) # => "o" # "hello".at(0) # => "h"
# "hello".at(10) # => nil # "hello".at(4) # => "o"
def at(position) # "hello".at(10) # => nil
chars[position, 1].to_s def at(position)
end chars[position, 1].to_s
end
# Returns the remaining of the string from the +position+ treating the string as an array (where 0 is the first character).
# # Returns the remaining of the string from the +position+ treating the string as an array (where 0 is the first character).
# Examples: #
# "hello".from(0) # => "hello" # Examples:
# "hello".from(2) # => "llo" # "hello".from(0) # => "hello"
# "hello".from(10) # => nil # "hello".from(2) # => "llo"
def from(position) # "hello".from(10) # => nil
chars[position..-1].to_s def from(position)
end chars[position..-1].to_s
end
# Returns the beginning of the string up to the +position+ treating the string as an array (where 0 is the first character).
# # Returns the beginning of the string up to the +position+ treating the string as an array (where 0 is the first character).
# Examples: #
# "hello".to(0) # => "h" # Examples:
# "hello".to(2) # => "hel" # "hello".to(0) # => "h"
# "hello".to(10) # => "hello" # "hello".to(2) # => "hel"
def to(position) # "hello".to(10) # => "hello"
chars[0..position].to_s def to(position)
end chars[0..position].to_s
end
# Returns the first character of the string or the first +limit+ characters. # Returns the first character of the string or the first +limit+ characters.
# #
# Examples: # Examples:
# "hello".first # => "h" # "hello".first # => "h"
# "hello".first(2) # => "he" # "hello".first(2) # => "he"
# "hello".first(10) # => "hello" # "hello".first(10) # => "hello"
def first(limit = 1) def first(limit = 1)
chars[0..(limit - 1)].to_s chars[0..(limit - 1)].to_s
end
# Returns the last character of the string or the last +limit+ characters.
#
# Examples:
# "hello".last # => "o"
# "hello".last(2) # => "lo"
# "hello".last(10) # => "hello"
def last(limit = 1)
(chars[(-limit)..-1] || self).to_s
end
end end
else
# Returns the last character of the string or the last +limit+ characters. module Access #:nodoc:
# def at(position)
# Examples: self[position]
# "hello".last # => "o" end
# "hello".last(2) # => "lo"
# "hello".last(10) # => "hello" def from(position)
def last(limit = 1) self[position..-1]
(chars[(-limit)..-1] || self).to_s end
def to(position)
self[0..position]
end
def first(limit = 1)
self[0..(limit - 1)]
end
def last(limit = 1)
from(-limit) || self
end
end end
end end
end end