Function CreateStringTable

Descent3/localization.cpp:264–425

Given a filename, pointer to a char * array and a pointer to an int, it will load the string table and fill in the information returns true on success

// it will load the string table and fill in the information
// returns true on success
bool CreateStringTable(const char *filename, char ***table, int *size) {
  ASSERT(filename);
  ASSERT(Localization_language != -1);
  if (!filename) {
    if (table)
      *table = NULL;
    if (size)
      *size = 0;
    return false;
  }
  CFILE *file;

  char fname[_MAX_PATH];
  FixFilenameCase(filename, fname);
  file = cfopen(fname, "rt");
  if (!file) {
    if (table)
      *table = NULL;
    if (size)
      *size = 0;
    return false;
  }

  int old_language, scount;
  char tempbuffer[MAX_STRING_LENGTH];

  old_language = Localization_language;

try_english:

  // first found out how many strings total in the file
  scount = 0;

  while (!cfeof(file)) {
    cf_ReadString(tempbuffer, MAX_LINE_LENGTH + 1, file);
    if (_parse_line_information(tempbuffer) == Localization_language)
      scount++;
  }
  cfclose(file);

  if (scount == 0) {
    // no strings found, if we are searching a non-English version, then
    // load english versions
    if (Localization_language != LANGUAGE_ENGLISH) {
      Localization_language = LANGUAGE_ENGLISH;
      // open the file again
      file = cfopen(fname, "rt");
      goto try_english;
    }

    // no strings found
    Localization_language = old_language;
    mprintf(0, "Localization: Warning, 0 strings found in %s\n", filename);
    *table = NULL;
    *size = 0;
    return true;
  }