org.apache.tools.ant.taskdefs

Class Basename


public class Basename
extends Task

Sets a property to the base name of a specified file, optionally minus a suffix. This task can accept the following attributes: The file and property attributes are required. The suffix attribute can be specified either with or without the ".", and the result will be the same (ie., the returned file name will be minus the .suffix).

When this task executes, it will set the specified property to the value of the last element in the specified file. If file is a directory, the basename will be the last directory element. If file is a full-path filename, the basename will be the simple file name. If a suffix is specified, and the specified file ends in that suffix, the basename will be the simple file name without the suffix.

Since:
Ant 1.5

Field Summary

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

Method Summary

void
execute()
do the work
void
setFile(File file)
file or directory to get base name from
void
setProperty(String property)
Property to set base name to.
void
setSuffix(String suffix)
Optional suffix to remove from base name.

Methods inherited from class org.apache.tools.ant.Task

execute, getDescription, getLocation, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, init, isInvalid, log, log, maybeConfigure, perform, reconfigure, setDescription, setLocation, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType

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

getProject, log, log, setProject

Method Details

execute

public void execute()
            throws BuildException
do the work
Overrides:
execute in interface Task
Throws:
BuildException - if required attributes are not supplied property and attribute are required attributes

setFile

public void setFile(File file)
file or directory to get base name from
Parameters:
file - file or directory to get base name from

setProperty

public void setProperty(String property)
Property to set base name to.
Parameters:
property - name of property

setSuffix

public void setSuffix(String suffix)
Optional suffix to remove from base name.
Parameters:
suffix - suffix to remove from base name

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