GetNextItemProperty

GetNextItemProperty(object)

Determines the next itemproperty on an item

itemproperty GetNextItemProperty(
    object oItem
);

Parameters

oItem

Item to get the itemproperty from

Description

Will keep retrieving the next and the next item property on an Item,
will return an invalid item property when the list is empty.

Remarks

Used together with GetFirstItemProperty and GetIsItemPropertyValid, this can be used to loop through an item's properties.

Thus, it does with itemproperties what GetNextEffect does with effects and GetNextItemInInventory does with items.

Version

1.61

Example

//Remove true seeing from the entering PC's headgear
 
void main()
{
//Entering object
object oPC=GetEnteringObject();
 
//Only PCs
if (!GetIsPC(oPC)) return;
 
//That PC's helmet
object oItem=GetItemInSlot(INVENTORY_SLOT_HEAD, oPC);
 
//Stop script if the PC had no helmet on
if (!GetIsObjectValid(oItem)) return;
 
//Get the first itemproperty on the helmet
itemproperty ipLoop=GetFirstItemProperty(oItem);
 
//Loop for as long as the ipLoop variable is valid
while (GetIsItemPropertyValid(ipLoop))
   {
   //If ipLoop is a true seeing property, remove it
   if (GetItemPropertyType(ipLoop)==ITEM_PROPERTY_TRUE_SEEING)
      RemoveItemProperty(oItem, ipLoop);
 
   //Next itemproperty on the list...
   ipLoop=GetNextItemProperty(oItem);
   }
}

See Also

functions:

RemoveItemProperty

---

 author: Lilac Soul