<br><font size=2 face="sans-serif">Hi all,</font>
<br>
<br><font size=2 face="sans-serif">A note of warning about using STRTOK_R. Just like STRTOK, STRTOK_R destroys the string being parsed, so if the string is precious, make a copy of it.</font>
<br>
<br><font size=2 face="sans-serif">BTW, I've been using STRTOK_R, STRSEP_R and STRSEP_RS for several years now, on this and other platforms, and have not found a problem. Unlike STRTOK, these functions do not internally save where the parsing has got up to. That's your job. You have to pass the string each time. Harald's example below is a good one.</font>
<br>
<br><font size=2 face="sans-serif">In case you're wondering how they work, let us assume our parse string is ",ABC,,,DEF," and the search string is "-,+" (hyphen comma plus).</font>
<br>
<br><font size=2 face="sans-serif">STRTOK_R will return ABC on the first call, DEF on the second, and either NULL or an empty string on the third. (I've forgotten which one it is, but it's the same as STRTOK.)</font>
<br>
<br><font size=2 face="sans-serif">STRSEP_R (short for STRing SEParator) will return an empty string on the first, third and fourth calls, ABC on the second call, DEF on the fifth call, and either NULL or an empty string on the sixth. In other words, it goes serarator by separator.</font>
<br>
<br><font size=2 face="sans-serif">STRSEP_RS is identical to STRSEP_R, except it also returns the seperator encountered. This can be useful in parsing MicroSoft's CSV structure where a comma can be in the data, and double quotes are added around the whole field. Thus the following is valid</font>
<br><font size=2 face="sans-serif">        111,"2,2",333</font>
<br><font size=2 face="sans-serif">where the first three cells contain 111, 2,2 (2 comma 2) and 333.</font>
<br>
<br><font size=2 face="sans-serif">Enjoy,<br>
Peter S<br>
<br>
Peter Scandrett<br>
Engineering Systems Department<br>
ALSTOM Australia Limited<br>
3 Bridge Street, Pymble, 2073, Australia<br>
Phone (+612) 94 88 49 11<br>
Fax (+612) 94 88 49 00<br>
peter.scandrett@transport.alstom.com</font>
<br>
<br>
<br>
<table width=100%>
<tr valign=top>
<td>
<td><font size=1 face="sans-serif"><b>Harald Kipp <harald.kipp@egnite.de></b></font>
<br><font size=1 face="sans-serif">Sent by: en-nut-discussion-admin@egnite.de</font>
<p><font size=1 face="sans-serif">05-08-2003 07:03 pm</font>
<br><font size=1 face="sans-serif">Please respond to en-nut-discussion</font>
<br>
<td><font size=1 face="Arial">        </font>
<br><font size=1 face="sans-serif">        To:        en-nut-discussion@egnite.de</font>
<br><font size=1 face="sans-serif">        cc:        (bcc: Peter Scandrett/AUMIL01/Transport/ALSTOM)</font>
<br><font size=1 face="sans-serif">        Subject:        Re: [En-Nut-Discussion] any code in lib for parsing POST  tokens in req_query?</font></table>
<br>
<br>
<br><font size=2 face="Courier New">Damian,<br>
<br>
The next release will include a form sample:<br>
<br>
/*<br>
  * CGI Sample: Proccessing a form.<br>
  *<br>
  * This routine must have been registered by NutRegisterCgi() and is<br>
  * automatically called by NutHttpProcessRequest() when the client<br>
  * request the URL 'cgi-bin/form.cgi'.<br>
  *<br>
  * Thanks to Tom Boettger, who provided this sample for ICCAVR.<br>
  */<br>
int ShowForm(FILE * stream, REQUEST * req)<br>
{<br>
     static prog_char html_head[] = "<HTML><BODY><BR><H1>Form <br>
Result</H1><BR><BR>";<br>
     static prog_char html_body[] = "<BR><BR><p><a <br>
href=\"../index.html\">return to main</a></BODY></HTML></p>";<br>
<br>
     NutHttpSendHeaderTop(stream, req, 200, "Ok");<br>
     NutHttpSendHeaderBot(stream, html_mt, -1);<br>
<br>
     /* Send HTML header. */<br>
     fputs_P(html_head, stream);<br>
<br>
     if (req->req_query) {<br>
#ifdef __IMAGECRAFT__<br>
         char *param1;<br>
         char *param2;<br>
         char *param3;<br>
<br>
         /*<br>
          * Extract the parameters. Note, that it is potentially dangerous<br>
          * to use strtok in multithreaded applications. There's no problem<br>
          * here, because we can be sure that there will by no thread switch<br>
          * between the first and the last call to strtok. Otherwise we<br>
          * must use strtok_r().<br>
          */<br>
         param1 = strtok(req->req_query, "=");<br>
         param1 = strtok(NULL, "&");<br>
         param2 = strtok(NULL, "=");<br>
         param2 = strtok(NULL, "&");<br>
         param3 = strtok(NULL, "=");<br>
         param3 = strtok(NULL, "&");<br>
<br>
         /* Send the parameters back to the client. */<br>
         fputs("Param1=", stream);<br>
         fputs(param1, stream);<br>
         fputs("<BR>Param2=", stream);<br>
         fputs(param2, stream);<br>
         fputs("<BR>Param3=", stream);<br>
         fputs(param3, stream);<br>
#else<br>
         /*<br>
          * There's no strtok in the GCC library. So we take the chance to<br>
          * demonstrate Peter Scandrett's strtok_r().<br>
          */<br>
         char *qp;<br>
         char *c[3];<br>
         char *p[3];<br>
         u_char i;<br>
<br>
         /* Extract 3 parameters. */<br>
         qp = req->req_query;<br>
         for(i = 0; i < 3; i++) {<br>
             c[i] = strtok_r(&qp, "=");<br>
             p[i] = strtok_r(&qp, "&");<br>
         }<br>
<br>
         /* Send the parameters back to the client. */<br>
         for(i = 0; i < 3; i++) {<br>
             fprintf_P(stream, PSTR("%s: %s<BR>\r\n"), c[i], p[i]);<br>
         }<br>
#endif<br>
     }<br>
<br>
     fputs_P(html_body, stream);<br>
     fflush(stream);<br>
<br>
     return 0;<br>
}<br>
<br>
_______________________________________________<br>
En-Nut-Discussion mailing list</font>
<br><font size=2 face="Courier New">En-Nut-Discussion@egnite.de<br>
http://www.egnite.de/mailman/listinfo/en-nut-discussion<br>
</font>
<br>
<br>