summaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
-rw-r--r--zh-cn/ruby-cn.html.markdown401
1 files changed, 339 insertions, 62 deletions
diff --git a/zh-cn/ruby-cn.html.markdown b/zh-cn/ruby-cn.html.markdown
index 14d38137..2d181de0 100644
--- a/zh-cn/ruby-cn.html.markdown
+++ b/zh-cn/ruby-cn.html.markdown
@@ -10,6 +10,7 @@ contributors:
- ["ftwbzhao", "https://github.com/ftwbzhao"]
translators:
- ["Lin Xiangyu", "https://github.com/oa414"]
+ - ["Jiang Haiyun", "https://github.com/haiiiiiyun"]
---
```ruby
@@ -35,6 +36,13 @@ translators:
8 - 1 #=> 7
10 * 2 #=> 20
35 / 5 #=> 7
+2**5 #=> 32
+5 % 3 #=> 2
+
+# 位运算符
+3 & 5 #=> 1
+3 | 5 #=> 7
+3 ^ 5 #=> 6
# 算术符号只是语法糖而已
# 实际上是调用对象的方法
@@ -42,7 +50,7 @@ translators:
10.* 5 #=> 50
# 特殊的值也是对象
-nil # 空
+nil # 相当于其它语言中的 null
true # 真
false # 假
@@ -54,13 +62,11 @@ false.class #=> FalseClass
1 == 1 #=> true
2 == 1 #=> false
-# 不等运算符
+# 不相等运算符
1 != 1 #=> false
2 != 1 #=> true
-!true #=> false
-!false #=> true
-# 除了false自己,nil是唯一的值为false的对象
+# 除了false自己,nil是唯一的另一个值为false的对象
!nil #=> true
!false #=> true
@@ -72,6 +78,26 @@ false.class #=> FalseClass
2 <= 2 #=> true
2 >= 2 #=> true
+
+# 组合比较运算符
+1 <=> 10 #=> -1
+10 <=> 1 #=> 1
+1 <=> 1 #=> 0
+
+# 逻辑运算符
+true && false #=> false
+true || false #=> true
+!true #=> false
+
+# 也有优先级更低的逻辑运算符
+# 它们用于控制流结构中,用来串接语句,直到返回true或false。
+
+# `do_something_else` 只当 `do_something` 返回true时才会被调用
+do_something() and do_something_else()
+# `log_error` 只当 `do_something` 返回false时才会被调用
+do_something() or log_error()
+
+
# 字符串是对象
'I am a string'.class #=> String
@@ -81,9 +107,28 @@ placeholder = "use string interpolation"
"I can #{placeholder} when using double quoted strings"
#=> "I can use string interpolation when using double quoted strings"
+# 尽可能优先使用单引号的字符串
+# 双引号的字符串会进行一些额外的内部处理
+
+# 合并字符串,但不能和数字合并
+'hello ' + 'world' #=> "hello world"
+'hello ' + 3 #=> TypeError: can't convert Fixnum into String
+'hello ' + 3.to_s #=> "hello 3"
+
+# 合并字符串及其运算符
+'hello ' * 3 #=> "hello hello hello "
+
+# 字符串追加
+'hello' << ' world' #=> "hello world"
-# 输出值
+# 打印输出,并在末尾加换行符
puts "I'm printing!"
+#=> I'm printing!
+#=> nil
+
+# 打印输出,不加换行符
+print "I'm printing!"
+#=> I'm printing! => nil
# 变量
x = 25 #=> 25
@@ -96,17 +141,16 @@ x = y = 10 #=> 10
x #=> 10
y #=> 10
-# 按照惯例,用 snake_case 作为变量名
+# 按照惯例,使用类似snake_case风格的变量名
snake_case = true
-# 使用具有描述性的运算符
+# 使用有意义的变量名
path_to_project_root = '/good/name/'
path = '/bad/name/'
# 符号(Symbols,也是对象)
-# 符号是不可变的,内部用整数类型表示的可重用的值。
-# 通常用它代替字符串来有效地表示有意义的值。
-
+# 符号是不可变的,内部用整数值表示的可重用的常数
+# 通常用它代替字符串来有效地表示有意义的值
:pending.class #=> Symbol
@@ -132,26 +176,36 @@ array = [1, 2, 3, 4, 5] #=> [1, 2, 3, 4, 5]
array[0] #=> 1
array[12] #=> nil
-# 像运算符一样,[var]形式的访问
-# 也就是一个语法糖
-# 实际上是调用对象的[] 方法
+# 像运算符一样,[var] 形式的访问
+# 也只是语法糖
+# 实际上是调用对象的 [] 方法
array.[] 0 #=> 1
array.[] 12 #=> nil
# 从尾部开始
array[-1] #=> 5
+array.last #=> 5
# 同时指定开始的位置和长度
array[2, 3] #=> [3, 4, 5]
-# 或者指定一个范围
+# 将数组逆序
+a=[1,2,3]
+a.reverse! #=> [3,2,1]
+
+# 或者指定一个区间
array[1..3] #=> [2, 3, 4]
# 像这样往数组增加一个元素
array << 6 #=> [1, 2, 3, 4, 5, 6]
+# 或者像这样
+array.push(6) #=> [1, 2, 3, 4, 5, 6]
-# 哈希表是Ruby的键值对的基本数据结构
-# 哈希表由大括号定义
+# 检查元素是否包含在数组中
+array.include?(1) #=> true
+
+# 哈希表是 Ruby 的主要键/值对表示法
+# 哈希表由大括号表示
hash = {'color' => 'green', 'number' => 5}
hash.keys #=> ['color', 'number']
@@ -163,19 +217,14 @@ hash['number'] #=> 5
# 查询一个不存在地键将会返回nil
hash['nothing here'] #=> nil
-# 用 #each 方法来枚举哈希表:
-hash.each do |k, v|
- puts "#{k} is #{v}"
-end
-
-# 从Ruby 1.9开始, 用符号作为键的时候有特别的记号表示:
+# 从Ruby 1.9开始,用符号作为键的时候有特别的记号表示:
-new_hash = { defcon: 3, action: true}
+new_hash = { defcon: 3, action: true }
new_hash.keys #=> [:defcon, :action]
# 小贴士:数组和哈希表都是可枚举的
-# 它们可以共享一些有用的方法,比如each, map, count 等等
+# 它们共享一些有用的方法,比如each,map,count等等
# 控制流
@@ -196,9 +245,15 @@ end
#=> iteration 4
#=> iteration 5
-# 然而
-# 没人用for循环
-# 用`each`来代替,就像这样
+
+# 但是,没有人用for循环。
+# 你应该使用"each"方法,然后再传给它一个块。
+# 所谓块就是可以传给像"each"这样的方法的代码段。
+# 它类似于其它语言中的lambdas, 匿名函数或闭包。
+#
+# 区间上的"each"方法会对区间中的每个元素运行一次块代码。
+# 我们将counter作为一个参数传给了块。
+# 调用带有块的"each"方法看起来如下:
(1..5).each do |counter|
puts "iteration #{counter}"
@@ -209,6 +264,23 @@ end
#=> iteration 4
#=> iteration 5
+# 你也可以将块包含在一个大括号中:
+(1..5).each { |counter| puts "iteration #{counter}" }
+
+# 数据结构中的内容也可以使用each来遍历。
+array.each do |element|
+ puts "#{element} is part of the array"
+end
+hash.each do |key, value|
+ puts "#{key} is #{value}"
+end
+
+# 如果你还需要索引值,可以使用"each_with_index",并且定义
+# 一个索引变量
+array.each_with_index do |element, index|
+ puts "#{element} is number #{index} in the array"
+end
+
counter = 1
while counter <= 5 do
puts "iteration #{counter}"
@@ -220,6 +292,20 @@ end
#=> iteration 4
#=> iteration 5
+# Ruby 中还有很多有用的循环遍历函数,
+# 如"map","reduce","inject"等等。
+# 以map为例,它会遍历数组,并根据你在
+# 块中定义的逻辑对它进行处理,然后返回
+# 一个全新的数组。
+array = [1,2,3,4,5]
+doubled = array.map do |element|
+ element * 2
+end
+puts doubled
+#=> [2,4,6,8,10]
+puts array
+#=> [1,2,3,4,5]
+
grade = 'B'
case grade
@@ -236,6 +322,33 @@ when 'F'
else
puts "Alternative grading system, eh?"
end
+#=> "Better luck next time"
+
+# case也可以用区间
+grade = 82
+case grade
+when 90..100
+ puts 'Hooray!'
+when 80...90
+ puts 'OK job'
+else
+ puts 'You failed!'
+end
+#=> "OK job"
+
+# 异常处理:
+begin
+ # 这里的代码可能会抛出异常
+ raise NoMemoryError, 'You ran out of memory.'
+rescue NoMemoryError => exception_variable
+ puts 'NoMemoryError was raised', exception_variable
+rescue RuntimeError => other_exception_variable
+ puts 'RuntimeError was raised now'
+else
+ puts 'This runs if no exceptions were thrown at all'
+ensure
+ puts 'This code always runs no matter what'
+end
# 函数
@@ -243,7 +356,7 @@ def double(x)
x * 2
end
-# 函数 (以及所有的方法块) 隐式地返回了最后语句的值
+# 函数 (以及所有的块) 隐式地返回最后语句的值
double(2) #=> 4
# 当不存在歧义的时候括号是可有可无的
@@ -261,8 +374,8 @@ sum 3, 4 #=> 7
sum sum(3,4), 5 #=> 12
# yield
-# 所有的方法都有一个隐式的块参数
-# 可以用yield参数调用
+# 所有的方法都有一个隐式的,可选的块参数
+# 可以用 'yield' 关键字调用
def surround
puts "{"
@@ -276,45 +389,84 @@ surround { puts 'hello world' }
# hello world
# }
+# 可以向函数传递一个块
+# "&"标记传递的块是一个引用
+def guests(&block)
+ block.call 'some_argument'
+end
-# 用class关键字定义一个类
-class Human
-
- # 一个类变量,它被这个类地所有实例变量共享
- @@species = "H. sapiens"
+# 可以传递多个参数,这些参数会转成一个数组,
+# 这也是使用星号符 ("*") 的原因:
+def guests(*array)
+ array.each { |guest| puts guest }
+end
- # 构造函数
- def initialize(name, age=0)
- # 将参数name的值赋给实例变量@name
- @name = name
- # 如果没有给出age, 那么会采用参数列表中地默认地值
- @age = age
- end
+# 如果函数返回一个数组,在赋值时可以进行拆分:
+def foods
+ ['pancake', 'sandwich', 'quesadilla']
+end
+breakfast, lunch, dinner = foods
+breakfast #=> 'pancake'
+dinner #=> 'quesadilla'
- # 基本的 setter 方法
- def name=(name)
- @name = name
- end
+# 按照惯例,所有返回布尔值的方法都以?结尾
+5.even? # false
+5.odd? # true
- # 基本地 getter 方法
- def name
- @name
- end
+# 如果方法名末尾有!,表示会做一些破坏性的操作,比如修改调用者自身。
+# 很多方法都会有一个!的版本来进行修改,和一个非!的版本
+# 只用来返回更新了的结果
+company_name = "Dunder Mifflin"
+company_name.upcase #=> "DUNDER MIFFLIN"
+company_name #=> "Dunder Mifflin"
+company_name.upcase! # we're mutating company_name this time!
+company_name #=> "DUNDER MIFFLIN"
- # 一个类方法以self.开头
- # 它可以被类调用,但不能被类的实例调用
- def self.say(msg)
- puts "#{msg}"
- end
- def species
- @@species
- end
+# 用class关键字定义一个类
+class Human
+ # 一个类变量,它被这个类的所有实例变量共享
+ @@species = "H. sapiens"
+
+ # 基本构造函数
+ def initialize(name, age = 0)
+ # 将参数值赋给实例变量"name"
+ @name = name
+ # 如果没有给出age,那么会采用参数列表中的默认值
+ @age = age
+ end
+
+ # 基本的setter方法
+ def name=(name)
+ @name = name
+ end
+
+ # 基本地getter方法
+ def name
+ @name
+ end
+
+ # 以上的功能也可以用下面的attr_accessor来封装
+ attr_accessor :name
+
+ # Getter/setter方法也可以像这样单独创建
+ attr_reader :name
+ attr_writer :name
+
+ # 类方法通过使用self与实例方法区别开来。
+ # 它只能通过类来调用,不能通过实例调用。
+ def self.say(msg)
+ puts "#{msg}"
+ end
+
+ def species
+ @@species
+ end
end
-# 类的例子
+# 初始化一个类
jim = Human.new("Jim Halpert")
dwight = Human.new("Dwight K. Schrute")
@@ -327,7 +479,132 @@ jim.name #=> "Jim Halpert II"
dwight.species #=> "H. sapiens"
dwight.name #=> "Dwight K. Schrute"
-# 调用对象的方法
-Human.say("Hi") #=> "Hi"
+# 调用类方法
+Human.say('Hi') #=> "Hi"
+
+# 变量的作用域由它们的名字格式定义
+# 以$开头的变量具有全局域
+$var = "I'm a global var"
+defined? $var #=> "global-variable"
+
+# 以@开头的变量具有实例作用域
+@var = "I'm an instance var"
+defined? @var #=> "instance-variable"
+
+# 以@@开头的变量具有类作用域
+@@var = "I'm a class var"
+defined? @@var #=> "class variable"
+
+# 以大写字母开头的变量是常数
+Var = "I'm a constant"
+defined? Var #=> "constant"
+
+# 类也是对象。因此类也可以有实例变量。
+# 类变量在类以及其继承者之间共享。
+
+# 基类
+class Human
+ @@foo = 0
+
+ def self.foo
+ @@foo
+ end
+
+ def self.foo=(value)
+ @@foo = value
+ end
+end
+
+# 派生类
+class Worker < Human
+end
+
+Human.foo # 0
+Worker.foo # 0
+
+Human.foo = 2 # 2
+Worker.foo # 2
+
+# 类实例变量不能在继承类间共享。
+
+class Human
+ @bar = 0
+
+ def self.bar
+ @bar
+ end
+
+ def self.bar=(value)
+ @bar = value
+ end
+end
+
+class Doctor < Human
+end
+
+Human.bar # 0
+Doctor.bar # nil
+
+module ModuleExample
+ def foo
+ 'foo'
+ end
+end
+
+# '包含'模块后,模块的方法会绑定为类的实例方法
+# '扩展'模块后,模块的方法会绑定为类方法
+
+class Person
+ include ModuleExample
+end
+
+class Book
+ extend ModuleExample
+end
+
+Person.foo # => NoMethodError: undefined method `foo' for Person:Class
+Person.new.foo # => 'foo'
+Book.foo # => 'foo'
+Book.new.foo # => NoMethodError: undefined method `foo'
+
+# 当包含或扩展一个模块时,相应的回调代码会被执行。
+module ConcernExample
+ def self.included(base)
+ base.extend(ClassMethods)
+ base.send(:include, InstanceMethods)
+ end
+
+ module ClassMethods
+ def bar
+ 'bar'
+ end
+ end
+
+ module InstanceMethods
+ def qux
+ 'qux'
+ end
+ end
+end
+
+class Something
+ include ConcernExample
+end
+
+Something.bar # => 'bar'
+Something.qux # => NoMethodError: undefined method `qux'
+Something.new.bar # => NoMethodError: undefined method `bar'
+Something.new.qux # => 'qux'
```
+
+
+## 其它资源
+
+- [Learn Ruby by Example with Challenges](http://www.learneroo.com/modules/61/nodes/338) - A variant of this reference with in-browser challenges.
+- [An Interactive Tutorial for Ruby](https://rubymonk.com/) - Learn Ruby through a series of interactive tutorials.
+- [Official Documentation](http://ruby-doc.org/core)
+- [Ruby from other languages](https://www.ruby-lang.org/en/documentation/ruby-from-other-languages/)
+- [Programming Ruby](http://www.amazon.com/Programming-Ruby-1-9-2-0-Programmers/dp/1937785491/) - An older [free edition](http://ruby-doc.com/docs/ProgrammingRuby/) is available online.
+- [Ruby Style Guide](https://github.com/bbatsov/ruby-style-guide) - A community-driven Ruby coding style guide.
+- [Try Ruby](http://tryruby.org) - Learn the basic of Ruby programming language, interactive in the browser.