global_worklist.c

Go to the documentation of this file.

/***********************************************************************
 Freeciv - Copyright (C) 1996 - A Kjeldberg, L Gregersen, P Unold
   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2, or (at your option)
   any later version.
 
   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.
***********************************************************************/
#ifdef HAVE_CONFIG_H
#include <fc_config.h>
#endif
 
#include <stdarg.h>
 
/* utility */
#include "fcintl.h"
#include "log.h"
#include "mem.h"
#include "registry.h"
#include "shared.h"
#include "support.h"
 
/* common */
#include "fc_types.h"
#include "requirements.h"
#include "worklist.h"
 
/* client */
#include "client_main.h"
 
#include "global_worklist.h"
 
enum global_worklist_status {
  /* Means we have a list of kind of universal and their name, but we
   * don't know the id they could have on the server's ruleset.  In this
   * case, we use the unbuilt part and not the worklist one. */
  STATUS_UNBUILT,
 
  /* Means this worklist is plainly usable at running time. */
  STATUS_WORKLIST
};
 
 
/* The global worklist structure. */
struct global_worklist {
  int id;
  char name[MAX_LEN_NAME];
  enum global_worklist_status status;
  union {
    struct {
      int length;
      struct uni_name {
        char *kind;
        char *name;
      } entries[MAX_LEN_WORKLIST];
    } unbuilt;
    struct worklist worklist;
  };
};
 
static bool global_worklist_load(struct section_file *file,
                                 const char *path, ...)
                                 fc__attribute((__format__ (__printf__, 2, 3)));
static void global_worklist_save(const struct global_worklist *pgwl,
                                 struct section_file *file, int fill_until,
                                 const char *path, ...)
                                 fc__attribute((__format__ (__printf__, 4, 5)));
 
/*******************************************************************/
void global_worklists_init(void)
{
  if (!client.worklists) {
    client.worklists = global_worklist_list_new();
  }
}
 
/*******************************************************************/
void global_worklists_free(void)
{
  if (client.worklists) {
    global_worklists_iterate_all(pgwl) {
      global_worklist_destroy(pgwl);
    } global_worklists_iterate_all_end;
    global_worklist_list_destroy(client.worklists);
    client.worklists = NULL;
  }
}
 
/*******************************************************************/
void global_worklists_build(void)
{
  global_worklists_iterate_all(pgwl) {
    if (pgwl->status == STATUS_UNBUILT) {
      struct worklist worklist;
      struct uni_name *puni_name;
      int i;
 
      /* Build a worklist. */
      worklist_init(&worklist);
      for (i = 0; i < pgwl->unbuilt.length; i++) {
        struct universal source;
 
        puni_name = pgwl->unbuilt.entries + i;
        source = universal_by_rule_name(puni_name->kind, puni_name->name);
        if (source.kind == universals_n_invalid()) {
          /* This worklist is not valid on this ruleset.
           * N.B.: Don't remove it to resave it in client rc file. */
          break;
        } else {
          worklist_append(&worklist, &source);
        }
      }
 
      if (worklist_length(&worklist) != pgwl->unbuilt.length) {
        /* Somewhat in this worklist is not supported by the current
         * ruleset.  Don't try to build it, but keep it for later save. */
        continue;
      }
 
      /* Now the worklist is built, change status. */
      for (i = 0; i < pgwl->unbuilt.length; i++) {
        puni_name = pgwl->unbuilt.entries + i;
        free(puni_name->kind);
        free(puni_name->name);
      }
      pgwl->status = STATUS_WORKLIST;
      worklist_copy(&pgwl->worklist, &worklist);
    }
  } global_worklists_iterate_all_end;
}
 
/*******************************************************************/
void global_worklists_unbuild(void)
{
  global_worklists_iterate_all(pgwl) {
    if (pgwl->status == STATUS_WORKLIST) {
      struct worklist worklist;
      struct uni_name *puni_name;
      int i;
 
      /* Copy before over-write. */
      worklist_copy(&worklist, &pgwl->worklist);
      pgwl->status = STATUS_UNBUILT;
 
      pgwl->unbuilt.length = worklist_length(&worklist);
      for (i = 0; i < worklist_length(&worklist); i++) {
        puni_name = pgwl->unbuilt.entries + i;
        puni_name->kind =
          fc_strdup(universal_type_rule_name(worklist.entries + i));
        puni_name->name =
          fc_strdup(universal_rule_name(worklist.entries + i));
      }
    }
  } global_worklists_iterate_all_end;
}
 
