Function PPic_FindFirst

Descent3/PilotPicsAPI.cpp:269–310

--------------------------------------------------------- PPic_FindFirst Purpose: Given a pilot callsign it will return the first pilot that matches the search. Returns true on success, false if it couldn't find any pilots matching. It returns the pilot id. ----------------------------------------------------------

//	the pilot id.
// ----------------------------------------------------------
bool PPic_FindFirst(char *pilot_name, uint16_t *pilot_id) {
  if (!PilotPic_init)
    return false;

  *pilot_id = 65535;

  int letter_offset = PPic_JumpToPilot(pilot_name);
  if (letter_offset == -1)
    return false;

  strcpy(PilotPic_find_name, pilot_name);

  char name_buffer[PILOT_STRING_SIZE];
  CFILE *file = PilotPic_database_index_handle;

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

  // next read in pilot_id
  uint16_t pid;
  pid = (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);

  if (stricmp(name_buffer, pilot_name)) {
    return false; // weird
  }

  *pilot_id = pid;
  PilotPic_find_offset = cftell(file);

  return true;
}

// ----------------------------------------------------------
// PPic_FindNext