github/rails
1
1
Fork 0
mirror of https://github.com/github/rails.git synced 2026-04-26 03:00:59 -04:00
Code Issues Packages Projects Releases Wiki Activity

much complete rdoc for String#ord

Browse Source
This commit is contained in:
Xavier Noria
2010-04-18 11:55:07 +02:00
parent 0f0b40d3b6
commit bb19f20876
1 changed files with 19 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
activesupport/lib/active_support/core_ext/string/conversions.rb
View File

@@ -3,11 +3,27 @@ require 'active_support/core_ext/time/publicize_conversion_methods'
require 'active_support/core_ext/time/calculations'
class String
# Returns the ASCII code of the first character of the string, assuming it belongs to ASCII.
# Returns the codepoint of the first character of the string, assuming a
# single-byte character encoding:
#
# This method is defined for Ruby 1.9 forward compatibility on ASCII characters.
# "a".ord # => 97
# "à".ord # => 224, in ISO-8859-1
#
# See also <tt>ActiveSupport::Multibyte::Chars#ord</tt>.
# This method is defined in Ruby 1.8 for Ruby 1.9 forward compatibility on
# these character encodings.
#
# <tt>ActiveSupport::Multibyte::Chars#ord</tt> is forward compatible with
# Ruby 1.9 on UTF8 strings:
#
# "a".mb_chars.ord # => 97
# "à".mb_chars.ord # => 224, in UTF8
#
# Note that the 224 is different in both examples. In ISO-8859-1 "à" is
# represented as a single byte, 224. In UTF8 it is represented with two
# bytes, namely 195 and 160, but its Unicode codepoint is 224. If we
# call +ord+ on the UTF8 string "à" the return value will be 195. That is
# not an error, because UTF8 is unsupported, the call itself would be
# bogus.
def ord
self[0]
end unless method_defined?(:ord)