icetWallTime(3)

📦 version 6.1.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 icetWallTime(3) — the IceT Reference, but make it cute 💖

okay bestie, gather round, because today we're talking about icetWallTime from the IceT manual (section 3, obvi), and honestly? she's giving stopwatch energy and I'm obsessed. 🕐✨

✨ NAME ✨

icetWallTime — timer function. that's it. that's the girl. a little clock goblin. 🎀

🌸 SYNOPSIS 🌸

#include <IceT.h>

IceTDouble icetWallTime(   void   )

no args, no drama, just vibes and a IceTDouble coming back at you. 💅

🦋 DESCRIPTION 🦋

so what does she actually do? icetWallTime retrieves the current time, in seconds. that's the whole job. periodt.

but here's the ✨important✨ lil caveat that you CANNOT skip, bestie: the values she hands back are only valid in relation to each other. like, the time it returns may or may not have anything to do with the actual current date or time. it's not a clock you'd check to know when your 3pm lecture starts. it's a relative girlie. 🙈

the way it works: if you call icetWallTime twice and subtract, the difference of values between two calls is the elapsed time in seconds between the two calls. that's the magic. that's the whole point. so if you wanna know how long some subprocess took to run, she's literally handy for that — determining the running time of various subprocesses. 💯

and plot twist: she's working behind the scenes too. icetWallTime is used internally for determining the values for the state variables ICET_BUFFER_READ_TIME, ICET_BUFFER_WRITE_TIME, ICET_COLLECT_TIME, ICET_COMPARE_TIME, ICET_COMPOSITE_TIME, ICET_COMPRESS_TIME, ICET_INTERLACE_TIME, ICET_RENDER_TIME, and ICET_TOTAL_DRAW_TIME. yes, ALL of those. she's booked, busy, and thriving. 👑

⭐ RETURN VALUE ⭐

the current time, in seconds. simple. iconic. no notes. 🌈

💀 ERRORS 💀

None. she does not do errors. flawless behavior only. 😌

🙈 WARNINGS 🙈

None. no red flags here, bestie. 🚩❌

🍓 BUGS 🍓

None known. and we love that for her. 🫶

okay so legally speaking, here's the tea:

Copyright (C)2003 Sandia Corporation

Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation, the U.S. Government retains certain rights in this software.

This source code is released under the New BSD License.

so yeah — respect the license, give credit where it's due. 🎀

👑 SEE ALSO 👑

  • icetGet(3) — go read that one next, bestie, it's the whole ecosystem iykyk 💖

and that's a wrap on this page from the IceT Reference, dated February 10, 2015 ✨ no cap, she's a tiny function with big main character energy, and now you know her whole lore. go time something, babe. 💅🦋🌸

📦 where this page comes from