[#FlatFileSeq-Allocate]
= xref:FlatFileSeq.adoc[FlatFileSeq]::Allocate
:relfileprefix: ../
:mrdocs:

Allocate additional space in a file after the given starting position&period; The amount allocated will be the minimum multiple of the sequence chunk size greater than add&lowbar;size&period;

== Synopsis

Declared in `&lt;flatfile&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
size&lowbar;t
Allocate(
    xref:FlatFilePos.adoc[FlatFilePos] const& pos,
    size&lowbar;t add&lowbar;size,
    bool& out&lowbar;of&lowbar;space) const;
----

== Return Value

The number of bytes successfully allocated&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *pos* [in]
| The starting position that bytes will be allocated after&period;
| *add&lowbar;size* [in]
| The minimum number of bytes to be allocated&period;
| *out&lowbar;of&lowbar;space* [out]
| Whether the allocation failed due to insufficient disk space&period;
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#
