str.splitlines([keepends])
keepends
- bool
, если True
- разрывы строк не будут вырезатьсяlist
, список строк.Метод str.splitlines()
возвращает список строк, текста str
, разделенного по универсальным разрывам строк. Разрывы (разделители) строк не включаются в результирующий список, если не задано значение keepends=True
.
Универсальные разрывы (разделители) строк представляют собой надмножество escape-последовательностей.
В методе строки str.splitlines()
определены следующие разделители (разрывы) строк:
\n
- Перевод строки\r
- Возврат каретки\r\n
- Возврат каретки + перевод строки\v
или \x0b
- Табуляция строк\f
или \x0c
- Подача страницы\x1c
- Разделитель файлов\x1d
- Разделитель групп\x1e
- Разделитель записей\x85
- Следующая строка (контрольный код C1)\u2028
- Разделитель строк\u2029n
- Разделитель абзацев>>> 'ab c\n\nde fg\rkl\r\n'.splitlines()
# ['ab c', '', 'de fg', 'kl']
>>> 'ab c\n\nde fg\rkl\r\n'.splitlines(keepends=True)
# ['ab c\n', '\n', 'de fg\r', 'kl\r\n']
В отличие от str.split()
, когда задается строка-разделитель sep
, метод str.splitlines()
возвращает пустой список []
для пустой строки, а разрыв строки не приводит к дополнительной строке:
>>> "".splitlines()
# []
>>> "One line\n".splitlines()
# ['One line']
# Для сравнения, split('\n') дает:
>>> ''.split('\n')
# ['']
>>> 'Two lines\n'.split('\n')
# ['Two lines', '']