---
name: "bench_read"
section: "3tcl"
platform: "linux"
package: "tcllib"
version: "2.0+dfsg-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/bench_read"
---

# bench\_read(3tcl)

bench::in - Reading benchmark results

```

```

## NAME

bench::in - bench::in - Reading benchmark results

## SYNOPSIS

package require **Tcl 8.5 9**

package require **csv**

package require **bench::in ?0.2?**

**::bench::in::read** *file*

```

```

## DESCRIPTION

This package provides a command for reading benchmark results from files, sockets, etc.

A reader interested in the creation, processing or writing of such results should go and read *bench - Processing benchmark suites* instead.

If the bench language itself is the actual interest please start with the *bench language introduction* and then proceed from there to the formal *bench language specification*.

## PUBLIC API

- **::bench::in::read** *file*

  This command reads a benchmark result from the specified *file* and returns it as its result. The command understands the three formats created by the commands

  - **bench::out::raw**

    Provided by package **bench**.

  - **bench::out::csv**

    Provided by package **bench::out::csv**.

  - **bench::out::text**

    Provided by package **bench::out::text**.

  and automatically detects which format is used by the input file.

## BUGS, IDEAS, FEEDBACK

This document, and the package it describes, will undoubtedly contain bugs and other problems. Please report such in the category *bench* of the *Tcllib Trackers* \[http://core.tcl.tk/tcllib/reportlist\]. Please also report any ideas for enhancements you may have for either package and/or documentation.

When proposing code changes, please provide *unified diffs*, i.e the output of **diff -u**.

Note further that *attachments* are strongly preferred over inlined patches. Attachments can be made 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.

## SEE ALSO

bench, bench::out::csv, bench::out::text, bench\_intro

## KEYWORDS

benchmark, csv, formatting, human readable, parsing, performance, reading, testing, text

## CATEGORY

Benchmark tools

## COPYRIGHT

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