libzypp  15.28.6
zypp::UserRequestException Class Reference

Base for exceptions caused by explicit user request. More...

#include <UserRequestException.h>

Inheritance diagram for zypp::UserRequestException:

Public Types

enum  Kind {
  UNSPECIFIED, IGNORE, SKIP, RETRY,
  ABORT
}
 
- Public Types inherited from zypp::Exception
typedef
exception_detail::CodeLocation 
CodeLocation
 
typedef std::list< std::string > History
 
typedef History::const_iterator HistoryIterator
 
typedef History::size_type HistorySize
 

Public Member Functions

 UserRequestException (const std::string &msg_r=std::string())
 
 UserRequestException (const std::string &msg_r, const Exception &history_r)
 
 UserRequestException (Kind kind_r, const std::string &msg_r=std::string())
 
 UserRequestException (Kind kind_r, const std::string &msg_r, const Exception &history_r)
 
Kind kind () const
 
- Public Member Functions inherited from zypp::Exception
 Exception ()
 Default ctor. More...
 
 Exception (const std::string &msg_r)
 Ctor taking a message. More...
 
 Exception (const std::string &msg_r, const Exception &history_r)
 Ctor taking a message and an exception to remember as history. More...
 
virtual ~Exception () throw ()
 Dtor. More...
 
const CodeLocationwhere () const
 Return CodeLocation. More...
 
void relocate (const CodeLocation &where_r) const
 Exchange location on rethrow. More...
 
const std::string & msg () const
 Return the message string provided to the ctor. More...
 
std::string asString () const
 Error message provided by dumpOn as string. More...
 
std::string asUserString () const
 Translated error message as string suitable for the user. More...
 
void remember (const Exception &old_r)
 Store an other Exception as history. More...
 
void addHistory (const std::string &msg_r)
 Add some message text to the history. More...
 
HistoryIterator historyBegin () const
 Iterator pointing to the most recent message. More...
 
HistoryIterator historyEnd () const
 Iterator pointing behind the last message. More...
 
bool historyEmpty () const
 Whether the history list is empty. More...
 
HistorySize historySize () const
 The size of the history list. More...
 
std::string historyAsString () const
 The history as string. More...
 
std::string asUserHistory () const
 A single (multiline) string composed of asUserString and historyAsString. More...
 

Protected Member Functions

virtual std::ostream & dumpOn (std::ostream &str) const
 Overload this to print a proper error message. More...
 

Private Attributes

Kind _kind
 

Additional Inherited Members

- Static Public Member Functions inherited from zypp::Exception
static std::string strErrno (int errno_r)
 Make a string from errno_r. More...
 
static std::string strErrno (int errno_r, const std::string &msg_r)
 Make a string from errno_r and msg_r. More...
 
static void log (const Exception &excpt_r, const CodeLocation &where_r, const char *const prefix_r)
 Drop a logline on throw, catch or rethrow. More...
 

Detailed Description

Base for exceptions caused by explicit user request.

Use the derived convenience classes to throw exceptions of a certain kind.

ProgressData ticks( makeProgressData( input_r ) );
ticks.sendTo( fnc_r );
ticks.toMin(); // start sending min (0)
iostr::EachLine line( input_r );
for( ; line; line.next() )
{
// process the line
if ( ! ticks.set( input_r.stream().tellg() ) )
ZYPP_THROW( AbortRequestException( "" ) );
}
// either this way
catch ( const AbortRequestException & excpt_r )
{
...
}
// or that
catch ( const UserRequestException & excpt_r )
{
switch ( excpt_r.kind() )
{
...
break;
}
}

Definition at line 64 of file UserRequestException.h.

Member Enumeration Documentation

Enumerator
UNSPECIFIED 
IGNORE 
SKIP 
RETRY 
ABORT 

Definition at line 67 of file UserRequestException.h.

Constructor & Destructor Documentation

zypp::UserRequestException::UserRequestException ( const std::string &  msg_r = std::string())
explicit

Definition at line 28 of file UserRequestException.cc.

zypp::UserRequestException::UserRequestException ( const std::string &  msg_r,
const Exception history_r 
)

Definition at line 32 of file UserRequestException.cc.

zypp::UserRequestException::UserRequestException ( Kind  kind_r,
const std::string &  msg_r = std::string() 
)
explicit

Definition at line 36 of file UserRequestException.cc.

zypp::UserRequestException::UserRequestException ( Kind  kind_r,
const std::string &  msg_r,
const Exception history_r 
)

Definition at line 40 of file UserRequestException.cc.

Member Function Documentation

Kind zypp::UserRequestException::kind ( ) const
inline

Definition at line 76 of file UserRequestException.h.

std::ostream & zypp::UserRequestException::dumpOn ( std::ostream &  str) const
protectedvirtual

Overload this to print a proper error message.

Reimplemented from zypp::Exception.

Definition at line 49 of file UserRequestException.cc.

Member Data Documentation

Kind zypp::UserRequestException::_kind
private

Definition at line 81 of file UserRequestException.h.


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