bash-hackers-wiki/original_source/syntax/words.txt

====== Words... ======

{{keywords>bash shell scripting token words split splitting recognition}}

FIXME This article needs a review, it covers two topics (command line splitting and word splitting) and mixes both a bit too much. But in general, it's still usable to help understand this behaviour, it's "wrong but not wrong".

One fundamental principle of Bash is to recognize words entered at the command prompt, or under other circumstances like variable-expansion.


===== Splitting the commandline =====
Bash scans the command line and splits it into words, usually to put the parameters you enter for a command into the right C-memory (the ''argv'' vector) to later correctly call the command. These words are recognized by splitting the command line at the special character position, **Space** or **Tab** (the manual defines them as **blanks**).
For example, take the echo program. It displays all its parameters separated by a space. When you enter an echo command at the Bash prompt, Bash will look for those special characters, and use them to separate the parameters.

You don't know what I'm talking about? I'm talking about this:
<code>
$ echo Hello little world
Hello little world
</code>

In other words, something you do (and Bash does) everyday. The characters where Bash splits the command line (SPACE, TAB i.e. blanks) are recognized as delimiters.
There is no null argument generated when you have 2 or more blanks in the command line. **A sequence of more blank characters is treated as a single blank.**
Here's an example:

<code>
$ echo Hello                little                  world
Hello little world
</code>

Bash splits the command line at the blanks into words, then it calls echo with **each word as an argument**. In this example, echo is called with three arguments: "''Hello''", "''little''" and "''world''"!

__Does that mean we can't echo more than one Space?__ Of course not!
Bash treats blanks as special characters, but there are two ways to tell Bash not to treat them special: **Escaping** and **quoting**.

Escaping a character means, to **take away its special meaning**. Bash will use an escaped character as text, even if it's a special one. Escaping is done by preceeding the character with a backslash:

<code>
$ echo Hello\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ little \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ world
Hello                little                  world
</code>

None of the escaped spaces will be used to perform word splitting. Thus, echo is called with one argument: "''Hello                little            world''".

Bash has a mechanism to "escape" an entire string: **Quoting**.
In the context of command-splitting, which this section is about, it doesn't matter which kind of quoting you use: weak quoting or strong quoting, both cause Bash to not treat spaces as special characters:

<code>
$ echo "Hello                little                  world"
Hello                little                  world
</code>
<code>
$ echo 'Hello                little                  world'
Hello                little                  world
</code>

__What is it all about now?__ Well, for example imagine a program that expects a filename as an argument, like cat. Filenames can have spaces in them:

<code>
$ ls -l
total 4
-rw-r--r-- 1 bonsai bonsai 5 Apr 18 18:16 test file

$ cat test file
cat: test: No such file or directory
cat: file: No such file or directory

$ cat test\ file
m00!

$ cat "test file"
m00!
</code>

If you enter that on the command line with Tab completion, that will take care of the spaces. But Bash also does another type of splitting.

===== Word splitting =====

For a more technical description, please read the [[syntax:expansion:wordsplit | article about word splitting]]!

The first kind of splitting is done to parse the command line into separate tokens. This is what was described above, it's a pure **command line parsing**.

After the command line has been split into words, Bash will perform expansion, if needed - variables that occur in the command line need to be expanded (substituted by their value), for example. This is where the second type of word splitting comes in - several expansions undergo **word splitting** (but others do not).

Imagine you have a filename stored in a variable:

<code>
MYFILE="test file"
</code>

When this variable is used, its occurance will be replaced by its content.

<code>
$ cat $MYFILE
cat: test: No such file or directory
cat: file: No such file or directory
</code>

Though this is another step where spaces make things difficult, **quoting** is used to work around the difficulty. Quotes also affect word splitting:

<code>
$ cat "$MYFILE"
m00!
</code>








===== Example =====

Let's follow an unquoted command through these steps, assuming that the variable is set:
<code>
MYFILE="THE FILE.TXT"
</code>
and the first review is:
<code>
echo The file is named $MYFILE
</code>

The parser will scan for blanks and mark the relevant words ("splitting the command line"):

^Initial command line splitting:^^^^^^
^Word 1^Word 2^Word 3^Word 4^Word 5^Word 6^
|''echo''|''The''|''file''|''is''|''named''|''$MYFILE''|

A [[syntax:pe | parameter/variable expansion]] is part of that command line, Bash will perform the substitution, and the [[syntax:expansion:wordsplit | word splitting]] on the results:

^Word splitting after substitution:^^^^^^^
^Word 1^Word 2^Word 3^Word 4^Word 5^Word 6^Word 7^
|''echo''|''The''|''file''|''is''|''named''|''THE''|''FILE.TXT''|

Now let's imagine we quoted ''$MYFILE'', the command line now looks like:
<code>
echo The file is named "$MYFILE"
</code>

^Word splitting after substitution (quoted!):^^^^^^
^Word 1^Word 2^Word 3^Word 4^Word 5^Word 6^
|''echo''|''The''|''file''|''is''|''named''|''THE FILE.TXT''|

**//Bold Text//72i love this world**===== See also =====
  * Internal: [[syntax:quoting | Quoting and character escaping]]
  * Internal: [[syntax:expansion:wordsplit | Word splitting]]
  * Internal: [[syntax:expansion:intro | Introduction to expansions and substitutions]]

  * External: [[http://www.grymoire.com/Unix/Quote.html | Grymore: Shellquoting]]