~ubuntu-branches/ubuntu/quantal/pexpect/quantal

« back to all changes in this revision

Viewing changes to doc/screen.html

  • Committer: Package Import Robot
  • Author(s): Arthur de Jong, Arthur de Jong, Piotr Ożarowski, Sandro Tosi, Carlos Galisteo
  • Date: 2012-03-09 11:43:41 UTC
  • mfrom: (2.1.4 sid)
  • Revision ID: package-import@ubuntu.com-20120309114341-tyl62gut4noubs1g
Tags: 2.4-1
* Team upload.

[ Arthur de Jong ]
* New upstream release (Closes: #609195).
* Switch to 3.0 (quilt) source format.
* Switch to dh-style debian/rules.
* Moved packaging from python-central to dh_python2 (Closes: #616935,
  LP: #788514).
* Drop Conflicts/Replaces on ancient versions which shipped in sarge.
* Bump standards-version to 3.9.3.
* Register documentation with doc-base.
* Update debian/copyright (license is actually MIT instead of Python 2.3).
* Fix syntax errors in one of the examples (closes: #580271)

[ Piotr Ożarowski ]
* Added Vcs-Svn and Vcs-Browser fields

[ Sandro Tosi ]
* debian/control
  - uniforming Vcs-Browser field
* debian/control
  - switch Vcs-Browser field to viewsvn

[ Carlos Galisteo ]
* debian/control
  - Added Homepage field.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
 
2
 
<!doctype html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
3
 
<html><head><title>Python: module screen</title>
4
 
</head><body bgcolor="#f0f0f8">
5
 
 
6
 
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
7
 
<tr bgcolor="#7799ee">
8
 
<td valign=bottom>&nbsp;<br>
9
 
<font color="#ffffff" face="helvetica, arial">&nbsp;<br><big><big><strong>screen</strong></big></big></font></td
10
 
><td align=right valign=bottom
11
 
><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/home/noah/pexpect/trunk/pexpect/screen.py">/home/noah/pexpect/trunk/pexpect/screen.py</a></font></td></tr></table>
12
 
    <p><tt>This&nbsp;implements&nbsp;a&nbsp;virtual&nbsp;<a href="#screen">screen</a>.&nbsp;This&nbsp;is&nbsp;used&nbsp;to&nbsp;support&nbsp;ANSI&nbsp;terminal<br>
13
 
emulation.&nbsp;The&nbsp;<a href="#screen">screen</a>&nbsp;representation&nbsp;and&nbsp;state&nbsp;is&nbsp;implemented&nbsp;in&nbsp;this&nbsp;class.<br>
14
 
Most&nbsp;of&nbsp;the&nbsp;methods&nbsp;are&nbsp;inspired&nbsp;by&nbsp;ANSI&nbsp;<a href="#screen">screen</a>&nbsp;control&nbsp;codes.&nbsp;The&nbsp;ANSI&nbsp;class<br>
15
 
extends&nbsp;this&nbsp;class&nbsp;to&nbsp;add&nbsp;parsing&nbsp;of&nbsp;ANSI&nbsp;escape&nbsp;codes.<br>
16
 
&nbsp;<br>
17
 
$Id:&nbsp;<a href="#screen">screen</a>.py&nbsp;486&nbsp;2007-07-13&nbsp;01:04:16Z&nbsp;noah&nbsp;$</tt></p>
18
 
<p>
19
 
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
20
 
<tr bgcolor="#aa55cc">
21
 
<td colspan=3 valign=bottom>&nbsp;<br>
22
 
<font color="#fffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
23
 
    
24
 
<tr><td bgcolor="#aa55cc"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
25
 
<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="copy.html">copy</a><br>
26
 
</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
27
 
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
28
 
<tr bgcolor="#ee77aa">
29
 
<td colspan=3 valign=bottom>&nbsp;<br>
30
 
<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
31
 
    
32
 
<tr><td bgcolor="#ee77aa"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
33
 
<td width="100%"><dl>
34
 
<dt><font face="helvetica, arial"><a href="screen.html#screen">screen</a>
35
 
</font></dt></dl>
36
 
 <p>
37
 
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
38
 
<tr bgcolor="#ffc8d8">
39
 
<td colspan=3 valign=bottom>&nbsp;<br>
40
 
<font color="#000000" face="helvetica, arial"><a name="screen">class <strong>screen</strong></a></font></td></tr>
41
 
    
42
 
<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;</tt></td>
43
 
<td colspan=2><tt>This&nbsp;object&nbsp;maintains&nbsp;the&nbsp;state&nbsp;of&nbsp;a&nbsp;virtual&nbsp;text&nbsp;<a href="#screen">screen</a>&nbsp;as&nbsp;a<br>
44
 
rectangluar&nbsp;array.&nbsp;This&nbsp;maintains&nbsp;a&nbsp;virtual&nbsp;cursor&nbsp;position&nbsp;and&nbsp;handles<br>
45
 
scrolling&nbsp;as&nbsp;characters&nbsp;are&nbsp;added.&nbsp;This&nbsp;supports&nbsp;most&nbsp;of&nbsp;the&nbsp;methods&nbsp;needed<br>
46
 
by&nbsp;an&nbsp;ANSI&nbsp;text&nbsp;<a href="#screen">screen</a>.&nbsp;Row&nbsp;and&nbsp;column&nbsp;indexes&nbsp;are&nbsp;1-based&nbsp;(not&nbsp;zero-based,<br>
47
 
like&nbsp;arrays).<br>&nbsp;</tt></td></tr>
48
 
<tr><td>&nbsp;</td>
49
 
<td width="100%">Methods defined here:<br>
50
 
<dl><dt><a name="screen-__init__"><strong>__init__</strong></a>(self, r<font color="#909090">=24</font>, c<font color="#909090">=80</font>)</dt><dd><tt>This&nbsp;initializes&nbsp;a&nbsp;blank&nbsp;scree&nbsp;of&nbsp;the&nbsp;given&nbsp;dimentions.</tt></dd></dl>
51
 
 
52
 
<dl><dt><a name="screen-__str__"><strong>__str__</strong></a>(self)</dt><dd><tt>This&nbsp;returns&nbsp;a&nbsp;printable&nbsp;representation&nbsp;of&nbsp;the&nbsp;<a href="#screen">screen</a>.&nbsp;The&nbsp;end&nbsp;of<br>
53
 
each&nbsp;<a href="#screen">screen</a>&nbsp;line&nbsp;is&nbsp;terminated&nbsp;by&nbsp;a&nbsp;newline.</tt></dd></dl>
54
 
 
55
 
<dl><dt><a name="screen-clear_all_tabs"><strong>clear_all_tabs</strong></a>(self)</dt><dd><tt>Clears&nbsp;all&nbsp;tabs.</tt></dd></dl>
56
 
 
57
 
<dl><dt><a name="screen-clear_tab"><strong>clear_tab</strong></a>(self)</dt><dd><tt>Clears&nbsp;tab&nbsp;at&nbsp;the&nbsp;current&nbsp;position.</tt></dd></dl>
58
 
 
59
 
<dl><dt><a name="screen-cr"><strong>cr</strong></a>(self)</dt><dd><tt>This&nbsp;moves&nbsp;the&nbsp;cursor&nbsp;to&nbsp;the&nbsp;beginning&nbsp;(col&nbsp;1)&nbsp;of&nbsp;the&nbsp;current&nbsp;row.</tt></dd></dl>
60
 
 
61
 
<dl><dt><a name="screen-crlf"><strong>crlf</strong></a>(self)</dt><dd><tt>This&nbsp;advances&nbsp;the&nbsp;cursor&nbsp;with&nbsp;CRLF&nbsp;properties.<br>
62
 
The&nbsp;cursor&nbsp;will&nbsp;line&nbsp;wrap&nbsp;and&nbsp;the&nbsp;<a href="#screen">screen</a>&nbsp;may&nbsp;scroll.</tt></dd></dl>
63
 
 
64
 
<dl><dt><a name="screen-cursor_back"><strong>cursor_back</strong></a>(self, count<font color="#909090">=1</font>)</dt></dl>
65
 
 
66
 
<dl><dt><a name="screen-cursor_constrain"><strong>cursor_constrain</strong></a>(self)</dt><dd><tt>This&nbsp;keeps&nbsp;the&nbsp;cursor&nbsp;within&nbsp;the&nbsp;<a href="#screen">screen</a>&nbsp;area.</tt></dd></dl>
67
 
 
68
 
<dl><dt><a name="screen-cursor_down"><strong>cursor_down</strong></a>(self, count<font color="#909090">=1</font>)</dt></dl>
69
 
 
70
 
<dl><dt><a name="screen-cursor_force_position"><strong>cursor_force_position</strong></a>(self, r, c)</dt><dd><tt>Identical&nbsp;to&nbsp;Cursor&nbsp;Home.</tt></dd></dl>
71
 
 
72
 
<dl><dt><a name="screen-cursor_forward"><strong>cursor_forward</strong></a>(self, count<font color="#909090">=1</font>)</dt></dl>
73
 
 
74
 
<dl><dt><a name="screen-cursor_home"><strong>cursor_home</strong></a>(self, r<font color="#909090">=1</font>, c<font color="#909090">=1</font>)</dt></dl>
75
 
 
76
 
<dl><dt><a name="screen-cursor_restore_attrs"><strong>cursor_restore_attrs</strong></a>(self)</dt><dd><tt>Restores&nbsp;cursor&nbsp;position&nbsp;after&nbsp;a&nbsp;Save&nbsp;Cursor.</tt></dd></dl>
77
 
 
78
 
<dl><dt><a name="screen-cursor_save"><strong>cursor_save</strong></a>(self)</dt><dd><tt>Save&nbsp;current&nbsp;cursor&nbsp;position.</tt></dd></dl>
79
 
 
80
 
<dl><dt><a name="screen-cursor_save_attrs"><strong>cursor_save_attrs</strong></a>(self)</dt><dd><tt>Save&nbsp;current&nbsp;cursor&nbsp;position.</tt></dd></dl>
81
 
 
82
 
<dl><dt><a name="screen-cursor_unsave"><strong>cursor_unsave</strong></a>(self)</dt><dd><tt>Restores&nbsp;cursor&nbsp;position&nbsp;after&nbsp;a&nbsp;Save&nbsp;Cursor.</tt></dd></dl>
83
 
 
84
 
<dl><dt><a name="screen-cursor_up"><strong>cursor_up</strong></a>(self, count<font color="#909090">=1</font>)</dt></dl>
85
 
 
86
 
<dl><dt><a name="screen-cursor_up_reverse"><strong>cursor_up_reverse</strong></a>(self)</dt></dl>
87
 
 
88
 
<dl><dt><a name="screen-dump"><strong>dump</strong></a>(self)</dt><dd><tt>This&nbsp;returns&nbsp;a&nbsp;copy&nbsp;of&nbsp;the&nbsp;<a href="#screen">screen</a>&nbsp;as&nbsp;a&nbsp;string.&nbsp;This&nbsp;is&nbsp;similar&nbsp;to<br>
89
 
__str__&nbsp;except&nbsp;that&nbsp;lines&nbsp;are&nbsp;not&nbsp;terminated&nbsp;with&nbsp;line&nbsp;feeds.</tt></dd></dl>
90
 
 
91
 
<dl><dt><a name="screen-erase_down"><strong>erase_down</strong></a>(self)</dt><dd><tt>Erases&nbsp;the&nbsp;<a href="#screen">screen</a>&nbsp;from&nbsp;the&nbsp;current&nbsp;line&nbsp;down&nbsp;to&nbsp;the&nbsp;bottom&nbsp;of&nbsp;the<br>
92
 
<a href="#screen">screen</a>.</tt></dd></dl>
93
 
 
94
 
<dl><dt><a name="screen-erase_end_of_line"><strong>erase_end_of_line</strong></a>(self)</dt><dd><tt>Erases&nbsp;from&nbsp;the&nbsp;current&nbsp;cursor&nbsp;position&nbsp;to&nbsp;the&nbsp;end&nbsp;of&nbsp;the&nbsp;current<br>
95
 
line.</tt></dd></dl>
96
 
 
97
 
<dl><dt><a name="screen-erase_line"><strong>erase_line</strong></a>(self)</dt><dd><tt>Erases&nbsp;the&nbsp;entire&nbsp;current&nbsp;line.</tt></dd></dl>
98
 
 
99
 
<dl><dt><a name="screen-erase_screen"><strong>erase_screen</strong></a>(self)</dt><dd><tt>Erases&nbsp;the&nbsp;<a href="#screen">screen</a>&nbsp;with&nbsp;the&nbsp;background&nbsp;color.</tt></dd></dl>
100
 
 
101
 
<dl><dt><a name="screen-erase_start_of_line"><strong>erase_start_of_line</strong></a>(self)</dt><dd><tt>Erases&nbsp;from&nbsp;the&nbsp;current&nbsp;cursor&nbsp;position&nbsp;to&nbsp;the&nbsp;start&nbsp;of&nbsp;the&nbsp;current<br>
102
 
line.</tt></dd></dl>
103
 
 
104
 
<dl><dt><a name="screen-erase_up"><strong>erase_up</strong></a>(self)</dt><dd><tt>Erases&nbsp;the&nbsp;<a href="#screen">screen</a>&nbsp;from&nbsp;the&nbsp;current&nbsp;line&nbsp;up&nbsp;to&nbsp;the&nbsp;top&nbsp;of&nbsp;the<br>
105
 
<a href="#screen">screen</a>.</tt></dd></dl>
106
 
 
107
 
<dl><dt><a name="screen-fill"><strong>fill</strong></a>(self, ch<font color="#909090">=' '</font>)</dt></dl>
108
 
 
109
 
<dl><dt><a name="screen-fill_region"><strong>fill_region</strong></a>(self, rs, cs, re, ce, ch<font color="#909090">=' '</font>)</dt></dl>
110
 
 
111
 
<dl><dt><a name="screen-get"><strong>get</strong></a>(self)</dt></dl>
112
 
 
113
 
<dl><dt><a name="screen-get_abs"><strong>get_abs</strong></a>(self, r, c)</dt></dl>
114
 
 
115
 
<dl><dt><a name="screen-get_region"><strong>get_region</strong></a>(self, rs, cs, re, ce)</dt><dd><tt>This&nbsp;returns&nbsp;a&nbsp;list&nbsp;of&nbsp;lines&nbsp;representing&nbsp;the&nbsp;region.</tt></dd></dl>
116
 
 
117
 
<dl><dt><a name="screen-insert"><strong>insert</strong></a>(self, ch)</dt></dl>
118
 
 
119
 
<dl><dt><a name="screen-insert_abs"><strong>insert_abs</strong></a>(self, r, c, ch)</dt><dd><tt>This&nbsp;inserts&nbsp;a&nbsp;character&nbsp;at&nbsp;(r,c).&nbsp;Everything&nbsp;under<br>
120
 
and&nbsp;to&nbsp;the&nbsp;right&nbsp;is&nbsp;shifted&nbsp;right&nbsp;one&nbsp;character.<br>
121
 
The&nbsp;last&nbsp;character&nbsp;of&nbsp;the&nbsp;line&nbsp;is&nbsp;lost.</tt></dd></dl>
122
 
 
123
 
<dl><dt><a name="screen-lf"><strong>lf</strong></a>(self)</dt><dd><tt>This&nbsp;moves&nbsp;the&nbsp;cursor&nbsp;down&nbsp;with&nbsp;scrolling.</tt></dd></dl>
124
 
 
125
 
<dl><dt><a name="screen-newline"><strong>newline</strong></a>(self)</dt><dd><tt>This&nbsp;is&nbsp;an&nbsp;alias&nbsp;for&nbsp;<a href="#screen-crlf">crlf</a>().</tt></dd></dl>
126
 
 
127
 
<dl><dt><a name="screen-pretty"><strong>pretty</strong></a>(self)</dt><dd><tt>This&nbsp;returns&nbsp;a&nbsp;copy&nbsp;of&nbsp;the&nbsp;<a href="#screen">screen</a>&nbsp;as&nbsp;a&nbsp;string&nbsp;with&nbsp;an&nbsp;ASCII&nbsp;text&nbsp;box<br>
128
 
around&nbsp;the&nbsp;<a href="#screen">screen</a>&nbsp;border.&nbsp;This&nbsp;is&nbsp;similar&nbsp;to&nbsp;__str__&nbsp;except&nbsp;that&nbsp;it<br>
129
 
adds&nbsp;a&nbsp;box.</tt></dd></dl>
130
 
 
131
 
<dl><dt><a name="screen-put"><strong>put</strong></a>(self, ch)</dt><dd><tt>This&nbsp;puts&nbsp;a&nbsp;characters&nbsp;at&nbsp;the&nbsp;current&nbsp;cursor&nbsp;position.</tt></dd></dl>
132
 
 
133
 
<dl><dt><a name="screen-put_abs"><strong>put_abs</strong></a>(self, r, c, ch)</dt><dd><tt>Screen&nbsp;array&nbsp;starts&nbsp;at&nbsp;1&nbsp;index.</tt></dd></dl>
134
 
 
135
 
<dl><dt><a name="screen-scroll_constrain"><strong>scroll_constrain</strong></a>(self)</dt><dd><tt>This&nbsp;keeps&nbsp;the&nbsp;scroll&nbsp;region&nbsp;within&nbsp;the&nbsp;<a href="#screen">screen</a>&nbsp;region.</tt></dd></dl>
136
 
 
137
 
<dl><dt><a name="screen-scroll_down"><strong>scroll_down</strong></a>(self)</dt><dd><tt>Scroll&nbsp;display&nbsp;down&nbsp;one&nbsp;line.</tt></dd></dl>
138
 
 
139
 
<dl><dt><a name="screen-scroll_screen"><strong>scroll_screen</strong></a>(self)</dt><dd><tt>Enable&nbsp;scrolling&nbsp;for&nbsp;entire&nbsp;display.</tt></dd></dl>
140
 
 
141
 
<dl><dt><a name="screen-scroll_screen_rows"><strong>scroll_screen_rows</strong></a>(self, rs, re)</dt><dd><tt>Enable&nbsp;scrolling&nbsp;from&nbsp;row&nbsp;{start}&nbsp;to&nbsp;row&nbsp;{end}.</tt></dd></dl>
142
 
 
143
 
<dl><dt><a name="screen-scroll_up"><strong>scroll_up</strong></a>(self)</dt><dd><tt>Scroll&nbsp;display&nbsp;up&nbsp;one&nbsp;line.</tt></dd></dl>
144
 
 
145
 
<dl><dt><a name="screen-set_tab"><strong>set_tab</strong></a>(self)</dt><dd><tt>Sets&nbsp;a&nbsp;tab&nbsp;at&nbsp;the&nbsp;current&nbsp;position.</tt></dd></dl>
146
 
 
147
 
</td></tr></table></td></tr></table><p>
148
 
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
149
 
<tr bgcolor="#eeaa77">
150
 
<td colspan=3 valign=bottom>&nbsp;<br>
151
 
<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
152
 
    
153
 
<tr><td bgcolor="#eeaa77"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
154
 
<td width="100%"><dl><dt><a name="-constrain"><strong>constrain</strong></a>(n, min, max)</dt><dd><tt>This&nbsp;returns&nbsp;a&nbsp;number,&nbsp;n&nbsp;constrained&nbsp;to&nbsp;the&nbsp;min&nbsp;and&nbsp;max&nbsp;bounds.</tt></dd></dl>
155
 
</td></tr></table><p>
156
 
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
157
 
<tr bgcolor="#55aa55">
158
 
<td colspan=3 valign=bottom>&nbsp;<br>
159
 
<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
160
 
    
161
 
<tr><td bgcolor="#55aa55"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
162
 
<td width="100%"><strong>BEL</strong> = 7<br>
163
 
<strong>BS</strong> = 8<br>
164
 
<strong>CAN</strong> = 24<br>
165
 
<strong>CR</strong> = 13<br>
166
 
<strong>DEL</strong> = 127<br>
167
 
<strong>ENQ</strong> = 5<br>
168
 
<strong>ESC</strong> = 27<br>
169
 
<strong>FF</strong> = 12<br>
170
 
<strong>HT</strong> = 9<br>
171
 
<strong>LF</strong> = 10<br>
172
 
<strong>NUL</strong> = 0<br>
173
 
<strong>SI</strong> = 15<br>
174
 
<strong>SO</strong> = 14<br>
175
 
<strong>SPACE</strong> = ' '<br>
176
 
<strong>SUB</strong> = 26<br>
177
 
<strong>VT</strong> = 11<br>
178
 
<strong>XOFF</strong> = 19<br>
179
 
<strong>XON</strong> = 17</td></tr></table>
180
 
</body></html>
 
 
b'\\ No newline at end of file'