diff options
Diffstat (limited to 'zh-cn')
| -rw-r--r-- | zh-cn/awk-cn.html.markdown | 2 | ||||
| -rw-r--r-- | zh-cn/docker-cn.html.markdown | 150 | ||||
| -rw-r--r-- | zh-cn/gdscript-cn.html.markdown | 314 | ||||
| -rw-r--r-- | zh-cn/git-cn.html.markdown | 2 | ||||
| -rw-r--r-- | zh-cn/mips-cn.html.markdown | 2 | ||||
| -rw-r--r-- | zh-cn/python-cn.html.markdown | 739 | ||||
| -rw-r--r-- | zh-cn/raylib-cn.html.markdown | 147 | ||||
| -rw-r--r-- | zh-cn/rust-cn.html.markdown | 2 | ||||
| -rw-r--r-- | zh-cn/sql-cn.html.markdown (renamed from zh-cn/sql.html.markdown) | 0 |
9 files changed, 1191 insertions, 167 deletions
diff --git a/zh-cn/awk-cn.html.markdown b/zh-cn/awk-cn.html.markdown index 8ee2db2c..bac833a6 100644 --- a/zh-cn/awk-cn.html.markdown +++ b/zh-cn/awk-cn.html.markdown @@ -179,7 +179,7 @@ function string_functions( localvar, arr) { # 都是返回替换的个数 localvar = "fooooobar" sub("fo+", "Meet me at the ", localvar) # localvar => "Meet me at the bar" - gsub("e+", ".", localvar) # localvar => "m..t m. at th. bar" + gsub("e", ".", localvar) # localvar => "m..t m. at th. bar" # 搜索匹配正则的字符串 # index() 也是搜索, 不支持正则 diff --git a/zh-cn/docker-cn.html.markdown b/zh-cn/docker-cn.html.markdown new file mode 100644 index 00000000..ff793ae0 --- /dev/null +++ b/zh-cn/docker-cn.html.markdown @@ -0,0 +1,150 @@ +--- +category: tool +tool: docker +lang: zh-cn +filename: docker-cn.bat +contributors: + - ["Ruslan López", "http://javapro.org/"] +translators: + - ["imba-tjd", "https://github.com/imba-tjd/"] +--- + +```bat +:: 下载、安装、运行 hello-world 镜像(image) +docker run hello-world + +:: :: 如果这是第一次运行，你应该能见到这些信息 +:: Unable to find image 'hello-world:latest' locally # 在本地找不到镜像xxx +:: latest: Pulling from library/hello-world +:: 1b930d010525: Pull complete +:: Digest: sha256:4fe721ccc2e8dc7362278a29dc660d833570ec2682f4e4194f4ee23e415e1064 +:: Status: Downloaded newer image for hello-world:latest +:: +:: Hello from Docker! # 来自Docker的欢迎 +:: This message shows that your installation appears to be working correctly. # 此信息表明你的安装似乎成功了 +:: +:: To generate this message, Docker took the following steps: # Docker进行了如下步骤来产生此信息 +:: 1. The Docker client contacted the Docker daemon. # Docker客户端联系Docker守护程序 +:: 2. The Docker daemon pulled the "hello-world" image from the Docker Hub. # Docker守护程序从Docker Hub拉取镜像 +:: (amd64) +:: 3. The Docker daemon created a new container from that image which runs the # Docker守护程序从镜像中创建了一个容器 +:: executable that produces the output you are currently reading. # 运行了产生你正在读的输出的可执行文件 +:: 4. The Docker daemon streamed that output to the Docker client, which sent it # Docker守护程序把输出流式传输给Docker客户端，后者发送到你的终端上 +:: to your terminal. +:: +:: To try something more ambitious, you can run an Ubuntu container with: # 若要尝试更强大的东西，你可以用该命令运行Ubuntu容器 +:: $ docker run -it ubuntu bash +:: +:: Share images, automate workflows, and more with a free Docker ID: # 使用免费的Docker ID来分享镜像，自动化工作流等 +:: https://hub.docker.com/ +:: +:: For more examples and ideas, visit: # 欲获取更多例子和想法，访问 +:: https://docs.docker.com/get-started/ + +:: 现在来看看当前正运行的镜像 +docker ps +:: CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS +:: NAMES + +:: 看看之前运行过的镜像 +docker ps -a + +:: CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS +:: NAMES +:: 4a76281f9c53 hello-world "/hello" 2 minutes ago Exited (0) 2 minutes ago +:: happy_poincare +:: 名字(name)是自动生成的，因此它会和你的不同 + +:: 移除(remove)我们之前生成的镜像 +docker rm happy_poincare + +:: 测试是否真的删除了 +docker ps -a +:: CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS +:: NAMES + +:: 为容器(container)指定自定义名字 +docker run --name test_container hello-world +:: Hello from Docker! +:: This message shows that your installation appears to be working correctly. +:: +:: To generate this message, Docker took the following steps: +:: 1. The Docker client contacted the Docker daemon. +:: 2. The Docker daemon pulled the "hello-world" image from the Docker Hub. +:: (amd64) +:: 3. The Docker daemon created a new container from that image which runs the +:: executable that produces the output you are currently reading. +:: 4. The Docker daemon streamed that output to the Docker client, which sent it +:: to your terminal. +:: +:: To try something more ambitious, you can run an Ubuntu container with: +:: $ docker run -it ubuntu bash +:: +:: Share images, automate workflows, and more with a free Docker ID: +:: https://hub.docker.com/ +:: +:: For more examples and ideas, visit: +:: https://docs.docker.com/get-started/ + +docker ps -a +:: CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS +:: NAMES +:: d345fe1a4f41 hello-world "/hello" About a minute ago Exited (0) About a minute ago +:: test_container +:: 如你所见，名字现在是我们指定的了 + +:: 从命名过的容器中获取日志(logs) +docker logs test_container +:: Hello from Docker! +:: This message shows that your installation appears to be working correctly. +:: +:: To generate this message, Docker took the following steps: +:: 1. The Docker client contacted the Docker daemon. +:: 2. The Docker daemon pulled the "hello-world" image from the Docker Hub. +:: (amd64) +:: 3. The Docker daemon created a new container from that image which runs the +:: executable that produces the output you are currently reading. +:: 4. The Docker daemon streamed that output to the Docker client, which sent it +:: to your terminal. +:: +:: To try something more ambitious, you can run an Ubuntu container with: +:: $ docker run -it ubuntu bash +:: +:: Share images, automate workflows, and more with a free Docker ID: +:: https://hub.docker.com/ +:: +:: For more examples and ideas, visit: +:: https://docs.docker.com/get-started/ + +docker rm test_container + +docker run ubuntu +:: Unable to find image 'ubuntu:latest' locally +:: latest: Pulling from library/ubuntu +:: 2746a4a261c9: Pull complete +:: 4c1d20cdee96: Pull complete 0d3160e1d0de: Pull complete c8e37668deea: Pull complete Digest: sha256:250cc6f3f3ffc5cdaa9d8f4946ac79821aafb4d3afc93928f0de9336eba21aa4 +:: Status: Downloaded newer image for ubuntu:latest + +docker ps -a +:: CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS +:: NAMES +:: c19e9e5b000a ubuntu "/bin/bash" 5 seconds ago Exited (0) 4 seconds ago +:: relaxed_nobel + +:: 在交互模式(interactive mode)下运行容器 +docker run -it ubuntu +:: root@e2cac48323d2:/# uname +:: Linux +:: root@e2cac48323d2:/# exit +:: exit + +docker rm relaxed_nobel + +docker ps -a +:: CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS +:: NAMES +:: e2cac48323d2 ubuntu "/bin/bash" 2 minutes ago Exited (0) About a minute ago +:: nifty_goldwasser + +docker rm nifty_goldwasser +``` diff --git a/zh-cn/gdscript-cn.html.markdown b/zh-cn/gdscript-cn.html.markdown new file mode 100644 index 00000000..3405bb8d --- /dev/null +++ b/zh-cn/gdscript-cn.html.markdown @@ -0,0 +1,314 @@ +--- +language: GDScript +contributors: + - ["Wichamir", "https://github.com/Wichamir/"] +translators: + - ["ShiftWatchOut", "https://github.com/ShiftWatchOut"] +filename: learngdscript-cn.gd +lang: zh-cn +--- + +GDScript 是一种动态类型的脚本语言，专门为免费开源游戏引擎 Godot 制作。 GDScript 的语法类似 Python。 +它的主要优点是易于使用和与引擎深度集成。 它非常适合游戏开发。 + +## 基础 + +```nim +# 单行注释使用 # 号书写。 +""" + 多行 + 注释 + 是 + 使用 + 文档字符串(docstring) + 书写。 +""" + +# 脚本文件本身默认是一个类，文件名为类名，您也可以为其定义其他名称。 +class_name MyClass + +# 继承 +extends Node2D + +# 成员变量 +var x = 8 # 整型 +var y = 1.2 # 浮点型 +var b = true # 布尔型 +var s = "Hello World!" # 字符串 +var a = [1, false, "brown fox"] # 数组(Array) - 类似于 Python 的列表(list), + # 它可以同时保存不同类型的变量。 +var d = { + "key" : "value", + 42 : true +} # 字典包含键值对。 +var p_arr = PoolStringArray(["Hi", "there", "!"]) # 池数组只能包含单一类型。 + # 放入其他类型会被转换为目标类型 + +# 内置向量类型: +var v2 = Vector2(1, 2) +var v3 = Vector3(1, 2, 3) + +# 常量 +const ANSWER_TO_EVERYTHING = 42 +const BREAKFAST = "Spam and eggs!" + +# 枚举 +enum { ZERO, ONE , TWO, THREE } +enum NamedEnum { ONE = 1, TWO, THREE } + +# 导出的变量将在检查器中可见。 +export(int) var age +export(float) var height +export var person_name = "Bob" # 如果设置了默认值，则不需要类型注解。 + +# 函数 +func foo(): + pass # pass 关键字是未书写的代码的占位符 + +func add(first, second): + return first + second + +# 打印值 +func printing(): + print("GDScript ", "简直", "棒呆了") + prints("这", "些", "字", "被", "空", "格", "分", "割") + printt("这", "些", "字", "被", "制", "表", "符", "分", "割") + printraw("这句话将被打印到系统控制台。") + +# 数学 +func doing_math(): + var first = 8 + var second = 4 + print(first + second) # 12 + print(first - second) # 4 + print(first * second) # 32 + print(first / second) # 2 + print(first % second) # 0 + # 还有 +=, -=, *=, /=, %= 等操作符，但并没有 ++ 和 -- . + print(pow(first, 2)) # 64 + print(sqrt(second)) # 2 + printt(PI, TAU, INF, NAN) # 内置常量 + +# 控制流 +func control_flow(): + x = 8 + y = 2 # y 最初被设为一个浮点数， + # 但我们可以利用语言提供的动态类型能力将它的类型变为整型！ + + if x < y: + print("x 小于 y") + elif x > y: + print("x 大于 y") + else: + print("x 等于 y") + + var a = true + var b = false + var c = false + if a and b or not c: # 你也可以用 &&, || 和 ! + print("看到这句说明上面的条件判断为真！") + + for i in range(20): # GDScript 有类似 Python 的 range 函数 + print(i) # 所以这句将打印从 0 到 19 的数字 + + for i in ["two", 3, 1.0]: # 遍历数组 + print(i) + + while x > y: + printt(x, y) + y += 1 + + x = 2 + y = 10 + while x < y: + x += 1 + if x == 6: + continue # continue 语句使 x 等于 6 时，程序跳过这次循环后面的代码，不会打印 6。 + prints("x 等于：", x) + if x == 7: + break # 循环将在 x 等于 7 处跳出，后续所有循环不再执行，因此不会打印 8、9 和 10 + + match x: + 1: + print("match 很像其他语言中的 switch.") + 2: + print("但是，您不需要在每个值之前写一个 case 关键字。") + 3: + print("此外，每种情况都会默认跳出。") + break # 错误！不要在 match 里用 break 语句！ + 4: + print("如果您需要跳过后续代码，这里也使用 continue 关键字。") + continue + _: + print("下划线分支，在其他分支都不满足时，在这里书写默认的逻辑。") + + # 三元运算符 (写在一行的 if-else 语句) + prints("x 是", "正值" if x >= 0 else "负值") + +# 类型转换 +func casting_examples(): + var i = 42 + var f = float(42) # 使用变量构造函数强制转换 + var b = i as bool # 或使用 as 关键字 + +# 重载函数 +# 通常，我们只会重载以下划线开头的内置函数， +# 但实际上您可以重载几乎任何函数。 + +# _init 在对象初始化时被调用。 +# 这是对象的构造函数。 +func _init(): + # 在此处初始化对象的内部属性。 + pass + +# _ready 在脚本节点及其子节点进入场景树时被调用。 +func _ready(): + pass + +# _process 在每一帧上都被调用。 +func _process(delta): + # 传递给此函数的 delta 参数是时间，即从上一帧到当前帧经过的秒数。 + print("Delta 时间为：", delta) + +# _physics_process 在每个物理帧上都被调用。 +# 这意味着 delta 应该是恒定的。 +func _physics_process(delta): + # 使用向量加法和乘法进行简单移动。 + var direction = Vector2(1, 0) # 或使用 Vector2.RIGHT + var speed = 100.0 + self.global_position += direction * speed * delta + # self 指向当前类的实例 + +# 重载函数时，您可以使用 . 运算符调用父函数 +# like here: +func get_children(): + # 在这里做一些额外的事情。 + var r = .get_children() # 调用父函数的实现 + return r + +# 内部类 +class InnerClass: + extends Object + + func hello(): + print("来自内部类的 Hello！") + +func use_inner_class(): + var ic = InnerClass.new() + ic.hello() + ic.free() # 可以自行释放内存 +``` + +## 访问场景树中其他节点 + +```nim +extends Node2D + +var sprite # 该变量将用来保存引用。 + +# 您可以在 _ready 中获取对其他节点的引用。 +func _ready() -> void: + # NodePath 对于访问节点很有用。 + # 将 String 传递给其构造函数来创建 NodePath： + var path1 = NodePath("path/to/something") + # 或者使用 NodePath 字面量: + var path2 = @"path/to/something" + # NodePath 示例: + var path3 = @"Sprite" # 相对路径，当前节点的直接子节点 + var path4 = @"Timers/Firerate" # 相对路径，子节点的子节点 + var path5 = @".." # 当前节点的父节点 + var path6 = @"../Enemy" # 当前节点的兄弟节点 + var path7 = @"/root" # 绝对路径，等价于 get_tree().get_root() + var path8 = @"/root/Main/Player/Sprite" # Player 的 Sprite 的绝对路径 + var path9 = @"Timers/Firerate:wait_time" # 访问属性 + var path10 = @"Player:position:x" # 访问子属性 + + # 最后，获取节点引用可以使用以下方法: + sprite = get_node(@"Sprite") as Sprite # 始终转换为您期望的类型 + sprite = get_node("Sprite") as Sprite # 这里 String 被隐式转换为 NodePath + sprite = get_node(path3) as Sprite + sprite = get_node_or_null("Sprite") as Sprite + sprite = $Sprite as Sprite + +func _process(delta): + # 现在我们就可以在别处使用 sprite 里保存的引用了。 + prints("Sprite 有一个全局位置 ", sprite.global_position) + +# 在 _ready 执行之前，使用 onready 关键字为变量赋值。 +# 这是一种常用的语法糖。 +onready var tween = $Tween as Tween + +# 您可以导出这个 NodePath，以便在检查器中给它赋值。 +export var nodepath = @"" +onready var reference = get_node(nodepath) as Node +``` + +## 信号(Signals) + +信号系统是 Godot 对观察者编程模式的实现。例子如下: + +```nim +class_name Player extends Node2D + +var hp = 10 + +signal died() # 定义一个信号 +signal hurt(hp_old, hp_new) # 信号可以带参数 + +func apply_damage(dmg): + var hp_old = hp + hp -= dmg + emit_signal("hurt", hp_old, hp) # 发出信号并传递参数 + if hp <= 0: + emit_signal("died") + +func _ready(): + # 将信号 "died" 连接到 self 中定义的 _on_death 函数 + self.connect("died", self, "_on_death") + +func _on_death(): + self.queue_free() # 死亡时销毁 Player +``` + +## 类型注解 + +GDScript 可以选择性地使用静态类型。 + +```nim +extends Node + +var x: int # 定义带有类型的变量 +var y: float = 4.2 +var z := 1.0 # 使用 := 运算符根据默认值推断类型 + +onready var node_ref_typed := $Child as Node + +export var speed := 50.0 + +const CONSTANT := "Typed constant." + +func _ready() -> void: + # 此函数不返回任何东西 + x = "string" # 错误！不要更改类型！ + return + +func join(arg1: String, arg2: String) -> String: + # 此函数接受两个 String 并返回一个 String。 + return arg1 + arg2 + +func get_child_at(index: int) -> Node: + # 此函数接受一个 int 并返回一个 Node + return get_children()[index] + +signal example(arg: int) # 错误！信号不能接受类型参数！ +``` + +## 延展阅读 + +* [Godot's Website](https://godotengine.org/) +* [Godot Docs](https://docs.godotengine.org/en/stable/) +* [Getting started with GDScript](https://docs.godotengine.org/en/stable/getting_started/scripting/gdscript/index.html) +* [NodePath](https://docs.godotengine.org/en/stable/classes/class_nodepath.html) +* [Signals](https://docs.godotengine.org/en/stable/getting_started/step_by_step/signals.html) +* [GDQuest](https://www.gdquest.com/) +* [GDScript.com](https://gdscript.com/)
\ No newline at end of file diff --git a/zh-cn/git-cn.html.markdown b/zh-cn/git-cn.html.markdown index 63d740a1..9dfbbb93 100644 --- a/zh-cn/git-cn.html.markdown +++ b/zh-cn/git-cn.html.markdown @@ -370,5 +370,3 @@ $ git rm /pather/to/the/file/HelloWorld.c * [Atlassian Git - 教程与工作流程](https://www.atlassian.com/git/) * [SalesForce Cheat Sheet](https://na1.salesforce.com/help/doc/en/salesforce_git_developer_cheatsheet.pdf) - -* [GitGuys](http://www.gitguys.com/) diff --git a/zh-cn/mips-cn.html.markdown b/zh-cn/mips-cn.html.markdown index 83888338..4f9ea7da 100644 --- a/zh-cn/mips-cn.html.markdown +++ b/zh-cn/mips-cn.html.markdown @@ -160,7 +160,7 @@ MIPS（Microprocessor without Interlocked Pipeline Stages）汇编语言是为 # 让 $s0 = a, $s1 = b, $s2 = c, $v0 = 返回寄存器 ble $s0, $s1, a_LTE_b # 如果 (a <= b) 跳转到 (a_LTE_b) ble $s0, $s2, max_C # 如果 (a > b && a <= c) 跳转到 (max_C) - move $v0, $s1 # 否则 [a > b && a > c] max = a + move $v0, $s0 # 否则 [a > b && a > c] max = a j done # 跳转到程序结束 a_LTE_b: # 当 a <= b 时的标签 diff --git a/zh-cn/python-cn.html.markdown b/zh-cn/python-cn.html.markdown index 4469443f..a4e53c1b 100644 --- a/zh-cn/python-cn.html.markdown +++ b/zh-cn/python-cn.html.markdown @@ -6,8 +6,10 @@ contributors: - ["Andre Polykanine", "https://github.com/Oire"] translators: - ["Geoff Liu", "http://geoffliu.me"] + - ["Maple", "https://github.com/mapleincode"] filename: learnpython-cn.py lang: zh-cn + --- Python 是由吉多·范罗苏姆(Guido Van Rossum)在 90 年代早期设计。 @@ -19,7 +21,6 @@ Python 是由吉多·范罗苏姆(Guido Van Rossum)在 90 年代早期设计。 注意：这篇教程是基于 Python 3 写的。如果你想学旧版 Python 2，我们特别有[另一篇教程](http://learnxinyminutes.com/docs/pythonlegacy/)。 ```python - # 用井字符开头的是单行注释 """ 多行字符串用三个引号 @@ -35,50 +36,66 @@ Python 是由吉多·范罗苏姆(Guido Van Rossum)在 90 年代早期设计。 3 # => 3 # 算术没有什么出乎意料的 -1 + 1 # => 2 -8 - 1 # => 7 +1 + 1 # => 2 +8 - 1 # => 7 10 * 2 # => 20 # 但是除法例外，会自动转换成浮点数 35 / 5 # => 7.0 -5 / 3 # => 1.6666666666666667 +10.0 / 3 # => 3.3333333333333335 # 整数除法的结果都是向下取整 -5 // 3 # => 1 -5.0 // 3.0 # => 1.0 # 浮点数也可以 --5 // 3 # => -2 --5.0 // 3.0 # => -2.0 +5 // 3 # => 1 +5.0 // 3.0 # => 1.0 # 浮点数也可以 +-5 // 3 # => -2 +-5.0 // 3.0 # => -2.0 # 浮点数的运算结果也是浮点数 3 * 2.0 # => 6.0 # 模除 7 % 3 # => 1 +# i % j 结果的正负符号会和 j 相同，而不是和 i 相同 +-7 % 3 # => 2 -# x的y次方 +# x 的 y 次方 2**4 # => 16 # 用括号决定优先级 +1 + 3 * 2 # => 7 (1 + 3) * 2 # => 8 -# 布尔值 -True -False +# 布尔值 (注意: 首字母大写) +True # => True +False # => False -# 用not取非 -not True # => False +# 用 not 取非 +not True # => False not False # => True -# 逻辑运算符，注意and和or都是小写 +# 逻辑运算符，注意 and 和 or 都是小写 True and False # => False False or True # => True -# 整数也可以当作布尔值 -0 and 2 # => 0 --5 or 0 # => -5 +# True 和 False 实质上就是数字 1 和0 +True + True # => 2 +True * 8 # => 8 +False - 5 # => -5 + +# 数值与 True 和 False 之间的比较运算 0 == False # => True 2 == True # => False 1 == True # => True +-5 != False # => True + +# 使用布尔逻辑运算符对数字类型的值进行运算时，会把数值强制转换为布尔值进行运算 +# 但计算结果会返回它们的强制转换前的值 +# 注意不要把 bool(ints) 与位运算的 "按位与"、"按位或" (&, |) 混淆 +bool(0) # => False +bool(4) # => True +bool(-6) # => True +0 and 2 # => 0 +-5 or 0 # => -5 # 用==判断相等 1 == 1 # => True @@ -94,43 +111,66 @@ False or True # => True 2 <= 2 # => True 2 >= 2 # => True +# 判断一个值是否在范围里 +1 < 2 and 2 < 3 # => True +2 < 3 and 3 < 2 # => False # 大小比较可以连起来！ 1 < 2 < 3 # => True 2 < 3 < 2 # => False -# 字符串用单引双引都可以 +# (is 对比 ==) is 判断两个变量是否引用同一个对象, +# 而 == 判断两个对象是否含有相同的值 +a = [1, 2, 3, 4] # 变量 a 是一个新的列表, [1, 2, 3, 4] +b = a # 变量 b 赋值了变量 a 的值 +b is a # => True, a 和 b 引用的是同一个对象 +b == a # => True, a 和 b 的对象的值相同 +b = [1, 2, 3, 4] # 变量 b 赋值了一个新的列表, [1, 2, 3, 4] +b is a # => False, a 和 b 引用的不是同一个对象 +b == a # => True, a 和 b 的对象的值相同 + + +# 创建字符串可以使用单引号（'）或者双引号（"） "这是个字符串" '这也是个字符串' -# 用加号连接字符串 +# 字符串可以使用加号连接成新的字符串 "Hello " + "world!" # => "Hello world!" +# 非变量形式的字符串甚至可以在没有加号的情况下连接 +"Hello " "world!" # => "Hello world!" # 字符串可以被当作字符列表 -"This is a string"[0] # => 'T' +"Hello world!"[0] # => 'H' -# 用.format来格式化字符串 -"{} can be {}".format("strings", "interpolated") +# 你可以获得字符串的长度 +len("This is a string") # => 16 +# 你可以使用 f-strings 格式化字符串（python3.6+） +name = "Reiko" +f"She said her name is {name}." # => "She said her name is Reiko" +# 你可以在大括号内几乎加入任何 python 表达式，表达式的结果会以字符串的形式返回 +f"{name} is {len(name)} characters long." # => "Reiko is 5 characters long." + +# 用 .format 来格式化字符串 +"{} can be {}".format("strings", "interpolated") # 可以重复参数以节省时间 "{0} be nimble, {0} be quick, {0} jump over the {1}".format("Jack", "candle stick") # => "Jack be nimble, Jack be quick, Jack jump over the candle stick" - # 如果不想数参数，可以用关键字 "{name} wants to eat {food}".format(name="Bob", food="lasagna") # => "Bob wants to eat lasagna" -# 如果你的Python3程序也要在Python2.5以下环境运行，也可以用老式的格式化语法 +# 如果你的 Python3 程序也要在 Python2.5 以下环境运行，也可以用老式的格式化语法 "%s can be %s the %s way" % ("strings", "interpolated", "old") # None是一个对象 None # => None -# 当与None进行比较时不要用 ==，要用is。is是用来比较两个变量是否指向同一个对象。 +# 当与 None 进行比较时不要用 ==，要用 is。is 是用来比较两个变量是否指向同一个对象。 "etc" is None # => False None is None # => True -# None，0，空字符串，空列表，空字典，空元组都算是False -# 所有其他值都是True +# None，0，空字符串，空列表，空字典，空元组都算是 False +# 所有其他值都是 True bool(0) # => False bool("") # => False bool([]) # => False @@ -145,16 +185,26 @@ bool(()) # => False # print是内置的打印函数 print("I'm Python. Nice to meet you!") +# 默认情况下，print 函数会在输出结果后加入一个空行作为结尾 +# 可以使用附加参数改变输出结尾 +print("Hello, World", end="!") # => Hello, World! + +# 可以很简单的从终端获得输入数据 +input_string_var = input("Enter some data: ") # 返回字符串数值 + # 在给变量赋值前不用提前声明 -# 传统的变量命名是小写，用下划线分隔单词 +# 习惯上变量命名是小写，用下划线分隔单词 some_var = 5 some_var # => 5 # 访问未赋值的变量会抛出异常 # 参考流程控制一段来学习异常处理 -some_unknown_var # 抛出NameError +some_unknown_var # 抛出 NameError + +# "if" 可以用作表达式，它的作用等同于 C 语言的三元运算符 "?:" +"yay!" if 0 > 1 else "nay!" # => "nay!" -# 用列表(list)储存序列 +# 用列表 (list) 储存序列 li = [] # 创建列表时也可以同时赋给元素 other_li = [4, 5, 6] @@ -174,128 +224,177 @@ li[0] # => 1 # 取出最后一个元素 li[-1] # => 3 -# 越界存取会造成IndexError -li[4] # 抛出IndexError +# 越界存取会造成 IndexError +li[4] # 抛出 IndexError # 列表有切割语法 -li[1:3] # => [2, 4] +li[1:3] # => [2, 4] # 取尾 -li[2:] # => [4, 3] +li[2:] # => [4, 3] # 取头 -li[:3] # => [1, 2, 4] +li[:3] # => [1, 2, 4] # 隔一个取一个 -li[::2] # =>[1, 4] +li[::2] # =>[1, 4] # 倒排列表 li[::-1] # => [3, 4, 2, 1] # 可以用三个参数的任何组合来构建切割 # li[始:终:步伐] -# 用del删除任何一个元素 -del li[2] # li is now [1, 2, 3] +# 简单的实现了单层数组的深度复制 +li2 = li[:] # => li2 = [1, 2, 4, 3] ，但 (li2 is li) 会返回 False + +# 用 del 删除任何一个元素 +del li[2] # li 现在为 [1, 2, 3] + +# 删除第一个匹配的元素 +li.remove(2) # li 现在为 [1, 3] +li.remove(2) # 抛出错误 ValueError: 2 is not in the list + +# 在指定索引处插入一个新的元素 +li.insert(1, 2) # li is now [1, 2, 3] again + +# 获得列表第一个匹配的值的索引 +li.index(2) # => 1 +li.index(4) # 抛出一个 ValueError: 4 is not in the list # 列表可以相加 -# 注意：li和other_li的值都不变 +# 注意：li 和 other_li 的值都不变 li + other_li # => [1, 2, 3, 4, 5, 6] -# 用extend拼接列表 -li.extend(other_li) # li现在是[1, 2, 3, 4, 5, 6] +# 用 "extend()" 拼接列表 +li.extend(other_li) # li 现在是[1, 2, 3, 4, 5, 6] -# 用in测试列表是否包含值 +# 用 "in" 测试列表是否包含值 1 in li # => True -# 用len取列表长度 +# 用 "len()" 取列表长度 len(li) # => 6 -# 元组是不可改变的序列 +# 元组类似列表，但是不允许修改 tup = (1, 2, 3) tup[0] # => 1 -tup[0] = 3 # 抛出TypeError +tup[0] = 3 # 抛出 TypeError + +# 如果元素数量为 1 的元组必须在元素之后加一个逗号 +# 其他元素数量的元组，包括空元组，都不需要 +type((1)) # => <class 'int'> +type((1,)) # => <class 'tuple'> +type(()) # => <class 'tuple'> -# 列表允许的操作元组大都可以 +# 列表允许的操作元组大多都可以 len(tup) # => 3 tup + (4, 5, 6) # => (1, 2, 3, 4, 5, 6) tup[:2] # => (1, 2) 2 in tup # => True # 可以把元组合列表解包，赋值给变量 -a, b, c = (1, 2, 3) # 现在a是1，b是2，c是3 +a, b, c = (1, 2, 3) # 现在 a 是 1，b 是 2，c 是 3 +# 也可以做扩展解包 +a, *b, c = (1, 2, 3, 4) # 现在 a 是 1, b 是 [2, 3]， c 是 4 # 元组周围的括号是可以省略的 -d, e, f = 4, 5, 6 +d, e, f = 4, 5, 6 # 元组 4, 5, 6 通过解包被赋值给变量 d, e, f # 交换两个变量的值就这么简单 -e, d = d, e # 现在d是5，e是4 +e, d = d, e # 现在 d 是 5，e 是 4 -# 用字典表达映射关系 +# 字典用来存储 key 到 value 的映射关系 empty_dict = {} # 初始化的字典 filled_dict = {"one": 1, "two": 2, "three": 3} +# 字典的 key 必须为不可变类型。 这是为了确保 key 被转换为唯一的哈希值以用于快速查询 +# 不可变类型包括整数、浮点、字符串、元组 +invalid_dict = {[1,2,3]: "123"} # => 抛出 TypeError: unhashable type: 'list' +valid_dict = {(1,2,3):[1,2,3]} # 然而 value 可以是任何类型 + # 用[]取值 filled_dict["one"] # => 1 - # 用 keys 获得所有的键。 -# 因为 keys 返回一个可迭代对象，所以在这里把结果包在 list 里。我们下面会详细介绍可迭代。 -# 注意：字典键的顺序是不定的，你得到的结果可能和以下不同。 -list(filled_dict.keys()) # => ["three", "two", "one"] +# 因为 keys 返回一个可迭代对象，所以我们需要把它包在 "list()" 里才能转换为列表。 +# 我们下面会详细介绍可迭代。 +# 注意: 对于版本 < 3.7 的 python, 字典的 key 的排序是无序的。你的运行结果 +# 可能与下面的例子不符，但是在 3.7 版本，字典中的项会按照他们被插入到字典的顺序进行排序 +list(filled_dict.keys()) # => ["three", "two", "one"] Python 版本 <3.7 +list(filled_dict.keys()) # => ["one", "two", "three"] Python 版本 3.7+ +# 用 "values()" 获得所有的值。跟 keys 一样也是可迭代对象，要使用 "list()" 才能转换为列表。 +# 注意: 排序顺序和 keys 的情况相同。 -# 用values获得所有的值。跟keys一样，要用list包起来，顺序也可能不同。 -list(filled_dict.values()) # => [3, 2, 1] +list(filled_dict.values()) # => [3, 2, 1] Python 版本 < 3.7 +list(filled_dict.values()) # => [1, 2, 3] Python 版本 3.7+ # 用in测试一个字典是否包含一个键 "one" in filled_dict # => True 1 in filled_dict # => False -# 访问不存在的键会导致KeyError +# 访问不存在的键会导致 KeyError filled_dict["four"] # KeyError -# 用get来避免KeyError -filled_dict.get("one") # => 1 -filled_dict.get("four") # => None -# 当键不存在的时候get方法可以返回默认值 +# 用 "get()" 来避免KeyError +filled_dict.get("one") # => 1 +filled_dict.get("four") # => None +# 当键不存在的时候 "get()" 方法可以返回默认值 filled_dict.get("one", 4) # => 1 -filled_dict.get("four", 4) # => 4 +filled_dict.get("four", 4) # => 4 -# setdefault方法只有当键不存在的时候插入新值 -filled_dict.setdefault("five", 5) # filled_dict["five"]设为5 -filled_dict.setdefault("five", 6) # filled_dict["five"]还是5 +# "setdefault()" 方法只有当键不存在的时候插入新值 +filled_dict.setdefault("five", 5) # filled_dict["five"] 设为5 +filled_dict.setdefault("five", 6) # filled_dict["five"] 还是5 # 字典赋值 filled_dict.update({"four":4}) # => {"one": 1, "two": 2, "three": 3, "four": 4} -filled_dict["four"] = 4 # 另一种赋值方法 +filled_dict["four"] = 4 # 另一种赋值方法 -# 用del删除 -del filled_dict["one"] # 从filled_dict中把one删除 +# 用 del 删除项 +del filled_dict["one"] # 从 filled_dict 中把 one 删除 -# 用set表达集合 +# 用 set 表达集合 empty_set = set() # 初始化一个集合，语法跟字典相似。 -some_set = {1, 1, 2, 2, 3, 4} # some_set现在是{1, 2, 3, 4} +some_set = {1, 1, 2, 2, 3, 4} # some_set现在是 {1, 2, 3, 4} + +# 类似字典的 keys，set 的元素也必须是不可变类型 +invalid_set = {[1], 1} # => Raises a TypeError: unhashable type: 'list' +valid_set = {(1,), 1} # 可以把集合赋值于变量 filled_set = some_set # 为集合添加元素 -filled_set.add(5) # filled_set现在是{1, 2, 3, 4, 5} +filled_set.add(5) # filled_set 现在是 {1, 2, 3, 4, 5} +# set 没有重复的元素 +filled_set.add(5) # filled_set 依然是 {1, 2, 3, 4, 5} -# & 取交集 +# "&" 取交集 other_set = {3, 4, 5, 6} filled_set & other_set # => {3, 4, 5} -# | 取并集 +# "|" 取并集 filled_set | other_set # => {1, 2, 3, 4, 5, 6} -# - 取补集 +# "-" 取补集 {1, 2, 3, 4} - {2, 3, 5} # => {1, 4} +# "^" 取异或集（对称差） +{1, 2, 3, 4} ^ {2, 3, 5} # => {1, 4, 5} + +# 判断左边的集合是否是右边集合的超集 +{1, 2} >= {1, 2, 3} # => False + +# 判断左边的集合是否是右边集合的子集 +{1, 2} <= {1, 2, 3} # => True + # in 测试集合是否包含元素 2 in filled_set # => True 10 in filled_set # => False +# 单层集合的深度复制 +filled_set = some_set.copy() # filled_set 是 {1, 2, 3, 4, 5} +filled_set is some_set # => False #################################################### ## 3. 流程控制和迭代器 @@ -304,28 +403,30 @@ filled_set | other_set # => {1, 2, 3, 4, 5, 6} # 先随便定义一个变量 some_var = 5 -# 这是个if语句。注意缩进在Python里是有意义的 -# 印出"some_var比10小" +# 这是个if语句。注意缩进在Python里是有意义的！ +# 缩进要使用 4 个空格而不是 tabs。 +# 这段代码会打印 "some_var is smaller than 10" if some_var > 10: - print("some_var比10大") -elif some_var < 10: # elif句是可选的 - print("some_var比10小") -else: # else也是可选的 - print("some_var就是10") + print("some_var is totally bigger than 10.") +elif some_var < 10: # elif 语句是可选的 + print("some_var is smaller than 10.") +else: # else 也是可选的 + print("some_var is indeed 10.") """ -用for循环语句遍历列表 +用 for 循环语句遍历列表 打印: dog is a mammal cat is a mammal mouse is a mammal """ for animal in ["dog", "cat", "mouse"]: + # 你可以使用 format() 格式化字符串并插入值 print("{} is a mammal".format(animal)) """ -"range(number)"返回数字列表从0到给的数字 +"range(number)" 返回数字列表从 0 到 number 的数字 打印: 0 1 @@ -334,9 +435,41 @@ for animal in ["dog", "cat", "mouse"]: """ for i in range(4): print(i) + +""" +"range(lower, upper)" 会返回一个包含从 lower 到 upper 的数字迭代器 +prints: + 4 + 5 + 6 + 7 +""" +for i in range(4, 8): + print(i) """ -while循环直到条件不满足 +"range(lower, upper, step)" 会返回一个，从 lower 到 upper、并且间隔值为 step 的迭代器。 +如果 step 未传入则会使用默认值 1 +prints: + 4 + 6 +""" +for i in range(4, 8, 2): + print(i) + +""" +遍历列表，并且同时返回列表里的每一个元素的索引和数值。 +prints: + 0 dog + 1 cat + 2 mouse +""" +animals = ["dog", "cat", "mouse"] +for i, value in enumerate(animals): + print(i, value) + +""" +while 循环直到条件不满足 打印: 0 1 @@ -348,20 +481,51 @@ while x < 4: print(x) x += 1 # x = x + 1 的简写 -# 用try/except块处理异常状况 + +# 用 try/except 块处理异常状况 try: - # 用raise抛出异常 + # 用 raise 抛出异常 raise IndexError("This is an index error") except IndexError as e: - pass # pass是无操作，但是应该在这里处理错误 + pass # pass 是无操作，但是应该在这里处理错误 except (TypeError, NameError): - pass # 可以同时处理不同类的错误 -else: # else语句是可选的，必须在所有的except之后 + pass # 可以同时处理不同类的错误 +else: # else语句是可选的，必须在所有的except之后 print("All good!") # 只有当try运行完没有错误的时候这句才会运行 +finally: # 在任何情况下都会执行 + print("We can clean up resources here") + +# 你可以使用 with 语句来代替 try/finally 对操作进行结束的操作 +with open("myfile.txt") as f: + for line in f: + print(line) + +# 写入文件 +contents = {"aa": 12, "bb": 21} +with open("myfile1.txt", "w+") as file: + file.write(str(contents)) # 写入字符串到文件 + +with open("myfile2.txt", "w+") as file: + file.write(json.dumps(contents)) # 写入对象到文件 + +# Reading from a file +with open("myfile1.txt", "r+") as file: + contents = file.read() # 从文件读取字符串 +print(contents) +# print: {"aa": 12, "bb": 21} + +with open("myfile2.txt", "r+") as file: + contents = json.load(file) # 从文件读取 json 对象 +print(contents) +# print: {"aa": 12, "bb": 21} + +# Windows 环境调用 open() 读取文件的默认编码为 ANSI，如果需要读取 utf-8 编码的文件， +# 需要指定 encoding 参数: +# open("myfile3.txt", "r+", encoding = "utf-8") -# Python提供一个叫做可迭代(iterable)的基本抽象。一个可迭代对象是可以被当作序列 -# 的对象。比如说上面range返回的对象就是可迭代的。 +# Python 提供一个叫做可迭代 (iterable) 的基本抽象。一个可迭代对象是可以被当作序列 +# 的对象。比如说上面 range 返回的对象就是可迭代的。 filled_dict = {"one": 1, "two": 2, "three": 3} our_iterable = filled_dict.keys() @@ -378,19 +542,24 @@ our_iterable[1] # 抛出TypeError our_iterator = iter(our_iterable) # 迭代器是一个可以记住遍历的位置的对象 -# 用__next__可以取得下一个元素 -our_iterator.__next__() # => "one" +# 用 "next()" 获得下一个对象 +next(our_iterator) # => "one" -# 再一次调取__next__时会记得位置 -our_iterator.__next__() # => "two" -our_iterator.__next__() # => "three" +# 再一次调取 "next()" 时会记得位置 +next(our_iterator) # => "two" +next(our_iterator) # => "three" -# 当迭代器所有元素都取出后，会抛出StopIteration -our_iterator.__next__() # 抛出StopIteration +# 当迭代器所有元素都取出后，会抛出 StopIteration +next(our_iterator) # 抛出 StopIteration -# 可以用list一次取出迭代器所有的元素 -list(filled_dict.keys()) # => Returns ["one", "two", "three"] +# 我们可以通过遍历还访问所有的值，实际上，for 内部实现了迭代 +our_iterator = iter(our_iterable) +for i in our_iterator: + print(i) # 依次打印 one, two, three +# 可以用 list 一次取出迭代器或者可迭代对象所有的元素 +list(filled_dict.keys()) # => 返回 ["one", "two", "three"] +list(our_iterator) # => 返回 [] 因为迭代的位置被保存了 #################################################### @@ -400,10 +569,10 @@ list(filled_dict.keys()) # => Returns ["one", "two", "three"] # 用def定义新函数 def add(x, y): print("x is {} and y is {}".format(x, y)) - return x + y # 用return语句返回 + return x + y # 用 return 语句返回 # 调用函数 -add(5, 6) # => 印出"x is 5 and y is 6"并且返回11 +add(5, 6) # => 打印 "x is 5 and y is 6" 并且返回 11 # 也可以用关键字参数来调用函数 add(y=6, x=5) # 关键字参数可以用任何顺序 @@ -434,33 +603,43 @@ all_the_args(1, 2, a=3, b=4) prints: {"a": 3, "b": 4} """ -# 调用可变参数函数时可以做跟上面相反的，用*展开序列，用**展开字典。 +# 调用可变参数函数时可以做跟上面相反的，用 * 展开元组，用 ** 展开字典。 args = (1, 2, 3, 4) kwargs = {"a": 3, "b": 4} all_the_args(*args) # 相当于 all_the_args(1, 2, 3, 4) all_the_args(**kwargs) # 相当于 all_the_args(a=3, b=4) all_the_args(*args, **kwargs) # 相当于 all_the_args(1, 2, 3, 4, a=3, b=4) +# 使用返回多个数值（返回值为元组类型） +def swap(x, y): + return y, x # 用不带括号的元组的格式来返回多个数值 + # (注意: 括号不需要加，但是也可以加) + +x = 1 +y = 2 +x, y = swap(x, y) # => x = 2, y = 1 +# (x, y) = swap(x,y) # 同上，括号不需要加，但是也可以加 + # 函数作用域 x = 5 def setX(num): - # 局部作用域的x和全局域的x是不同的 + # 局部作用域的 x 和全局域的 x 是不同的 x = num # => 43 print (x) # => 43 def setGlobalX(num): global x print (x) # => 5 - x = num # 现在全局域的x被赋值 + x = num # 现在全局域的 x 被赋值 print (x) # => 6 setX(43) setGlobalX(6) -# 函数在Python是一等公民 +# 函数在 Python 是一等公民 def create_adder(x): def adder(y): return x + y @@ -470,39 +649,90 @@ add_10 = create_adder(10) add_10(3) # => 13 # 也有匿名函数 -(lambda x: x > 2)(3) # => True +(lambda x: x > 2)(3) # => True +(lambda x, y: x ** 2 + y ** 2)(2, 1) # => 5 # 内置的高阶函数 -map(add_10, [1, 2, 3]) # => [11, 12, 13] -filter(lambda x: x > 5, [3, 4, 5, 6, 7]) # => [6, 7] +list(map(add_10, [1, 2, 3])) # => [11, 12, 13] +list(map(max, [1, 2, 3], [4, 2, 1])) # => [4, 2, 3] + +list(filter(lambda x: x > 5, [3, 4, 5, 6, 7])) # => [6, 7] # 用列表推导式可以简化映射和过滤。列表推导式的返回值是另一个列表。 [add_10(i) for i in [1, 2, 3]] # => [11, 12, 13] [x for x in [3, 4, 5, 6, 7] if x > 5] # => [6, 7] +# 你也可以用这种方式实现对集合和字典的构建 +{x for x in 'abcddeef' if x not in 'abc'} # => {'d', 'e', 'f'} +{x: x**2 for x in range(5)} # => {0: 0, 1: 1, 2: 4, 3: 9, 4: 16} + + #################################################### -## 5. 类 +## 5. 模块 #################################################### +# 导入模块 +import math +print(math.sqrt(16)) # => 4.0 + +# 你可以导入模块中具体的函数 +from math import ceil, floor +print(ceil(3.7)) # => 4.0 +print(floor(3.7)) # => 3.0 + +# 你可以导入模块中的所有的函数 +# 警告: 此操作不推荐 +from math import * + +# 你可以对模块名进行简化 +import math as m +math.sqrt(16) == m.sqrt(16) # => True + +# Python 模块实质上是 Python 文件 +# 你可以自己编写自己的模块，然后导入 +# 模块的名称和文件名相同 + +# 你可以用 "dir()" 查看模块中定义的函数和字段 +import math +dir(math) + +# 当你的脚本文件所在的文件夹也包含了一个名为 math.py 的 Python 文件 +# 这个 math.p 文件会被代替引入，而不是引入 Python 內建模块中的 math +# 出现这个情况的原因是本地文件夹的引入优先级要比 Python 內建库引入优先级要高 + + +#################################################### +## 6. 类 +#################################################### -# 定义一个继承object的类 -class Human(object): +# 我们使用 "class" 语句来创建类 +class Human: - # 类属性，被所有此类的实例共用。 + # 一个类的字段。 这个字段共享给这个类的所有实例。 species = "H. sapiens" - # 构造方法，当实例被初始化时被调用。注意名字前后的双下划线，这是表明这个属 - # 性或方法对Python有特殊意义，但是允许用户自行定义。你自己取名时不应该用这 - # 种格式。 + # 构造方法，当实例被初始化时被调用。注意名字前后的双下划线，这是表明这个属性 + # 或方法对 Python 有特殊意义，但是允许用户自行定义。 + # 方法(可能是对象或者属性) 类似: __init__, __str__,__repr__ etc + # 都是特殊的方法 + # 你自己取名时不应该用这种格式 def __init__(self, name): - # Assign the argument to the instance's name attribute + # 将参数赋值给实例的 name 字段 self.name = name - # 实例方法，第一个参数总是self，就是这个实例对象 + # 初始化属性 + self._age = 0 + + # 实例方法，第一个参数总是self，也就是这个实例对象 def say(self, msg): - return "{name}: {message}".format(name=self.name, message=msg) + print("{name}: {message}".format(name=self.name, message=msg)) + + # 另一个实例方法 + def sing(self): + return 'yo... yo... microphone check... one two... one two...' - # 类方法，被所有此类的实例共用。第一个参数是这个类对象。 + # 类方法，被所有此类的实例共用。 + # 第一个参数是这个类对象。 @classmethod def get_species(cls): return cls.species @@ -512,53 +742,225 @@ class Human(object): def grunt(): return "*grunt*" + # property 有点类似 getter + # 它把方法 age() 转换为同名并且只读的属性 + # 通常情况下，可以不需要编写复杂的 getter 和 setter。 + @property + def age(self): + return self._age + + # 允许属性被修改 + @age.setter + def age(self, age): + self._age = age + + # 允许属性被删除 + @age.deleter + def age(self): + del self._age + +# 当 Python 解释器在读取源文件的时候，就会执行文件中所有的代码 +# 对 __name__ 的检查可以保证这块代码只会在执行这个模块是住程序情况下被运行（而不是在引用时运行） +if __name__ == '__main__': + # + i = Human(name="Ian") + i.say("hi") # "Ian: hi" + j = Human("Joel") + j.say("hello") # "Joel: hello" + # i 和 j 都是 Human 实例化后的对象，换一句话说，它们都是 Human 实例 + + # 运行类方法 (classmethod) + i.say(i.get_species()) # "Ian: H. sapiens" + # 修改共享的类属性 + Human.species = "H. neanderthalensis" + i.say(i.get_species()) # => "Ian: H. neanderthalensis" + j.say(j.get_species()) # => "Joel: H. neanderthalensis" + + # 运行静态方法 (staticmethod) + print(Human.grunt()) # => "*grunt*" + + # 实例上也可以执行静态方法 + print(i.grunt()) # => "*grunt*" + + # 更新实例的属性 + i.age = 42 + # 访问实例的属性 + i.say(i.age) # => "Ian: 42" + j.say(j.age) # => "Joel: 0" + # 删除实例的属性 + del i.age + # i.age # => 这会抛出一个错误: AttributeError + + +#################################################### +## 6.1 类的继承 +#################################################### + +# 继承机制允许子类可以继承父类上的方法和变量。 +# 我们可以把 Human 类作为一个基础类或者说叫做父类， +# 然后定义一个名为 Superhero 的子类来继承父类上的比如 "species"、 "name"、 "age" 的属性 +# 和比如 "sing" 、"grunt" 这样的方法，同时，也可以定义它自己独有的属性 + +# 基于 Python 文件模块化的特点，你可以把这个类放在独立的文件中，比如说，human.py。 + +# 要从别的文件导入函数，需要使用以下的语句 +# from "filename-without-extension" import "function-or-class" + +from human import Human + +# 指定父类作为类初始化的参数 +class Superhero(Human): + + # 如果子类需要继承所有父类的定义，并且不需要做任何的修改， + # 你可以直接使用 "pass" 关键字（并且不需要其他任何语句） + # 但是在这个例子中会被注释掉，以用来生成不一样的子类。 + # pass + + # 子类可以重写父类定义的字段 + species = 'Superhuman' + + # 子类会自动的继承父类的构造函数包括它的参数，但同时，子类也可以新增额外的参数或者定义， + # 甚至去覆盖父类的方法比如说构造函数。 + # 这个构造函数从父类 "Human" 上继承了 "name" 参数，同时又新增了 "superpower" 和 + # "movie" 参数: + def __init__(self, name, movie=False, + superpowers=["super strength", "bulletproofing"]): + + # 新增额外类的参数 + self.fictional = True + self.movie = movie + # 注意可变的默认值，因为默认值是共享的 + self.superpowers = superpowers + + # "super" 函数让你可以访问父类中被子类重写的方法 + # 在这个例子中，被重写的是 __init__ 方法 + # 这个语句是用来运行父类的构造函数: + super().__init__(name) + + # 重写父类中的 sing 方法 + def sing(self): + return 'Dun, dun, DUN!' + + # 新增一个额外的方法 + def boast(self): + for power in self.superpowers: + print("I wield the power of {pow}!".format(pow=power)) + + +if __name__ == '__main__': + sup = Superhero(name="Tick") + + # 检查实例类型 + if isinstance(sup, Human): + print('I am human') + if type(sup) is Superhero: + print('I am a superhero') -# 构造一个实例 -i = Human(name="Ian") -print(i.say("hi")) # 印出 "Ian: hi" + # 获取方法解析顺序 MRO，MRO 被用于 getattr() 和 super() + # 这个字段是动态的，并且可以被修改 + print(Superhero.__mro__) # => (<class '__main__.Superhero'>, + # => <class 'human.Human'>, <class 'object'>) -j = Human("Joel") -print(j.say("hello")) # 印出 "Joel: hello" + # 调用父类的方法并且使用子类的属性 + print(sup.get_species()) # => Superhuman -# 调用一个类方法 -i.get_species() # => "H. sapiens" + # 调用被重写的方法 + print(sup.sing()) # => Dun, dun, DUN! -# 改一个共用的类属性 -Human.species = "H. neanderthalensis" -i.get_species() # => "H. neanderthalensis" -j.get_species() # => "H. neanderthalensis" + # 调用 Human 的方法 + sup.say('Spoon') # => Tick: Spoon -# 调用静态方法 -Human.grunt() # => "*grunt*" + # 调用 Superhero 独有的方法 + sup.boast() # => I wield the power of super strength! + # => I wield the power of bulletproofing! + + # 继承类的字段 + sup.age = 31 + print(sup.age) # => 31 + + # Superhero 独有的字段 + print('Am I Oscar eligible? ' + str(sup.movie)) #################################################### -## 6. 模块 +## 6.2 多重继承 #################################################### -# 用import导入模块 -import math -print(math.sqrt(16)) # => 4.0 +# 定义另一个类 +# bat.py +class Bat: -# 也可以从模块中导入个别值 -from math import ceil, floor -print(ceil(3.7)) # => 4.0 -print(floor(3.7)) # => 3.0 + species = 'Baty' -# 可以导入一个模块中所有值 -# 警告：不建议这么做 -from math import * + def __init__(self, can_fly=True): + self.fly = can_fly -# 如此缩写模块名字 -import math as m -math.sqrt(16) == m.sqrt(16) # => True + # 这个类同样有 say 的方法 + def say(self, msg): + msg = '... ... ...' + return msg -# Python模块其实就是普通的Python文件。你可以自己写，然后导入， -# 模块的名字就是文件的名字。 + # 新增一个独有的方法 + def sonar(self): + return '))) ... (((' -# 你可以这样列出一个模块里所有的值 -import math -dir(math) +if __name__ == '__main__': + b = Bat() + print(b.say('hello')) + print(b.fly) + +# 现在我们来定义一个类来同时继承 Superhero 和 Bat +# superhero.py +from superhero import Superhero +from bat import Bat + +# 定义 Batman 作为子类，来同时继承 SuperHero 和 Bat +class Batman(Superhero, Bat): + + def __init__(self, *args, **kwargs): + # 通常要继承属性，你必须调用 super: + # super(Batman, self).__init__(*args, **kwargs) + # 然而在这里我们处理的是多重继承，而 super() 只会返回 MRO 列表的下一个基础类。 + # 因此，我们需要显式调用初始类的 __init__ + # *args 和 **kwargs 传递参数时更加清晰整洁，而对于父类而言像是 “剥了一层洋葱” + Superhero.__init__(self, 'anonymous', movie=True, + superpowers=['Wealthy'], *args, **kwargs) + Bat.__init__(self, *args, can_fly=False, **kwargs) + # 重写了 name 字段 + self.name = 'Sad Affleck' + + def sing(self): + return 'nan nan nan nan nan batman!' + + +if __name__ == '__main__': + sup = Batman() + + # 获取方法解析顺序 MRO，MRO 被用于 getattr() 和 super() + # 这个字段是动态的，并且可以被修改 + print(Batman.__mro__) # => (<class '__main__.Batman'>, + # => <class 'superhero.Superhero'>, + # => <class 'human.Human'>, + # => <class 'bat.Bat'>, <class 'object'>) + + # 调用父类的方法并且使用子类的属性 + print(sup.get_species()) # => Superhuman + + # 调用被重写的类 + print(sup.sing()) # => nan nan nan nan nan batman! + + # 调用 Human 上的方法，(之所以是 Human 而不是 Bat)，是因为继承顺序起了作用 + sup.say('I agree') # => Sad Affleck: I agree + + # 调用仅存在于第二个继承的父类的方法 + print(sup.sonar()) # => ))) ... ((( + + # 继承类的属性 + sup.age = 100 + print(sup.age) # => 100 + + # 从第二个类上继承字段，并且其默认值被重写 + print('Can I fly? ' + str(sup.fly)) # => Can I fly? False #################################################### @@ -583,6 +985,10 @@ for i in double_numbers(range_): print(i) if i >= 30: break +# 你也可以把一个生成器推导直接转换为列表 +values = (-x for x in [1,2,3,4,5]) +gen_to_list = list(values) +print(gen_to_list) # => [-1, -2, -3, -4, -5] # 装饰器(decorators) @@ -612,18 +1018,27 @@ print(say()) # Can you buy me a beer? print(say(say_please=True)) # Can you buy me a beer? Please! I am poor :( ``` -## 想继续学吗？ -### 线上免费材料（英文） -* [Learn Python The Hard Way](http://learnpythonthehardway.org/book/) -* [Dive Into Python](http://www.diveintopython.net/) -* [Ideas for Python Projects](http://pythonpracticeprojects.com) +## 想继续学吗？ -* [The Official Docs](http://docs.python.org/3/) -* [Hitchhiker's Guide to Python](http://docs.python-guide.org/en/latest/) -* [Python Module of the Week](http://pymotw.com/3/) -* [A Crash Course in Python for Scientists](http://nbviewer.ipython.org/5920182) +### 在线免费材料（英文） + +* [Automate the Boring Stuff with Python](https://automatetheboringstuff.com/) +* [Ideas for Python Projects](http://pythonpracticeprojects.com/) +* [The Official Docs](https://docs.python.org/3/) +* [Hitchhiker’s Guide to Python](https://docs.python-guide.org/en/latest/) +* [Python Course](https://www.python-course.eu/) +* [Free Interactive Python Course](http://www.kikodo.io/) +* [First Steps With Python](https://realpython.com/learn/python-first-steps/) +* [A curated list of awesome Python frameworks, libraries and software](https://github.com/vinta/awesome-python) +* [30 Python Language Features and Tricks You May Not Know About](https://sahandsaba.com/thirty-python-language-features-and-tricks-you-may-not-know.html) +* [Official Style Guide for Python](https://www.python.org/dev/peps/pep-0008/) +* [Python 3 Computer Science Circles](https://cscircles.cemc.uwaterloo.ca/) +* [Dive Into Python 3](https://www.diveintopython3.net/index.html) +* [A Crash Course in Python for Scientists](https://nbviewer.jupyter.org/gist/anonymous/5924718) +* [Python Tutorial for Intermediates](https://pythonbasics.org/) +* [Build a Desktop App with Python](https://pythonpyqt.com/) ### 书籍（也是英文） diff --git a/zh-cn/raylib-cn.html.markdown b/zh-cn/raylib-cn.html.markdown new file mode 100644 index 00000000..c88aa91e --- /dev/null +++ b/zh-cn/raylib-cn.html.markdown @@ -0,0 +1,147 @@ +--- +category: tool +tool: raylib +lang: zh-cn +filename: learnraylib-cn.c +contributors: + - ["Nikolas Wipper", "https://notnik.cc"] +translators: + - ["lzw-723", "https://github.com/lzw-723"] +--- + +**raylib** 是一个跨平台、易用的图形库，围绕OpenGL 1.1、2.1、3.3和OpenGL ES 2.0构建。 +虽然它是用C语言编写的，却有超过50种不同语言的绑定。本教程将使用C语言。 +更确切地说，是C99。 + +```c +#include <raylib.h> + +int main(void) +{ + const int screenWidth = 800; + const int screenHeight = 450; + + // 在初始化raylib之前，可以设置标志位 + SetConfigFlags(FLAG_MSAA_4X_HINT | FLAG_VSYNC_HINT); + + // raylib并不要求我们存储任何实例结构 + // 目前raylib一次只能处理一个窗口 + InitWindow(screenWidth, screenHeight, "MyWindow"); + + // 设置我们的游戏以每秒60帧的速度运行 + SetTargetFPS(60); + + // 设置一个关闭窗口的键。 + //可以是0，表示没有键 + SetExitKey(KEY_DELETE); + + // raylib定义了两种类型的相机。Camera3D和Camera2D + // Camera是Camera3D的一个类型化定义 + Camera camera = { + .position = {0.0f, 0.0f, 0.0f}, + .target = {0.0f, 0.0f, 1.0f}, + .up = {0.0f, 1.0f, 0.0f}, + .fovy = 70.0f, + .type = CAMERA_PERSPECTIVE + }; + + + // raylib支持加载各种不同的文件格式的模型、动画、图像和声音。 + Model myModel = LoadModel("my_model.obj"); + Font someFont = LoadFont("some_font.ttf"); + + // 创建一个100x100的渲染纹理 + RenderTexture renderTexture = LoadRenderTexture(100, 100); + + // WindowShouldClose方法检查用户是否正在关闭窗口。 + // 可能用的是快捷方式、窗口控制或之前设置的关闭窗口键 + while (!WindowShouldClose()) + { + + // BeginDrawing方法要在任何绘图操作之前被调用。 + BeginDrawing(); + { + + // 为背景设定某种颜色 + ClearBackground(BLACK); + + if (IsKeyDown(KEY_SPACE)) + DrawCircle(400, 400, 30, GREEN); + + // 简单地绘制文本 + DrawText("Congrats! You created your first window!", + 190, // x + 200, // y + 20, // 字体大小 + LIGHTGRAY + ); + + // 大多数函数都有几个版本 + // 通常后缀为Ex, Pro, V + // 或者是Rec、Wires（仅适用于3D）、Lines（仅适用于2D）。 + DrawTextEx(someFont, + "Text in another font", + (Vector2) {10, 10}, + 20, // 字体大小 + 2, // 间距 + LIGHTGRAY); + + // 绘制3D时需要，有2D的等价方法 + BeginMode3D(camera); + { + + DrawCube((Vector3) {0.0f, 0.0f, 3.0f}, + 1.0f, 1.0f, 1.0f, RED); + + // 绘图时的白色色调将保持原来的颜色 + DrawModel(myModel, (Vector3) {0.0f, 0.0f, 3.0f}, + 1.0f, // 缩放 + WHITE); + + } + // 结束3D模式，这样就可以再次普通绘图 + EndMode3D(); + + // 开始在渲染纹理上绘图 + BeginTextureMode(renderTexture); + { + + // 它的行为与刚才调用的`BeginDrawing()`方法相同 + + ClearBackground(RAYWHITE); + + BeginMode3D(camera); + { + + DrawGrid(10, // Slices + 1.0f // 间距 + ); + + } + EndMode3D(); + + } + EndTextureMode(); + + // 渲染有Texture2D字段的纹理 + DrawTexture(renderTexture.texture, 40, 378, BLUE); + + } + EndDrawing(); + } + + // 卸载已载入的对象 + UnloadFont(someFont); + UnloadModel(myModel); + + // 关闭窗口和OpenGL上下文 + CloseWindow(); + + return 0; +} + +``` + +## 延伸阅读 +raylib有一些[不错的例子](https://www.raylib.com/examples.html) +如果你不喜欢C语言你也可以看看[raylib的其他语言绑定](https://github.com/raysan5/raylib/blob/master/BINDINGS.md) diff --git a/zh-cn/rust-cn.html.markdown b/zh-cn/rust-cn.html.markdown index b77c9c38..6bed1650 100644 --- a/zh-cn/rust-cn.html.markdown +++ b/zh-cn/rust-cn.html.markdown @@ -1,5 +1,5 @@ --- -language: rust +language: Rust contributors: - ["P1start", "http://p1start.github.io/"] translators: diff --git a/zh-cn/sql.html.markdown b/zh-cn/sql-cn.html.markdown index 9d430bd1..9d430bd1 100644 --- a/zh-cn/sql.html.markdown +++ b/zh-cn/sql-cn.html.markdown |