Chromium Embedded Framework (CEF)  106.0.15+gbb70d04+chromium-106.0.5249.12
Public Types | Public Member Functions | List of all members
CefStringBase< traits > Class Template Reference

CEF string classes can convert between all supported string types. More...

#include "include/internal/cef_string_wrappers.h"

Public Types

typedef traits::char_type char_type
 
typedef traits::struct_type struct_type
 
typedef traits::userfree_struct_type userfree_struct_type
 

Public Member Functions

 CefStringBase ()
 Default constructor. More...
 
 CefStringBase (const CefStringBase &str)
 Create a new string from an existing string. More...
 
 CefStringBase (const std::string &src)
 Create a new string from an existing std::string. More...
 
 CefStringBase (const char *src, size_t length=0)
 
 CefStringBase (const std::wstring &src)
 Create a new string from an existing std::wstring. More...
 
 CefStringBase (const wchar_t *src, size_t length=0)
 
 CefStringBase (const std::u16string &src)
 Create a new string from an existing string16. More...
 
 CefStringBase (const std::u16string::value_type *src, size_t length=0)
 
 CefStringBase (const char_type *src, size_t src_len, bool copy)
 Create a new string from an existing character array. More...
 
 CefStringBase (const struct_type *src)
 Create a new string referencing an existing string structure without taking ownership. More...
 
virtual ~CefStringBase ()
 
const char_type * c_str () const
 The following methods are named for compatibility with the standard library string template types. More...
 
size_t length () const
 Return the length of the string data. More...
 
size_t size () const
 Return the length of the string data. More...
 
bool empty () const
 Returns true if the string is empty. More...
 
int compare (const CefStringBase &str) const
 Compare this string to the specified string. More...
 
void clear ()
 Clear the string data. More...
 
void swap (CefStringBase &str)
 Swap this string's contents with the specified string. More...
 
bool IsOwner () const
 Returns true if this class owns the underlying string structure. More...
 
const struct_type * GetStruct () const
 Returns a read-only pointer to the underlying string structure. More...
 
struct_type * GetWritableStruct ()
 Returns a writable pointer to the underlying string structure. More...
 
void ClearAndFree ()
 Clear the state of this class. More...
 
void Attach (struct_type *str, bool owner)
 Attach to the specified string structure. More...
 
void AttachToUserFree (userfree_struct_type str)
 Take ownership of the specified userfree structure's string data. More...
 
void Detach ()
 Detach from the underlying string structure. More...
 
userfree_struct_type DetachToUserFree ()
 Create a userfree structure and give it ownership of this class' string data. More...
 
bool FromString (const char_type *src, size_t src_len, bool copy)
 Set this string's data to the specified character array. More...
 
bool FromASCII (const char *str)
 Set this string's data from an existing ASCII string. More...
 
std::string ToString () const
 Return this string's data as a std::string. More...
 
bool FromString (const std::string &str)
 Set this string's data from an existing std::string. More...
 
bool FromString (const std::string::value_type *data, size_t length=0)
 Set this string's data from existing |data| and optional |length|. More...
 
std::wstring ToWString () const
 Return this string's data as a std::wstring. More...
 
bool FromWString (const std::wstring &str)
 Set this string's data from an existing std::wstring. More...
 
bool FromWString (const std::wstring::value_type *data, size_t length=0)
 Set this string's data from existing |data| and optional |length|. More...
 
std::u16string ToString16 () const
 Return this string's data as a string16. More...
 
bool FromString16 (const std::u16string &str)
 Set this string's data from an existing string16. More...
 
bool FromString16 (const std::u16string::value_type *data, size_t length=0)
 Set this string's data from existing |data| and optional |length|. More...
 
bool operator< (const CefStringBase &str) const
 Comparison operator overloads. More...
 
bool operator<= (const CefStringBase &str) const
 
bool operator> (const CefStringBase &str) const
 
bool operator>= (const CefStringBase &str) const
 
bool operator== (const CefStringBase &str) const
 
bool operator!= (const CefStringBase &str) const
 
