Function PPic_JumpToPilot

Descent3/PilotPicsAPI.cpp:629–703

------------------------------------------------- PPic_JumpToPilot Purpose: Returns an offset into the file to where the the first pilot that matches pilot_name is. -1 is returned if no match --------------------------------------------------

//	is returned if no match
// --------------------------------------------------
int PPic_JumpToPilot(char *pilot_name) {
  int lett_offset;
  int let_pos;

  if (isalpha(pilot_name[0])) {
    let_pos = toupper(pilot_name[0]) - 'A';
  } else {
    let_pos = 26;
  }

  lett_offset = Alphabet_to_offset[let_pos];
  if (lett_offset == -1) {
    // no pilot names begin with this letter
    return -1;
  }

  CFILE *file = PilotPic_database_index_handle;

  // jump to that position of the file
  cfseek(file, lett_offset, SEEK_SET);

  // now try to find the pilot
  bool done = false;
  int file_pos;
  char name_buffer[PILOT_STRING_SIZE];

  while (!done) {

    // save the file position
    file_pos = cftell(file);

    // first read in the pilot name
    uint8_t name_size;
    name_size = cf_ReadByte(file);
    if (cfeof(file)) {
      done = true;
      continue;
    }
    cf_ReadBytes((uint8_t *)name_buffer, name_size, file);
    name_buffer[name_size] = '\0';

    // next read in pilot_id
    uint16_t pilot_id;
    pilot_id = (uint16_t)cf_ReadShort(file);

    // next read past the bitmap name
    uint8_t bmp_size;
    bmp_size = cf_ReadByte(file);
    cfseek(file, bmp_size, SEEK_CUR);

    int strcmpret = stricmp(name_buffer, pilot_name);

    switch (strcmpret) {
    case 0:
      // we found a match
      cfseek(file, file_pos, SEEK_SET);
      return file_pos;
    default: