4.27. file
4.27.1. Summary
Parameters: name type
Positional parameters in same order.
Pass attribute hash as last to subroutine: no
Must pass named parameter interpolate=1 to cause interpolation.
Invalidates cache: no
Called Routine:
ASP-like Perl call:
$Tag->file(
{
name => VALUE,
type => VALUE,
}
)
OR
$Tag->file($name, $type);
[file name type]
| Parameters | Description | Default |
| name | DEFAULT_VALUE | |
| type | DEFAULT_VALUE |
| Attributes | Default |
| interpolate (reparse) | No |
| Other_Charactreristics | |
| Invalidates cache | no |
| Container tag | No |
| Has Subtags | No |
| Nests | Yes |
Tag expansion example:
[file name type] --- TAGRESULT
ASP-like Perl call:
$Tag->file( { name => VALUE_name
type => VALUE_type
}, $body );
or similarly with positional parameters,
$Tag->file(name,type, $attribute_hash_reference, $body);
4.27.2. Description
Inserts the contents of the named file. The file should normally be relative to the catalog directory -- file names beginning with / or .. are not allowed if the Interchange server administrator has set NoAbsolute to Yes.
The optional type parameter will do an appropriate ASCII translation on the file before it is sent.