CefStringBase & operator= (const CefStringBase &str)
 Assignment operator overloads. More...
 
 operator std::string () const
 
CefStringBase & operator= (const std::string &str)
 
CefStringBase & operator= (const std::string::value_type *str)
 
 operator std::wstring () const
 
CefStringBase & operator= (const std::wstring &str)
 
CefStringBase & operator= (const std::wstring::value_type *str)
 
 operator std::u16string () const
 
CefStringBase & operator= (const std::u16string &str)
 
CefStringBase & operator= (const std::u16string::value_type *str)
 

Detailed Description

template<class traits>
class CefStringBase< traits >

CEF string classes can convert between all supported string types.

For example, the CefStringWide class uses wchar_t as the underlying character type and provides two approaches for converting data to/from a UTF8 string (std::string).

  1. Implicit conversion using the assignment operator overload. 
      CefStringWide aCefString;
  std::string aUTF8String;
  aCefString = aUTF8String; // Assign std::string to CefStringWide
  aUTF8String = aCefString; // Assign CefStringWide to std::string
  2. Explicit conversion using the FromString/ToString methods. 
      CefStringWide aCefString;
  std::string aUTF8String;
  aCefString.FromString(aUTF8String); // Assign std::string to CefStringWide
  aUTF8String = aCefString.ToString(); // Assign CefStringWide to
  std::string

Conversion will only occur if the assigned value is a different string type. Assigning a std::string to a CefStringUTF8, for example, will copy the data without performing a conversion.

CEF string classes are safe for reading from multiple threads but not for modification. It is the user's responsibility to provide synchronization if modifying CEF strings from multiple threads.

Member Typedef Documentation

◆ char_type

template<class traits >
typedef traits::char_type CefStringBase< traits >::char_type

◆ struct_type

template<class traits >
typedef traits::struct_type CefStringBase< traits >::struct_type

◆ userfree_struct_type

template<class traits >
typedef traits::userfree_struct_type CefStringBase< traits >::userfree_struct_type

Constructor & Destructor Documentation

◆ CefStringBase() [1/10]

template<class traits >
CefStringBase< traits >::CefStringBase ( )
inline

Default constructor.

◆ CefStringBase() [2/10]

template<class traits >
CefStringBase< traits >::CefStringBase ( const CefStringBase< traits > &  str)
inline

Create a new string from an existing string.

Data will always be copied.

◆ CefStringBase() [3/10]

template<class traits >
CefStringBase< traits >::CefStringBase ( const std::string &  src)
inline

Create a new string from an existing std::string.

Data will be always copied. Translation will occur if necessary based on the underlying string type.

◆ CefStringBase() [4/10]

template<class traits >
CefStringBase< traits >::CefStringBase ( const char *  src,
size_t  length = 0 
)
inline

◆ CefStringBase() [5/10]

template<class traits >
CefStringBase< traits >::CefStringBase ( const std::wstring &  src)
inline

Create a new string from an existing std::wstring.

Data will be always copied. Translation will occur if necessary based on the underlying string type.

◆ CefStringBase() [6/10]

template<class traits >
CefStringBase< traits >::CefStringBase ( const wchar_t *  src,
size_t  length = 0 
)
inline

◆ CefStringBase() [7/10]

template<class traits >
CefStringBase< traits >::CefStringBase ( const std::u16string &  src)
inline

Create a new string from an existing string16.

Data will be always copied. Translation will occur if necessary based on the underlying string type.

◆ CefStringBase() [8/10]

template<class traits >
CefStringBase< traits >::CefStringBase ( const std::u16string::value_type *  src,
size_t  length = 0 
)
inline

◆ CefStringBase() [9/10]

template<class traits >
CefStringBase< traits >::CefStringBase ( const char_type *  src,
size_t  src_len,
bool  copy 
)
inline

Create a new string from an existing character array.

If |copy| is true this class will copy the data. Otherwise, this class will reference the existing data. Referenced data must exist for the lifetime of this class and will not be freed by this class.

◆ CefStringBase() [10/10]

