esv::u8str

esv::u8str_new

Matter is energy.

esv::u8str_new

esv::u8str_new is an alias template or a "derived from" class, used to create a string by new, by guaranteeing always auto-fill u8'\0' for empty space.

Cannibalism is forbidden by nature.

esv::str_new_class

It is alias template of or derived from esv::str_new_class, for support specific character type.

The preferred choice is to use alias template, but for compatible, "derived from" is selected.

Rules:

It guarantees a string space of at least 1 size length is always allocated by new ;
If the string size is 0, 1 size space will be allocated, by initializing it with '\0';
If the string size is N (N > 0), N+1 size space will be allocated, The last space is always initialized with '\0' .
If the real data length is M (M>=0), and the allocated space is N+1 (M<=N, N>=0), then the M size space will be initialized with real data, and the rest space will be all initialized with '\0' ;
If the size from template param is N (N > 0), but the string used to initialize is empty or is "", then N+1 size space will be allocated, and all space will be initialized with '\0' ;
If the size from template param is empty or is N (N==0), but the string used to initialize is not empty and not "", such as "string", then the allocated space is esv::str_size("string")+1, and space will be initialized with "string\0" ;
Any string created by it must be destroyed by delete [] str, it does not have deleter in the destructor, because the name esv::???str_new has a word new ;
As it is class, having all object-oriented features, it can be used for extra object-oriented style case, however it's not encouraged to use it for additional object-oriented cases, because:

It is designed for the following style usage case originally:

// Can be also applied to esv::wstr_new, ..., etc.
char * ptr = esv::str_new<12>{"Hell c++!"};	// 12+1
// The real content of created space is:
// "Hell c++!\0\0\0\0"
delete [] ptr;

// Can be also applied to esv::wstr_new, ..., etc.
// Both char * and const char * work, and size in template param can be auto-deduced.
const char * ptr2 = esv::str_new{"Hell c++!"};	// 9+1
delete [] ptr2;

esv::u8str_new

esv::u8str_new

esv::str_new_class

Rules:

See Also