Python writelines() 方法

---

---

Python 的 writelines() 方法将一系列字符串写入文件。该序列可以是任何产生字符串的可迭代对象，通常是字符串列表。

当该方法将一系列字符串写入文件时，它首先写入内部缓冲区；一旦该缓冲区已满，内容就会被传输到当前文件。由于这种缓冲机制，文本可能直到调用 flush() 或 close() 方法后才会实际显示在文件中。

如果当前文件为空，该方法会从开头添加内容；但如果它已经包含一些文本，则添加此文本的位置取决于文件指针的位置；而此位置根据文件模式而变化。各种情况如下：

• 如果文件以写入模式 (w 或 w+) 打开，则文件中的现有文本将被擦除，文件指针移动到文件开头。因此，在这种情况下，writelines() 方法从开头写入。
• 如果文件以追加模式 (a 或 a+) 打开，则现有文本保持不变，文件指针保持在文件末尾。因此，新文本将添加到现有内容之后。
• 如果文件以读写模式 (r+) 打开，则指针移动到文件开头并替换文件中的现有内容。但是，不会替换整个文本；writelines() 方法只用新字符串对象的字符替换现有字符串中的字符。文件中剩余的文本保持不变。
• 如果文件以读取模式 (r) 打开，此方法无效。

语法

以下是 Python 文件 writelines() 方法的语法：

fileObject.writelines( sequence )

参数

• sequence − 这是字符串的序列。

返回值

此方法不返回值。

示例

考虑一个包含字符串的演示文件“foo.txt”。

This is 1st line
This is 2nd line
This is 3rd line
This is 4th line
This is 5th line

以下示例演示了 Python 文件 writelines() 方法的用法。演示文件以写入 (w) 模式打开，因此文件中的现有内容将被擦除，并使用此方法插入新内容。由于此方法不返回值，因此必须直接检查文件以查看反映出的更改。

# Open a file in write mode
fo = open("foo.txt", "w")
print("Name of the file: ", fo.name)

# Assuming file has following 5 lines
# This is 1st line
# This is 2nd line
# This is 3rd line
# This is 4th line
# This is 5th line

# Write a new line into the file
seq = ["This is the new line", '\n', "This is another new line"]
line = fo.writelines(seq)

print("Check the file to see the reflected changes")

# Close opened file
fo.close()

当我们运行上述程序时，它会产生以下结果：

Name of the file:  foo.txt
Check the file to see the reflected changes

示例

在上面的例子中，需要打开文件来检查更改是否生效。但是我们也可以尝试在终端本身显示文件内容。为此，一旦使用 `writelines()` 方法重写文件，我们就关闭文件。然后，以读取 (r) 模式再次打开此文件，并使用 `read()` 方法读取文件内容。

# Open a file in write mode
fo = open("foo.txt", "w")
print("Name of the file: ", fo.name)

# Assuming file has following 5 lines
# This is 1st line
# This is 2nd line
# This is 3rd line
# This is 4th line
# This is 5th line

# Write a new line
seq = ["This is the new line", '\n', "This is another new line"]
line = fo.writelines(seq)

# Close opened file
fo.close()

# Open the file again in read mode
fo = open("foo.txt", "r")

line = fo.read()
print("File Contents:", line)

# Close opened file again
fo.close()

运行上面的程序后，输出将如下所示在终端上显示：

Name of the file:  foo.txt
File Contents: This is the new line
This is another new line

示例

如果尝试以写入 (w) 模式打开目录中不存在的文件，则会创建一个具有给定名称的新文件。在下面的示例中，`writelines()` 方法在此文件中调用，并将新内容插入其中。

# Open a non-existent file in write mode
fo = open("new.txt", "w")
print("Name of the file: ", fo.name)

# Write a new text
seq = ["Hello", '\n', "Welcome to Tutorialspoint"]
line = fo.writelines(seq)

print("Check the file to see the reflected changes")

# Close opened file
fo.close()

让我们编译并运行给定的程序，输出将如下所示：

Name of the file:  new.txt
Check the file to see the reflected changes

示例

当文件以追加 (a 或 a+) 模式打开时，也可以使用 `writelines()` 方法。

在这个例子中，一个名为“foo.txt”的文件以追加模式“a”打开。由于文件以追加模式打开，`writelines()` 方法将内容写入文件的末尾。使用 `write()` 方法，新行紧跟在字符串的最后一个字符之后；但使用 `writelines()` 方法，由于换行符和字符串作为对象传递给列表，新字符串将追加到下一行。文件内容将在终端本身显示。

# Let the test file contain the following strings
# Hello!
# This is Tutorialspoint
# Welcome

# Open the test file in append mode
fo = open("test.txt", "a")
print("Name of the file: ", fo.name)

seq = ['\n', "This is the new line"]
fo.writelines(seq)

# Close opened file
fo.close()

# Open the file again in read mode
fo = open("test.txt", "r")

line = fo.read()
print("File Contents:", line)

# Close opened file again
fo.close()

程序编译并运行后，输出将如下所示在终端显示：

Name of the file:  test.txt
File Contents: Hello!
This is Tutorialspoint
Welcome
This is the new line

示例

如果在使用读写模式 (r+) 打开的文件上使用 `writelines()` 方法，指针将移动到文件的开头，并替换文件中现有的内容。

在下面的示例中，我们以“r+”模式打开现有文件“foo.txt”。文件中现有的字符将从开头被传递作为列表的字符串对象中的字符替换。文件中剩余的文本保持不变。

# Open the test file in append mode
fo = open("foo.txt", "r+")
print("Name of the file: ", fo.name)

seq = ["This is a new line", '\n', "This is another new line", '\n']
fo.writelines(seq)

print("Check the file to see the reflected changes")

# Close opened file again
fo.close()

# Open the file again in read mode
fo = open("foo.txt", "r")

line = fo.read()
print("File Contents:", line)

# Close opened file again
fo.close()

让我们编译并运行上面的程序，得到如下结果：

Name of the file:  foo.txt
Check the file to see the reflected changes
File Contents: This is a new line
This is another new line
d line
This is 4th line
This is 5th line