String class for D-Bus object paths in Glib::Variant. More...

#include <glibmm/variantdbusstring.h>

Inheritance diagram for Glib::DBusObjectPathString:

Public Member Functions
	ustring ()

	ustring (const ustring & other)

	ustring (ustring && other)

	ustring (const std::string & src)

	ustring (std::string && src)

	ustring (const ustring & src, size_type i, size_type n=npos)

	ustring (const char * src, size_type n)

	ustring (const char * src)

	ustring (size_type n, gunichar uc)

	ustring (size_type n, char c)

template<class In>
	ustring (In pbegin, In pend)

Public Member Functions inherited from Glib::ustring
	ustring ()

	~ustring () noexcept

	ustring (const ustring & other)

	ustring (ustring && other)

ustring &	operator= (const ustring & other)

ustring &	operator= (ustring && other)

void	swap (ustring & other)

	ustring (const std::string & src)

	ustring (std::string && src)

	ustring (const ustring & src, size_type i, size_type n=npos)

	ustring (const char * src, size_type n)

	ustring (const char * src)

	ustring (size_type n, gunichar uc)

	ustring (size_type n, char c)

template<class In>
	ustring (In pbegin, In pend)

ustring &	operator= (const std::string & src)

ustring &	operator= (std::string && src)

ustring &	operator= (const char * src)

ustring &	operator= (gunichar uc)

ustring &	operator= (char c)

ustring &	assign (const ustring & src)

ustring &	assign (ustring && src)

ustring &	assign (const ustring & src, size_type i, size_type n)

ustring &	assign (const char * src, size_type n)

ustring &	assign (const char * src)

ustring &	assign (size_type n, gunichar uc)

ustring &	assign (size_type n, char c)

template<class In>
ustring &	assign (In pbegin, In pend)

ustring &	operator+= (const ustring & src)

ustring &	operator+= (const char * src)

ustring &	operator+= (gunichar uc)

ustring &	operator+= (char c)

void	push_back (gunichar uc)

void	push_back (char c)

ustring &	append (const ustring & src)

ustring &	append (const ustring & src, size_type i, size_type n)

ustring &	append (const char * src, size_type n)

ustring &	append (const char * src)

ustring &	append (size_type n, gunichar uc)

ustring &	append (size_type n, char c)

template<class In>
ustring &	append (In pbegin, In pend)

ustring &	insert (size_type i, const ustring & src)

ustring &	insert (size_type i, const ustring & src, size_type i2, size_type n)

ustring &	insert (size_type i, const char * src, size_type n)

ustring &	insert (size_type i, const char * src)

ustring &	insert (size_type i, size_type n, gunichar uc)

ustring &	insert (size_type i, size_type n, char c)

iterator	insert (iterator p, gunichar uc)

iterator	insert (iterator p, char c)

void	insert (iterator p, size_type n, gunichar uc)

void	insert (iterator p, size_type n, char c)

template<class In>
void	insert (iterator p, In pbegin, In pend)

ustring &	replace (size_type i, size_type n, const ustring & src)

ustring &	replace (size_type i, size_type n, const ustring & src, size_type i2, size_type n2)

ustring &	replace (size_type i, size_type n, const char * src, size_type n2)

ustring &	replace (size_type i, size_type n, const char * src)

ustring &	replace (size_type i, size_type n, size_type n2, gunichar uc)

ustring &	replace (size_type i, size_type n, size_type n2, char c)

ustring &	replace (iterator pbegin, iterator pend, const ustring & src)

ustring &	replace (iterator pbegin, iterator pend, const char * src, size_type n)

ustring &	replace (iterator pbegin, iterator pend, const char * src)

ustring &	replace (iterator pbegin, iterator pend, size_type n, gunichar uc)

ustring &	replace (iterator pbegin, iterator pend, size_type n, char c)

template<class In>
ustring &	replace (iterator pbegin, iterator pend, In pbegin2, In pend2)

void	clear ()

ustring &	erase (size_type i, size_type n=npos)

ustring &	erase ()

iterator	erase (iterator p)

iterator	erase (iterator pbegin, iterator pend)

int	compare (const ustring & rhs) const

int	compare (const char * rhs) const

int	compare (size_type i, size_type n, const ustring & rhs) const

int	compare (size_type i, size_type n, const ustring & rhs, size_type i2, size_type n2) const

