Espacios de nombres
Variantes
Acciones

Diferencia entre revisiones de «cpp/string/basic string/copy»

De cppreference.com
< cpp‎ | string‎ | basic string
m (Use {{lc}}. Update links. Various fixes.)
(Traducción completa)
 
Línea 1: Línea 1:
{{tr_note}}
 
 
{{cpp/string/basic_string/title | copy}}
 
{{cpp/string/basic_string/title | copy}}
 
{{cpp/string/basic_string/navbar}}
 
{{cpp/string/basic_string/navbar}}
{{ddcl | 1=
+
{{
size_type copy( CharT* dest,
+
                size_type count,
+
| =
                size_type pos = 0);
+
size_type copy( CharT* dest, size_type count,
 +
 +
size_type pos = 0 ) ;
 
}}
 
}}
 +
  
{{tr|Copia un {{tt|[pos, pos+count)}} subcadena en una cadena de caracteres apuntada por {{tt|dest}}. Si la subcadena solicitado dura más allá del final de la cadena, o si {{c|1=count == npos}}, la subcadena copiada es {{tt|[pos, size())}}. La cadena de caracteres resultante no es terminada en cero .|Copies a substring {{tt|[pos, pos+count)}} to character string pointed to by {{tt|dest}}. If the requested substring lasts past the end of the string, or if {{c|1=count == npos}}, the copied substring is {{tt|[pos, size())}}.  The resulting character string is not null-terminated.}}
+
Copia {{tt|[pos, pos+count)}} una cadena de caracteres {{tt|dest}}. Si la subcadena solicitado más allá del final de la cadena, o si {{c|1=count == npos}}, la subcadena copiada es {{tt|[pos, size())}}. La cadena de caracteres resultante no es terminada en .
  
{{tr|Si {{c|1=pos >= size()}}, {{lc|std::out_of_range}} se produce . |If {{c|1=pos >= size()}}, {{lc|std::out_of_range}} is thrown. }}
+
Si {{c|1=pos >= size()}}, se {{lc|std::out_of_range}}.
  
 
===Parámetros===
 
===Parámetros===
 
{{par begin}}
 
{{par begin}}
{{par | dest |{{tr| puntero a la cadena de caracteres de destino| pointer to the destination character string}}}}
+
{{par | dest | a la cadena de caracteres de destino}}
{{par | pos |{{tr| posición del primer carácter que desea incluir| position of the first character to include}}}}
+
{{par | | }}
{{par | count |{{tr| longitud de la subcadena| length of the substring}}}}
+
{{par | | }}
 
{{par end}}  
 
{{par end}}  
  
 
===Valor de retorno===
 
===Valor de retorno===
{{tr|número de caracteres copiados|number of characters copied}}
+
de caracteres copiados
  
 
===Excepciones===
 
===Excepciones===
{{lc|std::out_of_range}} if {{c|1=pos >= size()}}.
+
{{lc|std::out_of_range}} {{c|1=pos >= size()}}.
  
 
===Complejidad===
 
===Complejidad===
{{tr|lineal en {{tt|count}}|linear in {{tt|count}}}}
+
en {{tt|count}}
  
 
===Ejemplo===
 
===Ejemplo===
 
{{example
 
{{example
 
  | code=
 
  | code=
| output=
+
 +
 +
 
 +
 +
 +
 +
 +
 +
 +
 +
| output=
 +
 
}}
 
}}
  
===Ver también===
+
===también===
 
{{dsc begin}}
 
{{dsc begin}}
 
{{dsc inc | cpp/string/basic_string/dsc substr}}
 
{{dsc inc | cpp/string/basic_string/dsc substr}}
 
{{dsc end}}
 
{{dsc end}}
  
[[de:cpp/string/basic string/copy]]
+
deenfritjaplptruzh
[[en:cpp/string/basic string/copy]]
+
[[fr:cpp/string/basic string/copy]]
+
[[it:cpp/string/basic string/copy]]
+
[[ja:cpp/string/basic string/copy]]
+
[[pl:cpp/string/basic string/copy]]
+
[[pt:cpp/string/basic string/copy]]
+
[[ru:cpp/string/basic string/copy]]
+
[[zh:cpp/string/basic string/copy]]
+

Última revisión de 08:13 4 ago 2020

 
 
 
std::basic_string
 
size_type copy( CharT* dest, size_type count, size_type pos = 0 ) const;
(hasta C++20)
constexpr size_type copy( CharT* dest, size_type count, size_type pos = 0 ) const;
(desde C++20)

Copia una subcadena [pos, pos+count) a una cadena de caracteres a la que apunta dest. Si la subcadena solicitado se extiende más allá del final de la cadena, o si count == npos, la subcadena copiada es [pos, size()). La cadena de caracteres resultante no es terminada en nulo.

Si pos >= size(), se lanza std::out_of_range.

Contenido

[editar] Parámetros

dest - Puntero a la cadena de caracteres de destino.
count - Longitud de la subcadena.
pos - Posición del primer carácter a incluir.

[editar] Valor de retorno

Número de caracteres copiados.

[editar] Excepciones

std::out_of_range si pos >= size().

[editar] Complejidad

Lineal en count.

[editar] Ejemplo

#include <string>
#include <iostream>
 
int main()
{
  std::string foo("quuuux");
  char bar[7]{};
  foo.copy(bar, sizeof bar);
  std::cout << bar << '\n';
}

Salida:

quuuux

[editar] Véase también

Devuelve una subcadena
(función miembro pública) [editar]