TStringHashList.Insert

Stores a hash item at the specified position in the container.

Declaration

Source position: stringhashlist.pas line 56

Arguments

Description

Insert is a method used to store the pointer in Item to the internal storage in List. Insert re-allocates the memory used for List to include the addition space needed for the new item.

Index contains the ordinal position in List where the PStringHashItem instance is stored. Index must be in the range 0..Count. When Index has the value in Count, Insert behaves like an Append operation in the List. The value Index is adjusted if it exceeds either range limit.

When Index is not the newly added position (Count), the memory for existing entries in List are shifted upward by the size of the hash item in Item. The pointer in Item is stored in List at the ordinal position in Index.

Inserts increments the value in the Count property for the newly added item in the container.

Insert is used to implement the Add method.