Description

Write the content of a file to stdout.

Parameters

file

Description: file to be written

Domain: valid filename

Default: -

to_file

Description: if specified this attribute defines the name of the file the input file will be written to

Domain: valid filename

Default: -

append

Description: This attribute applies only if attribute 'to'file' was specified. If set to 'true' the content of 'file' will be appended to the file. Otherwise the file will be overwritten with the content of 'file'.

Domain: Boolean (true|false)

Default: false

RNG Specification

<define name="cat">
  <element name="cat">
    <ref name="dir_if_unless"/>
    <choice>
      <text/>
      <attribute name="file"/>
    </choice>
    <optional>
      <attribute name="to_file"/>
      <optional>
        <attribute name="append"/>
      </optional>
    </optional>
  </element>
</define>

		

Examples

  <cat file="my_file.txt"/>
  <cat file="my_file.txt" to_file="output.txt"/>
  <cat file="my_other_file.txt" to_file="output.txt" append="true"/>