summaryrefslogtreecommitdiff
path: root/doc/usage/echo.rst
blob: 861abdfd1ebb3719bbc03fcc61ada065e7a4f425 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
echo command
============

Synopsis
--------

::

    echo [-n] [args ...]

Description
-----------

The echo command prints its arguments to the console separated by spaces.

-n
    Do not print a line feed after the last argument.

args
    Arguments to be printed. The arguments are evaluated before being passed to
    the command.

Examples
--------

Strings are parsed before the arguments are passed to the echo command:

::

    => echo "a" 'b' c
    a b c
    =>

Observe how variables included in strings are handled:

::

    => setenv var X; echo "a)" ${var} 'b)' '${var}' c) ${var}
    a) X b) ${var} c) X
    =>


-n suppresses the line feed:

::

    => echo -n 1 2 3; echo a b c
    1 2 3a b c
    => echo -n 1 2 3
    1 2 3=>

A more complex example:

::

    => for i in a b c; do for j in 1 2 3; do echo -n "${i}${j}, "; done; echo; done;
    a1, a2, a3,
    b1, b2, b3,
    c1, c2, c3,
    =>

Return value
------------

The return value $? is always set to 0 (true).