This inserts an item before another item within the list. It uses the same priority as the
found index item and places the new item before it.
public insertBefore ( $indexitem, $item ) : integer | ||
return | integer | where the item has been inserted in the flattened list |