Skip to content
Adrian Sieber edited this page Nov 11, 2018 · 4 revisions

Backslash is literal in "\n". Prefer explicit escaping: "\\n".

Note: this warning has been retired due to being too pedantic

Problematic code:

printf "%s\n" "Hello"

Correct code:

printf "%s\\n" "Hello"

or alternatively, with single quotes:

printf '%s\n' "Hello"

Rationale:

In a double quoted string, you have escaped a character that has no special behavior when escaped. Instead, it's invoking the fallback behavior of being interpreted literally.

Instead of relying on this implicit fallback, you should escape the backslash explicitly. This makes it clear that it's meant to be passed as a literal backslash in the string parameter.

Exceptions:

None. This is a stylistic issue which can be ignored. But can you name the 5 characters that are special when escaped in double quotes?

They are $, `, ", \, or newline. More infos are available in the bash manual.

Retired:

This warning is no longer emitted as of d8a32da07 (strictly after v0.5).

The number of harmlessly affected printf, sed and grep statements was significantly higher than the number of actual unexpanded escape sequences. It may return some day under a -pedantic type flag.

ShellCheck

Each individual ShellCheck warning has its own wiki page like SC1000. Use GitHub Wiki's "Pages" feature above to find a specific one, or see Checks.

Clone this wiki locally