str_cpy

str_cpy(STRING* string, char* content)

Copies a character sequence into a STRING.

Parameters:

string - target STRING* pointer.
content - source STRING* or char* pointer.

Returns:

string

Modifies:

string

Remarks:

Source and target strings must not be identical.
If the source string is a Unicode string, the target string is also converted to Unicode.

Speed:

Fast

Example:

//  erase a string the easy way, by copying an empty string over            :
function delete_string(str)
{
  str_cpy(str," "); // string has now empty content
}

See also:

STRING, str_cat, str_cmp, str_len, str_clip, str_trunc, str_stri

► latest version online