# Length Task

## Length

### Description

Display or set a property containing length information for a string, a file, or one or more nested filesets.

### Parameters

Attribute | Description | Required
property | The property to set. If omitted the length is written to the log. | No
file | Single file whose length to report. | One of these, or one or more nested filesets
string | The string whose length to report.
mode | File length mode; when "all" the resulting value is the sum of all included files' lengths; when "each" the task outputs the absolute path and length of each included file, one per line. | No; default is "all"
trim | Whether to trim when operating on a string. | No; only valid when string is set

### Parameters specified as nested elements

#### fileset

You can include files via nested filesets.

### Examples

    <length string="foo" property="length.foo" />

Stores the length of the string "foo" in the property named length.foo.

    <length file="bar" property="length.bar" />

Stores the length of file "bar" in the property named length.bar.

Copyright © 2005 The Apache Software Foundation. All rights Reserved.