int	compare (size_type i, size_type n, const char * rhs, size_type n2) const

int	compare (size_type i, size_type n, const char * rhs) const

std::string	collate_key () const

std::string	casefold_collate_key () const

value_type	operator[] (size_type i) const

value_type	at (size_type i) const

ustring	substr (size_type i=0, size_type n=npos) const

iterator	begin ()

iterator	end ()

const_iterator	begin () const

const_iterator	end () const

reverse_iterator	rbegin ()

reverse_iterator	rend ()

const_reverse_iterator	rbegin () const

const_reverse_iterator	rend () const

const_iterator	cbegin () const

const_iterator	cend () const

size_type	find (const ustring & str, size_type i=0) const

size_type	find (const char * str, size_type i, size_type n) const

size_type	find (const char * str, size_type i=0) const

size_type	find (gunichar uc, size_type i=0) const

size_type	find (char c, size_type i=0) const

size_type	rfind (const ustring & str, size_type i=npos) const

size_type	rfind (const char * str, size_type i, size_type n) const

size_type	rfind (const char * str, size_type i=npos) const

size_type	rfind (gunichar uc, size_type i=npos) const

size_type	rfind (char c, size_type i=npos) const

size_type	find_first_of (const ustring & match, size_type i=0) const

size_type	find_first_of (const char * match, size_type i, size_type n) const

size_type	find_first_of (const char * match, size_type i=0) const

size_type	find_first_of (gunichar uc, size_type i=0) const

size_type	find_first_of (char c, size_type i=0) const

size_type	find_last_of (const ustring & match, size_type i=npos) const

size_type	find_last_of (const char * match, size_type i, size_type n) const

size_type	find_last_of (const char * match, size_type i=npos) const

size_type	find_last_of (gunichar uc, size_type i=npos) const

size_type	find_last_of (char c, size_type i=npos) const

size_type	find_first_not_of (const ustring & match, size_type i=0) const

size_type	find_first_not_of (const char * match, size_type i, size_type n) const

size_type	find_first_not_of (const char * match, size_type i=0) const

size_type	find_first_not_of (gunichar uc, size_type i=0) const

size_type	find_first_not_of (char c, size_type i=0) const

size_type	find_last_not_of (const ustring & match, size_type i=npos) const

size_type	find_last_not_of (const char * match, size_type i, size_type n) const

size_type	find_last_not_of (const char * match, size_type i=npos) const

size_type	find_last_not_of (gunichar uc, size_type i=npos) const

size_type	find_last_not_of (char c, size_type i=npos) const

bool	empty () const
	Returns true if the string is empty.

size_type	size () const
	Returns the number of characters in the string, not including any null-termination.

size_type	length () const
	This is the same as size().

size_type	bytes () const
	Returns the number of bytes in the string, not including any null-termination.

void	resize (size_type n, gunichar uc)

void	resize (size_type n, char c='\0')

size_type	capacity () const

size_type	max_size () const

void	reserve (size_type n=0)

	operator std::string () const

const std::string &	raw () const

const char *	data () const

const char *	c_str () const

size_type	copy (char * dest, size_type n, size_type i=0) const

bool	validate () const

bool	validate (iterator & first_invalid)

bool	validate (const_iterator & first_invalid) const

ustring	make_valid () const

bool	is_ascii () const

ustring	normalize (NormalizeMode mode=NORMALIZE_DEFAULT_COMPOSE) const

ustring	uppercase () const

ustring	lowercase () const

ustring	casefold () const

Additional Inherited Members
Public Types inherited from Glib::ustring
using	size_type = std::string::size_type

using	difference_type = std::string::difference_type

using	value_type = gunichar

using	reference = gunichar&

using	const_reference = const gunichar&

using	iterator = ustring_Iterator<std::string::iterator>

using	const_iterator = ustring_Iterator<std::string::const_iterator>

using	reverse_iterator = std::reverse_iterator<iterator>

using	const_reverse_iterator = std::reverse_iterator<const_iterator>

Static Public Member Functions inherited from Glib::ustring
template<class T1>
static ustring	compose (const ustring & fmt)

template<class T1>
static ustring	compose (const ustring & fmt, const T1 & a1)

template<class T1, class T2>
static ustring	compose (const ustring & fmt, const T1 & a1, const T2 & a2)

