#! /usr/bin/python
# -*- coding: utf-8 -*-

# open() 方法
'''
Python open() 方法用于打开一个文件，并返回文件对象，
在对文件进行处理过程都需要使用到这个函数，如果该文件无法被打开，会抛出 OSError
注意：使用 open() 方法一定要保证关闭文件对象，即调用 close() 方法
'''

# open() 函数常用形式是接收两个参数：文件名(file)和模式(mode)
'''
open(file, mode='r', buffering=-1, encoding=None, errors=None, newline=None, closefd=True, opener=None)

file: 必需，文件路径（相对或者绝对路径）。
mode: 可选，文件打开模式

buffering: 设置缓冲
buffering的可取值有0，1， >1三个，0代表buffer关闭（只适用于二进制模式），
1代表line buffer（只适用于文本模式），>1表示初始化的buffer大小；

encoding:编码格式
表示的是返回的数据采用何种编码，一般采用utf8或者gbk；

errors:错误级别
errors的取值一般有strict，ignore，当取strict的时候，字符编码出现问题的时候，会报错，
当取ignore的时候，编码出现问题，程序会忽略而过，继续执行下面的程序。

newline:区分换行符
可以取的值有None, \n,  \r, '', ‘\r\n' ，用于区分换行符，但是这个参数只对文本模式有效；

closefd的取值，是与传入的文件参数有关，默认情况下为True，传入的file参数为文件的文件名，
取值为False的时候，file只能是文件描述符，什么是文件描述符，
就是一个非负整数，在Unix内核的系统中，打开一个文件，便会返回一个文件描述符。

mode 参数有：
模式  描述
t   文本模式 (默认)。
x   写模式，新建一个文件，如果该文件已存在则会报错。
b   二进制模式。
+   打开一个文件进行更新(可读可写)。
U   通用换行模式（Python 3 不支持）。
r   以只读方式打开文件。文件的指针将会放在文件的开头。这是默认模式。
rb  以二进制格式打开一个文件用于只读。文件指针将会放在文件的开头。这是默认模式。一般用于非文本文件如图片等。
r+  打开一个文件用于读写。文件指针将会放在文件的开头。
rb+ 以二进制格式打开一个文件用于读写。文件指针将会放在文件的开头。一般用于非文本文件如图片等。
w   打开一个文件只用于写入。如果该文件已存在则打开文件，并从开头开始编辑，即原有内容会被删除。如果该文件不存在，创建新文件。
wb  以二进制格式打开一个文件只用于写入。如果该文件已存在则打开文件，并从开头开始编辑，即原有内容会被删除。如果该文件不存在，创建新文件。一般用于非文本文件如图片等。
w+  打开一个文件用于读写。如果该文件已存在则打开文件，并从开头开始编辑，即原有内容会被删除。如果该文件不存在，创建新文件。
wb+ 以二进制格式打开一个文件用于读写。如果该文件已存在则打开文件，并从开头开始编辑，即原有内容会被删除。如果该文件不存在，创建新文件。一般用于非文本文件如图片等。
a   打开一个文件用于追加。如果该文件已存在，文件指针将会放在文件的结尾。也就是说，新的内容将会被写入到已有内容之后。如果该文件不存在，创建新文件进行写入。
ab  以二进制格式打开一个文件用于追加。如果该文件已存在，文件指针将会放在文件的结尾。也就是说，新的内容将会被写入到已有内容之后。如果该文件不存在，创建新文件进行写入。
a+  打开一个文件用于读写。如果该文件已存在，文件指针将会放在文件的结尾。文件打开时会是追加模式。如果该文件不存在，创建新文件用于读写。
ab+ 以二进制格式打开一个文件用于追加。如果该文件已存在，文件指针将会放在文件的结尾。如果该文件不存在，创建新文件用于读写。
默认为文本模式，如果要以二进制模式打开，加上 b 。

'''

# file 对象
'''
file 对象使用 open 函数来创建，下表列出了 file 对象常用的函数：
序号  方法及描述
1   
file.close()
关闭文件。关闭后文件不能再进行读写操作。
2   
file.flush()
刷新文件内部缓冲，直接把内部缓冲区的数据立刻写入文件, 而不是被动的等待输出缓冲区写入。
3   
file.fileno()
返回一个整型的文件描述符(file descriptor FD 整型), 可以用在如os模块的read方法等一些底层操作上。
4   
file.isatty()
如果文件连接到一个终端设备返回 True，否则返回 False。
5   
file.next()
Python 3 中的 File 对象不支持 next() 方法。
返回文件下一行。
6   
file.read([size])
从文件读取指定的字节数，如果未给定或为负则读取所有。
7   
file.readline([size])
读取整行，包括 "\n" 字符。
8   
file.readlines([sizeint])
读取所有行并返回列表，若给定sizeint>0，返回总和大约为sizeint字节的行, 实际读取值可能比 sizeint 较大, 因为需要填充缓冲区。
9   
file.seek(offset[, whence])
移动文件读取指针到指定位置
10  
file.tell()
返回文件当前位置。
11  
file.truncate([size])
从文件的首行首字符开始截断，截断文件为 size 个字符，无 size 表示从当前位置截断；截断之后后面的所有字符被删除，其中 Widnows 系统下的换行代表2个字符大小。
12  
file.write(str)
将字符串写入文件，返回的是写入的字符长度。
13  
file.writelines(sequence)
向文件写入一个序列字符串列表，如果需要换行则要自己加入每行的换行符。

'''
f = open('sometest.txt', 'w+')
f.write('Python是一门不错的语音\n是的，我很喜欢\n')
f.close()

print ("哈哈")
f = open('sometest.txt', 'r')
a = f.readline()
print (a)
f.close()


with open('sometest.txt', 'w+') as f:
    f.write('Python是一门不错的语音\n是的，我很喜欢')

with open('sometest.txt', 'r') as f:
    # str = f.readline()
    # str2 = f.readline(2)
    f.seek(5)
    str3 = f.read(1)
    f.seek(-3, 2)
    str4 = f.read(2)
    print (str3)
    print (str4)