moab::ErrorOutput Class Reference

Utility class for printing error output. More...

#include <ErrorOutput.hpp>

Collaboration diagram for moab::ErrorOutput:

Public Member Functions
	ErrorOutput (FILE *str)
	ErrorOutput (std::ostream &str)
	~ErrorOutput ()
bool	have_rank () const
	Check if MPI rank has been set. More...
int	get_rank () const
	Get MPI rank. More...
void	set_rank (int rank)
	Set MPI rank. More...
void	use_world_rank ()
	Set MPI rank to the rank of this process in MPI_COMM_WORLD, if MOAB is built with MPI and MPI_Init has been called. More...
void	print (const char *str)
	Output the specified string. More...
void	print (const std::string &str)
	Output the specified string. More...
void	printf (const char *fmt,...) MB_PRINTF(1)
	Output the specified printf-formatted output. More...

Private Member Functions
void	print_real (const char *buffer)
void	print_real (const std::string &str)
void	print_real (const char *buffer, va_list args1, va_list args2)
void	process_line_buffer ()

Private Attributes
ErrorOutputStream *	outputImpl
int	mpiRank
std::vector< char >	lineBuffer

Detailed Description

Utility class for printing error output.

This class implements line-oriented output. That is, it buffers output data until a newline is encountered, at which point it sends the output to the output stream followed by an explicit flush, and optionally prefixed with the MPI rank.

\Note Any output not terminated with an newline character or followed by later output containing a newline character will not be flushed until the destructor is invoked.

Definition at line 28 of file ErrorOutput.hpp.

Constructor & Destructor Documentation

ErrorOutput() [1/2]

moab::ErrorOutput::ErrorOutput

(

FILE *

str

)

Parameters

str	Output stream to which to flush output

Definition at line 62 of file ErrorOutput.cpp.

                                     : outputImpl( new FILEErrorStream( impl ) ), mpiRank( -1 )
{
    lineBuffer.reserve( 1024 );
}

References lineBuffer.

ErrorOutput() [2/2]

moab::ErrorOutput::ErrorOutput

(

std::ostream &

str

)

Parameters

str	Output stream to which to flush output

Definition at line 67 of file ErrorOutput.cpp.

                                          : outputImpl( new CxxErrorStream( str ) ), mpiRank( -1 )
{
    lineBuffer.reserve( 1024 );
}

References lineBuffer.

~ErrorOutput()

moab::ErrorOutput::~ErrorOutput

(

)

Destructor flushes any remaining output that wasn't followed by a newline character.

Definition at line 72 of file ErrorOutput.cpp.

{
    if( !lineBuffer.empty() )
    {
        lineBuffer.push_back( '\n' );
        process_line_buffer();
    }
 
    if( NULL != outputImpl )
    {
        delete outputImpl;
        outputImpl = NULL;
    }
}

References lineBuffer, outputImpl, and process_line_buffer().

Member Function Documentation

get_rank()

int moab::ErrorOutput::get_rank ( ) const

inline

Get MPI rank.

Definition at line 53 of file ErrorOutput.hpp.

    {
        return mpiRank;
    }

References mpiRank.

Referenced by moab::MBTraceBackErrorHandler(), and process_line_buffer().

have_rank()

bool moab::ErrorOutput::have_rank ( ) const

inline

Check if MPI rank has been set.

Definition at line 48 of file ErrorOutput.hpp.

    {
        return mpiRank >= 0;
    }

References mpiRank.

Referenced by moab::MBTraceBackErrorHandler(), and process_line_buffer().

print() [1/2]

void moab::ErrorOutput::print ( const char *  str )

inline

Output the specified string.

Definition at line 67 of file ErrorOutput.hpp.

    {
        print_real( str );
    }

References print_real().

Referenced by moab::MBTraceBackErrorHandler().

print() [2/2]

void moab::ErrorOutput::print ( const std::string &  str )

inline

Output the specified string.

Definition at line 73 of file ErrorOutput.hpp.

    {
        print_real( str );
    }

References print_real().

print_real() [1/3]

void moab::ErrorOutput::print_real ( const char *  buffer )

private

Definition at line 98 of file ErrorOutput.cpp.

{
    lineBuffer.insert( lineBuffer.end(), buffer, buffer + strlen( buffer ) );
    process_line_buffer();
}

References buffer, lineBuffer, and process_line_buffer().

Referenced by print(), and printf().

print_real() [2/3]

