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:

         name => VALUE,
         type => VALUE,


    $Tag->file($name, $type);
    [file name type]
Parameters Description Default
Attributes Default
interpolate (reparse) No
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. name type