llGetFreeURLs
function
Function syntax
integer llGetFreeURLs();- Returns
integer- Energy
- 10
Returns an integer that is the number of available URLs. If attached, return the URLs remaining for the owner. Otherwise, return the available URLs for the region.
integer result = llGetFreeURLs();Specification
Section titled “Specification”There is a separate URL limit for the region, and a limit for each agent. The URL limit is the same as the Land Impact limit:
- Agent: 38
- Openspace Sim: 1,250
- Homestead Sim: 5,000
- Full Sim: 20,000
- Mainland Sim: 22,500
- 30k Sim: 30,000
Caveats
Section titled “Caveats”- If called from an attachment, there is no way to get the number of free URLs in the region; it will always return the URL count remaining for the agent.
Examples
Section titled “Examples”This script will say the number of currently available HTTP-In URLs left in the region.
default{ touch_start(integer num_detected) { integer numberOfFreeURLs = llGetFreeURLs();
if (numberOfFreeURLs)9 collapsed lines
{ llSay(0, "There are " + (string)numberOfFreeURLs + " available HTTP-In URLs left in this region."); } else { llSay(0, "WARNING: There are no HTTP-In URLs available anymore."); } }}Example 2
25 collapsed lines
// WARNING://// This script is only for proof-of-concept (demo purposes).// DO NOT use it if you don't have the sim owners and/or// estate managers OK to test this script.// This script can possibly block HTTP communication from and to the sim.// ...bringing down all networked vendors and/or similar machines.//// This script allocates all available URLs.// Deleting the script and/or derezzing the object containing the script,// will release all previously taken URLs.
default{ state_entry() { llRequestURL(); }
http_request(key request_id, string method, string body) { if (method == URL_REQUEST_DENIED) { llSetText("No free URLs!", <1.0, 0.0, 0.0>, 1.0); } else if (method == URL_REQUEST_GRANTED) { llSetText((string)llGetFreeURLs() + " URLs left\n" + body, <1.0, 1.0, 1.0>, 1.0); llRequestURL(); }6 collapsed lines
else if (method == "GET") { llHTTPResponse(id, 200, "Hello there!"); } }}URLs are a finite region resource and should be released when no longer needed.
History
Section titled “History”- SVN:1836 r112899 Trunk
See also
Section titled “See also”Functions
Section titled “Functions”Articles
Section titled “Articles”Original wiki source
Some wiki templates and tables need their original context. View this article on the Second Life Wiki. Technical wording and examples are retained from the source; historical guidance may differ from current behavior.