void moab::ErrorOutput::print_real ( const char *  buffer, va_list  args1, va_list  args2  )

private

Definition at line 110 of file ErrorOutput.cpp.

{
    size_t idx = lineBuffer.size();
    // try once with remaining space in buffer
    lineBuffer.resize( lineBuffer.capacity() );
    unsigned size = vsnprintf( &lineBuffer[idx], lineBuffer.size() - idx, fmt, args1 );
    ++size;  // trailing null
    // if necessary, increase buffer size and retry
    if( size > ( lineBuffer.size() - idx ) )
    {
        lineBuffer.resize( idx + size );
        size = vsnprintf( &lineBuffer[idx], lineBuffer.size() - idx, fmt, args2 );
        ++size;  // trailing null
    }
 
    // less one because we don't want the trailing '\0'
    lineBuffer.resize( idx + size - 1 );
    process_line_buffer();
}

References lineBuffer, process_line_buffer(), and size.

print_real() [3/3]

void moab::ErrorOutput::print_real ( const std::string &  str )

private

Definition at line 104 of file ErrorOutput.cpp.

{
    lineBuffer.insert( lineBuffer.end(), str.begin(), str.end() );
    process_line_buffer();
}

References lineBuffer, and process_line_buffer().

printf()

void moab::ErrorOutput::printf ( const char *  fmt,   ...  )

inline

Output the specified printf-formatted output.

Definition at line 98 of file ErrorOutput.hpp.

{
    va_list args1, args2;
    va_start( args1, fmt );
    va_start( args2, fmt );
    print_real( fmt, args1, args2 );
    va_end( args2 );
    va_end( args1 );
}

References print_real().

Referenced by moab::MBTraceBackErrorHandler().

process_line_buffer()

void moab::ErrorOutput::process_line_buffer ( )

private

Definition at line 130 of file ErrorOutput.cpp.

{
    size_t last_idx = 0;
    std::vector< char >::iterator i;
    for( i = std::find( lineBuffer.begin(), lineBuffer.end(), '\n' ); i != lineBuffer.end();
         i = std::find( i, lineBuffer.end(), '\n' ) )
    {
        *i = '\0';
        if( have_rank() )
            outputImpl->println( get_rank(), &lineBuffer[last_idx] );
        else
            outputImpl->println( &lineBuffer[last_idx] );
        ++i;
        last_idx = i - lineBuffer.begin();
    }
 
    if( last_idx )
    {
        i = std::copy( lineBuffer.begin() + last_idx, lineBuffer.end(), lineBuffer.begin() );
        lineBuffer.erase( i, lineBuffer.end() );
    }
}

References get_rank(), have_rank(), lineBuffer, outputImpl, and moab::ErrorOutputStream::println().

Referenced by print_real(), and ~ErrorOutput().

set_rank()

void moab::ErrorOutput::set_rank ( int  rank )

inline

Set MPI rank.

Definition at line 58 of file ErrorOutput.hpp.

    {
        mpiRank = rank;
    }

References mpiRank.

use_world_rank()

void moab::ErrorOutput::use_world_rank

(

)

Set MPI rank to the rank of this process in MPI_COMM_WORLD, if MOAB is built with MPI and MPI_Init has been called.

Definition at line 87 of file ErrorOutput.cpp.

{
#ifdef MOAB_HAVE_MPI
    int flag1;
    MPI_Initialized( &flag1 );
    int flag2;
    MPI_Finalized( &flag2 );
    if( flag1 && !flag2 ) MPI_Comm_rank( MPI_COMM_WORLD, &mpiRank );
#endif
}

References mpiRank.

Referenced by moab::MBErrorHandler_Init().

Member Data Documentation

lineBuffer

std::vector< char > moab::ErrorOutput::lineBuffer

private

Definition at line 95 of file ErrorOutput.hpp.

Referenced by ErrorOutput(), print_real(), process_line_buffer(), and ~ErrorOutput().

mpiRank

int moab::ErrorOutput::mpiRank

private

Definition at line 83 of file ErrorOutput.hpp.

Referenced by get_rank(), have_rank(), set_rank(), and use_world_rank().

outputImpl

ErrorOutputStream* moab::ErrorOutput::outputImpl

private

Definition at line 82 of file ErrorOutput.hpp.

Referenced by process_line_buffer(), and ~ErrorOutput().

---

The documentation for this class was generated from the following files:

• ErrorOutput.hpp
• ErrorOutput.cpp