template<class traits >
CefStringBase< traits >::CefStringBase ( const struct_type *  src)
inline

Create a new string referencing an existing string structure without taking ownership.

Referenced structures must exist for the lifetime of this class and will not be freed by this class.

◆ ~CefStringBase()

template<class traits >
virtual CefStringBase< traits >::~CefStringBase ( )
inlinevirtual

Member Function Documentation

◆ Attach()

template<class traits >
void CefStringBase< traits >::Attach ( struct_type *  str,
bool  owner 
)
inline

Attach to the specified string structure.

If |owner| is true this class will take ownership of the structure.

◆ AttachToUserFree()

template<class traits >
void CefStringBase< traits >::AttachToUserFree ( userfree_struct_type  str)
inline

Take ownership of the specified userfree structure's string data.

The userfree structure itself will be freed. Only use this method with userfree structures.

Free the |str| structure but not the data.

◆ c_str()

template<class traits >
const char_type* CefStringBase< traits >::c_str ( ) const
inline

The following methods are named for compatibility with the standard library string template types.

Return a read-only pointer to the string data.

◆ clear()

template<class traits >
void CefStringBase< traits >::clear ( )
inline

Clear the string data.

◆ ClearAndFree()

template<class traits >
void CefStringBase< traits >::ClearAndFree ( )
inline

Clear the state of this class.

The underlying string structure and data will be freed if this class owns the structure.

◆ compare()

template<class traits >
int CefStringBase< traits >::compare ( const CefStringBase< traits > &  str) const
inline

Compare this string to the specified string.

◆ Detach()

template<class traits >
void CefStringBase< traits >::Detach ( )
inline

Detach from the underlying string structure.

To avoid memory leaks only use this method if you already hold a pointer to the underlying string structure.

◆ DetachToUserFree()

template<class traits >
userfree_struct_type CefStringBase< traits >::DetachToUserFree ( )
inline

Create a userfree structure and give it ownership of this class' string data.

This class will be disassociated from the data. May return NULL if this string class currently contains no data.

◆ empty()

template<class traits >
bool CefStringBase< traits >::empty ( ) const
inline

Returns true if the string is empty.

◆ FromASCII()

template<class traits >
bool CefStringBase< traits >::FromASCII ( const char *  str)
inline

Set this string's data from an existing ASCII string.

Data will be always copied. Translation will occur if necessary based on the underlying string type.

◆ FromString() [1/3]

template<class traits >
bool CefStringBase< traits >::FromString ( const char_type *  src,
size_t  src_len,
bool  copy 
)
inline

Set this string's data to the specified character array.

If |copy| is true this class will copy the data. Otherwise, this class will reference the existing data. Referenced data must exist for the lifetime of this class and will not be freed by this class.

◆ FromString() [2/3]

template<class traits >
bool CefStringBase< traits >::FromString ( const std::string &  str)
inline

Set this string's data from an existing std::string.

Data will be always copied. Translation will occur if necessary based on the underlying string type.

◆ FromString() [3/3]

template<class traits >
bool CefStringBase< traits >::FromString ( const std::string::value_type *  data,
size_t  length = 0 
)
inline

Set this string's data from existing |data| and optional |length|.

Data will be always copied. Translation will occur if necessary based on the underlying string type.

◆ FromString16() [1/2]

template<class traits >
bool CefStringBase< traits >::FromString16 ( const std::u16string &  str)
inline

Set this string's data from an existing string16.

Data will be always copied. Translation will occur if necessary based on the underlying string type.

◆ FromString16() [2/2]

template<class traits >
bool CefStringBase< traits >::FromString16 ( const std::u16string::value_type *  data,
size_t  length = 0 
)
inline

Set this string's data from existing |data| and optional |length|.

Data will be always copied. Translation will occur if necessary based on the underlying string type.

◆ FromWString() [1/2]

template<class traits >
bool CefStringBase< traits >::FromWString ( const std::wstring &  str)
inline

Set this string's data from an existing std::wstring.

Data will be always copied. Translation will occur if necessary based on the underlying string type.

◆ FromWString() [2/2]

