Pathname. More...

#include <Pathname.h>

Public Member Functions
	Pathname ()
	Default ctor: an empty path. More...

	Pathname (const std::string &name_r)
	Ctor from string. More...

	Pathname (const char *name_r)
	Ctor from char*. More...

	Pathname (const Pathname &rhs)
	Copy Ctor. More...

	Pathname (Pathname &&tmp)
	Move Ctor. More...

Pathname &	operator= (Pathname rhs)
	Assign. More...

Pathname &	operator/= (const Pathname &path_tv)
	Concatenate and assign. More...

Pathname &	operator+= (const Pathname &path_tv)
	Concatenate and assign. More...

const std::string &	asString () const
	String representation. More...

Url	asUrl (const std::string &scheme_r) const
	Url representation using `scheme_r` schema . More...

Url	asUrl () const

Url	asDirUrl () const

Url	asFileUrl () const

const char *	c_str () const
	String representation. More...

bool	empty () const
	Test for an empty path. More...

bool	absolute () const
	Test for an absolute path. More...

bool	relative () const
	Test for a relative path. More...

bool	emptyOrRoot () const
	Test for "" or "/". More...

Pathname	dirname () const
	Return all but the last component od this path. More...

std::string	basename () const
	Return the last component of this path. More...

std::string	extension () const
	Return all of the characters in name after and including the last dot in the last element of name. More...

Pathname	absolutename () const
	Return this path, adding a leading '/' if relative. More...

Pathname	relativename () const
	Return this path, removing a leading '/' if absolute. More...

Pathname	realpath () const
	Returns this path as the absolute canonical pathname. More...

Pathname	cat (const Pathname &r) const
	Concatenation of pathnames. More...

Pathname	extend (const std::string &r) const
	Append string r to the last component of the path. More...

Static Public Member Functions
static std::string	showRoot (const Pathname &root_r, const Pathname &path_r)
	String representation as "(root)/path". More...

static std::string	showRootIf (const Pathname &root_r, const Pathname &path_r)
	String representation as "(root)/path", unless root is `"/"` or empty. More...

static Pathname	dirname (const Pathname &name_r)

static std::string	basename (const Pathname &name_r)

static std::string	extension (const Pathname &name_r)

static Pathname	absolutename (const Pathname &name_r)

static Pathname	relativename (const Pathname &name_r)

static Pathname	assertprefix (const Pathname &root_r, const Pathname &path_r)
	Return `path_r` prefixed with `root_r`, unless it is already prefixed. More...

static Pathname	stripprefix (const Pathname &root_r, const Pathname &path_r)
	Return `path_r` with any `root_r` dir prefix striped. More...

static Pathname	cat (const Pathname &l, const Pathname &r)

static Pathname	extend (const Pathname &l, const std::string &r)

Private Member Functions
void	_assign (const std::string &name_r)

Private Attributes
std::string	_name

Friends
void	swap (Pathname &lhs, Pathname &rhs)
	Swap. More...

Related Functions
(Note that these are not member functions.)
bool	operator== (const Pathname &l, const Pathname &r)

bool	operator!= (const Pathname &l, const Pathname &r)

Pathname	operator/ (const Pathname &l, const Pathname &r)
	Concatenate two Pathname. More...

Pathname	operator+ (const Pathname &l, const Pathname &r)
	Concatenate two Pathname. More...

bool	operator< (const Pathname &l, const Pathname &r)

std::ostream &	operator<< (std::ostream &str, const Pathname &obj)
	Stream output. More...

Detailed Description

Pathname.

Note: For convenience Pathname is available as zypp::Pathname too.

Always stores normalized paths (no inner '.' or '..' components and no consecutive '/'es). Concatenation automatically adds the path separator '/'.

Todo:: Add support for handling extensions incl. stripping extensions from basename (basename("/path/foo.baa", ".baa") ==> "foo")

Definition at line 44 of file Pathname.h.

Constructor & Destructor Documentation

◆ Pathname() [1/5]

zypp::filesystem::Pathname::Pathname ( )

inline

Default ctor: an empty path.

Definition at line 48 of file Pathname.h.

◆ Pathname() [2/5]

zypp::filesystem::Pathname::Pathname ( const std::string & name_r )

inline

Ctor from string.

Definition at line 52 of file Pathname.h.

◆ Pathname() [3/5]

zypp::filesystem::Pathname::Pathname ( const char * name_r )

inline

Ctor from char*.

Definition at line 56 of file Pathname.h.

◆ Pathname() [4/5]

zypp::filesystem::Pathname::Pathname ( const Pathname & rhs )

inline

Copy Ctor.

Definition at line 60 of file Pathname.h.

