basic_string::resize

[metoda] Zmienia rozmiar obiektu.

Składnia

#include <string>

namespace std
{
template <
class TypZnaku,
class CechowanieZnakow = char_traits < TypZnaku >,
class Alokator = allocator < TypZnaku >
>
class basic_string
{
public:
void resize( size_type _n );
void resize( size_type _n, TypZnaku _c );

}; //class basic_string
} //namespace std

Argumenty

Argument	Opis
_n	Nowy rozmiar obiektu.
_c	Znak wypełniający nadmiar miejsca.

Opis szczegółowy

Metoda zmienia rozmiar aktualnego obiektu na _n. Jeżeli _n jest mniejsze od aktualnego rozmiaru, wystające znaki zostaną ucięte. Jeżeli _n jest większe od aktualnego rozmiaru, to nadmiar miejsca zostanie wypełniony znakiem _c jeśli został on określony, bajtami zerowymi w przeciwnym wypadku.

Rzucane wyjątki

Jeżeli wyjątek zostanie rzucony, wartość obiektu nie ulegnie zmianie.

Jeżeli _n jest większe od wartości zwracanej przez _{» standard C++ » basic_string ♦}max_size, to zostanie rzucony _{» standard C++ ♦}length_error.
Jeżeli szablon korzysta z domyślnego alokatora, to _{» standard C++ ♦}bad_alloc zostanie rzucony, gdy funkcja będzie chcieć zaalokować pamięć i operacja się nie powiedzie.

Przykład

#include <iostream>
#include <string>

typedef std::basic_string < char, std::char_traits < char >, std::allocator < char >> MojString;
int main()
{
MojString str( "Lubie programowac w C" );
std::cout << str << '\n';

MojString::size_type sz = str.size();

str.resize( sz + 2, '+' );
std::cout << str << '\n';

str.resize( 17 );
std::cout << str << '\n';
return 0;
}

Standardowe wyjście programu:

Lubie programowac w C
Lubie programowac w C++
Lubie programowac

Zagadnienia powiązane

size	Zwraca długość przechowywanego napisu. (metoda)
clear	Usuwa całą zawartość stringa. (metoda)
max_size	Zwraca maksymalny możliwy rozmiar kontenera. (metoda)

Linki zewnętrzne

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.