Template Naming Convention

When creating bindings for a templated class tolc will choose a name based on the template parameters. For example:

template <typename T>
class Example {
public:
T f(T type) {
    return type;
}
};

template class Example<int>;

The specialized class Example<int> will be available from python as Example_int:

import MyLib

example = MyLib.Example_int()
# Prints 5
print(example.f(5))

Multiple template parameters are separated with an underscore (_). The names are meant to be as predictable as possible. The rules are:

• std:: is removed from any standard library type.
• _ is removed from any standard library type.
• User defined types are left untouched (i.e. the class MyNamespace::MyClass will result in appending MyClass).

Type to string conversions

C++ type	Resulting name
std::array	array
std::complex	complex
std::deque	deque
std::filesystem::path	path
std::forward_list	forwardlist
std::function	function
std::list	list
std::map	map
std::multimap	multimap
std::multiset	multiset
std::optional	optional
std::pair	pair
std::priority_queue	priorityqueue
std::queue	queue
std::set	set
std::shared_ptr	sharedptr
std::stack	stack
std::tuple	tuple
std::unique_ptr	uniqueptr
std::unordered_map	unorderedmap
std::unordered_multimap	unorderedmultimap
std::unordered_multiset	unorderedmultiset
std::unordered_set	unorderedset
std::valarray	valarray
std::variant	variant
std::vector	vector
bool	bool
char	char
char16_t	char16t
char32_t	char32t
double	double
float	float
int	int
Integral	Integral literal*
long double	longdouble
long int	longint
long long int	longlongint
short int	shortint
signed char	signedchar
string	string
string_view	stringview
unsigned char	unsignedchar
unsigned int	unsignedint
unsigned long int	unsignedlongint
unsigned long long int	unsignedlonglongint
unsigned short int	unsignedshortint
wchar_t	wchart

* For example the 3 in MyClass<std::array<int, 3>> results in MyClass_array_int_3.