File: echo.rst

package info (click to toggle)
fish 4.2.1-3.1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 35,980 kB
  • sloc: python: 6,972; javascript: 1,407; sh: 1,009; xml: 411; ansic: 230; objc: 78; makefile: 20
file content (84 lines) | stat: -rw-r--r-- 1,352 bytes parent folder | download | duplicates (2)
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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
echo - display a line of text
=============================

Synopsis
--------

.. synopsis::

    echo [OPTIONS] [STRING]

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

.. only:: builder_man

          NOTE: This page documents the fish builtin ``echo``.
          To see the documentation on any non-fish versions, use ``command man echo``.

``echo`` displays *STRING* of text.

The following options are available:

**-n**
    Do not output a newline.

**-s**
    Do not separate arguments with spaces.

**-E**
    Disable interpretation of backslash escapes (default).

**-e**
    Enable interpretation of backslash escapes.

Unlike other shells, this echo accepts ``--`` to signal the end of the options.

Escape Sequences
----------------

If ``-e`` is used, the following sequences are recognized:

- ``\`` backslash

- ``\a`` alert (BEL)

- ``\b`` backspace

- ``\c`` produce no further output

- ``\e`` escape

- ``\f`` form feed

- ``\n`` new line

- ``\r`` carriage return

- ``\t`` horizontal tab

- ``\v`` vertical tab

- ``\0NNN`` byte with octal value NNN (1 to 3 digits)

- ``\xHH`` byte with hexadecimal value HH (1 to 2 digits)

Example
-------

::

   > echo 'Hello World'
   Hello World

   > echo -e 'Top\nBottom'
   Top
   Bottom

   > echo -- -n
   -n

See Also
--------

- the :doc:`printf <printf>` command, for more control over output formatting