Debug.H

Go to the documentation of this file.

// Copyright (C) 2001, Compaq Computer Corporation
// 
// This file is part of Vesta.
// 
// Vesta is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
// 
// Vesta 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
// Lesser General Public License for more details.
// 
// You should have received a copy of the GNU Lesser General Public
// License along with Vesta; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

// Last modified on Thu Nov  8 12:36:38 EST 2001 by ken@xorian.net
//      modified on Wed Sep 20 14:55:21 PDT 1995 by heydon

// Debug.H -- common functions for debugging, etc.

#ifndef _DEBUG_H
#define _DEBUG_H

class Debug {
  public:
    static void Lock() throw ();
    static void Unlock() throw ();
    // Acquire/release a hidden global lock "Debug::mu"

    static char *Timestamp() throw ();
    /* REQUIRES Debug::mu IN LL */
    /* Returns a string for the current timestamp of the form "HH:MM:SS.sss",
       where "HH" are hours, "MM" are minutes, "SS" are seconds, and "sss" are
       milliseconds. The result is a pointer to a hidden global buffer, so
       subsequent calls will overwrite the result.

       This procedure is not atomic; use "Lock()" and "Unlock()" above to
       guarantee atomicity. Also, once the lock is release, the result should
       not be used. */

    static int MyRand(int lo, int hi) throw ();
    // Return a random integer in the closed interval [lo, hi].

    static void BlockForever() throw ();
    // The calling thread never returns; it blocks on a condition variable
    // that is never signaled.
};

#endif // _DEBUG_H

---