| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| <html xmlns="http://www.w3.org/1999/xhtml"> |
| <head> |
| <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> |
| <meta http-equiv="X-UA-Compatible" content="IE=9"/> |
| <meta name="generator" content="Doxygen 1.8.7"/> |
| <title>FlatBuffers: Use in Go</title> |
| <link href="tabs.css" rel="stylesheet" type="text/css"/> |
| <script type="text/javascript" src="jquery.js"></script> |
| <script type="text/javascript" src="dynsections.js"></script> |
| <link href="navtree.css" rel="stylesheet" type="text/css"/> |
| <script type="text/javascript" src="resize.js"></script> |
| <script type="text/javascript" src="navtree.js"></script> |
| <script type="text/javascript"> |
| $(document).ready(initResizable); |
| $(window).load(resizeHeight); |
| </script> |
| <link href="doxygen.css" rel="stylesheet" type="text/css" /> |
| </head> |
| <body> |
| <div id="top"><!-- do not remove this div, it is closed by doxygen! --> |
| <div id="titlearea"> |
| <table cellspacing="0" cellpadding="0"> |
| <tbody> |
| <tr style="height: 56px;"> |
| <td style="padding-left: 0.5em;"> |
| <div id="projectname">FlatBuffers |
| </div> |
| </td> |
| </tr> |
| </tbody> |
| </table> |
| </div> |
| <!-- end header part --> |
| <!-- Generated by Doxygen 1.8.7 --> |
| </div><!-- top --> |
| <div id="side-nav" class="ui-resizable side-nav-resizable"> |
| <div id="nav-tree"> |
| <div id="nav-tree-contents"> |
| <div id="nav-sync" class="sync"></div> |
| </div> |
| </div> |
| <div id="splitbar" style="-moz-user-select:none;" |
| class="ui-resizable-handle"> |
| </div> |
| </div> |
| <script type="text/javascript"> |
| $(document).ready(function(){initNavTree('md__go_usage.html','');}); |
| </script> |
| <div id="doc-content"> |
| <div class="header"> |
| <div class="headertitle"> |
| <div class="title">Use in Go </div> </div> |
| </div><!--header--> |
| <div class="contents"> |
| <div class="textblock"><p>There's experimental support for reading FlatBuffers in Go. Generate code for Go with the <code>-g</code> option to <code>flatc</code>.</p> |
| <p>See <code>go_test.go</code> for an example. You import the generated code, read a FlatBuffer binary file into a <code>[]byte</code>, which you pass to the <code>GetRootAsMonster</code> function:</p> |
| <div class="fragment"><div class="line"><span class="keyword">import</span> (</div> |
| <div class="line"> example <span class="stringliteral">"MyGame/Example"</span></div> |
| <div class="line"> flatbuffers <span class="stringliteral">"github.com/google/flatbuffers/go"</span></div> |
| <div class="line"></div> |
| <div class="line"> io/ioutil</div> |
| <div class="line">)</div> |
| <div class="line"></div> |
| <div class="line">buf, err := ioutil.ReadFile(<span class="stringliteral">"monster.dat"</span>)</div> |
| <div class="line"><span class="comment">// handle err</span></div> |
| <div class="line">monster := example.GetRootAsMonster(buf, 0)</div> |
| </div><!-- fragment --><p>Now you can access values like this:</p> |
| <div class="fragment"><div class="line">hp := monster.Hp()</div> |
| <div class="line">pos := monster.Pos(nil)</div> |
| </div><!-- fragment --><p>Note that whenever you access a new object like in the <code>Pos</code> example above, a new temporary accessor object gets created. If your code is very performance sensitive (you iterate through a lot of objects), you can replace nil with a pointer to a <code>Vec3</code> object you've already created. This allows you to reuse it across many calls and reduce the amount of object allocation (and thus garbage collection) your program does.</p> |
| <p>To access vectors you pass an extra index to the vector field accessor. Then a second method with the same name suffixed by <code>Length</code> let's you know the number of elements you can access:</p> |
| <div class="fragment"><div class="line"><span class="keywordflow">for</span> i := 0; i < monster.InventoryLength(); i++ {</div> |
| <div class="line"> monster.Inventory(i) <span class="comment">// do something here</span></div> |
| <div class="line">}</div> |
| </div><!-- fragment --><p>You can also construct these buffers in Go using the functions found in the generated code, and the FlatBufferBuilder class:</p> |
| <div class="fragment"><div class="line">builder := flatbuffers.NewBuilder(0)</div> |
| </div><!-- fragment --><p>Create strings:</p> |
| <div class="fragment"><div class="line">str := builder.CreateString(<span class="stringliteral">"MyMonster"</span>)</div> |
| </div><!-- fragment --><p>Create a table with a struct contained therein:</p> |
| <div class="fragment"><div class="line">example.MonsterStart(builder)</div> |
| <div class="line">example.MonsterAddPos(builder, example.CreateVec3(builder, 1.0, 2.0, 3.0, 3.0, 4, 5, 6))</div> |
| <div class="line">example.MonsterAddHp(builder, 80)</div> |
| <div class="line">example.MonsterAddName(builder, str)</div> |
| <div class="line">example.MonsterAddInventory(builder, inv)</div> |
| <div class="line">example.MonsterAddTest_Type(builder, 1)</div> |
| <div class="line">example.MonsterAddTest(builder, mon2)</div> |
| <div class="line">example.MonsterAddTest4(builder, test4s)</div> |
| <div class="line">mon := example.MonsterEnd(builder)</div> |
| </div><!-- fragment --><p>Unlike C++, Go does not support table creation functions like 'createMonster()'. This is to create the buffer without using temporary object allocation (since the <code>Vec3</code> is an inline component of <code>Monster</code>, it has to be created right where it is added, whereas the name and the inventory are not inline). Structs do have convenient methods that allow you to construct them in one call. These also have arguments for nested structs, e.g. if a struct has a field <code>a</code> and a nested struct field <code>b</code> (which has fields <code>c</code> and <code>d</code>), then the arguments will be <code>a</code>, <code>c</code> and <code>d</code>.</p> |
| <p>Vectors also use this start/end pattern to allow vectors of both scalar types and structs:</p> |
| <div class="fragment"><div class="line">example.MonsterStartInventoryVector(builder, 5)</div> |
| <div class="line"><span class="keywordflow">for</span> i := 4; i >= 0; i-- {</div> |
| <div class="line"> builder.PrependByte(byte(i))</div> |
| <div class="line">}</div> |
| <div class="line">inv := builder.EndVector(5)</div> |
| </div><!-- fragment --><p>The generated method 'StartInventoryVector' is provided as a convenience function which calls 'StartVector' with the correct element size of the vector type which in this case is 'ubyte' or 1 byte per vector element. You pass the number of elements you want to write. You write the elements backwards since the buffer is being constructed back to front.</p> |
| <p>There are <code>Prepend</code> functions for all the scalar types. You use <code>PrependUOffset</code> for any previously constructed objects (such as other tables, strings, vectors). For structs, you use the appropriate <code>create</code> function in-line, as shown above in the <code>Monster</code> example.</p> |
| <h2>Text Parsing</h2> |
| <p>There currently is no support for parsing text (Schema's and JSON) directly from Go, though you could use the C++ parser through cgo. Please see the C++ documentation for more on text parsing. </p> |
| </div></div><!-- contents --> |
| </div><!-- doc-content --> |
| <!-- Google Analytics --> |
| <script> |
| (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ |
| (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), |
| m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) |
| })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); |
| ga('create', 'UA-49880327-7', 'auto'); |
| ga('send', 'pageview'); |
| </script> |
| </body> |
| </html> |
