NAME

       copy-string -  (strings)

PURPOSE

       Copies string to another string.

SYNTAX

           copy-string <source string> to <dest string> \
               [ start-with <start with> ] \
               [ length <length> ]

DESCRIPTION

       Use copy-string to copy <source string> to <dest string>.

       <start  with>  number  (in "start-with" clause) is the position in <source string> to start copying from,
       with 0 being the first byte.

       Without "length" clause, the whole of <source string> is copied. With "length" clause,  exactly  <length>
       bytes are copied into <dest string>.

       You  can copy a string to itself. In this case, the original string remains and the new string references
       a copy:

           set-string str = "original string" // string to change

           set-string orig = str // references original copy of the string to change

           copy-string str to str // make a copy of string to change and assign it to itself

           upper-string str // change the copy

           // Now "str" references "ORIGINAL STRING"
           // and "orig" references "original string"

EXAMPLES

       After copy-string below, "my_str" will be a copy of string "some value":

           set-string other_string="some value"
           copy-string other_string to my_str

       Copy certain number of bytes, the result in "my_str" will be "ome":

           set-string other_string="some value"
           copy-string other_string to my_str length 3 start-with 1

SEE ALSO

        Strings

       concatenate-strings copy-string count-substring delete-string lower-string new-string read-split replace-
       string set-string split-string string-length trim-string upper-string write-string See all documentation

$DATE                                               $VERSION                                           GOLF(2gg)