bench::out::csv(n)

✨ bench::out::csv — the Tcllib page, but make it cute ✨

okay bestie so this is a page from the Benchmarking/Performance tools manual section, and it's literally called bench::out::csv. Yes the manual name is bench::out::csv(n) and yes I'm folding it in right here at the top like a little name tag. 💖

---

🌸 NAME 🌸

bench::out::csv — bench::out::csv — Formatting benchmark results as CSV

(yes it says its own name twice, no I will not be explaining that, it's just the vibe 🫶)

---

🎀 SYNOPSIS 🎀

package require Tcl 8.5 9

package require bench::out::csv ?0.1.3?

::bench::out::csv bench_result

---

💅 DESCRIPTION 💅

So this package hands you the commands to format benchmark results into a CSV table — the kind you can import straight into spreadsheets. Excel girlies, this one's for you. 📊✨

If you're the reader who's actually interested in generating or processing those results, bestie, go read bench - Processing benchmark suites instead. That's the one you want.

And if it's the bench language itself that's got your attention? Start with the bench language introduction, and then go from there to the formal bench language specification. One step at a time, you got this. 🦋

---

👑 PUBLIC API 👑

⭐ ::bench::out::csv bench_result

This command formats the benchmark result you give it so it can be written out to a file, a socket, whatever you need. And this specific command generates CSV data importable by spreadsheets. no cap. 🍓

For other formatting styles, go check out the packages bench and bench::out::text — they give you commands that format benchmark results in raw form or for human consumption, respectively. pick your fighter 💀

---

😭 BUGS, IDEAS, FEEDBACK 😭

Okay so real talk: this document, and the package it describes, will undoubtedly contain bugs and other problems. Like, guaranteed. Not being dramatic, it literally says so.

Please report them in the category bench of the Tcllib Trackers:

http://core.tcl.tk/tcllib/reportlist

And please also report any ideas for enhancements you have for either the package and/or the documentation. We love ideas here. 🌈

When proposing code changes, please provide unified diffs, i.e. the output of diff -u. Don't make us guess, bestie.

Note further that attachments are strongly preferred over inlined patches. You can attach stuff by going to the Edit form of the ticket immediately after its creation, and then using the left-most button in the secondary navigation bar. iykyk 👑

---

💜 SEE ALSO 💜

• bench
• bench::out::text

---

🌟 KEYWORDS 🌟

benchmark, csv, formatting, performance, testing

---

🧚 CATEGORY 🧚

Benchmark tools

---

🫶 COPYRIGHT 🫶

Copyright (c) 2007 Andreas Kupries <andreas_kupries@users.sourceforge.net>

---

aaaand that's the whole page, you ate it 💖 this was tcllib, version 0.1.3, serving bench::out::csv(n) realness. go format some results, main character. ✨👑