diff options
Diffstat (limited to 'zh-cn')
| -rw-r--r-- | zh-cn/bash-cn.html.markdown | 189 | ||||
| -rw-r--r-- | zh-cn/csharp-cn.html.markdown | 3 | ||||
| -rw-r--r-- | zh-cn/go-cn.html.markdown | 4 | ||||
| -rw-r--r-- | zh-cn/groovy-cn.html.markdown | 420 | ||||
| -rw-r--r-- | zh-cn/java-cn.html.markdown | 2 | ||||
| -rw-r--r-- | zh-cn/javascript-cn.html.markdown | 7 | ||||
| -rw-r--r-- | zh-cn/markdown-cn.html.markdown | 4 | ||||
| -rw-r--r-- | zh-cn/ruby-cn.html.markdown | 9 | ||||
| -rw-r--r-- | zh-cn/rust-cn.html.markdown | 296 | 
9 files changed, 889 insertions, 45 deletions
| diff --git a/zh-cn/bash-cn.html.markdown b/zh-cn/bash-cn.html.markdown index 6afa659a..d85e5b8f 100644 --- a/zh-cn/bash-cn.html.markdown +++ b/zh-cn/bash-cn.html.markdown @@ -5,7 +5,14 @@ contributors:      - ["Max Yankov", "https://github.com/golergka"]      - ["Darren Lin", "https://github.com/CogBear"]      - ["Alexandre Medeiros", "http://alemedeiros.sdf.org"] +    - ["Denis Arh", "https://github.com/darh"] +    - ["akirahirose", "https://twitter.com/akirahirose"] +    - ["Anton Strömkvist", "http://lutic.org/"] +    - ["Rahil Momin", "https://github.com/iamrahil"] +    - ["Gregrory Kielian", "https://github.com/gskielian"] +    - ["Etan Reisner", "https://github.com/deryni"]  translators: +    - ["Jinchang Ye", "https://github.com/Alwayswithme"]      - ["Chunyang Xu", "https://github.com/XuChunyang"]  filename: LearnBash-cn.sh  lang: zh-cn @@ -23,31 +30,45 @@ Bash 是一个为 GNU 计划编写的 Unix shell,是 Linux 和 Mac OS X 下的  # 如你所见,注释以 # 开头,shebang 也是注释。  # 显示 “Hello world!” -echo Hello, world! +echo Hello world!  # 每一句指令以换行或分号隔开:  echo 'This is the first line'; echo 'This is the second line'  # 声明一个变量: -VARIABLE="Some string" +Variable="Some string"  # 下面是错误的做法: -VARIABLE = "Some string" -# Bash 会把 VARIABLE 当做一个指令,由于找不到该指令,因此这里会报错。 +Variable = "Some string" +# Bash 会把 Variable 当做一个指令,由于找不到该指令,因此这里会报错。 +# 也不可以这样: +Variable= 'Some string' +# Bash 会认为 'Some string' 是一条指令,由于找不到该指令,这里再次报错。 +# (这个例子中 'Variable=' 这部分会被当作仅对 'Some string' 起作用的赋值。)  # 使用变量: -echo $VARIABLE -echo "$VARIABLE" -echo '$VARIABLE' +echo $Variable +echo "$Variable" +echo '$Variable'  # 当你赋值 (assign) 、导出 (export),或者以其他方式使用变量时,变量名前不加 $。  # 如果要使用变量的值, 则要加 $。  # 注意: ' (单引号) 不会展开变量(即会屏蔽掉变量)。  # 在变量内部进行字符串代换 -echo ${VARIABLE/Some/A} -# 会把 VARIABLE 中首次出现的 "some" 替换成 “A”。 +echo ${Variable/Some/A} +# 会把 Variable 中首次出现的 "some" 替换成 “A”。 + +# 变量的截取 +Length=7 +echo ${Variable:0:Length} +# 这样会仅返回变量值的前7个字符 + +# 变量的默认值 +echo ${Foo:-"DefaultValueIfFooIsMissingOrEmpty"} +# 对 null (Foo=) 和空串 (Foo="") 起作用; 零(Foo=0)时返回0 +# 注意这仅返回默认值而不是改变变量的值  # 内置变量:  # 下面的内置变量很有用 @@ -55,26 +76,37 @@ echo "Last program return value: $?"  echo "Script's PID: $$"  echo "Number of arguments: $#"  echo "Scripts arguments: $@" -echo "Scripts arguments separeted in different variables: $1 $2..." +echo "Scripts arguments separated in different variables: $1 $2..."  # 读取输入:  echo "What's your name?" -read NAME # 这里不需要声明新变量 -echo Hello, $NAME! +read Name # 这里不需要声明新变量 +echo Hello, $Name!  # 通常的 if 结构看起来像这样:  # 'man test' 可查看更多的信息 -if [ $NAME -ne $USER ] +if [ $Name -ne $USER ]  then -    echo "Your name is you username" +    echo "Your name isn't your username"  else -    echo "Your name isn't you username" +    echo "Your name is your username"  fi  # 根据上一个指令执行结果决定是否执行下一个指令 -echo "Always executed" || echo "Only executed if first command fail" +echo "Always executed" || echo "Only executed if first command fails"  echo "Always executed" && echo "Only executed if first command does NOT fail" +# 在 if 语句中使用 && 和 || 需要多对方括号 +if [ $Name == "Steve" ] && [ $Age -eq 15 ] +then +    echo "This will run if $Name is Steve AND $Age is 15." +fi + +if [ $Name == "Daniya" ] || [ $Name == "Zach" ] +then +    echo "This will run if $Name is Daniya OR Zach." +fi +  # 表达式的格式如下:  echo $(( 10 + 5 )) @@ -88,18 +120,54 @@ ls -l # 列出文件和目录的详细信息  # 用下面的指令列出当前目录下所有的 txt 文件:  ls -l | grep "\.txt" +# 重定向输入和输出(标准输入,标准输出,标准错误)。 +# 以 ^EOF$ 作为结束标记从标准输入读取数据并覆盖 hello.py : +cat > hello.py << EOF +#!/usr/bin/env python +from __future__ import print_function +import sys +print("#stdout", file=sys.stdout) +print("#stderr", file=sys.stderr) +for line in sys.stdin: +    print(line, file=sys.stdout) +EOF +  # 重定向可以到输出,输入和错误输出。 -python2 hello.py < "input.in" -python2 hello.py > "output.out" -python2 hello.py 2> "error.err" +python hello.py < "input.in" +python hello.py > "output.out" +python hello.py 2> "error.err" +python hello.py > "output-and-error.log" 2>&1 +python hello.py > /dev/null 2>&1  # > 会覆盖已存在的文件, >> 会以累加的方式输出文件中。 +python hello.py >> "output.out" 2>> "error.err" + +# 覆盖 output.out , 追加 error.err 并统计行数 +info bash 'Basic Shell Features' 'Redirections' > output.out 2>> error.err +wc -l output.out error.err + +# 运行指令并打印文件描述符 (比如 /dev/fd/123) +# 具体可查看: man fd +echo <(echo "#helloworld") + +# 以 "#helloworld" 覆盖 output.out: +cat > output.out <(echo "#helloworld") +echo "#helloworld" > output.out +echo "#helloworld" | cat > output.out +echo "#helloworld" | tee output.out >/dev/null + +# 清理临时文件并显示详情(增加 '-i' 选项启用交互模式) +rm -v output.out error.err output-and-error.log  # 一个指令可用 $( ) 嵌套在另一个指令内部:  # 以下的指令会打印当前目录下的目录和文件总数  echo "There are $(ls | wc -l) items here." +# 反引号 `` 起相同作用,但不允许嵌套 +# 优先使用 $(  ). +echo "There are `ls | wc -l` items here." +  # Bash 的 case 语句与 Java 和 C++ 中的 switch 语句类似: -case "$VARIABLE" in +case "$Variable" in      # 列出需要匹配的字符串      0) echo "There is a zero.";;      1) echo "There is a one.";; @@ -107,11 +175,37 @@ case "$VARIABLE" in  esac  # 循环遍历给定的参数序列: -# 变量$VARIABLE 的值会被打印 3 次。 -# 注意 ` ` 和 $( ) 等价。seq 返回长度为 3 的数组。 -for VARIABLE in `seq 3` +# 变量$Variable 的值会被打印 3 次。 +for Variable in {1..3} +do +    echo "$Variable" +done + +# 或传统的 “for循环” : +for ((a=1; a <= 3; a++))  do -    echo "$VARIABLE" +    echo $a +done + +# 也可以用于文件 +# 用 cat 输出 file1 和 file2 内容 +for Variable in file1 file2 +do +    cat "$Variable" +done + +# 或作用于其他命令的输出 +# 对 ls 输出的文件执行 cat 指令。 +for Output in $(ls) +do +    cat "$Output" +done + +# while 循环: +while [ true ] +do +    echo "loop body here..." +    break  done  # 你也可以使用函数 @@ -132,17 +226,52 @@ bar ()  }  # 调用函数 -foo "My name is" $NAME +foo "My name is" $Name  # 有很多有用的指令需要学习: -tail -n 10 file.txt  # 打印 file.txt 的最后 10 行 -head -n 10 file.txt +tail -n 10 file.txt  # 打印 file.txt 的前 10 行 -sort file.txt +head -n 10 file.txt  # 将 file.txt 按行排序 -uniq -d file.txt +sort file.txt  # 报告或忽略重复的行,用选项 -d 打印重复的行 -cut -d ',' -f 1 file.txt +uniq -d file.txt  # 打印每行中 ',' 之前内容 +cut -d ',' -f 1 file.txt +# 将 file.txt 文件所有 'okay' 替换为 'great', (兼容正则表达式) +sed -i 's/okay/great/g' file.txt +# 将 file.txt 中匹配正则的行打印到标准输出 +# 这里打印以 "foo" 开头, "bar" 结尾的行 +grep "^foo.*bar$" file.txt +# 使用选项 "-c" 统计行数 +grep -c "^foo.*bar$" file.txt +# 如果只是要按字面形式搜索字符串而不是按正则表达式,使用 fgrep (或 grep -F) +fgrep "^foo.*bar$" file.txt  + + +# 以 bash 内建的 'help' 指令阅读 Bash 自带文档: +help +help help +help for +help return +help source +help . + +# 用 man 指令阅读相关的 Bash 手册 +apropos bash +man 1 bash +man bash + +# 用 info 指令查阅命令的 info 文档 (info 中按 ? 显示帮助信息) +apropos info | grep '^info.*(' +man info +info info +info 5 info + +# 阅读 Bash 的 info 文档: +info bash +info bash 'Bash Features' +info bash 6 +info --apropos bash  ``` diff --git a/zh-cn/csharp-cn.html.markdown b/zh-cn/csharp-cn.html.markdown index a3cda5b3..971c1be9 100644 --- a/zh-cn/csharp-cn.html.markdown +++ b/zh-cn/csharp-cn.html.markdown @@ -232,7 +232,8 @@ on a new line! ""Wow!"", the masses cried";              // 三元表达式              // 简单的 if/else 语句可以写成:              // <条件> ? <真> : <假> -            string isTrue = (true) ? "True" : "False"; +            int toCompare = 17; +            string isTrue = toCompare == 17 ? "True" : "False";              // While 循环              int fooWhile = 0; diff --git a/zh-cn/go-cn.html.markdown b/zh-cn/go-cn.html.markdown index 9f6a8c15..49224085 100644 --- a/zh-cn/go-cn.html.markdown +++ b/zh-cn/go-cn.html.markdown @@ -239,7 +239,7 @@ func learnConcurrency() {      go inc(0, c) // go is a statement that starts a new goroutine.      go inc(10, c)      go inc(-805, c) -    // 从channel中独处结果并打印。 +    // 从channel中读取结果并打印。      // 打印出什么东西是不可预知的。      fmt.Println(<-c, <-c, <-c) // channel在右边的时候,<-是读操作。 @@ -283,4 +283,4 @@ Go的根源在[Go官方网站](http://golang.org/)。  强烈推荐阅读语言定义部分,很简单而且很简洁!(as language definitions go these days.) -学习Go还要阅读Go标准库的源代码,全部文档化了,可读性非常好,可以学到go,go style和go idioms。在文档中点击函数名,源代码就出来了! +学习Go还要阅读Go[标准库的源代码](http://golang.org/src/),全部文档化了,可读性非常好,可以学到go,go style和go idioms。在[文档](http://golang.org/pkg/)中点击函数名,源代码就出来了! diff --git a/zh-cn/groovy-cn.html.markdown b/zh-cn/groovy-cn.html.markdown new file mode 100644 index 00000000..562a0284 --- /dev/null +++ b/zh-cn/groovy-cn.html.markdown @@ -0,0 +1,420 @@ +--- +language: Groovy +filename: learngroovy-cn.groovy +contributors: +    - ["Roberto Pérez Alcolea", "http://github.com/rpalcolea"] +translators: +    - ["Todd Gao", "http://github.com/7c00"] +lang: zh-cn +--- + +Groovy - Java平台的动态语言。[了解更多。](http://www.groovy-lang.org/) + +```groovy + +/* +  安装: + +  1) 安装 GVM - http://gvmtool.net/ +  2) 安装 Groovy: gvm install groovy +  3) 启动 groovy 控制台,键入: groovyConsole + +*/ + +//  双斜线开始的是单行注释 +/* +像这样的是多行注释 +*/ + +// Hello World +println "Hello world!" + +/* +  变量: + +  可以给变量赋值,以便稍后使用 +*/ + +def x = 1 +println x + +x = new java.util.Date() +println x + +x = -3.1499392 +println x + +x = false +println x + +x = "Groovy!" +println x + +/* +  集合和映射 +*/ + +//创建一个空的列表 +def technologies = [] + +/*** 往列表中增加一个元素 ***/ + +// 和Java一样 +technologies.add("Grails") + +// 左移添加,返回该列表 +technologies << "Groovy" + +// 增加多个元素 +technologies.addAll(["Gradle","Griffon"]) + +/*** 从列表中删除元素 ***/ + +// 和Java一样 +technologies.remove("Griffon") + +// 减号也行 +technologies = technologies - 'Grails' + +/*** 遍历列表 ***/ + +// 遍历列表中的元素 +technologies.each { println "Technology: $it"} +technologies.eachWithIndex { it, i -> println "$i: $it"} + +/*** 检查列表内容 ***/ + +//判断列表是否包含某元素,返回boolean +contained = technologies.contains( 'Groovy' ) + +// 或 +contained = 'Groovy' in technologies + +// 检查多个元素 +technologies.containsAll(['Groovy','Grails']) + +/*** 列表排序 ***/ + +// 排序列表(修改原列表) +technologies.sort() + +// 要想不修改原列表,可以这样: +sortedTechnologies = technologies.sort( false ) + +/*** 列表操作 ***/ + +//替换列表元素 +Collections.replaceAll(technologies, 'Gradle', 'gradle') + +//打乱列表 +Collections.shuffle(technologies, new Random()) + +//清空列表 +technologies.clear() + +//创建空的映射 +def devMap = [:] + +//增加值 +devMap = ['name':'Roberto', 'framework':'Grails', 'language':'Groovy'] +devMap.put('lastName','Perez') + +//遍历映射元素 +devMap.each { println "$it.key: $it.value" } +devMap.eachWithIndex { it, i -> println "$i: $it"} + +//判断映射是否包含某键 +assert devMap.containsKey('name') + +//判断映射是否包含某值 +assert devMap.containsValue('Roberto') + +//取得映射所有的键 +println devMap.keySet() + +//取得映射所有的值 +println devMap.values() + +/* +  Groovy Beans + +  GroovyBeans 是 JavaBeans,但使用了更简单的语法 + +  Groovy 被编译为字节码时,遵循下列规则。 + +    * 如果一个名字声明时带有访问修饰符(public, private, 或者 protected), +      则会生成一个字段(field)。 + +    * 名字声明时没有访问修饰符,则会生成一个带有public getter和setter的 +      private字段,即属性(property)。 + +    * 如果一个属性声明为final,则会创建一个final的private字段,但不会生成setter。 + +    * 可以声明一个属性的同时定义自己的getter和setter。 + +    * 可以声明具有相同名字的属性和字段,该属性会使用该字段。 + +    * 如果要定义private或protected属性,必须提供声明为private或protected的getter +      和setter。 + +    * 如果使用显式或隐式的 this(例如 this.foo, 或者 foo)访问类的在编译时定义的属性, +      Groovy会直接访问对应字段,而不是使用getter或者setter + +    * 如果使用显式或隐式的 foo 访问一个不存在的属性,Groovy会通过元类(meta class) +      访问它,这可能导致运行时错误。 + +*/ + +class Foo { +    // 只读属性 +    final String name = "Roberto" + +    // 只读属性,有public getter和protected setter +    String language +    protected void setLanguage(String language) { this.language = language } + +    // 动态类型属性 +    def lastName +} + +/* +  逻辑分支和循环 +*/ + +//Groovy支持常见的if - else语法 +def x = 3 + +if(x==1) { +    println "One" +} else if(x==2) { +    println "Two" +} else { +    println "X greater than Two" +} + +//Groovy也支持三元运算符 +def y = 10 +def x = (y > 1) ? "worked" : "failed" +assert x == "worked" + +//for循环 +//使用区间(range)遍历 +def x = 0 +for (i in 0 .. 30) { +    x += i +} + +//遍历列表 +x = 0 +for( i in [5,3,2,1] ) { +    x += i +} + +//遍历数组 +array = (0..20).toArray() +x = 0 +for (i in array) { +    x += i +} + +//遍历映射 +def map = ['name':'Roberto', 'framework':'Grails', 'language':'Groovy'] +x = 0 +for ( e in map ) { +    x += e.value +} + +/* +  运算符 + +  在Groovy中以下常用运算符支持重载: +  http://www.groovy-lang.org/operators.html#Operator-Overloading + +  实用的groovy运算符 +*/ +//展开(spread)运算符:对聚合对象的所有元素施加操作 +def technologies = ['Groovy','Grails','Gradle'] +technologies*.toUpperCase() // 相当于 technologies.collect { it?.toUpperCase() } + +//安全导航(safe navigation)运算符:用来避免NullPointerException +def user = User.get(1) +def username = user?.username + + +/* +  闭包 +  Groovy闭包好比代码块或者方法指针,它是一段代码定义,可以以后执行。 + +  更多信息见:http://www.groovy-lang.org/closures.html +*/ +//例子: +def clos = { println "Hello World!" } + +println "Executing the Closure:" +clos() + +//传参数给闭包 +def sum = { a, b -> println a+b } +sum(2,4) + +//闭包可以引用参数列表以外的变量 +def x = 5 +def multiplyBy = { num -> num * x } +println multiplyBy(10) + +// 只有一个参数的闭包可以省略参数的定义 +def clos = { print it } +clos( "hi" ) + +/* +  Groovy可以记忆闭包结果 [1][2][3] +*/ +def cl = {a, b -> +    sleep(3000) // 模拟费时操作 +    a + b +} + +mem = cl.memoize() + +def callClosure(a, b) { +    def start = System.currentTimeMillis() +    mem(a, b) +    println "Inputs(a = $a, b = $b) - took ${System.currentTimeMillis() - start} msecs." +} + +callClosure(1, 2) +callClosure(1, 2) +callClosure(2, 3) +callClosure(2, 3) +callClosure(3, 4) +callClosure(3, 4) +callClosure(1, 2) +callClosure(2, 3) +callClosure(3, 4) + +/* +  Expando + +  Expando类是一种动态bean类,可以给它的实例添加属性和添加闭包作为方法 + +  http://mrhaki.blogspot.mx/2009/10/groovy-goodness-expando-as-dynamic-bean.html +*/ +  def user = new Expando(name:"Roberto") +  assert 'Roberto' == user.name + +  user.lastName = 'Pérez' +  assert 'Pérez' == user.lastName + +  user.showInfo = { out -> +      out << "Name: $name" +      out << ", Last name: $lastName" +  } + +  def sw = new StringWriter() +  println user.showInfo(sw) + + +/* +  元编程(MOP) +*/ + +//使用ExpandoMetaClass增加行为 +String.metaClass.testAdd = { +    println "we added this" +} + +String x = "test" +x?.testAdd() + +//拦截方法调用 +class Test implements GroovyInterceptable { +    def sum(Integer x, Integer y) { x + y } + +    def invokeMethod(String name, args) { +        System.out.println "Invoke method $name with args: $args" +    } +} + +def test = new Test() +test?.sum(2,3) +test?.multiply(2,3) + +//Groovy支持propertyMissing,来处理属性解析尝试 +class Foo { +   def propertyMissing(String name) { name } +} +def f = new Foo() + +assertEquals "boo", f.boo + +/* +  类型检查和静态编译 +  Groovy天生是并将永远是一门动态语言,但也支持类型检查和静态编译 + +  更多: http://www.infoq.com/articles/new-groovy-20 +*/ +//类型检查 +import groovy.transform.TypeChecked + +void testMethod() {} + +@TypeChecked +void test() { +    testMeethod() + +    def name = "Roberto" + +    println naameee + +} + +//另一例子 +import groovy.transform.TypeChecked + +@TypeChecked +Integer test() { +    Integer num = "1" + +    Integer[] numbers = [1,2,3,4] + +    Date date = numbers[1] + +    return "Test" + +} + +//静态编译例子 +import groovy.transform.CompileStatic + +@CompileStatic +int sum(int x, int y) { +    x + y +} + +assert sum(2,5) == 7 + + +``` + +## 进阶资源 + +[Groovy文档](http://www.groovy-lang.org/documentation.html) + +[Groovy web console](http://groovyconsole.appspot.com/) + +加入[Groovy用户组](http://www.groovy-lang.org/usergroups.html) + +## 图书 + +* [Groovy Goodness] (https://leanpub.com/groovy-goodness-notebook) + +* [Groovy in Action] (http://manning.com/koenig2/) + +* [Programming Groovy 2: Dynamic Productivity for the Java Developer] (http://shop.oreilly.com/product/9781937785307.do) + +[1] http://roshandawrani.wordpress.com/2010/10/18/groovy-new-feature-closures-can-now-memorize-their-results/ +[2] http://www.solutionsiq.com/resources/agileiq-blog/bid/72880/Programming-with-Groovy-Trampoline-and-Memoize +[3] http://mrhaki.blogspot.mx/2011/05/groovy-goodness-cache-closure-results.html + + + diff --git a/zh-cn/java-cn.html.markdown b/zh-cn/java-cn.html.markdown index f08d3507..12afa59a 100644 --- a/zh-cn/java-cn.html.markdown +++ b/zh-cn/java-cn.html.markdown @@ -149,7 +149,7 @@ public class LearnJava {          // 位运算操作符          /* -        ~       补 +        ~       取反,求反码          <<      带符号左移          >>      带符号右移          >>>     无符号右移 diff --git a/zh-cn/javascript-cn.html.markdown b/zh-cn/javascript-cn.html.markdown index 64b0aadc..bdef0099 100644 --- a/zh-cn/javascript-cn.html.markdown +++ b/zh-cn/javascript-cn.html.markdown @@ -341,7 +341,7 @@ var myFunc = myObj.myFunc;  myFunc(); // = undefined  // 相应的,一个函数也可以被指定为一个对象的方法,并且可以通过`this`访问 -// 这个对象的成员,即使在行数被定义时并没有依附在对象上。 +// 这个对象的成员,即使在函数被定义时并没有依附在对象上。  var myOtherFunc = function(){      return this.myString.toUpperCase();  } @@ -402,7 +402,7 @@ myObj.meaningOfLife; // = 42  // 函数也可以工作。  myObj.myFunc() // = "hello world!" -// 当然,如果你要访问的成员在原型当中也没有定义的话,解释器就会去找原型的原型,以此类堆。 +// 当然,如果你要访问的成员在原型当中也没有定义的话,解释器就会去找原型的原型,以此类推。  myPrototype.__proto__ = {      myBoolean: true  }; @@ -447,9 +447,6 @@ myNumber === myNumberObj; // = false  if (0){      // 这段代码不会执行,因为0代表假  } -if (Number(0)){ -    // 这段代码*会*执行,因为Number(0)代表真 -}  // 不过,包装类型和内置类型共享一个原型,  // 所以你实际可以给内置类型也增加一些功能,例如对string: diff --git a/zh-cn/markdown-cn.html.markdown b/zh-cn/markdown-cn.html.markdown index 1c577efb..b633714d 100644 --- a/zh-cn/markdown-cn.html.markdown +++ b/zh-cn/markdown-cn.html.markdown @@ -69,7 +69,7 @@ __此文本也是__  <!-- 如果你插入一个 HTML中的<br />标签,你可以在段末加入两个以上的空格,  然后另起一段。--> -此段落结尾有两个空格(选中以显示)。       +此段落结尾有两个空格(选中以显示)。    上文有一个 <br /> ! @@ -127,7 +127,7 @@ __此文本也是__  <!-- 代码段落 -->  <!-- 代码段落(HTML中 <code>标签)可以由缩进四格(spaces) -或者一个标签页(tab)实现--> +或者一个制表符(tab)实现-->      This is code      So is this diff --git a/zh-cn/ruby-cn.html.markdown b/zh-cn/ruby-cn.html.markdown index 99250b43..14d38137 100644 --- a/zh-cn/ruby-cn.html.markdown +++ b/zh-cn/ruby-cn.html.markdown @@ -7,6 +7,7 @@ contributors:    - ["Joel Walden", "http://joelwalden.net"]    - ["Luke Holder", "http://twitter.com/lukeholder"]    - ["lidashuang", "https://github.com/lidashuang"] +  - ["ftwbzhao", "https://github.com/ftwbzhao"]  translators:    - ["Lin Xiangyu", "https://github.com/oa414"]  --- @@ -120,11 +121,11 @@ status == :approved #=> false  # 数组  # 这是一个数组 -[1, 2, 3, 4, 5] #=> [1, 2, 3, 4, 5] +array = [1, 2, 3, 4, 5] #=> [1, 2, 3, 4, 5]  # 数组可以包含不同类型的元素 -array = [1, "hello", false] #=> => [1, "hello", false] +[1, "hello", false] #=> [1, "hello", false]  # 数组可以被索引  # 从前面开始 @@ -140,8 +141,8 @@ array.[] 12 #=> nil  # 从尾部开始  array[-1] #=> 5 -# 同时指定开始的位置和结束的位置 -array[2, 4] #=> [3, 4, 5] +# 同时指定开始的位置和长度 +array[2, 3] #=> [3, 4, 5]  # 或者指定一个范围  array[1..3] #=> [2, 3, 4] diff --git a/zh-cn/rust-cn.html.markdown b/zh-cn/rust-cn.html.markdown new file mode 100644 index 00000000..17a897df --- /dev/null +++ b/zh-cn/rust-cn.html.markdown @@ -0,0 +1,296 @@ +--- +language: rust +contributors: +    - ["P1start", "http://p1start.github.io/"] +translators: +    - ["Guangming Mao", "http://maogm.com"] +filename: learnrust-cn.rs +lang: zh-cn +--- + +Rust 是由 Mozilla 研究院开发的编程语言。Rust 将底层的性能控制与高级语言的便利性和安全保障结合在了一起。 + +而 Rust 并不需要一个垃圾回收器或者运行时即可实现这个目的,这使得 Rust 库可以成为一种 C 语言的替代品。 + +Rust 第一版(0.1 版)发布于 2012 年 1 月,3 年以来一直在紧锣密鼓地迭代。 +因为更新太频繁,一般建议使用每夜构建版而不是稳定版,直到最近 1.0 版本的发布。 + +2015 年 3 月 15 日,Rust 1.0 发布,完美向后兼容,最新的每夜构建版提供了缩短编译时间等新特性。 +Rust 采用了持续迭代模型,每 6 周一个发布版。Rust 1.1 beta 版在 1.0 发布时同时发布。 + +尽管 Rust 相对来说是一门底层语言,它提供了一些常见于高级语言的函数式编程的特性。这让 Rust 不仅高效,并且易用。 + +```rust +// 这是注释,单行注释... +/* ...这是多行注释 */ + +/////////////// +// 1. 基础   // +/////////////// + +// 函数 (Functions) +// `i32` 是有符号 32 位整数类型(32-bit signed integers) +fn add2(x: i32, y: i32) -> i32 { +    // 隐式返回 (不要分号) +    x + y +} + +// 主函数(Main function) +fn main() { +    // 数字 (Numbers) // + +    // 不可变绑定 +    let x: i32 = 1; + +    // 整形/浮点型数 后缀 +    let y: i32 = 13i32; +    let f: f64 = 1.3f64; + +    // 类型推导 +    // 大部分时间,Rust 编译器会推导变量类型,所以不必把类型显式写出来。 +    // 这个教程里面很多地方都显式写了类型,但是只是为了示范。 +    // 绝大部分时间可以交给类型推导。 +    let implicit_x = 1; +    let implicit_f = 1.3; + +    // 算术运算 +    let sum = x + y + 13; + +    // 可变变量 +    let mut mutable = 1; +    mutable = 4; +    mutable += 2; + +    // 字符串 (Strings) // + +    // 字符串字面量 +    let x: &str = "hello world!"; + +    // 输出 +    println!("{} {}", f, x); // 1.3 hello world + +    // 一个 `String` – 在堆上分配空间的字符串 +    let s: String = "hello world".to_string(); + +    // 字符串分片(slice) - 另一个字符串的不可变视图 +    // 基本上就是指向一个字符串的不可变指针,它不包含字符串里任何内容,只是一个指向某个东西的指针 +    // 比如这里就是 `s` +    let s_slice: &str = &s; + +    println!("{} {}", s, s_slice); // hello world hello world + +    // 数组 (Vectors/arrays) // + +    // 长度固定的数组 (array) +    let four_ints: [i32; 4] = [1, 2, 3, 4]; + +    // 变长数组 (vector) +    let mut vector: Vec<i32> = vec![1, 2, 3, 4]; +    vector.push(5); + +    // 分片 - 某个数组(vector/array)的不可变视图 +    // 和字符串分片基本一样,只不过是针对数组的 +    let slice: &[i32] = &vector; + +    // 使用 `{:?}` 按调试样式输出 +    println!("{:?} {:?}", vector, slice); // [1, 2, 3, 4, 5] [1, 2, 3, 4, 5] + +    // 元组 (Tuples) // + +    // 元组是固定大小的一组值,可以是不同类型 +    let x: (i32, &str, f64) = (1, "hello", 3.4); + +    // 解构 `let` +    let (a, b, c) = x; +    println!("{} {} {}", a, b, c); // 1 hello 3.4 + +    // 索引 +    println!("{}", x.1); // hello + +    ////////////// +    // 2. 类型 (Type)  // +    ////////////// + +    // 结构体(Sturct) +    struct Point { +        x: i32, +        y: i32, +    } + +    let origin: Point = Point { x: 0, y: 0 }; + +    // 匿名成员结构体,又叫“元组结构体”(‘tuple struct’) +    struct Point2(i32, i32); + +    let origin2 = Point2(0, 0); + +    // 基础的 C 风格枚举类型(enum) +    enum Direction { +        Left, +        Right, +        Up, +        Down, +    } + +    let up = Direction::Up; + +    // 有成员的枚举类型 +    enum OptionalI32 { +        AnI32(i32), +        Nothing, +    } + +    let two: OptionalI32 = OptionalI32::AnI32(2); +    let nothing = OptionalI32::Nothing; + +    // 泛型 (Generics) // + +    struct Foo<T> { bar: T } + +    // 这个在标准库里面有实现,叫 `Option` +    enum Optional<T> { +        SomeVal(T), +        NoVal, +    } + +    // 方法 (Methods) // + +    impl<T> Foo<T> { +        // 方法需要一个显式的 `self` 参数 +        fn get_bar(self) -> T { +            self.bar +        } +    } + +    let a_foo = Foo { bar: 1 }; +    println!("{}", a_foo.get_bar()); // 1 + +    // 接口(Traits) (其他语言里叫 interfaces 或 typeclasses) // + +    trait Frobnicate<T> { +        fn frobnicate(self) -> Option<T>; +    } + +    impl<T> Frobnicate<T> for Foo<T> { +        fn frobnicate(self) -> Option<T> { +            Some(self.bar) +        } +    } + +    let another_foo = Foo { bar: 1 }; +    println!("{:?}", another_foo.frobnicate()); // Some(1) + +    /////////////////////////////////// +    // 3. 模式匹配 (Pattern matching) // +    /////////////////////////////////// + +    let foo = OptionalI32::AnI32(1); +    match foo { +        OptionalI32::AnI32(n) => println!("it’s an i32: {}", n), +        OptionalI32::Nothing  => println!("it’s nothing!"), +    } + +    // 高级模式匹配 +    struct FooBar { x: i32, y: OptionalI32 } +    let bar = FooBar { x: 15, y: OptionalI32::AnI32(32) }; + +    match bar { +        FooBar { x: 0, y: OptionalI32::AnI32(0) } => +            println!("The numbers are zero!"), +        FooBar { x: n, y: OptionalI32::AnI32(m) } if n == m => +            println!("The numbers are the same"), +        FooBar { x: n, y: OptionalI32::AnI32(m) } => +            println!("Different numbers: {} {}", n, m), +        FooBar { x: _, y: OptionalI32::Nothing } => +            println!("The second number is Nothing!"), +    } + +    /////////////////////////////// +    // 4. 流程控制 (Control flow) // +    /////////////////////////////// + +    // `for` 循环 +    let array = [1, 2, 3]; +    for i in array.iter() { +        println!("{}", i); +    } + +    // 区间 (Ranges) +    for i in 0u32..10 { +        print!("{} ", i); +    } +    println!(""); +    // 输出 `0 1 2 3 4 5 6 7 8 9 ` + +    // `if` +    if 1 == 1 { +        println!("Maths is working!"); +    } else { +        println!("Oh no..."); +    } + +    // `if` 可以当表达式 +    let value = if true { +        "good" +    } else { +        "bad" +    }; + +    // `while` 循环 +    while 1 == 1 { +        println!("The universe is operating normally."); +    } + +    // 无限循环 +    loop { +        println!("Hello!"); +    } + +    //////////////////////////////////////////////// +    // 5. 内存安全和指针 (Memory safety & pointers) // +    //////////////////////////////////////////////// + +    // 独占指针 (Owned pointer) - 同一时刻只能有一个对象能“拥有”这个指针 +    // 意味着 `Box` 离开他的作用域后,会被安全地释放 +    let mut mine: Box<i32> = Box::new(3); +    *mine = 5; // 解引用 +    // `now_its_mine` 获取了 `mine` 的所有权。换句话说,`mine` 移动 (move) 了 +    let mut now_its_mine = mine; +    *now_its_mine += 2; + +    println!("{}", now_its_mine); // 7 +    // println!("{}", mine); // 编译报错,因为现在 `now_its_mine` 独占那个指针 + +    // 引用 (Reference) – 引用其他数据的不可变指针 +    // 当引用指向某个值,我们称为“借用”这个值,因为是被不可变的借用,所以不能被修改,也不能移动 +    // 借用一直持续到生命周期结束,即离开作用域 +    let mut var = 4; +    var = 3; +    let ref_var: &i32 = &var; + +    println!("{}", var); //不像 `box`, `var` 还可以继续使用 +    println!("{}", *ref_var); +    // var = 5; // 编译报错,因为 `var` 被借用了 +    // *ref_var = 6; // 编译报错,因为 `ref_var` 是不可变引用 + +    // 可变引用 (Mutable reference) +    // 当一个变量被可变地借用时,也不可使用 +    let mut var2 = 4; +    let ref_var2: &mut i32 = &mut var2; +    *ref_var2 += 2; + +    println!("{}", *ref_var2); // 6 +    // var2 = 2; // 编译报错,因为 `var2` 被借用了 +} +``` + +## 更深入的资料 + +Rust 还有很多很多其他内容 - 这只是 Rust 最基本的功能,帮助你了解 Rust 里面最重要的东西。 +如果想深入学习 Rust,可以去读 +[The Rust Programming Language](http://doc.rust-lang.org/book/index.html) +或者上 reddit [/r/rust](http://reddit.com/r/rust) 订阅。 +同时 irc.mozilla.org 的 #rust 频道上的小伙伴们也非常欢迎新来的朋友。 + +你可以在这个在线编译器 [Rust playpen](http://play.rust-lang.org) 上尝试 Rust 的一些特性 +或者上[官方网站](http://rust-lang.org). | 
