## org.apache.tools.ant.taskdefs
Class Delete

    java.lang.Object
      org.apache.tools.ant.ProjectComponent
          org.apache.tools.ant.Task
              org.apache.tools.ant.taskdefs.MatchingTask
                  org.apache.tools.ant.taskdefs.Delete

All Implemented Interfaces:
  SelectorContainer

public class Delete
extends MatchingTask

Deletes a file or directory, or set of files defined by a fileset. The original delete task would delete a file, or a set of files using the include/exclude syntax. The deltree task would delete a directory tree. This task combines the functionality of these two originally distinct tasks.

Currently Delete extends MatchingTask. This is intend only to provide backwards compatibility for a release. The future position is to use nested filesets exclusively.

Since:
  Ant 1.2
Author:
  Stefano Mazzocchi stefano@apache.org, Tom Dimock tad1@cornell.edu, Glenn McAllister glennm@ca.ibm.com, Jon S. Stevens jon@latchkey.com

Field Summary
`protected java.io.File` `dir`
`protected java.io.File` `file`
`protected java.util.Vector` `filesets`
`protected boolean` `includeEmpty`
`protected boolean` `usedMatchingTask`

Fields inherited from class org.apache.tools.ant.taskdefs.MatchingTask
`fileset, useDefaultExcludes`

Fields inherited from class org.apache.tools.ant.Task
`description, location, target, taskName, taskType, wrapper`

Fields inherited from class org.apache.tools.ant.ProjectComponent
`project`

Constructor Summary
`Delete()`

Method Summary
`void` `addAnd(AndSelector selector)` add an "And" selector entry on the selector list
`void` `addContains(ContainsSelector selector)` add a contains selector entry on the selector list
`void` `addCustom(ExtendSelector selector)` add an extended selector entry on the selector list
`void` `addDate(DateSelector selector)` add a selector date entry on the selector list
`void` `addDepend(DependSelector selector)` add a depends selector entry on the selector list
`void` `addDepth(DepthSelector selector)` add a depth selector entry on the selector list
`void` `addFilename(FilenameSelector selector)` add a selector filename entry on the selector list
`void` `addFileset(FileSet set)` Adds a set of files to be deleted.
`void` `addMajority(MajoritySelector selector)` add a majority selector entry on the selector list
`void` `addNone(NoneSelector selector)` add a "None" selector entry on the selector list
`void` `addNot(NotSelector selector)` add a "Not" selector entry on the selector list
`void` `addOr(OrSelector selector)` add an "Or" selector entry on the selector list
`void` `addPresent(PresentSelector selector)` add a present selector entry on the selector list
`void` `addSelector(SelectSelector selector)` add a "Select" selector entry on the selector list
`void` `addSize(SizeSelector selector)` add a selector size entry on the selector list
`PatternSet.NameEntry` `createExclude()` add a name entry on the exclude list
`PatternSet.NameEntry` `createExcludesFile()` add a name entry on the include files list
`PatternSet.NameEntry` `createInclude()` add a name entry on the include list
`PatternSet.NameEntry` `createIncludesFile()` add a name entry on the include files list
`PatternSet` `createPatternSet()` add a set of patterns
`void` `execute()` Delete the file(s).
`protected void` `removeDir(java.io.File d)`
`protected void` `removeFiles(java.io.File d, java.lang.String[] files, java.lang.String[] dirs)` remove an array of files in a directory, and a list of subdirectories which will only be deleted if 'includeEmpty' is true
`void` `setCaseSensitive(boolean isCaseSensitive)` Sets case sensitivity of the file system
`void` `setDefaultexcludes(boolean useDefaultExcludes)` Sets whether default exclusions should be used or not.
`void` `setDir(java.io.File dir)` Set the directory from which files are to be deleted
`void` `setExcludes(java.lang.String excludes)` Sets the set of exclude patterns.
`void` `setExcludesfile(java.io.File excludesfile)` Sets the name of the file containing the includes patterns.
`void` `setFailOnError(boolean failonerror)` If false, note errors but continue.
`void` `setFile(java.io.File file)` Set the name of a single file to be removed.
`void` `setFollowSymlinks(boolean followSymlinks)` Sets whether or not symbolic links should be followed.
`void` `setIncludeEmptyDirs(boolean includeEmpty)` If true, delete empty directories.
`void` `setIncludes(java.lang.String includes)` Sets the set of include patterns.
`void` `setIncludesfile(java.io.File includesfile)` Sets the name of the file containing the includes patterns.
`void` `setQuiet(boolean quiet)` If true and the file does not exist, do not display a diagnostic message or modify the exit status to reflect an error.
`void` `setVerbose(boolean verbose)` If true, list all names of deleted files.

