set-query-param ( url value key -- url )

set-query-param ( url value key -- url )
Furnace framework » URL objects

Prev:	query-param ( url key -- value )
Next:	url-addr ( url -- addr )

Vocabulary
urls

Inputs

url	an url
value	an object
key	a string

Outputs

url

an url

Word description
Sets a query parameter. The value can be any object supported by present, or f, in which case the key is removed.

Notes
This word always returns the same URL object that was input. This allows for a ``pipeline'' coding style, where several query parameters are set in a row. Since it mutates the input object, you must clone it first if it is literal, as in the below example.

Examples

USING: kernel http.client urls ; URL" http://search.yahooapis.com/WebSearchService/V1/webSearch" clone "concatenative programming (NSFW)" "query" set-query-param "1" "adult_ok" set-query-param http-get

(For a complete Yahoo! search web service implementation, see the yahoo vocabulary.)

Side effects
Modifies url

Definition

USING: accessors kernel linked-assocs ;

IN: urls

: set-query-param ( url value key -- url )
pick query>> [ <linked-hash> ] unless*
[ set-or-delete ] keep >>query ;