BloombergLP::bdlb::String::copy

Return a newly allocated null-terminated copy of string.

Synopsis

Declared in <bdlb_string.h>

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

Description

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.

Return Value

address of the newly allocated copy

Parameters

NameDescription
stringstring to copy
lengthlength of string in bytes
basicAllocatorallocator used to supply memory