template<class traits >
bool CefStringBase< traits >::FromWString ( const std::wstring::value_type *  data,
size_t  length = 0 
)
inline

Set this string's data from existing |data| and optional |length|.

Data will be always copied. Translation will occur if necessary based on the underlying string type.

◆ GetStruct()

template<class traits >
const struct_type* CefStringBase< traits >::GetStruct ( ) const
inline

Returns a read-only pointer to the underlying string structure.

May return NULL if no structure is currently allocated.

◆ GetWritableStruct()

template<class traits >
struct_type* CefStringBase< traits >::GetWritableStruct ( )
inline

Returns a writable pointer to the underlying string structure.

Will never return NULL.

◆ IsOwner()

template<class traits >
bool CefStringBase< traits >::IsOwner ( ) const
inline

Returns true if this class owns the underlying string structure.

◆ length()

template<class traits >
size_t CefStringBase< traits >::length ( ) const
inline

Return the length of the string data.

◆ operator std::string()

template<class traits >
CefStringBase< traits >::operator std::string ( ) const
inline

◆ operator std::u16string()

template<class traits >
CefStringBase< traits >::operator std::u16string ( ) const
inline

◆ operator std::wstring()

template<class traits >
CefStringBase< traits >::operator std::wstring ( ) const
inline

◆ operator!=()

template<class traits >
bool CefStringBase< traits >::operator!= ( const CefStringBase< traits > &  str) const
inline

◆ operator<()

template<class traits >
bool CefStringBase< traits >::operator< ( const CefStringBase< traits > &  str) const
inline

Comparison operator overloads.

◆ operator<=()

template<class traits >
bool CefStringBase< traits >::operator<= ( const CefStringBase< traits > &  str) const
inline

◆ operator=() [1/7]

template<class traits >
CefStringBase& CefStringBase< traits >::operator= ( const CefStringBase< traits > &  str)
inline

Assignment operator overloads.

◆ operator=() [2/7]

template<class traits >
CefStringBase& CefStringBase< traits >::operator= ( const std::string &  str)
inline

◆ operator=() [3/7]

template<class traits >
CefStringBase& CefStringBase< traits >::operator= ( const std::string::value_type *  str)
inline

◆ operator=() [4/7]

template<class traits >
CefStringBase& CefStringBase< traits >::operator= ( const std::u16string &  str)
inline

◆ operator=() [5/7]

template<class traits >
CefStringBase& CefStringBase< traits >::operator= ( const std::u16string::value_type *  str)
inline

◆ operator=() [6/7]

template<class traits >
CefStringBase& CefStringBase< traits >::operator= ( const std::wstring &  str)
inline

◆ operator=() [7/7]

template<class traits >
CefStringBase& CefStringBase< traits >::operator= ( const std::wstring::value_type *  str)
inline

◆ operator==()

template<class traits >
bool CefStringBase< traits >::operator== ( const CefStringBase< traits > &  str) const
inline

◆ operator>()

template<class traits >
bool CefStringBase< traits >::operator> ( const CefStringBase< traits > &  str) const
inline

◆ operator>=()

template<class traits >
bool CefStringBase< traits >::operator>= ( const CefStringBase< traits > &  str) const
inline

◆ size()

template<class traits >
size_t CefStringBase< traits >::size ( ) const
inline

Return the length of the string data.

◆ swap()

template<class traits >
void CefStringBase< traits >::swap ( CefStringBase< traits > &  str)
inline

Swap this string's contents with the specified string.

◆ ToString()

template<class traits >
std::string CefStringBase< traits >::ToString ( ) const
inline

Return this string's data as a std::string.

Translation will occur if necessary based on the underlying string type.

◆ ToString16()

template<class traits >
std::u16string CefStringBase< traits >::ToString16 ( ) const
inline

Return this string's data as a string16.

Translation will occur if necessary based on the underlying string type.

◆ ToWString()

template<class traits >
std::wstring CefStringBase< traits >::ToWString ( ) const
inline

Return this string's data as a std::wstring.

Translation will occur if necessary based on the underlying string type.

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