/*******************************************************************/
int global_worklists_number(void)
{
  int count = 0;
 
  global_worklists_iterate(pgwl) {
    count++;
  } global_worklists_iterate_end;
 
  return count;
}
 
/*******************************************************************/
static struct global_worklist *
global_worklist_alloc(enum global_worklist_status type)
{
  static int last_id = 0;
  struct global_worklist *pgwl = fc_calloc(1, sizeof(struct global_worklist));
 
  pgwl->id = ++last_id;
  pgwl->status = type;
 
  /* Specific initializer. */
  switch (pgwl->status) {
  case STATUS_UNBUILT:
    /* All members set to 0 by fc_calloc. */
    break;
  case STATUS_WORKLIST:
    worklist_init(&pgwl->worklist);
    break;
  }
 
  global_worklist_list_append(client.worklists, pgwl);
 
  return pgwl;
}
 
/*******************************************************************/
void global_worklist_destroy(struct global_worklist *pgwl)
{
  fc_assert_ret(NULL != pgwl);
 
  global_worklist_list_remove(client.worklists, pgwl);
 
  /* Specific descturctor. */
  switch (pgwl->status) {
  case STATUS_UNBUILT:
    {
      struct uni_name *puni_name;
      int i;
 
      for (i = 0; i < pgwl->unbuilt.length; i++) {
        puni_name = pgwl->unbuilt.entries + i;
        free(puni_name->kind);
        free(puni_name->name);
      }
    }
    break;
  case STATUS_WORKLIST:
    break;
  }
 
  free(pgwl);
}
 
/*******************************************************************/
struct global_worklist *global_worklist_new(const char *name)
{
  struct global_worklist *pgwl = global_worklist_alloc(STATUS_WORKLIST);
 
  global_worklist_set_name(pgwl, name);
  return pgwl;
}
 
/*******************************************************************/
bool global_worklist_is_valid(const struct global_worklist *pgwl)
{
  return pgwl && pgwl->status == STATUS_WORKLIST;
}
 
/*******************************************************************/
bool global_worklist_set(struct global_worklist *pgwl,
                         const struct worklist *pwl)
{
  if (pgwl && pgwl->status == STATUS_WORKLIST && pwl) {
    worklist_copy(&pgwl->worklist, pwl);
    return TRUE;
  }
  return FALSE;
}
 
/*******************************************************************/
const struct worklist *global_worklist_get(const struct global_worklist *pgwl)
{
  if (pgwl && pgwl->status == STATUS_WORKLIST) {
    return &pgwl->worklist;
  } else {
    return NULL;
  }
}
 
/*******************************************************************/
int global_worklist_id(const struct global_worklist *pgwl)
{
  fc_assert_ret_val(NULL != pgwl, -1);
  return pgwl->id;
}
 
/*******************************************************************/
struct global_worklist *global_worklist_by_id(int id)
{
  global_worklists_iterate_all(pgwl) {
    if (pgwl->id == id) {
      return pgwl;
    }
  } global_worklists_iterate_all_end;
 
  return NULL;
}
 
/*******************************************************************/
void global_worklist_set_name(struct global_worklist *pgwl,
                              const char *name)
{
  if (name) {
    sz_strlcpy(pgwl->name, name);
  }
}
 
/*******************************************************************/
const char *global_worklist_name(const struct global_worklist *pgwl)
{
  fc_assert_ret_val(NULL != pgwl, NULL);
  return pgwl->name;
}
 
