# GB.NewString

`void GB.NewString ( char ** str , const char * copy , long len );`

Allocates a new string by coying an existing one.

- str will receive a pointer to the new string.
- copy is the address of the string to copy.
- len is the length of the string to copy.

If len is zero, then the function assumes that copy points to a null-terminated string, and calculates its length with the `strlen()` function.