Paste

3.1.7 Paste

Paste - Paste (insert) text using the system clipboard. Instead of typing the text character by character on the keyboard the command copies it into the clipboard and simulates pressing of Ctrl+V (Command+V on Mac OS X) to trigger the system Paste action. This is much faster than typing the text through Type/Typeline.

The command targets connections which support clipboard operations, such as the Local Desktop one. For other connections, the command silently falls back to the Type command functionality.

SYNOPSIS

paste <text> [wait=<time>] [count=<number>]
* Red colour indicates obligatory parameters

OPTIONS

text

- The text to paste. If the text contains spaces or equal signs '=', it must be enclosed in double-quotes, e.g. "This is a text containing spaces". If you need to include the double-quote character into your text, place a leading backslash before it, e.g. "This is double-quote - \"". If you need to display a backslash followed by a double quote, use '\\"', e.g. "This is a backslash followed by a double quote - \\"".

Supported text characters are subject to limitations applied by the desktop client (protocol). For example, the RFB (VNC) protocol cannot transfer characters outside of the Latin-1 (ISO 8859-1) character set. On the contrary, the native Java client can transfer only characters which can be generated on the local keyboard regardless of the character set they belong to. Read the particular client documentation for more information.

wait=<time>

- Time to wait after the text gets pasted. It has the same effect as if the following command was 'Wait <time>'. The value must be either a number of milliseconds or valid time value.

count=<number>

- How many times the command should be repeated. The default value is 1 (paste just once).

RETURNS

The command returns 0 (zero) on success or 1 when it fails, for example for an I/O error.

EXAMPLES

Paste "hello world!"

-Paste 'hello world!'.