Difference between revisions of "mirc/commands/echo"

Revision as of 01:55, 6 July 2014

The /echo command prints text to the specified window. This command does not send anything to the server. Text is only shown in your window buffer.

Note: If you use /window -s, line added to the window with /echo won't get sorted.

Synopsis

/echo [color] [-deghiNtsaqlbfnmr] [window] <text>
/echo [color] -c[deghiNtsaqlbfnmr] <color_name> [window] <text>

Switches

-c - Indicates the <color_name> parameter was provided.
-e - Encloses the text with a pair of line separators
-g - Prevents the text from being logged.
-h - Applies a hard-wrap on the text.
-i<N> - Wraps the text by <N> characters.
-t - Adds a timestamp to the text if the timestamp is enabled (global or for that window)
-s - prints to the status window
-a - prints to the active window
-d - prints to the single message window
-q - Honors the $show flag. (If the alias was called with the . prefix)
-n - Prevents switchbar/treebar status color change
-m - Treats the line as user message instead of an event
Settings Related:
-r - Applies the strip settings to the text.
-l - Applies the highlight settings to the text
-b - Applies the beep settings to the window.
-f - Applies the flash settings to the window.

Parameters

[color] - A numeric color value (0 to 15)
<color_name> - Used with the -c switch. One of the following: Action, ctcp, highlight, info, info2, invite, join, part, quit, kick, mode, topic, nick, normal, notice, notify, other, own, wallops, whois
[window] - The target window/channel/query
<text> - The text to be printed

Example

A Hello World example:

/echo -a Hello World!

A simple example of a loop that prints a few lines:

alias example {
  var %x = 5
  while (%x) {
    echo -a This is example line $v1 $+ .
    dec %x
  }
}

The above will print:

This is example line 5.
This is example line 4.
This is example line 3.
This is example line 2.
This is example line 1.

Compatibility

Added: mIRC v3.7
Added on: 12 Oct 1995
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.