JDATABASE::JUPI Struct Reference

Universal product identifier (UPI). More...

#include <JUPI.hh>

Inheritance diagram for JDATABASE::JUPI:

Public Member Functions
	JUPI ()
	Default constructor. More...
	JUPI (const JPBS &pbs, const std::string &variant="")
	Constructor. More...
	JUPI (const std::string &upi)
	Constructor. More...
const JUPI &	getUPI () const
	Get UPI. More...
const std::string &	getVariant () const
	Get variant. More...
	ClassDefNV (JUPI, 1)
const JPBS &	getPBS () const
	Get PBS. More...
bool	is_valid () const
	Check validity. More...
	ClassDefNV (JPBS, 1)

Static Public Attributes
static const char	DOT = '.'
	Separator between PBS values. More...
static const char	SEPARATOR = '/'
	Separator between PBS and variant. More...

Protected Attributes
std::string	variant

Friends
bool	operator== (const JUPI &first, const JUPI &second)
	Equality. More...
bool	operator< (const JUPI &first, const JUPI &second)
	Less-than operator. More...
std::istream &	operator>> (std::istream &in, JUPI &object)
	Read UPI from input stream. More...
std::ostream &	operator<< (std::ostream &out, const JUPI &object)
	Write UPI to output stream. More...

Detailed Description

Universal product identifier (UPI).

The UPI consists of a PBS and a variant, seperated by JPBS::SEPARATOR.
The ASCII format should therefore read "<int>[.<int>]+/<variant>".
The variant cannot start with any kind of white space.

Definition at line 30 of file JUPI.hh.

Constructor & Destructor Documentation

JDATABASE::JUPI::JUPI ( )

inline

Default constructor.

Definition at line 36 of file JUPI.hh.

    {}

JDATABASE::JUPI::JUPI ( const JPBS &  pbs, const std::string &  variant = ""  )

inline

Constructor.

Parameters

pbs	PBS
variant	variant

Definition at line 46 of file JUPI.hh.

                                                         :
      JPBS   (pbs),
      variant(variant)
    {}

JDATABASE::JUPI::JUPI ( const std::string &  upi )

inline

Constructor.

Parameters

upi

UPI

Definition at line 57 of file JUPI.hh.

    {
      std::istringstream(upi) >> *this;
    }

Member Function Documentation

const JUPI& JDATABASE::JUPI::getUPI ( ) const

inline

Get UPI.

Returns

UPI

Definition at line 68 of file JUPI.hh.

    {
      return static_cast<const JUPI&>(*this);
    }

const std::string& JDATABASE::JUPI::getVariant ( ) const

inline

Get variant.

Returns

variant

Definition at line 79 of file JUPI.hh.

    {
      return variant;
    }

JDATABASE::JUPI::ClassDefNV	(	JUPI	,
		1
	)

const JPBS& JDATABASE::JPBS::getPBS ( ) const

inlineinherited

Get PBS.

Returns

PBS

Definition at line 105 of file JPBS.hh.

    {
      return static_cast<const JPBS&>(*this);
    }

bool JDATABASE::JPBS::is_valid ( ) const

inlineinherited

Check validity.

Returns

true if valid; else false

Definition at line 116 of file JPBS.hh.

    {
      return !this->empty();
    }

JDATABASE::JPBS::ClassDefNV ( JPBS  , 1    )

inherited

Friends And Related Function Documentation

bool operator== ( const JUPI &  first, const JUPI &  second  )

friend

Equality.

Parameters

first	first UPI
second	second UPI

Returns

true if UPIs are equals; else false

Definition at line 92 of file JUPI.hh.

    {
      return (first.getPBS()     == second.getPBS()    &&
              first.getVariant() == second.getVariant()); 
    }

bool operator< ( const JUPI &  first, const JUPI &  second  )

friend

Less-than operator.

Parameters

first	first UPI
second	second UPI

Returns

true if first UPI higher in hierarchy or lesser variant; else false

Definition at line 106 of file JUPI.hh.

    {
      if (first.getPBS() == second.getPBS())
        return first.getVariant() < second.getVariant();
      else
        return first.getPBS()     < second.getPBS();
    }

std::istream& operator>> ( std::istream &  in, JUPI &  object  )

friend

Read UPI from input stream.

Parameters

in	input stream
object	UPI

Returns

input stream

Definition at line 122 of file JUPI.hh.

    {
      using namespace std;

      object.variant.clear();

      if (in >> static_cast<JPBS&>(object)) {

        if (in.get() == (int) JPBS::SEPARATOR) {

          const int c = in.peek();

          if (c != EOF && !isspace(c)) 
            in >> object.variant;
          else
            in.setstate(ios::failbit);

        } else {

          in.setstate(ios::failbit);
        }
      }

      return in;
    }

std::ostream& operator<< ( std::ostream &  out, const JUPI &  object  )

friend

Write UPI to output stream.

Parameters

out	output stream
object	UPI

Returns

output stream

Definition at line 156 of file JUPI.hh.

    {
      using namespace std;

      ostringstream os;

      os << object.getPBS() << JPBS::SEPARATOR << object.getVariant();

      return out << os.str();
    }

Member Data Documentation

std::string JDATABASE::JUPI::variant

protected

Definition at line 170 of file JUPI.hh.

const char JDATABASE::JPBS::DOT = '.'

staticinherited

Separator between PBS values.

Definition at line 33 of file JPBS.hh.

const char JDATABASE::JPBS::SEPARATOR = '/'

staticinherited

Separator between PBS and variant.

Definition at line 39 of file JPBS.hh.

---

The documentation for this struct was generated from the following file:

• JUPI.hh