This file is indexed.

/usr/include/crystalspace-2.0/csutil/measuretime.h is in libcrystalspace-dev 2.0+dfsg-1build1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
/*
    Copyright (C) 2004-2006 by Jorrit Tyberghein
              (C) 2004-2006 by Frank Richter

    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_TIMEMEASURE_H__
#define __CS_CSUTIL_TIMEMEASURE_H__

/**\file
 * Simple helper class to measure execution time of a block.
 */

#include "csutil/csstring.h"
#include "csutil/util.h"
#include "csutil/sysfunc.h"

namespace CS
{

  /**
   * \addtogroup util
   * @{ */

  /**
   * Simple helper class to measure execution time of a block.
   * When destructed, csPrintf()s the time that has passed between
   * construction and destruction in microseconds.
   * 
   * Use like:
   * \code
   * void Foo (int x)
   * {
   *   CS::MeasureTime measureFoo ("Foo (%d) time", x);
   *   
   *   // ...
   * }
   * \endcode
   * This will print the total execution time of Foo().
   */ 
  class CS_CRYSTALSPACE_EXPORT MeasureTime
  {
  protected:
    int64 offsetTime;
    csString text;
    void PrintTime (const char* prefix, int64 time, const char* suffix);
  public:
    /**
     * Construct with a formatted description string.
     */
    MeasureTime (const char* format, ...)
    {
      va_list args;
      va_start (args, format);
      text.FormatV (format, args);
      va_end (args);

      offsetTime = csGetMicroTicks ();
    }
    
    ~MeasureTime ()
    {
      csTicks endTime = csGetMicroTicks ();
      PrintTime ((text + ": ").GetData(), endTime - offsetTime, 
	" \xC2\xB5s\n");
    }
    
    /// Print an intermediate measurement.
    void PrintIntermediate (const char* descr, ...)
    {
      int64 currentTime = csGetMicroTicks ();

      csPrintf ("(%s)", text.GetData());
      va_list args;
      va_start (args, descr);
      csPrintfV (descr, args);
      va_end (args);
      PrintTime (": ", currentTime - offsetTime, " \xC2\xB5s\n");
      
      int64 currentTime2 = csGetMicroTicks ();
      // Correct difference from printing
      offsetTime += currentTime2 - currentTime;
    }
  };
 
/** @} */

} // namespace CS

#endif