faithandbrave / cpp_io

C++ I/O library

C++ I/O library

The library is alternative C++ standard I/O stream library.

Underconstruction

We will introduce break change.

Build Environment

• Language version : C++17

Design

• No Locale (locale is heavy and useless)
• With new line API (println)
• Can get native handle (for OS native API)

Features

• Type specified outputs:
  • unsigned integers
  • signed integer
• Stream devices:
  • File stream (stdout, stderr)
  • Scoped file stream (regular file)
  • Null stream (like /dev/null)
  • String stream (a.k.a. Memory stream)
• Make single header script (python3 make_single_header.py)
  • Single header file is committed
• Common interface

Plan

• More type specified outputs:
  • character
  • string
  • floating point
• Colored output
• String format

Example

#include <cassert>
#include "cpp_io/io.hpp"

int main()
{
    using fmt = io::int_format;

    // output to stdout
    io::println(123u);
    io::println(123u, fmt::binary);
    io::println(123u, fmt::hex);
    io::println(123u, fmt::binary, io::with_prefix);
    io::println(123u, fmt::hex, io::with_prefix);

    io::println(-123);
    io::println(123);

    // like /dev/null
    io::null_stream null_out;
    io::println(null_out, 123); // no output

    // string stream
    io::string_stream ss;
    io::print(ss, 123);
    assert(ss.str() == "123");

    // file stream
    {
        io::scoped_file_stream file;
        file.open("a.txt", "w");
        io::println(file, 123u);
    }
}

outputs :

123
1111011
7b
0b1111011
0x7b
-123
123

Licence

MIT