copy overloads

Synopses

Declared in <bdlb_string.h>

Create a null‐terminated copy of the specified string, using the specified basicAllocator to supply memory, and return the address of the newly‐created modifiable string. The string that is returned is owned by the caller. The behavior is undefined unless string.size() <= INT_MAX and basicAllocator is non‐null. Note that if string contains any embedded null ('0') characters they will be propagated to the copy.

static
char*
copy(
    bsl::string const& string,
    bslma::Allocator* basicAllocator);

Create a null‐terminated copy of the specified string, using the specified basicAllocator to supply memory, and return the address of the newly‐created modifiable string. The string that is returned is owned by the caller. The behavior is undefined unless bsl::strlen(string) <= INT_MAX and basicAllocator is non‐null.

static
char*
copy(
    char const* string,
    bslma::Allocator* basicAllocator);

Create a null‐terminated copy of the specified string having the specified length (in bytes), using the specified basicAllocator to supply memory, and return the address of the newly‐created modifiable string. The string that is returned is owned by the caller. The behavior is undefined unless 0 <= length and basicAllocator is non‐null. Note that if string contains any embedded null ('0') characters they will be propagated to the copy.

static
char*
copy(
    char const* string,
    int length,
    bslma::Allocator* basicAllocator);

Created with MrDocs