"""
模块：python3 open().py
参考：https://www.runoob.com/python3/python3-func-open.html
知识点：
1.open(file, mode='r', buffering=-1, encoding=None,
errors=None, newline=None, closefd=True, opener=None) -> 文件对象
open() 函数用于打开一个文件，并返回文件对象，
在对文件进行处理时，都需要用到这个函数，
如果该文件无法打开，会抛出 OSError。
注意：
使用 open() 函数一定要保证关闭文件对象，即调用 close() 函数。
open() 函数常用形式如下：
open(file, mode='r')
file: 必需，文件路径（相对或者绝对路径）。
mode: 可选，文件打开模式
buffering: 设置缓冲
encoding: 一般使用utf8
errors: 报错级别
newline: 区分换行符
closefd: 传入的file参数类型
opener:
mode 参数有：
r 以只读方式打开文件。文件的指针将会放在文件的开头 (默认)。
t 文本模式 (默认)。
b 二进制模式。
rb 以二进制格式打开一个文件用于只读。
文件指针将会放在文件的开头。一般用于非文本文件如图片，或未知编码类型的文件等。
+ 打开一个文件进行更新(可读可写)。
r+ 打开一个文件用于读写。文件指针将会放在文件的开头。
rb+ 以二进制格式打开一个文件用于读写。文件指针将会放在文件的开头。一般用于非文本文件如图片等。
w 打开一个文件只用于写入。
如果该文件已存在则打开文件，清空文件内容。
如果该文件不存在，创建新文件。
wb 以二进制格式打开一个文件只用于写入。
如果该文件已存在则打开文件，清空文件内容。
如果该文件不存在，创建新文件。一般用于非文本文件如图片等。
w+ 打开一个文件用于读写。
如果该文件已存在则打开文件，清空文件内容。
如果该文件不存在，创建新文件。
wb+ 以二进制格式打开一个文件用于读写。
如果该文件已存在则打开文件，清空文件内容。
如果该文件不存在，创建新文件。一般用于非文本文件如图片等。
a 打开一个文件用于追加。
如果该文件已存在，文件指针将会放在文件的结尾。
也就是说，新的内容将会被写入到已有内容之后。
如果该文件不存在，创建新文件进行写入。
ab 以二进制格式打开一个文件用于追加。
如果该文件已存在，文件指针将会放在文件的结尾。
也就是说，新的内容将会被写入到已有内容之后。
如果该文件不存在，创建新文件进行写入。
a+ 打开一个文件用于读写。
如果该文件已存在，文件指针将会放在文件的结尾。
文件打开时会是追加模式。
如果该文件不存在，创建新文件用于读写。
ab+ 以二进制格式打开一个文件用于追加。
如果该文件已存在，文件指针将会放在文件的结尾。
如果该文件不存在，创建新文件用于读写。
默认为文本模式，如果要以二进制模式打开，加上 b 。
"""
# 1.推荐用法。
# f，文件对象。
# 当为文本模式时，可以使用 encoding 指定编码方式，
# 要与文件的编码方式一致，否则，乱码。
with open("cs.txt", "rt", encoding="utf-8") as f:
# print("f:", f)
# # f: <_io.TextIOWrapper name='cs.txt' mode='rt' encoding='utf-8'>
# print("f.encoding:", f.encoding)
# # f.encoding: utf-8
content = f.read()
print("content:\n", content, sep='')
# content:
# 1.微信文件：
# C:\Users\Administrator\Documents\WeChat Files\gaoshengjie0914\FileStorage\File
# 2.marsGis:
# ...
