64 lines
2.2 KiB
HTML
64 lines
2.2 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: unlink</TITLE>
|
||
|
<LINK HREF="funcref-210.html" REL=next>
|
||
|
<LINK HREF="funcref-208.html" REL=previous>
|
||
|
<LINK HREF="funcref.html#toc3" REL=contents>
|
||
|
</HEAD>
|
||
|
<BODY>
|
||
|
<A HREF="funcref-210.html">Next</A>
|
||
|
<A HREF="funcref-208.html">Previous</A>
|
||
|
<A HREF="funcref.html#toc3">Contents</A>
|
||
|
<HR>
|
||
|
<H2><A NAME="unlink"></A> 3.164 <A HREF="funcref.html#toc3.164">unlink</A></H2>
|
||
|
|
||
|
|
||
|
<P>
|
||
|
<BLOCKQUOTE>
|
||
|
<DL>
|
||
|
<DT><B>Function</B><DD><P>Delete a file.</P>
|
||
|
<DT><B>Header</B><DD><P><CODE>
|
||
|
<A HREF="funcref-42.html#unistd.h">unistd.h</A></CODE></P>
|
||
|
<DT><B>Declaration</B><DD><P><CODE>int __fastcall__ unlink (const char* name);</CODE></P>
|
||
|
<DT><B>Description</B><DD><P><CODE>unlink</CODE> deletes the file with the given name. On success,
|
||
|
zero is returned. On error, -1 is returned and <CODE>errno</CODE> is set to an error
|
||
|
code describing the reason for the failure.</P>
|
||
|
<DT><B>Limits</B><DD><P>
|
||
|
<UL>
|
||
|
<LI>The use of this function is discouraged. Please use <CODE>
|
||
|
<A HREF="funcref-170.html#remove">remove</A></CODE> instead, which is a native ANSI C function and does the same.</LI>
|
||
|
<LI>This function is not available on all cc65 targets (depends on the
|
||
|
availability of file I/O).</LI>
|
||
|
<LI>The function is only available as fastcall function, so it may only
|
||
|
be used in presence of a prototype.</LI>
|
||
|
<LI>Instead of <CODE>unlink</CODE>, <CODE>
|
||
|
<A HREF="funcref-170.html#remove">remove</A></CODE> should be
|
||
|
used, which has the same semantics, but is more portable, because it conforms
|
||
|
to the ISO C standard.</LI>
|
||
|
</UL>
|
||
|
</P>
|
||
|
<DT><B>Availability</B><DD><P>POSIX 1003.1</P>
|
||
|
<DT><B>See also</B><DD><P>
|
||
|
<A HREF="funcref-170.html#remove">remove</A></P>
|
||
|
<DT><B>Example</B><DD>#<P>include <stdio.h>
|
||
|
#include <unistd.h></P>
|
||
|
<P>#define FILENAME "helloworld"</P>
|
||
|
<P>if (unlink (FILENAME) == 0) {
|
||
|
printf ("We deleted %s successfully\n", FILENAME);
|
||
|
} else {
|
||
|
printf ("There was a problem deleting %s\n", FILENAME);
|
||
|
}</P>
|
||
|
</DL>
|
||
|
</BLOCKQUOTE>
|
||
|
</P>
|
||
|
|
||
|
|
||
|
<HR>
|
||
|
<A HREF="funcref-210.html">Next</A>
|
||
|
<A HREF="funcref-208.html">Previous</A>
|
||
|
<A HREF="funcref.html#toc3">Contents</A>
|
||
|
</BODY>
|
||
|
</HTML>
|