2016-01-16 22:15:15 +01:00

198 lines
5.6 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<head>
<title>utils</title>
<link rel="stylesheet" href="../ldoc.css" type="text/css" />
</head>
<body>
<div id="container">
<div id="product">
<div id="product_logo"></div>
<div id="product_name"><big><b></b></big></div>
<div id="product_description"></div>
</div> <!-- id="product" -->
<div id="main">
<!-- Menu -->
<div id="navigation">
<br/>
<h1>utils</h1>
<ul>
<li><a href="../index.html">Index</a></li>
</ul>
<h2>Contents</h2>
<ul>
<li><a href="#Functions">Functions</a></li>
</ul>
<h2>Modules</h2>
<ul class="$(kind=='Topics' and '' or 'nowrap'">
<li><a href="../modules/stringutil.html">stringutil</a></li>
<li><a href="../modules/random.html">random</a></li>
<li><a href="../modules/noisemanager.html">noisemanager</a></li>
<li><a href="../modules/nodeutil.html">nodeutil</a></li>
<li><a href="../modules/posutil.html">posutil</a></li>
<li><a href="../modules/objectrefutil.html">objectrefutil</a></li>
<li><a href="../modules/nodeboxutil.html">nodeboxutil</a></li>
<li><a href="../modules/mapmanipulator.html">mapmanipulator</a></li>
<li><a href="../modules/fisheryates.html">fisheryates</a></li>
<li><a href="../modules/textureutil.html">textureutil</a></li>
<li><a href="../modules/blockutil.html">blockutil</a></li>
<li><a href="../modules/tango.html">tango</a></li>
<li><a href="../modules/arraymanipulator.html">arraymanipulator</a></li>
<li><a href="../modules/inventoryutil.html">inventoryutil</a></li>
<li><a href="../modules/entityutil.html">entityutil</a></li>
<li><a href="../modules/scheduler.html">scheduler</a></li>
<li><a href="../modules/blockedcache.html">blockedcache</a></li>
<li><a href="../modules/mathutil.html">mathutil</a></li>
<li><a href="../modules/log.html">log</a></li>
<li><a href="../modules/arrayutil.html">arrayutil</a></li>
<li><a href="../modules/directmapmanipulator.html">directmapmanipulator</a></li>
<li><a href="../modules/rotationutil.html">rotationutil</a></li>
<li><a href="../modules/settings.html">settings</a></li>
<li><a href="../modules/pathutil.html">pathutil</a></li>
<li><a href="../modules/wallmountedutil.html">wallmountedutil</a></li>
<li><a href="../modules/interpolate.html">interpolate</a></li>
<li><a href="../modules/transform.html">transform</a></li>
<li><a href="../modules/numberutil.html">numberutil</a></li>
<li><a href="../modules/test.html">test</a></li>
<li><a href="../modules/facedirutil.html">facedirutil</a></li>
<li><a href="../modules/constants.html">constants</a></li>
<li><a href="../modules/minetestex.html">minetestex</a></li>
<li><a href="../modules/list.html">list</a></li>
<li><strong>stopwatch</strong></li>
<li><a href="../modules/itemutil.html">itemutil</a></li>
<li><a href="../modules/color.html">color</a></li>
<li><a href="../modules/tableutil.html">tableutil</a></li>
</ul>
</div>
<div id="content">
<h1>Module <code>stopwatch</code></h1>
<p>Allows to easily time blocks of code.</p>
<p> The result will be logged.</p>
<h2><a href="#Functions">Functions</a></h2>
<table class="function_list">
<tr>
<td class="name" nowrap><a href="#start">start (watch_name)</a></td>
<td class="summary">Start a watch with the given name.</td>
</tr>
<tr>
<td class="name" nowrap><a href="#stop">stop (watch_name, message, decimal_places)</a></td>
<td class="summary">Stops the watch with the given name, logging the duration.</td>
</tr>
<tr>
<td class="name" nowrap><a href="#stop_only">stop_only (watch_name)</a></td>
<td class="summary">Stops the watch with the given name and returns the duration for which
the watch has been running.</td>
</tr>
</table>
<br/>
<br/>
<h2><a name="Functions"></a>Functions</h2>
<dl class="function">
<dt>
<a name = "start"></a>
<strong>start (watch_name)</strong>
</dt>
<dd>
Start a watch with the given name.
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">watch_name</span>
The name of the watch to start.
</li>
</ul>
</dd>
<dt>
<a name = "stop"></a>
<strong>stop (watch_name, message, decimal_places)</strong>
</dt>
<dd>
Stops the watch with the given name, logging the duration.
<p> It will be logged as info in the format "watch_name: duration ms" or
if the message is provided "message: duration ms"
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">watch_name</span>
The name of the watch to stop.
</li>
<li><span class="parameter">message</span>
Optional. The message to use for the log instead of the name.
</li>
<li><span class="parameter">decimal_places</span>
Optional. To how many decimal places the time should
be rounded. Defaults to 3.
</li>
</ul>
</dd>
<dt>
<a name = "stop_only"></a>
<strong>stop_only (watch_name)</strong>
</dt>
<dd>
Stops the watch with the given name and returns the duration for which
the watch has been running.
<h3>Parameters:</h3>
<ul>
<li><span class="parameter">watch_name</span>
The name of the watch to stop.
</li>
</ul>
<h3>Returns:</h3>
<ol>
The duration of the watch. -1 if it never was started.
</ol>
</dd>
</dl>
</div> <!-- id="content" -->
</div> <!-- id="main" -->
<div id="about">
<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.2</a></i>
</div> <!-- id="about" -->
</div> <!-- id="container" -->
</body>
</html>