llRequestURL

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/fr Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

RequestURL

llRequestURL

Summary

Function: key llRequestURL( );

345	Function ID
0.0	Forced Delay
10.0	Energy

Requests one HTTP:// url for use by this script. The http_request event is triggered with the result of the request.
Returns a key that is the handle used for identifying the result in the http_request event.

Caveats

• When a region is (re)started all HTTP server URLs are automatically released and invalidated.
  • Use CHANGED_REGION_START to detect this so new URL can be requested.
• The number of available URLs is a limited resource, that is to say, a script can only have so many open URLs. See LSL http_server#Resource Limitations for details.
• When abandoning a URL, always release it with llReleaseURL, otherwise it will leak.

All Issues ~ Search JIRA for related Bugs

Examples

Important: Never ever forget to release a URL again which you have requested! URLs are region resources just like prims. If you take them all you can get into big trouble with the sim owner and/or estate managers.

This script requests a new URL after region restart: <lsl> string url; key urlRequestId; key selfCheckRequestId;

request_url() {

   llReleaseURL(url);
   url = "";

   urlRequestId = llRequestURL();

}

throw_exception(string inputString) {

   key owner = llGetOwner();
   llInstantMessage(owner, inputString);

   // yeah, bad way to handle exceptions by restarting.
   // However this is just a demo script...

   llResetScript();

}

default {

   on_rez(integer start_param)
   {
       llResetScript();
   }

   changed(integer change)
   {

if (change & (CHANGED_OWNER

See Also

Functions

•	llRequestSecureURL
•	llGetFreeURLs
•	llReleaseURL
•	llHTTPResponse
•	llGetHTTPHeader

Articles

•

LSL http server

Deep Notes

History

• SVN:1836 r112899 Trunk

Search JIRA for related Issues

Signature
function key llRequestURL();