Template Class Manipulator

Defined in File manipulator.hpp

Class Documentation

template<typename Derived> class Manipulator

Parent template for c++ style stream manipulators.

This class uses a trick embedded within the curiously recurring template method to allow static inheritance (important in this case because the manipulator function call is template based). Manipulators have an advantage over the usual c++ style manipulators in that they are themselves classes (not functions such as std::endl). This means that they can retain state from one insertion to the next.

Usage:

The manipulators defined in the ecl export a few global instantiations, namely

ecl::endl
ecl::clrscr

Using them follows the same pattern as for standard c++ style cout manipulators.

using ecl::streams::OConsoleStream;
using ecl::streams::endl;
int main() {
    OConsoleStream ostream;
    ostream << clrscr;
    ostream << "Dude" << endl;
    return;
}

Creating your own Manipulators:

Any manipulator that you wish to define must inherit from this parent class in the following manner:

include <ecl/streams/manipulators.hpp>

class MyManipulator : public ecl::Manipulator<MyManipulator> {
    template <typename OutputStream>
    void action (OutputStream& ostream) {
        // ...
    }
};