nfgciter.h

Gambit 是一个游戏库理论软件

//
// $Source: /home/gambit/CVS/gambit/sources/game/nfgciter.h,v $
// $Date: 2002/08/26 05:50:09 $
// $Revision: 1.2 $
//
// DESCRIPTION:
// Interface to normal form contingency iterator
//
// This file is part of Gambit
// Copyright (c) 2002, The Gambit Project
//
// 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 of the License, 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.
//
// You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
//

#ifndef NFGCITER_H
#define NFGCITER_H

#include "base/base.h"
#include "nfplayer.h"

class StrategyProfile;

//
// This class is useful for iterating around the normal form.  This iterator
// allows the user choose to hold some players' strategies constant while
// iterating over the other players' strategies.  This is useful, for example,
// in displaying a 2D window into the n-D space of strategy profiles as in
// the normal form display code.  The constructor takes the normal form to
// work on and a gBlock<int> containing the numbers of players the user wants
// to hold constant.  The iteration is based on an index that goes from 1 to
// the total number of possible contingencies in increments of 1.
//
class NfgContIter    {
friend class NfgIter;
private:
  NFSupport support;
  gArray<int> current_strat;
  Nfg *N;
  StrategyProfile profile;
  gBlock<int> frozen, thawed;
  
public:
  NfgContIter(const NFSupport &s);
  ~NfgContIter();
  
  void First(void);
  
  void Freeze(const gBlock<int> &);
  void Freeze(int);
  inline void Freeze(const NFPlayer* p) { Freeze(p->GetNumber()); }
  void Thaw(int);
  
  // These next two only work on frozen strategies
  void Set(int pl, int num);
  void Set(const Strategy *);
  int Next(int pl);
  
  const StrategyProfile &Profile(void) const;

  gArray<int> Get(void) const;
  void Get(gArray<int> &t) const;
  
  int NextContingency(void);
  
  long GetIndex(void) const;
  
  NFOutcome *GetOutcome(void) const;
  void SetOutcome(NFOutcome *);
  
  void Dump(gOutput &) const;
};

#endif   // NFGCITER_H