/*******************************************************************/
static bool global_worklist_load(struct section_file *file,
                                 const char *path, ...)
{
  struct global_worklist *pgwl;
  const char *kind;
  const char *name;
  char path_str[1024];
  va_list ap;
  int i, length;
 
  /* The first part of the registry path is taken from the varargs to the
   * function. */
  va_start(ap, path);
  fc_vsnprintf(path_str, sizeof(path_str), path, ap);
  va_end(ap);
 
  length = secfile_lookup_int_default(file, -1, "%s.wl_length", path_str);
  if (length == -1) {
    /* Not set. */
    return FALSE;
  }
  length = MIN(length, MAX_LEN_WORKLIST);
  pgwl = global_worklist_alloc(STATUS_UNBUILT);
  global_worklist_set_name(pgwl,
                           secfile_lookup_str_default(file, _("(noname)"),
                                                      "%s.wl_name",
                                                      path_str));
 
  for (i = 0; i < length; i++) {
    kind = secfile_lookup_str_default(file, NULL, "%s.wl_kind%d",
                                      path_str, i);
 
    if (!kind) {
      /* before 2.2.0 unit production was indicated by flag. */
      bool is_unit = secfile_lookup_bool_default(file, FALSE,
                                                 "%s.wl_is_unit%d",
                                                 path_str, i);
      kind = universals_n_name(is_unit ? VUT_UTYPE : VUT_IMPROVEMENT);
    }
 
    name = secfile_lookup_str_default(file, NULL, "%s.wl_value%d",
                                      path_str, i);
    if (NULL == kind || '\0' == kind[0] || NULL == name || '\0' == name[0]) {
      break;
    } else {
      pgwl->unbuilt.entries[i].kind = fc_strdup(kind);
      pgwl->unbuilt.entries[i].name = fc_strdup(name);
      pgwl->unbuilt.length++;
    }
  }
 
  return TRUE;
}
 
/*******************************************************************/
void global_worklists_load(struct section_file *file)
{
  int i;
 
  /* Clear the current global worklists. */
  global_worklists_iterate_all(pgwl) {
    global_worklist_destroy(pgwl);
  } global_worklists_iterate_all_end;
 
  for (i = 0; global_worklist_load(file, "worklists.worklist%d", i); i++) {
    /* Nothing to do more. */
  }
 
  if (C_S_RUNNING <= client_state()) {
    /* We need to build the worklists immediately. */
    global_worklists_build();
  }
}
 
/*******************************************************************/
static void global_worklist_save(const struct global_worklist *pgwl,
                                 struct section_file *file, int fill_until,
                                 const char *path, ...)
{
  char path_str[1024];
  int i = 0;
  va_list ap;
 
  /* The first part of the registry path is taken from the varargs to the
   * function. */
  va_start(ap, path);
  fc_vsnprintf(path_str, sizeof(path_str), path, ap);
  va_end(ap);
 
  secfile_insert_str(file, pgwl->name, "%s.wl_name", path_str);  
 
  switch (pgwl->status) {
  case STATUS_UNBUILT:
    secfile_insert_int(file, pgwl->unbuilt.length,
                       "%s.wl_length", path_str);
    for (i = 0; i < pgwl->unbuilt.length; i++) {
      secfile_insert_str(file, pgwl->unbuilt.entries[i].kind,
                         "%s.wl_kind%d", path_str, i);
      secfile_insert_str(file, pgwl->unbuilt.entries[i].name,
                         "%s.wl_value%d", path_str, i);
    }
    break;
  case STATUS_WORKLIST:
    secfile_insert_int(file, worklist_length(&pgwl->worklist),
                       "%s.wl_length", path_str);
    for (i = 0; i < pgwl->unbuilt.length; i++) {
      secfile_insert_str(file,
                         universal_type_rule_name(pgwl->worklist.entries + i),
                         "%s.wl_kind%d", path_str, i);
      secfile_insert_str(file,
                         universal_rule_name(pgwl->worklist.entries + i),
                        "%s.wl_value%d", path_str, i);
    }
    break;
  }
 
  /* We want to keep savegame in tabular format, so each line has to be
   * of equal length.  Fill table up to maximum worklist size. */
  while (i < fill_until) {
    secfile_insert_str(file, "", "%s.wl_kind%d", path_str, i);
    secfile_insert_str(file, "", "%s.wl_value%d", path_str, i);
    i++;
  }
}
 
/*******************************************************************/
void global_worklists_save(struct section_file *file)
{
  int max_length = 0;
  int i = 0;
 
  /* We want to keep savegame in tabular format, so each line has to be
   * of equal length.  So we need to know about the biggest worklist. */
  global_worklists_iterate_all(pgwl) {
    switch (pgwl->status) {
    case STATUS_UNBUILT:
      max_length = MAX(max_length, pgwl->unbuilt.length);
      break;
    case STATUS_WORKLIST:
      max_length = MAX(max_length, worklist_length(&pgwl->worklist));
      break;
    }
  } global_worklists_iterate_all_end;
 
  global_worklists_iterate_all(pgwl) {
    global_worklist_save(pgwl, file, max_length,
                         "worklists.worklist%d", i++);
  } global_worklists_iterate_all_end;
}