Append

Specifies text file to be opened for append mode

Syntax
	KeyPgOpenOpen filename for Append [KeyPgEncodingEncoding encoding_type] [KeyPgLockLock lock_type] as 
	[#]filenum 

Parameters
	filename
		file name to open for append
	encoding_type
		indicates encoding type for the file
	lock_type
		locking to be used while the file is open
	filenum
		unused file number to associate with the open file

Description
	A file mode used with KeyPgOpenOpen to open a text file for writing.

	This mode is used to add text to an existing file  with KeyPgPrintPpPrint #, or 
	comma separated values with KeyPgWriteWrite#.

	Text files can't be simultaneously read and written in FreeBASIC, so if 
	both functions are required on the same file, it must be opened twice.

	filename must be a string expression resulting in a legal file name in 
	the target OS, without wildcards. The file will be sought for in the 
	present directory, unless the filename contains a path . If the file 
	does not exist, it is created. The pointer is set after the last 
	character of the file.

	Encoding_type indicates the Unicode KeyPgEncodingEncoding of the file, so characters 
	are correctly read. If omitted, "ascii" encoding is defaulted. Only 
	little endian character encodings are supported at the moment. 
		*"utf8"
		*"utf16"
		*"utf32"
		*"ascii" (the default)

	Lock_type indicates the way the file is locked  for other processes, it 
	is one of:
		* Read - the file can be opened simultaneously by other processes, 
		  but not for reading
		* Write - the file can be opened simultaneously by other processes, 
		  but not for writing
		* Read Write - the file cannot be opened simultaneously by other 
		  processes (the default)

	filenum Is a valid FreeBASIC file number (in the range 1..255) not being 
	used for any other file presently open. The file number identifies the 
	file for the rest of file operations. A free file number can be found 
	using the KeyPgFreefileFreeFile function.

Example
	Dim i As Integer
	For i = 1 To 10
	   Open "test.txt" For Append As #1
	   Print #1, "extending test.txt"
	   Close #1
	Next

Differences from QB
	* None

See also
	* KeyPgInputfilemodeInput (File Mode)
	* KeyPgOpenOpen
	* KeyPgOutputOutput
	* KeyPgPrintPpPrint #
	* KeyPgPrintPp? #
	* KeyPgWriteWrite #

