zypp::filesystem::Pathname Class Reference

Pathname. More...

#include <Pathname.h>

List of all members.

Public Member Functions
	Pathname ()
	Default ctor: an empty path.
	Pathname (const std::string &name_tv)
	Ctor from string.
	Pathname (const char *name_tv)
	Ctor from char*.
Pathname &	operator= (const Pathname &path_tv)
	Assign.
Pathname &	operator/= (const Pathname &path_tv)
	Concatenate and assing.
Pathname &	operator+= (const Pathname &path_tv)
	Concatenate and assing.
const std::string &	asString () const
	String representation.
Url	asUrl () const
	Url representation using dir schema.
const char *	c_str () const
	String representation.
bool	empty () const
	Test for an empty path.
bool	absolute () const
	Test for an absolute path.
bool	relative () const
	Test for a relative path.
Pathname	dirname () const
	Return all but the last component od this path.
std::string	basename () const
	Return the last component of this path.
std::string	extension () const
	Return all of the characters in name after and including the last dot in the last element of name.
Pathname	absolutename () const
	Return this path, adding a leading '/' if relative.
Pathname	relativename () const
	Return this path, removing a leading '/' if absolute.
Pathname	cat (const Pathname &r) const
	Concatenation of pathnames.
Pathname	extend (const std::string &r) const
	Append string r to the last component of the path.
Static Public Member Functions
static Pathname	dirname (const Pathname &name_tv)
static std::string	basename (const Pathname &name_tv)
static std::string	extension (const Pathname &name_tv)
static Pathname	absolutename (const Pathname &name_tv)
static Pathname	relativename (const Pathname &name_tv)
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_tv)
Private Attributes
std::string::size_type	prfx_i
std::string	name_t
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.
Pathname	operator+ (const Pathname &l, const Pathname &r)
	Concatenate two Pathname.
std::ostream &	operator<< (std::ostream &str, const Pathname &obj)
	Stream output.

---

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")

Todo:

Review. Maybe use COW pimpl, ckeck storage.

Todo:

EXPLICIT ctors.

Definition at line 45 of file Pathname.h.

---

Constructor & Destructor Documentation

zypp::filesystem::Pathname::Pathname

(

)

[inline]

Default ctor: an empty path.

Definition at line 49 of file Pathname.h.

zypp::filesystem::Pathname::Pathname

(

const std::string &

name_tv

)

[inline]

Ctor from string.

Definition at line 54 of file Pathname.h.

References _assign().

zypp::filesystem::Pathname::Pathname

(

const char *

name_tv

)

[inline]

Ctor from char*.

Definition at line 58 of file Pathname.h.

References _assign().

---

Member Function Documentation

Pathname& zypp::filesystem::Pathname::operator=

(

const Pathname &

path_tv

)

[inline]

Assign.

Definition at line 62 of file Pathname.h.

References name_t, and prfx_i.

Pathname& zypp::filesystem::Pathname::operator/=

(

const Pathname &

path_tv

)

[inline]

Concatenate and assing.

See also:

cat

Definition at line 70 of file Pathname.h.

References cat().

Pathname& zypp::filesystem::Pathname::operator+=

(

const Pathname &

path_tv

)

[inline]

Concatenate and assing.

See also:

cat

Deprecated:

: use /=

Definition at line 76 of file Pathname.h.

References cat().

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

(

)

const [inline]

String representation.

Definition at line 80 of file Pathname.h.

References name_t.

Referenced by zypp::filesystem::assert_dir(), zypp::filesystem::PathInfo::asString(), asUrl(), basename(), zypp::filesystem::PathInfo::c_str(), cat(), zypp::filesystem::checksum(), zypp::filesystem::chmod(), zypp::filesystem::copy(), zypp::filesystem::copy_dir(), zypp::filesystem::copy_dir_content(), zypp::filesystem::copy_file2dir(), zypp::filesystem::hardlink(), zypp::filesystem::is_empty_dir(), zypp::filesystem::md5sum(), zypp::filesystem::mkdir(), operator!=(), zypp::filesystem::PathInfo::operator()(), operator<<(), operator==(), zypp::filesystem::rename(), zypp::filesystem::symlink(), zypp::filesystem::TmpDir::TmpDir(), zypp::filesystem::TmpFile::TmpFile(), and zypp::filesystem::zipType().

Url zypp::filesystem::Pathname::asUrl

(

)

const

Url representation using dir schema.

Definition at line 236 of file Pathname.cc.

