# Echoproperties Task

## echoproperties

### Description

Displays all the current properties in the project. The output can be sent to a file if desired. You can also specify a subset of properties to save by naming a prefix: only properties starting with this prefix will be saved. This task can be used as a somewhat contrived means of returning data from an `<ant>` invocation, but is really for debugging build files.

### Parameters

Attribute | Description | Required
destfile | If specified, the value indicates the name of the file to send the output of the statement to. The generated output file is compatible for loading by any Java application as a property file. If not specified, then the output will go to the Ant log. | No
prefix | a prefix which is used to filter the properties only those properties starting with this prefix will be echoed. | No
failonerror | By default, the "failonerror" attribute is enabled. If an error occurs while writing the properties to a file, and this attribute is enabled, then a BuildException will be thrown, causing the build to fail. If disabled, then IO errors will be reported as a log statement, and the build will continue without failure from this task. | No

### Examples

>       <echoproperties />

Report the current properties to the log.

>       <echoproperties destfile="my.properties" />

Report the current properties to the file "my.properties", and will fail the build if the file could not be created or written to.

>       <echoproperties destfile="my.properties" failonerror="false" />

Report the current properties to the file "my.properties", and will log a message if the file could not be created or written to, but will still allow the build to continue.

>       <echoproperties prefix="java."/>

List all properties beginning with "java."

Copyright © 2002 Apache Software Foundation. All rights Reserved.