dunedaq::oks::Comment Class Reference

The comment about file modification. A comment can be added when user saves file using OKS tools. More...

#include <file.hpp>

Public Member Functions
const std::string &	get_created_by () const
const std::string &	get_author () const
const std::string &	get_created_on () const
const std::string &	get_text () const
void	validate (const std::string &creation_time)
void	validate ()

Private Member Functions
	Comment () noexcept
	Comment (const std::string &text, const std::string &author)
	Comment (const oks::Comment &src) noexcept

Private Attributes
std::string	p_created_by
std::string	p_author
std::string	p_created_on
std::string	p_text

Friends
class	OksFile

Detailed Description

The comment about file modification. A comment can be added when user saves file using OKS tools.

Definition at line 293 of file file.hpp.

Constructor & Destructor Documentation

Comment() [1/3]

dunedaq::oks::Comment::Comment ( )

inlineprivatenoexcept

The constructor creates comment read from file. Only OksFile is allowed to create comments.

Definition at line 300 of file file.hpp.

{ ; }

Comment() [2/3]

dunedaq::oks::oks::Comment::Comment ( const std::string & text, const std::string & author )

private

The constructor creates new comment from text. Only OksFile is allowed to create comments.

Exceptions

Throw

std::exception in case of problems.

Definition at line 669 of file file.cpp.

  : p_created_by(OksKernel::get_user_name())
  , p_author(author)
  , p_created_on(OksKernel::get_host_name())
  , p_text(text)
{
  validate();
}

Comment() [3/3]

dunedaq::oks::oks::Comment::Comment ( const oks::Comment & src )

privatenoexcept

The copy constructor. Only OksFile is allowed to create comments.

Definition at line 678 of file file.cpp.

  : p_created_by(src.p_created_by)
  , p_author(src.p_author)
  , p_created_on(src.p_created_on)
  , p_text(src.p_text)
{
}

Member Function Documentation

get_author()

const std::string & dunedaq::oks::Comment::get_author ( ) const

inline

The name of author created comment (as defined from user input, e.g. first and last name, email address, etc.).

Definition at line 314 of file file.hpp.

{ return p_author; }

get_created_by()

const std::string & dunedaq::oks::Comment::get_created_by ( ) const

inline

The name of user created comment (as defined by process ID).

Definition at line 311 of file file.hpp.

{ return p_created_by; }

get_created_on()

const std::string & dunedaq::oks::Comment::get_created_on ( ) const

inline

The name of host where comment was created.

Definition at line 317 of file file.hpp.

{ return p_created_on; }

get_text()

const std::string & dunedaq::oks::Comment::get_text ( ) const

inline

The comment text.

Definition at line 320 of file file.hpp.

{ return p_text; }

validate() [1/2]

void dunedaq::oks::oks::Comment::validate

(

)

Validate text of the comment.

Exceptions

Throw

std::exception if it is empty.

Definition at line 662 of file file.cpp.

{
  if (p_text.empty()) {
    throw std::runtime_error("text is empty");
  }
}

validate() [2/2]

void dunedaq::oks::oks::Comment::validate

(

const std::string &

creation_time

)

Parse creation time-stamp and validate text.

Exceptions

Throw

std::exception in case of problems.

Definition at line 649 of file file.cpp.

{
  // YYYYMMDDThhmmss
  if (creation_time.size() != 15 || creation_time[8] != 'T') {
    std::ostringstream msg;
    msg << "the creation time \'" << creation_time << "\' is not an ISO-8601 date-time";
    throw std::runtime_error(msg.str().c_str());
  }
 
  validate();
}

Friends And Related Symbol Documentation

OksFile

friend class OksFile

friend

Definition at line 296 of file file.hpp.

Member Data Documentation

p_author

std::string dunedaq::oks::Comment::p_author

private

Definition at line 330 of file file.hpp.

p_created_by

std::string dunedaq::oks::Comment::p_created_by

private

Definition at line 329 of file file.hpp.

p_created_on

std::string dunedaq::oks::Comment::p_created_on

private

Definition at line 331 of file file.hpp.

p_text

std::string dunedaq::oks::Comment::p_text

private

Definition at line 332 of file file.hpp.

---

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

• /github/workspace/dunedaq/sourcecode/oks/include/oks/file.hpp
• /github/workspace/dunedaq/sourcecode/oks/src/file.cpp