Difference between revisions of "LlGetInventoryName"

From Second Life Wiki
Jump to navigation Jump to search
m
(12 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{LSL Function/negative_index|false|number}}
{{LSL_Function
{{LSL_Function
|inject-3={{LSL Function/negative_index|false|number}}
|func_id=147|func_sleep=0.0|func_energy=10.0
|func_id=147|func_sleep=0.0|func_energy=10.0
|func=llGetInventoryName|return_type=string
|func=llGetInventoryName|return_type=string
|p1_type=integer|p1_name=type|p1_desc=INVENTORY_* flag
|p1_type=integer|p1_name=type|p1_desc=INVENTORY_* flag
|p2_type=integer|p2_name=number
|p2_type=integer|p2_name=number|p2_desc=Beginning from 0
|func_footnote=Inventory items are sorted in alphabetical order (not chronological order).
|func_footnote=
Inventory items are sorted in alphabetical order (not chronological order).
|func_desc
|func_desc
|return_text=that is the name of the inventory item '''number''' of '''type'''. Returns an empty string if no item of the specified type is found in the prim's inventory (or there are less than or equal to '''number''' items of the type).
|return_text=that is the name of the inventory item {{LSLP|number}} of {{LSLP|type}}. Returns an empty string if no item of the specified type is found in the prim's inventory (or there are less than or equal to {{LSLP|number}} items of the type).
|spec
|spec
|caveats
|caveats
|constants={{LSL Constants Inventory}}
|constants={{LSL Constants Inventory}}
|examples======Will Unpack all items of a box=====
|examples======Box Unpacker=====
<lsl>
<source lang="lsl2">
// script created by SpiritWolf Chikuwa
// Give all prim contents to anyone touching this object,
// minor changes by Strife Onizuka to speed things up
// But don't give this script itself.
//
// /!\ PUBLIC DOMAIN /!\
// You can Copy/Mod/Trans
// Please, do not resell this script and give it full perm
// Just please leave this header intact
//
// Minor changes: (insert your name here and delete this comment if you do any mod of this script, thank you)
//
// Script start here:
 
list    gInventoryList;
 
list getInventoryList()
{
    list      result = [];
    integer    n = llGetInventoryNumber(INVENTORY_ALL);
 
    while(n)
        result = llGetInventoryName(INVENTORY_ALL, --n) + result;
   
    return result;
}


default
default
{
{
     state_entry()
     touch_start(integer num_detected)
     {
     {
         gInventoryList = getInventoryList();
         list    InventoryList;
    }
         integer count = llGetInventoryNumber(INVENTORY_ALL); // Count of all items in prim's contents
 
         string ItemName;
    touch_start( integer n )
         while (count--)
    {
         integer i = 0;
         string folder = llGetObjectName();
 
         while(i < n)
         {
         {
             llGiveInventoryList(llDetectedKey(i), folder, gInventoryList );
             ItemName = llGetInventoryName(INVENTORY_ALL, count);
             ++i;
             if (ItemName != llGetScriptName() ) 
                InventoryList += ItemName;   // add all contents except this script, to a list
         }
         }
    }
        // Give all the items to the toucher, in a folder named as per this prim's name
 
        llGiveInventoryList(llDetectedKey(0), llGetObjectName(), InventoryList);
    changed( integer change )
    {
      if ( change == CHANGED_INVENTORY )
          gInventoryList = getInventoryList();
     }
     }
}
}
 
</source>
// llGetInventory number and name will scan all objects on the box.
// llGiveInventory will give you the content.
// See also llGetInventory and llGiveInventory on LSL Wiki for further informations.
</lsl>
|helpers
|helpers
|also_functions=
|also_functions=
Line 76: Line 43:
{{LSL DefineRow||[[llGetInventoryKey]]|Returns the inventory item's [[UUID]] (if full perm)}}
{{LSL DefineRow||[[llGetInventoryKey]]|Returns the inventory item's [[UUID]] (if full perm)}}
|also_events
|also_events
|also_tests
|also_tests=
{{LSL DefineRow||[[llGiveInventory_All_Test]]|}}
|also_articles
|also_articles
|notes
|notes=The maximum number of characters for an object inventory item is currently 63 characters.
|permission
|permission
|sort=GetInventoryName
|sort=GetInventoryName

Revision as of 01:58, 22 January 2015

Summary

Function: string llGetInventoryName( integer type, integer number );

Returns a string that is the name of the inventory item number of type. Returns an empty string if no item of the specified type is found in the prim's inventory (or there are less than or equal to number items of the type).

• integer type – INVENTORY_* flag
• integer number – Beginning from 0

number does not support negative indexes. Inventory items are sorted in alphabetical order (not chronological order).

Flag Inventory Type
INVENTORY_NONE -1 Item does not exist.
INVENTORY_ALL Any inventory type.
INVENTORY_TEXTURE 0 texture
INVENTORY_SOUND 1 sound
INVENTORY_LANDMARK 3 landmark
INVENTORY_CLOTHING 5 clothing
INVENTORY_OBJECT 6 object
Flag Inventory Type
INVENTORY_NOTECARD 7 notecard
INVENTORY_SCRIPT 10 script
INVENTORY_BODYPART 13 body part
INVENTORY_ANIMATION 20 animation
INVENTORY_GESTURE 21 gesture
INVENTORY_SETTING 56 setting
INVENTORY_MATERIAL 57 material

Caveats

  • If number is out of bounds the script continues to execute without an error message.
All Issues ~ Search JIRA for related Bugs

Examples

Box Unpacker
// Give all prim contents to anyone touching this object,
// But don't give this script itself.

default
{
    touch_start(integer num_detected)
    {
        list    InventoryList;
        integer count = llGetInventoryNumber(INVENTORY_ALL);  // Count of all items in prim's contents
        string  ItemName;
        while (count--)
        {
            ItemName = llGetInventoryName(INVENTORY_ALL, count);
            if (ItemName != llGetScriptName() )  
                InventoryList += ItemName;   // add all contents except this script, to a list
        }
        // Give all the items to the toucher, in a folder named as per this prim's name
        llGiveInventoryList(llDetectedKey(0), llGetObjectName(), InventoryList);
    }
}

Notes

The maximum number of characters for an object inventory item is currently 63 characters.

See Also

Functions

•  llGetInventoryNumber – Returns the number of items of a specific type in inventory
•  llGetInventoryType – Tests to see if an inventory item exists and returns its type.
•  llGetInventoryCreator – Returns the inventory item's creator
•  llGetInventoryPermMask – Returns the inventory item's permissions
•  llGetInventoryKey – Returns the inventory item's UUID (if full perm)

Deep Notes

Search JIRA for related Issues

Tests

•  llGiveInventory_All_Test

Signature

function string llGetInventoryName( integer type, integer number );
Retrieved from "https://wiki.secondlife.com/w/index.php?title=LlGetInventoryName&oldid=1194184"