From: Simon Cozens <simon@netthink.co.uk>
Date: Wed, 2 Aug 2000 02:20:23 +0000 (+0000)
Subject: Document in one place the memory abstractions used in Perl core.
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=0cf5025feb32fb02ae5300679222908dde622ca9;p=p5sagit%2Fp5-mst-13.2.git

Document in one place the memory abstractions used in Perl core.

Subject: Re: Memory abstraction
Organization: Earth.li Origins

p4raw-id: //depot/perl@6487
---

diff --git a/pod/perlguts.pod b/pod/perlguts.pod
index 1738742..8f4839a 100644
--- a/pod/perlguts.pod
+++ b/pod/perlguts.pod
@@ -1317,6 +1317,20 @@ destination starting points.  Perl will move, copy, or zero out C<number>
 instances of the size of the C<type> data structure (using the C<sizeof>
 function).
 
+Here is a handy table of equivalents between ordinary C and Perl's
+memory abstraction layer:
+
+ Instead Of:                Use:
+ malloc                     New
+ calloc                     Newz
+ realloc                    Renew
+ memcopy                    Copy
+ memmove                    Move
+ free                       Safefree
+ strdup                     savepv
+ strndup                    savepvn (Hey, strndup doesn't exist!)
+ memcopy/*(struct foo *)    StructCopy
+
 =head2 PerlIO
 
 The most recent development releases of Perl has been experimenting with