◆ Pathname() [5/5]

zypp::filesystem::Pathname::Pathname ( Pathname && tmp )

inline

Move Ctor.

Definition at line 72 of file Pathname.h.

Member Function Documentation

◆ operator=()

Pathname & zypp::filesystem::Pathname::operator= ( Pathname rhs )

inline

Assign.

Definition at line 77 of file Pathname.h.

◆ operator/=()

Pathname & zypp::filesystem::Pathname::operator/= ( const Pathname & path_tv )

inline

Concatenate and assign.

See also: cat

Definition at line 81 of file Pathname.h.

◆ operator+=()

Pathname & zypp::filesystem::Pathname::operator+= ( const Pathname & path_tv )

inline

Concatenate and assign.

See also: cat

Deprecated:: : use /=

Definition at line 87 of file Pathname.h.

◆ asString()

const std::string & zypp::filesystem::Pathname::asString ( ) const

inline

String representation.

Definition at line 91 of file Pathname.h.

◆ showRoot()

std::string zypp::filesystem::Pathname::showRoot	(	const Pathname &	root_r,
		const Pathname &	path_r
	)

static

String representation as "(root)/path".

Definition at line 189 of file Pathname.cc.

◆ showRootIf()

std::string zypp::filesystem::Pathname::showRootIf	(	const Pathname &	root_r,
		const Pathname &	path_r
	)

static

String representation as "(root)/path", unless root is "/" or empty.

Definition at line 194 of file Pathname.cc.

◆ asUrl() [1/2]

Url zypp::filesystem::Pathname::asUrl ( const std::string & scheme_r ) const

Url representation using scheme_r schema .

Definition at line 171 of file Pathname.cc.

◆ asUrl() [2/2]

Url zypp::filesystem::Pathname::asUrl ( ) const

Definition at line 179 of file Pathname.cc.

◆ asDirUrl()

Url zypp::filesystem::Pathname::asDirUrl ( ) const

Definition at line 182 of file Pathname.cc.

◆ asFileUrl()

Url zypp::filesystem::Pathname::asFileUrl ( ) const

Definition at line 185 of file Pathname.cc.

◆ c_str()

const char * zypp::filesystem::Pathname::c_str ( ) const

inline

String representation.

Definition at line 110 of file Pathname.h.

◆ empty()

bool zypp::filesystem::Pathname::empty ( ) const

inline

Test for an empty path.

Definition at line 114 of file Pathname.h.

◆ absolute()

bool zypp::filesystem::Pathname::absolute ( ) const

inline

Test for an absolute path.

Definition at line 116 of file Pathname.h.

◆ relative()

bool zypp::filesystem::Pathname::relative ( ) const

inline

Test for a relative path.

Definition at line 118 of file Pathname.h.

◆ emptyOrRoot()

bool zypp::filesystem::Pathname::emptyOrRoot ( ) const

inline

Test for "" or "/".

Definition at line 121 of file Pathname.h.

◆ dirname() [1/2]

Pathname zypp::filesystem::Pathname::dirname ( ) const

inline

Return all but the last component od this path.

Definition at line 124 of file Pathname.h.

◆ dirname() [2/2]

Pathname zypp::filesystem::Pathname::dirname ( const Pathname & name_r )

static

Definition at line 128 of file Pathname.cc.

◆ basename() [1/2]

std::string zypp::filesystem::Pathname::basename ( ) const

inline

Return the last component of this path.

Definition at line 128 of file Pathname.h.

◆ basename() [2/2]

string zypp::filesystem::Pathname::basename ( const Pathname & name_r )

static

Definition at line 152 of file Pathname.cc.

◆ extension() [1/2]

std::string zypp::filesystem::Pathname::extension ( ) const

inline

Return all of the characters in name after and including the last dot in the last element of name.

If there is no dot in the last element of name then returns the empty string.

Definition at line 135 of file Pathname.h.

◆ extension() [2/2]

string zypp::filesystem::Pathname::extension ( const Pathname & name_r )

static

Definition at line 206 of file Pathname.cc.

◆ absolutename() [1/2]

Pathname zypp::filesystem::Pathname::absolutename ( ) const

inline

Return this path, adding a leading '/' if relative.

Definition at line 139 of file Pathname.h.

◆ absolutename() [2/2]

static Pathname zypp::filesystem::Pathname::absolutename ( const Pathname & name_r )

inlinestatic

Definition at line 140 of file Pathname.h.

◆ relativename() [1/2]

Pathname zypp::filesystem::Pathname::relativename ( ) const

inline

Return this path, removing a leading '/' if absolute.

Definition at line 144 of file Pathname.h.

