Diferenças entre edições de "cpp/string/basic string/insert"
Da cppreference.com
< cpp | string | basic string
m (r2.7.3) (Robô: A adicionar: en, es, fr, it, zh A remover: pt) |
m (Use {{lc}}. Update links. Various fixes.) |
||
Linha 2: | Linha 2: | ||
{{cpp/string/basic_string/title | insert}} | {{cpp/string/basic_string/title | insert}} | ||
{{cpp/string/basic_string/navbar}} | {{cpp/string/basic_string/navbar}} | ||
− | {{ | + | {{begin}} |
− | {{ | + | {{| num=1 | |
basic_string& insert( size_type index, size_type count, CharT ch ); | basic_string& insert( size_type index, size_type count, CharT ch ); | ||
}} | }} | ||
− | {{ | + | {{| num=2 | |
basic_string& insert( size_type index, const CharT* s ); | basic_string& insert( size_type index, const CharT* s ); | ||
}} | }} | ||
− | {{ | + | {{| num=3 | |
basic_string& insert( size_type index, const CharT* s, size_type count ); | basic_string& insert( size_type index, const CharT* s, size_type count ); | ||
}} | }} | ||
− | {{ | + | {{| num=4 | |
basic_string& insert( size_type index, const basic_string& str ); | basic_string& insert( size_type index, const basic_string& str ); | ||
}} | }} | ||
− | {{ | + | {{| num=5 | |
basic_string& insert( size_type index, const basic_string& str, | basic_string& insert( size_type index, const basic_string& str, | ||
size_type index_str, size_type count ); | size_type index_str, size_type count ); | ||
}} | }} | ||
− | {{ | + | {{| num=6 | notes={{mark until c++11}} <br> {{mark since c++11}} | |
iterator insert( iterator pos, CharT ch ); | iterator insert( iterator pos, CharT ch ); | ||
iterator insert( const_iterator pos, CharT ch ); | iterator insert( const_iterator pos, CharT ch ); | ||
}} | }} | ||
− | {{ | + | {{| num=7 | notes={{mark until c++11}} <br> {{mark since c++11}} | |
void insert( iterator pos, size_type count, CharT ch ); | void insert( iterator pos, size_type count, CharT ch ); | ||
iterator insert( iterator pos, size_type count, CharT ch ); | iterator insert( iterator pos, size_type count, CharT ch ); | ||
}} | }} | ||
− | {{ | + | {{| num=8 | notes={{mark until c++11}} <br><br> {{mark since c++11}} | |
template< class InputIt > | template< class InputIt > | ||
void insert( iterator i, InputIt first, InputIt last ); | void insert( iterator i, InputIt first, InputIt last ); | ||
Linha 33: | Linha 33: | ||
iterator insert( const_iterator i, InputIt first, InputIt last ); | iterator insert( const_iterator i, InputIt first, InputIt last ); | ||
}} | }} | ||
− | {{ | + | {{| num=9 | sincec++11 | |
iterator insert( const_iterator pos, std::initializer_list<CharT> ilist ); | iterator insert( const_iterator pos, std::initializer_list<CharT> ilist ); | ||
}} | }} | ||
− | {{ | + | {{end}} |
{{tr|Insere caracteres para a string:|Inserts characters into the string:}} | {{tr|Insere caracteres para a string:|Inserts characters into the string:}} | ||
Linha 59: | Linha 59: | ||
===Parâmetros=== | ===Parâmetros=== | ||
− | {{ | + | {{begin}} |
− | {{ | + | {{| index |{{tr| posição na qual o conteúdo será inserido| position at which the content will be inserted}}}} |
− | {{ | + | {{| pos |{{tr| iterador antes que os personagens serão inseridos| iterator before which the characters will be inserted}}}} |
− | {{ | + | {{| ch |{{tr| personagem para inserir| character to insert}}}} |
− | {{ | + | {{| count |{{tr| número de caracteres para inserir| number of characters to insert}}}} |
− | {{ | + | {{| s |{{tr| ponteiro para a cadeia de caracteres a ser inserido| pointer to the character string to insert}}}} |
− | {{ | + | {{| str |{{tr| string para inserir| string to insert}}}} |
− | {{ | + | {{| first, last |{{tr| vão definir caracteres para inserir| range defining characters to insert}}}} |
− | {{ | + | {{| index_str |{{tr| posição do primeiro caractere na seqüência {{tt|str}} inserir| position of the first character in the string {{tt|str}} to insert}}}} |
− | {{ | + | {{| ilist |{{tr| inicializador lista para inserir os caracteres| initializer list to insert the characters from}}}} |
− | {{ | + | {{hreq}} |
− | {{ | + | {{req concept | InputIt | InputIterator}} |
− | {{ | + | {{end}} |
===Valor de retorno=== | ===Valor de retorno=== | ||
Linha 79: | Linha 79: | ||
===Exceções=== | ===Exceções=== | ||
− | @1@ {{ | + | @1@ {{|std::out_of_range}} if {{c|index > size()}} and {{|std::length_error}} if {{c|size() + count > max_size()}}. |
− | @2@ {{ | + | @2@ {{|std::out_of_range}} if {{c|index > size()}} and {{|std::length_error}} if {{c|size() + Traits::length(s) > max_size()}}. |
− | @3@ {{ | + | @3@ {{|std::out_of_range}} if {{c|index > size()}} and {{|std::length_error}} if {{c|size() + count > max_size()}}. |
@4@ {{tr|Lança exceções nas seguintes condições:|Throws exceptions on the following conditions:}} | @4@ {{tr|Lança exceções nas seguintes condições:|Throws exceptions on the following conditions:}} | ||
− | :@a@ {{ | + | :@a@ {{|std::out_of_range}} if {{c|index > size()}}. |
− | :@b@ {{tr|{{ | + | :@b@ {{tr|{{|std::length_error}} se {{c|size() + str.size() > max_size()}} onde {{tt|ins_count}} é o número de caracteres que serão inseridos.|{{|std::length_error}} if {{c|size() + str.size() > max_size()}} where {{tt|ins_count}} is the number of characters that will be inserted.}} |
@5@ {{tr|Lança exceções nas seguintes condições:|Throws exceptions on the following conditions:}} | @5@ {{tr|Lança exceções nas seguintes condições:|Throws exceptions on the following conditions:}} | ||
− | :@a@ {{ | + | :@a@ {{|std::out_of_range}} if {{c|index > size()}}. |
− | :@b@ {{ | + | :@b@ {{|std::out_of_range}} if {{c|index_str > str.size()}}. |
− | :@c@ {{tr|{{ | + | :@c@ {{tr|{{|std::length_error}} se {{c|size() + ins_count > max_size()}} onde {{tt|ins_count}} é o número de caracteres que serão inseridos.|{{|std::length_error}} if {{c|size() + ins_count > max_size()}} where {{tt|ins_count}} is the number of characters that will be inserted.}} |
@6-9@ {{tr|(Nenhum)|(none)}} | @6-9@ {{tr|(Nenhum)|(none)}} | ||
===Veja também=== | ===Veja também=== | ||
− | {{ | + | {{begin}} |
− | {{ | + | {{| cpp/string/basic_string/append}} |
− | {{ | + | {{| cpp/string/basic_string/push_back}} |
− | {{ | + | {{end}} |
[[de:cpp/string/basic string/insert]] | [[de:cpp/string/basic string/insert]] |
Edição actual desde as 10h22min de 2 de julho de 2013
![]() |
This page has been machine-translated from the English version of the wiki using Google Translate.
The translation may contain errors and awkward wording. Hover over text to see the original version. You can help to fix errors and improve the translation. For instructions click here. |
basic_string& insert( size_type index, size_type count, CharT ch ); |
(1) | |
basic_string& insert( size_type index, const CharT* s ); |
(2) | |
basic_string& insert( size_type index, const CharT* s, size_type count ); |
(3) | |
basic_string& insert( size_type index, const basic_string& str ); |
(4) | |
basic_string& insert( size_type index, const basic_string& str, size_type index_str, size_type count ); |
(5) | |
iterator insert( iterator pos, CharT ch ); iterator insert( const_iterator pos, CharT ch ); |
(6) | (até C++11) (desde C++11) |
void insert( iterator pos, size_type count, CharT ch ); iterator insert( iterator pos, size_type count, CharT ch ); |
(7) | (até C++11) (desde C++11) |
template< class InputIt > void insert( iterator i, InputIt first, InputIt last ); |
(8) | (até C++11) (desde C++11) |
iterator insert( const_iterator pos, std::initializer_list<CharT> ilist ); |
(9) | (desde C++11) |
Insere caracteres para a string:
Original:
Inserts characters into the string:
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
1)
Insere
count
cópias de ch
personagem no index
posiçãoOriginal:
Inserts
count
copies of character ch
at the position index
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
2)
Insere seqüência de caracteres terminada em nulo apontado por
s
no index
posição. O comprimento da corda é determinada pelo primeiro caractere nulo (efetivamente chamadas Traits::length(s). Original:
Inserts null-terminated character string pointed to by
s
at the position index
. The length of the string is determined by the first null character (effectively calls Traits::length(s). The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
3)
Insere os personagens
count
primeira da seqüência de caracteres apontada por s
no index
posição. s
pode conter caracteres nulos.Original:
Inserts the first
count
characters from the character string pointed to by s
at the position index
. s
can contain null characters.The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
4)
Insere
str
corda no index
posiçãoOriginal:
Inserts string
str
at the position index
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
5)
Insere uma corda, obtidos por str.substr(index_str, count) no
index
posiçãoOriginal:
Inserts a string, obtained by str.substr(index_str, count) at the position
index
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
6)
Insere
ch
personagem antes o caracter apontado por pos
Original:
Inserts character
ch
before the character pointed by pos
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
7)
Insere
count
cópias de ch
personagem antes do elemento apontado por pos
Original:
Inserts
count
copies of character ch
before the element pointed to by pos
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
8)
Insere personagens do
[first, last)
intervalo Original:
Inserts characters from the range
[first, last)
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
9)
Insere elementos da lista de inicializador
ilist
. Original:
Inserts elements from initializer list
ilist
. The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
Índice |
[editar] Parâmetros
index | - | posição na qual o conteúdo será inserido
Original: position at which the content will be inserted The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
pos | - | iterador antes que os personagens serão inseridos
Original: iterator before which the characters will be inserted The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
ch | - | personagem para inserir
Original: character to insert The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
count | - | número de caracteres para inserir
Original: number of characters to insert The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
s | - | ponteiro para a cadeia de caracteres a ser inserido
Original: pointer to the character string to insert The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
str | - | string para inserir
Original: string to insert The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
first, last | - | vão definir caracteres para inserir
Original: range defining characters to insert The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
index_str | - | posição do primeiro caractere na seqüência
str inserirOriginal: position of the first character in the string str to insertThe text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
ilist | - | inicializador lista para inserir os caracteres
Original: initializer list to insert the characters from The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. |
Type requirements | ||
-InputIt must meet the requirements of InputIterator .
|
[editar] Valor de retorno
1-5) *this
6-9)
Iterator após o último caractere inserido.
Original:
Iterator following the last inserted character.
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
[editar] Exceções
1) std::out_of_range if index > size() and std::length_error if size() + count > max_size().
2) std::out_of_range if index > size() and std::length_error if size() + Traits::length(s) > max_size().
3) std::out_of_range if index > size() and std::length_error if size() + count > max_size().
4)
Lança exceções nas seguintes condições:
Original:
Throws exceptions on the following conditions:
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
a) std::out_of_range if index > size().
b)
std::length_error se size() + str.size() > max_size() onde
ins_count
é o número de caracteres que serão inseridos.Original:
std::length_error if size() + str.size() > max_size() where
ins_count
is the number of characters that will be inserted.The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
5)
Lança exceções nas seguintes condições:
Original:
Throws exceptions on the following conditions:
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
a) std::out_of_range if index > size().
b) std::out_of_range if index_str > str.size().
c)
std::length_error se size() + ins_count > max_size() onde
ins_count
é o número de caracteres que serão inseridos.Original:
std::length_error if size() + ins_count > max_size() where
ins_count
is the number of characters that will be inserted.The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
6-9)
(Nenhum)
Original:
(none)
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
[editar] Veja também
Acrescenta caracteres até o fim Original: appends characters to the end The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função pública membro) | |
acrescenta um caráter até o fim Original: appends a character to the end The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função pública membro) |