The posturl( function loads a resource from the internet, with form data.


This function has four parameters:

url – The address of the resource to be loaded, for example "".

dictionary – Dictionary of keys and values to be submitted to the server.

timeout – The maximum number of seconds to wait for a response from the server. This parameter is optional, if omitted, the default timeout is 60 seconds.

cachepolicy – The cache policy to use for loading this resource. This parameter is optional, if omitted, the default cache policy will be used (0). If you want to ignore the cache and always go to the server, set the cache policy to 1. If you want to get hardcore and find out about other options, google NSURLRequestCachePolicy. For almost all operations, the default policy is the way to go.


This function loads a resource from the internet using HTTP POST (to make a HTTP GET request use the loadurl( function). In addition to the url itself, you can use a dictionary to supply one or more post arguments. These allow you to post data that would normally be supplied by an HTML form. In this example, two values are posted, Name and Email.

displaydata posturl("",
    initializedictionary("Name","John Smith","Email",""))

This function returns whatever data the server responds with, usually HTML text.

Note: The url function can perform the exact same operation as the posturl( function, but with more flexible options. We recommend using the url function for new code.

Note: The posturl( function is synchronous. This means that Panorama stops in its tracks until the communication is complete, so you should avoid this function if possible and use urltask( instead.

See Also


10.0NewNew in this version (though of course previous versions had a statement to do this, which is still available).