Skip to content

Commit 74123a2

Browse files
committed
doc: 添加io file os 错误异常文档
1 parent ca76352 commit 74123a2

7 files changed

Lines changed: 231 additions & 1 deletion

File tree

README.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,8 +41,12 @@
4141
- [集合](./set.md)
4242
- [日期和时间](./date-time.md)
4343
- [函数](./function.md)
44-
- [推导式](./comprehensions.md) ⚠️
44+
- [推导式](./comprehensions.md)
4545
- [模块](./modules.md)
46+
- [I/O](./io.md)
47+
- [File](./file.md)
48+
- [OS](./os.md)
49+
- [错误与异常](./execptions.md)
4650

4751
## Reference
4852

example/day07/excp.py

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
#!/usr/bin/env python3
2+
# -*- coding=utf-8 -*-
3+
4+
while True:
5+
try:
6+
x = int(input("请输入一个数字(为了看到异常请输入非数字): "))
7+
break
8+
except ValueError:
9+
print("Oops! 😰 出错了吧,再来一次 ")
10+
11+
print("----------------")
12+
13+
if True:
14+
try:
15+
raise NameError('使用raise抛出了一个异常,并指定异常类型')
16+
except NameError:
17+
print('捕获到异常,但是不处理,使用raise 直接向外抛出!')
18+
raise

example/day07/io.py

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
#!/usr/bin/env python3
2+
# -*- coding=utf-8 -*-
3+
4+
# str = raw_input("请输入:") # Python3 进行了整合,只存在 input 方法
5+
str = input("请输入:")
6+
print("str: ", str)

