Public API Reference

csutil/verbosity.h

Go to the documentation of this file.

/*
    Copyright (C) 2005 by Eric Sunshine <[email protected]>

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.

    This library 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
    Library General Public License for more details.

    You should have received a copy of the GNU Library General Public
    License along with this library; if not, write to the Free
    Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/

#ifndef __CS_CSUTIL_VERBOSITY_H__
#define __CS_CSUTIL_VERBOSITY_H__

#include "csextern.h"
#include "iutil/verbositymanager.h"
#include "csutil/strhash.h"
#include "csutil/csstring.h"
#include "csutil/scf_implementation.h"
class csStringArray;

class CS_CRYSTALSPACE_EXPORT csVerbosityParser
{
private:
  csStringHash flags;

  typedef csStringFast<128> Str;
  typedef bool (*SplitPredicate)(char c, size_t pos);
  static bool Split(char const*, char delim, SplitPredicate, bool empty_okay,
                    csStringArray&);
  static Str  Join(csStringArray const&, Str delim);
  static bool Error(char const* msg, char const* s, size_t pos);
  static bool ParseToggle(char const*&);
  static bool ParseFlag(char const*, csStringArray&, bool empty_okay);
  bool TestFlag(Str name, bool& enable) const;
  void Copy(csVerbosityParser const& v) { flags = v.flags; }

public:
  csVerbosityParser(char const* flags = 0);
  
  csVerbosityParser(csVerbosityParser const& v) { Copy(v); }

  ~csVerbosityParser() {}

  csVerbosityParser& operator=(csVerbosityParser const& v)
  { Copy(v); return *this; }

  void Parse(char const* flags);

  bool Enabled(char const* flag = 0, bool fuzzy = true) const;

  CS_DEPRECATED_METHOD_MSG("Use Enabled() instead")
  bool CheckFlag(char const* major, char const* minor) const
  {
    Str flag; flag << major << '.' << minor;
    return Enabled(flag);
  }
};

CS_CRYSTALSPACE_EXPORT csVerbosityParser csParseVerbosity (
  int argc, char const* const argv[]);
  
CS_CRYSTALSPACE_EXPORT bool csCheckVerbosity (
  int argc, char const* const argv[], char const* flag = 0, bool fuzzy = true);
  
CS_DEPRECATED_METHOD
CS_CRYSTALSPACE_EXPORT bool csCheckVerbosity (
  int argc, char const* const argv[], char const* major, char const* minor);

#include "csutil/win32/msvc_deprecated_warn_off.h"

class CS_CRYSTALSPACE_EXPORT csVerbosityManager : 
  public scfImplementation1<csVerbosityManager, iVerbosityManager>
{
private:
  csVerbosityParser vp;
public:

  csVerbosityManager(char const* flags = 0) 
    : scfImplementationType (this), vp(flags)
  { }
  virtual ~csVerbosityManager() { }

  virtual void Parse(char const* flags) { vp.Parse(flags); }

  virtual bool Enabled(char const* flag = 0, bool fuzzy = true) const
  { return vp.Enabled(flag, fuzzy); }

  CS_DEPRECATED_METHOD_MSG("Use Enabled() instead")
  virtual bool CheckFlag(char const* major, char const* minor) const
  {
    csStringFast<128> flag; flag << major << '.' << minor;
    return Enabled(flag);
  }
};

#include "csutil/win32/msvc_deprecated_warn_on.h"

#endif // __CS_CSUTIL_VERBOSITY_H__

---