Stream

# API reference

• Base
  • streams
    • rili::stream::Writable
    • rili::stream::Readable
    • rili::stream::Duplex
  • details
    • rili::stream::OperationResult
    • rili::stream::view::Base
    • rili::stream::view::Default
  • helpers
    • rili::stream::WritableIterator< T >
    • rili::stream::ReadableIterator< T >
    • rili::stream::ReadableCustomIterator< T >
    • rili::stream::WritableCustomIterator< T >
  • free functions/objects
    • rili::stream::flush
    • rili::stream::endl
    • Readable& rili::stream::cin()
    • Writable& rili::stream::cout()
    • Writable& rili::stream::cerr()
• "Buffering"/"in memory" streams
  • rili::stream::BufferingFifoDuplex
  • rili::stream::BufferingReadable
  • rili::stream::BufferingWritable
• std::istream/std::ostream compatibility:
  • rili::stream::std::Readable
  • rili::stream::std::Writable
  • rili::stream::std::ReadableStreambuf
  • rili::stream::std::WritableStreambuf
• C FILE*/cstdio compatibility:
  • rili::stream::ReadableFile
  • rili::stream::ReadableFileProxy
  • rili::stream::WritableFile
  • rili::stream::WritableFileProxy

Description

rili/stream is alternative for C++ streams. We hope it have much better error handling and is easier to correctly extand, specialize and use with user defined types than C++ native streams. Aditionally our streams seems to be very abstract, so there was no problem to easely implement for example rili/service/socket synchronous API just by extanding rili/stream for network operation details.

There are 3 main categories of streams: Readable, Writable and Duplex

For conveniance there are implemented basic wrappers for C and C++ native stream API, so you can use them to mix usage of for example std::ostream and rili::stream::Writable easely in two ways.

Example

#include <rili/Stream.hpp>

void hello(){
  rili::stream::cout() << "hello!" << rili::stream::endl;
}