unlink

Gamma: Version 4.0
Prev |  | Next

# `unlink`

`unlink` -- deletes a file.

## Syntax

    unlink (filename)

## Arguments

`filename`

  A string representing a valid file name.

## Returns

t if the file could be deleted, otherwise nil.

## Description

This functioin deletes a file in the file system. It will fail if the given file does not exist, or the calling process does not have sufficient privilege to delete the file. Wild cards are not expanded in the file name.

## Example

        Gamma> fu = open("todeletefile.dat","r");
        #<File:"todeletefile.dat">
        Gamma> unlink("todeletefile.dat");
        t
        Gamma> unlink("todeletefile.dat");
        nil
        Gamma>

## See Also

`open`

Prev | Home | Next
`unbuffer_file` | Up | OS APIs

Copyright 1995-2002 by Cogent Real-Time Systems, Inc.