Class wwFileStream

The file stream class can be used to buffer large strings incrementally to file. This is one way to allow creating strings that are bigger than 16mb in size.


        foxpro
        
            
        
     

        foxpro
        
            
        
     
loFS = CREATEOBJECT("wwFileStream")

loFS.Write("Hello ")
loFs.WriteLine("Rick")

*** Large File
loFS.WriteFile("C:\installs\Distribution CD\Demos\wconnect.exe")

lnSize = loFs.nLength
lcText = loFs.ToString()
lcFile = loFs.cFilename  && GUID.txt

this.MessageOut("Size: " + TRANSFORM(loFs.nLength))
this.AssertTrue( lnSize = LEN(lcText) )

loFs.Clear()
this.AssertTrue( loFs.nLength = 0 )

loFS.Dispose()
this.AssertTrue( !FILE(lcFile) )

Custom wwFileStream

Remarks

FoxPro supports access to strings >16mb in a limited fashion. As long as strings are not mutated/changed and are assigned only directly with a single FoxPro operation (like FILETOSTR() or loFs.ToString()) larger than 16mb strings can be used in FoxPro code.

Class Members

Member		Description
	WriteFile	Writes a file from disk into the memory stream. The file can be a text file or binary file. o.WriteFile(lcFilename)
	Clear	Clears the stream's buffer and leaves an empty buffer. o.Clear()
	Dispose	Clears the stream and deletes the underlying file that buffers the string data. o.Dispose()
	ToString	Returns the content of the stream as a string. Note that this string can potentially be bigger than 16mb in size if stored to a FoxPro variable which works. o.ToString()
	ToBlob	Returns the content of the file stream as a blob object. o.ToBlob()
	Write	Writes a string to the stream buffer. o.Write(lcContent)
	WriteLine	Like the [Write()](VFPS://Topic/_56G0MQO8R) method but appends a `CRLF` to the end of the line. o.WriteLine(lcContent)
	nLength	The current size of the string data stored in the stream.