CKTIS / C++
std::pmr::string — une chaîne avec un allocateur polymorphe
std::pmr::string est une spécialisation de std::basic_string qui utilise std::pmr::polymorphic_allocator<char>. Elle permet de choisir une ressource mémoire à l’exécution sans changer le type de la chaîne.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <string>
#include <memory_resource>
// Equivalent underlying type:
// std::basic_string<char, std::char_traits<char>, std::pmr::polymorphic_allocator<char>>
std::pmr::string text{&resource};std::pmr::string, déclaré dans <string>, est un alias de std::basic_string<char, std::char_traits<char>, std::pmr::polymorphic_allocator<char>>. Il fournit des opérations sur les chaînes comme append() et size(), mais son type diffère de celui de std::string, qui utilise std::allocator<char>.
Pour configurer une ressource, incluez <memory_resource> et transmettez un pointeur vers la ressource lors de la construction de la chaîne. L’allocateur dirige les demandes de mémoire vers cette ressource. Un allocateur construit par défaut utilise la ressource renvoyée par std::pmr::get_default_resource(). En revanche, la construction par déplacement sans argument d’allocateur conserve l’allocateur de la chaîne source et peut donc conserver une ressource autre que celle par défaut. L’utilisation de std::pmr::string ne garantit à elle seule ni l’absence d’allocations sur le tas, ni un nombre précis d’allocations.
La chaîne ne possède pas sa ressource. Celle-ci doit rester disponible aussi longtemps que la chaîne peut l’utiliser, y compris pendant sa destruction. Dans l’exemple, resource est construit avant text et est donc détruit après lui. std::pmr::monotonic_buffer_resource libère collectivement la mémoire accumulée ; les désallocations individuelles ne font rien. N’appelez pas release() tant qu’une chaîne vivante utilise encore la mémoire allouée.
L’exemple crée 40 caractères, ajoute ! et affiche la longueur ainsi que le résultat de la vérification de l’identité de la ressource. La sortie attendue est 41, puis true, sur des lignes distinctes. Le code affiché a été compilé sans modification avec une option C++23 et exécuté dans un environnement isolé. Il a été vérifié que sa sortie standard (stdout) correspondait exactement à la sortie attendue. Cela ne confirme pas la prise en charge dans un environnement d’exécution de production. Le brouillon de travail lié est maintenu et n’est pas figé en tant que C++23.
Exemples
#include <iostream>
#include <memory_resource>
#include <string>
int main() {
std::pmr::monotonic_buffer_resource resource;
std::pmr::string text(40, 'x', &resource);
text.append("!");
std::cout << text.size() << '\n';
std::cout << std::boolalpha
<< (text.get_allocator().resource() == &resource)
<< '\n';
}
Résultat
41 true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.