Go to: Synopsis. Return value. MEL examples.

Synopsis

int stringArrayInsertAtIndex(int $index, string[] $list, string $item)

Insert $item at $index in the string array $list. If $index is greater than the last index of $list, $item will be placed at the end of the list.

Return value

None

Arguments

Variable Name Variable Type Description
$indexintThe index into $list to add $str at
$liststring[]A list of string values.
$itemstringThe new item to add to $list at $index

MEL examples

  // Initialize the list

  string $list[] = {"item1", "item3"};
  // Result: item1 item3 //

  // Insert in the middle of the sequence

  stringArrayInsertAtIndex(1, $list, "item2");
  // Result: 1 //

  print $list;
  // Result: item1 item2 item3 //

  // Insert before the first element

  stringArrayInsertAtIndex(-1, $list, "item4" );
  // Result: 0 //

  // Insert at (or after) the end of the sequence

  stringArrayInsertAtIndex( 10, $list, "item4" );
  // Result: 1 //

  print $list;
  // Result: item1 item2 item3 item4 //

  // Insert at the beginning of the sequence

  stringArrayInsertAtIndex( 0, $list, "item0" );
  // Result: 1 //

  print $list;
  // Result: item0 item1 item2 item3 item4 //