2013-09-05 05:09:23 +00:00
|
|
|
.. _sprout-string-char_traits-copy:
|
|
|
|
|
###############################################################################
|
|
|
|
|
copy
|
|
|
|
|
###############################################################################
|
|
|
|
|
|
|
|
|
|
Interface
|
|
|
|
|
========================================
|
|
|
|
|
.. sourcecode:: c++
|
|
|
|
|
|
|
|
|
|
static char_type* copy(char_type* s1, char_type const* s2, std::size_t n);
|
|
|
|
|
|
2013-09-05 08:16:56 +00:00
|
|
|
Pre-condition
|
|
|
|
|
========================================
|
|
|
|
|
|
|
|
|
|
| s2 not in [s1,s1+n).
|
|
|
|
|
|
2013-09-05 05:09:23 +00:00
|
|
|
Effects
|
|
|
|
|
========================================
|
|
|
|
|
|
|
|
|
|
| Equivalent to ``std::char_traits<Char>::copy(s1, s2, n)``.
|
|
|
|
|
|
|
|
|
|
Examples
|
|
|
|
|
========================================
|
|
|
|
|
.. sourcecode:: c++
|
|
|
|
|
|
|
|
|
|
#include <sprout/string.hpp>
|
|
|
|
|
#include <sprout/assert.hpp>
|
|
|
|
|
using namespace sprout;
|
|
|
|
|
|
|
|
|
|
char x[] = "homuhomu";
|
|
|
|
|
SPROUT_STATIC_CONSTEXPR char const* y = "madocchi";
|
|
|
|
|
char_traits<char>::copy(x, y, 8);
|
|
|
|
|
SPROUT_ASSERT_MSG(x[0] == y[0], "y is copied to x.");
|
|
|
|
|
|
|
|
|
|
Complexity
|
|
|
|
|
========================================
|
|
|
|
|
|
|
|
|
|
| linear.
|
|
|
|
|
|
|
|
|
|
Header
|
|
|
|
|
========================================
|
|
|
|
|
|
|
|
|
|
| ``sprout/string/char_traits.hpp``
|
|
|
|
|
| Convenience header: ``sprout/string.hpp``
|
|
|
|
|
|