References asString(), and zypp::Url::setPathName().

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

(

)

const [inline]

String representation.

Definition at line 87 of file Pathname.h.

References name_t.

Referenced by zypp::filesystem::df().

bool zypp::filesystem::Pathname::empty

(

)

const [inline]

Test for an empty path.

Definition at line 91 of file Pathname.h.

References name_t.

Referenced by absolute(), zypp::filesystem::assert_dir(), basename(), cat(), dirname(), extension(), zypp::filesystem::PathInfo::operator()(), relative(), and zypp::filesystem::TmpPath::Impl::~Impl().

bool zypp::filesystem::Pathname::absolute

(

)

const [inline]

Test for an absolute path.

Definition at line 93 of file Pathname.h.

References empty(), name_t, and prfx_i.

Referenced by relativename().

bool zypp::filesystem::Pathname::relative

(

)

const [inline]

Test for a relative path.

Definition at line 95 of file Pathname.h.

References empty(), name_t, and prfx_i.

Referenced by absolutename(), and zypp::filesystem::assert_dir().

Pathname zypp::filesystem::Pathname::dirname

(

)

const [inline]

Return all but the last component od this path.

Definition at line 98 of file Pathname.h.

Referenced by zypp::filesystem::TmpDir::makeSibling(), and zypp::filesystem::TmpFile::makeSibling().

Pathname zypp::filesystem::Pathname::dirname

(

const Pathname &

name_tv

)

[static]

Definition at line 190 of file Pathname.cc.

References empty(), name_t, and prfx_i.

std::string zypp::filesystem::Pathname::basename

(

)

const [inline]

Return the last component of this path.

Definition at line 102 of file Pathname.h.

Referenced by zypp::filesystem::copy_dir(), extension(), zypp::filesystem::TmpDir::makeSibling(), and zypp::filesystem::TmpFile::makeSibling().

string zypp::filesystem::Pathname::basename

(

const Pathname &

name_tv

)

[static]

Definition at line 216 of file Pathname.cc.

References asString(), empty(), and prfx_i.

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 109 of file Pathname.h.

string zypp::filesystem::Pathname::extension

(

const Pathname &

name_tv

)

[static]

Definition at line 248 of file Pathname.cc.

References basename(), and empty().

Pathname zypp::filesystem::Pathname::absolutename

(

)

const [inline]

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

Definition at line 113 of file Pathname.h.

static Pathname zypp::filesystem::Pathname::absolutename

(

const Pathname &

name_tv

)

[inline, static]

Definition at line 114 of file Pathname.h.

References cat(), and relative().

Pathname zypp::filesystem::Pathname::relativename

(

)

const [inline]

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

Definition at line 118 of file Pathname.h.

static Pathname zypp::filesystem::Pathname::relativename

(

const Pathname &

name_tv

)

[inline, static]

Definition at line 119 of file Pathname.h.

References absolute(), and cat().

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 130 of file Pathname.h.

Referenced by absolutename(), operator+(), operator+=(), operator/(), operator/=(), and relativename().

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

Definition at line 265 of file Pathname.cc.

References asString(), empty(), and prfx_i.

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 138 of file Pathname.h.

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

void zypp::filesystem::Pathname::_assign

(

const std::string &

name_tv

)

[private]

Referenced by Pathname().

---

Friends And Related Function Documentation

bool operator==	(	const Pathname &	l,
		const Pathname &	r
	)			[related]

Definition at line 150 of file Pathname.h.

References asString().

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

Definition at line 154 of file Pathname.h.

References asString().

Pathname operator/	(	const Pathname &	l,
		const Pathname &	r
	)			[related]

Concatenate two Pathname.

Definition at line 158 of file Pathname.h.

References cat().

Pathname operator+	(	const Pathname &	l,
		const Pathname &	r
	)			[related]

Concatenate two Pathname.

Deprecated:

: use /

Definition at line 164 of file Pathname.h.

References cat().

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

Stream output.

Definition at line 170 of file Pathname.h.

References asString().

---

Member Data Documentation

std::string::size_type zypp::filesystem::Pathname::prfx_i [private]

Definition at line 142 of file Pathname.h.

Referenced by absolute(), basename(), cat(), dirname(), operator=(), and relative().

std::string zypp::filesystem::Pathname::name_t [private]

Definition at line 143 of file Pathname.h.

Referenced by absolute(), asString(), c_str(), dirname(), empty(), operator=(), and relative().

---

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

• zypp/Pathname.h
• zypp/Pathname.cc

---