Sign in Join
FPDoc Onlineexperiment

strcopy function

In unit Strings

Copy a null-terminated string.

Declaration

pascal
function strcopy(dest: PAnsiChar; source: PAnsiChar): PAnsiChar
 ; 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

Example: ex4

pascal
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.

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.