libURLFormData

Typefunction
DictionaryLCS
LibraryLiveCode Script
Syntax
libURLFormData(<key1>, <value1> [, <key2>, <value2> ...])
Associationsinternet library
Summary

libURLFormData formats data in the standard format suitable for sending to form processing CGIs and other processes on a web server.

Introduced2.5
OSmac, windows, linux, web
Platformsdesktop, server
Parameters
NameTypeDescription
key1
value1
key2
value2
Example
put "John" into tName
put "Hello" into tMessage
get libURLFormData("name", tName,"message", tMessage)
post it to url "http://www.someserver.com/cgi-bin/form.pl"
-- In this case, the data posted to the url will look like this: name=John&message=Hello
RelatedMessage: openBackground, openStack, startup, preOpenStack, preOpenCard
Command: post, libURLSetExpect100
Function: libURLMultipartFormAddPart, libURLMultipartFormData
Glossary: application, standalone application, function, main stack, keyword, group, Standalone Application Settings, message, handler, LiveCode custom library
Library: Internet library, library
Securitynetwork
Description

The function accepts variable numbers of parameters and treats them as key-value pairs. The first parameter is the name of the first form part, the second the value of the first part, the third is the name of the second part, and so on.

Note: The Content-Type header is set to "Content-Type: application/x-www-form-urlencoded" by default when using post. There is no need to set the httpHeaders unless you have previously set the Content-Type header to something else.

Important: The libURLFormData function is part of the Internet library. To ensure that the function works in a standalone application, you must include this custom library when you create your standalone. In the Inclusions pane of the Standalone Application Settings window, make sure the "Internet" script library is selected.