Function MatchWeaponToIndex

Descent3/weapon.cpp:660–699

Given a weapon name, assigns that weapon to a specific index into the Weapons array. Returns -1 if the named weapon is not found, 0 if the weapon is already in its place, or 1 if successfully moved

// the Weapons array.  Returns -1 if the named weapon is not found, 0 if the weapon
// is already in its place, or 1 if successfully moved
int MatchWeaponToIndex(char *name, int dest_index) {

  ASSERT(dest_index >= 0 && dest_index < MAX_WEAPONS);

  int cur_index = FindWeaponName(name);
  int new_index;

  if (cur_index == -1) {
    // The weapon we are trying to find is not loaded or doesn't exist
    Int3(); // Get Jason or Matt
    return -1;
  }

  if (cur_index == dest_index)
    return 0; // hurray, we're already matched up!

  if (Weapons[dest_index].used) {
    // This weapon is currently in use.  Copy the present data
    // into a new weapon and then assign our desired weapon to that index

    new_index = AllocWeapon();
    if (new_index >= 0) // DAJ -1FIX
      memcpy(&Weapons[new_index], &Weapons[dest_index], sizeof(weapon));

    // Now copy our new info over and free the old one
    memcpy(&Weapons[dest_index], &Weapons[cur_index], sizeof(weapon));
    FreeWeapon(cur_index);
  } else {
    // This slot is unused, so just take it

    Weapons[dest_index].used = 1;
    Num_weapons++;

    memcpy(&Weapons[dest_index], &Weapons[cur_index], sizeof(weapon));
    FreeWeapon(cur_index);
    return 0;
  }

  return new_index; // we made it!
}

// Moves a weapon from a given index into a new one (above MAX_STATIC_WEAPONS)
// returns new index