Terminal · intermediate
Null-delimited filenames
A null-delimited pathname stream terminates each pathname with a zero byte, the one byte that cannot occur inside a Unix pathname component.
Why it matters
Newline- or whitespace-delimited filename pipelines break on legal names containing those characters, while null delimiters preserve unambiguous boundaries.
Mental model
How to reason about null-delimited filenames
Choose a separator excluded from the data domain, then ensure every producer, intermediate stage, and consumer agrees on that same record format.
Analogy
It is tamper-proof packaging whose seal cannot appear inside any valid item, so a receiver always knows exactly where one package ends.
Examples
See the boundary, not just the happy path
Worked example · Read pathnames in Bash
while IFS= read -r -d '' path; do printf '%q\n' "$path"; done < <(find . -type f -print0)find emits null terminators and Bash read consumes them with -d ''; IFS= and -r prevent other text transformations.
Worked example · Sort pathnames without changing format
find . -type f -print0 | sort -z | xargs -0 sha256sumGNU sort -z reads and writes null-terminated records, so the entire pipeline preserves names containing newlines.
Useful contrast · Line-delimited display
find . -type f -printNewline output is convenient for human viewing but is not an unambiguous machine format when a pathname itself may contain a newline.
Common mistakes
Misconceptions to remove early
Using -print0 with a line-oriented middle stage
A tool such as ordinary grep or sed may not preserve null records; one incompatible stage invalidates the boundary guarantee.
Storing null bytes in shell variables
Common shells cannot represent embedded null bytes in variables, so consume null-delimited data as a stream and store each decoded pathname separately.
Quick check
Can you predict the result?
1. Why is the null byte a safe Unix pathname delimiter?
- • Unix pathname components cannot contain a null byte.
- • Null bytes are automatically escaped in filenames.
- • Every filesystem stores filenames as text lines.
2. What must be true of every tool in a null-delimited pipeline?
Keep building
Related concepts
Put the concept to work