template<class T1, class T2, class T3>
static ustring	compose (const ustring & fmt, const T1 & a1, const T2 & a2, const T3 & a3)

template<class T1, class T2, class T3, class T4>
static ustring	compose (const ustring & fmt, const T1 & a1, const T2 & a2, const T3 & a3, const T4 & a4)

template<class T1, class T2, class T3, class T4, class T5>
static ustring	compose (const ustring & fmt, const T1 & a1, const T2 & a2, const T3 & a3, const T4 & a4, const T5 & a5)

template<class T1, class T2, class T3, class T4, class T5, class T6>
static ustring	compose (const ustring & fmt, const T1 & a1, const T2 & a2, const T3 & a3, const T4 & a4, const T5 & a5, const T6 & a6)

template<class T1, class T2, class T3, class T4, class T5, class T6, class T7>
static ustring	compose (const ustring & fmt, const T1 & a1, const T2 & a2, const T3 & a3, const T4 & a4, const T5 & a5, const T6 & a6, const T7 & a7)

template<class T1, class T2, class T3, class T4, class T5, class T6, class T7, class T8>
static ustring	compose (const ustring & fmt, const T1 & a1, const T2 & a2, const T3 & a3, const T4 & a4, const T5 & a5, const T6 & a6, const T7 & a7, const T8 & a8)

template<class T1, class T2, class T3, class T4, class T5, class T6, class T7, class T8, class T9>
static ustring	compose (const ustring & fmt, const T1 & a1, const T2 & a2, const T3 & a3, const T4 & a4, const T5 & a5, const T6 & a6, const T7 & a7, const T8 & a8, const T9 & a9)

template<class T1>
static ustring	format (const T1 & a1)

template<class T1, class T2>
static ustring	format (const T1 & a1, const T2 & a2)

template<class T1, class T2, class T3>
static ustring	format (const T1 & a1, const T2 & a2, const T3 & a3)

template<class T1, class T2, class T3, class T4>
static ustring	format (const T1 & a1, const T2 & a2, const T3 & a3, const T4 & a4)

template<class T1, class T2, class T3, class T4, class T5>
static ustring	format (const T1 & a1, const T2 & a2, const T3 & a3, const T4 & a4, const T5 & a5)

template<class T1, class T2, class T3, class T4, class T5, class T6>
static ustring	format (const T1 & a1, const T2 & a2, const T3 & a3, const T4 & a4, const T5 & a5, const T6 & a6)

template<class T1, class T2, class T3, class T4, class T5, class T6, class T7>
static ustring	format (const T1 & a1, const T2 & a2, const T3 & a3, const T4 & a4, const T5 & a5, const T6 & a6, const T7 & a7)

template<class T1, class T2, class T3, class T4, class T5, class T6, class T7, class T8>
static ustring	format (const T1 & a1, const T2 & a2, const T3 & a3, const T4 & a4, const T5 & a5, const T6 & a6, const T7 & a7, const T8 & a8)

template<class... Ts>
static ustring	sprintf (const ustring & fmt, const Ts &... args)

template<class... Ts>
static ustring	sprintf (const char * fmt, const Ts &... args)

static ustring	sprintf (const ustring & fmt)

static ustring	sprintf (const char * fmt)

Static Public Attributes inherited from Glib::ustring
static const size_type	npos = std::string::npos

Related Symbols inherited from Glib::ustring
std::istream &	operator>> (std::istream & is, Glib::ustring & utf8_string)
	Stream input operator.

std::ostream &	operator<< (std::ostream & os, const Glib::ustring & utf8_string)
	Stream output operator.

std::wistream &	operator>> (std::wistream & is, ustring & utf8_string)
	Wide stream input operator.

std::wostream &	operator<< (std::wostream & os, const ustring & utf8_string)
	Wide stream output operator.

void	swap (ustring & lhs, ustring & rhs)

bool	operator== (const ustring & lhs, const ustring & rhs)

bool	operator== (const ustring & lhs, const char * rhs)

bool	operator== (const char * lhs, const ustring & rhs)

bool	operator!= (const ustring & lhs, const ustring & rhs)

bool	operator!= (const ustring & lhs, const char * rhs)

bool	operator!= (const char * lhs, const ustring & rhs)

