#!/usr/bin/python3

# open(file, mode='r', buffering=-1, encoding=None, errors=None, newline=None, closefd=True, opener=None)
# file: 必需，文件路径（相对或者绝对路径）。
# mode: 可选，文件打开模式
# buffering: 设置缓冲
# encoding: 一般使用utf8
# errors: 报错级别
# newline: 区分换行符
# closefd: 传入的file参数类型
# opener:

# 打开一个文件
# 第一个参数为要打开的文件名。
# 第二个参数描述文件如何使用的字符。 mode 可以是 'r' 如果文件只读, 'w' 只用于写 (如果存在同名文件则将被删除), 和 'a' 用于追加文件内容;
# 所写的任何数据都会被自动增加到末尾. 'r+' 同时用于读写。 mode 参数是可选的; 'r' 将是默认值。
# open() 将会返回一个 file 对象
# f = open("C:/Users/yj/Desktop/新建文件夹/python/file/filetest.txt", "w")  # 绝对路径
f = open("file/filetest.txt", "w")
# write(string) 将 string 写入到文件中, 然后返回写入的字符数
num = f.write( "Python 是一个非常好的语言。\n是的，的确非常好!!\n" )
print("写入的字符数:",num)
# 关闭打开的文件
f.close()

# 打开一个文件
f = open("file/filetest.txt", "r")
# 读取一个文件的内容
str = f.read()
print("read 读取文件的内容",str)
# 关闭打开的文件
f.close()

# 打开一个文件
f = open("file/filetest.txt", "r")
# readline() 会从文件中读取单独的一行。换行符为 '\n'。f.readline() 如果返回一个空字符串, 说明已经已经读取到最后一行。
str = f.readline()
print("readline 文件一行的内容",str)
# 关闭打开的文件
f.close()

# 打开一个文件
f = open("file/filetest.txt", "r")
# readlines() 将返回该文件中包含的所有行，如果设置可选参数 sizehint, 则读取指定长度的字节, 并且将这些字节按行分割。
str = f.readlines()
print("readlines文件中包含的所有行",str)
# 关闭打开的文件
f.close()

# 打开一个文件
f = open("file/filetest.txt", "r")
# 迭代方式
for line in f:
    print("迭代方式",line, end='')
# 关闭打开的文件
f.close()

# 打开一个文件
f = open("file/filetest.txt", "r")
# tell() 返回文件对象当前所处的位置, 它是从文件开头开始算起的字节数。
str=f.tell()
print("tell() 返回文件对象当前所处的位置",str)
# 关闭打开的文件
f.close()

# 打开一个文件
f = open('file/filetest.txt', 'rb+')
# 改变文件当前的位置, 可以使用 f.seek(offset, from_what) 函数
str=f.seek(5)     # 移动到文件的第六个字节
print("改变文件当前的位置",str)
# 关闭打开的文件
f.close()

# 方法

# file.close()    ：关闭文件。关闭后文件不能再进行读写操作。

# file.flush()    ：刷新文件内部缓冲，直接把内部缓冲区的数据立刻写入文件, 而不是被动的等待输出缓冲区写入。

# file.fileno()   ：返回一个整型的文件描述符(file descriptor FD 整型), 可以用在如os模块的read方法等一些底层操作上。

# file.isatty()   ：如果文件连接到一个终端设备返回 True，否则返回 False。

# file.next()     ：Python3 中的 File 对象不支持 next() 方法。返回文件下一行。

# file.read([size])   ：从文件读取指定的字节数，如果未给定或为负则读取所有。

# file.readline([size])   ：读取整行，包括 "\n" 字符。

# file.readlines([sizeint])   ：读取所有行并返回列表，若给定sizeint > 0，返回总和大约为sizeint字节的行, 实际读取值可能比 sizeint 较大, 因为需要填充缓冲区。

# file.seek(offset[, whence])     ：移动文件读取指针到指定位置

# file.tell()     ：返回文件当前位置。

# file.truncate([size])   ：从文件的首行首字符开始截断，截断文件为 size 个字符，无 size 表示从当前位置截断；截断之后后面的所有字符被删除，其中 Widnows 系统下的换行代表2个字符大小。

# file.write(str)     ：将字符串写入文件，返回的是写入的字符长度。

# file.writelines(sequence)   向文件写入一个序列字符串列表，如果需要换行则要自己加入每行的换行符。