CGAL 5.1 - IO Streams
CGAL::Output_rep< T, F > Class Template Reference

#include <CGAL/IO/io.h>

Definition

template<typename T, typename F>
class CGAL::Output_rep< T, F >

The purpose of Output_rep is to provide a way to control output formatting that works independently of the object's stream output operator.

If you dont specialize Output_rep for T, T's stream output operator is called from within Output_rep, by default. If you want another behaviour for your type T, you have to provide a specialization for that type. Furthermore, you can provide specializations with a second template parameter (a formatting tag). The second template parameter defaults to Null_tag and means default behaviour.

Specializations of Output_rep should provide the following features:

template< class F >
struct Output_rep< Some_type, F > {
static const bool is_specialized = true;
Output_rep( const Some_type& t );
std::ostream& operator()( std::ostream& out ) const;
};

You can also specialize for a formatting tag F.

The constant is_specialized can be tested by meta-programming tools to verify that a given type can be used with oformat(). Its value has to be true in a specialization of Output_rep. When there is no specialization for a type, the class template Output_rep defines is_specialized to the default value false.