bool	operator< (const ustring & lhs, const ustring & rhs)

bool	operator< (const ustring & lhs, const char * rhs)

bool	operator< (const char * lhs, const ustring & rhs)

bool	operator> (const ustring & lhs, const ustring & rhs)

bool	operator> (const ustring & lhs, const char * rhs)

bool	operator> (const char * lhs, const ustring & rhs)

bool	operator<= (const ustring & lhs, const ustring & rhs)

bool	operator<= (const ustring & lhs, const char * rhs)

bool	operator<= (const char * lhs, const ustring & rhs)

bool	operator>= (const ustring & lhs, const ustring & rhs)

bool	operator>= (const ustring & lhs, const char * rhs)

bool	operator>= (const char * lhs, const ustring & rhs)

ustring	operator+ (const ustring & lhs, const ustring & rhs)

ustring	operator+ (const ustring & lhs, const char * rhs)

ustring	operator+ (const char * lhs, const ustring & rhs)

ustring	operator+ (const ustring & lhs, gunichar rhs)

ustring	operator+ (gunichar lhs, const ustring & rhs)

ustring	operator+ (const ustring & lhs, char rhs)

ustring	operator+ (char lhs, const ustring & rhs)

Detailed Description

String class for D-Bus object paths in Glib::Variant.

Use it if you want to create a Glib::Variant with D-Bus object paths.

using opstring_with_string_t =
  std::map<Glib::DBusObjectPathString, Glib::Variant<Glib::ustring>>;
opstring_with_string_t map1;
map1["/map1/path1"] = Glib::Variant<Glib::ustring>::create("value1");
auto variant1 = Glib::Variant<opstring_with_string_t>::create(map1);

Since glibmm 2.54

Member Function Documentation

◆ ustring() [1/11]

Glib::ustring::ustring ( )

Default constructor, which creates an empty string.

◆ ustring() [2/11]

Glib::ustring::ustring ( const char * src )

Construct a ustring as a copy of a C string.

Parameters

src	Source C string encoded as UTF-8.

◆ ustring() [3/11]

Glib::ustring::ustring	(	const char *	src,
		size_type	n )

Construct a ustring as a partial copy of a C string.

Parameters

src	Source C string encoded as UTF-8.
n	Number of UTF-8 characters to copy.

◆ ustring() [4/11]

Glib::ustring::ustring ( const std::string & src )

Construct a ustring as a copy of a std::string.

Parameters

src	A source `std::string` containing text encoded as UTF-8.

◆ ustring() [5/11]

Glib::ustring::ustring ( const ustring & other )

Construct a ustring as a copy of another ustring.

Parameters

other A source string.

◆ ustring() [6/11]

Glib::ustring::ustring	(	const ustring &	src,
		size_type	i,
		size_type	n = npos )

Construct a ustring as a copy of a substring.

Parameters

src	Source ustring.
i	Index of first character to copy from.
n	Number of UTF-8 characters to copy (defaults to copying the remainder).

◆ ustring() [7/11]

template <class In>

Glib::ustring::ustring	(	In	pbegin,
		In	pend )

Construct a ustring as a copy of a range.

Parameters

pbegin	Start of range.
pend	End of range.

◆ ustring() [8/11]

Glib::ustring::ustring	(	size_type	n,
		char	c )

Construct a ustring as multiple characters.

Parameters

n	Number of characters.
c	ASCII character to use.

◆ ustring() [9/11]

Glib::ustring::ustring	(	size_type	n,
		gunichar	uc )

Construct a ustring as multiple characters.

Parameters

n	Number of characters.
uc	UCS-4 code point to use.

◆ ustring() [10/11]

Glib::ustring::ustring ( std::string && src )

Construct a ustring by moving from a std::string.

Parameters

src	A source `std::string` containing text encoded as UTF-8.

◆ ustring() [11/11]

Glib::ustring::ustring ( ustring && other )

Construct a ustring by moving from another ustring.

Parameters

other A source string.

Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ ustring() [1/11]

◆ ustring() [2/11]

◆ ustring() [3/11]

◆ ustring() [4/11]

◆ ustring() [5/11]

◆ ustring() [6/11]

◆ ustring() [7/11]

◆ ustring() [8/11]

◆ ustring() [9/11]

◆ ustring() [10/11]

◆ ustring() [11/11]