Quiret at 23:49, 16 January 2022

2022-01-16T23:49:48Z

← Older revision		Revision as of 23:49, 16 January 2022
Line 4:		Line 4:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	boolean file.flush ()		boolean file:flush ()
	</syntaxhighlight>		</syntaxhighlight>

Line 18:		Line 18:

	-- Write a nice poem.		-- Write a nice poem.
	textFile.write(		textFile:write(
	[[Roses are red,		[[Roses are red,
	Violets are blue,		Violets are blue,
Line 29:		Line 29:

	-- Make sure the world knows about our poem.		-- Make sure the world knows about our poem.
	textFile.flush();		textFile:flush();

	-- Now the text-file should be filled with the data. The MTA:Eir FileSystem implementation has		-- Now the text-file should be filled with the data. The MTA:Eir FileSystem implementation has

The GTA: Created page with "NOTOC This function writes all temporary buffers of a file/stream object into the output storage. This feature shall be interpreted as a hint, not a necessity. Implementation..."

2014-01-31T16:23:56Z

Created page with "__NOTOC__ This function writes all temporary buffers of a file/stream object into the output storage. This feature shall be interpreted as a hint, not a necessity. Implementation..."

New page

__NOTOC__
This function writes all temporary buffers of a file/stream object into the output storage. This feature shall be interpreted as a hint, not a necessity. Implementations do not have to support this feature.

==Syntax==
<syntaxhighlight lang="lua">
boolean file.flush ()
</syntaxhighlight>

==Returns==
Returns '''true''' if the file/stream has been successfully flushed, '''false''' otherwise.

==Example==
<section name="Client" class="client" show="true">
This snippet writes a text into a file and flushes its buffers, while the file handle is being kept alive as a global. The MTA:Eir FileSystem implementation is encouraged to make sure that the data is written to the harddisk.
<syntaxhighlight lang="lua">
-- Open a text file to store something into.
local textFile = fileCreate( "my_poem.txt" );

-- Write a nice poem.
textFile.write(
[[Roses are red,
Violets are blue,
Blueberries are sweet,
Cupcakes are too.]]
);

-- At this point, the implementation does not have to write the buffers into the textfile.
-- If delayed, the text file will be empty if opened by an external editor.

-- Make sure the world knows about our poem.
textFile.flush();

-- Now the text-file should be filled with the data. The MTA:Eir FileSystem implementation has
-- support for buffer flushing, so the flush method should always return true if used with raw files.

-- We do not want to loose the grip to our lovely poem, so lets keep it alive, forever. <3
_G.poemFile = textFile;
</syntaxhighlight>
</section>
{{:MTA:Eir/FileSystem/file/functions}}

MTA:Eir/FileSystem/file/flush - Revision history

Quiret at 23:49, 16 January 2022

The GTA: Created page with "__NOTOC__ This function writes all temporary buffers of a file/stream object into the output storage. This feature shall be interpreted as a hint, not a necessity. Implementation..."

The GTA: Created page with "NOTOC This function writes all temporary buffers of a file/stream object into the output storage. This feature shall be interpreted as a hint, not a necessity. Implementation..."