Methods inherited from class org.apache.tools.ant.taskdefs.MatchingTask
`appendSelector, getDirectoryScanner, getImplicitFileSet, getSelectors, hasSelectors, selectorCount, selectorElements, setProject, XsetIgnore, XsetItems`

Methods inherited from class org.apache.tools.ant.Task
`getDescription, getLocation, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, handleErrorFlush, handleErrorOutput, handleFlush, handleOutput, init, isInvalid, log, log, maybeConfigure, perform, setDescription, setLocation, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName`

Methods inherited from class org.apache.tools.ant.ProjectComponent
`getProject`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Field Detail

### file

    protected java.io.File file

### dir

    protected java.io.File dir

### filesets

    protected java.util.Vector filesets

### usedMatchingTask

    protected boolean usedMatchingTask

### includeEmpty

    protected boolean includeEmpty

Constructor Detail

### Delete

    public Delete()

Method Detail

### setFile

    public void setFile(java.io.File file)

  Set the name of a single file to be removed.

  Parameters:
    `file` - the file to be deleted

### setDir

    public void setDir(java.io.File dir)

  Set the directory from which files are to be deleted

  Parameters:
    `dir` - the directory path.

### setVerbose

    public void setVerbose(boolean verbose)

  If true, list all names of deleted files.

  Parameters:
    `verbose` - "true" or "on"

### setQuiet

    public void setQuiet(boolean quiet)

  If true and the file does not exist, do not display a diagnostic message or modify the exit status to reflect an error. This means that if a file or directory cannot be deleted, then no error is reported. This setting emulates the -f option to the Unix "rm" command. Default is false meaning things are "noisy"

  Parameters:
    `quiet` - "true" or "on"

### setFailOnError

    public void setFailOnError(boolean failonerror)

  If false, note errors but continue.

  Parameters:
    `failonerror` - true or false

### setIncludeEmptyDirs

    public void setIncludeEmptyDirs(boolean includeEmpty)

  If true, delete empty directories.

### addFileset

    public void addFileset(FileSet set)

  Adds a set of files to be deleted.

### createInclude

    public PatternSet.NameEntry createInclude()

  add a name entry on the include list

  Overrides:
    `createInclude` in class `MatchingTask`

### createIncludesFile

    public PatternSet.NameEntry createIncludesFile()

  add a name entry on the include files list

  Overrides:
    `createIncludesFile` in class `MatchingTask`

### createExclude

    public PatternSet.NameEntry createExclude()

  add a name entry on the exclude list

  Overrides:
    `createExclude` in class `MatchingTask`

### createExcludesFile

    public PatternSet.NameEntry createExcludesFile()

  add a name entry on the include files list

  Overrides:
    `createExcludesFile` in class `MatchingTask`

### createPatternSet

    public PatternSet createPatternSet()

  add a set of patterns

  Overrides:
    `createPatternSet` in class `MatchingTask`

### setIncludes

    public void setIncludes(java.lang.String includes)

  Sets the set of include patterns. Patterns may be separated by a comma or a space.

  Overrides:
    `setIncludes` in class `MatchingTask`
  Parameters:
    `includes` - the string containing the include patterns

### setExcludes

    public void setExcludes(java.lang.String excludes)

  Sets the set of exclude patterns. Patterns may be separated by a comma or a space.

  Overrides:
    `setExcludes` in class `MatchingTask`
  Parameters:
    `excludes` - the string containing the exclude patterns

### setDefaultexcludes

    public void setDefaultexcludes(boolean useDefaultExcludes)

  Sets whether default exclusions should be used or not.

  Overrides:
    `setDefaultexcludes` in class `MatchingTask`
  Parameters:
    `useDefaultExcludes` - "true"|"on"|"yes" when default exclusions should be used, "false"|"off"|"no" when they shouldn't be used.

### setIncludesfile

    public void setIncludesfile(java.io.File includesfile)

  Sets the name of the file containing the includes patterns.

  Overrides:
    `setIncludesfile` in class `MatchingTask`
  Parameters:
    `includesfile` - A string containing the filename to fetch the include patterns from.

### setExcludesfile

    public void setExcludesfile(java.io.File excludesfile)

  Sets the name of the file containing the includes patterns.

  Overrides:
    `setExcludesfile` in class `MatchingTask`
  Parameters:
    `excludesfile` - A string containing the filename to fetch the include patterns from.

