CKTIS / C++
std::basic_string::substr — sous-chaîne propriétaire
Extrayez un fragment dans une nouvelle chaîne qui possède ses données. Voyez comment la longueur est bornée, quand la position déclenche une exception et ce que change la surcharge pour rvalue en C++23.
Version : ISO C++23; implementation support may vary
Syntaxe
// ISO C++23 — member declarations in std::basic_string (<string>)
constexpr basic_string substr(size_type pos = 0, size_type count = npos) const &;
constexpr basic_string substr(size_type pos = 0, size_type count = npos) &&;std::basic_string::substr est une fonction membre déclarée dans <string>. s.substr(pos, count) renvoie une nouvelle chaîne du même type, propriétaire de ses données. pos est l’indice de départ, compté à partir de zéro ; count est un nombre d’éléments, pas un indice de fin. Par défaut, pos vaut 0 et count vaut npos, c’est-à-dire « jusqu’à la fin ».
Si pos <= s.size(), le résultat contient std::min(count, s.size() - pos) éléments. Une valeur de count trop grande est ramenée à la longueur disponible. pos == s.size() ou count == 0 avec un pos valide donne une chaîne vide. pos > s.size() déclenche std::out_of_range, même si count == 0. Vérifiez les entrées négatives avant de les convertir vers le type non signé size_type, et vérifiez la longueur avant s.size() - 4 pour éviter le rebouclage du calcul non signé.
Avant C++23, il n’existait qu’une surcharge const, devenue constexpr en C++20. En C++23, les deux surcharges sont constexpr ; leur prise en charge peut varier selon la bibliothèque. const & copie le fragment sans modifier la source. && est sélectionnée pour une rvalue non constante, comme std::move(s), et peut réutiliser le stockage de la source, sans garantie d’éviter une allocation. Après un appel réussi, la source reste valide dans un état non spécifié. Les deux surcharges construisent par défaut l’allocateur du résultat au lieu de copier s.get_allocator(). Si une exception est levée, la source reste inchangée.
Les positions et longueurs comptent des éléments CharT : des octets pour std::string et des unités de code UTF-8 de type char8_t pour std::u8string. Une découpe UTF-8 peut couper un point de code. substr conserve les éléments nuls internes ; pour copier toute la plage à l’identique, fournissez s.data() et s.size() au constructeur de chaîne, pas seulement le pointeur. Le résultat de std::basic_string_view::substr, lui, emprunte ses données : ne l’utilisez que tant que le stockage sous-jacent reste valide.
Pour les lettres et chiffres du jeu de caractères de base, s.substr(0, 3) prend jusqu’à trois lettres si elles sont en tête, et s.substr(3) prend la suite si s.size() >= 3. substr découpe, sans filtrer. Si la chaîne ne contient déjà que des chiffres, utilisez digits.substr(digits.size() - 4) lorsqu’elle a au moins quatre éléments ; sinon, ajoutez à gauche les zéros produits par std::string(4 - digits.size(), '0').
Exemples
#include <iostream>
#include <stdexcept>
#include <string>
std::string last_four(const std::string& digits) {
if (digits.size() < 4) {
return std::string(4 - digits.size(), '0') + digits;
}
return digits.substr(digits.size() - 4);
}
int main() {
const std::string label = "ABC12345";
std::cout << label.substr(0, 3) << '\n';
std::cout << label.substr(3, 99) << '\n';
std::cout << last_four(label.substr(3)) << '\n';
std::cout << last_four("7") << '\n';
std::cout << '[' << label.substr(label.size()) << "]\n";
try {
(void)label.substr(label.size() + 1, 0);
} catch (const std::out_of_range&) {
std::cout << "out_of_range\n";
}
}Résultat
ABC 12345 2345 0007 [] out_of_range
L’exemple montre un préfixe, une longueur ramenée à la taille disponible, la conservation des quatre derniers chiffres ou l’ajout de zéros à gauche, et la différence entre un départ à la fin et au-delà.
Leçons associées
- C++ · Leçon 49 · Avancé · Version : 3
- C++ · Leçon 53 · Avancé · Version : 3