[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] | Reference for unit 'sysutils' (#rtl)

# StrCopy

Copy a null-terminated string

## Declaration

Source position: syspchh.inc line 19

`function strcopy(`
`dest: pchar;`
`source: pchar`
`):pchar; overload; function StrCopy(`
`Dest: PWideChar;`
`Source: PWideChar`
`):PWideChar; overload;`

## Description

Copy the null terminated string in Source to Dest, and returns a pointer to Dest. Dest needs enough room to contain Source, i.e. StrLen(Source)+1 bytes.

## Errors

No length checking is performed.

## See also

StrPCopy |  | Copy an ansistring to a null-terminated string.
StrLCopy |  | Copy a null-terminated string, limited in length.
StrECopy |  | Copy a null-terminated string, return a pointer to the end.

## Example

    Program Example4;

    Uses strings;

    { Program to demonstrate the StrCopy function. }

    Const P : PCHar = 'This is a PCHAR string.';

    var PP : PChar;

    begin
      PP:=StrAlloc(Strlen(P)+1);
      STrCopy (PP,P);
      If StrComp (PP,P)<>0 then
        Writeln ('Oh-oh problems...')
      else
        Writeln ('All is well : PP=',PP);
      StrDispose(PP);
    end.