NAME

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

SYNOPSIS

       package require Tcl  8.2

       package require csv

       package require bench::in  ?0.1?

       ::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>