4.28. file
4.28.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_Characteristics | |
Invalidates cache | no |
Container tag | No |
Has Subtags | No |
Nests | Yes |
Tag expansion example:
[file name type] --- TODO: (tag result)
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.28.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.