Change docs to not encourage use of 1 byte buffers.

Change-Id: Ib0b1692044f35e374a0f7c0359c94319f4a25619
This commit is contained in:
Wouter van Oortmerssen
2016-10-24 10:29:09 -07:00
parent e31fbb0b23
commit af21b9064d

View File

@@ -399,55 +399,56 @@ The first step is to import/include the library, generated files, etc.
Now we are ready to start building some buffers. In order to start, we need Now we are ready to start building some buffers. In order to start, we need
to create an instance of the `FlatBufferBuilder`, which will contain the buffer to create an instance of the `FlatBufferBuilder`, which will contain the buffer
as it grows: as it grows. You can pass an initial size of the buffer (here 1024 bytes),
which will grow automatically if needed:
<div class="language-cpp"> <div class="language-cpp">
~~~{.cpp} ~~~{.cpp}
// Create a `FlatBufferBuilder`, which will be used to create our // Create a `FlatBufferBuilder`, which will be used to create our
// monsters' FlatBuffers. // monsters' FlatBuffers.
flatbuffers::FlatBufferBuilder builder; flatbuffers::FlatBufferBuilder builder(1024);
~~~ ~~~
</div> </div>
<div class="language-java"> <div class="language-java">
~~~{.java} ~~~{.java}
// Create a `FlatBufferBuilder`, which will be used to create our // Create a `FlatBufferBuilder`, which will be used to create our
// monsters' FlatBuffers. // monsters' FlatBuffers.
FlatBufferBuilder builder = new FlatBufferBuilder(0); FlatBufferBuilder builder = new FlatBufferBuilder(1024);
~~~ ~~~
</div> </div>
<div class="language-csharp"> <div class="language-csharp">
~~~{.cs} ~~~{.cs}
// Create a `FlatBufferBuilder`, which will be used to create our // Create a `FlatBufferBuilder`, which will be used to create our
// monsters' FlatBuffers. // monsters' FlatBuffers.
var builder = new FlatBufferBuilder(1); var builder = new FlatBufferBuilder(1024);
~~~ ~~~
</div> </div>
<div class="language-go"> <div class="language-go">
~~~{.go} ~~~{.go}
// Create a `FlatBufferBuilder`, which will be used to create our // Create a `FlatBufferBuilder`, which will be used to create our
// monsters' FlatBuffers. // monsters' FlatBuffers.
builder := flatbuffers.NewBuilder(0) builder := flatbuffers.NewBuilder(1024)
~~~ ~~~
</div> </div>
<div class="language-python"> <div class="language-python">
~~~{.py} ~~~{.py}
# Create a `FlatBufferBuilder`, which will be used to create our # Create a `FlatBufferBuilder`, which will be used to create our
# monsters' FlatBuffers. # monsters' FlatBuffers.
builder = flatbuffers.Builder(0) builder = flatbuffers.Builder(1024)
~~~ ~~~
</div> </div>
<div class="language-javascript"> <div class="language-javascript">
~~~{.js} ~~~{.js}
// Create a `flatbuffer.Builder`, which will be used to create our // Create a `flatbuffer.Builder`, which will be used to create our
// monsters' FlatBuffers. // monsters' FlatBuffers.
var builder = new flatbuffers.Builder(1); var builder = new flatbuffers.Builder(1024);
~~~ ~~~
</div> </div>
<div class="language-php"> <div class="language-php">
~~~{.php} ~~~{.php}
// Create a `FlatBufferBuilder`, which will be used to create our // Create a `FlatBufferBuilder`, which will be used to create our
// monsters' FlatBuffers. // monsters' FlatBuffers.
$builder = new Google\FlatBuffers\FlatbufferBuilder(0); $builder = new Google\FlatBuffers\FlatbufferBuilder(1024);
~~~ ~~~
</div> </div>
<div class="language-c"> <div class="language-c">