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
|
<HTML><HEAD>
<TITLE>Tcl API Reference -- ns_get_multipart_formdata</TITLE>
<LINK rel=Previous href="tapi-c59.htm">
<LINK rel=ToC href="toc.htm">
<LINK rel=Index href="master.htm">
<LINK rel=Next href="tapi-c61.htm">
</HEAD><BODY BGCOLOR="#ffffff"><A NAME="topofpage"></A>
<TABLE WIDTH=100%>
<TR>
<TD ALIGN=LEFT>
<A NAME="topofpage"></A> <IMG SRC="as-c-sm.gif">
</TD>
<TD ALIGN=RIGHT>
<A href="tapi-c59.htm"><IMG BORDER="0" src=navbprev.gif alt="[ Previous ]"></A>
<A href=toc.htm> <IMG BORDER="0" src=navbhome.gif alt="[ Contents ]"></A>
<A href=master.htm> <IMG BORDER="0" src=navbhelp.gif alt="[ Index ]"></A>
<A href="tapi-c61.htm"> <IMG BORDER="0" src=navbnext.gif alt="[ Next ]"></A>
<A name="7983"> </A>
</TD>
</TR>
</TABLE>
<a name="148702">
</a><h3>ns_get_multipart_formdata</h3>
<a name="148703">
</a><h4>Overview</h4>
<p><a name="148704">
</a>Handle the POST action of a form containing one Netscape file widget</p>
<a name="148705">
</a><h4>Syntax</h4>
<p><a name="148706">
</a><b>ns_get_multipart_formdata </b><i>key fieldId</i> ?<i>formdataSet</i>?</p>
<a name="148707">
</a><h4>Description</h4>
<p><a name="148927">
</a>If you have a Tcl script that is handling a POST of a form containing <i>exactly one </i>Netscape<i> </i>INPUT TYPE=FILE widget and 0 or more other widgets, you can call <b>ns_get_multipart_formdata</b> instead of <b>ns_conn form</b>. If you call <b>ns_get_multipart_formdata</b> at any other point, it will not work.</p>
<p><a name="148929">
</a>The <i>key</i> argument is the key for the file widget.</p>
<p><a name="148930">
</a>The <i>fileId</i> argument must be the file ID of a file that is open for write operations. <b>ns_get_multipart_formdata</b> will write the submitted file (from the file widget) to the file specified by fileId.</p>
<p><a name="148924">
</a>If you pass a <i>formdataSet</i> into the function, the rest of the form data is dropped into that formdata set.</p>
<a name="148932">
</a><h4>Example</h4>
<p><a name="148937">
</a>In the HTML page, the form is defined as:</p>
<pre> <a name="148938"></a><form enctype=multipart/form-data method=post action=/foo>
<a name="148939"></a><input name=file type=file>
<a name="148940"></a></form>
</pre><p><p><a name="148941">
</a>The POST action is handled by the /foo script defined below:</p>
<pre> <a name="148942"></a>ns_register_proc POST /foo foo
<a name="148943"></a>proc foo {conn ignore} {
<a name="148944"></a> set fp [open "/tmp/uploaded_file" w+]
<a name="148945"></a> ns_get_multipart_formdata "file" $fp
<a name="148946"></a> close $fp
<a name="148947"></a> ## Process file
<a name="148948"></a> ## return something
<a name="148934"></a>}
</pre><p>
<TABLE BORDER="2" CELLPADDING="1" width="100%">
<TR><TD COLSPAN=3><P ALIGN=Center>
<IMG SRC="bluebult.gif">
<A HREF="#topofpage">
<FONT SIZE=-1>Top of Page</FONT></A>
<IMG SRC="bluebult.gif">
</TD></TR>
<TR><TD COLSPAN=3><P ALIGN=Center>
<A href="tapi-c59.htm">
<IMG BORDER="0" src=navbprev.gif alt="[ Previous ]"></A>
<A href=toc.htm>
<IMG BORDER="0" src=navbhome.gif alt="[ Contents ]"></A>
<A href=master.htm>
<IMG BORDER="0" src=navbhelp.gif alt="[ Index ]"></A>
<A href="tapi-c61.htm">
<IMG BORDER="0" src=navbnext.gif alt="[ Next ]"></A>
<BR align=center>
<FONT size=-1>Copyright © 1998-99 America Online,
Inc.</FONT>
</TD></TR></TABLE></BODY></HTML>
|
