Difference between revisions of "ContentToStringlist (HttpResponse function)"

From m204wiki
Jump to navigation Jump to search
m (1 revision)
Line 1: Line 1:
<span class="pageSubtitle"><section begin=dpl_desc/><section end=dpl_desc/></span>
<span class="pageSubtitle"><section begin=dpl_desc/><section end=dpl_desc/></span>
[[Category:HttpResponse methods|ContentToStringlist function]]
[[Category:HttpResponse methods|ContentToStringlist function]]
Line 8: Line 7:
This method
This method
places into a Stringlist object the content returned
places into a Stringlist object the content returned
from an HTTPRequest Get, Post, or Send method.
from an HTTPRequest <var>[[Get (HttpRequest function)|Get]]</var>, <var>[[Post (HttpRequest function)|Post]]</var>, or <var>[[Send (HttpRequest function)|Send]]</var> method.
ContentToStringlist does the following:
ContentToStringlist does the following:

Revision as of 21:30, 17 June 2011

<section begin=dpl_desc/><section end=dpl_desc/>

ContentToStringlist is a member of the HttpResponse class.

This method places into a Stringlist object the content returned from an HTTPRequest Get, Post, or Send method. ContentToStringlist does the following:

  1. Instantiates a Stringlist object.
  2. Breaks the HTTPRequest returned content into lines by scanning for line-ends.
  3. Translates each line from ASCII to EBCDIC, and places it in its own Stringlist element in the Stringlist it created.
  4. Returns the Stringlist.


%lines = %httpresp:ContentToStringlist

Syntax terms

%lines A Stringlist object.
%httpresp A reference to an HTTPResponse object that was returned by a Get, Post, or Send method of an HTTPRequest object.

Usage Notes

  • No single HTTPResponse content line may exceed 6124 bytes in length (excluding the line end), or the request is cancelled. The scanned-for line-ends are the three typical characters (CRLF, CR, LF).
  • This method is useful when the content returned from the HTTP server is a series of ASCII text lines separated by line-end characters (for example, an HTML document). Accessing such content with the HTTPResponse Content method would leave all the lines in one Longstring, which the application would have to separate into lines using string-handling User Language code.
  • ContentToStringlist is also useful for getting readable output for debugging purposes. For example, you can string together the ContentToStringlist and Print methods:


    The statement above produces much more readable output than this:

    print %myGradeBookResponse:content


The following code prompts for a URL, fetches the page at that URL, places it in a Stringlist using ContentToStringlist, and displays the lines.

begin %HTTPRequest is object HTTPRequest %HTTPResponse is object HTTPResponse %myPage is object Stringlist %i is float %HTTPRequest = new %HTTPRequest:URL = $read('Hey Moe, give me a URL!') %HTTPResponse = %HTTPRequest:Get('XMLCLIENT', 0 ) if ( %httpResponse is null ) then print 'Could not connect' stop end if if ( %HTTPResponse:Code = 200 ) then %myPage = %HTTPResponse:ContentToStringlist print %myPage:Count and 'lines obtained.' for %i from 1 to %myPage:count print 'Line' and %i and ': ' and %myPage:item(%i) at 15 end for else print 'Sorry dude, you got an error: ' and - %HTTPResponse:statusline end if end

See Also

  • For information about returning response contents into a Longstring, see Content.