### setCaseSensitive

    public void setCaseSensitive(boolean isCaseSensitive)

  Sets case sensitivity of the file system

  Overrides:
    `setCaseSensitive` in class `MatchingTask`
  Parameters:
    `isCaseSensitive` - "true"|"on"|"yes" if file system is case sensitive, "false"|"off"|"no" when not.

### setFollowSymlinks

    public void setFollowSymlinks(boolean followSymlinks)

  Sets whether or not symbolic links should be followed.

  Overrides:
    `setFollowSymlinks` in class `MatchingTask`
  Parameters:
    `followSymlinks` - whether or not symbolic links should be followed

### addSelector

    public void addSelector(SelectSelector selector)

  add a "Select" selector entry on the selector list

  Specified by:
    `addSelector` in interface `SelectorContainer`
  Overrides:
    `addSelector` in class `MatchingTask`

### addAnd

    public void addAnd(AndSelector selector)

  add an "And" selector entry on the selector list

  Specified by:
    `addAnd` in interface `SelectorContainer`
  Overrides:
    `addAnd` in class `MatchingTask`

### addOr

    public void addOr(OrSelector selector)

  add an "Or" selector entry on the selector list

  Specified by:
    `addOr` in interface `SelectorContainer`
  Overrides:
    `addOr` in class `MatchingTask`

### addNot

    public void addNot(NotSelector selector)

  add a "Not" selector entry on the selector list

  Specified by:
    `addNot` in interface `SelectorContainer`
  Overrides:
    `addNot` in class `MatchingTask`

### addNone

    public void addNone(NoneSelector selector)

  add a "None" selector entry on the selector list

  Specified by:
    `addNone` in interface `SelectorContainer`
  Overrides:
    `addNone` in class `MatchingTask`

### addMajority

    public void addMajority(MajoritySelector selector)

  add a majority selector entry on the selector list

  Specified by:
    `addMajority` in interface `SelectorContainer`
  Overrides:
    `addMajority` in class `MatchingTask`

### addDate

    public void addDate(DateSelector selector)

  add a selector date entry on the selector list

  Specified by:
    `addDate` in interface `SelectorContainer`
  Overrides:
    `addDate` in class `MatchingTask`

### addSize

    public void addSize(SizeSelector selector)

  add a selector size entry on the selector list

  Specified by:
    `addSize` in interface `SelectorContainer`
  Overrides:
    `addSize` in class `MatchingTask`

### addFilename

    public void addFilename(FilenameSelector selector)

  add a selector filename entry on the selector list

  Specified by:
    `addFilename` in interface `SelectorContainer`
  Overrides:
    `addFilename` in class `MatchingTask`

### addCustom

    public void addCustom(ExtendSelector selector)

  add an extended selector entry on the selector list

  Specified by:
    `addCustom` in interface `SelectorContainer`
  Overrides:
    `addCustom` in class `MatchingTask`

### addContains

    public void addContains(ContainsSelector selector)

  add a contains selector entry on the selector list

  Specified by:
    `addContains` in interface `SelectorContainer`
  Overrides:
    `addContains` in class `MatchingTask`

### addPresent

    public void addPresent(PresentSelector selector)

  add a present selector entry on the selector list

  Specified by:
    `addPresent` in interface `SelectorContainer`
  Overrides:
    `addPresent` in class `MatchingTask`

### addDepth

    public void addDepth(DepthSelector selector)

  add a depth selector entry on the selector list

  Specified by:
    `addDepth` in interface `SelectorContainer`
  Overrides:
    `addDepth` in class `MatchingTask`

### addDepend

    public void addDepend(DependSelector selector)

  add a depends selector entry on the selector list

  Specified by:
    `addDepend` in interface `SelectorContainer`
  Overrides:
    `addDepend` in class `MatchingTask`

### execute

    public void execute()
                 throws BuildException

  Delete the file(s).

  Overrides:
    `execute` in class `Task`
  Throws:
    `BuildException` - if something goes wrong with the build

### removeDir

    protected void removeDir(java.io.File d)

### removeFiles

    protected void removeFiles(java.io.File d,
                               java.lang.String[] files,
                               java.lang.String[] dirs)

  remove an array of files in a directory, and a list of subdirectories which will only be deleted if 'includeEmpty' is true

  Parameters:
    `d` - directory to work from
    `files` - array of files to delete; can be of zero length
    `dirs` - array of directories to delete; can of zero length

Copyright © 2000-2003 Apache Software Foundation. All Rights Reserved.