Difference between revisions of "LlBreakAllLinks"

Revision as of 00:22, 27 November 2007

Function: llBreakAllLinks( );

Delinks all prims in the link set.

To run this function the script must request the PERMISSION_CHANGE_LINKS permission with llRequestPermissions and it must be granted by the owner.

Do not depend upon the auto-grant status of permissions. Always use the run_time_permissions event.
If the script lacks the permission PERMISSION_CHANGE_LINKS, the script will shout an error on DEBUG_CHANNEL and the operation fails (but the script continues to run).
If PERMISSION_CHANGE_LINKS is granted by anyone other than the owner, then when the function is called an error will be shouted on DEBUG_CHANNEL.

Once the PERMISSION_CHANGE_LINKS permission is granted there is no way to revoke it except from inside the script (for example, with a new llRequestPermissions call) or the script is reset or deleted.

Signature
function void llBreakAllLinks();

@@ Line 3: / Line 3: @@
 |func_id=143|func_sleep=0.0|func_energy=10.0
 |func=llBreakAllLinks
-|func_desc=Delinks all tasks in the link set.
+|func_desc=Delinks all prims in the link set.
 |func_footnote
 |return_text
@@ Line 9: / Line 9: @@
 |caveats
 |constants
-|examples=
+|examples
-<pre>
-// Makes the object explode if there are more than 5 (or so) links.
-// If there are more than 200 links this will cause the region to slow down A LOT.
-// Useful if you want vehicles to explode when being shot at.
-// This script assumes that the user already has PERMISSION_CHANGE_LINKS.
-// If it does not, THIS SCRIPT WILL FAIL!
-default {
-     state_entry() {
-          llSetStatus(STATUS_PHYSICS, 1); //Make it physical, if it isn't already.
-          llBreakAllLinks(); //KA-BOOM!
-          llRemoveInventory(llGetScriptName()); //Delete this script.
-     }
-}
-</pre>
 |helpers
 |also_functions={{LSL DefineRow||[[llBreakLink]]|Break a link}}

•	llGetPermissions	–	Get the permissions granted
•	llGetPermissionsKey	–	Get the agent who granted permissions
•	llRequestPermissions	–	Request permissions
•	llBreakLink	–	Break a link
•	llCreateLink	–	Link to another object