macro/command/dispstr.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
  "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  <title>dispstr</title>
  <meta http-equiv="Content-Style-Type" content="text/css">
  <link rel="stylesheet" href="../../style.css" type="text/css">
</head>

<body>


<h1>dispstr</h1>

<p>
Displays character on the client terminal screen. <em>(version 4.67 or later)</em>
</p>

<pre class="macro-syntax">
dispstr &lt;data1&gt; [&lt;data2&gt;....]
</pre>

<h2>Remarks</h2>

<p>
Causes Tera Term to display characters on the client terminal screen.<br>
If the &lt;data&gt; is a string type, the string is directly displayed on the terminal screen. <br>
If the &lt;data&gt; is an integer type, its lowest-order byte (0-255) is regarded as an ASCII code of the character, and the corresponding character is displayed on the terminal screen.
</p>

<h2>Example</h2>

<pre class="macro-example">
dispstr 'ABC'

; Display "ABC". (ASCII code of the character "A" is 65.)
dispstr  65 66 67
myname='Tera Term'
dispstr 'My name is ' myname '.'

; Clear your terminal screen by using the escape sequence.
dispstr #$1B"[2J"

; Display "Message" string along the X=20, Y=10 coordinate in your terminal screen.
dispstr #$1B"[10;20HMessage"

; Move your terminal screen to the X=100, Y=200 coordinate in the desktop.
dispstr #$1B"[3;100;200t"
</pre>

<pre class="macro-example">
; Change terminal size to 80x24
dispstr #$1b"[8;24;80t"
 
; demo
for y 24 30
  x = 80
  while x &lt; 100
    sprintf #$1b"[8;%d;%dt" y x
    dispstr inputstr
    x = x + 5
    pause 1
  endwhile
next 
</pre>

<pre class="macro-example">
connect '/C=1'
if result == 1 then
  dispstr 'Error opening COM1'   ; Command error because of not connection.
elseif result == 2 then
  dispstr 'Successfully opened COM1'
endif
end
</pre>

<h2>Note</h2>

<p>
The remote host can not recognize the dispstr output data. So, the terminal screen may not display properly because the buffer of the terminal screen differs from the remote host screen.
</p>

<p>
When Tera Term does not connect to the host, this macro command can not be executed.
</p>

</body>
</html>