Zero overhead unique identifier. More...

#include <hashed_string.hpp>

Inheritance diagram for entt::basic_hashed_string< Char >:

Collaboration diagram for entt::basic_hashed_string< Char >:

Public Types
using	value_type = typename base_type::value_type
	Character type.

using	size_type = typename base_type::size_type
	Unsigned integer type.

using	hash_type = typename base_type::hash_type
	Unsigned integer type.

Public Member Functions
constexpr	basic_hashed_string ()
	Constructs an empty hashed string.

constexpr	basic_hashed_string (const value_type *str, const size_type len)
	Constructs a hashed string from a string view. More...

template<std::size_t N>
constexpr	basic_hashed_string (const value_type(&str)[N])
	Constructs a hashed string from an array of const characters. More...

constexpr	basic_hashed_string (const_wrapper wrapper)
	Explicit constructor on purpose to avoid constructing a hashed string directly from a `const value_type *`. More...

constexpr size_type	size () const
	Returns the size a hashed string. More...

constexpr const value_type *	data () const
	Returns the human-readable representation of a hashed string. More...

constexpr hash_type	value () const
	Returns the numeric representation of a hashed string. More...

constexpr	operator const value_type * () const
	Returns the human-readable representation of a hashed string. More...

constexpr	operator hash_type () const
	Returns the numeric representation of a hashed string. More...

Static Public Member Functions
static constexpr hash_type	value (const value_type *str, const size_type len)
	Returns directly the numeric representation of a string view. More...

template<std::size_t N>
static constexpr hash_type	value (const value_type(&str)[N])
	Returns directly the numeric representation of a string. More...

static constexpr hash_type	value (const_wrapper wrapper)
	Returns directly the numeric representation of a string. More...

Detailed Description

template<typename Char>
class entt::basic_hashed_string< Char >

Zero overhead unique identifier.

A hashed string is a compile-time tool that allows users to use human-readable identifiers in the codebase while using their numeric counterparts at runtime.
Because of that, a hashed string can also be used in constant expressions if required.

Warning: This class doesn't take ownership of user-supplied strings nor does it make a copy of them.

Template Parameters

Char	Character type.

Definition at line 69 of file hashed_string.hpp.

Constructor & Destructor Documentation

◆ basic_hashed_string() [1/3]

template<typename Char >

constexpr entt::basic_hashed_string< Char >::basic_hashed_string	(	const value_type *	str,
		const size_type	len
	)

inlineconstexpr

Constructs a hashed string from a string view.

Parameters

str	Human-readable identifier.
len	Length of the string to hash.

Definition at line 148 of file hashed_string.hpp.

◆ basic_hashed_string() [2/3]

template<typename Char >

template<std::size_t N>

constexpr entt::basic_hashed_string< Char >::basic_hashed_string ( const value_type(&) str[N] )

inlineconstexpr

Constructs a hashed string from an array of const characters.

Template Parameters

N	Number of characters of the identifier.

Parameters

str	Human-readable identifier.

Definition at line 157 of file hashed_string.hpp.

◆ basic_hashed_string() [3/3]

template<typename Char >

constexpr entt::basic_hashed_string< Char >::basic_hashed_string ( const_wrapper wrapper )

inlineexplicitconstexpr

Explicit constructor on purpose to avoid constructing a hashed string directly from a const value_type *.

Warning: The lifetime of the string is not extended nor is it copied.

Parameters

wrapper Helps achieving the purpose by relying on overloading.

Definition at line 169 of file hashed_string.hpp.

Member Function Documentation

◆ data()

template<typename Char >

constexpr const value_type* entt::basic_hashed_string< Char >::data ( ) const

inlineconstexpr

Returns the human-readable representation of a hashed string.

Returns: The string used to initialize the hashed string.

Definition at line 184 of file hashed_string.hpp.

◆ operator const value_type *()

template<typename Char >

constexpr entt::basic_hashed_string< Char >::operator const value_type * ( ) const

inlineconstexpr

Returns the human-readable representation of a hashed string.

Returns: The string used to initialize the hashed string.

Definition at line 197 of file hashed_string.hpp.

◆ operator hash_type()

template<typename Char >

constexpr entt::basic_hashed_string< Char >::operator hash_type ( ) const

inlineconstexpr

Returns the numeric representation of a hashed string.

Returns: The numeric representation of the hashed string.

Definition at line 205 of file hashed_string.hpp.

◆ size()

template<typename Char >

constexpr size_type entt::basic_hashed_string< Char >::size ( ) const

inlineconstexpr

Returns the size a hashed string.

Returns: The size of the hashed string.

Definition at line 176 of file hashed_string.hpp.

◆ value() [1/4]

template<typename Char >

constexpr hash_type entt::basic_hashed_string< Char >::value ( ) const

inlineconstexpr

Returns the numeric representation of a hashed string.

Returns: The numeric representation of the hashed string.

Definition at line 192 of file hashed_string.hpp.

◆ value() [2/4]

template<typename Char >

static constexpr hash_type entt::basic_hashed_string< Char >::value	(	const value_type *	str,
		const size_type	len
	)

inlinestaticconstexpr

Returns directly the numeric representation of a string view.

Parameters

str	Human-readable identifier.
len	Length of the string to hash.

Returns: The numeric representation of the string.

Definition at line 115 of file hashed_string.hpp.

◆ value() [3/4]

template<typename Char >

template<std::size_t N>

static constexpr hash_type entt::basic_hashed_string< Char >::value ( const value_type(&) str[N] )

inlinestaticconstexpr

Returns directly the numeric representation of a string.

Template Parameters

N	Number of characters of the identifier.

Parameters

str	Human-readable identifier.

Returns: The numeric representation of the string.

Definition at line 126 of file hashed_string.hpp.

◆ value() [4/4]

template<typename Char >

static constexpr hash_type entt::basic_hashed_string< Char >::value ( const_wrapper wrapper )

inlinestaticconstexpr

Returns directly the numeric representation of a string.

Parameters

wrapper Helps achieving the purpose by relying on overloading.

Returns: The numeric representation of the string.

Definition at line 135 of file hashed_string.hpp.

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

src/entt/core/hashed_string.hpp

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

template<typename Char> class entt::basic_hashed_string< Char >

Constructor & Destructor Documentation

◆ basic_hashed_string() [1/3]

◆ basic_hashed_string() [2/3]

◆ basic_hashed_string() [3/3]

Member Function Documentation

◆ data()

◆ operator const value_type *()

◆ operator hash_type()

◆ size()

◆ value() [1/4]

◆ value() [2/4]

◆ value() [3/4]

◆ value() [4/4]

template<typename Char>
class entt::basic_hashed_string< Char >