4.44. log

Log contained text to specified file.

4.44.1. Summary

    [log file other_named_attributes]

Parameters	Description	Default
arg	Alias for file	DEFAULT_VALUE
create	Set create=1 to create the file if not present	DEFAULT_VALUE
delim	Line delimiter	DEFAULT_VALUE
file	name of file to log to. 'file=">filename"' also sets 'create' attribute.	DEFAULT_VALUE
hide	Suppress status otherwise returned by tag to the page.	DEFAULT_VALUE
process	Processing (if any) to apply to the content while logging nostrip (don't strip leading/trailing whitespace and convert "\r\n" to "\n"	DEFAULT_VALUE
record_delim	Record delimiter	DEFAULT_VALUE
type	Log type text (ordinary text file) quot (delimited entries) error (add Interchange error formatting and time/location stamps)	DEFAULT_VALUE

Attributes	Default
interpolate	No
reparse	Yes

Other_Characteristics
Invalidates cache	no
Container tag	Yes
Has Subtags	No
Nests	No

Tag expansion example:

    [log file]
---
    TODO: (tag result)

ASP-like Perl call:

   $Tag->log(  { file => VALUE_file
}, $body  );

or similarly with positional parameters,

    $Tag->log(file, $attribute_hash_reference, $body);

4.44.2. Description

Log contained text to specified file.

4.44.2.1. create

Set create=1 to create the file if not present

4.44.2.2. delim

Line delimiter

4.44.2.3. file

name of file to log to. 'file=">filename"' also sets 'create' attribute.

4.44.2.4. hide

Suppress status otherwise returned by tag to the page.

4.44.2.5. process

Processing (if any) to apply to the content while logging

• nostrip (don't strip leading/trailing whitespace and convert "\r\n" to "\n"

4.44.2.6. record_delim

Record delimiter

4.44.2.7. type

Log type

• text (ordinary text file)
• quot (delimited entries)
• error (add Interchange error formatting and time/location stamps)