惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
WordPress大学
WordPress大学
T
Tailwind CSS Blog
V
Visual Studio Blog
月光博客
月光博客
Hugging Face - Blog
Hugging Face - Blog
小众软件
小众软件
奇客Solidot–传递最新科技情报
奇客Solidot–传递最新科技情报
博客园 - Franky
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
Last Week in AI
Last Week in AI
阮一峰的网络日志
阮一峰的网络日志
量子位
有赞技术团队
有赞技术团队
酷 壳 – CoolShell
酷 壳 – CoolShell
Apple Machine Learning Research
Apple Machine Learning Research
博客园_首页
Jina AI
Jina AI
雷峰网
雷峰网
博客园 - 【当耐特】
博客园 - 叶小钗
美团技术团队
宝玉的分享
宝玉的分享
IT之家
IT之家

jdhao's digital space

Conversion between base64 and OpenCV or PIL Image 腾讯云对象存储博客图床开启 CDN 加速(不需要购买额外域名) Search and Replace in Multiple Files in Vim/Neovim Change Table Column Width in LaTeX Image or Table Side by Side in LaTeX LaTeX 并排显示图像或表格 Firenvim: Neovim inside Your Browser Content inside HTML tags missing in Latest Hugo? Creating Markdown Front Matter with Ultisnips Labelme JSON 标注格式转 voc XML 格式 Nifty Nvim Techniques That Make My Life Easier -- Series 6 macOS 下如何为视频制作字幕 Running Command Asynchronously inside Neovim Resolving Merge Conflict after Git Stash Pop Pylint: command not found? A Hands-on Experience with Neovim's Built-in LSP Support How to Convert PDF to Images with Imagemagick 互联网上常用缩略语集锦 File Backup in Neovim Converting PDF Pages to Images with Poppler Nifty Nvim Techniques That Make My Life Easier -- Series 5 Neovim Configuration for System-wide Use How to sort a list of tuple or list in Python -- lambda or itemgetter? Building A Vim Statusline from Scratch 人类第一颗原子弹爆炸始末 Distributed Training in PyTorch with Horovod Learning Expect Programming Essential Knowledge about SSH Nifty LaTeX Techniques -- Series 1 更改 Adsense 邮寄地址,重新寄送 PIN
How Is Newline Handled in Python and Various Editors?
2018-12-08 · via jdhao's digital space

Every programmer knows newline character, but may be not so familiar. In this post, I want to share what I have learned about newline handling in various cases.

Newline characters on different platforms#

Due to historical reasons, different platforms use different characters to signify a new line. On Windows, <CR><LF> (byte code 0x0D0x0A) is used to represent newline. On Linux, <LF>(byte code 0x0A) is used to represent newline. On older Mac1, <CR>(byte code 0x0D) is used.

<CR> and <LF> date back to the old time when typewriters is used for printing texts on paper. <CR> represents carriage return, which means to put the carriage to its left-most position. <LF> represents line feed, which means to move the paper a little higher so that you can type on a new line. You can see that these two actions combined will start a new line ready for typing.

Newline handling in Python#

Python 2 and Python 3 have different way of handling newlines. In Python 2, there is a universal newline mode, which means that no matter what the file line ending is, it will all be translated to \n when reading files with mode specifier rU.

In Python 3, things have changed. The old U mode specifier has been deprecated in favor of a newline parameter in the open() method. According to the documentation:

newline controls how universal newlines mode works (it only applies to text mode). It can be None, ‘’, ‘\n’, ‘\r’, and ‘\r\n’. It works as follows:

  • When reading input from the stream, if newline is None, universal newlines mode is enabled. Lines in the input can end in ‘\n’, ‘\r’, or ‘\r\n’, and these are translated into ‘\n’ before being returned to the caller. If it is ‘’, universal newlines mode is enabled, but line endings are returned to the caller untranslated.
  • When writing output to the stream, if newline is None, any ‘\n’ characters written are translated to the system default line separator, os.linesep. If newline is ’’ or ‘\n’, no translation takes place.

when reading text files, newline is None by default, which means that system-dependent newline will be quietly replaced by \n. If you are not aware of this behavior, you may get into trouble. For example, when you read a file with \r\n line ending and want to split the text into lines on Windows platform, if you use the following snippet:

with open("some_file.txt", "r") as f:
    text = f.read()
lines = text.split(os.linesep)

you will not be able to split the text into lines. That is because on Windows platform, os.linesep is \r\n. But Python has secretly translated the \r\n in the file to \n!

When writing files, you should also be aware that \n will be translated to platform-dependent line endings.

Newline handling in different editors#

Vim#

When reading a file into the buffer, Vim will automatically detect the file format2. Then Vim will replace the platform-dependent newline characters with a special mark to mark the end of each line. When writing the buffer content back into the file, Vim will write the actual newline characters based on the detected file format.

For example, if you open a file with Windows-style line ending, Vim will replace all <CR><LF> with its own newline mark. If you try to search these two characters using their byte code (\%x0A for <CR> and \%x0D for <LF> ), you will find nothing. Neither can you find <CR> characters using \r in Windows file in Vim (suppose fileformats include dos). When searching in Vim, \n is used to specify end of line, no matter what the actual newline character is for this file. So you can search the line end with \n.

How do I show the <CR> characters in Vim then?#

You can open a Windows file in Vim and use e ++ff=unix3 to force Vim to treat this file as a unix file. Vim will then treat the \n characters as newline, thus removing it from the buffer. But the \r characters in the file will now be treated as normal characters and will be shown as ^M. You will see it now.

You can also press <Ctrl-V> and then press <Enter> to type a carriage return character. Then you can search this character using \r.

A pitfall in searching and replacing newlines#

In Vim, \n is used to represent newline only when you are searching it. If you want to represent a newline in replacement, use \r instead4. This makes no sense, but that is how Vim works.

Sublime Text#

According to discussions here, Sublime Text will also convert platform-dependent newline to \n in memory. When writing to files, it will write newlines based on the detected file type (Windows, Unix or Mac).

Notepad++#

Notepad++ is also a popular code editor. It can detect your line endings, but it will not replace the newline with \n. To show the newline characters in a file, go to View --> Show Symbol and toggle on option Show End of Line, you will be able to see the newline characters.

Conversion between different file formats?#

In Vim, you can use set ff=<Format> to covert the current file to desired format, where <Format> can be unix, dos or mac.

In Sublime Text, just choose the desired format from the bottom right status bar.

In Notepad++, go to Edit --> EOL Conversion and choose the desired file format.

There are also tools such as dos2unix and unix2dos which convert between different file formats.

References#


Title image is taken from here.