execptions.md

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
# 错误与异常
2+
3+
> 示例:example/day07
4+
5+
## 异常处理
6+
7+
基本语法:
8+
9+
```py
10+
try :
11+
...
12+
except ErrName :
13+
...
14+
except ErrName :
15+
...
16+
except ErrName :
17+
...
18+
else :
19+
...
20+
finally :
21+
...
22+
23+
# 或者是
24+
25+
try :
26+
...
27+
except (ErrName, ErrName, ErrName) :
28+
...
29+
else :
30+
...
31+
finally :
32+
...
33+
```
34+
35+
示例:
36+
37+
```py
38+
#!/usr/bin/env python3
39+
# -*- coding=utf-8 -*-
40+
41+
while True:
42+
try:
43+
x = int(input("请输入一个数字(为了看到异常请输入非数字): "))
44+
break
45+
except ValueError:
46+
print("Oops! 😰 出错了吧,再来一次 ")
47+
```
48+
49+
## 抛出异常
50+
51+
> 使用 `raise` 语句抛出一个指定的异常
52+
53+
```py
54+
if True:
55+
try:
56+
raise NameError('使用raise抛出了一个异常,并指定异常类型')
57+
except NameError:
58+
print('捕获到异常,但是不处理,使用raise 直接向外抛出!')
59+
raise
60+
61+
# 输出结果
62+
63+
捕获到异常,但是不处理,使用raise 直接向外抛出!
64+
Traceback (most recent call last):
65+
File "example/day07/excp.py", line 15, in <module>
66+
raise NameError('使用raise抛出了一个异常,并指定异常类型')
67+
NameError: 使用raise抛出了一个异常,并指定异常类型
68+
```
69+
70+
## 自定义异常
71+
72+
>
73+
74+
稍后补充
75+
76+
## 参考
77+
78+
- [菜鸟 - 错误与异常](http://www.runoob.com/python3/python3-errors-execptions.html)

file.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# 文件 File
2+
3+
## file 对象方法
4+
5+
file 对象使用 open 函数来创建,下表列出了 file 对象常用的函数:
6+
7+
| 方法 | 描述 |
8+
| - | - |
9+
| file.close() | 关闭文件。关闭后文件不能再进行读写操作 |
10+
| file.flush() | 刷新文件内部缓冲,直接把内部缓冲区的数据立刻写入文件, 而不是被动的等待输出缓冲区写入 |
11+
| file.fileno() | 返回一个整型的文件描述符(file descriptor FD 整型), 可以用在如os模块的read方法等一些底层操作上 |
12+
| file.isatty() | 如果文件连接到一个终端设备返回 True,否则返回 False |
13+
| file.next() | 返回文件下一行 |
14+
| file.read([size]) | 从文件读取指定的字节数,如果未给定或为负则读取所有 |
15+
| file.readline([size]) | 读取整行,包括 "\n" 字符 |
16+
| file.readlines([sizehint]) | 读取所有行并返回列表,若给定sizeint>0,则是设置一次读多少字节,这是为了减轻读取压力 |
17+
| file.seek(offset[, whence]) | 设置文件当前位 |
18+
| file.tell() | 返回文件当前位置 |
19+
| file.truncate([size]) | 截取文件,截取的字节通过size指定,默认为当前文件位置 |
20+
| file.write(str) | 将字符串写入文件,返回的是写入的字符长度 |
21+
| file.writelines(sequence) | 向文件写入一个序列字符串列表,如果需要换行则要自己加入每行的换行符
22+

io.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# 输入与输出
2+
3+
> 示例:example/day07
4+
5+
## 读取键盘输入
6+
7+
Python提供了两个内置函数从标准输入读入一行文本,默认的标准输入是键盘
8+
9+
- `raw_input` : 从标准输入读取一个行,并返回一个字符串(去掉结尾的换行符)
10+
- `input` : 可以接收一个Python表达式作为输入,并将运算结果返回
11+
12+
> 注意 ⚠️ `python3``raw_input``input` 进行了整合,**只有 `input`**
13+
14+
```py
15+
# str = raw_input("请输入:")
16+
str = input("请输入:")
17+
print("str: ", str)
18+
```
19+
20+
## 读写文件
21+
22+
>
23+
24+
详细内容查看参考文档
25+
26+
## 参考
27+
28+
- [菜鸟 - I/O](http://www.runoob.com/python/python-files-io.html)
29+
- [菜鸟 - Python3 I/O](http://www.runoob.com/python3/python3-inputoutput.html)

os.md

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
# OS
2+
3+
> `os` 模块提供了非常丰富的方法用来处理 `文件``目录`
4+
5+
| 方法 | 描述 |
6+
| - | - |
7+
| os.access(path, mode) | 检验权限模式 |
8+
| os.chdir(path) | 改变当前工作目录 |
9+
| os.chflags(path, flags) | 设置路径的标记为数字标记。 |
10+
| os.chmod(path, mode) | 更改权限 |
11+
| os.chown(path, uid, gid) | 更改文件所有者 |
12+
| os.chroot(path) | 改变当前进程的根目录 |
13+
| os.close(fd) | 关闭文件描述符 fd |
14+
| os.closerange(fd_low, fd_high) | 关闭所有文件描述符,从 fd_low (包含) 到 fd_high (不包含), 错误会忽略 |
15+
| os.dup(fd) | 复制文件描述符 fd |
16+
| os.dup2(fd, fd2) | 将一个文件描述符 fd 复制到另一个 fd2 |
17+
| os.fchdir(fd) | 通过文件描述符改变当前工作目录 |
18+
| os.fchmod(fd, mode) | 改变一个文件的访问权限,该文件由参数fd指定,参数mode是Unix下的文件访问权限。 |
19+
| os.fchown(fd, uid, gid) | 修改一个文件的所有权,这个函数修改一个文件的用户ID和用户组ID,该文件由文件描述符fd指定。 |
20+
| os.fdatasync(fd) | 强制将文件写入磁盘,该文件由文件描述符fd指定,但是不强制更新文件的状态信息。 |
21+
| os.fdopen(fd[, mode[, bufsize]]) | 通过文件描述符 fd 创建一个文件对象,并返回这个文件对象 |
22+
| os.fpathconf(fd, name) | 返回一个打开的文件的系统配置信息。name为检索的系统配置的值,它也许是一个定义系统值的字符串,这些名字在很多标准中指定(POSIX.1, Unix 95, Unix 98, 和其它)。 |
23+
| os.fstat(fd) | 返回文件描述符fd的状态,像stat()。 |
24+
| os.fstatvfs(fd) | 返回包含文件描述符fd的文件的文件系统的信息,像 statvfs() |
25+
| os.fsync(fd) | 强制将文件描述符为fd的文件写入硬盘。 |
26+
| os.ftruncate(fd, length) | 裁剪文件描述符fd对应的文件, 所以它最大不能超过文件大小。 |
27+
| os.getcwd() | 返回当前工作目录 |
28+
| os.getcwdu() | 返回一个当前工作目录的Unicode对象 |
29+
| os.isatty(fd) | 如果文件描述符fd是打开的,同时与tty(-like)设备相连,则返回true, 否则False。 |
30+
| os.lchflags(path, flags) | 设置路径的标记为数字标记,类似 chflags(),但是没有软链接 |
31+
| os.lchmod(path, mode) | 修改连接文件权限 |
32+
| os.lchown(path, uid, gid) | 更改文件所有者,类似 chown,但是不追踪链接。 |
33+
| os.link(src, dst) | 创建硬链接,名为参数 dst,指向参数 src |
34+
| os.listdir(path) | 返回path指定的文件夹包含的文件或文件夹的名字的列表。 |
35+
| os.lseek(fd, pos, how) | 设置文件描述符 fd当前位置pos, how方式修改: SEEK_SET 或者 0 设置从文件开始的计算的pos; SEEK_CUR或者 1 则从当前位置计算; os.SEEK_END或者2则从文件尾部开始.在unix,Windows中有效 |
36+
| os.lstat(path) | 像stat(),但是没有软链接 |
37+
| os.major(device) | 从原始的设备号中提取设备major号码 (使用stat中的st_dev或者st_rdev field)。 |
38+
| os.makedev(major, minor) | 以major和minor设备号组成一个原始设备号 |
39+
| os.makedirs(path[, mode]) | 递归文件夹创建函数。像mkdir(), 但创建的所有intermediate-level文件夹需要包含子文件夹。 |
40+
| os.minor(device) | 从原始的设备号中提取设备minor号码 (使用stat中的st_dev或者st_rdev field )。 |
41+
| os.mkdir(path[, mode]) | 以数字mode的mode创建一个名为path的文件夹.默认的 mode 是 0777 (八进制)。 |
42+
| os.mkfifo(path[, mode]) | 创建命名管道,mode 为数字,默认为 0666 (八进制) |
43+
| os.mknod(filename[, mode=0600, device]) | 创建一个名为filename文件系统节点(文件,设备特别文或者命名pipe)。 |
44+
| os.open(file, flags[, mode]) | 打开一个文件,并且设置需要的打开选项,mode参数是可选的 |
45+
| os.openpty() | 打开一个新的伪终端对。返回 pty 和 tty的文件描述符。 |
46+
| os.pathconf(path, name) | 返回相关文件的系统配置信息。 |
47+
| os.pipe() | 创建一个管道. 返回一对文件描述符(r, w) 分别为读和写 |
48+
| os.popen(command[, mode[, bufsize]]) | 从一个 command 打开一个管道 |
49+
| os.read(fd, n) | 从文件描述符 fd 中读取最多 n 个字节,返回包含读取字节的字符串,文件描述符 fd对应文件已达到结尾, 返回一个空字符串。 |
50+
| os.readlink(path) | 返回软链接所指向的文件 |
51+
| os.remove(path) | 删除路径为path的文件。如果path 是一个文件夹,将抛出OSError; 查看下面的rmdir()删除一个 directory。 |
52+
| os.removedirs(path) | 递归删除目录。 |
53+
| os.rename(src, dst) | 重命名文件或目录,从 src 到 dst |
54+
| os.renames(old, new) | 递归地对目录进行更名,也可以对文件进行更名。 |
55+
| os.rmdir(path) | 删除path指定的空目录,如果目录非空,则抛出一个OSError异常。 |
56+
| os.stat(path) | 获取path指定的路径的信息,功能等同于C API中的stat()系统调用。 |
57+
| os.stat_float_times([newvalue]) | 决定stat_result是否以float对象显示时间戳 |
58+
| os.statvfs(path) | 获取指定路径的文件系统统计信息 |
59+
| os.symlink(src, dst) | 创建一个软链接 |
60+
| os.tcgetpgrp(fd) | 返回与终端fd(一个由os.open()返回的打开的文件描述符)关联的进程组 |
61+
| os.tcsetpgrp(fd, pg) | 设置与终端fd(一个由os.open()返回的打开的文件描述符)关联的进程组为pg。 |
62+
| os.tempnam([dir[, prefix]]) | *Python3* 中已删除。返回唯一的路径名用于创建临时文件。 |
63+
| os.tmpfile() | *Python3* 中已删除。返回一个打开的模式为(w+b)的文件对象 .这文件对象没有文件夹入口,没有文件描述符,将会自动删除。 |
64+
| os.tmpnam() | *Python3* 中已删除。为创建一个临时文件返回一个唯一的路径 |
65+
| os.ttyname(fd) | 返回一个字符串,它表示与文件描述符fd 关联的终端设备。如果fd 没有与终端设备关联,则引发一个异常。 |
66+
| os.unlink(path) | 删除文件路径 |
67+
| os.utime(path, times) | 返回指定的path文件的访问和修改的时间。 |
68+
| os.walk(top[, topdown=True[, onerror=None[, followlinks=False]]]) | 输出在文件夹中的文件名通过在树中游走,向上或者向下。 |
69+
| os.write(fd, str) | 写入字符串到文件描述符 fd中. 返回实际写入的字符串长度 |
70+
71+
## 参考
72+
73+
- [菜鸟 - OS模块](http://www.runoob.com/python3/python3-os-file-methods.html)

0 commit comments

Comments
 (0)