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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<link rel="STYLESHEET" href="modpython.css" type='text/css'>
<link rel="first" href="modpython.html" title='Mod_python Manual'>
<link rel='contents' href='contents.html' title="Contents">
<link rel='index' href='genindex.html' title='Index'>
<link rel='last' href='about.html' title='About this document...'>
<link rel='help' href='about.html' title='About this document...'>
<LINK REL="next" href="pyapi-mpconn-mem.html">
<LINK REL="prev" href="pyapi-mpconn.html">
<LINK REL="parent" href="pyapi-mpconn.html">
<LINK REL="next" href="pyapi-mpconn-mem.html">
<meta name='aesop' content='information'>
<META NAME="description" CONTENT="Connection Methods">
<META NAME="keywords" CONTENT="modpython">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<title>4.5.4.1 Connection Methods</title>
</head>
<body>
<DIV CLASS="navigation">
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td><a rel="prev" title="4.5.4 Connection Object (mp_conn) "
href="pyapi-mpconn.html"><img src='previous.gif'
border='0' height='32' alt='Previous Page' width='32'></A></td>
<td><a rel="parent" title="4.5.4 Connection Object (mp_conn) "
href="pyapi-mpconn.html"><img src='up.gif'
border='0' height='32' alt='Up One Level' width='32'></A></td>
<td><a rel="next" title="4.5.4.2 Connection Members"
href="pyapi-mpconn-mem.html"><img src='next.gif'
border='0' height='32' alt='Next Page' width='32'></A></td>
<td align="center" width="100%">Mod_python Manual</td>
<td><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.gif'
border='0' height='32' alt='Contents' width='32'></A></td>
<td><img src='blank.gif'
border='0' height='32' alt='' width='32'></td>
<td><a rel="index" title="Index"
href="genindex.html"><img src='index.gif'
border='0' height='32' alt='Index' width='32'></A></td>
</tr></table>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="pyapi-mpconn.html">4.5.4 Connection Object (mp_conn) </A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="pyapi-mpconn.html">4.5.4 Connection Object (mp_conn) </A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="pyapi-mpconn-mem.html">4.5.4.2 Connection Members</A>
<br><hr>
</DIV>
<!--End of Navigation Panel-->
<H3><A NAME="SECTION006541000000000000000"> </A>
<BR>
4.5.4.1 Connection Methods
</H3>
<P>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
<td><nobr><b><a name="l2h-131"><tt class="method">read</tt></a></b>(</nobr></td>
<td><big>[</big><var>length</var><big>]</big>)</td></tr></table>
<dd>
Reads at most <var>length</var> bytes from the client. The read blocks
indefinitely until there is at least one byte to read. If length is
-1, keep reading until the socket is closed from the other end (This
is known as <code>EXHAUSTIVE</code> mode in the http server code).
<P>
This method should only be used inside <i>Connection Handlers</i>.
<P>
<div class="note"><b class="label">Note:</b>
The behaviour of this method has changed since version 3.0.3. In
3.0.3 and prior, this method would block until <var>length</var> bytes
was read.
</div>
<P>
</dl>
<P>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
<td><nobr><b><a name="l2h-132"><tt class="method">readline</tt></a></b>(</nobr></td>
<td><big>[</big><var>length</var><big>]</big>)</td></tr></table>
<dd>
<P>
Reads a line from the connection or up to <var>length</var> bytes.
<P>
This method should only be used inside <i>Connection Handlers</i>.
<P>
</dl>
<P>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
<td><nobr><b><a name="l2h-133"><tt class="method">write</tt></a></b>(</nobr></td>
<td><var>string</var>)</td></tr></table>
<dd>
<P>
Writes <var>string</var> to the client.
<P>
This method should only be used inside <i>Connection Handlers</i>.
<P>
</dl>
<P>
<DIV CLASS="navigation">
<p><hr>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td><a rel="prev" title="4.5.4 Connection Object (mp_conn) "
rel="prev" title="4.5.4 Connection Object (mp_conn) "
href="pyapi-mpconn.html"><img src='previous.gif'
border='0' height='32' alt='Previous Page' width='32'></A></td>
<td><a rel="parent" title="4.5.4 Connection Object (mp_conn) "
rel="parent" title="4.5.4 Connection Object (mp_conn) "
href="pyapi-mpconn.html"><img src='up.gif'
border='0' height='32' alt='Up One Level' width='32'></A></td>
<td><a rel="next" title="4.5.4.2 Connection Members"
rel="next" title="4.5.4.2 Connection Members"
href="pyapi-mpconn-mem.html"><img src='next.gif'
border='0' height='32' alt='Next Page' width='32'></A></td>
<td align="center" width="100%">Mod_python Manual</td>
<td><a rel="contents" title="Table of Contents"
rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.gif'
border='0' height='32' alt='Contents' width='32'></A></td>
<td><img src='blank.gif'
border='0' height='32' alt='' width='32'></td>
<td><a rel="index" title="Index"
rel="index" title="Index"
href="genindex.html"><img src='index.gif'
border='0' height='32' alt='Index' width='32'></A></td>
</tr></table>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="pyapi-mpconn.html">4.5.4 Connection Object (mp_conn) </A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="pyapi-mpconn.html">4.5.4 Connection Object (mp_conn) </A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="pyapi-mpconn-mem.html">4.5.4.2 Connection Members</A>
<hr>
<span class="release-info">Release 3.2.10, documentation updated on July 19, 2006.</span>
</DIV>
<!--End of Navigation Panel-->
</BODY>
</HTML>
|