◆ relativename() [2/2]

static Pathname zypp::filesystem::Pathname::relativename ( const Pathname & name_r )

inlinestatic

Definition at line 145 of file Pathname.h.

◆ realpath()

Pathname zypp::filesystem::Pathname::realpath ( ) const

Returns this path as the absolute canonical pathname.

Definition at line 230 of file Pathname.cc.

◆ assertprefix()

Pathname zypp::filesystem::Pathname::assertprefix	(	const Pathname &	root_r,
		const Pathname &	path_r
	)

static

Return path_r prefixed with root_r, unless it is already prefixed.

Definition at line 271 of file Pathname.cc.

◆ stripprefix()

Pathname zypp::filesystem::Pathname::stripprefix	(	const Pathname &	root_r,
		const Pathname &	path_r
	)

static

Return path_r with any root_r dir prefix striped.

Definition at line 280 of file Pathname.cc.

◆ cat() [1/2]

Pathname zypp::filesystem::Pathname::cat ( const Pathname & r ) const

inline

Concatenation of pathnames.

"foo"  / "baa"  ==> "foo/baa"
"foo/" / "baa"  ==> "foo/baa"
"foo"  / "/baa" ==> "foo/baa"
"foo/" / "/baa" ==> "foo/baa"

Definition at line 165 of file Pathname.h.

◆ cat() [2/2]

Pathname zypp::filesystem::Pathname::cat	(	const Pathname &	l,
		const Pathname &	r
	)

static

Definition at line 297 of file Pathname.cc.

◆ extend() [1/2]

Pathname zypp::filesystem::Pathname::extend ( const std::string & r ) const

inline

Append string r to the last component of the path.

"foo/baa".extend( ".h" ) ==> "foo/baa.h"

Definition at line 173 of file Pathname.h.

◆ extend() [2/2]

static Pathname zypp::filesystem::Pathname::extend	(	const Pathname &	l,
		const std::string &	r
	)

static

◆ _assign()

void zypp::filesystem::Pathname::_assign ( const std::string & name_r )

private

Definition at line 32 of file Pathname.cc.

Friends And Related Function Documentation

◆ swap

void swap	(	Pathname &	lhs,
		Pathname &	rhs
	)

friend

Swap.

Definition at line 65 of file Pathname.h.

◆ operator==()

bool operator==	(	const Pathname &	l,
		const Pathname &	r
	)

◆ operator!=()

bool operator!=	(	const Pathname &	l,
		const Pathname &	r
	)

◆ operator/()

Pathname operator/	(	const Pathname &	l,
		const Pathname &	r
	)

Definition at line 191 of file Pathname.h.

◆ operator+()

Pathname operator+	(	const Pathname &	l,
		const Pathname &	r
	)

Deprecated:: : use /

Definition at line 197 of file Pathname.h.

◆ operator<()

bool operator<	(	const Pathname &	l,
		const Pathname &	r
	)

◆ operator<<()

std::ostream & operator<<	(	std::ostream &	str,
		const Pathname &	obj
	)

Definition at line 207 of file Pathname.h.

Member Data Documentation

◆ _name

std::string zypp::filesystem::Pathname::_name

private

Definition at line 177 of file Pathname.h.

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

zypp/Pathname.h
zypp-core/Pathname.cc

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Friends

Related Functions

Detailed Description

Constructor & Destructor Documentation

◆ Pathname() [1/5]

◆ Pathname() [2/5]

◆ Pathname() [3/5]

◆ Pathname() [4/5]

◆ Pathname() [5/5]

Member Function Documentation

◆ operator=()

◆ operator/=()

◆ operator+=()

◆ asString()

◆ showRoot()

◆ showRootIf()

◆ asUrl() [1/2]

◆ asUrl() [2/2]

◆ asDirUrl()

◆ asFileUrl()

◆ c_str()

◆ empty()

◆ absolute()

◆ relative()

◆ emptyOrRoot()

◆ dirname() [1/2]

◆ dirname() [2/2]

◆ basename() [1/2]

◆ basename() [2/2]

◆ extension() [1/2]

◆ extension() [2/2]

◆ absolutename() [1/2]

◆ absolutename() [2/2]

◆ relativename() [1/2]

◆ relativename() [2/2]

◆ realpath()

◆ assertprefix()

◆ stripprefix()

◆ cat() [1/2]

◆ cat() [2/2]

◆ extend() [1/2]

◆ extend() [2/2]

◆ _assign()

Friends And Related Function Documentation

◆ swap

◆ operator==()

◆ operator!=()

◆ operator/()

◆ operator+()

◆ operator<()

◆ operator<<()

Member Data Documentation

◆ _name