Add content to the end of the file

Contract
Return type	wob
Parameter key	Default value	Type
a_obj	req	string

Water Contract
<method resource.filesystem.file.append a_obj=req=string/>

See also: insert, set, is_writable, file

Add a_obj to the end of the _subject of type file . Returns true if successful. If not successful, append throws an error.

Example: Standard usage

<file "logical://user/test_file.txt" />.<append <join char.carriage_return char.newline "more stuff" /> />

If a_obj is not a string , it will be converted before it is written to the file.

Example: Objects are converted before writing

<class foo>
<method htm_inst>
  "foo htm instance"
</method>
</class>
<file "logical://user/test_file.txt" />.<append <join char.carriage_return char.newline <foo /> /> />

The above code would append the string "foo htm instance" to the file. If the insert method is used without an argument, it behaves as the append method except that insert returns the new file content.