diff --git a/docs/sbs/zh/sbs/file.md b/docs/sbs/zh/sbs/file.md index 94efb0133e6d0201b129fd40eb539611b9911d9f..09da331a55f711ac29373df65f136f0be01a0abf 100644 --- a/docs/sbs/zh/sbs/file.md +++ b/docs/sbs/zh/sbs/file.md @@ -1,27 +1,27 @@ -### 文件读写 使用说明 +# 文件读写使用说明 -#### 文件基本概念 +## 文件基本概念 文件将数据保存并存储在某种长期存储设备上,存储设备主要包括硬盘 、U 盘 、移动硬盘、光盘等。 -**文件存储方式** +## 文件存储方式 -文件主要以二进制及文本的方式进行储存。 +文件主要以文本及二进制的方式进行储存。 -1. 文本文件 , 例如 Python 的 源程序 : +### 文本文件 , 例如 Python 的源程序： - 可以使用文本编辑软件查看 ； - 本质上还是二进制文件 。 -2. 二进制文件 ，例如图片文件、音频文件、视频文件： +### 二进制文件，例如图片文件、音频文件、视频文件： - 保存的内容无法直接阅读 ，而是提供给其他软件使用的 ； - 二进制文件不能使用文本编辑软件查看 。 -**文件的基本操作** +## 文件的基本操作 -文件操作类型 +### 文件操作类型 - 打开文件 - 读、写文件 @@ -29,7 +29,7 @@ - 写 ： 将内存内容写入文件 - 关闭文件 -文件访问方式 +### 文件访问方式 表 **1**： 文件访问方式 @@ -41,7 +41,7 @@ **备注** :若频繁移动文件指针，会影响文件的读写效率。通常，在开发过程中会以只读、只写的方式来操作文件。 -**文件操作函数** +## 文件操作函数 表 **2**： 文件操作函数 @@ -54,25 +54,25 @@ -#### 操作文件及目录 +## 操作文件及目录 -将 EC100Y-CN QuecPython 开发板 连接至电脑，接入后的操作方法详见《 Quectel_QuecPython_基础 操作说明 》。 +将 EC600S-CN QuecPython 开发板连接至电脑，接入后的操作方法详见[《Quectel_QuecPython_基础操作说明》](https://python.quectel.com/doc/doc/sbs/zh/index.html)。 -![Quectel_QuecPython_file_rw_029.png](media/Quectel_QuecPython_file_rw_029.png) +![QuecPytgon_sbs_file_01.png](media/QuecPytgon_sbs_file_01.png) -​ 图 **1**： **EC100Y-CN QuecPython** 开发板与电脑连接 +​ 图 **1**： **EC600S-CN QuecPython** 开发板与电脑连接 -**以只读方式打开文件** +### 以只读方式打开文件 步骤一 ： 创建 *test.py*、*test.txt* 文件， 并 在 *test.py* 文件中导入 QuecPython 中的 *uio* 模块，在 *test.txt* 文件输入 "hello python"。 -- 在 t*est.py* 文件中导入 QuecPython 中的 *uio* 模块 ： +- 在 t*est.py* 文件中导入 QuecPython 中的 *uio* 模块： ```python import uio # 以只读方式打开 test.txt 文件 -fd = uio.open("test.txt", mode='r') +fd = uio.open("usr/test.txt", mode='r') # 读取文件内容 text = fd.read() @@ -84,29 +84,29 @@ fd.close() - 在 *test.txt* 文件输入 "hello python"： -![Quectel_QuecPython_file_rw_032.png](media/Quectel_QuecPython_file_rw_032.png) +![QuecPytgon_sbs_file_02.png](media/QuecPytgon_sbs_file_02.png) ​ 图 **2**： 在 **test.txt** 文件输入 **"hello python"** -步骤 二 ： 将 *test.py* 文件和 *test.txt* 文件分别上传到 EC100Y-CN QuecPython 开发板内，上传方法详见《Quectel_QuecPython_基础操作说明》 。 +步骤 二 ： 将 *test.py* 文件和 *test.txt* 文件分别上传到 EC600S-CN QuecPython 开发板内，上传方法详见[《Quectel_QuecPython_基础操作说明》](https://python.quectel.com/doc/doc/sbs/zh/index.html)。 -步骤 三 ： 读取文件 运行结果 +步骤 三 ： 读取文件运行结果 -![Quectel_QuecPython_file_rw_033.png](media/Quectel_QuecPython_file_rw_033.png) +![QuecPytgon_sbs_file_03.png](media/QuecPytgon_sbs_file_03.png) -​ 图 **3**： 读取 文件运行结果 +​ 图 **3**： 读取文件运行结果 -**以只写方式打开文件** +### 以只写方式打开文件 -步骤一 ： 创建 *test.py* 文件及 内容 为空白的 *test.txt* 文件，在 *test.py* 文件中导入 QuecPython 中的 uio 模 +步骤一 ： 创建 *test.py* 文件及内容为空白的 *test.txt* 文件，在 *test.py* 文件中导入 QuecPython 中的 uio 模 -块， 并 编写如下代码 ： +块，并编写如下代码 ： ```python import uio # 以只写方式打开 test.txt 文件 -fd = uio.open("test.txt", mode=‘w') +fd = uio.open("usr/test.txt", mode='w') # 向文件写内容 fd.write("HELLO PYTHON") @@ -115,31 +115,32 @@ fd.write("HELLO PYTHON") fd.close() ``` -步骤 二 ： 将 *test.py* 文件和 *test.txt* 文件分别上传到 EC100Y-CN QuecPython 开发板内，上传方法详见《Quectel_QuecPython_基础操作说明》。 +步骤 二 ： 将 *test.py* 文件和 *test.txt* 文件分别上传到 EC600S-CN QuecPython 开发板内，上传方法详见[《Quectel_QuecPython_基础操作说明》](https://python.quectel.com/doc/doc/sbs/zh/index.html)。 -步骤 三 ： 写入文件运行结果 +步骤 三 ： 参照5.1运行只读文件方式显示文件，可得到写入结果。 -![Quectel_QuecPython_file_rw_035.png](media/Quectel_QuecPython_file_rw_035.png) +![QuecPytgon_sbs_file_04.png](media/QuecPytgon_sbs_file_04.png) -​ 图 **4**： 写入 文件运行结果 +​ 图 **4**： 写入文件运行结果 -**使用 uos 模块** +### 使用 uos 模块 +具体的API 详解请参考[QuecPython-标准库-uos](https://python.quectel.com/wiki/#/zh-cn/api/pythonStdlib?id=uos-基本系统服务)。 -1. 列出当前文件列表 +#### 列出当前文件列表 -![Quectel_QuecPython_file_rw_036.png](media/Quectel_QuecPython_file_rw_036.png) +![QuecPytgon_sbs_file_05.png](media/QuecPytgon_sbs_file_05.png) -​ 图 **5**： 列出 当前文件列表 +​ 图 **5**： 列出当前文件列表 -2. 新建目录 +#### 新建目录 -![Quectel_QuecPython_file_rw_037.png](media/Quectel_QuecPython_file_rw_037.png) +![QuecPytgon_sbs_file_05.png](media/QuecPytgon_sbs_file_05.png) ​ 图 **6**： 新建目录 -3. 删除目录 +#### 删除目录 -![Quectel_QuecPython_file_rw_038.png](media/Quectel_QuecPython_file_rw_038.png) +![QuecPytgon_sbs_file_06.png](media/QuecPytgon_sbs_file_06.png) ​ 图 **7**： 删除目录 @@ -147,11 +148,10 @@ fd.close() -#### 附录术语缩写 +### 附录术语缩写 表 **3**： 术语缩写 | 缩写 | 英文全称 | 中文全称 | | ---- | --------------------------------- | ---------------- | -| SDK | Software Development Kit | 软件开发工具包 | | API | Application Programming Interface | 应用程序编程接口 | \ No newline at end of file diff --git a/docs/sbs/zh/sbs/media/782cd2c870c62e6f022cca4e47c7c806.jpg b/docs/sbs/zh/sbs/media/782cd2c870c62e6f022cca4e47c7c806.jpg deleted file mode 100644 index 575991836b57cc4989dd6fa50f37889b5b670f9b..0000000000000000000000000000000000000000 Binary files a/docs/sbs/zh/sbs/media/782cd2c870c62e6f022cca4e47c7c806.jpg and /dev/null differ diff --git a/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_01.png b/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_01.png new file mode 100644 index 0000000000000000000000000000000000000000..466b1f1fb45f3dfdf08323643c5f28dc903a14f8 Binary files /dev/null and b/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_01.png differ diff --git a/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_02.png b/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_02.png new file mode 100644 index 0000000000000000000000000000000000000000..b39e4f37680ee5911427a7e9bf9f84b1f6ded5ee Binary files /dev/null and b/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_02.png differ diff --git a/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_03.png b/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_03.png new file mode 100644 index 0000000000000000000000000000000000000000..10b772a9015e0358e685d6ffd863b93fb00f7976 Binary files /dev/null and b/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_03.png differ diff --git a/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_04.png b/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_04.png new file mode 100644 index 0000000000000000000000000000000000000000..6e47dbbf1576ac466bb6f85d7cb373cd850bc822 Binary files /dev/null and b/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_04.png differ diff --git a/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_05.png b/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_05.png new file mode 100644 index 0000000000000000000000000000000000000000..eec29be874bb9d8fadd9155ab6a84b55d2a105b6 Binary files /dev/null and b/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_05.png differ diff --git a/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_06.png b/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_06.png new file mode 100644 index 0000000000000000000000000000000000000000..d1218e14a4ab15041f160b17850c4ea051c1e345 Binary files /dev/null and b/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_06.png differ diff --git a/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_07.png b/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_07.png new file mode 100644 index 0000000000000000000000000000000000000000..456b9e10aec4a0a60305343a7c041ea07d994362 Binary files /dev/null and b/docs/sbs/zh/sbs/media/QuecPytgon_sbs_file_07.png differ diff --git a/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_029.png b/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_029.png deleted file mode 100644 index 6d0a8d54e6cf42b1d1e7b95eeffd9d8671befa2d..0000000000000000000000000000000000000000 Binary files a/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_029.png and /dev/null differ diff --git a/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_032.png b/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_032.png deleted file mode 100644 index 91c4b6474fa4fc99c56ac4035f65cdb7795bd158..0000000000000000000000000000000000000000 Binary files a/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_032.png and /dev/null differ diff --git a/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_033.png b/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_033.png deleted file mode 100644 index 827b0ed0c7089e0b41cc0f2bd78421acea367915..0000000000000000000000000000000000000000 Binary files a/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_033.png and /dev/null differ diff --git a/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_035.png b/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_035.png deleted file mode 100644 index 09acb3348a2aa167ced6ce1971b7106c76b9f735..0000000000000000000000000000000000000000 Binary files a/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_035.png and /dev/null differ diff --git a/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_036.png b/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_036.png deleted file mode 100644 index 1c48fc1de4607a17708f6b0c2eef57c2b4cf8f0f..0000000000000000000000000000000000000000 Binary files a/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_036.png and /dev/null differ diff --git a/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_037.png b/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_037.png deleted file mode 100644 index 7502a4a86b041d07e074851150b537cc027c005e..0000000000000000000000000000000000000000 Binary files a/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_037.png and /dev/null differ diff --git a/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_038.png b/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_038.png deleted file mode 100644 index 552f339a9d394d536a648dd8641cda8007de58ad..0000000000000000000000000000000000000000 Binary files a/docs/sbs/zh/sbs/media/Quectel_QuecPython_file_rw_038.png and /dev/null differ