52 lines
1.7 KiB
HTML
52 lines
1.7 KiB
HTML
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||
|
<HTML>
|
||
|
<HEAD>
|
||
|
<META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.20">
|
||
|
<TITLE>cc65 function reference: Alphabetical function reference: strdup</TITLE>
|
||
|
<LINK HREF="funcref-189.html" REL=next>
|
||
|
<LINK HREF="funcref-187.html" REL=previous>
|
||
|
<LINK HREF="funcref.html#toc3" REL=contents>
|
||
|
</HEAD>
|
||
|
<BODY>
|
||
|
<A HREF="funcref-189.html">Next</A>
|
||
|
<A HREF="funcref-187.html">Previous</A>
|
||
|
<A HREF="funcref.html#toc3">Contents</A>
|
||
|
<HR>
|
||
|
<H2><A NAME="strdup"></A> 3.143 <A HREF="funcref.html#toc3.143">strdup</A></H2>
|
||
|
|
||
|
|
||
|
<P>
|
||
|
<BLOCKQUOTE>
|
||
|
<DL>
|
||
|
<DT><B>Function</B><DD><P>Allocate a copy of a string on the heap.</P>
|
||
|
<DT><B>Header</B><DD><P><CODE>
|
||
|
<A HREF="funcref-39.html#string.h">string.h</A></CODE></P>
|
||
|
<DT><B>Declaration</B><DD><P><CODE>char* __fastcall__ strdup (const char* s);</CODE></P>
|
||
|
<DT><B>Description</B><DD><P><CODE>strdup</CODE> allocates a memory block on the heap, big enough
|
||
|
to hold a copy of <CODE>s</CODE> including the terminating zero. If the allocation
|
||
|
fails, <CODE>NULL</CODE> is returned, otherwise <CODE>s</CODE> is copied into the allocated
|
||
|
memory block, and a pointer to the block is returned.</P>
|
||
|
<DT><B>Limits</B><DD><P>
|
||
|
<UL>
|
||
|
<LI>The function is only available as fastcall function, so it may only
|
||
|
be used in presence of a prototype.</LI>
|
||
|
<LI>It is up to the caller to free the allocated memory block.</LI>
|
||
|
</UL>
|
||
|
</P>
|
||
|
<DT><B>Availability</B><DD><P>ISO 9899</P>
|
||
|
<DT><B>See also</B><DD><P>
|
||
|
<A HREF="funcref-107.html#free">free</A>,
|
||
|
<A HREF="funcref-139.html#malloc">malloc</A></P>
|
||
|
<DT><B>Example</B><DD><P>None.</P>
|
||
|
</DL>
|
||
|
</BLOCKQUOTE>
|
||
|
</P>
|
||
|
|
||
|
|
||
|
<HR>
|
||
|
<A HREF="funcref-189.html">Next</A>
|
||
|
<A HREF="funcref-187.html">Previous</A>
|
||
|
<A HREF="funcref.html#toc3">Contents</A>
|
||
|
</BODY>
|
||
|
</HTML>
|