diff --git a/flatbuffers_8h_source.html b/flatbuffers_8h_source.html index 0b3561f832e3f06ea71d0fbb4fe11a912ca9322d..cd5ae277e8604033d7401a429937fcd35b178364 100644 --- a/flatbuffers_8h_source.html +++ b/flatbuffers_8h_source.html @@ -203,7 +203,7 @@ $(document).ready(function(){initNavTree('flatbuffers_8h_source.html','');}); <div class="line"><a name="l00088"></a><span class="lineno"> 88</span> <span class="preprocessor">#endif // !defined(FLATBUFFERS_LITTLEENDIAN)</span></div> <div class="line"><a name="l00089"></a><span class="lineno"> 89</span> </div> <div class="line"><a name="l00090"></a><span class="lineno"> 90</span> <span class="preprocessor">#define FLATBUFFERS_VERSION_MAJOR 1</span></div> -<div class="line"><a name="l00091"></a><span class="lineno"> 91</span> <span class="preprocessor">#define FLATBUFFERS_VERSION_MINOR 0</span></div> +<div class="line"><a name="l00091"></a><span class="lineno"> 91</span> <span class="preprocessor">#define FLATBUFFERS_VERSION_MINOR 5</span></div> <div class="line"><a name="l00092"></a><span class="lineno"> 92</span> <span class="preprocessor">#define FLATBUFFERS_VERSION_REVISION 0</span></div> <div class="line"><a name="l00093"></a><span class="lineno"> 93</span> <span class="preprocessor">#define FLATBUFFERS_STRING_EXPAND(X) #X</span></div> <div class="line"><a name="l00094"></a><span class="lineno"> 94</span> <span class="preprocessor">#define FLATBUFFERS_STRING(X) FLATBUFFERS_STRING_EXPAND(X)</span></div> @@ -367,9 +367,9 @@ $(document).ready(function(){initNavTree('flatbuffers_8h_source.html','');}); <div class="line"><a name="l00252"></a><span class="lineno"> 252</span> <span class="comment">// calling Get() for every element.</span></div> <div class="line"><a name="l00253"></a><span class="lineno"> 253</span> <span class="keyword">template</span><<span class="keyword">typename</span> T, <span class="keyword">typename</span> IT></div> <div class="line"><a name="l00254"></a><span class="lineno"> 254</span> <span class="keyword">struct </span>VectorIterator</div> -<div class="line"><a name="l00255"></a><span class="lineno"> 255</span>  : <span class="keyword">public</span> std::iterator<std::input_iterator_tag, IT, uoffset_t> {</div> +<div class="line"><a name="l00255"></a><span class="lineno"> 255</span>  : <span class="keyword">public</span> std::iterator<std::random_access_iterator_tag, IT, uoffset_t> {</div> <div class="line"><a name="l00256"></a><span class="lineno"> 256</span> </div> -<div class="line"><a name="l00257"></a><span class="lineno"> 257</span>  <span class="keyword">typedef</span> std::iterator<std::input_iterator_tag, IT, uoffset_t> super_type;</div> +<div class="line"><a name="l00257"></a><span class="lineno"> 257</span>  <span class="keyword">typedef</span> std::iterator<std::random_access_iterator_tag, IT, uoffset_t> super_type;</div> <div class="line"><a name="l00258"></a><span class="lineno"> 258</span> </div> <div class="line"><a name="l00259"></a><span class="lineno"> 259</span> <span class="keyword">public</span>:</div> <div class="line"><a name="l00260"></a><span class="lineno"> 260</span>  VectorIterator(<span class="keyword">const</span> uint8_t *data, uoffset_t i) :</div> @@ -389,15 +389,15 @@ $(document).ready(function(){initNavTree('flatbuffers_8h_source.html','');}); <div class="line"><a name="l00274"></a><span class="lineno"> 274</span>  <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div> <div class="line"><a name="l00275"></a><span class="lineno"> 275</span>  }</div> <div class="line"><a name="l00276"></a><span class="lineno"> 276</span> </div> -<div class="line"><a name="l00277"></a><span class="lineno"> 277</span>  <span class="keywordtype">bool</span> operator==(<span class="keyword">const</span> VectorIterator& other)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l00277"></a><span class="lineno"> 277</span>  <span class="keywordtype">bool</span> operator==(<span class="keyword">const</span> VectorIterator &other)<span class="keyword"> const </span>{</div> <div class="line"><a name="l00278"></a><span class="lineno"> 278</span>  <span class="keywordflow">return</span> data_ == other.data_;</div> <div class="line"><a name="l00279"></a><span class="lineno"> 279</span>  }</div> <div class="line"><a name="l00280"></a><span class="lineno"> 280</span> </div> -<div class="line"><a name="l00281"></a><span class="lineno"> 281</span>  <span class="keywordtype">bool</span> operator!=(<span class="keyword">const</span> VectorIterator& other)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l00281"></a><span class="lineno"> 281</span>  <span class="keywordtype">bool</span> operator!=(<span class="keyword">const</span> VectorIterator &other)<span class="keyword"> const </span>{</div> <div class="line"><a name="l00282"></a><span class="lineno"> 282</span>  <span class="keywordflow">return</span> data_ != other.data_;</div> <div class="line"><a name="l00283"></a><span class="lineno"> 283</span>  }</div> <div class="line"><a name="l00284"></a><span class="lineno"> 284</span> </div> -<div class="line"><a name="l00285"></a><span class="lineno"> 285</span>  ptrdiff_t operator-(<span class="keyword">const</span> VectorIterator& other)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l00285"></a><span class="lineno"> 285</span>  ptrdiff_t operator-(<span class="keyword">const</span> VectorIterator &other)<span class="keyword"> const </span>{</div> <div class="line"><a name="l00286"></a><span class="lineno"> 286</span>  <span class="keywordflow">return</span> (data_ - other.data_) / IndirectHelper<T>::element_stride;</div> <div class="line"><a name="l00287"></a><span class="lineno"> 287</span>  }</div> <div class="line"><a name="l00288"></a><span class="lineno"> 288</span> </div> @@ -415,1513 +415,1542 @@ $(document).ready(function(){initNavTree('flatbuffers_8h_source.html','');}); <div class="line"><a name="l00300"></a><span class="lineno"> 300</span>  }</div> <div class="line"><a name="l00301"></a><span class="lineno"> 301</span> </div> <div class="line"><a name="l00302"></a><span class="lineno"> 302</span>  VectorIterator operator++(<span class="keywordtype">int</span>) {</div> -<div class="line"><a name="l00303"></a><span class="lineno"> 303</span>  VectorIterator temp(data_,0);</div> +<div class="line"><a name="l00303"></a><span class="lineno"> 303</span>  VectorIterator temp(data_, 0);</div> <div class="line"><a name="l00304"></a><span class="lineno"> 304</span>  data_ += IndirectHelper<T>::element_stride;</div> <div class="line"><a name="l00305"></a><span class="lineno"> 305</span>  <span class="keywordflow">return</span> temp;</div> <div class="line"><a name="l00306"></a><span class="lineno"> 306</span>  }</div> <div class="line"><a name="l00307"></a><span class="lineno"> 307</span> </div> -<div class="line"><a name="l00308"></a><span class="lineno"> 308</span> <span class="keyword">private</span>:</div> -<div class="line"><a name="l00309"></a><span class="lineno"> 309</span>  <span class="keyword">const</span> uint8_t *data_;</div> -<div class="line"><a name="l00310"></a><span class="lineno"> 310</span> };</div> +<div class="line"><a name="l00308"></a><span class="lineno"> 308</span>  VectorIterator operator+(<span class="keyword">const</span> uoffset_t &offset) {</div> +<div class="line"><a name="l00309"></a><span class="lineno"> 309</span>  <span class="keywordflow">return</span> VectorIterator(data_ + offset * IndirectHelper<T>::element_stride, 0);</div> +<div class="line"><a name="l00310"></a><span class="lineno"> 310</span>  }</div> <div class="line"><a name="l00311"></a><span class="lineno"> 311</span> </div> -<div class="line"><a name="l00312"></a><span class="lineno"> 312</span> <span class="comment">// This is used as a helper type for accessing vectors.</span></div> -<div class="line"><a name="l00313"></a><span class="lineno"> 313</span> <span class="comment">// Vector::data() assumes the vector elements start after the length field.</span></div> -<div class="line"><a name="l00314"></a><span class="lineno"> 314</span> <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keyword">class </span>Vector {</div> -<div class="line"><a name="l00315"></a><span class="lineno"> 315</span> <span class="keyword">public</span>:</div> -<div class="line"><a name="l00316"></a><span class="lineno"> 316</span>  <span class="keyword">typedef</span> VectorIterator<T, typename IndirectHelper<T>::mutable_return_type></div> -<div class="line"><a name="l00317"></a><span class="lineno"> 317</span>  iterator;</div> -<div class="line"><a name="l00318"></a><span class="lineno"> 318</span>  <span class="keyword">typedef</span> VectorIterator<T, typename IndirectHelper<T>::return_type></div> -<div class="line"><a name="l00319"></a><span class="lineno"> 319</span>  const_iterator;</div> -<div class="line"><a name="l00320"></a><span class="lineno"> 320</span> </div> -<div class="line"><a name="l00321"></a><span class="lineno"> 321</span>  uoffset_t size()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> EndianScalar(length_); }</div> -<div class="line"><a name="l00322"></a><span class="lineno"> 322</span> </div> -<div class="line"><a name="l00323"></a><span class="lineno"> 323</span>  <span class="comment">// Deprecated: use size(). Here for backwards compatibility.</span></div> -<div class="line"><a name="l00324"></a><span class="lineno"> 324</span>  uoffset_t Length()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> size(); }</div> -<div class="line"><a name="l00325"></a><span class="lineno"> 325</span> </div> -<div class="line"><a name="l00326"></a><span class="lineno"> 326</span>  <span class="keyword">typedef</span> <span class="keyword">typename</span> IndirectHelper<T>::return_type return_type;</div> -<div class="line"><a name="l00327"></a><span class="lineno"> 327</span>  <span class="keyword">typedef</span> <span class="keyword">typename</span> IndirectHelper<T>::mutable_return_type mutable_return_type;</div> -<div class="line"><a name="l00328"></a><span class="lineno"> 328</span> </div> -<div class="line"><a name="l00329"></a><span class="lineno"> 329</span>  return_type Get(uoffset_t i)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l00330"></a><span class="lineno"> 330</span>  assert(i < size());</div> -<div class="line"><a name="l00331"></a><span class="lineno"> 331</span>  <span class="keywordflow">return</span> IndirectHelper<T>::Read(Data(), i);</div> -<div class="line"><a name="l00332"></a><span class="lineno"> 332</span>  }</div> -<div class="line"><a name="l00333"></a><span class="lineno"> 333</span> </div> -<div class="line"><a name="l00334"></a><span class="lineno"> 334</span>  return_type operator[](uoffset_t i)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> Get(i); }</div> -<div class="line"><a name="l00335"></a><span class="lineno"> 335</span> </div> -<div class="line"><a name="l00336"></a><span class="lineno"> 336</span>  <span class="comment">// If this is a Vector of enums, T will be its storage type, not the enum</span></div> -<div class="line"><a name="l00337"></a><span class="lineno"> 337</span>  <span class="comment">// type. This function makes it convenient to retrieve value with enum</span></div> -<div class="line"><a name="l00338"></a><span class="lineno"> 338</span>  <span class="comment">// type E.</span></div> -<div class="line"><a name="l00339"></a><span class="lineno"> 339</span>  <span class="keyword">template</span><<span class="keyword">typename</span> E> E GetEnum(uoffset_t i)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l00340"></a><span class="lineno"> 340</span>  <span class="keywordflow">return</span> <span class="keyword">static_cast<</span>E<span class="keyword">></span>(Get(i));</div> -<div class="line"><a name="l00341"></a><span class="lineno"> 341</span>  }</div> -<div class="line"><a name="l00342"></a><span class="lineno"> 342</span> </div> -<div class="line"><a name="l00343"></a><span class="lineno"> 343</span>  <span class="keyword">const</span> <span class="keywordtype">void</span> *GetStructFromOffset(<span class="keywordtype">size_t</span> o)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l00344"></a><span class="lineno"> 344</span>  <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span><span class="keywordtype">void</span> *<span class="keyword">></span>(Data() + o);</div> -<div class="line"><a name="l00345"></a><span class="lineno"> 345</span>  }</div> -<div class="line"><a name="l00346"></a><span class="lineno"> 346</span> </div> -<div class="line"><a name="l00347"></a><span class="lineno"> 347</span>  iterator begin() { <span class="keywordflow">return</span> iterator(Data(), 0); }</div> -<div class="line"><a name="l00348"></a><span class="lineno"> 348</span>  const_iterator begin()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> const_iterator(Data(), 0); }</div> +<div class="line"><a name="l00312"></a><span class="lineno"> 312</span>  VectorIterator& operator+=(<span class="keyword">const</span> uoffset_t &offset) {</div> +<div class="line"><a name="l00313"></a><span class="lineno"> 313</span>  data_ += offset * IndirectHelper<T>::element_stride;</div> +<div class="line"><a name="l00314"></a><span class="lineno"> 314</span>  <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div> +<div class="line"><a name="l00315"></a><span class="lineno"> 315</span>  }</div> +<div class="line"><a name="l00316"></a><span class="lineno"> 316</span> </div> +<div class="line"><a name="l00317"></a><span class="lineno"> 317</span>  VectorIterator &operator--() {</div> +<div class="line"><a name="l00318"></a><span class="lineno"> 318</span>  data_ -= IndirectHelper<T>::element_stride;</div> +<div class="line"><a name="l00319"></a><span class="lineno"> 319</span>  <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div> +<div class="line"><a name="l00320"></a><span class="lineno"> 320</span>  }</div> +<div class="line"><a name="l00321"></a><span class="lineno"> 321</span> </div> +<div class="line"><a name="l00322"></a><span class="lineno"> 322</span>  VectorIterator operator--(<span class="keywordtype">int</span>) {</div> +<div class="line"><a name="l00323"></a><span class="lineno"> 323</span>  VectorIterator temp(data_, 0);</div> +<div class="line"><a name="l00324"></a><span class="lineno"> 324</span>  data_ -= IndirectHelper<T>::element_stride;</div> +<div class="line"><a name="l00325"></a><span class="lineno"> 325</span>  <span class="keywordflow">return</span> temp;</div> +<div class="line"><a name="l00326"></a><span class="lineno"> 326</span>  }</div> +<div class="line"><a name="l00327"></a><span class="lineno"> 327</span> </div> +<div class="line"><a name="l00328"></a><span class="lineno"> 328</span>  VectorIterator operator-(<span class="keyword">const</span> uoffset_t &offset) {</div> +<div class="line"><a name="l00329"></a><span class="lineno"> 329</span>  <span class="keywordflow">return</span> VectorIterator(data_ - offset * IndirectHelper<T>::element_stride, 0);</div> +<div class="line"><a name="l00330"></a><span class="lineno"> 330</span>  }</div> +<div class="line"><a name="l00331"></a><span class="lineno"> 331</span> </div> +<div class="line"><a name="l00332"></a><span class="lineno"> 332</span>  VectorIterator& operator-=(<span class="keyword">const</span> uoffset_t &offset) {</div> +<div class="line"><a name="l00333"></a><span class="lineno"> 333</span>  data_ -= offset * IndirectHelper<T>::element_stride;</div> +<div class="line"><a name="l00334"></a><span class="lineno"> 334</span>  <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div> +<div class="line"><a name="l00335"></a><span class="lineno"> 335</span>  }</div> +<div class="line"><a name="l00336"></a><span class="lineno"> 336</span> </div> +<div class="line"><a name="l00337"></a><span class="lineno"> 337</span> <span class="keyword">private</span>:</div> +<div class="line"><a name="l00338"></a><span class="lineno"> 338</span>  <span class="keyword">const</span> uint8_t *data_;</div> +<div class="line"><a name="l00339"></a><span class="lineno"> 339</span> };</div> +<div class="line"><a name="l00340"></a><span class="lineno"> 340</span> </div> +<div class="line"><a name="l00341"></a><span class="lineno"> 341</span> <span class="comment">// This is used as a helper type for accessing vectors.</span></div> +<div class="line"><a name="l00342"></a><span class="lineno"> 342</span> <span class="comment">// Vector::data() assumes the vector elements start after the length field.</span></div> +<div class="line"><a name="l00343"></a><span class="lineno"> 343</span> <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keyword">class </span>Vector {</div> +<div class="line"><a name="l00344"></a><span class="lineno"> 344</span> <span class="keyword">public</span>:</div> +<div class="line"><a name="l00345"></a><span class="lineno"> 345</span>  <span class="keyword">typedef</span> VectorIterator<T, typename IndirectHelper<T>::mutable_return_type></div> +<div class="line"><a name="l00346"></a><span class="lineno"> 346</span>  iterator;</div> +<div class="line"><a name="l00347"></a><span class="lineno"> 347</span>  <span class="keyword">typedef</span> VectorIterator<T, typename IndirectHelper<T>::return_type></div> +<div class="line"><a name="l00348"></a><span class="lineno"> 348</span>  const_iterator;</div> <div class="line"><a name="l00349"></a><span class="lineno"> 349</span> </div> -<div class="line"><a name="l00350"></a><span class="lineno"> 350</span>  iterator end() { <span class="keywordflow">return</span> iterator(Data(), size()); }</div> -<div class="line"><a name="l00351"></a><span class="lineno"> 351</span>  const_iterator end()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> const_iterator(Data(), size()); }</div> -<div class="line"><a name="l00352"></a><span class="lineno"> 352</span> </div> -<div class="line"><a name="l00353"></a><span class="lineno"> 353</span>  <span class="comment">// Change elements if you have a non-const pointer to this object.</span></div> -<div class="line"><a name="l00354"></a><span class="lineno"> 354</span>  <span class="comment">// Scalars only. See reflection.h, and the documentation.</span></div> -<div class="line"><a name="l00355"></a><span class="lineno"> 355</span>  <span class="keywordtype">void</span> Mutate(uoffset_t i, <span class="keyword">const</span> T& val) {</div> -<div class="line"><a name="l00356"></a><span class="lineno"> 356</span>  assert(i < size());</div> -<div class="line"><a name="l00357"></a><span class="lineno"> 357</span>  WriteScalar(data() + i, val);</div> -<div class="line"><a name="l00358"></a><span class="lineno"> 358</span>  }</div> -<div class="line"><a name="l00359"></a><span class="lineno"> 359</span> </div> -<div class="line"><a name="l00360"></a><span class="lineno"> 360</span>  <span class="comment">// Change an element of a vector of tables (or strings).</span></div> -<div class="line"><a name="l00361"></a><span class="lineno"> 361</span>  <span class="comment">// "val" points to the new table/string, as you can obtain from</span></div> -<div class="line"><a name="l00362"></a><span class="lineno"> 362</span>  <span class="comment">// e.g. reflection::AddFlatBuffer().</span></div> -<div class="line"><a name="l00363"></a><span class="lineno"> 363</span>  <span class="keywordtype">void</span> MutateOffset(uoffset_t i, <span class="keyword">const</span> uint8_t *val) {</div> -<div class="line"><a name="l00364"></a><span class="lineno"> 364</span>  assert(i < size());</div> -<div class="line"><a name="l00365"></a><span class="lineno"> 365</span>  assert(<span class="keyword">sizeof</span>(T) == <span class="keyword">sizeof</span>(uoffset_t));</div> -<div class="line"><a name="l00366"></a><span class="lineno"> 366</span>  WriteScalar(data() + i,</div> -<div class="line"><a name="l00367"></a><span class="lineno"> 367</span>  static_cast<uoffset_t>(val - (Data() + i * <span class="keyword">sizeof</span>(uoffset_t))));</div> -<div class="line"><a name="l00368"></a><span class="lineno"> 368</span>  }</div> -<div class="line"><a name="l00369"></a><span class="lineno"> 369</span> </div> -<div class="line"><a name="l00370"></a><span class="lineno"> 370</span>  <span class="comment">// Get a mutable pointer to tables/strings inside this vector.</span></div> -<div class="line"><a name="l00371"></a><span class="lineno"> 371</span>  mutable_return_type GetMutableObject(uoffset_t i)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l00372"></a><span class="lineno"> 372</span>  assert(i < size());</div> -<div class="line"><a name="l00373"></a><span class="lineno"> 373</span>  <span class="keywordflow">return</span> <span class="keyword">const_cast<</span>mutable_return_type<span class="keyword">></span>(IndirectHelper<T>::Read(Data(), i));</div> +<div class="line"><a name="l00350"></a><span class="lineno"> 350</span>  uoffset_t size()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> EndianScalar(length_); }</div> +<div class="line"><a name="l00351"></a><span class="lineno"> 351</span> </div> +<div class="line"><a name="l00352"></a><span class="lineno"> 352</span>  <span class="comment">// Deprecated: use size(). Here for backwards compatibility.</span></div> +<div class="line"><a name="l00353"></a><span class="lineno"> 353</span>  uoffset_t Length()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> size(); }</div> +<div class="line"><a name="l00354"></a><span class="lineno"> 354</span> </div> +<div class="line"><a name="l00355"></a><span class="lineno"> 355</span>  <span class="keyword">typedef</span> <span class="keyword">typename</span> IndirectHelper<T>::return_type return_type;</div> +<div class="line"><a name="l00356"></a><span class="lineno"> 356</span>  <span class="keyword">typedef</span> <span class="keyword">typename</span> IndirectHelper<T>::mutable_return_type mutable_return_type;</div> +<div class="line"><a name="l00357"></a><span class="lineno"> 357</span> </div> +<div class="line"><a name="l00358"></a><span class="lineno"> 358</span>  return_type Get(uoffset_t i)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l00359"></a><span class="lineno"> 359</span>  assert(i < size());</div> +<div class="line"><a name="l00360"></a><span class="lineno"> 360</span>  <span class="keywordflow">return</span> IndirectHelper<T>::Read(Data(), i);</div> +<div class="line"><a name="l00361"></a><span class="lineno"> 361</span>  }</div> +<div class="line"><a name="l00362"></a><span class="lineno"> 362</span> </div> +<div class="line"><a name="l00363"></a><span class="lineno"> 363</span>  return_type operator[](uoffset_t i)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> Get(i); }</div> +<div class="line"><a name="l00364"></a><span class="lineno"> 364</span> </div> +<div class="line"><a name="l00365"></a><span class="lineno"> 365</span>  <span class="comment">// If this is a Vector of enums, T will be its storage type, not the enum</span></div> +<div class="line"><a name="l00366"></a><span class="lineno"> 366</span>  <span class="comment">// type. This function makes it convenient to retrieve value with enum</span></div> +<div class="line"><a name="l00367"></a><span class="lineno"> 367</span>  <span class="comment">// type E.</span></div> +<div class="line"><a name="l00368"></a><span class="lineno"> 368</span>  <span class="keyword">template</span><<span class="keyword">typename</span> E> E GetEnum(uoffset_t i)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l00369"></a><span class="lineno"> 369</span>  <span class="keywordflow">return</span> <span class="keyword">static_cast<</span>E<span class="keyword">></span>(Get(i));</div> +<div class="line"><a name="l00370"></a><span class="lineno"> 370</span>  }</div> +<div class="line"><a name="l00371"></a><span class="lineno"> 371</span> </div> +<div class="line"><a name="l00372"></a><span class="lineno"> 372</span>  <span class="keyword">const</span> <span class="keywordtype">void</span> *GetStructFromOffset(<span class="keywordtype">size_t</span> o)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l00373"></a><span class="lineno"> 373</span>  <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span><span class="keywordtype">void</span> *<span class="keyword">></span>(Data() + o);</div> <div class="line"><a name="l00374"></a><span class="lineno"> 374</span>  }</div> <div class="line"><a name="l00375"></a><span class="lineno"> 375</span> </div> -<div class="line"><a name="l00376"></a><span class="lineno"> 376</span>  <span class="comment">// The raw data in little endian format. Use with care.</span></div> -<div class="line"><a name="l00377"></a><span class="lineno"> 377</span>  <span class="keyword">const</span> uint8_t *Data()<span class="keyword"> const </span>{</div> -<div class="line"><a name="l00378"></a><span class="lineno"> 378</span>  <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>uint8_t *<span class="keyword">></span>(&length_ + 1);</div> -<div class="line"><a name="l00379"></a><span class="lineno"> 379</span>  }</div> -<div class="line"><a name="l00380"></a><span class="lineno"> 380</span> </div> -<div class="line"><a name="l00381"></a><span class="lineno"> 381</span>  uint8_t *Data() {</div> -<div class="line"><a name="l00382"></a><span class="lineno"> 382</span>  <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span>uint8_t *<span class="keyword">></span>(&length_ + 1);</div> -<div class="line"><a name="l00383"></a><span class="lineno"> 383</span>  }</div> -<div class="line"><a name="l00384"></a><span class="lineno"> 384</span> </div> -<div class="line"><a name="l00385"></a><span class="lineno"> 385</span>  <span class="comment">// Similarly, but typed, much like std::vector::data</span></div> -<div class="line"><a name="l00386"></a><span class="lineno"> 386</span>  <span class="keyword">const</span> T *data()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>T *<span class="keyword">></span>(Data()); }</div> -<div class="line"><a name="l00387"></a><span class="lineno"> 387</span>  T *data() { <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span>T *<span class="keyword">></span>(Data()); }</div> +<div class="line"><a name="l00376"></a><span class="lineno"> 376</span>  iterator begin() { <span class="keywordflow">return</span> iterator(Data(), 0); }</div> +<div class="line"><a name="l00377"></a><span class="lineno"> 377</span>  const_iterator begin()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> const_iterator(Data(), 0); }</div> +<div class="line"><a name="l00378"></a><span class="lineno"> 378</span> </div> +<div class="line"><a name="l00379"></a><span class="lineno"> 379</span>  iterator end() { <span class="keywordflow">return</span> iterator(Data(), size()); }</div> +<div class="line"><a name="l00380"></a><span class="lineno"> 380</span>  const_iterator end()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> const_iterator(Data(), size()); }</div> +<div class="line"><a name="l00381"></a><span class="lineno"> 381</span> </div> +<div class="line"><a name="l00382"></a><span class="lineno"> 382</span>  <span class="comment">// Change elements if you have a non-const pointer to this object.</span></div> +<div class="line"><a name="l00383"></a><span class="lineno"> 383</span>  <span class="comment">// Scalars only. See reflection.h, and the documentation.</span></div> +<div class="line"><a name="l00384"></a><span class="lineno"> 384</span>  <span class="keywordtype">void</span> Mutate(uoffset_t i, <span class="keyword">const</span> T& val) {</div> +<div class="line"><a name="l00385"></a><span class="lineno"> 385</span>  assert(i < size());</div> +<div class="line"><a name="l00386"></a><span class="lineno"> 386</span>  WriteScalar(data() + i, val);</div> +<div class="line"><a name="l00387"></a><span class="lineno"> 387</span>  }</div> <div class="line"><a name="l00388"></a><span class="lineno"> 388</span> </div> -<div class="line"><a name="l00389"></a><span class="lineno"> 389</span>  <span class="keyword">template</span><<span class="keyword">typename</span> K> return_type LookupByKey(K key)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l00390"></a><span class="lineno"> 390</span>  <span class="keywordtype">void</span> *search_result = std::bsearch(&key, Data(), size(),</div> -<div class="line"><a name="l00391"></a><span class="lineno"> 391</span>  IndirectHelper<T>::element_stride, KeyCompare<K>);</div> -<div class="line"><a name="l00392"></a><span class="lineno"> 392</span> </div> -<div class="line"><a name="l00393"></a><span class="lineno"> 393</span>  <span class="keywordflow">if</span> (!search_result) {</div> -<div class="line"><a name="l00394"></a><span class="lineno"> 394</span>  <span class="keywordflow">return</span> <span class="keyword">nullptr</span>; <span class="comment">// Key not found.</span></div> -<div class="line"><a name="l00395"></a><span class="lineno"> 395</span>  }</div> -<div class="line"><a name="l00396"></a><span class="lineno"> 396</span> </div> -<div class="line"><a name="l00397"></a><span class="lineno"> 397</span>  <span class="keyword">const</span> uint8_t *element = <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>uint8_t *<span class="keyword">></span>(search_result);</div> +<div class="line"><a name="l00389"></a><span class="lineno"> 389</span>  <span class="comment">// Change an element of a vector of tables (or strings).</span></div> +<div class="line"><a name="l00390"></a><span class="lineno"> 390</span>  <span class="comment">// "val" points to the new table/string, as you can obtain from</span></div> +<div class="line"><a name="l00391"></a><span class="lineno"> 391</span>  <span class="comment">// e.g. reflection::AddFlatBuffer().</span></div> +<div class="line"><a name="l00392"></a><span class="lineno"> 392</span>  <span class="keywordtype">void</span> MutateOffset(uoffset_t i, <span class="keyword">const</span> uint8_t *val) {</div> +<div class="line"><a name="l00393"></a><span class="lineno"> 393</span>  assert(i < size());</div> +<div class="line"><a name="l00394"></a><span class="lineno"> 394</span>  assert(<span class="keyword">sizeof</span>(T) == <span class="keyword">sizeof</span>(uoffset_t));</div> +<div class="line"><a name="l00395"></a><span class="lineno"> 395</span>  WriteScalar(data() + i,</div> +<div class="line"><a name="l00396"></a><span class="lineno"> 396</span>  static_cast<uoffset_t>(val - (Data() + i * <span class="keyword">sizeof</span>(uoffset_t))));</div> +<div class="line"><a name="l00397"></a><span class="lineno"> 397</span>  }</div> <div class="line"><a name="l00398"></a><span class="lineno"> 398</span> </div> -<div class="line"><a name="l00399"></a><span class="lineno"> 399</span>  <span class="keywordflow">return</span> IndirectHelper<T>::Read(element, 0);</div> -<div class="line"><a name="l00400"></a><span class="lineno"> 400</span>  }</div> -<div class="line"><a name="l00401"></a><span class="lineno"> 401</span> </div> -<div class="line"><a name="l00402"></a><span class="lineno"> 402</span> <span class="keyword">protected</span>:</div> -<div class="line"><a name="l00403"></a><span class="lineno"> 403</span>  <span class="comment">// This class is only used to access pre-existing data. Don't ever</span></div> -<div class="line"><a name="l00404"></a><span class="lineno"> 404</span>  <span class="comment">// try to construct these manually.</span></div> -<div class="line"><a name="l00405"></a><span class="lineno"> 405</span>  Vector();</div> -<div class="line"><a name="l00406"></a><span class="lineno"> 406</span> </div> -<div class="line"><a name="l00407"></a><span class="lineno"> 407</span>  uoffset_t length_;</div> -<div class="line"><a name="l00408"></a><span class="lineno"> 408</span> </div> -<div class="line"><a name="l00409"></a><span class="lineno"> 409</span> <span class="keyword">private</span>:</div> -<div class="line"><a name="l00410"></a><span class="lineno"> 410</span>  <span class="keyword">template</span><<span class="keyword">typename</span> K> <span class="keyword">static</span> <span class="keywordtype">int</span> KeyCompare(<span class="keyword">const</span> <span class="keywordtype">void</span> *ap, <span class="keyword">const</span> <span class="keywordtype">void</span> *bp) {</div> -<div class="line"><a name="l00411"></a><span class="lineno"> 411</span>  <span class="keyword">const</span> K *key = <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>K *<span class="keyword">></span>(ap);</div> -<div class="line"><a name="l00412"></a><span class="lineno"> 412</span>  <span class="keyword">const</span> uint8_t *data = <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>uint8_t *<span class="keyword">></span>(bp);</div> -<div class="line"><a name="l00413"></a><span class="lineno"> 413</span>  <span class="keyword">auto</span> table = IndirectHelper<T>::Read(data, 0);</div> -<div class="line"><a name="l00414"></a><span class="lineno"> 414</span> </div> -<div class="line"><a name="l00415"></a><span class="lineno"> 415</span>  <span class="comment">// std::bsearch compares with the operands transposed, so we negate the</span></div> -<div class="line"><a name="l00416"></a><span class="lineno"> 416</span>  <span class="comment">// result here.</span></div> -<div class="line"><a name="l00417"></a><span class="lineno"> 417</span>  <span class="keywordflow">return</span> -table->KeyCompareWithValue(*key);</div> -<div class="line"><a name="l00418"></a><span class="lineno"> 418</span>  }</div> -<div class="line"><a name="l00419"></a><span class="lineno"> 419</span> };</div> -<div class="line"><a name="l00420"></a><span class="lineno"> 420</span> </div> -<div class="line"><a name="l00421"></a><span class="lineno"> 421</span> <span class="comment">// Represent a vector much like the template above, but in this case we</span></div> -<div class="line"><a name="l00422"></a><span class="lineno"> 422</span> <span class="comment">// don't know what the element types are (used with reflection.h).</span></div> -<div class="line"><a name="l00423"></a><span class="lineno"> 423</span> <span class="keyword">class </span>VectorOfAny {</div> -<div class="line"><a name="l00424"></a><span class="lineno"> 424</span> <span class="keyword">public</span>:</div> -<div class="line"><a name="l00425"></a><span class="lineno"> 425</span>  uoffset_t size()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> EndianScalar(length_); }</div> -<div class="line"><a name="l00426"></a><span class="lineno"> 426</span> </div> -<div class="line"><a name="l00427"></a><span class="lineno"> 427</span>  <span class="keyword">const</span> uint8_t *Data()<span class="keyword"> const </span>{</div> -<div class="line"><a name="l00428"></a><span class="lineno"> 428</span>  <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>uint8_t *<span class="keyword">></span>(&length_ + 1);</div> +<div class="line"><a name="l00399"></a><span class="lineno"> 399</span>  <span class="comment">// Get a mutable pointer to tables/strings inside this vector.</span></div> +<div class="line"><a name="l00400"></a><span class="lineno"> 400</span>  mutable_return_type GetMutableObject(uoffset_t i)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l00401"></a><span class="lineno"> 401</span>  assert(i < size());</div> +<div class="line"><a name="l00402"></a><span class="lineno"> 402</span>  <span class="keywordflow">return</span> <span class="keyword">const_cast<</span>mutable_return_type<span class="keyword">></span>(IndirectHelper<T>::Read(Data(), i));</div> +<div class="line"><a name="l00403"></a><span class="lineno"> 403</span>  }</div> +<div class="line"><a name="l00404"></a><span class="lineno"> 404</span> </div> +<div class="line"><a name="l00405"></a><span class="lineno"> 405</span>  <span class="comment">// The raw data in little endian format. Use with care.</span></div> +<div class="line"><a name="l00406"></a><span class="lineno"> 406</span>  <span class="keyword">const</span> uint8_t *Data()<span class="keyword"> const </span>{</div> +<div class="line"><a name="l00407"></a><span class="lineno"> 407</span>  <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>uint8_t *<span class="keyword">></span>(&length_ + 1);</div> +<div class="line"><a name="l00408"></a><span class="lineno"> 408</span>  }</div> +<div class="line"><a name="l00409"></a><span class="lineno"> 409</span> </div> +<div class="line"><a name="l00410"></a><span class="lineno"> 410</span>  uint8_t *Data() {</div> +<div class="line"><a name="l00411"></a><span class="lineno"> 411</span>  <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span>uint8_t *<span class="keyword">></span>(&length_ + 1);</div> +<div class="line"><a name="l00412"></a><span class="lineno"> 412</span>  }</div> +<div class="line"><a name="l00413"></a><span class="lineno"> 413</span> </div> +<div class="line"><a name="l00414"></a><span class="lineno"> 414</span>  <span class="comment">// Similarly, but typed, much like std::vector::data</span></div> +<div class="line"><a name="l00415"></a><span class="lineno"> 415</span>  <span class="keyword">const</span> T *data()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>T *<span class="keyword">></span>(Data()); }</div> +<div class="line"><a name="l00416"></a><span class="lineno"> 416</span>  T *data() { <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span>T *<span class="keyword">></span>(Data()); }</div> +<div class="line"><a name="l00417"></a><span class="lineno"> 417</span> </div> +<div class="line"><a name="l00418"></a><span class="lineno"> 418</span>  <span class="keyword">template</span><<span class="keyword">typename</span> K> return_type LookupByKey(K key)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l00419"></a><span class="lineno"> 419</span>  <span class="keywordtype">void</span> *search_result = std::bsearch(&key, Data(), size(),</div> +<div class="line"><a name="l00420"></a><span class="lineno"> 420</span>  IndirectHelper<T>::element_stride, KeyCompare<K>);</div> +<div class="line"><a name="l00421"></a><span class="lineno"> 421</span> </div> +<div class="line"><a name="l00422"></a><span class="lineno"> 422</span>  <span class="keywordflow">if</span> (!search_result) {</div> +<div class="line"><a name="l00423"></a><span class="lineno"> 423</span>  <span class="keywordflow">return</span> <span class="keyword">nullptr</span>; <span class="comment">// Key not found.</span></div> +<div class="line"><a name="l00424"></a><span class="lineno"> 424</span>  }</div> +<div class="line"><a name="l00425"></a><span class="lineno"> 425</span> </div> +<div class="line"><a name="l00426"></a><span class="lineno"> 426</span>  <span class="keyword">const</span> uint8_t *element = <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>uint8_t *<span class="keyword">></span>(search_result);</div> +<div class="line"><a name="l00427"></a><span class="lineno"> 427</span> </div> +<div class="line"><a name="l00428"></a><span class="lineno"> 428</span>  <span class="keywordflow">return</span> IndirectHelper<T>::Read(element, 0);</div> <div class="line"><a name="l00429"></a><span class="lineno"> 429</span>  }</div> -<div class="line"><a name="l00430"></a><span class="lineno"> 430</span>  uint8_t *Data() {</div> -<div class="line"><a name="l00431"></a><span class="lineno"> 431</span>  <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span>uint8_t *<span class="keyword">></span>(&length_ + 1);</div> -<div class="line"><a name="l00432"></a><span class="lineno"> 432</span>  }</div> -<div class="line"><a name="l00433"></a><span class="lineno"> 433</span> <span class="keyword">protected</span>:</div> -<div class="line"><a name="l00434"></a><span class="lineno"> 434</span>  VectorOfAny();</div> +<div class="line"><a name="l00430"></a><span class="lineno"> 430</span> </div> +<div class="line"><a name="l00431"></a><span class="lineno"> 431</span> <span class="keyword">protected</span>:</div> +<div class="line"><a name="l00432"></a><span class="lineno"> 432</span>  <span class="comment">// This class is only used to access pre-existing data. Don't ever</span></div> +<div class="line"><a name="l00433"></a><span class="lineno"> 433</span>  <span class="comment">// try to construct these manually.</span></div> +<div class="line"><a name="l00434"></a><span class="lineno"> 434</span>  Vector();</div> <div class="line"><a name="l00435"></a><span class="lineno"> 435</span> </div> <div class="line"><a name="l00436"></a><span class="lineno"> 436</span>  uoffset_t length_;</div> -<div class="line"><a name="l00437"></a><span class="lineno"> 437</span> };</div> -<div class="line"><a name="l00438"></a><span class="lineno"> 438</span> </div> -<div class="line"><a name="l00439"></a><span class="lineno"> 439</span> <span class="comment">// Convenient helper function to get the length of any vector, regardless</span></div> -<div class="line"><a name="l00440"></a><span class="lineno"> 440</span> <span class="comment">// of wether it is null or not (the field is not set).</span></div> -<div class="line"><a name="l00441"></a><span class="lineno"> 441</span> <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keyword">static</span> <span class="keyword">inline</span> <span class="keywordtype">size_t</span> VectorLength(<span class="keyword">const</span> Vector<T> *v) {</div> -<div class="line"><a name="l00442"></a><span class="lineno"> 442</span>  <span class="keywordflow">return</span> v ? v->Length() : 0;</div> -<div class="line"><a name="l00443"></a><span class="lineno"> 443</span> }</div> -<div class="line"><a name="l00444"></a><span class="lineno"> 444</span> </div> -<div class="line"><a name="l00445"></a><span class="lineno"> 445</span> <span class="keyword">struct </span>String : <span class="keyword">public</span> Vector<char> {</div> -<div class="line"><a name="l00446"></a><span class="lineno"> 446</span>  <span class="keyword">const</span> <span class="keywordtype">char</span> *c_str()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span><span class="keywordtype">char</span> *<span class="keyword">></span>(Data()); }</div> -<div class="line"><a name="l00447"></a><span class="lineno"> 447</span>  std::string str()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> std::string(c_str(), Length()); }</div> -<div class="line"><a name="l00448"></a><span class="lineno"> 448</span> </div> -<div class="line"><a name="l00449"></a><span class="lineno"> 449</span>  <span class="keywordtype">bool</span> operator <(<span class="keyword">const</span> String &o)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l00450"></a><span class="lineno"> 450</span>  <span class="keywordflow">return</span> strcmp(c_str(), o.c_str()) < 0;</div> -<div class="line"><a name="l00451"></a><span class="lineno"> 451</span>  }</div> -<div class="line"><a name="l00452"></a><span class="lineno"> 452</span> };</div> -<div class="line"><a name="l00453"></a><span class="lineno"> 453</span> </div> -<div class="line"><a name="l00454"></a><span class="lineno"> 454</span> <span class="comment">// Simple indirection for buffer allocation, to allow this to be overridden</span></div> -<div class="line"><a name="l00455"></a><span class="lineno"> 455</span> <span class="comment">// with custom allocation (see the FlatBufferBuilder constructor).</span></div> -<div class="line"><a name="l00456"></a><span class="lineno"> 456</span> <span class="keyword">class </span>simple_allocator {</div> -<div class="line"><a name="l00457"></a><span class="lineno"> 457</span>  <span class="keyword">public</span>:</div> -<div class="line"><a name="l00458"></a><span class="lineno"> 458</span>  <span class="keyword">virtual</span> ~simple_allocator() {}</div> -<div class="line"><a name="l00459"></a><span class="lineno"> 459</span>  <span class="keyword">virtual</span> uint8_t *allocate(<span class="keywordtype">size_t</span> size)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> <span class="keyword">new</span> uint8_t[size]; }</div> -<div class="line"><a name="l00460"></a><span class="lineno"> 460</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> deallocate(uint8_t *p)<span class="keyword"> const </span>{ <span class="keyword">delete</span>[] p; }</div> -<div class="line"><a name="l00461"></a><span class="lineno"> 461</span> };</div> -<div class="line"><a name="l00462"></a><span class="lineno"> 462</span> </div> -<div class="line"><a name="l00463"></a><span class="lineno"> 463</span> <span class="comment">// This is a minimal replication of std::vector<uint8_t> functionality,</span></div> -<div class="line"><a name="l00464"></a><span class="lineno"> 464</span> <span class="comment">// except growing from higher to lower addresses. i.e push_back() inserts data</span></div> -<div class="line"><a name="l00465"></a><span class="lineno"> 465</span> <span class="comment">// in the lowest address in the vector.</span></div> -<div class="line"><a name="l00466"></a><span class="lineno"> 466</span> <span class="keyword">class </span>vector_downward {</div> -<div class="line"><a name="l00467"></a><span class="lineno"> 467</span>  <span class="keyword">public</span>:</div> -<div class="line"><a name="l00468"></a><span class="lineno"> 468</span>  <span class="keyword">explicit</span> vector_downward(<span class="keywordtype">size_t</span> initial_size,</div> -<div class="line"><a name="l00469"></a><span class="lineno"> 469</span>  <span class="keyword">const</span> simple_allocator &allocator)</div> -<div class="line"><a name="l00470"></a><span class="lineno"> 470</span>  : reserved_(initial_size),</div> -<div class="line"><a name="l00471"></a><span class="lineno"> 471</span>  buf_(allocator.allocate(reserved_)),</div> -<div class="line"><a name="l00472"></a><span class="lineno"> 472</span>  cur_(buf_ + reserved_),</div> -<div class="line"><a name="l00473"></a><span class="lineno"> 473</span>  allocator_(allocator) {</div> -<div class="line"><a name="l00474"></a><span class="lineno"> 474</span>  assert((initial_size & (<span class="keyword">sizeof</span>(largest_scalar_t) - 1)) == 0);</div> -<div class="line"><a name="l00475"></a><span class="lineno"> 475</span>  }</div> -<div class="line"><a name="l00476"></a><span class="lineno"> 476</span> </div> -<div class="line"><a name="l00477"></a><span class="lineno"> 477</span>  ~vector_downward() {</div> -<div class="line"><a name="l00478"></a><span class="lineno"> 478</span>  <span class="keywordflow">if</span> (buf_)</div> -<div class="line"><a name="l00479"></a><span class="lineno"> 479</span>  allocator_.deallocate(buf_);</div> +<div class="line"><a name="l00437"></a><span class="lineno"> 437</span> </div> +<div class="line"><a name="l00438"></a><span class="lineno"> 438</span> <span class="keyword">private</span>:</div> +<div class="line"><a name="l00439"></a><span class="lineno"> 439</span>  <span class="keyword">template</span><<span class="keyword">typename</span> K> <span class="keyword">static</span> <span class="keywordtype">int</span> KeyCompare(<span class="keyword">const</span> <span class="keywordtype">void</span> *ap, <span class="keyword">const</span> <span class="keywordtype">void</span> *bp) {</div> +<div class="line"><a name="l00440"></a><span class="lineno"> 440</span>  <span class="keyword">const</span> K *key = <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>K *<span class="keyword">></span>(ap);</div> +<div class="line"><a name="l00441"></a><span class="lineno"> 441</span>  <span class="keyword">const</span> uint8_t *data = <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>uint8_t *<span class="keyword">></span>(bp);</div> +<div class="line"><a name="l00442"></a><span class="lineno"> 442</span>  <span class="keyword">auto</span> table = IndirectHelper<T>::Read(data, 0);</div> +<div class="line"><a name="l00443"></a><span class="lineno"> 443</span> </div> +<div class="line"><a name="l00444"></a><span class="lineno"> 444</span>  <span class="comment">// std::bsearch compares with the operands transposed, so we negate the</span></div> +<div class="line"><a name="l00445"></a><span class="lineno"> 445</span>  <span class="comment">// result here.</span></div> +<div class="line"><a name="l00446"></a><span class="lineno"> 446</span>  <span class="keywordflow">return</span> -table->KeyCompareWithValue(*key);</div> +<div class="line"><a name="l00447"></a><span class="lineno"> 447</span>  }</div> +<div class="line"><a name="l00448"></a><span class="lineno"> 448</span> };</div> +<div class="line"><a name="l00449"></a><span class="lineno"> 449</span> </div> +<div class="line"><a name="l00450"></a><span class="lineno"> 450</span> <span class="comment">// Represent a vector much like the template above, but in this case we</span></div> +<div class="line"><a name="l00451"></a><span class="lineno"> 451</span> <span class="comment">// don't know what the element types are (used with reflection.h).</span></div> +<div class="line"><a name="l00452"></a><span class="lineno"> 452</span> <span class="keyword">class </span>VectorOfAny {</div> +<div class="line"><a name="l00453"></a><span class="lineno"> 453</span> <span class="keyword">public</span>:</div> +<div class="line"><a name="l00454"></a><span class="lineno"> 454</span>  uoffset_t size()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> EndianScalar(length_); }</div> +<div class="line"><a name="l00455"></a><span class="lineno"> 455</span> </div> +<div class="line"><a name="l00456"></a><span class="lineno"> 456</span>  <span class="keyword">const</span> uint8_t *Data()<span class="keyword"> const </span>{</div> +<div class="line"><a name="l00457"></a><span class="lineno"> 457</span>  <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>uint8_t *<span class="keyword">></span>(&length_ + 1);</div> +<div class="line"><a name="l00458"></a><span class="lineno"> 458</span>  }</div> +<div class="line"><a name="l00459"></a><span class="lineno"> 459</span>  uint8_t *Data() {</div> +<div class="line"><a name="l00460"></a><span class="lineno"> 460</span>  <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span>uint8_t *<span class="keyword">></span>(&length_ + 1);</div> +<div class="line"><a name="l00461"></a><span class="lineno"> 461</span>  }</div> +<div class="line"><a name="l00462"></a><span class="lineno"> 462</span> <span class="keyword">protected</span>:</div> +<div class="line"><a name="l00463"></a><span class="lineno"> 463</span>  VectorOfAny();</div> +<div class="line"><a name="l00464"></a><span class="lineno"> 464</span> </div> +<div class="line"><a name="l00465"></a><span class="lineno"> 465</span>  uoffset_t length_;</div> +<div class="line"><a name="l00466"></a><span class="lineno"> 466</span> };</div> +<div class="line"><a name="l00467"></a><span class="lineno"> 467</span> </div> +<div class="line"><a name="l00468"></a><span class="lineno"> 468</span> <span class="comment">// Convenient helper function to get the length of any vector, regardless</span></div> +<div class="line"><a name="l00469"></a><span class="lineno"> 469</span> <span class="comment">// of wether it is null or not (the field is not set).</span></div> +<div class="line"><a name="l00470"></a><span class="lineno"> 470</span> <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keyword">static</span> <span class="keyword">inline</span> <span class="keywordtype">size_t</span> VectorLength(<span class="keyword">const</span> Vector<T> *v) {</div> +<div class="line"><a name="l00471"></a><span class="lineno"> 471</span>  <span class="keywordflow">return</span> v ? v->Length() : 0;</div> +<div class="line"><a name="l00472"></a><span class="lineno"> 472</span> }</div> +<div class="line"><a name="l00473"></a><span class="lineno"> 473</span> </div> +<div class="line"><a name="l00474"></a><span class="lineno"> 474</span> <span class="keyword">struct </span>String : <span class="keyword">public</span> Vector<char> {</div> +<div class="line"><a name="l00475"></a><span class="lineno"> 475</span>  <span class="keyword">const</span> <span class="keywordtype">char</span> *c_str()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span><span class="keywordtype">char</span> *<span class="keyword">></span>(Data()); }</div> +<div class="line"><a name="l00476"></a><span class="lineno"> 476</span>  std::string str()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> std::string(c_str(), Length()); }</div> +<div class="line"><a name="l00477"></a><span class="lineno"> 477</span> </div> +<div class="line"><a name="l00478"></a><span class="lineno"> 478</span>  <span class="keywordtype">bool</span> operator <(<span class="keyword">const</span> String &o)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l00479"></a><span class="lineno"> 479</span>  <span class="keywordflow">return</span> strcmp(c_str(), o.c_str()) < 0;</div> <div class="line"><a name="l00480"></a><span class="lineno"> 480</span>  }</div> -<div class="line"><a name="l00481"></a><span class="lineno"> 481</span> </div> -<div class="line"><a name="l00482"></a><span class="lineno"> 482</span>  <span class="keywordtype">void</span> clear() {</div> -<div class="line"><a name="l00483"></a><span class="lineno"> 483</span>  <span class="keywordflow">if</span> (buf_ == <span class="keyword">nullptr</span>)</div> -<div class="line"><a name="l00484"></a><span class="lineno"> 484</span>  buf_ = allocator_.allocate(reserved_);</div> -<div class="line"><a name="l00485"></a><span class="lineno"> 485</span> </div> -<div class="line"><a name="l00486"></a><span class="lineno"> 486</span>  cur_ = buf_ + reserved_;</div> -<div class="line"><a name="l00487"></a><span class="lineno"> 487</span>  }</div> -<div class="line"><a name="l00488"></a><span class="lineno"> 488</span> </div> -<div class="line"><a name="l00489"></a><span class="lineno"> 489</span> <span class="preprocessor"> #ifndef FLATBUFFERS_CPP98_STL</span></div> -<div class="line"><a name="l00490"></a><span class="lineno"> 490</span>  <span class="comment">// Relinquish the pointer to the caller.</span></div> -<div class="line"><a name="l00491"></a><span class="lineno"> 491</span>  unique_ptr_t release() {</div> -<div class="line"><a name="l00492"></a><span class="lineno"> 492</span>  <span class="comment">// Actually deallocate from the start of the allocated memory.</span></div> -<div class="line"><a name="l00493"></a><span class="lineno"> 493</span>  std::function<void(uint8_t *)> deleter(</div> -<div class="line"><a name="l00494"></a><span class="lineno"> 494</span>  std::bind(&simple_allocator::deallocate, allocator_, buf_));</div> -<div class="line"><a name="l00495"></a><span class="lineno"> 495</span> </div> -<div class="line"><a name="l00496"></a><span class="lineno"> 496</span>  <span class="comment">// Point to the desired offset.</span></div> -<div class="line"><a name="l00497"></a><span class="lineno"> 497</span>  unique_ptr_t retval(data(), deleter);</div> -<div class="line"><a name="l00498"></a><span class="lineno"> 498</span> </div> -<div class="line"><a name="l00499"></a><span class="lineno"> 499</span>  <span class="comment">// Don't deallocate when this instance is destroyed.</span></div> -<div class="line"><a name="l00500"></a><span class="lineno"> 500</span>  buf_ = <span class="keyword">nullptr</span>;</div> -<div class="line"><a name="l00501"></a><span class="lineno"> 501</span>  cur_ = <span class="keyword">nullptr</span>;</div> -<div class="line"><a name="l00502"></a><span class="lineno"> 502</span> </div> -<div class="line"><a name="l00503"></a><span class="lineno"> 503</span>  <span class="keywordflow">return</span> retval;</div> +<div class="line"><a name="l00481"></a><span class="lineno"> 481</span> };</div> +<div class="line"><a name="l00482"></a><span class="lineno"> 482</span> </div> +<div class="line"><a name="l00483"></a><span class="lineno"> 483</span> <span class="comment">// Simple indirection for buffer allocation, to allow this to be overridden</span></div> +<div class="line"><a name="l00484"></a><span class="lineno"> 484</span> <span class="comment">// with custom allocation (see the FlatBufferBuilder constructor).</span></div> +<div class="line"><a name="l00485"></a><span class="lineno"> 485</span> <span class="keyword">class </span>simple_allocator {</div> +<div class="line"><a name="l00486"></a><span class="lineno"> 486</span>  <span class="keyword">public</span>:</div> +<div class="line"><a name="l00487"></a><span class="lineno"> 487</span>  <span class="keyword">virtual</span> ~simple_allocator() {}</div> +<div class="line"><a name="l00488"></a><span class="lineno"> 488</span>  <span class="keyword">virtual</span> uint8_t *allocate(<span class="keywordtype">size_t</span> size)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> <span class="keyword">new</span> uint8_t[size]; }</div> +<div class="line"><a name="l00489"></a><span class="lineno"> 489</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> deallocate(uint8_t *p)<span class="keyword"> const </span>{ <span class="keyword">delete</span>[] p; }</div> +<div class="line"><a name="l00490"></a><span class="lineno"> 490</span> };</div> +<div class="line"><a name="l00491"></a><span class="lineno"> 491</span> </div> +<div class="line"><a name="l00492"></a><span class="lineno"> 492</span> <span class="comment">// This is a minimal replication of std::vector<uint8_t> functionality,</span></div> +<div class="line"><a name="l00493"></a><span class="lineno"> 493</span> <span class="comment">// except growing from higher to lower addresses. i.e push_back() inserts data</span></div> +<div class="line"><a name="l00494"></a><span class="lineno"> 494</span> <span class="comment">// in the lowest address in the vector.</span></div> +<div class="line"><a name="l00495"></a><span class="lineno"> 495</span> <span class="keyword">class </span>vector_downward {</div> +<div class="line"><a name="l00496"></a><span class="lineno"> 496</span>  <span class="keyword">public</span>:</div> +<div class="line"><a name="l00497"></a><span class="lineno"> 497</span>  <span class="keyword">explicit</span> vector_downward(<span class="keywordtype">size_t</span> initial_size,</div> +<div class="line"><a name="l00498"></a><span class="lineno"> 498</span>  <span class="keyword">const</span> simple_allocator &allocator)</div> +<div class="line"><a name="l00499"></a><span class="lineno"> 499</span>  : reserved_(initial_size),</div> +<div class="line"><a name="l00500"></a><span class="lineno"> 500</span>  buf_(allocator.allocate(reserved_)),</div> +<div class="line"><a name="l00501"></a><span class="lineno"> 501</span>  cur_(buf_ + reserved_),</div> +<div class="line"><a name="l00502"></a><span class="lineno"> 502</span>  allocator_(allocator) {</div> +<div class="line"><a name="l00503"></a><span class="lineno"> 503</span>  assert((initial_size & (<span class="keyword">sizeof</span>(largest_scalar_t) - 1)) == 0);</div> <div class="line"><a name="l00504"></a><span class="lineno"> 504</span>  }</div> -<div class="line"><a name="l00505"></a><span class="lineno"> 505</span> <span class="preprocessor"> #endif</span></div> -<div class="line"><a name="l00506"></a><span class="lineno"> 506</span> </div> -<div class="line"><a name="l00507"></a><span class="lineno"> 507</span>  <span class="keywordtype">size_t</span> growth_policy(<span class="keywordtype">size_t</span> bytes) {</div> -<div class="line"><a name="l00508"></a><span class="lineno"> 508</span>  <span class="keywordflow">return</span> (bytes / 2) & ~(<span class="keyword">sizeof</span>(largest_scalar_t) - 1);</div> +<div class="line"><a name="l00505"></a><span class="lineno"> 505</span> </div> +<div class="line"><a name="l00506"></a><span class="lineno"> 506</span>  ~vector_downward() {</div> +<div class="line"><a name="l00507"></a><span class="lineno"> 507</span>  <span class="keywordflow">if</span> (buf_)</div> +<div class="line"><a name="l00508"></a><span class="lineno"> 508</span>  allocator_.deallocate(buf_);</div> <div class="line"><a name="l00509"></a><span class="lineno"> 509</span>  }</div> <div class="line"><a name="l00510"></a><span class="lineno"> 510</span> </div> -<div class="line"><a name="l00511"></a><span class="lineno"> 511</span>  uint8_t *make_space(<span class="keywordtype">size_t</span> len) {</div> -<div class="line"><a name="l00512"></a><span class="lineno"> 512</span>  <span class="keywordflow">if</span> (len > static_cast<size_t>(cur_ - buf_)) {</div> -<div class="line"><a name="l00513"></a><span class="lineno"> 513</span>  <span class="keyword">auto</span> old_size = size();</div> -<div class="line"><a name="l00514"></a><span class="lineno"> 514</span>  <span class="keyword">auto</span> largest_align = AlignOf<largest_scalar_t>();</div> -<div class="line"><a name="l00515"></a><span class="lineno"> 515</span>  reserved_ += (std::max)(len, growth_policy(reserved_));</div> -<div class="line"><a name="l00516"></a><span class="lineno"> 516</span>  <span class="comment">// Round up to avoid undefined behavior from unaligned loads and stores.</span></div> -<div class="line"><a name="l00517"></a><span class="lineno"> 517</span>  reserved_ = (reserved_ + (largest_align - 1)) & ~(largest_align - 1);</div> -<div class="line"><a name="l00518"></a><span class="lineno"> 518</span>  <span class="keyword">auto</span> new_buf = allocator_.allocate(reserved_);</div> -<div class="line"><a name="l00519"></a><span class="lineno"> 519</span>  <span class="keyword">auto</span> new_cur = new_buf + reserved_ - old_size;</div> -<div class="line"><a name="l00520"></a><span class="lineno"> 520</span>  memcpy(new_cur, cur_, old_size);</div> -<div class="line"><a name="l00521"></a><span class="lineno"> 521</span>  cur_ = new_cur;</div> -<div class="line"><a name="l00522"></a><span class="lineno"> 522</span>  allocator_.deallocate(buf_);</div> -<div class="line"><a name="l00523"></a><span class="lineno"> 523</span>  buf_ = new_buf;</div> -<div class="line"><a name="l00524"></a><span class="lineno"> 524</span>  }</div> -<div class="line"><a name="l00525"></a><span class="lineno"> 525</span>  cur_ -= len;</div> -<div class="line"><a name="l00526"></a><span class="lineno"> 526</span>  <span class="comment">// Beyond this, signed offsets may not have enough range:</span></div> -<div class="line"><a name="l00527"></a><span class="lineno"> 527</span>  <span class="comment">// (FlatBuffers > 2GB not supported).</span></div> -<div class="line"><a name="l00528"></a><span class="lineno"> 528</span>  assert(size() < FLATBUFFERS_MAX_BUFFER_SIZE);</div> -<div class="line"><a name="l00529"></a><span class="lineno"> 529</span>  <span class="keywordflow">return</span> cur_;</div> -<div class="line"><a name="l00530"></a><span class="lineno"> 530</span>  }</div> +<div class="line"><a name="l00511"></a><span class="lineno"> 511</span>  <span class="keywordtype">void</span> clear() {</div> +<div class="line"><a name="l00512"></a><span class="lineno"> 512</span>  <span class="keywordflow">if</span> (buf_ == <span class="keyword">nullptr</span>)</div> +<div class="line"><a name="l00513"></a><span class="lineno"> 513</span>  buf_ = allocator_.allocate(reserved_);</div> +<div class="line"><a name="l00514"></a><span class="lineno"> 514</span> </div> +<div class="line"><a name="l00515"></a><span class="lineno"> 515</span>  cur_ = buf_ + reserved_;</div> +<div class="line"><a name="l00516"></a><span class="lineno"> 516</span>  }</div> +<div class="line"><a name="l00517"></a><span class="lineno"> 517</span> </div> +<div class="line"><a name="l00518"></a><span class="lineno"> 518</span> <span class="preprocessor"> #ifndef FLATBUFFERS_CPP98_STL</span></div> +<div class="line"><a name="l00519"></a><span class="lineno"> 519</span>  <span class="comment">// Relinquish the pointer to the caller.</span></div> +<div class="line"><a name="l00520"></a><span class="lineno"> 520</span>  unique_ptr_t release() {</div> +<div class="line"><a name="l00521"></a><span class="lineno"> 521</span>  <span class="comment">// Actually deallocate from the start of the allocated memory.</span></div> +<div class="line"><a name="l00522"></a><span class="lineno"> 522</span>  std::function<void(uint8_t *)> deleter(</div> +<div class="line"><a name="l00523"></a><span class="lineno"> 523</span>  std::bind(&simple_allocator::deallocate, allocator_, buf_));</div> +<div class="line"><a name="l00524"></a><span class="lineno"> 524</span> </div> +<div class="line"><a name="l00525"></a><span class="lineno"> 525</span>  <span class="comment">// Point to the desired offset.</span></div> +<div class="line"><a name="l00526"></a><span class="lineno"> 526</span>  unique_ptr_t retval(data(), deleter);</div> +<div class="line"><a name="l00527"></a><span class="lineno"> 527</span> </div> +<div class="line"><a name="l00528"></a><span class="lineno"> 528</span>  <span class="comment">// Don't deallocate when this instance is destroyed.</span></div> +<div class="line"><a name="l00529"></a><span class="lineno"> 529</span>  buf_ = <span class="keyword">nullptr</span>;</div> +<div class="line"><a name="l00530"></a><span class="lineno"> 530</span>  cur_ = <span class="keyword">nullptr</span>;</div> <div class="line"><a name="l00531"></a><span class="lineno"> 531</span> </div> -<div class="line"><a name="l00532"></a><span class="lineno"> 532</span>  uoffset_t size()<span class="keyword"> const </span>{</div> -<div class="line"><a name="l00533"></a><span class="lineno"> 533</span>  assert(cur_ != <span class="keyword">nullptr</span> && buf_ != <span class="keyword">nullptr</span>);</div> -<div class="line"><a name="l00534"></a><span class="lineno"> 534</span>  <span class="keywordflow">return</span> <span class="keyword">static_cast<</span>uoffset_t<span class="keyword">></span>(reserved_ - (cur_ - buf_));</div> -<div class="line"><a name="l00535"></a><span class="lineno"> 535</span>  }</div> -<div class="line"><a name="l00536"></a><span class="lineno"> 536</span> </div> -<div class="line"><a name="l00537"></a><span class="lineno"> 537</span>  uint8_t *data()<span class="keyword"> const </span>{</div> -<div class="line"><a name="l00538"></a><span class="lineno"> 538</span>  assert(cur_ != <span class="keyword">nullptr</span>);</div> -<div class="line"><a name="l00539"></a><span class="lineno"> 539</span>  <span class="keywordflow">return</span> cur_;</div> -<div class="line"><a name="l00540"></a><span class="lineno"> 540</span>  }</div> -<div class="line"><a name="l00541"></a><span class="lineno"> 541</span> </div> -<div class="line"><a name="l00542"></a><span class="lineno"> 542</span>  uint8_t *data_at(<span class="keywordtype">size_t</span> offset)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> buf_ + reserved_ - offset; }</div> -<div class="line"><a name="l00543"></a><span class="lineno"> 543</span> </div> -<div class="line"><a name="l00544"></a><span class="lineno"> 544</span>  <span class="comment">// push() & fill() are most frequently called with small byte counts (<= 4),</span></div> -<div class="line"><a name="l00545"></a><span class="lineno"> 545</span>  <span class="comment">// which is why we're using loops rather than calling memcpy/memset.</span></div> -<div class="line"><a name="l00546"></a><span class="lineno"> 546</span>  <span class="keywordtype">void</span> push(<span class="keyword">const</span> uint8_t *bytes, <span class="keywordtype">size_t</span> num) {</div> -<div class="line"><a name="l00547"></a><span class="lineno"> 547</span>  <span class="keyword">auto</span> dest = make_space(num);</div> -<div class="line"><a name="l00548"></a><span class="lineno"> 548</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i = 0; i < num; i++) dest[i] = bytes[i];</div> -<div class="line"><a name="l00549"></a><span class="lineno"> 549</span>  }</div> -<div class="line"><a name="l00550"></a><span class="lineno"> 550</span> </div> -<div class="line"><a name="l00551"></a><span class="lineno"> 551</span>  <span class="keywordtype">void</span> fill(<span class="keywordtype">size_t</span> zero_pad_bytes) {</div> -<div class="line"><a name="l00552"></a><span class="lineno"> 552</span>  <span class="keyword">auto</span> dest = make_space(zero_pad_bytes);</div> -<div class="line"><a name="l00553"></a><span class="lineno"> 553</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i = 0; i < zero_pad_bytes; i++) dest[i] = 0;</div> -<div class="line"><a name="l00554"></a><span class="lineno"> 554</span>  }</div> -<div class="line"><a name="l00555"></a><span class="lineno"> 555</span> </div> -<div class="line"><a name="l00556"></a><span class="lineno"> 556</span>  <span class="keywordtype">void</span> pop(<span class="keywordtype">size_t</span> bytes_to_remove) { cur_ += bytes_to_remove; }</div> -<div class="line"><a name="l00557"></a><span class="lineno"> 557</span> </div> -<div class="line"><a name="l00558"></a><span class="lineno"> 558</span>  <span class="keyword">private</span>:</div> -<div class="line"><a name="l00559"></a><span class="lineno"> 559</span>  <span class="comment">// You shouldn't really be copying instances of this class.</span></div> -<div class="line"><a name="l00560"></a><span class="lineno"> 560</span>  vector_downward(<span class="keyword">const</span> vector_downward &);</div> -<div class="line"><a name="l00561"></a><span class="lineno"> 561</span>  vector_downward &operator=(<span class="keyword">const</span> vector_downward &);</div> -<div class="line"><a name="l00562"></a><span class="lineno"> 562</span> </div> -<div class="line"><a name="l00563"></a><span class="lineno"> 563</span>  <span class="keywordtype">size_t</span> reserved_;</div> -<div class="line"><a name="l00564"></a><span class="lineno"> 564</span>  uint8_t *buf_;</div> -<div class="line"><a name="l00565"></a><span class="lineno"> 565</span>  uint8_t *cur_; <span class="comment">// Points at location between empty (below) and used (above).</span></div> -<div class="line"><a name="l00566"></a><span class="lineno"> 566</span>  <span class="keyword">const</span> simple_allocator &allocator_;</div> -<div class="line"><a name="l00567"></a><span class="lineno"> 567</span> };</div> -<div class="line"><a name="l00568"></a><span class="lineno"> 568</span> </div> -<div class="line"><a name="l00569"></a><span class="lineno"> 569</span> <span class="comment">// Converts a Field ID to a virtual table offset.</span></div> -<div class="line"><a name="l00570"></a><span class="lineno"> 570</span> <span class="keyword">inline</span> voffset_t FieldIndexToOffset(voffset_t field_id) {</div> -<div class="line"><a name="l00571"></a><span class="lineno"> 571</span>  <span class="comment">// Should correspond to what EndTable() below builds up.</span></div> -<div class="line"><a name="l00572"></a><span class="lineno"> 572</span>  <span class="keyword">const</span> <span class="keywordtype">int</span> fixed_fields = 2; <span class="comment">// Vtable size and Object Size.</span></div> -<div class="line"><a name="l00573"></a><span class="lineno"> 573</span>  <span class="keywordflow">return</span> <span class="keyword">static_cast<</span>voffset_t<span class="keyword">></span>((field_id + fixed_fields) * <span class="keyword">sizeof</span>(voffset_t));</div> -<div class="line"><a name="l00574"></a><span class="lineno"> 574</span> }</div> -<div class="line"><a name="l00575"></a><span class="lineno"> 575</span> </div> -<div class="line"><a name="l00576"></a><span class="lineno"> 576</span> <span class="comment">// Computes how many bytes you'd have to pad to be able to write an</span></div> -<div class="line"><a name="l00577"></a><span class="lineno"> 577</span> <span class="comment">// "scalar_size" scalar if the buffer had grown to "buf_size" (downwards in</span></div> -<div class="line"><a name="l00578"></a><span class="lineno"> 578</span> <span class="comment">// memory).</span></div> -<div class="line"><a name="l00579"></a><span class="lineno"> 579</span> <span class="keyword">inline</span> <span class="keywordtype">size_t</span> PaddingBytes(<span class="keywordtype">size_t</span> buf_size, <span class="keywordtype">size_t</span> scalar_size) {</div> -<div class="line"><a name="l00580"></a><span class="lineno"> 580</span>  <span class="keywordflow">return</span> ((~buf_size) + 1) & (scalar_size - 1);</div> -<div class="line"><a name="l00581"></a><span class="lineno"> 581</span> }</div> -<div class="line"><a name="l00582"></a><span class="lineno"> 582</span> </div> -<div class="line"><a name="l00583"></a><span class="lineno"> 583</span> <span class="keyword">template</span> <<span class="keyword">typename</span> T> <span class="keyword">const</span> T* data(<span class="keyword">const</span> std::vector<T> &v) {</div> -<div class="line"><a name="l00584"></a><span class="lineno"> 584</span>  <span class="keywordflow">return</span> v.empty() ? <span class="keyword">nullptr</span> : &v.front();</div> -<div class="line"><a name="l00585"></a><span class="lineno"> 585</span> }</div> -<div class="line"><a name="l00586"></a><span class="lineno"> 586</span> <span class="keyword">template</span> <<span class="keyword">typename</span> T> T* data(std::vector<T> &v) {</div> -<div class="line"><a name="l00587"></a><span class="lineno"> 587</span>  <span class="keywordflow">return</span> v.empty() ? <span class="keyword">nullptr</span> : &v.front();</div> -<div class="line"><a name="l00588"></a><span class="lineno"> 588</span> }</div> -<div class="line"><a name="l00589"></a><span class="lineno"> 589</span> <span class="comment"></span></div> -<div class="line"><a name="l00590"></a><span class="lineno"> 590</span> <span class="comment">/// @endcond</span></div> -<div class="line"><a name="l00591"></a><span class="lineno"> 591</span> <span class="comment"></span><span class="comment"></span></div> -<div class="line"><a name="l00592"></a><span class="lineno"> 592</span> <span class="comment">/// @addtogroup flatbuffers_cpp_api</span></div> -<div class="line"><a name="l00593"></a><span class="lineno"> 593</span> <span class="comment">/// @{</span></div> -<div class="line"><a name="l00594"></a><span class="lineno"> 594</span> <span class="comment">/// @class FlatBufferBuilder</span></div> -<div class="line"><a name="l00595"></a><span class="lineno"> 595</span> <span class="comment">/// @brief Helper class to hold data needed in creation of a FlatBuffer.</span></div> -<div class="line"><a name="l00596"></a><span class="lineno"> 596</span> <span class="comment">/// To serialize data, you typically call one of the `Create*()` functions in</span></div> -<div class="line"><a name="l00597"></a><span class="lineno"> 597</span> <span class="comment">/// the generated code, which in turn call a sequence of `StartTable`/</span></div> -<div class="line"><a name="l00598"></a><span class="lineno"> 598</span> <span class="comment">/// `PushElement`/`AddElement`/`EndTable`, or the builtin `CreateString`/</span></div> -<div class="line"><a name="l00599"></a><span class="lineno"> 599</span> <span class="comment">/// `CreateVector` functions. Do this is depth-first order to build up a tree to</span></div> -<div class="line"><a name="l00600"></a><span class="lineno"> 600</span> <span class="comment">/// the root. `Finish()` wraps up the buffer ready for transport.</span></div> -<div class="line"><a name="l00601"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html"> 601</a></span> <span class="comment"></span><span class="keyword">class </span><a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html">FlatBufferBuilder</a><span class="comment"></span></div> -<div class="line"><a name="l00602"></a><span class="lineno"> 602</span> <span class="comment">/// @cond FLATBUFFERS_INTERNAL</span></div> -<div class="line"><a name="l00603"></a><span class="lineno"> 603</span> <span class="comment"></span>FLATBUFFERS_FINAL_CLASS<span class="comment"></span></div> -<div class="line"><a name="l00604"></a><span class="lineno"> 604</span> <span class="comment">/// @endcond</span></div> -<div class="line"><a name="l00605"></a><span class="lineno"> 605</span> <span class="comment"></span>{</div> -<div class="line"><a name="l00606"></a><span class="lineno"> 606</span>  <span class="keyword">public</span>:<span class="comment"></span></div> -<div class="line"><a name="l00607"></a><span class="lineno"> 607</span> <span class="comment"> /// @brief Default constructor for FlatBufferBuilder.</span></div> -<div class="line"><a name="l00608"></a><span class="lineno"> 608</span> <span class="comment"> /// @param[in] initial_size The initial size of the buffer, in bytes. Defaults</span></div> -<div class="line"><a name="l00609"></a><span class="lineno"> 609</span> <span class="comment"> /// to`1024`.</span></div> -<div class="line"><a name="l00610"></a><span class="lineno"> 610</span> <span class="comment"> /// @param[in] allocator A pointer to the `simple_allocator` that should be</span></div> -<div class="line"><a name="l00611"></a><span class="lineno"> 611</span> <span class="comment"> /// used. Defaults to `nullptr`, which means the `default_allocator` will be</span></div> -<div class="line"><a name="l00612"></a><span class="lineno"> 612</span> <span class="comment"> /// be used.</span></div> -<div class="line"><a name="l00613"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#ac72b54a75e0c329e0ce0b8fab758e256"> 613</a></span> <span class="comment"></span> <span class="keyword">explicit</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac72b54a75e0c329e0ce0b8fab758e256">FlatBufferBuilder</a>(uoffset_t initial_size = 1024,</div> -<div class="line"><a name="l00614"></a><span class="lineno"> 614</span>  <span class="keyword">const</span> simple_allocator *allocator = <span class="keyword">nullptr</span>)</div> -<div class="line"><a name="l00615"></a><span class="lineno"> 615</span>  : buf_(initial_size, allocator ? *allocator : default_allocator),</div> -<div class="line"><a name="l00616"></a><span class="lineno"> 616</span>  nested(false), finished(false), minalign_(1), force_defaults_(false),</div> -<div class="line"><a name="l00617"></a><span class="lineno"> 617</span>  string_pool(nullptr) {</div> -<div class="line"><a name="l00618"></a><span class="lineno"> 618</span>  offsetbuf_.reserve(16); <span class="comment">// Avoid first few reallocs.</span></div> -<div class="line"><a name="l00619"></a><span class="lineno"> 619</span>  vtables_.reserve(16);</div> -<div class="line"><a name="l00620"></a><span class="lineno"> 620</span>  EndianCheck();</div> -<div class="line"><a name="l00621"></a><span class="lineno"> 621</span>  }</div> -<div class="line"><a name="l00622"></a><span class="lineno"> 622</span> </div> -<div class="line"><a name="l00623"></a><span class="lineno"> 623</span>  ~<a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html">FlatBufferBuilder</a>() {</div> -<div class="line"><a name="l00624"></a><span class="lineno"> 624</span>  <span class="keywordflow">if</span> (string_pool) <span class="keyword">delete</span> string_pool;</div> -<div class="line"><a name="l00625"></a><span class="lineno"> 625</span>  }</div> -<div class="line"><a name="l00626"></a><span class="lineno"> 626</span> <span class="comment"></span></div> -<div class="line"><a name="l00627"></a><span class="lineno"> 627</span> <span class="comment"> /// @brief Reset all the state in this FlatBufferBuilder so it can be reused</span></div> -<div class="line"><a name="l00628"></a><span class="lineno"> 628</span> <span class="comment"> /// to construct another buffer.</span></div> -<div class="line"><a name="l00629"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#ae94b94ba71ea0aeb2d9a98c43b713412"> 629</a></span> <span class="comment"></span> <span class="keywordtype">void</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ae94b94ba71ea0aeb2d9a98c43b713412">Clear</a>() {</div> -<div class="line"><a name="l00630"></a><span class="lineno"> 630</span>  buf_.clear();</div> -<div class="line"><a name="l00631"></a><span class="lineno"> 631</span>  offsetbuf_.clear();</div> -<div class="line"><a name="l00632"></a><span class="lineno"> 632</span>  nested = <span class="keyword">false</span>;</div> -<div class="line"><a name="l00633"></a><span class="lineno"> 633</span>  finished = <span class="keyword">false</span>;</div> -<div class="line"><a name="l00634"></a><span class="lineno"> 634</span>  vtables_.clear();</div> -<div class="line"><a name="l00635"></a><span class="lineno"> 635</span>  minalign_ = 1;</div> -<div class="line"><a name="l00636"></a><span class="lineno"> 636</span>  <span class="keywordflow">if</span> (string_pool) string_pool->clear();</div> -<div class="line"><a name="l00637"></a><span class="lineno"> 637</span>  }</div> -<div class="line"><a name="l00638"></a><span class="lineno"> 638</span> <span class="comment"></span></div> -<div class="line"><a name="l00639"></a><span class="lineno"> 639</span> <span class="comment"> /// @brief The current size of the serialized buffer, counting from the end.</span></div> -<div class="line"><a name="l00640"></a><span class="lineno"> 640</span> <span class="comment"> /// @return Returns an `uoffset_t` with the current size of the buffer.</span></div> -<div class="line"><a name="l00641"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63"> 641</a></span> <span class="comment"></span> uoffset_t <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> buf_.size(); }</div> -<div class="line"><a name="l00642"></a><span class="lineno"> 642</span> <span class="comment"></span></div> -<div class="line"><a name="l00643"></a><span class="lineno"> 643</span> <span class="comment"> /// @brief Get the serialized buffer (after you call `Finish()`).</span></div> -<div class="line"><a name="l00644"></a><span class="lineno"> 644</span> <span class="comment"> /// @return Returns an `uint8_t` pointer to the FlatBuffer data inside the</span></div> -<div class="line"><a name="l00645"></a><span class="lineno"> 645</span> <span class="comment"> /// buffer.</span></div> -<div class="line"><a name="l00646"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a8dc35f792179df4ca850492c1796d8b8"> 646</a></span> <span class="comment"></span> uint8_t *<a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a8dc35f792179df4ca850492c1796d8b8">GetBufferPointer</a>()<span class="keyword"> const </span>{</div> -<div class="line"><a name="l00647"></a><span class="lineno"> 647</span>  Finished();</div> -<div class="line"><a name="l00648"></a><span class="lineno"> 648</span>  <span class="keywordflow">return</span> buf_.data();</div> -<div class="line"><a name="l00649"></a><span class="lineno"> 649</span>  }</div> -<div class="line"><a name="l00650"></a><span class="lineno"> 650</span> <span class="comment"></span></div> -<div class="line"><a name="l00651"></a><span class="lineno"> 651</span> <span class="comment"> /// @brief Get a pointer to an unfinished buffer.</span></div> -<div class="line"><a name="l00652"></a><span class="lineno"> 652</span> <span class="comment"> /// @return Returns a `uint8_t` pointer to the unfinished buffer.</span></div> -<div class="line"><a name="l00653"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a3f4252e9bc005ba6c700469544fdccc9"> 653</a></span> <span class="comment"></span> uint8_t *<a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a3f4252e9bc005ba6c700469544fdccc9">GetCurrentBufferPointer</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> buf_.data(); }</div> -<div class="line"><a name="l00654"></a><span class="lineno"> 654</span> </div> -<div class="line"><a name="l00655"></a><span class="lineno"> 655</span> <span class="preprocessor"> #ifndef FLATBUFFERS_CPP98_STL</span></div> -<div class="line"><a name="l00656"></a><span class="lineno"> 656</span> <span class="comment"> /// @brief Get the released pointer to the serialized buffer.</span></div> -<div class="line"><a name="l00657"></a><span class="lineno"> 657</span> <span class="comment"></span><span class="comment"> /// @warning Do NOT attempt to use this FlatBufferBuilder afterwards!</span></div> -<div class="line"><a name="l00658"></a><span class="lineno"> 658</span> <span class="comment"></span><span class="comment"> /// @return The `unique_ptr` returned has a special allocator that knows how</span></div> -<div class="line"><a name="l00659"></a><span class="lineno"> 659</span> <span class="comment"></span><span class="comment"> /// to deallocate this pointer (since it points to the middle of an</span></div> -<div class="line"><a name="l00660"></a><span class="lineno"> 660</span> <span class="comment"></span><span class="comment"> /// allocation). Thus, do not mix this pointer with other `unique_ptr`'s, or</span></div> -<div class="line"><a name="l00661"></a><span class="lineno"> 661</span> <span class="comment"></span><span class="comment"> /// call `release()`/`reset()` on it.</span></div> -<div class="line"><a name="l00662"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a21c7f933d7ff1212f2090763ef9f0c44"> 662</a></span> <span class="comment"></span> unique_ptr_t <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a21c7f933d7ff1212f2090763ef9f0c44">ReleaseBufferPointer</a>() {</div> -<div class="line"><a name="l00663"></a><span class="lineno"> 663</span>  Finished();</div> -<div class="line"><a name="l00664"></a><span class="lineno"> 664</span>  <span class="keywordflow">return</span> buf_.release();</div> -<div class="line"><a name="l00665"></a><span class="lineno"> 665</span>  }</div> -<div class="line"><a name="l00666"></a><span class="lineno"> 666</span> <span class="preprocessor"> #endif</span></div> +<div class="line"><a name="l00532"></a><span class="lineno"> 532</span>  <span class="keywordflow">return</span> retval;</div> +<div class="line"><a name="l00533"></a><span class="lineno"> 533</span>  }</div> +<div class="line"><a name="l00534"></a><span class="lineno"> 534</span> <span class="preprocessor"> #endif</span></div> +<div class="line"><a name="l00535"></a><span class="lineno"> 535</span> </div> +<div class="line"><a name="l00536"></a><span class="lineno"> 536</span>  <span class="keywordtype">size_t</span> growth_policy(<span class="keywordtype">size_t</span> bytes) {</div> +<div class="line"><a name="l00537"></a><span class="lineno"> 537</span>  <span class="keywordflow">return</span> (bytes / 2) & ~(<span class="keyword">sizeof</span>(largest_scalar_t) - 1);</div> +<div class="line"><a name="l00538"></a><span class="lineno"> 538</span>  }</div> +<div class="line"><a name="l00539"></a><span class="lineno"> 539</span> </div> +<div class="line"><a name="l00540"></a><span class="lineno"> 540</span>  uint8_t *make_space(<span class="keywordtype">size_t</span> len) {</div> +<div class="line"><a name="l00541"></a><span class="lineno"> 541</span>  <span class="keywordflow">if</span> (len > static_cast<size_t>(cur_ - buf_)) {</div> +<div class="line"><a name="l00542"></a><span class="lineno"> 542</span>  <span class="keyword">auto</span> old_size = size();</div> +<div class="line"><a name="l00543"></a><span class="lineno"> 543</span>  <span class="keyword">auto</span> largest_align = AlignOf<largest_scalar_t>();</div> +<div class="line"><a name="l00544"></a><span class="lineno"> 544</span>  reserved_ += (std::max)(len, growth_policy(reserved_));</div> +<div class="line"><a name="l00545"></a><span class="lineno"> 545</span>  <span class="comment">// Round up to avoid undefined behavior from unaligned loads and stores.</span></div> +<div class="line"><a name="l00546"></a><span class="lineno"> 546</span>  reserved_ = (reserved_ + (largest_align - 1)) & ~(largest_align - 1);</div> +<div class="line"><a name="l00547"></a><span class="lineno"> 547</span>  <span class="keyword">auto</span> new_buf = allocator_.allocate(reserved_);</div> +<div class="line"><a name="l00548"></a><span class="lineno"> 548</span>  <span class="keyword">auto</span> new_cur = new_buf + reserved_ - old_size;</div> +<div class="line"><a name="l00549"></a><span class="lineno"> 549</span>  memcpy(new_cur, cur_, old_size);</div> +<div class="line"><a name="l00550"></a><span class="lineno"> 550</span>  cur_ = new_cur;</div> +<div class="line"><a name="l00551"></a><span class="lineno"> 551</span>  allocator_.deallocate(buf_);</div> +<div class="line"><a name="l00552"></a><span class="lineno"> 552</span>  buf_ = new_buf;</div> +<div class="line"><a name="l00553"></a><span class="lineno"> 553</span>  }</div> +<div class="line"><a name="l00554"></a><span class="lineno"> 554</span>  cur_ -= len;</div> +<div class="line"><a name="l00555"></a><span class="lineno"> 555</span>  <span class="comment">// Beyond this, signed offsets may not have enough range:</span></div> +<div class="line"><a name="l00556"></a><span class="lineno"> 556</span>  <span class="comment">// (FlatBuffers > 2GB not supported).</span></div> +<div class="line"><a name="l00557"></a><span class="lineno"> 557</span>  assert(size() < FLATBUFFERS_MAX_BUFFER_SIZE);</div> +<div class="line"><a name="l00558"></a><span class="lineno"> 558</span>  <span class="keywordflow">return</span> cur_;</div> +<div class="line"><a name="l00559"></a><span class="lineno"> 559</span>  }</div> +<div class="line"><a name="l00560"></a><span class="lineno"> 560</span> </div> +<div class="line"><a name="l00561"></a><span class="lineno"> 561</span>  uoffset_t size()<span class="keyword"> const </span>{</div> +<div class="line"><a name="l00562"></a><span class="lineno"> 562</span>  assert(cur_ != <span class="keyword">nullptr</span> && buf_ != <span class="keyword">nullptr</span>);</div> +<div class="line"><a name="l00563"></a><span class="lineno"> 563</span>  <span class="keywordflow">return</span> <span class="keyword">static_cast<</span>uoffset_t<span class="keyword">></span>(reserved_ - (cur_ - buf_));</div> +<div class="line"><a name="l00564"></a><span class="lineno"> 564</span>  }</div> +<div class="line"><a name="l00565"></a><span class="lineno"> 565</span> </div> +<div class="line"><a name="l00566"></a><span class="lineno"> 566</span>  uint8_t *data()<span class="keyword"> const </span>{</div> +<div class="line"><a name="l00567"></a><span class="lineno"> 567</span>  assert(cur_ != <span class="keyword">nullptr</span>);</div> +<div class="line"><a name="l00568"></a><span class="lineno"> 568</span>  <span class="keywordflow">return</span> cur_;</div> +<div class="line"><a name="l00569"></a><span class="lineno"> 569</span>  }</div> +<div class="line"><a name="l00570"></a><span class="lineno"> 570</span> </div> +<div class="line"><a name="l00571"></a><span class="lineno"> 571</span>  uint8_t *data_at(<span class="keywordtype">size_t</span> offset)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> buf_ + reserved_ - offset; }</div> +<div class="line"><a name="l00572"></a><span class="lineno"> 572</span> </div> +<div class="line"><a name="l00573"></a><span class="lineno"> 573</span>  <span class="comment">// push() & fill() are most frequently called with small byte counts (<= 4),</span></div> +<div class="line"><a name="l00574"></a><span class="lineno"> 574</span>  <span class="comment">// which is why we're using loops rather than calling memcpy/memset.</span></div> +<div class="line"><a name="l00575"></a><span class="lineno"> 575</span>  <span class="keywordtype">void</span> push(<span class="keyword">const</span> uint8_t *bytes, <span class="keywordtype">size_t</span> num) {</div> +<div class="line"><a name="l00576"></a><span class="lineno"> 576</span>  <span class="keyword">auto</span> dest = make_space(num);</div> +<div class="line"><a name="l00577"></a><span class="lineno"> 577</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i = 0; i < num; i++) dest[i] = bytes[i];</div> +<div class="line"><a name="l00578"></a><span class="lineno"> 578</span>  }</div> +<div class="line"><a name="l00579"></a><span class="lineno"> 579</span> </div> +<div class="line"><a name="l00580"></a><span class="lineno"> 580</span>  <span class="keywordtype">void</span> fill(<span class="keywordtype">size_t</span> zero_pad_bytes) {</div> +<div class="line"><a name="l00581"></a><span class="lineno"> 581</span>  <span class="keyword">auto</span> dest = make_space(zero_pad_bytes);</div> +<div class="line"><a name="l00582"></a><span class="lineno"> 582</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i = 0; i < zero_pad_bytes; i++) dest[i] = 0;</div> +<div class="line"><a name="l00583"></a><span class="lineno"> 583</span>  }</div> +<div class="line"><a name="l00584"></a><span class="lineno"> 584</span> </div> +<div class="line"><a name="l00585"></a><span class="lineno"> 585</span>  <span class="keywordtype">void</span> pop(<span class="keywordtype">size_t</span> bytes_to_remove) { cur_ += bytes_to_remove; }</div> +<div class="line"><a name="l00586"></a><span class="lineno"> 586</span> </div> +<div class="line"><a name="l00587"></a><span class="lineno"> 587</span>  <span class="keyword">private</span>:</div> +<div class="line"><a name="l00588"></a><span class="lineno"> 588</span>  <span class="comment">// You shouldn't really be copying instances of this class.</span></div> +<div class="line"><a name="l00589"></a><span class="lineno"> 589</span>  vector_downward(<span class="keyword">const</span> vector_downward &);</div> +<div class="line"><a name="l00590"></a><span class="lineno"> 590</span>  vector_downward &operator=(<span class="keyword">const</span> vector_downward &);</div> +<div class="line"><a name="l00591"></a><span class="lineno"> 591</span> </div> +<div class="line"><a name="l00592"></a><span class="lineno"> 592</span>  <span class="keywordtype">size_t</span> reserved_;</div> +<div class="line"><a name="l00593"></a><span class="lineno"> 593</span>  uint8_t *buf_;</div> +<div class="line"><a name="l00594"></a><span class="lineno"> 594</span>  uint8_t *cur_; <span class="comment">// Points at location between empty (below) and used (above).</span></div> +<div class="line"><a name="l00595"></a><span class="lineno"> 595</span>  <span class="keyword">const</span> simple_allocator &allocator_;</div> +<div class="line"><a name="l00596"></a><span class="lineno"> 596</span> };</div> +<div class="line"><a name="l00597"></a><span class="lineno"> 597</span> </div> +<div class="line"><a name="l00598"></a><span class="lineno"> 598</span> <span class="comment">// Converts a Field ID to a virtual table offset.</span></div> +<div class="line"><a name="l00599"></a><span class="lineno"> 599</span> <span class="keyword">inline</span> voffset_t FieldIndexToOffset(voffset_t field_id) {</div> +<div class="line"><a name="l00600"></a><span class="lineno"> 600</span>  <span class="comment">// Should correspond to what EndTable() below builds up.</span></div> +<div class="line"><a name="l00601"></a><span class="lineno"> 601</span>  <span class="keyword">const</span> <span class="keywordtype">int</span> fixed_fields = 2; <span class="comment">// Vtable size and Object Size.</span></div> +<div class="line"><a name="l00602"></a><span class="lineno"> 602</span>  <span class="keywordflow">return</span> <span class="keyword">static_cast<</span>voffset_t<span class="keyword">></span>((field_id + fixed_fields) * <span class="keyword">sizeof</span>(voffset_t));</div> +<div class="line"><a name="l00603"></a><span class="lineno"> 603</span> }</div> +<div class="line"><a name="l00604"></a><span class="lineno"> 604</span> </div> +<div class="line"><a name="l00605"></a><span class="lineno"> 605</span> <span class="comment">// Computes how many bytes you'd have to pad to be able to write an</span></div> +<div class="line"><a name="l00606"></a><span class="lineno"> 606</span> <span class="comment">// "scalar_size" scalar if the buffer had grown to "buf_size" (downwards in</span></div> +<div class="line"><a name="l00607"></a><span class="lineno"> 607</span> <span class="comment">// memory).</span></div> +<div class="line"><a name="l00608"></a><span class="lineno"> 608</span> <span class="keyword">inline</span> <span class="keywordtype">size_t</span> PaddingBytes(<span class="keywordtype">size_t</span> buf_size, <span class="keywordtype">size_t</span> scalar_size) {</div> +<div class="line"><a name="l00609"></a><span class="lineno"> 609</span>  <span class="keywordflow">return</span> ((~buf_size) + 1) & (scalar_size - 1);</div> +<div class="line"><a name="l00610"></a><span class="lineno"> 610</span> }</div> +<div class="line"><a name="l00611"></a><span class="lineno"> 611</span> </div> +<div class="line"><a name="l00612"></a><span class="lineno"> 612</span> <span class="keyword">template</span> <<span class="keyword">typename</span> T> <span class="keyword">const</span> T* data(<span class="keyword">const</span> std::vector<T> &v) {</div> +<div class="line"><a name="l00613"></a><span class="lineno"> 613</span>  <span class="keywordflow">return</span> v.empty() ? <span class="keyword">nullptr</span> : &v.front();</div> +<div class="line"><a name="l00614"></a><span class="lineno"> 614</span> }</div> +<div class="line"><a name="l00615"></a><span class="lineno"> 615</span> <span class="keyword">template</span> <<span class="keyword">typename</span> T> T* data(std::vector<T> &v) {</div> +<div class="line"><a name="l00616"></a><span class="lineno"> 616</span>  <span class="keywordflow">return</span> v.empty() ? <span class="keyword">nullptr</span> : &v.front();</div> +<div class="line"><a name="l00617"></a><span class="lineno"> 617</span> }</div> +<div class="line"><a name="l00618"></a><span class="lineno"> 618</span> <span class="comment"></span></div> +<div class="line"><a name="l00619"></a><span class="lineno"> 619</span> <span class="comment">/// @endcond</span></div> +<div class="line"><a name="l00620"></a><span class="lineno"> 620</span> <span class="comment"></span><span class="comment"></span></div> +<div class="line"><a name="l00621"></a><span class="lineno"> 621</span> <span class="comment">/// @addtogroup flatbuffers_cpp_api</span></div> +<div class="line"><a name="l00622"></a><span class="lineno"> 622</span> <span class="comment">/// @{</span></div> +<div class="line"><a name="l00623"></a><span class="lineno"> 623</span> <span class="comment">/// @class FlatBufferBuilder</span></div> +<div class="line"><a name="l00624"></a><span class="lineno"> 624</span> <span class="comment">/// @brief Helper class to hold data needed in creation of a FlatBuffer.</span></div> +<div class="line"><a name="l00625"></a><span class="lineno"> 625</span> <span class="comment">/// To serialize data, you typically call one of the `Create*()` functions in</span></div> +<div class="line"><a name="l00626"></a><span class="lineno"> 626</span> <span class="comment">/// the generated code, which in turn call a sequence of `StartTable`/</span></div> +<div class="line"><a name="l00627"></a><span class="lineno"> 627</span> <span class="comment">/// `PushElement`/`AddElement`/`EndTable`, or the builtin `CreateString`/</span></div> +<div class="line"><a name="l00628"></a><span class="lineno"> 628</span> <span class="comment">/// `CreateVector` functions. Do this is depth-first order to build up a tree to</span></div> +<div class="line"><a name="l00629"></a><span class="lineno"> 629</span> <span class="comment">/// the root. `Finish()` wraps up the buffer ready for transport.</span></div> +<div class="line"><a name="l00630"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html"> 630</a></span> <span class="comment"></span><span class="keyword">class </span><a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html">FlatBufferBuilder</a><span class="comment"></span></div> +<div class="line"><a name="l00631"></a><span class="lineno"> 631</span> <span class="comment">/// @cond FLATBUFFERS_INTERNAL</span></div> +<div class="line"><a name="l00632"></a><span class="lineno"> 632</span> <span class="comment"></span>FLATBUFFERS_FINAL_CLASS<span class="comment"></span></div> +<div class="line"><a name="l00633"></a><span class="lineno"> 633</span> <span class="comment">/// @endcond</span></div> +<div class="line"><a name="l00634"></a><span class="lineno"> 634</span> <span class="comment"></span>{</div> +<div class="line"><a name="l00635"></a><span class="lineno"> 635</span>  <span class="keyword">public</span>:<span class="comment"></span></div> +<div class="line"><a name="l00636"></a><span class="lineno"> 636</span> <span class="comment"> /// @brief Default constructor for FlatBufferBuilder.</span></div> +<div class="line"><a name="l00637"></a><span class="lineno"> 637</span> <span class="comment"> /// @param[in] initial_size The initial size of the buffer, in bytes. Defaults</span></div> +<div class="line"><a name="l00638"></a><span class="lineno"> 638</span> <span class="comment"> /// to`1024`.</span></div> +<div class="line"><a name="l00639"></a><span class="lineno"> 639</span> <span class="comment"> /// @param[in] allocator A pointer to the `simple_allocator` that should be</span></div> +<div class="line"><a name="l00640"></a><span class="lineno"> 640</span> <span class="comment"> /// used. Defaults to `nullptr`, which means the `default_allocator` will be</span></div> +<div class="line"><a name="l00641"></a><span class="lineno"> 641</span> <span class="comment"> /// be used.</span></div> +<div class="line"><a name="l00642"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#ac72b54a75e0c329e0ce0b8fab758e256"> 642</a></span> <span class="comment"></span> <span class="keyword">explicit</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac72b54a75e0c329e0ce0b8fab758e256">FlatBufferBuilder</a>(uoffset_t initial_size = 1024,</div> +<div class="line"><a name="l00643"></a><span class="lineno"> 643</span>  <span class="keyword">const</span> simple_allocator *allocator = <span class="keyword">nullptr</span>)</div> +<div class="line"><a name="l00644"></a><span class="lineno"> 644</span>  : buf_(initial_size, allocator ? *allocator : default_allocator),</div> +<div class="line"><a name="l00645"></a><span class="lineno"> 645</span>  nested(false), finished(false), minalign_(1), force_defaults_(false),</div> +<div class="line"><a name="l00646"></a><span class="lineno"> 646</span>  string_pool(nullptr) {</div> +<div class="line"><a name="l00647"></a><span class="lineno"> 647</span>  offsetbuf_.reserve(16); <span class="comment">// Avoid first few reallocs.</span></div> +<div class="line"><a name="l00648"></a><span class="lineno"> 648</span>  vtables_.reserve(16);</div> +<div class="line"><a name="l00649"></a><span class="lineno"> 649</span>  EndianCheck();</div> +<div class="line"><a name="l00650"></a><span class="lineno"> 650</span>  }</div> +<div class="line"><a name="l00651"></a><span class="lineno"> 651</span> </div> +<div class="line"><a name="l00652"></a><span class="lineno"> 652</span>  ~<a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html">FlatBufferBuilder</a>() {</div> +<div class="line"><a name="l00653"></a><span class="lineno"> 653</span>  <span class="keywordflow">if</span> (string_pool) <span class="keyword">delete</span> string_pool;</div> +<div class="line"><a name="l00654"></a><span class="lineno"> 654</span>  }</div> +<div class="line"><a name="l00655"></a><span class="lineno"> 655</span> <span class="comment"></span></div> +<div class="line"><a name="l00656"></a><span class="lineno"> 656</span> <span class="comment"> /// @brief Reset all the state in this FlatBufferBuilder so it can be reused</span></div> +<div class="line"><a name="l00657"></a><span class="lineno"> 657</span> <span class="comment"> /// to construct another buffer.</span></div> +<div class="line"><a name="l00658"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#ae94b94ba71ea0aeb2d9a98c43b713412"> 658</a></span> <span class="comment"></span> <span class="keywordtype">void</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ae94b94ba71ea0aeb2d9a98c43b713412">Clear</a>() {</div> +<div class="line"><a name="l00659"></a><span class="lineno"> 659</span>  buf_.clear();</div> +<div class="line"><a name="l00660"></a><span class="lineno"> 660</span>  offsetbuf_.clear();</div> +<div class="line"><a name="l00661"></a><span class="lineno"> 661</span>  nested = <span class="keyword">false</span>;</div> +<div class="line"><a name="l00662"></a><span class="lineno"> 662</span>  finished = <span class="keyword">false</span>;</div> +<div class="line"><a name="l00663"></a><span class="lineno"> 663</span>  vtables_.clear();</div> +<div class="line"><a name="l00664"></a><span class="lineno"> 664</span>  minalign_ = 1;</div> +<div class="line"><a name="l00665"></a><span class="lineno"> 665</span>  <span class="keywordflow">if</span> (string_pool) string_pool->clear();</div> +<div class="line"><a name="l00666"></a><span class="lineno"> 666</span>  }</div> <div class="line"><a name="l00667"></a><span class="lineno"> 667</span> <span class="comment"></span></div> -<div class="line"><a name="l00668"></a><span class="lineno"> 668</span> <span class="comment"> /// @brief get the minimum alignment this buffer needs to be accessed</span></div> -<div class="line"><a name="l00669"></a><span class="lineno"> 669</span> <span class="comment"> /// properly. This is only known once all elements have been written (after</span></div> -<div class="line"><a name="l00670"></a><span class="lineno"> 670</span> <span class="comment"> /// you call Finish()). You can use this information if you need to embed</span></div> -<div class="line"><a name="l00671"></a><span class="lineno"> 671</span> <span class="comment"> /// a FlatBuffer in some other buffer, such that you can later read it</span></div> -<div class="line"><a name="l00672"></a><span class="lineno"> 672</span> <span class="comment"> /// without first having to copy it into its own buffer.</span></div> -<div class="line"><a name="l00673"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#aa1ebce1f3f46832946a95952af1e9c2b"> 673</a></span> <span class="comment"></span> <span class="keywordtype">size_t</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#aa1ebce1f3f46832946a95952af1e9c2b">GetBufferMinAlignment</a>() {</div> -<div class="line"><a name="l00674"></a><span class="lineno"> 674</span>  Finished();</div> -<div class="line"><a name="l00675"></a><span class="lineno"> 675</span>  <span class="keywordflow">return</span> minalign_;</div> -<div class="line"><a name="l00676"></a><span class="lineno"> 676</span>  }</div> -<div class="line"><a name="l00677"></a><span class="lineno"> 677</span> <span class="comment"></span></div> -<div class="line"><a name="l00678"></a><span class="lineno"> 678</span> <span class="comment"> /// @cond FLATBUFFERS_INTERNAL</span></div> -<div class="line"><a name="l00679"></a><span class="lineno"> 679</span> <span class="comment"></span> <span class="keywordtype">void</span> Finished()<span class="keyword"> const </span>{</div> -<div class="line"><a name="l00680"></a><span class="lineno"> 680</span>  <span class="comment">// If you get this assert, you're attempting to get access a buffer</span></div> -<div class="line"><a name="l00681"></a><span class="lineno"> 681</span>  <span class="comment">// which hasn't been finished yet. Be sure to call</span></div> -<div class="line"><a name="l00682"></a><span class="lineno"> 682</span>  <span class="comment">// FlatBufferBuilder::Finish with your root table.</span></div> -<div class="line"><a name="l00683"></a><span class="lineno"> 683</span>  <span class="comment">// If you really need to access an unfinished buffer, call</span></div> -<div class="line"><a name="l00684"></a><span class="lineno"> 684</span>  <span class="comment">// GetCurrentBufferPointer instead.</span></div> -<div class="line"><a name="l00685"></a><span class="lineno"> 685</span>  assert(finished);</div> -<div class="line"><a name="l00686"></a><span class="lineno"> 686</span>  }<span class="comment"></span></div> -<div class="line"><a name="l00687"></a><span class="lineno"> 687</span> <span class="comment"> /// @endcond</span></div> -<div class="line"><a name="l00688"></a><span class="lineno"> 688</span> <span class="comment"></span><span class="comment"></span></div> -<div class="line"><a name="l00689"></a><span class="lineno"> 689</span> <span class="comment"> /// @brief In order to save space, fields that are set to their default value</span></div> -<div class="line"><a name="l00690"></a><span class="lineno"> 690</span> <span class="comment"> /// don't get serialized into the buffer.</span></div> -<div class="line"><a name="l00691"></a><span class="lineno"> 691</span> <span class="comment"> /// @param[in] bool fd When set to `true`, always serializes default values.</span></div> -<div class="line"><a name="l00692"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a16a8fd46b34ad7727406c37b65b6b27a"> 692</a></span> <span class="comment"></span> <span class="keywordtype">void</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a16a8fd46b34ad7727406c37b65b6b27a">ForceDefaults</a>(<span class="keywordtype">bool</span> fd) { force_defaults_ = fd; }</div> -<div class="line"><a name="l00693"></a><span class="lineno"> 693</span> <span class="comment"></span></div> -<div class="line"><a name="l00694"></a><span class="lineno"> 694</span> <span class="comment"> /// @cond FLATBUFFERS_INTERNAL</span></div> -<div class="line"><a name="l00695"></a><span class="lineno"> 695</span> <span class="comment"></span> <span class="keywordtype">void</span> Pad(<span class="keywordtype">size_t</span> num_bytes) { buf_.fill(num_bytes); }</div> -<div class="line"><a name="l00696"></a><span class="lineno"> 696</span> </div> -<div class="line"><a name="l00697"></a><span class="lineno"> 697</span>  <span class="keywordtype">void</span> Align(<span class="keywordtype">size_t</span> elem_size) {</div> -<div class="line"><a name="l00698"></a><span class="lineno"> 698</span>  <span class="keywordflow">if</span> (elem_size > minalign_) minalign_ = elem_size;</div> -<div class="line"><a name="l00699"></a><span class="lineno"> 699</span>  buf_.fill(PaddingBytes(buf_.size(), elem_size));</div> -<div class="line"><a name="l00700"></a><span class="lineno"> 700</span>  }</div> -<div class="line"><a name="l00701"></a><span class="lineno"> 701</span> </div> -<div class="line"><a name="l00702"></a><span class="lineno"> 702</span>  <span class="keywordtype">void</span> PushFlatBuffer(<span class="keyword">const</span> uint8_t *bytes, <span class="keywordtype">size_t</span> size) {</div> -<div class="line"><a name="l00703"></a><span class="lineno"> 703</span>  PushBytes(bytes, size);</div> -<div class="line"><a name="l00704"></a><span class="lineno"> 704</span>  finished = <span class="keyword">true</span>;</div> +<div class="line"><a name="l00668"></a><span class="lineno"> 668</span> <span class="comment"> /// @brief The current size of the serialized buffer, counting from the end.</span></div> +<div class="line"><a name="l00669"></a><span class="lineno"> 669</span> <span class="comment"> /// @return Returns an `uoffset_t` with the current size of the buffer.</span></div> +<div class="line"><a name="l00670"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63"> 670</a></span> <span class="comment"></span> uoffset_t <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> buf_.size(); }</div> +<div class="line"><a name="l00671"></a><span class="lineno"> 671</span> <span class="comment"></span></div> +<div class="line"><a name="l00672"></a><span class="lineno"> 672</span> <span class="comment"> /// @brief Get the serialized buffer (after you call `Finish()`).</span></div> +<div class="line"><a name="l00673"></a><span class="lineno"> 673</span> <span class="comment"> /// @return Returns an `uint8_t` pointer to the FlatBuffer data inside the</span></div> +<div class="line"><a name="l00674"></a><span class="lineno"> 674</span> <span class="comment"> /// buffer.</span></div> +<div class="line"><a name="l00675"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a8dc35f792179df4ca850492c1796d8b8"> 675</a></span> <span class="comment"></span> uint8_t *<a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a8dc35f792179df4ca850492c1796d8b8">GetBufferPointer</a>()<span class="keyword"> const </span>{</div> +<div class="line"><a name="l00676"></a><span class="lineno"> 676</span>  Finished();</div> +<div class="line"><a name="l00677"></a><span class="lineno"> 677</span>  <span class="keywordflow">return</span> buf_.data();</div> +<div class="line"><a name="l00678"></a><span class="lineno"> 678</span>  }</div> +<div class="line"><a name="l00679"></a><span class="lineno"> 679</span> <span class="comment"></span></div> +<div class="line"><a name="l00680"></a><span class="lineno"> 680</span> <span class="comment"> /// @brief Get a pointer to an unfinished buffer.</span></div> +<div class="line"><a name="l00681"></a><span class="lineno"> 681</span> <span class="comment"> /// @return Returns a `uint8_t` pointer to the unfinished buffer.</span></div> +<div class="line"><a name="l00682"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a3f4252e9bc005ba6c700469544fdccc9"> 682</a></span> <span class="comment"></span> uint8_t *<a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a3f4252e9bc005ba6c700469544fdccc9">GetCurrentBufferPointer</a>()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> buf_.data(); }</div> +<div class="line"><a name="l00683"></a><span class="lineno"> 683</span> </div> +<div class="line"><a name="l00684"></a><span class="lineno"> 684</span> <span class="preprocessor"> #ifndef FLATBUFFERS_CPP98_STL</span></div> +<div class="line"><a name="l00685"></a><span class="lineno"> 685</span> <span class="comment"> /// @brief Get the released pointer to the serialized buffer.</span></div> +<div class="line"><a name="l00686"></a><span class="lineno"> 686</span> <span class="comment"></span><span class="comment"> /// @warning Do NOT attempt to use this FlatBufferBuilder afterwards!</span></div> +<div class="line"><a name="l00687"></a><span class="lineno"> 687</span> <span class="comment"></span><span class="comment"> /// @return The `unique_ptr` returned has a special allocator that knows how</span></div> +<div class="line"><a name="l00688"></a><span class="lineno"> 688</span> <span class="comment"></span><span class="comment"> /// to deallocate this pointer (since it points to the middle of an</span></div> +<div class="line"><a name="l00689"></a><span class="lineno"> 689</span> <span class="comment"></span><span class="comment"> /// allocation). Thus, do not mix this pointer with other `unique_ptr`'s, or</span></div> +<div class="line"><a name="l00690"></a><span class="lineno"> 690</span> <span class="comment"></span><span class="comment"> /// call `release()`/`reset()` on it.</span></div> +<div class="line"><a name="l00691"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a21c7f933d7ff1212f2090763ef9f0c44"> 691</a></span> <span class="comment"></span> unique_ptr_t <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a21c7f933d7ff1212f2090763ef9f0c44">ReleaseBufferPointer</a>() {</div> +<div class="line"><a name="l00692"></a><span class="lineno"> 692</span>  Finished();</div> +<div class="line"><a name="l00693"></a><span class="lineno"> 693</span>  <span class="keywordflow">return</span> buf_.release();</div> +<div class="line"><a name="l00694"></a><span class="lineno"> 694</span>  }</div> +<div class="line"><a name="l00695"></a><span class="lineno"> 695</span> <span class="preprocessor"> #endif</span></div> +<div class="line"><a name="l00696"></a><span class="lineno"> 696</span> <span class="comment"></span></div> +<div class="line"><a name="l00697"></a><span class="lineno"> 697</span> <span class="comment"> /// @brief get the minimum alignment this buffer needs to be accessed</span></div> +<div class="line"><a name="l00698"></a><span class="lineno"> 698</span> <span class="comment"> /// properly. This is only known once all elements have been written (after</span></div> +<div class="line"><a name="l00699"></a><span class="lineno"> 699</span> <span class="comment"> /// you call Finish()). You can use this information if you need to embed</span></div> +<div class="line"><a name="l00700"></a><span class="lineno"> 700</span> <span class="comment"> /// a FlatBuffer in some other buffer, such that you can later read it</span></div> +<div class="line"><a name="l00701"></a><span class="lineno"> 701</span> <span class="comment"> /// without first having to copy it into its own buffer.</span></div> +<div class="line"><a name="l00702"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#aa1ebce1f3f46832946a95952af1e9c2b"> 702</a></span> <span class="comment"></span> <span class="keywordtype">size_t</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#aa1ebce1f3f46832946a95952af1e9c2b">GetBufferMinAlignment</a>() {</div> +<div class="line"><a name="l00703"></a><span class="lineno"> 703</span>  Finished();</div> +<div class="line"><a name="l00704"></a><span class="lineno"> 704</span>  <span class="keywordflow">return</span> minalign_;</div> <div class="line"><a name="l00705"></a><span class="lineno"> 705</span>  }</div> -<div class="line"><a name="l00706"></a><span class="lineno"> 706</span> </div> -<div class="line"><a name="l00707"></a><span class="lineno"> 707</span>  <span class="keywordtype">void</span> PushBytes(<span class="keyword">const</span> uint8_t *bytes, <span class="keywordtype">size_t</span> size) {</div> -<div class="line"><a name="l00708"></a><span class="lineno"> 708</span>  buf_.push(bytes, size);</div> -<div class="line"><a name="l00709"></a><span class="lineno"> 709</span>  }</div> -<div class="line"><a name="l00710"></a><span class="lineno"> 710</span> </div> -<div class="line"><a name="l00711"></a><span class="lineno"> 711</span>  <span class="keywordtype">void</span> PopBytes(<span class="keywordtype">size_t</span> amount) { buf_.pop(amount); }</div> -<div class="line"><a name="l00712"></a><span class="lineno"> 712</span> </div> -<div class="line"><a name="l00713"></a><span class="lineno"> 713</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">void</span> AssertScalarT() {</div> -<div class="line"><a name="l00714"></a><span class="lineno"> 714</span> <span class="preprocessor"> #ifndef FLATBUFFERS_CPP98_STL</span></div> -<div class="line"><a name="l00715"></a><span class="lineno"> 715</span>  <span class="comment">// The code assumes power of 2 sizes and endian-swap-ability.</span></div> -<div class="line"><a name="l00716"></a><span class="lineno"> 716</span>  static_assert(std::is_scalar<T>::value</div> -<div class="line"><a name="l00717"></a><span class="lineno"> 717</span>  <span class="comment">// The Offset<T> type is essentially a scalar but fails is_scalar.</span></div> -<div class="line"><a name="l00718"></a><span class="lineno"> 718</span>  || <span class="keyword">sizeof</span>(T) == <span class="keyword">sizeof</span>(Offset<void>),</div> -<div class="line"><a name="l00719"></a><span class="lineno"> 719</span>  <span class="stringliteral">"T must be a scalar type"</span>);</div> -<div class="line"><a name="l00720"></a><span class="lineno"> 720</span> <span class="preprocessor"> #endif</span></div> -<div class="line"><a name="l00721"></a><span class="lineno"> 721</span>  }</div> -<div class="line"><a name="l00722"></a><span class="lineno"> 722</span> </div> -<div class="line"><a name="l00723"></a><span class="lineno"> 723</span>  <span class="comment">// Write a single aligned scalar to the buffer</span></div> -<div class="line"><a name="l00724"></a><span class="lineno"> 724</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> uoffset_t PushElement(T element) {</div> -<div class="line"><a name="l00725"></a><span class="lineno"> 725</span>  AssertScalarT<T>();</div> -<div class="line"><a name="l00726"></a><span class="lineno"> 726</span>  T litle_endian_element = EndianScalar(element);</div> -<div class="line"><a name="l00727"></a><span class="lineno"> 727</span>  Align(<span class="keyword">sizeof</span>(T));</div> -<div class="line"><a name="l00728"></a><span class="lineno"> 728</span>  PushBytes(reinterpret_cast<uint8_t *>(&litle_endian_element), <span class="keyword">sizeof</span>(T));</div> -<div class="line"><a name="l00729"></a><span class="lineno"> 729</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>();</div> -<div class="line"><a name="l00730"></a><span class="lineno"> 730</span>  }</div> -<div class="line"><a name="l00731"></a><span class="lineno"> 731</span> </div> -<div class="line"><a name="l00732"></a><span class="lineno"> 732</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> uoffset_t PushElement(Offset<T> off) {</div> -<div class="line"><a name="l00733"></a><span class="lineno"> 733</span>  <span class="comment">// Special case for offsets: see ReferTo below.</span></div> -<div class="line"><a name="l00734"></a><span class="lineno"> 734</span>  <span class="keywordflow">return</span> PushElement(ReferTo(off.o));</div> -<div class="line"><a name="l00735"></a><span class="lineno"> 735</span>  }</div> -<div class="line"><a name="l00736"></a><span class="lineno"> 736</span> </div> -<div class="line"><a name="l00737"></a><span class="lineno"> 737</span>  <span class="comment">// When writing fields, we track where they are, so we can create correct</span></div> -<div class="line"><a name="l00738"></a><span class="lineno"> 738</span>  <span class="comment">// vtables later.</span></div> -<div class="line"><a name="l00739"></a><span class="lineno"> 739</span>  <span class="keywordtype">void</span> TrackField(voffset_t field, uoffset_t off) {</div> -<div class="line"><a name="l00740"></a><span class="lineno"> 740</span>  FieldLoc fl = { off, field };</div> -<div class="line"><a name="l00741"></a><span class="lineno"> 741</span>  offsetbuf_.push_back(fl);</div> -<div class="line"><a name="l00742"></a><span class="lineno"> 742</span>  }</div> -<div class="line"><a name="l00743"></a><span class="lineno"> 743</span> </div> -<div class="line"><a name="l00744"></a><span class="lineno"> 744</span>  <span class="comment">// Like PushElement, but additionally tracks the field this represents.</span></div> -<div class="line"><a name="l00745"></a><span class="lineno"> 745</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">void</span> AddElement(voffset_t field, T e, T def) {</div> -<div class="line"><a name="l00746"></a><span class="lineno"> 746</span>  <span class="comment">// We don't serialize values equal to the default.</span></div> -<div class="line"><a name="l00747"></a><span class="lineno"> 747</span>  <span class="keywordflow">if</span> (e == def && !force_defaults_) <span class="keywordflow">return</span>;</div> -<div class="line"><a name="l00748"></a><span class="lineno"> 748</span>  <span class="keyword">auto</span> off = PushElement(e);</div> -<div class="line"><a name="l00749"></a><span class="lineno"> 749</span>  TrackField(field, off);</div> +<div class="line"><a name="l00706"></a><span class="lineno"> 706</span> <span class="comment"></span></div> +<div class="line"><a name="l00707"></a><span class="lineno"> 707</span> <span class="comment"> /// @cond FLATBUFFERS_INTERNAL</span></div> +<div class="line"><a name="l00708"></a><span class="lineno"> 708</span> <span class="comment"></span> <span class="keywordtype">void</span> Finished()<span class="keyword"> const </span>{</div> +<div class="line"><a name="l00709"></a><span class="lineno"> 709</span>  <span class="comment">// If you get this assert, you're attempting to get access a buffer</span></div> +<div class="line"><a name="l00710"></a><span class="lineno"> 710</span>  <span class="comment">// which hasn't been finished yet. Be sure to call</span></div> +<div class="line"><a name="l00711"></a><span class="lineno"> 711</span>  <span class="comment">// FlatBufferBuilder::Finish with your root table.</span></div> +<div class="line"><a name="l00712"></a><span class="lineno"> 712</span>  <span class="comment">// If you really need to access an unfinished buffer, call</span></div> +<div class="line"><a name="l00713"></a><span class="lineno"> 713</span>  <span class="comment">// GetCurrentBufferPointer instead.</span></div> +<div class="line"><a name="l00714"></a><span class="lineno"> 714</span>  assert(finished);</div> +<div class="line"><a name="l00715"></a><span class="lineno"> 715</span>  }<span class="comment"></span></div> +<div class="line"><a name="l00716"></a><span class="lineno"> 716</span> <span class="comment"> /// @endcond</span></div> +<div class="line"><a name="l00717"></a><span class="lineno"> 717</span> <span class="comment"></span><span class="comment"></span></div> +<div class="line"><a name="l00718"></a><span class="lineno"> 718</span> <span class="comment"> /// @brief In order to save space, fields that are set to their default value</span></div> +<div class="line"><a name="l00719"></a><span class="lineno"> 719</span> <span class="comment"> /// don't get serialized into the buffer.</span></div> +<div class="line"><a name="l00720"></a><span class="lineno"> 720</span> <span class="comment"> /// @param[in] bool fd When set to `true`, always serializes default values.</span></div> +<div class="line"><a name="l00721"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a16a8fd46b34ad7727406c37b65b6b27a"> 721</a></span> <span class="comment"></span> <span class="keywordtype">void</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a16a8fd46b34ad7727406c37b65b6b27a">ForceDefaults</a>(<span class="keywordtype">bool</span> fd) { force_defaults_ = fd; }</div> +<div class="line"><a name="l00722"></a><span class="lineno"> 722</span> <span class="comment"></span></div> +<div class="line"><a name="l00723"></a><span class="lineno"> 723</span> <span class="comment"> /// @cond FLATBUFFERS_INTERNAL</span></div> +<div class="line"><a name="l00724"></a><span class="lineno"> 724</span> <span class="comment"></span> <span class="keywordtype">void</span> Pad(<span class="keywordtype">size_t</span> num_bytes) { buf_.fill(num_bytes); }</div> +<div class="line"><a name="l00725"></a><span class="lineno"> 725</span> </div> +<div class="line"><a name="l00726"></a><span class="lineno"> 726</span>  <span class="keywordtype">void</span> Align(<span class="keywordtype">size_t</span> elem_size) {</div> +<div class="line"><a name="l00727"></a><span class="lineno"> 727</span>  <span class="keywordflow">if</span> (elem_size > minalign_) minalign_ = elem_size;</div> +<div class="line"><a name="l00728"></a><span class="lineno"> 728</span>  buf_.fill(PaddingBytes(buf_.size(), elem_size));</div> +<div class="line"><a name="l00729"></a><span class="lineno"> 729</span>  }</div> +<div class="line"><a name="l00730"></a><span class="lineno"> 730</span> </div> +<div class="line"><a name="l00731"></a><span class="lineno"> 731</span>  <span class="keywordtype">void</span> PushFlatBuffer(<span class="keyword">const</span> uint8_t *bytes, <span class="keywordtype">size_t</span> size) {</div> +<div class="line"><a name="l00732"></a><span class="lineno"> 732</span>  PushBytes(bytes, size);</div> +<div class="line"><a name="l00733"></a><span class="lineno"> 733</span>  finished = <span class="keyword">true</span>;</div> +<div class="line"><a name="l00734"></a><span class="lineno"> 734</span>  }</div> +<div class="line"><a name="l00735"></a><span class="lineno"> 735</span> </div> +<div class="line"><a name="l00736"></a><span class="lineno"> 736</span>  <span class="keywordtype">void</span> PushBytes(<span class="keyword">const</span> uint8_t *bytes, <span class="keywordtype">size_t</span> size) {</div> +<div class="line"><a name="l00737"></a><span class="lineno"> 737</span>  buf_.push(bytes, size);</div> +<div class="line"><a name="l00738"></a><span class="lineno"> 738</span>  }</div> +<div class="line"><a name="l00739"></a><span class="lineno"> 739</span> </div> +<div class="line"><a name="l00740"></a><span class="lineno"> 740</span>  <span class="keywordtype">void</span> PopBytes(<span class="keywordtype">size_t</span> amount) { buf_.pop(amount); }</div> +<div class="line"><a name="l00741"></a><span class="lineno"> 741</span> </div> +<div class="line"><a name="l00742"></a><span class="lineno"> 742</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">void</span> AssertScalarT() {</div> +<div class="line"><a name="l00743"></a><span class="lineno"> 743</span> <span class="preprocessor"> #ifndef FLATBUFFERS_CPP98_STL</span></div> +<div class="line"><a name="l00744"></a><span class="lineno"> 744</span>  <span class="comment">// The code assumes power of 2 sizes and endian-swap-ability.</span></div> +<div class="line"><a name="l00745"></a><span class="lineno"> 745</span>  static_assert(std::is_scalar<T>::value</div> +<div class="line"><a name="l00746"></a><span class="lineno"> 746</span>  <span class="comment">// The Offset<T> type is essentially a scalar but fails is_scalar.</span></div> +<div class="line"><a name="l00747"></a><span class="lineno"> 747</span>  || <span class="keyword">sizeof</span>(T) == <span class="keyword">sizeof</span>(Offset<void>),</div> +<div class="line"><a name="l00748"></a><span class="lineno"> 748</span>  <span class="stringliteral">"T must be a scalar type"</span>);</div> +<div class="line"><a name="l00749"></a><span class="lineno"> 749</span> <span class="preprocessor"> #endif</span></div> <div class="line"><a name="l00750"></a><span class="lineno"> 750</span>  }</div> <div class="line"><a name="l00751"></a><span class="lineno"> 751</span> </div> -<div class="line"><a name="l00752"></a><span class="lineno"> 752</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">void</span> AddOffset(voffset_t field, Offset<T> off) {</div> -<div class="line"><a name="l00753"></a><span class="lineno"> 753</span>  <span class="keywordflow">if</span> (!off.o) <span class="keywordflow">return</span>; <span class="comment">// An offset of 0 means NULL, don't store.</span></div> -<div class="line"><a name="l00754"></a><span class="lineno"> 754</span>  AddElement(field, ReferTo(off.o), static_cast<uoffset_t>(0));</div> -<div class="line"><a name="l00755"></a><span class="lineno"> 755</span>  }</div> -<div class="line"><a name="l00756"></a><span class="lineno"> 756</span> </div> -<div class="line"><a name="l00757"></a><span class="lineno"> 757</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">void</span> AddStruct(voffset_t field, <span class="keyword">const</span> T *structptr) {</div> -<div class="line"><a name="l00758"></a><span class="lineno"> 758</span>  <span class="keywordflow">if</span> (!structptr) <span class="keywordflow">return</span>; <span class="comment">// Default, don't store.</span></div> -<div class="line"><a name="l00759"></a><span class="lineno"> 759</span>  Align(AlignOf<T>());</div> -<div class="line"><a name="l00760"></a><span class="lineno"> 760</span>  PushBytes(reinterpret_cast<const uint8_t *>(structptr), <span class="keyword">sizeof</span>(T));</div> -<div class="line"><a name="l00761"></a><span class="lineno"> 761</span>  TrackField(field, <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>());</div> -<div class="line"><a name="l00762"></a><span class="lineno"> 762</span>  }</div> -<div class="line"><a name="l00763"></a><span class="lineno"> 763</span> </div> -<div class="line"><a name="l00764"></a><span class="lineno"> 764</span>  <span class="keywordtype">void</span> AddStructOffset(voffset_t field, uoffset_t off) {</div> -<div class="line"><a name="l00765"></a><span class="lineno"> 765</span>  TrackField(field, off);</div> -<div class="line"><a name="l00766"></a><span class="lineno"> 766</span>  }</div> -<div class="line"><a name="l00767"></a><span class="lineno"> 767</span> </div> -<div class="line"><a name="l00768"></a><span class="lineno"> 768</span>  <span class="comment">// Offsets initially are relative to the end of the buffer (downwards).</span></div> -<div class="line"><a name="l00769"></a><span class="lineno"> 769</span>  <span class="comment">// This function converts them to be relative to the current location</span></div> -<div class="line"><a name="l00770"></a><span class="lineno"> 770</span>  <span class="comment">// in the buffer (when stored here), pointing upwards.</span></div> -<div class="line"><a name="l00771"></a><span class="lineno"> 771</span>  uoffset_t ReferTo(uoffset_t off) {</div> -<div class="line"><a name="l00772"></a><span class="lineno"> 772</span>  <span class="comment">// Align to ensure GetSize() below is correct.</span></div> -<div class="line"><a name="l00773"></a><span class="lineno"> 773</span>  Align(<span class="keyword">sizeof</span>(uoffset_t));</div> -<div class="line"><a name="l00774"></a><span class="lineno"> 774</span>  <span class="comment">// Offset must refer to something already in buffer.</span></div> -<div class="line"><a name="l00775"></a><span class="lineno"> 775</span>  assert(off && off <= <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>());</div> -<div class="line"><a name="l00776"></a><span class="lineno"> 776</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>() - off + <span class="keyword">static_cast<</span>uoffset_t<span class="keyword">></span>(<span class="keyword">sizeof</span>(uoffset_t));</div> -<div class="line"><a name="l00777"></a><span class="lineno"> 777</span>  }</div> -<div class="line"><a name="l00778"></a><span class="lineno"> 778</span> </div> -<div class="line"><a name="l00779"></a><span class="lineno"> 779</span>  <span class="keywordtype">void</span> NotNested() {</div> -<div class="line"><a name="l00780"></a><span class="lineno"> 780</span>  <span class="comment">// If you hit this, you're trying to construct a Table/Vector/String</span></div> -<div class="line"><a name="l00781"></a><span class="lineno"> 781</span>  <span class="comment">// during the construction of its parent table (between the MyTableBuilder</span></div> -<div class="line"><a name="l00782"></a><span class="lineno"> 782</span>  <span class="comment">// and table.Finish().</span></div> -<div class="line"><a name="l00783"></a><span class="lineno"> 783</span>  <span class="comment">// Move the creation of these sub-objects to above the MyTableBuilder to</span></div> -<div class="line"><a name="l00784"></a><span class="lineno"> 784</span>  <span class="comment">// not get this assert.</span></div> -<div class="line"><a name="l00785"></a><span class="lineno"> 785</span>  <span class="comment">// Ignoring this assert may appear to work in simple cases, but the reason</span></div> -<div class="line"><a name="l00786"></a><span class="lineno"> 786</span>  <span class="comment">// it is here is that storing objects in-line may cause vtable offsets</span></div> -<div class="line"><a name="l00787"></a><span class="lineno"> 787</span>  <span class="comment">// to not fit anymore. It also leads to vtable duplication.</span></div> -<div class="line"><a name="l00788"></a><span class="lineno"> 788</span>  assert(!nested);</div> -<div class="line"><a name="l00789"></a><span class="lineno"> 789</span>  }</div> -<div class="line"><a name="l00790"></a><span class="lineno"> 790</span> </div> -<div class="line"><a name="l00791"></a><span class="lineno"> 791</span>  <span class="comment">// From generated code (or from the parser), we call StartTable/EndTable</span></div> -<div class="line"><a name="l00792"></a><span class="lineno"> 792</span>  <span class="comment">// with a sequence of AddElement calls in between.</span></div> -<div class="line"><a name="l00793"></a><span class="lineno"> 793</span>  uoffset_t StartTable() {</div> -<div class="line"><a name="l00794"></a><span class="lineno"> 794</span>  NotNested();</div> -<div class="line"><a name="l00795"></a><span class="lineno"> 795</span>  nested = <span class="keyword">true</span>;</div> -<div class="line"><a name="l00796"></a><span class="lineno"> 796</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>();</div> -<div class="line"><a name="l00797"></a><span class="lineno"> 797</span>  }</div> -<div class="line"><a name="l00798"></a><span class="lineno"> 798</span> </div> -<div class="line"><a name="l00799"></a><span class="lineno"> 799</span>  <span class="comment">// This finishes one serialized object by generating the vtable if it's a</span></div> -<div class="line"><a name="l00800"></a><span class="lineno"> 800</span>  <span class="comment">// table, comparing it against existing vtables, and writing the</span></div> -<div class="line"><a name="l00801"></a><span class="lineno"> 801</span>  <span class="comment">// resulting vtable offset.</span></div> -<div class="line"><a name="l00802"></a><span class="lineno"> 802</span>  uoffset_t EndTable(uoffset_t start, voffset_t numfields) {</div> -<div class="line"><a name="l00803"></a><span class="lineno"> 803</span>  <span class="comment">// If you get this assert, a corresponding StartTable wasn't called.</span></div> -<div class="line"><a name="l00804"></a><span class="lineno"> 804</span>  assert(nested);</div> -<div class="line"><a name="l00805"></a><span class="lineno"> 805</span>  <span class="comment">// Write the vtable offset, which is the start of any Table.</span></div> -<div class="line"><a name="l00806"></a><span class="lineno"> 806</span>  <span class="comment">// We fill it's value later.</span></div> -<div class="line"><a name="l00807"></a><span class="lineno"> 807</span>  <span class="keyword">auto</span> vtableoffsetloc = PushElement<soffset_t>(0);</div> -<div class="line"><a name="l00808"></a><span class="lineno"> 808</span>  <span class="comment">// Write a vtable, which consists entirely of voffset_t elements.</span></div> -<div class="line"><a name="l00809"></a><span class="lineno"> 809</span>  <span class="comment">// It starts with the number of offsets, followed by a type id, followed</span></div> -<div class="line"><a name="l00810"></a><span class="lineno"> 810</span>  <span class="comment">// by the offsets themselves. In reverse:</span></div> -<div class="line"><a name="l00811"></a><span class="lineno"> 811</span>  buf_.fill(numfields * <span class="keyword">sizeof</span>(voffset_t));</div> -<div class="line"><a name="l00812"></a><span class="lineno"> 812</span>  <span class="keyword">auto</span> table_object_size = vtableoffsetloc - start;</div> -<div class="line"><a name="l00813"></a><span class="lineno"> 813</span>  assert(table_object_size < 0x10000); <span class="comment">// Vtable use 16bit offsets.</span></div> -<div class="line"><a name="l00814"></a><span class="lineno"> 814</span>  PushElement<voffset_t>(<span class="keyword">static_cast<</span>voffset_t<span class="keyword">></span>(table_object_size));</div> -<div class="line"><a name="l00815"></a><span class="lineno"> 815</span>  PushElement<voffset_t>(FieldIndexToOffset(numfields));</div> -<div class="line"><a name="l00816"></a><span class="lineno"> 816</span>  <span class="comment">// Write the offsets into the table</span></div> -<div class="line"><a name="l00817"></a><span class="lineno"> 817</span>  <span class="keywordflow">for</span> (<span class="keyword">auto</span> field_location = offsetbuf_.begin();</div> -<div class="line"><a name="l00818"></a><span class="lineno"> 818</span>  field_location != offsetbuf_.end();</div> -<div class="line"><a name="l00819"></a><span class="lineno"> 819</span>  ++field_location) {</div> -<div class="line"><a name="l00820"></a><span class="lineno"> 820</span>  <span class="keyword">auto</span> pos = <span class="keyword">static_cast<</span>voffset_t<span class="keyword">></span>(vtableoffsetloc - field_location->off);</div> -<div class="line"><a name="l00821"></a><span class="lineno"> 821</span>  <span class="comment">// If this asserts, it means you've set a field twice.</span></div> -<div class="line"><a name="l00822"></a><span class="lineno"> 822</span>  assert(!ReadScalar<voffset_t>(buf_.data() + field_location->id));</div> -<div class="line"><a name="l00823"></a><span class="lineno"> 823</span>  WriteScalar<voffset_t>(buf_.data() + field_location->id, pos);</div> -<div class="line"><a name="l00824"></a><span class="lineno"> 824</span>  }</div> -<div class="line"><a name="l00825"></a><span class="lineno"> 825</span>  offsetbuf_.clear();</div> -<div class="line"><a name="l00826"></a><span class="lineno"> 826</span>  <span class="keyword">auto</span> vt1 = <span class="keyword">reinterpret_cast<</span>voffset_t *<span class="keyword">></span>(buf_.data());</div> -<div class="line"><a name="l00827"></a><span class="lineno"> 827</span>  <span class="keyword">auto</span> vt1_size = ReadScalar<voffset_t>(vt1);</div> -<div class="line"><a name="l00828"></a><span class="lineno"> 828</span>  <span class="keyword">auto</span> vt_use = <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>();</div> -<div class="line"><a name="l00829"></a><span class="lineno"> 829</span>  <span class="comment">// See if we already have generated a vtable with this exact same</span></div> -<div class="line"><a name="l00830"></a><span class="lineno"> 830</span>  <span class="comment">// layout before. If so, make it point to the old one, remove this one.</span></div> -<div class="line"><a name="l00831"></a><span class="lineno"> 831</span>  <span class="keywordflow">for</span> (<span class="keyword">auto</span> it = vtables_.begin(); it != vtables_.end(); ++it) {</div> -<div class="line"><a name="l00832"></a><span class="lineno"> 832</span>  <span class="keyword">auto</span> vt2 = <span class="keyword">reinterpret_cast<</span>voffset_t *<span class="keyword">></span>(buf_.data_at(*it));</div> -<div class="line"><a name="l00833"></a><span class="lineno"> 833</span>  <span class="keyword">auto</span> vt2_size = *vt2;</div> -<div class="line"><a name="l00834"></a><span class="lineno"> 834</span>  <span class="keywordflow">if</span> (vt1_size != vt2_size || memcmp(vt2, vt1, vt1_size)) <span class="keywordflow">continue</span>;</div> -<div class="line"><a name="l00835"></a><span class="lineno"> 835</span>  vt_use = *it;</div> -<div class="line"><a name="l00836"></a><span class="lineno"> 836</span>  buf_.pop(<a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>() - vtableoffsetloc);</div> -<div class="line"><a name="l00837"></a><span class="lineno"> 837</span>  <span class="keywordflow">break</span>;</div> -<div class="line"><a name="l00838"></a><span class="lineno"> 838</span>  }</div> -<div class="line"><a name="l00839"></a><span class="lineno"> 839</span>  <span class="comment">// If this is a new vtable, remember it.</span></div> -<div class="line"><a name="l00840"></a><span class="lineno"> 840</span>  <span class="keywordflow">if</span> (vt_use == <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>()) {</div> -<div class="line"><a name="l00841"></a><span class="lineno"> 841</span>  vtables_.push_back(vt_use);</div> -<div class="line"><a name="l00842"></a><span class="lineno"> 842</span>  }</div> -<div class="line"><a name="l00843"></a><span class="lineno"> 843</span>  <span class="comment">// Fill the vtable offset we created above.</span></div> -<div class="line"><a name="l00844"></a><span class="lineno"> 844</span>  <span class="comment">// The offset points from the beginning of the object to where the</span></div> -<div class="line"><a name="l00845"></a><span class="lineno"> 845</span>  <span class="comment">// vtable is stored.</span></div> -<div class="line"><a name="l00846"></a><span class="lineno"> 846</span>  <span class="comment">// Offsets default direction is downward in memory for future format</span></div> -<div class="line"><a name="l00847"></a><span class="lineno"> 847</span>  <span class="comment">// flexibility (storing all vtables at the start of the file).</span></div> -<div class="line"><a name="l00848"></a><span class="lineno"> 848</span>  WriteScalar(buf_.data_at(vtableoffsetloc),</div> -<div class="line"><a name="l00849"></a><span class="lineno"> 849</span>  <span class="keyword">static_cast<</span>soffset_t<span class="keyword">></span>(vt_use) -</div> -<div class="line"><a name="l00850"></a><span class="lineno"> 850</span>  static_cast<soffset_t>(vtableoffsetloc));</div> -<div class="line"><a name="l00851"></a><span class="lineno"> 851</span> </div> -<div class="line"><a name="l00852"></a><span class="lineno"> 852</span>  nested = <span class="keyword">false</span>;</div> -<div class="line"><a name="l00853"></a><span class="lineno"> 853</span>  <span class="keywordflow">return</span> vtableoffsetloc;</div> -<div class="line"><a name="l00854"></a><span class="lineno"> 854</span>  }</div> -<div class="line"><a name="l00855"></a><span class="lineno"> 855</span> </div> -<div class="line"><a name="l00856"></a><span class="lineno"> 856</span>  <span class="comment">// This checks a required field has been set in a given table that has</span></div> -<div class="line"><a name="l00857"></a><span class="lineno"> 857</span>  <span class="comment">// just been constructed.</span></div> -<div class="line"><a name="l00858"></a><span class="lineno"> 858</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">void</span> Required(Offset<T> table, voffset_t field) {</div> -<div class="line"><a name="l00859"></a><span class="lineno"> 859</span>  <span class="keyword">auto</span> table_ptr = buf_.data_at(table.o);</div> -<div class="line"><a name="l00860"></a><span class="lineno"> 860</span>  <span class="keyword">auto</span> vtable_ptr = table_ptr - ReadScalar<soffset_t>(table_ptr);</div> -<div class="line"><a name="l00861"></a><span class="lineno"> 861</span>  <span class="keywordtype">bool</span> ok = ReadScalar<voffset_t>(vtable_ptr + field) != 0;</div> -<div class="line"><a name="l00862"></a><span class="lineno"> 862</span>  <span class="comment">// If this fails, the caller will show what field needs to be set.</span></div> -<div class="line"><a name="l00863"></a><span class="lineno"> 863</span>  assert(ok);</div> -<div class="line"><a name="l00864"></a><span class="lineno"> 864</span>  (void)ok;</div> -<div class="line"><a name="l00865"></a><span class="lineno"> 865</span>  }</div> -<div class="line"><a name="l00866"></a><span class="lineno"> 866</span> </div> -<div class="line"><a name="l00867"></a><span class="lineno"> 867</span>  uoffset_t StartStruct(<span class="keywordtype">size_t</span> alignment) {</div> -<div class="line"><a name="l00868"></a><span class="lineno"> 868</span>  Align(alignment);</div> -<div class="line"><a name="l00869"></a><span class="lineno"> 869</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>();</div> -<div class="line"><a name="l00870"></a><span class="lineno"> 870</span>  }</div> -<div class="line"><a name="l00871"></a><span class="lineno"> 871</span> </div> -<div class="line"><a name="l00872"></a><span class="lineno"> 872</span>  uoffset_t EndStruct() { <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>(); }</div> -<div class="line"><a name="l00873"></a><span class="lineno"> 873</span> </div> -<div class="line"><a name="l00874"></a><span class="lineno"> 874</span>  <span class="keywordtype">void</span> ClearOffsets() { offsetbuf_.clear(); }</div> -<div class="line"><a name="l00875"></a><span class="lineno"> 875</span> </div> -<div class="line"><a name="l00876"></a><span class="lineno"> 876</span>  <span class="comment">// Aligns such that when "len" bytes are written, an object can be written</span></div> -<div class="line"><a name="l00877"></a><span class="lineno"> 877</span>  <span class="comment">// after it with "alignment" without padding.</span></div> -<div class="line"><a name="l00878"></a><span class="lineno"> 878</span>  <span class="keywordtype">void</span> PreAlign(<span class="keywordtype">size_t</span> len, <span class="keywordtype">size_t</span> alignment) {</div> -<div class="line"><a name="l00879"></a><span class="lineno"> 879</span>  buf_.fill(PaddingBytes(<a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>() + len, alignment));</div> -<div class="line"><a name="l00880"></a><span class="lineno"> 880</span>  }</div> -<div class="line"><a name="l00881"></a><span class="lineno"> 881</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">void</span> PreAlign(<span class="keywordtype">size_t</span> len) {</div> -<div class="line"><a name="l00882"></a><span class="lineno"> 882</span>  AssertScalarT<T>();</div> -<div class="line"><a name="l00883"></a><span class="lineno"> 883</span>  PreAlign(len, <span class="keyword">sizeof</span>(T));</div> -<div class="line"><a name="l00884"></a><span class="lineno"> 884</span>  }<span class="comment"></span></div> -<div class="line"><a name="l00885"></a><span class="lineno"> 885</span> <span class="comment"> /// @endcond</span></div> -<div class="line"><a name="l00886"></a><span class="lineno"> 886</span> <span class="comment"></span><span class="comment"></span></div> -<div class="line"><a name="l00887"></a><span class="lineno"> 887</span> <span class="comment"> /// @brief Store a string in the buffer, which can contain any binary data.</span></div> -<div class="line"><a name="l00888"></a><span class="lineno"> 888</span> <span class="comment"> /// @param[in] str A const char pointer to the data to be stored as a string.</span></div> -<div class="line"><a name="l00889"></a><span class="lineno"> 889</span> <span class="comment"> /// @param[in] len The number of bytes that should be stored from `str`.</span></div> -<div class="line"><a name="l00890"></a><span class="lineno"> 890</span> <span class="comment"> /// @return Returns the offset in the buffer where the string starts.</span></div> -<div class="line"><a name="l00891"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#aec6f9df2a0366b540b24822414d92cbe"> 891</a></span> <span class="comment"></span> Offset<String> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#aec6f9df2a0366b540b24822414d92cbe">CreateString</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *str, <span class="keywordtype">size_t</span> len) {</div> -<div class="line"><a name="l00892"></a><span class="lineno"> 892</span>  NotNested();</div> -<div class="line"><a name="l00893"></a><span class="lineno"> 893</span>  PreAlign<uoffset_t>(len + 1); <span class="comment">// Always 0-terminated.</span></div> -<div class="line"><a name="l00894"></a><span class="lineno"> 894</span>  buf_.fill(1);</div> -<div class="line"><a name="l00895"></a><span class="lineno"> 895</span>  PushBytes(reinterpret_cast<const uint8_t *>(str), len);</div> -<div class="line"><a name="l00896"></a><span class="lineno"> 896</span>  PushElement(static_cast<uoffset_t>(len));</div> -<div class="line"><a name="l00897"></a><span class="lineno"> 897</span>  <span class="keywordflow">return</span> Offset<String>(<a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>());</div> -<div class="line"><a name="l00898"></a><span class="lineno"> 898</span>  }</div> -<div class="line"><a name="l00899"></a><span class="lineno"> 899</span> <span class="comment"></span></div> -<div class="line"><a name="l00900"></a><span class="lineno"> 900</span> <span class="comment"> /// @brief Store a string in the buffer, which is null-terminated.</span></div> -<div class="line"><a name="l00901"></a><span class="lineno"> 901</span> <span class="comment"> /// @param[in] str A const char pointer to a C-string to add to the buffer.</span></div> -<div class="line"><a name="l00902"></a><span class="lineno"> 902</span> <span class="comment"> /// @return Returns the offset in the buffer where the string starts.</span></div> -<div class="line"><a name="l00903"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#aad93d113ac24e86ed04b5236b3f4c0c5"> 903</a></span> <span class="comment"></span> Offset<String> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#aad93d113ac24e86ed04b5236b3f4c0c5">CreateString</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *str) {</div> -<div class="line"><a name="l00904"></a><span class="lineno"> 904</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#aec6f9df2a0366b540b24822414d92cbe">CreateString</a>(str, strlen(str));</div> -<div class="line"><a name="l00905"></a><span class="lineno"> 905</span>  }</div> -<div class="line"><a name="l00906"></a><span class="lineno"> 906</span> <span class="comment"></span></div> -<div class="line"><a name="l00907"></a><span class="lineno"> 907</span> <span class="comment"> /// @brief Store a string in the buffer, which can contain any binary data.</span></div> -<div class="line"><a name="l00908"></a><span class="lineno"> 908</span> <span class="comment"> /// @param[in] str A const reference to a std::string to store in the buffer.</span></div> -<div class="line"><a name="l00909"></a><span class="lineno"> 909</span> <span class="comment"> /// @return Returns the offset in the buffer where the string starts.</span></div> -<div class="line"><a name="l00910"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a8c3af55e64f5cda9aefa38ac5287ef9f"> 910</a></span> <span class="comment"></span> Offset<String> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a8c3af55e64f5cda9aefa38ac5287ef9f">CreateString</a>(<span class="keyword">const</span> std::string &str) {</div> -<div class="line"><a name="l00911"></a><span class="lineno"> 911</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#aec6f9df2a0366b540b24822414d92cbe">CreateString</a>(str.c_str(), str.length());</div> -<div class="line"><a name="l00912"></a><span class="lineno"> 912</span>  }</div> -<div class="line"><a name="l00913"></a><span class="lineno"> 913</span> <span class="comment"></span></div> -<div class="line"><a name="l00914"></a><span class="lineno"> 914</span> <span class="comment"> /// @brief Store a string in the buffer, which can contain any binary data.</span></div> -<div class="line"><a name="l00915"></a><span class="lineno"> 915</span> <span class="comment"> /// @param[in] str A const pointer to a `String` struct to add to the buffer.</span></div> -<div class="line"><a name="l00916"></a><span class="lineno"> 916</span> <span class="comment"> /// @return Returns the offset in the buffer where the string starts</span></div> -<div class="line"><a name="l00917"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#ac0b6a1c5d949f20ad84367fc0f9e1506"> 917</a></span> <span class="comment"></span> Offset<String> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac0b6a1c5d949f20ad84367fc0f9e1506">CreateString</a>(<span class="keyword">const</span> String *str) {</div> -<div class="line"><a name="l00918"></a><span class="lineno"> 918</span>  <span class="keywordflow">return</span> str ? <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#aec6f9df2a0366b540b24822414d92cbe">CreateString</a>(str->c_str(), str->Length()) : 0;</div> -<div class="line"><a name="l00919"></a><span class="lineno"> 919</span>  }</div> -<div class="line"><a name="l00920"></a><span class="lineno"> 920</span> <span class="comment"></span></div> -<div class="line"><a name="l00921"></a><span class="lineno"> 921</span> <span class="comment"> /// @brief Store a string in the buffer, which can contain any binary data.</span></div> -<div class="line"><a name="l00922"></a><span class="lineno"> 922</span> <span class="comment"> /// If a string with this exact contents has already been serialized before,</span></div> -<div class="line"><a name="l00923"></a><span class="lineno"> 923</span> <span class="comment"> /// instead simply returns the offset of the existing string.</span></div> -<div class="line"><a name="l00924"></a><span class="lineno"> 924</span> <span class="comment"> /// @param[in] str A const char pointer to the data to be stored as a string.</span></div> -<div class="line"><a name="l00925"></a><span class="lineno"> 925</span> <span class="comment"> /// @param[in] len The number of bytes that should be stored from `str`.</span></div> -<div class="line"><a name="l00926"></a><span class="lineno"> 926</span> <span class="comment"> /// @return Returns the offset in the buffer where the string starts.</span></div> -<div class="line"><a name="l00927"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#ab478a645216d2d613fc7b7c29b0ff9d1"> 927</a></span> <span class="comment"></span> Offset<String> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ab478a645216d2d613fc7b7c29b0ff9d1">CreateSharedString</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *str, <span class="keywordtype">size_t</span> len) {</div> -<div class="line"><a name="l00928"></a><span class="lineno"> 928</span>  <span class="keywordflow">if</span> (!string_pool)</div> -<div class="line"><a name="l00929"></a><span class="lineno"> 929</span>  string_pool = <span class="keyword">new</span> StringOffsetMap(StringOffsetCompare(buf_));</div> -<div class="line"><a name="l00930"></a><span class="lineno"> 930</span>  <span class="keyword">auto</span> size_before_string = buf_.size();</div> -<div class="line"><a name="l00931"></a><span class="lineno"> 931</span>  <span class="comment">// Must first serialize the string, since the set is all offsets into</span></div> -<div class="line"><a name="l00932"></a><span class="lineno"> 932</span>  <span class="comment">// buffer.</span></div> -<div class="line"><a name="l00933"></a><span class="lineno"> 933</span>  <span class="keyword">auto</span> off = <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#aec6f9df2a0366b540b24822414d92cbe">CreateString</a>(str, len);</div> -<div class="line"><a name="l00934"></a><span class="lineno"> 934</span>  <span class="keyword">auto</span> it = string_pool->find(off);</div> -<div class="line"><a name="l00935"></a><span class="lineno"> 935</span>  <span class="comment">// If it exists we reuse existing serialized data!</span></div> -<div class="line"><a name="l00936"></a><span class="lineno"> 936</span>  <span class="keywordflow">if</span> (it != string_pool->end()) {</div> -<div class="line"><a name="l00937"></a><span class="lineno"> 937</span>  <span class="comment">// We can remove the string we serialized.</span></div> -<div class="line"><a name="l00938"></a><span class="lineno"> 938</span>  buf_.pop(buf_.size() - size_before_string);</div> -<div class="line"><a name="l00939"></a><span class="lineno"> 939</span>  <span class="keywordflow">return</span> *it;</div> -<div class="line"><a name="l00940"></a><span class="lineno"> 940</span>  }</div> -<div class="line"><a name="l00941"></a><span class="lineno"> 941</span>  <span class="comment">// Record this string for future use.</span></div> -<div class="line"><a name="l00942"></a><span class="lineno"> 942</span>  string_pool->insert(off);</div> -<div class="line"><a name="l00943"></a><span class="lineno"> 943</span>  <span class="keywordflow">return</span> off;</div> -<div class="line"><a name="l00944"></a><span class="lineno"> 944</span>  }</div> -<div class="line"><a name="l00945"></a><span class="lineno"> 945</span> <span class="comment"></span></div> -<div class="line"><a name="l00946"></a><span class="lineno"> 946</span> <span class="comment"> /// @brief Store a string in the buffer, which null-terminated.</span></div> -<div class="line"><a name="l00947"></a><span class="lineno"> 947</span> <span class="comment"> /// If a string with this exact contents has already been serialized before,</span></div> -<div class="line"><a name="l00948"></a><span class="lineno"> 948</span> <span class="comment"> /// instead simply returns the offset of the existing string.</span></div> -<div class="line"><a name="l00949"></a><span class="lineno"> 949</span> <span class="comment"> /// @param[in] str A const char pointer to a C-string to add to the buffer.</span></div> -<div class="line"><a name="l00950"></a><span class="lineno"> 950</span> <span class="comment"> /// @return Returns the offset in the buffer where the string starts.</span></div> -<div class="line"><a name="l00951"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a3eb68613e5883dc4b8fff6cf7d1223d7"> 951</a></span> <span class="comment"></span> Offset<String> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a3eb68613e5883dc4b8fff6cf7d1223d7">CreateSharedString</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *str) {</div> -<div class="line"><a name="l00952"></a><span class="lineno"> 952</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ab478a645216d2d613fc7b7c29b0ff9d1">CreateSharedString</a>(str, strlen(str));</div> -<div class="line"><a name="l00953"></a><span class="lineno"> 953</span>  }</div> -<div class="line"><a name="l00954"></a><span class="lineno"> 954</span> <span class="comment"></span></div> -<div class="line"><a name="l00955"></a><span class="lineno"> 955</span> <span class="comment"> /// @brief Store a string in the buffer, which can contain any binary data.</span></div> -<div class="line"><a name="l00956"></a><span class="lineno"> 956</span> <span class="comment"> /// If a string with this exact contents has already been serialized before,</span></div> -<div class="line"><a name="l00957"></a><span class="lineno"> 957</span> <span class="comment"> /// instead simply returns the offset of the existing string.</span></div> -<div class="line"><a name="l00958"></a><span class="lineno"> 958</span> <span class="comment"> /// @param[in] str A const reference to a std::string to store in the buffer.</span></div> -<div class="line"><a name="l00959"></a><span class="lineno"> 959</span> <span class="comment"> /// @return Returns the offset in the buffer where the string starts.</span></div> -<div class="line"><a name="l00960"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a10e8ec7d1c8fbdc21b1c7047bbbe38d9"> 960</a></span> <span class="comment"></span> Offset<String> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a10e8ec7d1c8fbdc21b1c7047bbbe38d9">CreateSharedString</a>(<span class="keyword">const</span> std::string &str) {</div> -<div class="line"><a name="l00961"></a><span class="lineno"> 961</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ab478a645216d2d613fc7b7c29b0ff9d1">CreateSharedString</a>(str.c_str(), str.length());</div> -<div class="line"><a name="l00962"></a><span class="lineno"> 962</span>  }</div> -<div class="line"><a name="l00963"></a><span class="lineno"> 963</span> <span class="comment"></span></div> -<div class="line"><a name="l00964"></a><span class="lineno"> 964</span> <span class="comment"> /// @brief Store a string in the buffer, which can contain any binary data.</span></div> -<div class="line"><a name="l00965"></a><span class="lineno"> 965</span> <span class="comment"> /// If a string with this exact contents has already been serialized before,</span></div> -<div class="line"><a name="l00966"></a><span class="lineno"> 966</span> <span class="comment"> /// instead simply returns the offset of the existing string.</span></div> -<div class="line"><a name="l00967"></a><span class="lineno"> 967</span> <span class="comment"> /// @param[in] str A const pointer to a `String` struct to add to the buffer.</span></div> -<div class="line"><a name="l00968"></a><span class="lineno"> 968</span> <span class="comment"> /// @return Returns the offset in the buffer where the string starts</span></div> -<div class="line"><a name="l00969"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a840b769fbb4148f97d3eed266e4690c3"> 969</a></span> <span class="comment"></span> Offset<String> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a840b769fbb4148f97d3eed266e4690c3">CreateSharedString</a>(<span class="keyword">const</span> String *str) {</div> -<div class="line"><a name="l00970"></a><span class="lineno"> 970</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ab478a645216d2d613fc7b7c29b0ff9d1">CreateSharedString</a>(str->c_str(), str->Length());</div> -<div class="line"><a name="l00971"></a><span class="lineno"> 971</span>  }</div> -<div class="line"><a name="l00972"></a><span class="lineno"> 972</span> <span class="comment"></span></div> -<div class="line"><a name="l00973"></a><span class="lineno"> 973</span> <span class="comment"> /// @cond FLATBUFFERS_INTERNAL</span></div> -<div class="line"><a name="l00974"></a><span class="lineno"> 974</span> <span class="comment"></span> uoffset_t EndVector(<span class="keywordtype">size_t</span> len) {</div> -<div class="line"><a name="l00975"></a><span class="lineno"> 975</span>  assert(nested); <span class="comment">// Hit if no corresponding StartVector.</span></div> -<div class="line"><a name="l00976"></a><span class="lineno"> 976</span>  nested = <span class="keyword">false</span>;</div> -<div class="line"><a name="l00977"></a><span class="lineno"> 977</span>  <span class="keywordflow">return</span> PushElement(static_cast<uoffset_t>(len));</div> -<div class="line"><a name="l00978"></a><span class="lineno"> 978</span>  }</div> -<div class="line"><a name="l00979"></a><span class="lineno"> 979</span> </div> -<div class="line"><a name="l00980"></a><span class="lineno"> 980</span>  <span class="keywordtype">void</span> StartVector(<span class="keywordtype">size_t</span> len, <span class="keywordtype">size_t</span> elemsize) {</div> -<div class="line"><a name="l00981"></a><span class="lineno"> 981</span>  NotNested();</div> -<div class="line"><a name="l00982"></a><span class="lineno"> 982</span>  nested = <span class="keyword">true</span>;</div> -<div class="line"><a name="l00983"></a><span class="lineno"> 983</span>  PreAlign<uoffset_t>(len * elemsize);</div> -<div class="line"><a name="l00984"></a><span class="lineno"> 984</span>  PreAlign(len * elemsize, elemsize); <span class="comment">// Just in case elemsize > uoffset_t.</span></div> -<div class="line"><a name="l00985"></a><span class="lineno"> 985</span>  }</div> -<div class="line"><a name="l00986"></a><span class="lineno"> 986</span> </div> -<div class="line"><a name="l00987"></a><span class="lineno"> 987</span>  <span class="comment">// Call this right before StartVector/CreateVector if you want to force the</span></div> -<div class="line"><a name="l00988"></a><span class="lineno"> 988</span>  <span class="comment">// alignment to be something different than what the element size would</span></div> -<div class="line"><a name="l00989"></a><span class="lineno"> 989</span>  <span class="comment">// normally dictate.</span></div> -<div class="line"><a name="l00990"></a><span class="lineno"> 990</span>  <span class="comment">// This is useful when storing a nested_flatbuffer in a vector of bytes,</span></div> -<div class="line"><a name="l00991"></a><span class="lineno"> 991</span>  <span class="comment">// or when storing SIMD floats, etc.</span></div> -<div class="line"><a name="l00992"></a><span class="lineno"> 992</span>  <span class="keywordtype">void</span> ForceVectorAlignment(<span class="keywordtype">size_t</span> len, <span class="keywordtype">size_t</span> elemsize, <span class="keywordtype">size_t</span> alignment) {</div> -<div class="line"><a name="l00993"></a><span class="lineno"> 993</span>  PreAlign(len * elemsize, alignment);</div> -<div class="line"><a name="l00994"></a><span class="lineno"> 994</span>  }</div> -<div class="line"><a name="l00995"></a><span class="lineno"> 995</span> </div> -<div class="line"><a name="l00996"></a><span class="lineno"> 996</span>  uint8_t *ReserveElements(<span class="keywordtype">size_t</span> len, <span class="keywordtype">size_t</span> elemsize) {</div> -<div class="line"><a name="l00997"></a><span class="lineno"> 997</span>  <span class="keywordflow">return</span> buf_.make_space(len * elemsize);</div> -<div class="line"><a name="l00998"></a><span class="lineno"> 998</span>  }<span class="comment"></span></div> -<div class="line"><a name="l00999"></a><span class="lineno"> 999</span> <span class="comment"> /// @endcond</span></div> -<div class="line"><a name="l01000"></a><span class="lineno"> 1000</span> <span class="comment"></span><span class="comment"></span></div> -<div class="line"><a name="l01001"></a><span class="lineno"> 1001</span> <span class="comment"> /// @brief Serialize an array into a FlatBuffer `vector`.</span></div> -<div class="line"><a name="l01002"></a><span class="lineno"> 1002</span> <span class="comment"> /// @tparam T The data type of the array elements.</span></div> -<div class="line"><a name="l01003"></a><span class="lineno"> 1003</span> <span class="comment"> /// @param[in] v A pointer to the array of type `T` to serialize into the</span></div> -<div class="line"><a name="l01004"></a><span class="lineno"> 1004</span> <span class="comment"> /// buffer as a `vector`.</span></div> -<div class="line"><a name="l01005"></a><span class="lineno"> 1005</span> <span class="comment"> /// @param[in] len The number of elements to serialize.</span></div> -<div class="line"><a name="l01006"></a><span class="lineno"> 1006</span> <span class="comment"> /// @return Returns a typed `Offset` into the serialized data indicating</span></div> -<div class="line"><a name="l01007"></a><span class="lineno"> 1007</span> <span class="comment"> /// where the vector is stored.</span></div> -<div class="line"><a name="l01008"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a2cca5c89246a53e80e6ad9487f4c36f3"> 1008</a></span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T> Offset<Vector<T>> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a2cca5c89246a53e80e6ad9487f4c36f3">CreateVector</a>(<span class="keyword">const</span> T *v, <span class="keywordtype">size_t</span> len) {</div> -<div class="line"><a name="l01009"></a><span class="lineno"> 1009</span>  StartVector(len, <span class="keyword">sizeof</span>(T));</div> -<div class="line"><a name="l01010"></a><span class="lineno"> 1010</span>  <span class="keywordflow">for</span> (<span class="keyword">auto</span> i = len; i > 0; ) {</div> -<div class="line"><a name="l01011"></a><span class="lineno"> 1011</span>  PushElement(v[--i]);</div> -<div class="line"><a name="l01012"></a><span class="lineno"> 1012</span>  }</div> -<div class="line"><a name="l01013"></a><span class="lineno"> 1013</span>  <span class="keywordflow">return</span> Offset<Vector<T>>(EndVector(len));</div> +<div class="line"><a name="l00752"></a><span class="lineno"> 752</span>  <span class="comment">// Write a single aligned scalar to the buffer</span></div> +<div class="line"><a name="l00753"></a><span class="lineno"> 753</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> uoffset_t PushElement(T element) {</div> +<div class="line"><a name="l00754"></a><span class="lineno"> 754</span>  AssertScalarT<T>();</div> +<div class="line"><a name="l00755"></a><span class="lineno"> 755</span>  T litle_endian_element = EndianScalar(element);</div> +<div class="line"><a name="l00756"></a><span class="lineno"> 756</span>  Align(<span class="keyword">sizeof</span>(T));</div> +<div class="line"><a name="l00757"></a><span class="lineno"> 757</span>  PushBytes(reinterpret_cast<uint8_t *>(&litle_endian_element), <span class="keyword">sizeof</span>(T));</div> +<div class="line"><a name="l00758"></a><span class="lineno"> 758</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>();</div> +<div class="line"><a name="l00759"></a><span class="lineno"> 759</span>  }</div> +<div class="line"><a name="l00760"></a><span class="lineno"> 760</span> </div> +<div class="line"><a name="l00761"></a><span class="lineno"> 761</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> uoffset_t PushElement(Offset<T> off) {</div> +<div class="line"><a name="l00762"></a><span class="lineno"> 762</span>  <span class="comment">// Special case for offsets: see ReferTo below.</span></div> +<div class="line"><a name="l00763"></a><span class="lineno"> 763</span>  <span class="keywordflow">return</span> PushElement(ReferTo(off.o));</div> +<div class="line"><a name="l00764"></a><span class="lineno"> 764</span>  }</div> +<div class="line"><a name="l00765"></a><span class="lineno"> 765</span> </div> +<div class="line"><a name="l00766"></a><span class="lineno"> 766</span>  <span class="comment">// When writing fields, we track where they are, so we can create correct</span></div> +<div class="line"><a name="l00767"></a><span class="lineno"> 767</span>  <span class="comment">// vtables later.</span></div> +<div class="line"><a name="l00768"></a><span class="lineno"> 768</span>  <span class="keywordtype">void</span> TrackField(voffset_t field, uoffset_t off) {</div> +<div class="line"><a name="l00769"></a><span class="lineno"> 769</span>  FieldLoc fl = { off, field };</div> +<div class="line"><a name="l00770"></a><span class="lineno"> 770</span>  offsetbuf_.push_back(fl);</div> +<div class="line"><a name="l00771"></a><span class="lineno"> 771</span>  }</div> +<div class="line"><a name="l00772"></a><span class="lineno"> 772</span> </div> +<div class="line"><a name="l00773"></a><span class="lineno"> 773</span>  <span class="comment">// Like PushElement, but additionally tracks the field this represents.</span></div> +<div class="line"><a name="l00774"></a><span class="lineno"> 774</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">void</span> AddElement(voffset_t field, T e, T def) {</div> +<div class="line"><a name="l00775"></a><span class="lineno"> 775</span>  <span class="comment">// We don't serialize values equal to the default.</span></div> +<div class="line"><a name="l00776"></a><span class="lineno"> 776</span>  <span class="keywordflow">if</span> (e == def && !force_defaults_) <span class="keywordflow">return</span>;</div> +<div class="line"><a name="l00777"></a><span class="lineno"> 777</span>  <span class="keyword">auto</span> off = PushElement(e);</div> +<div class="line"><a name="l00778"></a><span class="lineno"> 778</span>  TrackField(field, off);</div> +<div class="line"><a name="l00779"></a><span class="lineno"> 779</span>  }</div> +<div class="line"><a name="l00780"></a><span class="lineno"> 780</span> </div> +<div class="line"><a name="l00781"></a><span class="lineno"> 781</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">void</span> AddOffset(voffset_t field, Offset<T> off) {</div> +<div class="line"><a name="l00782"></a><span class="lineno"> 782</span>  <span class="keywordflow">if</span> (!off.o) <span class="keywordflow">return</span>; <span class="comment">// An offset of 0 means NULL, don't store.</span></div> +<div class="line"><a name="l00783"></a><span class="lineno"> 783</span>  AddElement(field, ReferTo(off.o), static_cast<uoffset_t>(0));</div> +<div class="line"><a name="l00784"></a><span class="lineno"> 784</span>  }</div> +<div class="line"><a name="l00785"></a><span class="lineno"> 785</span> </div> +<div class="line"><a name="l00786"></a><span class="lineno"> 786</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">void</span> AddStruct(voffset_t field, <span class="keyword">const</span> T *structptr) {</div> +<div class="line"><a name="l00787"></a><span class="lineno"> 787</span>  <span class="keywordflow">if</span> (!structptr) <span class="keywordflow">return</span>; <span class="comment">// Default, don't store.</span></div> +<div class="line"><a name="l00788"></a><span class="lineno"> 788</span>  Align(AlignOf<T>());</div> +<div class="line"><a name="l00789"></a><span class="lineno"> 789</span>  PushBytes(reinterpret_cast<const uint8_t *>(structptr), <span class="keyword">sizeof</span>(T));</div> +<div class="line"><a name="l00790"></a><span class="lineno"> 790</span>  TrackField(field, <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>());</div> +<div class="line"><a name="l00791"></a><span class="lineno"> 791</span>  }</div> +<div class="line"><a name="l00792"></a><span class="lineno"> 792</span> </div> +<div class="line"><a name="l00793"></a><span class="lineno"> 793</span>  <span class="keywordtype">void</span> AddStructOffset(voffset_t field, uoffset_t off) {</div> +<div class="line"><a name="l00794"></a><span class="lineno"> 794</span>  TrackField(field, off);</div> +<div class="line"><a name="l00795"></a><span class="lineno"> 795</span>  }</div> +<div class="line"><a name="l00796"></a><span class="lineno"> 796</span> </div> +<div class="line"><a name="l00797"></a><span class="lineno"> 797</span>  <span class="comment">// Offsets initially are relative to the end of the buffer (downwards).</span></div> +<div class="line"><a name="l00798"></a><span class="lineno"> 798</span>  <span class="comment">// This function converts them to be relative to the current location</span></div> +<div class="line"><a name="l00799"></a><span class="lineno"> 799</span>  <span class="comment">// in the buffer (when stored here), pointing upwards.</span></div> +<div class="line"><a name="l00800"></a><span class="lineno"> 800</span>  uoffset_t ReferTo(uoffset_t off) {</div> +<div class="line"><a name="l00801"></a><span class="lineno"> 801</span>  <span class="comment">// Align to ensure GetSize() below is correct.</span></div> +<div class="line"><a name="l00802"></a><span class="lineno"> 802</span>  Align(<span class="keyword">sizeof</span>(uoffset_t));</div> +<div class="line"><a name="l00803"></a><span class="lineno"> 803</span>  <span class="comment">// Offset must refer to something already in buffer.</span></div> +<div class="line"><a name="l00804"></a><span class="lineno"> 804</span>  assert(off && off <= <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>());</div> +<div class="line"><a name="l00805"></a><span class="lineno"> 805</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>() - off + <span class="keyword">static_cast<</span>uoffset_t<span class="keyword">></span>(<span class="keyword">sizeof</span>(uoffset_t));</div> +<div class="line"><a name="l00806"></a><span class="lineno"> 806</span>  }</div> +<div class="line"><a name="l00807"></a><span class="lineno"> 807</span> </div> +<div class="line"><a name="l00808"></a><span class="lineno"> 808</span>  <span class="keywordtype">void</span> NotNested() {</div> +<div class="line"><a name="l00809"></a><span class="lineno"> 809</span>  <span class="comment">// If you hit this, you're trying to construct a Table/Vector/String</span></div> +<div class="line"><a name="l00810"></a><span class="lineno"> 810</span>  <span class="comment">// during the construction of its parent table (between the MyTableBuilder</span></div> +<div class="line"><a name="l00811"></a><span class="lineno"> 811</span>  <span class="comment">// and table.Finish().</span></div> +<div class="line"><a name="l00812"></a><span class="lineno"> 812</span>  <span class="comment">// Move the creation of these sub-objects to above the MyTableBuilder to</span></div> +<div class="line"><a name="l00813"></a><span class="lineno"> 813</span>  <span class="comment">// not get this assert.</span></div> +<div class="line"><a name="l00814"></a><span class="lineno"> 814</span>  <span class="comment">// Ignoring this assert may appear to work in simple cases, but the reason</span></div> +<div class="line"><a name="l00815"></a><span class="lineno"> 815</span>  <span class="comment">// it is here is that storing objects in-line may cause vtable offsets</span></div> +<div class="line"><a name="l00816"></a><span class="lineno"> 816</span>  <span class="comment">// to not fit anymore. It also leads to vtable duplication.</span></div> +<div class="line"><a name="l00817"></a><span class="lineno"> 817</span>  assert(!nested);</div> +<div class="line"><a name="l00818"></a><span class="lineno"> 818</span>  }</div> +<div class="line"><a name="l00819"></a><span class="lineno"> 819</span> </div> +<div class="line"><a name="l00820"></a><span class="lineno"> 820</span>  <span class="comment">// From generated code (or from the parser), we call StartTable/EndTable</span></div> +<div class="line"><a name="l00821"></a><span class="lineno"> 821</span>  <span class="comment">// with a sequence of AddElement calls in between.</span></div> +<div class="line"><a name="l00822"></a><span class="lineno"> 822</span>  uoffset_t StartTable() {</div> +<div class="line"><a name="l00823"></a><span class="lineno"> 823</span>  NotNested();</div> +<div class="line"><a name="l00824"></a><span class="lineno"> 824</span>  nested = <span class="keyword">true</span>;</div> +<div class="line"><a name="l00825"></a><span class="lineno"> 825</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>();</div> +<div class="line"><a name="l00826"></a><span class="lineno"> 826</span>  }</div> +<div class="line"><a name="l00827"></a><span class="lineno"> 827</span> </div> +<div class="line"><a name="l00828"></a><span class="lineno"> 828</span>  <span class="comment">// This finishes one serialized object by generating the vtable if it's a</span></div> +<div class="line"><a name="l00829"></a><span class="lineno"> 829</span>  <span class="comment">// table, comparing it against existing vtables, and writing the</span></div> +<div class="line"><a name="l00830"></a><span class="lineno"> 830</span>  <span class="comment">// resulting vtable offset.</span></div> +<div class="line"><a name="l00831"></a><span class="lineno"> 831</span>  uoffset_t EndTable(uoffset_t start, voffset_t numfields) {</div> +<div class="line"><a name="l00832"></a><span class="lineno"> 832</span>  <span class="comment">// If you get this assert, a corresponding StartTable wasn't called.</span></div> +<div class="line"><a name="l00833"></a><span class="lineno"> 833</span>  assert(nested);</div> +<div class="line"><a name="l00834"></a><span class="lineno"> 834</span>  <span class="comment">// Write the vtable offset, which is the start of any Table.</span></div> +<div class="line"><a name="l00835"></a><span class="lineno"> 835</span>  <span class="comment">// We fill it's value later.</span></div> +<div class="line"><a name="l00836"></a><span class="lineno"> 836</span>  <span class="keyword">auto</span> vtableoffsetloc = PushElement<soffset_t>(0);</div> +<div class="line"><a name="l00837"></a><span class="lineno"> 837</span>  <span class="comment">// Write a vtable, which consists entirely of voffset_t elements.</span></div> +<div class="line"><a name="l00838"></a><span class="lineno"> 838</span>  <span class="comment">// It starts with the number of offsets, followed by a type id, followed</span></div> +<div class="line"><a name="l00839"></a><span class="lineno"> 839</span>  <span class="comment">// by the offsets themselves. In reverse:</span></div> +<div class="line"><a name="l00840"></a><span class="lineno"> 840</span>  buf_.fill(numfields * <span class="keyword">sizeof</span>(voffset_t));</div> +<div class="line"><a name="l00841"></a><span class="lineno"> 841</span>  <span class="keyword">auto</span> table_object_size = vtableoffsetloc - start;</div> +<div class="line"><a name="l00842"></a><span class="lineno"> 842</span>  assert(table_object_size < 0x10000); <span class="comment">// Vtable use 16bit offsets.</span></div> +<div class="line"><a name="l00843"></a><span class="lineno"> 843</span>  PushElement<voffset_t>(<span class="keyword">static_cast<</span>voffset_t<span class="keyword">></span>(table_object_size));</div> +<div class="line"><a name="l00844"></a><span class="lineno"> 844</span>  PushElement<voffset_t>(FieldIndexToOffset(numfields));</div> +<div class="line"><a name="l00845"></a><span class="lineno"> 845</span>  <span class="comment">// Write the offsets into the table</span></div> +<div class="line"><a name="l00846"></a><span class="lineno"> 846</span>  <span class="keywordflow">for</span> (<span class="keyword">auto</span> field_location = offsetbuf_.begin();</div> +<div class="line"><a name="l00847"></a><span class="lineno"> 847</span>  field_location != offsetbuf_.end();</div> +<div class="line"><a name="l00848"></a><span class="lineno"> 848</span>  ++field_location) {</div> +<div class="line"><a name="l00849"></a><span class="lineno"> 849</span>  <span class="keyword">auto</span> pos = <span class="keyword">static_cast<</span>voffset_t<span class="keyword">></span>(vtableoffsetloc - field_location->off);</div> +<div class="line"><a name="l00850"></a><span class="lineno"> 850</span>  <span class="comment">// If this asserts, it means you've set a field twice.</span></div> +<div class="line"><a name="l00851"></a><span class="lineno"> 851</span>  assert(!ReadScalar<voffset_t>(buf_.data() + field_location->id));</div> +<div class="line"><a name="l00852"></a><span class="lineno"> 852</span>  WriteScalar<voffset_t>(buf_.data() + field_location->id, pos);</div> +<div class="line"><a name="l00853"></a><span class="lineno"> 853</span>  }</div> +<div class="line"><a name="l00854"></a><span class="lineno"> 854</span>  offsetbuf_.clear();</div> +<div class="line"><a name="l00855"></a><span class="lineno"> 855</span>  <span class="keyword">auto</span> vt1 = <span class="keyword">reinterpret_cast<</span>voffset_t *<span class="keyword">></span>(buf_.data());</div> +<div class="line"><a name="l00856"></a><span class="lineno"> 856</span>  <span class="keyword">auto</span> vt1_size = ReadScalar<voffset_t>(vt1);</div> +<div class="line"><a name="l00857"></a><span class="lineno"> 857</span>  <span class="keyword">auto</span> vt_use = <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>();</div> +<div class="line"><a name="l00858"></a><span class="lineno"> 858</span>  <span class="comment">// See if we already have generated a vtable with this exact same</span></div> +<div class="line"><a name="l00859"></a><span class="lineno"> 859</span>  <span class="comment">// layout before. If so, make it point to the old one, remove this one.</span></div> +<div class="line"><a name="l00860"></a><span class="lineno"> 860</span>  <span class="keywordflow">for</span> (<span class="keyword">auto</span> it = vtables_.begin(); it != vtables_.end(); ++it) {</div> +<div class="line"><a name="l00861"></a><span class="lineno"> 861</span>  <span class="keyword">auto</span> vt2 = <span class="keyword">reinterpret_cast<</span>voffset_t *<span class="keyword">></span>(buf_.data_at(*it));</div> +<div class="line"><a name="l00862"></a><span class="lineno"> 862</span>  <span class="keyword">auto</span> vt2_size = *vt2;</div> +<div class="line"><a name="l00863"></a><span class="lineno"> 863</span>  <span class="keywordflow">if</span> (vt1_size != vt2_size || memcmp(vt2, vt1, vt1_size)) <span class="keywordflow">continue</span>;</div> +<div class="line"><a name="l00864"></a><span class="lineno"> 864</span>  vt_use = *it;</div> +<div class="line"><a name="l00865"></a><span class="lineno"> 865</span>  buf_.pop(<a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>() - vtableoffsetloc);</div> +<div class="line"><a name="l00866"></a><span class="lineno"> 866</span>  <span class="keywordflow">break</span>;</div> +<div class="line"><a name="l00867"></a><span class="lineno"> 867</span>  }</div> +<div class="line"><a name="l00868"></a><span class="lineno"> 868</span>  <span class="comment">// If this is a new vtable, remember it.</span></div> +<div class="line"><a name="l00869"></a><span class="lineno"> 869</span>  <span class="keywordflow">if</span> (vt_use == <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>()) {</div> +<div class="line"><a name="l00870"></a><span class="lineno"> 870</span>  vtables_.push_back(vt_use);</div> +<div class="line"><a name="l00871"></a><span class="lineno"> 871</span>  }</div> +<div class="line"><a name="l00872"></a><span class="lineno"> 872</span>  <span class="comment">// Fill the vtable offset we created above.</span></div> +<div class="line"><a name="l00873"></a><span class="lineno"> 873</span>  <span class="comment">// The offset points from the beginning of the object to where the</span></div> +<div class="line"><a name="l00874"></a><span class="lineno"> 874</span>  <span class="comment">// vtable is stored.</span></div> +<div class="line"><a name="l00875"></a><span class="lineno"> 875</span>  <span class="comment">// Offsets default direction is downward in memory for future format</span></div> +<div class="line"><a name="l00876"></a><span class="lineno"> 876</span>  <span class="comment">// flexibility (storing all vtables at the start of the file).</span></div> +<div class="line"><a name="l00877"></a><span class="lineno"> 877</span>  WriteScalar(buf_.data_at(vtableoffsetloc),</div> +<div class="line"><a name="l00878"></a><span class="lineno"> 878</span>  <span class="keyword">static_cast<</span>soffset_t<span class="keyword">></span>(vt_use) -</div> +<div class="line"><a name="l00879"></a><span class="lineno"> 879</span>  static_cast<soffset_t>(vtableoffsetloc));</div> +<div class="line"><a name="l00880"></a><span class="lineno"> 880</span> </div> +<div class="line"><a name="l00881"></a><span class="lineno"> 881</span>  nested = <span class="keyword">false</span>;</div> +<div class="line"><a name="l00882"></a><span class="lineno"> 882</span>  <span class="keywordflow">return</span> vtableoffsetloc;</div> +<div class="line"><a name="l00883"></a><span class="lineno"> 883</span>  }</div> +<div class="line"><a name="l00884"></a><span class="lineno"> 884</span> </div> +<div class="line"><a name="l00885"></a><span class="lineno"> 885</span>  <span class="comment">// This checks a required field has been set in a given table that has</span></div> +<div class="line"><a name="l00886"></a><span class="lineno"> 886</span>  <span class="comment">// just been constructed.</span></div> +<div class="line"><a name="l00887"></a><span class="lineno"> 887</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">void</span> Required(Offset<T> table, voffset_t field) {</div> +<div class="line"><a name="l00888"></a><span class="lineno"> 888</span>  <span class="keyword">auto</span> table_ptr = buf_.data_at(table.o);</div> +<div class="line"><a name="l00889"></a><span class="lineno"> 889</span>  <span class="keyword">auto</span> vtable_ptr = table_ptr - ReadScalar<soffset_t>(table_ptr);</div> +<div class="line"><a name="l00890"></a><span class="lineno"> 890</span>  <span class="keywordtype">bool</span> ok = ReadScalar<voffset_t>(vtable_ptr + field) != 0;</div> +<div class="line"><a name="l00891"></a><span class="lineno"> 891</span>  <span class="comment">// If this fails, the caller will show what field needs to be set.</span></div> +<div class="line"><a name="l00892"></a><span class="lineno"> 892</span>  assert(ok);</div> +<div class="line"><a name="l00893"></a><span class="lineno"> 893</span>  (void)ok;</div> +<div class="line"><a name="l00894"></a><span class="lineno"> 894</span>  }</div> +<div class="line"><a name="l00895"></a><span class="lineno"> 895</span> </div> +<div class="line"><a name="l00896"></a><span class="lineno"> 896</span>  uoffset_t StartStruct(<span class="keywordtype">size_t</span> alignment) {</div> +<div class="line"><a name="l00897"></a><span class="lineno"> 897</span>  Align(alignment);</div> +<div class="line"><a name="l00898"></a><span class="lineno"> 898</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>();</div> +<div class="line"><a name="l00899"></a><span class="lineno"> 899</span>  }</div> +<div class="line"><a name="l00900"></a><span class="lineno"> 900</span> </div> +<div class="line"><a name="l00901"></a><span class="lineno"> 901</span>  uoffset_t EndStruct() { <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>(); }</div> +<div class="line"><a name="l00902"></a><span class="lineno"> 902</span> </div> +<div class="line"><a name="l00903"></a><span class="lineno"> 903</span>  <span class="keywordtype">void</span> ClearOffsets() { offsetbuf_.clear(); }</div> +<div class="line"><a name="l00904"></a><span class="lineno"> 904</span> </div> +<div class="line"><a name="l00905"></a><span class="lineno"> 905</span>  <span class="comment">// Aligns such that when "len" bytes are written, an object can be written</span></div> +<div class="line"><a name="l00906"></a><span class="lineno"> 906</span>  <span class="comment">// after it with "alignment" without padding.</span></div> +<div class="line"><a name="l00907"></a><span class="lineno"> 907</span>  <span class="keywordtype">void</span> PreAlign(<span class="keywordtype">size_t</span> len, <span class="keywordtype">size_t</span> alignment) {</div> +<div class="line"><a name="l00908"></a><span class="lineno"> 908</span>  buf_.fill(PaddingBytes(<a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>() + len, alignment));</div> +<div class="line"><a name="l00909"></a><span class="lineno"> 909</span>  }</div> +<div class="line"><a name="l00910"></a><span class="lineno"> 910</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">void</span> PreAlign(<span class="keywordtype">size_t</span> len) {</div> +<div class="line"><a name="l00911"></a><span class="lineno"> 911</span>  AssertScalarT<T>();</div> +<div class="line"><a name="l00912"></a><span class="lineno"> 912</span>  PreAlign(len, <span class="keyword">sizeof</span>(T));</div> +<div class="line"><a name="l00913"></a><span class="lineno"> 913</span>  }<span class="comment"></span></div> +<div class="line"><a name="l00914"></a><span class="lineno"> 914</span> <span class="comment"> /// @endcond</span></div> +<div class="line"><a name="l00915"></a><span class="lineno"> 915</span> <span class="comment"></span><span class="comment"></span></div> +<div class="line"><a name="l00916"></a><span class="lineno"> 916</span> <span class="comment"> /// @brief Store a string in the buffer, which can contain any binary data.</span></div> +<div class="line"><a name="l00917"></a><span class="lineno"> 917</span> <span class="comment"> /// @param[in] str A const char pointer to the data to be stored as a string.</span></div> +<div class="line"><a name="l00918"></a><span class="lineno"> 918</span> <span class="comment"> /// @param[in] len The number of bytes that should be stored from `str`.</span></div> +<div class="line"><a name="l00919"></a><span class="lineno"> 919</span> <span class="comment"> /// @return Returns the offset in the buffer where the string starts.</span></div> +<div class="line"><a name="l00920"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#aec6f9df2a0366b540b24822414d92cbe"> 920</a></span> <span class="comment"></span> Offset<String> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#aec6f9df2a0366b540b24822414d92cbe">CreateString</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *str, <span class="keywordtype">size_t</span> len) {</div> +<div class="line"><a name="l00921"></a><span class="lineno"> 921</span>  NotNested();</div> +<div class="line"><a name="l00922"></a><span class="lineno"> 922</span>  PreAlign<uoffset_t>(len + 1); <span class="comment">// Always 0-terminated.</span></div> +<div class="line"><a name="l00923"></a><span class="lineno"> 923</span>  buf_.fill(1);</div> +<div class="line"><a name="l00924"></a><span class="lineno"> 924</span>  PushBytes(reinterpret_cast<const uint8_t *>(str), len);</div> +<div class="line"><a name="l00925"></a><span class="lineno"> 925</span>  PushElement(static_cast<uoffset_t>(len));</div> +<div class="line"><a name="l00926"></a><span class="lineno"> 926</span>  <span class="keywordflow">return</span> Offset<String>(<a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>());</div> +<div class="line"><a name="l00927"></a><span class="lineno"> 927</span>  }</div> +<div class="line"><a name="l00928"></a><span class="lineno"> 928</span> <span class="comment"></span></div> +<div class="line"><a name="l00929"></a><span class="lineno"> 929</span> <span class="comment"> /// @brief Store a string in the buffer, which is null-terminated.</span></div> +<div class="line"><a name="l00930"></a><span class="lineno"> 930</span> <span class="comment"> /// @param[in] str A const char pointer to a C-string to add to the buffer.</span></div> +<div class="line"><a name="l00931"></a><span class="lineno"> 931</span> <span class="comment"> /// @return Returns the offset in the buffer where the string starts.</span></div> +<div class="line"><a name="l00932"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#aad93d113ac24e86ed04b5236b3f4c0c5"> 932</a></span> <span class="comment"></span> Offset<String> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#aad93d113ac24e86ed04b5236b3f4c0c5">CreateString</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *str) {</div> +<div class="line"><a name="l00933"></a><span class="lineno"> 933</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#aec6f9df2a0366b540b24822414d92cbe">CreateString</a>(str, strlen(str));</div> +<div class="line"><a name="l00934"></a><span class="lineno"> 934</span>  }</div> +<div class="line"><a name="l00935"></a><span class="lineno"> 935</span> <span class="comment"></span></div> +<div class="line"><a name="l00936"></a><span class="lineno"> 936</span> <span class="comment"> /// @brief Store a string in the buffer, which can contain any binary data.</span></div> +<div class="line"><a name="l00937"></a><span class="lineno"> 937</span> <span class="comment"> /// @param[in] str A const reference to a std::string to store in the buffer.</span></div> +<div class="line"><a name="l00938"></a><span class="lineno"> 938</span> <span class="comment"> /// @return Returns the offset in the buffer where the string starts.</span></div> +<div class="line"><a name="l00939"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a8c3af55e64f5cda9aefa38ac5287ef9f"> 939</a></span> <span class="comment"></span> Offset<String> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a8c3af55e64f5cda9aefa38ac5287ef9f">CreateString</a>(<span class="keyword">const</span> std::string &str) {</div> +<div class="line"><a name="l00940"></a><span class="lineno"> 940</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#aec6f9df2a0366b540b24822414d92cbe">CreateString</a>(str.c_str(), str.length());</div> +<div class="line"><a name="l00941"></a><span class="lineno"> 941</span>  }</div> +<div class="line"><a name="l00942"></a><span class="lineno"> 942</span> <span class="comment"></span></div> +<div class="line"><a name="l00943"></a><span class="lineno"> 943</span> <span class="comment"> /// @brief Store a string in the buffer, which can contain any binary data.</span></div> +<div class="line"><a name="l00944"></a><span class="lineno"> 944</span> <span class="comment"> /// @param[in] str A const pointer to a `String` struct to add to the buffer.</span></div> +<div class="line"><a name="l00945"></a><span class="lineno"> 945</span> <span class="comment"> /// @return Returns the offset in the buffer where the string starts</span></div> +<div class="line"><a name="l00946"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#ac0b6a1c5d949f20ad84367fc0f9e1506"> 946</a></span> <span class="comment"></span> Offset<String> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac0b6a1c5d949f20ad84367fc0f9e1506">CreateString</a>(<span class="keyword">const</span> String *str) {</div> +<div class="line"><a name="l00947"></a><span class="lineno"> 947</span>  <span class="keywordflow">return</span> str ? <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#aec6f9df2a0366b540b24822414d92cbe">CreateString</a>(str->c_str(), str->Length()) : 0;</div> +<div class="line"><a name="l00948"></a><span class="lineno"> 948</span>  }</div> +<div class="line"><a name="l00949"></a><span class="lineno"> 949</span> <span class="comment"></span></div> +<div class="line"><a name="l00950"></a><span class="lineno"> 950</span> <span class="comment"> /// @brief Store a string in the buffer, which can contain any binary data.</span></div> +<div class="line"><a name="l00951"></a><span class="lineno"> 951</span> <span class="comment"> /// If a string with this exact contents has already been serialized before,</span></div> +<div class="line"><a name="l00952"></a><span class="lineno"> 952</span> <span class="comment"> /// instead simply returns the offset of the existing string.</span></div> +<div class="line"><a name="l00953"></a><span class="lineno"> 953</span> <span class="comment"> /// @param[in] str A const char pointer to the data to be stored as a string.</span></div> +<div class="line"><a name="l00954"></a><span class="lineno"> 954</span> <span class="comment"> /// @param[in] len The number of bytes that should be stored from `str`.</span></div> +<div class="line"><a name="l00955"></a><span class="lineno"> 955</span> <span class="comment"> /// @return Returns the offset in the buffer where the string starts.</span></div> +<div class="line"><a name="l00956"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#ab478a645216d2d613fc7b7c29b0ff9d1"> 956</a></span> <span class="comment"></span> Offset<String> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ab478a645216d2d613fc7b7c29b0ff9d1">CreateSharedString</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *str, <span class="keywordtype">size_t</span> len) {</div> +<div class="line"><a name="l00957"></a><span class="lineno"> 957</span>  <span class="keywordflow">if</span> (!string_pool)</div> +<div class="line"><a name="l00958"></a><span class="lineno"> 958</span>  string_pool = <span class="keyword">new</span> StringOffsetMap(StringOffsetCompare(buf_));</div> +<div class="line"><a name="l00959"></a><span class="lineno"> 959</span>  <span class="keyword">auto</span> size_before_string = buf_.size();</div> +<div class="line"><a name="l00960"></a><span class="lineno"> 960</span>  <span class="comment">// Must first serialize the string, since the set is all offsets into</span></div> +<div class="line"><a name="l00961"></a><span class="lineno"> 961</span>  <span class="comment">// buffer.</span></div> +<div class="line"><a name="l00962"></a><span class="lineno"> 962</span>  <span class="keyword">auto</span> off = <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#aec6f9df2a0366b540b24822414d92cbe">CreateString</a>(str, len);</div> +<div class="line"><a name="l00963"></a><span class="lineno"> 963</span>  <span class="keyword">auto</span> it = string_pool->find(off);</div> +<div class="line"><a name="l00964"></a><span class="lineno"> 964</span>  <span class="comment">// If it exists we reuse existing serialized data!</span></div> +<div class="line"><a name="l00965"></a><span class="lineno"> 965</span>  <span class="keywordflow">if</span> (it != string_pool->end()) {</div> +<div class="line"><a name="l00966"></a><span class="lineno"> 966</span>  <span class="comment">// We can remove the string we serialized.</span></div> +<div class="line"><a name="l00967"></a><span class="lineno"> 967</span>  buf_.pop(buf_.size() - size_before_string);</div> +<div class="line"><a name="l00968"></a><span class="lineno"> 968</span>  <span class="keywordflow">return</span> *it;</div> +<div class="line"><a name="l00969"></a><span class="lineno"> 969</span>  }</div> +<div class="line"><a name="l00970"></a><span class="lineno"> 970</span>  <span class="comment">// Record this string for future use.</span></div> +<div class="line"><a name="l00971"></a><span class="lineno"> 971</span>  string_pool->insert(off);</div> +<div class="line"><a name="l00972"></a><span class="lineno"> 972</span>  <span class="keywordflow">return</span> off;</div> +<div class="line"><a name="l00973"></a><span class="lineno"> 973</span>  }</div> +<div class="line"><a name="l00974"></a><span class="lineno"> 974</span> <span class="comment"></span></div> +<div class="line"><a name="l00975"></a><span class="lineno"> 975</span> <span class="comment"> /// @brief Store a string in the buffer, which null-terminated.</span></div> +<div class="line"><a name="l00976"></a><span class="lineno"> 976</span> <span class="comment"> /// If a string with this exact contents has already been serialized before,</span></div> +<div class="line"><a name="l00977"></a><span class="lineno"> 977</span> <span class="comment"> /// instead simply returns the offset of the existing string.</span></div> +<div class="line"><a name="l00978"></a><span class="lineno"> 978</span> <span class="comment"> /// @param[in] str A const char pointer to a C-string to add to the buffer.</span></div> +<div class="line"><a name="l00979"></a><span class="lineno"> 979</span> <span class="comment"> /// @return Returns the offset in the buffer where the string starts.</span></div> +<div class="line"><a name="l00980"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a3eb68613e5883dc4b8fff6cf7d1223d7"> 980</a></span> <span class="comment"></span> Offset<String> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a3eb68613e5883dc4b8fff6cf7d1223d7">CreateSharedString</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *str) {</div> +<div class="line"><a name="l00981"></a><span class="lineno"> 981</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ab478a645216d2d613fc7b7c29b0ff9d1">CreateSharedString</a>(str, strlen(str));</div> +<div class="line"><a name="l00982"></a><span class="lineno"> 982</span>  }</div> +<div class="line"><a name="l00983"></a><span class="lineno"> 983</span> <span class="comment"></span></div> +<div class="line"><a name="l00984"></a><span class="lineno"> 984</span> <span class="comment"> /// @brief Store a string in the buffer, which can contain any binary data.</span></div> +<div class="line"><a name="l00985"></a><span class="lineno"> 985</span> <span class="comment"> /// If a string with this exact contents has already been serialized before,</span></div> +<div class="line"><a name="l00986"></a><span class="lineno"> 986</span> <span class="comment"> /// instead simply returns the offset of the existing string.</span></div> +<div class="line"><a name="l00987"></a><span class="lineno"> 987</span> <span class="comment"> /// @param[in] str A const reference to a std::string to store in the buffer.</span></div> +<div class="line"><a name="l00988"></a><span class="lineno"> 988</span> <span class="comment"> /// @return Returns the offset in the buffer where the string starts.</span></div> +<div class="line"><a name="l00989"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a10e8ec7d1c8fbdc21b1c7047bbbe38d9"> 989</a></span> <span class="comment"></span> Offset<String> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a10e8ec7d1c8fbdc21b1c7047bbbe38d9">CreateSharedString</a>(<span class="keyword">const</span> std::string &str) {</div> +<div class="line"><a name="l00990"></a><span class="lineno"> 990</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ab478a645216d2d613fc7b7c29b0ff9d1">CreateSharedString</a>(str.c_str(), str.length());</div> +<div class="line"><a name="l00991"></a><span class="lineno"> 991</span>  }</div> +<div class="line"><a name="l00992"></a><span class="lineno"> 992</span> <span class="comment"></span></div> +<div class="line"><a name="l00993"></a><span class="lineno"> 993</span> <span class="comment"> /// @brief Store a string in the buffer, which can contain any binary data.</span></div> +<div class="line"><a name="l00994"></a><span class="lineno"> 994</span> <span class="comment"> /// If a string with this exact contents has already been serialized before,</span></div> +<div class="line"><a name="l00995"></a><span class="lineno"> 995</span> <span class="comment"> /// instead simply returns the offset of the existing string.</span></div> +<div class="line"><a name="l00996"></a><span class="lineno"> 996</span> <span class="comment"> /// @param[in] str A const pointer to a `String` struct to add to the buffer.</span></div> +<div class="line"><a name="l00997"></a><span class="lineno"> 997</span> <span class="comment"> /// @return Returns the offset in the buffer where the string starts</span></div> +<div class="line"><a name="l00998"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a840b769fbb4148f97d3eed266e4690c3"> 998</a></span> <span class="comment"></span> Offset<String> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a840b769fbb4148f97d3eed266e4690c3">CreateSharedString</a>(<span class="keyword">const</span> String *str) {</div> +<div class="line"><a name="l00999"></a><span class="lineno"> 999</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ab478a645216d2d613fc7b7c29b0ff9d1">CreateSharedString</a>(str->c_str(), str->Length());</div> +<div class="line"><a name="l01000"></a><span class="lineno"> 1000</span>  }</div> +<div class="line"><a name="l01001"></a><span class="lineno"> 1001</span> <span class="comment"></span></div> +<div class="line"><a name="l01002"></a><span class="lineno"> 1002</span> <span class="comment"> /// @cond FLATBUFFERS_INTERNAL</span></div> +<div class="line"><a name="l01003"></a><span class="lineno"> 1003</span> <span class="comment"></span> uoffset_t EndVector(<span class="keywordtype">size_t</span> len) {</div> +<div class="line"><a name="l01004"></a><span class="lineno"> 1004</span>  assert(nested); <span class="comment">// Hit if no corresponding StartVector.</span></div> +<div class="line"><a name="l01005"></a><span class="lineno"> 1005</span>  nested = <span class="keyword">false</span>;</div> +<div class="line"><a name="l01006"></a><span class="lineno"> 1006</span>  <span class="keywordflow">return</span> PushElement(static_cast<uoffset_t>(len));</div> +<div class="line"><a name="l01007"></a><span class="lineno"> 1007</span>  }</div> +<div class="line"><a name="l01008"></a><span class="lineno"> 1008</span> </div> +<div class="line"><a name="l01009"></a><span class="lineno"> 1009</span>  <span class="keywordtype">void</span> StartVector(<span class="keywordtype">size_t</span> len, <span class="keywordtype">size_t</span> elemsize) {</div> +<div class="line"><a name="l01010"></a><span class="lineno"> 1010</span>  NotNested();</div> +<div class="line"><a name="l01011"></a><span class="lineno"> 1011</span>  nested = <span class="keyword">true</span>;</div> +<div class="line"><a name="l01012"></a><span class="lineno"> 1012</span>  PreAlign<uoffset_t>(len * elemsize);</div> +<div class="line"><a name="l01013"></a><span class="lineno"> 1013</span>  PreAlign(len * elemsize, elemsize); <span class="comment">// Just in case elemsize > uoffset_t.</span></div> <div class="line"><a name="l01014"></a><span class="lineno"> 1014</span>  }</div> -<div class="line"><a name="l01015"></a><span class="lineno"> 1015</span> <span class="comment"></span></div> -<div class="line"><a name="l01016"></a><span class="lineno"> 1016</span> <span class="comment"> /// @brief Serialize a `std::vector` into a FlatBuffer `vector`.</span></div> -<div class="line"><a name="l01017"></a><span class="lineno"> 1017</span> <span class="comment"> /// @tparam T The data type of the `std::vector` elements.</span></div> -<div class="line"><a name="l01018"></a><span class="lineno"> 1018</span> <span class="comment"> /// @param v A const reference to the `std::vector` to serialize into the</span></div> -<div class="line"><a name="l01019"></a><span class="lineno"> 1019</span> <span class="comment"> /// buffer as a `vector`.</span></div> -<div class="line"><a name="l01020"></a><span class="lineno"> 1020</span> <span class="comment"> /// @return Returns a typed `Offset` into the serialized data indicating</span></div> -<div class="line"><a name="l01021"></a><span class="lineno"> 1021</span> <span class="comment"> /// where the vector is stored.</span></div> -<div class="line"><a name="l01022"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#af715dd24dd37cb0151dc7a980ad0f207"> 1022</a></span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T> Offset<Vector<T>> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#af715dd24dd37cb0151dc7a980ad0f207">CreateVector</a>(<span class="keyword">const</span> std::vector<T> &v) {</div> -<div class="line"><a name="l01023"></a><span class="lineno"> 1023</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a2cca5c89246a53e80e6ad9487f4c36f3">CreateVector</a>(data(v), v.size());</div> -<div class="line"><a name="l01024"></a><span class="lineno"> 1024</span>  }</div> -<div class="line"><a name="l01025"></a><span class="lineno"> 1025</span> </div> -<div class="line"><a name="l01026"></a><span class="lineno"> 1026</span>  <span class="comment">// vector<bool> may be implemented using a bit-set, so we can't access it as</span></div> -<div class="line"><a name="l01027"></a><span class="lineno"> 1027</span>  <span class="comment">// an array. Instead, read elements manually.</span></div> -<div class="line"><a name="l01028"></a><span class="lineno"> 1028</span>  <span class="comment">// Background: https://isocpp.org/blog/2012/11/on-vectorbool</span></div> -<div class="line"><a name="l01029"></a><span class="lineno"> 1029</span>  Offset<Vector<uint8_t>> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a2cca5c89246a53e80e6ad9487f4c36f3">CreateVector</a>(<span class="keyword">const</span> std::vector<bool> &v) {</div> -<div class="line"><a name="l01030"></a><span class="lineno"> 1030</span>  StartVector(v.size(), <span class="keyword">sizeof</span>(uint8_t));</div> -<div class="line"><a name="l01031"></a><span class="lineno"> 1031</span>  <span class="keywordflow">for</span> (<span class="keyword">auto</span> i = v.size(); i > 0; ) {</div> -<div class="line"><a name="l01032"></a><span class="lineno"> 1032</span>  PushElement(static_cast<uint8_t>(v[--i]));</div> -<div class="line"><a name="l01033"></a><span class="lineno"> 1033</span>  }</div> -<div class="line"><a name="l01034"></a><span class="lineno"> 1034</span>  <span class="keywordflow">return</span> Offset<Vector<uint8_t>>(EndVector(v.size()));</div> -<div class="line"><a name="l01035"></a><span class="lineno"> 1035</span>  }</div> -<div class="line"><a name="l01036"></a><span class="lineno"> 1036</span> </div> -<div class="line"><a name="l01037"></a><span class="lineno"> 1037</span> <span class="preprocessor"> #ifndef FLATBUFFERS_CPP98_STL</span></div> -<div class="line"><a name="l01038"></a><span class="lineno"> 1038</span> <span class="comment"> /// @brief Serialize values returned by a function into a FlatBuffer `vector`.</span></div> -<div class="line"><a name="l01039"></a><span class="lineno"> 1039</span> <span class="comment"></span><span class="comment"> /// This is a convenience function that takes care of iteration for you.</span></div> -<div class="line"><a name="l01040"></a><span class="lineno"> 1040</span> <span class="comment"></span><span class="comment"> /// @tparam T The data type of the `std::vector` elements.</span></div> -<div class="line"><a name="l01041"></a><span class="lineno"> 1041</span> <span class="comment"></span><span class="comment"> /// @param f A function that takes the current iteration 0..vector_size-1 and</span></div> -<div class="line"><a name="l01042"></a><span class="lineno"> 1042</span> <span class="comment"></span><span class="comment"> /// returns any type that you can construct a FlatBuffers vector out of.</span></div> -<div class="line"><a name="l01043"></a><span class="lineno"> 1043</span> <span class="comment"></span><span class="comment"> /// @return Returns a typed `Offset` into the serialized data indicating</span></div> -<div class="line"><a name="l01044"></a><span class="lineno"> 1044</span> <span class="comment"></span><span class="comment"> /// where the vector is stored.</span></div> -<div class="line"><a name="l01045"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a1080c9e370e2d9d9d872dadd1131436b"> 1045</a></span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T> Offset<Vector<T>> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a1080c9e370e2d9d9d872dadd1131436b">CreateVector</a>(<span class="keywordtype">size_t</span> vector_size,</div> -<div class="line"><a name="l01046"></a><span class="lineno"> 1046</span>  <span class="keyword">const</span> std::function<T (<span class="keywordtype">size_t</span> i)> &f) {</div> -<div class="line"><a name="l01047"></a><span class="lineno"> 1047</span>  std::vector<T> elems(vector_size);</div> -<div class="line"><a name="l01048"></a><span class="lineno"> 1048</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i = 0; i < vector_size; i++) elems[i] = f(i);</div> -<div class="line"><a name="l01049"></a><span class="lineno"> 1049</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a2cca5c89246a53e80e6ad9487f4c36f3">CreateVector</a>(elems);</div> -<div class="line"><a name="l01050"></a><span class="lineno"> 1050</span>  }</div> -<div class="line"><a name="l01051"></a><span class="lineno"> 1051</span> <span class="preprocessor"> #endif</span></div> -<div class="line"><a name="l01052"></a><span class="lineno"> 1052</span> <span class="comment"></span></div> -<div class="line"><a name="l01053"></a><span class="lineno"> 1053</span> <span class="comment"> /// @brief Serialize a `std::vector<std::string>` into a FlatBuffer `vector`.</span></div> -<div class="line"><a name="l01054"></a><span class="lineno"> 1054</span> <span class="comment"> /// This is a convenience function for a common case.</span></div> -<div class="line"><a name="l01055"></a><span class="lineno"> 1055</span> <span class="comment"> /// @param v A const reference to the `std::vector` to serialize into the</span></div> -<div class="line"><a name="l01056"></a><span class="lineno"> 1056</span> <span class="comment"> /// buffer as a `vector`.</span></div> -<div class="line"><a name="l01057"></a><span class="lineno"> 1057</span> <span class="comment"> /// @return Returns a typed `Offset` into the serialized data indicating</span></div> -<div class="line"><a name="l01058"></a><span class="lineno"> 1058</span> <span class="comment"> /// where the vector is stored.</span></div> -<div class="line"><a name="l01059"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a592110519a6c8db1926f1365bf2a58e6"> 1059</a></span> <span class="comment"></span> Offset<Vector<Offset<String>>> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a592110519a6c8db1926f1365bf2a58e6">CreateVectorOfStrings</a>(</div> -<div class="line"><a name="l01060"></a><span class="lineno"> 1060</span>  <span class="keyword">const</span> std::vector<std::string> &v) {</div> -<div class="line"><a name="l01061"></a><span class="lineno"> 1061</span>  std::vector<Offset<String>> offsets(v.size());</div> -<div class="line"><a name="l01062"></a><span class="lineno"> 1062</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i = 0; i < v.size(); i++) offsets[i] = <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#aec6f9df2a0366b540b24822414d92cbe">CreateString</a>(v[i]);</div> -<div class="line"><a name="l01063"></a><span class="lineno"> 1063</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a2cca5c89246a53e80e6ad9487f4c36f3">CreateVector</a>(offsets);</div> +<div class="line"><a name="l01015"></a><span class="lineno"> 1015</span> </div> +<div class="line"><a name="l01016"></a><span class="lineno"> 1016</span>  <span class="comment">// Call this right before StartVector/CreateVector if you want to force the</span></div> +<div class="line"><a name="l01017"></a><span class="lineno"> 1017</span>  <span class="comment">// alignment to be something different than what the element size would</span></div> +<div class="line"><a name="l01018"></a><span class="lineno"> 1018</span>  <span class="comment">// normally dictate.</span></div> +<div class="line"><a name="l01019"></a><span class="lineno"> 1019</span>  <span class="comment">// This is useful when storing a nested_flatbuffer in a vector of bytes,</span></div> +<div class="line"><a name="l01020"></a><span class="lineno"> 1020</span>  <span class="comment">// or when storing SIMD floats, etc.</span></div> +<div class="line"><a name="l01021"></a><span class="lineno"> 1021</span>  <span class="keywordtype">void</span> ForceVectorAlignment(<span class="keywordtype">size_t</span> len, <span class="keywordtype">size_t</span> elemsize, <span class="keywordtype">size_t</span> alignment) {</div> +<div class="line"><a name="l01022"></a><span class="lineno"> 1022</span>  PreAlign(len * elemsize, alignment);</div> +<div class="line"><a name="l01023"></a><span class="lineno"> 1023</span>  }</div> +<div class="line"><a name="l01024"></a><span class="lineno"> 1024</span> </div> +<div class="line"><a name="l01025"></a><span class="lineno"> 1025</span>  uint8_t *ReserveElements(<span class="keywordtype">size_t</span> len, <span class="keywordtype">size_t</span> elemsize) {</div> +<div class="line"><a name="l01026"></a><span class="lineno"> 1026</span>  <span class="keywordflow">return</span> buf_.make_space(len * elemsize);</div> +<div class="line"><a name="l01027"></a><span class="lineno"> 1027</span>  }<span class="comment"></span></div> +<div class="line"><a name="l01028"></a><span class="lineno"> 1028</span> <span class="comment"> /// @endcond</span></div> +<div class="line"><a name="l01029"></a><span class="lineno"> 1029</span> <span class="comment"></span><span class="comment"></span></div> +<div class="line"><a name="l01030"></a><span class="lineno"> 1030</span> <span class="comment"> /// @brief Serialize an array into a FlatBuffer `vector`.</span></div> +<div class="line"><a name="l01031"></a><span class="lineno"> 1031</span> <span class="comment"> /// @tparam T The data type of the array elements.</span></div> +<div class="line"><a name="l01032"></a><span class="lineno"> 1032</span> <span class="comment"> /// @param[in] v A pointer to the array of type `T` to serialize into the</span></div> +<div class="line"><a name="l01033"></a><span class="lineno"> 1033</span> <span class="comment"> /// buffer as a `vector`.</span></div> +<div class="line"><a name="l01034"></a><span class="lineno"> 1034</span> <span class="comment"> /// @param[in] len The number of elements to serialize.</span></div> +<div class="line"><a name="l01035"></a><span class="lineno"> 1035</span> <span class="comment"> /// @return Returns a typed `Offset` into the serialized data indicating</span></div> +<div class="line"><a name="l01036"></a><span class="lineno"> 1036</span> <span class="comment"> /// where the vector is stored.</span></div> +<div class="line"><a name="l01037"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a2cca5c89246a53e80e6ad9487f4c36f3"> 1037</a></span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T> Offset<Vector<T>> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a2cca5c89246a53e80e6ad9487f4c36f3">CreateVector</a>(<span class="keyword">const</span> T *v, <span class="keywordtype">size_t</span> len) {</div> +<div class="line"><a name="l01038"></a><span class="lineno"> 1038</span>  StartVector(len, <span class="keyword">sizeof</span>(T));</div> +<div class="line"><a name="l01039"></a><span class="lineno"> 1039</span>  <span class="keywordflow">for</span> (<span class="keyword">auto</span> i = len; i > 0; ) {</div> +<div class="line"><a name="l01040"></a><span class="lineno"> 1040</span>  PushElement(v[--i]);</div> +<div class="line"><a name="l01041"></a><span class="lineno"> 1041</span>  }</div> +<div class="line"><a name="l01042"></a><span class="lineno"> 1042</span>  <span class="keywordflow">return</span> Offset<Vector<T>>(EndVector(len));</div> +<div class="line"><a name="l01043"></a><span class="lineno"> 1043</span>  }</div> +<div class="line"><a name="l01044"></a><span class="lineno"> 1044</span> <span class="comment"></span></div> +<div class="line"><a name="l01045"></a><span class="lineno"> 1045</span> <span class="comment"> /// @brief Serialize a `std::vector` into a FlatBuffer `vector`.</span></div> +<div class="line"><a name="l01046"></a><span class="lineno"> 1046</span> <span class="comment"> /// @tparam T The data type of the `std::vector` elements.</span></div> +<div class="line"><a name="l01047"></a><span class="lineno"> 1047</span> <span class="comment"> /// @param v A const reference to the `std::vector` to serialize into the</span></div> +<div class="line"><a name="l01048"></a><span class="lineno"> 1048</span> <span class="comment"> /// buffer as a `vector`.</span></div> +<div class="line"><a name="l01049"></a><span class="lineno"> 1049</span> <span class="comment"> /// @return Returns a typed `Offset` into the serialized data indicating</span></div> +<div class="line"><a name="l01050"></a><span class="lineno"> 1050</span> <span class="comment"> /// where the vector is stored.</span></div> +<div class="line"><a name="l01051"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#af715dd24dd37cb0151dc7a980ad0f207"> 1051</a></span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T> Offset<Vector<T>> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#af715dd24dd37cb0151dc7a980ad0f207">CreateVector</a>(<span class="keyword">const</span> std::vector<T> &v) {</div> +<div class="line"><a name="l01052"></a><span class="lineno"> 1052</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a2cca5c89246a53e80e6ad9487f4c36f3">CreateVector</a>(data(v), v.size());</div> +<div class="line"><a name="l01053"></a><span class="lineno"> 1053</span>  }</div> +<div class="line"><a name="l01054"></a><span class="lineno"> 1054</span> </div> +<div class="line"><a name="l01055"></a><span class="lineno"> 1055</span>  <span class="comment">// vector<bool> may be implemented using a bit-set, so we can't access it as</span></div> +<div class="line"><a name="l01056"></a><span class="lineno"> 1056</span>  <span class="comment">// an array. Instead, read elements manually.</span></div> +<div class="line"><a name="l01057"></a><span class="lineno"> 1057</span>  <span class="comment">// Background: https://isocpp.org/blog/2012/11/on-vectorbool</span></div> +<div class="line"><a name="l01058"></a><span class="lineno"> 1058</span>  Offset<Vector<uint8_t>> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a2cca5c89246a53e80e6ad9487f4c36f3">CreateVector</a>(<span class="keyword">const</span> std::vector<bool> &v) {</div> +<div class="line"><a name="l01059"></a><span class="lineno"> 1059</span>  StartVector(v.size(), <span class="keyword">sizeof</span>(uint8_t));</div> +<div class="line"><a name="l01060"></a><span class="lineno"> 1060</span>  <span class="keywordflow">for</span> (<span class="keyword">auto</span> i = v.size(); i > 0; ) {</div> +<div class="line"><a name="l01061"></a><span class="lineno"> 1061</span>  PushElement(static_cast<uint8_t>(v[--i]));</div> +<div class="line"><a name="l01062"></a><span class="lineno"> 1062</span>  }</div> +<div class="line"><a name="l01063"></a><span class="lineno"> 1063</span>  <span class="keywordflow">return</span> Offset<Vector<uint8_t>>(EndVector(v.size()));</div> <div class="line"><a name="l01064"></a><span class="lineno"> 1064</span>  }</div> -<div class="line"><a name="l01065"></a><span class="lineno"> 1065</span> <span class="comment"></span></div> -<div class="line"><a name="l01066"></a><span class="lineno"> 1066</span> <span class="comment"> /// @brief Serialize an array of structs into a FlatBuffer `vector`.</span></div> -<div class="line"><a name="l01067"></a><span class="lineno"> 1067</span> <span class="comment"> /// @tparam T The data type of the struct array elements.</span></div> -<div class="line"><a name="l01068"></a><span class="lineno"> 1068</span> <span class="comment"> /// @param[in] v A pointer to the array of type `T` to serialize into the</span></div> -<div class="line"><a name="l01069"></a><span class="lineno"> 1069</span> <span class="comment"> /// buffer as a `vector`.</span></div> -<div class="line"><a name="l01070"></a><span class="lineno"> 1070</span> <span class="comment"> /// @param[in] len The number of elements to serialize.</span></div> -<div class="line"><a name="l01071"></a><span class="lineno"> 1071</span> <span class="comment"> /// @return Returns a typed `Offset` into the serialized data indicating</span></div> -<div class="line"><a name="l01072"></a><span class="lineno"> 1072</span> <span class="comment"> /// where the vector is stored.</span></div> -<div class="line"><a name="l01073"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#afede51fd9c32d146cbb1832f57c5e1b7"> 1073</a></span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T> Offset<Vector<const T *>> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#afede51fd9c32d146cbb1832f57c5e1b7">CreateVectorOfStructs</a>(</div> -<div class="line"><a name="l01074"></a><span class="lineno"> 1074</span>  <span class="keyword">const</span> T *v, <span class="keywordtype">size_t</span> len) {</div> -<div class="line"><a name="l01075"></a><span class="lineno"> 1075</span>  StartVector(len * <span class="keyword">sizeof</span>(T) / AlignOf<T>(), AlignOf<T>());</div> -<div class="line"><a name="l01076"></a><span class="lineno"> 1076</span>  PushBytes(reinterpret_cast<const uint8_t *>(v), <span class="keyword">sizeof</span>(T) * len);</div> -<div class="line"><a name="l01077"></a><span class="lineno"> 1077</span>  <span class="keywordflow">return</span> Offset<Vector<const T *>>(EndVector(len));</div> -<div class="line"><a name="l01078"></a><span class="lineno"> 1078</span>  }</div> -<div class="line"><a name="l01079"></a><span class="lineno"> 1079</span> <span class="comment"></span></div> -<div class="line"><a name="l01080"></a><span class="lineno"> 1080</span> <span class="comment"> /// @brief Serialize a `std::vector` of structs into a FlatBuffer `vector`.</span></div> -<div class="line"><a name="l01081"></a><span class="lineno"> 1081</span> <span class="comment"> /// @tparam T The data type of the `std::vector` struct elements.</span></div> -<div class="line"><a name="l01082"></a><span class="lineno"> 1082</span> <span class="comment"> /// @param[in]] v A const reference to the `std::vector` of structs to</span></div> -<div class="line"><a name="l01083"></a><span class="lineno"> 1083</span> <span class="comment"> /// serialize into the buffer as a `vector`.</span></div> -<div class="line"><a name="l01084"></a><span class="lineno"> 1084</span> <span class="comment"> /// @return Returns a typed `Offset` into the serialized data indicating</span></div> -<div class="line"><a name="l01085"></a><span class="lineno"> 1085</span> <span class="comment"> /// where the vector is stored.</span></div> -<div class="line"><a name="l01086"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a8704709a2e25ad04679212ee4126b1a1"> 1086</a></span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T> Offset<Vector<const T *>> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a8704709a2e25ad04679212ee4126b1a1">CreateVectorOfStructs</a>(</div> -<div class="line"><a name="l01087"></a><span class="lineno"> 1087</span>  <span class="keyword">const</span> std::vector<T> &v) {</div> -<div class="line"><a name="l01088"></a><span class="lineno"> 1088</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#afede51fd9c32d146cbb1832f57c5e1b7">CreateVectorOfStructs</a>(data(v), v.size());</div> -<div class="line"><a name="l01089"></a><span class="lineno"> 1089</span>  }</div> -<div class="line"><a name="l01090"></a><span class="lineno"> 1090</span> <span class="comment"></span></div> -<div class="line"><a name="l01091"></a><span class="lineno"> 1091</span> <span class="comment"> /// @cond FLATBUFFERS_INTERNAL</span></div> -<div class="line"><a name="l01092"></a><span class="lineno"> 1092</span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T></div> -<div class="line"><a name="l01093"></a><span class="lineno"> 1093</span>  <span class="keyword">struct </span>TableKeyComparator {</div> -<div class="line"><a name="l01094"></a><span class="lineno"> 1094</span>  TableKeyComparator(vector_downward& buf) : buf_(buf) {}</div> -<div class="line"><a name="l01095"></a><span class="lineno"> 1095</span>  <span class="keywordtype">bool</span> operator()(<span class="keyword">const</span> Offset<T> &a, <span class="keyword">const</span> Offset<T> &b)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01096"></a><span class="lineno"> 1096</span>  <span class="keyword">auto</span> table_a = <span class="keyword">reinterpret_cast<</span>T *<span class="keyword">></span>(buf_.data_at(a.o));</div> -<div class="line"><a name="l01097"></a><span class="lineno"> 1097</span>  <span class="keyword">auto</span> table_b = <span class="keyword">reinterpret_cast<</span>T *<span class="keyword">></span>(buf_.data_at(b.o));</div> -<div class="line"><a name="l01098"></a><span class="lineno"> 1098</span>  <span class="keywordflow">return</span> table_a->KeyCompareLessThan(table_b);</div> -<div class="line"><a name="l01099"></a><span class="lineno"> 1099</span>  }</div> -<div class="line"><a name="l01100"></a><span class="lineno"> 1100</span>  vector_downward& buf_;</div> -<div class="line"><a name="l01101"></a><span class="lineno"> 1101</span> </div> -<div class="line"><a name="l01102"></a><span class="lineno"> 1102</span>  <span class="keyword">private</span>:</div> -<div class="line"><a name="l01103"></a><span class="lineno"> 1103</span>  TableKeyComparator& operator= (<span class="keyword">const</span> TableKeyComparator&);</div> -<div class="line"><a name="l01104"></a><span class="lineno"> 1104</span>  };<span class="comment"></span></div> -<div class="line"><a name="l01105"></a><span class="lineno"> 1105</span> <span class="comment"> /// @endcond</span></div> -<div class="line"><a name="l01106"></a><span class="lineno"> 1106</span> <span class="comment"></span><span class="comment"></span></div> -<div class="line"><a name="l01107"></a><span class="lineno"> 1107</span> <span class="comment"> /// @brief Serialize an array of `table` offsets as a `vector` in the buffer</span></div> -<div class="line"><a name="l01108"></a><span class="lineno"> 1108</span> <span class="comment"> /// in sorted order.</span></div> -<div class="line"><a name="l01109"></a><span class="lineno"> 1109</span> <span class="comment"> /// @tparam T The data type that the offset refers to.</span></div> -<div class="line"><a name="l01110"></a><span class="lineno"> 1110</span> <span class="comment"> /// @param[in] v An array of type `Offset<T>` that contains the `table`</span></div> -<div class="line"><a name="l01111"></a><span class="lineno"> 1111</span> <span class="comment"> /// offsets to store in the buffer in sorted order.</span></div> -<div class="line"><a name="l01112"></a><span class="lineno"> 1112</span> <span class="comment"> /// @param[in] len The number of elements to store in the `vector`.</span></div> +<div class="line"><a name="l01065"></a><span class="lineno"> 1065</span> </div> +<div class="line"><a name="l01066"></a><span class="lineno"> 1066</span> <span class="preprocessor"> #ifndef FLATBUFFERS_CPP98_STL</span></div> +<div class="line"><a name="l01067"></a><span class="lineno"> 1067</span> <span class="comment"> /// @brief Serialize values returned by a function into a FlatBuffer `vector`.</span></div> +<div class="line"><a name="l01068"></a><span class="lineno"> 1068</span> <span class="comment"></span><span class="comment"> /// This is a convenience function that takes care of iteration for you.</span></div> +<div class="line"><a name="l01069"></a><span class="lineno"> 1069</span> <span class="comment"></span><span class="comment"> /// @tparam T The data type of the `std::vector` elements.</span></div> +<div class="line"><a name="l01070"></a><span class="lineno"> 1070</span> <span class="comment"></span><span class="comment"> /// @param f A function that takes the current iteration 0..vector_size-1 and</span></div> +<div class="line"><a name="l01071"></a><span class="lineno"> 1071</span> <span class="comment"></span><span class="comment"> /// returns any type that you can construct a FlatBuffers vector out of.</span></div> +<div class="line"><a name="l01072"></a><span class="lineno"> 1072</span> <span class="comment"></span><span class="comment"> /// @return Returns a typed `Offset` into the serialized data indicating</span></div> +<div class="line"><a name="l01073"></a><span class="lineno"> 1073</span> <span class="comment"></span><span class="comment"> /// where the vector is stored.</span></div> +<div class="line"><a name="l01074"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a1080c9e370e2d9d9d872dadd1131436b"> 1074</a></span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T> Offset<Vector<T>> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a1080c9e370e2d9d9d872dadd1131436b">CreateVector</a>(<span class="keywordtype">size_t</span> vector_size,</div> +<div class="line"><a name="l01075"></a><span class="lineno"> 1075</span>  <span class="keyword">const</span> std::function<T (<span class="keywordtype">size_t</span> i)> &f) {</div> +<div class="line"><a name="l01076"></a><span class="lineno"> 1076</span>  std::vector<T> elems(vector_size);</div> +<div class="line"><a name="l01077"></a><span class="lineno"> 1077</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i = 0; i < vector_size; i++) elems[i] = f(i);</div> +<div class="line"><a name="l01078"></a><span class="lineno"> 1078</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a2cca5c89246a53e80e6ad9487f4c36f3">CreateVector</a>(elems);</div> +<div class="line"><a name="l01079"></a><span class="lineno"> 1079</span>  }</div> +<div class="line"><a name="l01080"></a><span class="lineno"> 1080</span> <span class="preprocessor"> #endif</span></div> +<div class="line"><a name="l01081"></a><span class="lineno"> 1081</span> <span class="comment"></span></div> +<div class="line"><a name="l01082"></a><span class="lineno"> 1082</span> <span class="comment"> /// @brief Serialize a `std::vector<std::string>` into a FlatBuffer `vector`.</span></div> +<div class="line"><a name="l01083"></a><span class="lineno"> 1083</span> <span class="comment"> /// This is a convenience function for a common case.</span></div> +<div class="line"><a name="l01084"></a><span class="lineno"> 1084</span> <span class="comment"> /// @param v A const reference to the `std::vector` to serialize into the</span></div> +<div class="line"><a name="l01085"></a><span class="lineno"> 1085</span> <span class="comment"> /// buffer as a `vector`.</span></div> +<div class="line"><a name="l01086"></a><span class="lineno"> 1086</span> <span class="comment"> /// @return Returns a typed `Offset` into the serialized data indicating</span></div> +<div class="line"><a name="l01087"></a><span class="lineno"> 1087</span> <span class="comment"> /// where the vector is stored.</span></div> +<div class="line"><a name="l01088"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a592110519a6c8db1926f1365bf2a58e6"> 1088</a></span> <span class="comment"></span> Offset<Vector<Offset<String>>> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a592110519a6c8db1926f1365bf2a58e6">CreateVectorOfStrings</a>(</div> +<div class="line"><a name="l01089"></a><span class="lineno"> 1089</span>  <span class="keyword">const</span> std::vector<std::string> &v) {</div> +<div class="line"><a name="l01090"></a><span class="lineno"> 1090</span>  std::vector<Offset<String>> offsets(v.size());</div> +<div class="line"><a name="l01091"></a><span class="lineno"> 1091</span>  <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i = 0; i < v.size(); i++) offsets[i] = <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#aec6f9df2a0366b540b24822414d92cbe">CreateString</a>(v[i]);</div> +<div class="line"><a name="l01092"></a><span class="lineno"> 1092</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a2cca5c89246a53e80e6ad9487f4c36f3">CreateVector</a>(offsets);</div> +<div class="line"><a name="l01093"></a><span class="lineno"> 1093</span>  }</div> +<div class="line"><a name="l01094"></a><span class="lineno"> 1094</span> <span class="comment"></span></div> +<div class="line"><a name="l01095"></a><span class="lineno"> 1095</span> <span class="comment"> /// @brief Serialize an array of structs into a FlatBuffer `vector`.</span></div> +<div class="line"><a name="l01096"></a><span class="lineno"> 1096</span> <span class="comment"> /// @tparam T The data type of the struct array elements.</span></div> +<div class="line"><a name="l01097"></a><span class="lineno"> 1097</span> <span class="comment"> /// @param[in] v A pointer to the array of type `T` to serialize into the</span></div> +<div class="line"><a name="l01098"></a><span class="lineno"> 1098</span> <span class="comment"> /// buffer as a `vector`.</span></div> +<div class="line"><a name="l01099"></a><span class="lineno"> 1099</span> <span class="comment"> /// @param[in] len The number of elements to serialize.</span></div> +<div class="line"><a name="l01100"></a><span class="lineno"> 1100</span> <span class="comment"> /// @return Returns a typed `Offset` into the serialized data indicating</span></div> +<div class="line"><a name="l01101"></a><span class="lineno"> 1101</span> <span class="comment"> /// where the vector is stored.</span></div> +<div class="line"><a name="l01102"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#afede51fd9c32d146cbb1832f57c5e1b7"> 1102</a></span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T> Offset<Vector<const T *>> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#afede51fd9c32d146cbb1832f57c5e1b7">CreateVectorOfStructs</a>(</div> +<div class="line"><a name="l01103"></a><span class="lineno"> 1103</span>  <span class="keyword">const</span> T *v, <span class="keywordtype">size_t</span> len) {</div> +<div class="line"><a name="l01104"></a><span class="lineno"> 1104</span>  StartVector(len * <span class="keyword">sizeof</span>(T) / AlignOf<T>(), AlignOf<T>());</div> +<div class="line"><a name="l01105"></a><span class="lineno"> 1105</span>  PushBytes(reinterpret_cast<const uint8_t *>(v), <span class="keyword">sizeof</span>(T) * len);</div> +<div class="line"><a name="l01106"></a><span class="lineno"> 1106</span>  <span class="keywordflow">return</span> Offset<Vector<const T *>>(EndVector(len));</div> +<div class="line"><a name="l01107"></a><span class="lineno"> 1107</span>  }</div> +<div class="line"><a name="l01108"></a><span class="lineno"> 1108</span> <span class="comment"></span></div> +<div class="line"><a name="l01109"></a><span class="lineno"> 1109</span> <span class="comment"> /// @brief Serialize a `std::vector` of structs into a FlatBuffer `vector`.</span></div> +<div class="line"><a name="l01110"></a><span class="lineno"> 1110</span> <span class="comment"> /// @tparam T The data type of the `std::vector` struct elements.</span></div> +<div class="line"><a name="l01111"></a><span class="lineno"> 1111</span> <span class="comment"> /// @param[in]] v A const reference to the `std::vector` of structs to</span></div> +<div class="line"><a name="l01112"></a><span class="lineno"> 1112</span> <span class="comment"> /// serialize into the buffer as a `vector`.</span></div> <div class="line"><a name="l01113"></a><span class="lineno"> 1113</span> <span class="comment"> /// @return Returns a typed `Offset` into the serialized data indicating</span></div> <div class="line"><a name="l01114"></a><span class="lineno"> 1114</span> <span class="comment"> /// where the vector is stored.</span></div> -<div class="line"><a name="l01115"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a2130ef232ff405eebe2e7f184ecd06e6"> 1115</a></span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T> Offset<Vector<Offset<T>>> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a2130ef232ff405eebe2e7f184ecd06e6">CreateVectorOfSortedTables</a>(</div> -<div class="line"><a name="l01116"></a><span class="lineno"> 1116</span>  Offset<T> *v, <span class="keywordtype">size_t</span> len) {</div> -<div class="line"><a name="l01117"></a><span class="lineno"> 1117</span>  std::sort(v, v + len, TableKeyComparator<T>(buf_));</div> -<div class="line"><a name="l01118"></a><span class="lineno"> 1118</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a2cca5c89246a53e80e6ad9487f4c36f3">CreateVector</a>(v, len);</div> -<div class="line"><a name="l01119"></a><span class="lineno"> 1119</span>  }</div> -<div class="line"><a name="l01120"></a><span class="lineno"> 1120</span> <span class="comment"></span></div> -<div class="line"><a name="l01121"></a><span class="lineno"> 1121</span> <span class="comment"> /// @brief Serialize an array of `table` offsets as a `vector` in the buffer</span></div> -<div class="line"><a name="l01122"></a><span class="lineno"> 1122</span> <span class="comment"> /// in sorted order.</span></div> -<div class="line"><a name="l01123"></a><span class="lineno"> 1123</span> <span class="comment"> /// @tparam T The data type that the offset refers to.</span></div> -<div class="line"><a name="l01124"></a><span class="lineno"> 1124</span> <span class="comment"> /// @param[in] v An array of type `Offset<T>` that contains the `table`</span></div> -<div class="line"><a name="l01125"></a><span class="lineno"> 1125</span> <span class="comment"> /// offsets to store in the buffer in sorted order.</span></div> -<div class="line"><a name="l01126"></a><span class="lineno"> 1126</span> <span class="comment"> /// @return Returns a typed `Offset` into the serialized data indicating</span></div> -<div class="line"><a name="l01127"></a><span class="lineno"> 1127</span> <span class="comment"> /// where the vector is stored.</span></div> -<div class="line"><a name="l01128"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#ac64d11c219559ea51567eab556e13135"> 1128</a></span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T> Offset<Vector<Offset<T>>> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac64d11c219559ea51567eab556e13135">CreateVectorOfSortedTables</a>(</div> -<div class="line"><a name="l01129"></a><span class="lineno"> 1129</span>  std::vector<Offset<T>> *v) {</div> -<div class="line"><a name="l01130"></a><span class="lineno"> 1130</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a2130ef232ff405eebe2e7f184ecd06e6">CreateVectorOfSortedTables</a>(data(*v), v->size());</div> -<div class="line"><a name="l01131"></a><span class="lineno"> 1131</span>  }</div> -<div class="line"><a name="l01132"></a><span class="lineno"> 1132</span> <span class="comment"></span></div> -<div class="line"><a name="l01133"></a><span class="lineno"> 1133</span> <span class="comment"> /// @brief Specialized version of `CreateVector` for non-copying use cases.</span></div> -<div class="line"><a name="l01134"></a><span class="lineno"> 1134</span> <span class="comment"> /// Write the data any time later to the returned buffer pointer `buf`.</span></div> -<div class="line"><a name="l01135"></a><span class="lineno"> 1135</span> <span class="comment"> /// @param[in] len The number of elements to store in the `vector`.</span></div> -<div class="line"><a name="l01136"></a><span class="lineno"> 1136</span> <span class="comment"> /// @param[in] elemsize The size of each element in the `vector`.</span></div> -<div class="line"><a name="l01137"></a><span class="lineno"> 1137</span> <span class="comment"> /// @param[out] buf A pointer to a `uint8_t` pointer that can be</span></div> -<div class="line"><a name="l01138"></a><span class="lineno"> 1138</span> <span class="comment"> /// written to at a later time to serialize the data into a `vector`</span></div> -<div class="line"><a name="l01139"></a><span class="lineno"> 1139</span> <span class="comment"> /// in the buffer.</span></div> -<div class="line"><a name="l01140"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#ac2b96292fa0fb1534fe7fd218a094d0c"> 1140</a></span> <span class="comment"></span> uoffset_t <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac2b96292fa0fb1534fe7fd218a094d0c">CreateUninitializedVector</a>(<span class="keywordtype">size_t</span> len, <span class="keywordtype">size_t</span> elemsize,</div> -<div class="line"><a name="l01141"></a><span class="lineno"> 1141</span>  uint8_t **buf) {</div> -<div class="line"><a name="l01142"></a><span class="lineno"> 1142</span>  NotNested();</div> -<div class="line"><a name="l01143"></a><span class="lineno"> 1143</span>  StartVector(len, elemsize);</div> -<div class="line"><a name="l01144"></a><span class="lineno"> 1144</span>  buf_.make_space(len * elemsize);</div> -<div class="line"><a name="l01145"></a><span class="lineno"> 1145</span>  <span class="keyword">auto</span> vec_start = <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>();</div> -<div class="line"><a name="l01146"></a><span class="lineno"> 1146</span>  <span class="keyword">auto</span> vec_end = EndVector(len);</div> -<div class="line"><a name="l01147"></a><span class="lineno"> 1147</span>  *buf = buf_.data_at(vec_start);</div> -<div class="line"><a name="l01148"></a><span class="lineno"> 1148</span>  <span class="keywordflow">return</span> vec_end;</div> -<div class="line"><a name="l01149"></a><span class="lineno"> 1149</span>  }</div> -<div class="line"><a name="l01150"></a><span class="lineno"> 1150</span> <span class="comment"></span></div> -<div class="line"><a name="l01151"></a><span class="lineno"> 1151</span> <span class="comment"> /// @brief Specialized version of `CreateVector` for non-copying use cases.</span></div> -<div class="line"><a name="l01152"></a><span class="lineno"> 1152</span> <span class="comment"> /// Write the data any time later to the returned buffer pointer `buf`.</span></div> -<div class="line"><a name="l01153"></a><span class="lineno"> 1153</span> <span class="comment"> /// @tparam T The data type of the data that will be stored in the buffer</span></div> -<div class="line"><a name="l01154"></a><span class="lineno"> 1154</span> <span class="comment"> /// as a `vector`.</span></div> -<div class="line"><a name="l01155"></a><span class="lineno"> 1155</span> <span class="comment"> /// @param[in] len The number of elements to store in the `vector`.</span></div> -<div class="line"><a name="l01156"></a><span class="lineno"> 1156</span> <span class="comment"> /// @param[out] buf A pointer to a pointer of type `T` that can be</span></div> -<div class="line"><a name="l01157"></a><span class="lineno"> 1157</span> <span class="comment"> /// written to at a later time to serialize the data into a `vector`</span></div> -<div class="line"><a name="l01158"></a><span class="lineno"> 1158</span> <span class="comment"> /// in the buffer.</span></div> -<div class="line"><a name="l01159"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a2305b63d367845972b51669dd995cc50"> 1159</a></span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T> Offset<Vector<T>> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a2305b63d367845972b51669dd995cc50">CreateUninitializedVector</a>(</div> -<div class="line"><a name="l01160"></a><span class="lineno"> 1160</span>  <span class="keywordtype">size_t</span> len, T **buf) {</div> -<div class="line"><a name="l01161"></a><span class="lineno"> 1161</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac2b96292fa0fb1534fe7fd218a094d0c">CreateUninitializedVector</a>(len, <span class="keyword">sizeof</span>(T),</div> -<div class="line"><a name="l01162"></a><span class="lineno"> 1162</span>  reinterpret_cast<uint8_t **>(buf));</div> -<div class="line"><a name="l01163"></a><span class="lineno"> 1163</span>  }</div> -<div class="line"><a name="l01164"></a><span class="lineno"> 1164</span> <span class="comment"></span></div> -<div class="line"><a name="l01165"></a><span class="lineno"> 1165</span> <span class="comment"> /// @brief The length of a FlatBuffer file header.</span></div> -<div class="line"><a name="l01166"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#af8c7583c92e1d1d6f438977da5158d19"> 1166</a></span> <span class="comment"></span> <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">size_t</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#af8c7583c92e1d1d6f438977da5158d19">kFileIdentifierLength</a> = 4;</div> -<div class="line"><a name="l01167"></a><span class="lineno"> 1167</span> <span class="comment"></span></div> -<div class="line"><a name="l01168"></a><span class="lineno"> 1168</span> <span class="comment"> /// @brief Finish serializing a buffer by writing the root offset.</span></div> -<div class="line"><a name="l01169"></a><span class="lineno"> 1169</span> <span class="comment"> /// @param[in] file_identifier If a `file_identifier` is given, the buffer</span></div> -<div class="line"><a name="l01170"></a><span class="lineno"> 1170</span> <span class="comment"> /// will be prefixed with a standard FlatBuffers file header.</span></div> -<div class="line"><a name="l01171"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a0c9e507b373d598b51052fab4fa34912"> 1171</a></span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">void</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a0c9e507b373d598b51052fab4fa34912">Finish</a>(Offset<T> root,</div> -<div class="line"><a name="l01172"></a><span class="lineno"> 1172</span>  <span class="keyword">const</span> <span class="keywordtype">char</span> *file_identifier = <span class="keyword">nullptr</span>) {</div> -<div class="line"><a name="l01173"></a><span class="lineno"> 1173</span> </div> -<div class="line"><a name="l01174"></a><span class="lineno"> 1174</span>  <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a0c9e507b373d598b51052fab4fa34912">Finish</a>(root.o, file_identifier, <span class="keyword">false</span>);</div> -<div class="line"><a name="l01175"></a><span class="lineno"> 1175</span>  }</div> -<div class="line"><a name="l01176"></a><span class="lineno"> 1176</span> <span class="comment"></span></div> -<div class="line"><a name="l01177"></a><span class="lineno"> 1177</span> <span class="comment"> /// @brief Finish a buffer with a 32 bit size field pre-fixed (size of the</span></div> -<div class="line"><a name="l01178"></a><span class="lineno"> 1178</span> <span class="comment"> /// buffer following the size field). These buffers are NOT compatible</span></div> -<div class="line"><a name="l01179"></a><span class="lineno"> 1179</span> <span class="comment"> /// with standard buffers created by Finish, i.e. you can't call GetRoot</span></div> -<div class="line"><a name="l01180"></a><span class="lineno"> 1180</span> <span class="comment"> /// on them, you have to use GetSizePrefixedRoot instead.</span></div> -<div class="line"><a name="l01181"></a><span class="lineno"> 1181</span> <span class="comment"> /// All >32 bit quantities in this buffer will be aligned when the whole</span></div> -<div class="line"><a name="l01182"></a><span class="lineno"> 1182</span> <span class="comment"> /// size pre-fixed buffer is aligned.</span></div> -<div class="line"><a name="l01183"></a><span class="lineno"> 1183</span> <span class="comment"> /// These kinds of buffers are useful for creating a stream of FlatBuffers.</span></div> -<div class="line"><a name="l01184"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a7ba8462e408431054c99d25120326220"> 1184</a></span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">void</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a7ba8462e408431054c99d25120326220">FinishSizePrefixed</a>(Offset<T> root,</div> -<div class="line"><a name="l01185"></a><span class="lineno"> 1185</span>  <span class="keyword">const</span> <span class="keywordtype">char</span> *file_identifier = <span class="keyword">nullptr</span>) {</div> -<div class="line"><a name="l01186"></a><span class="lineno"> 1186</span>  <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a0c9e507b373d598b51052fab4fa34912">Finish</a>(root.o, file_identifier, <span class="keyword">true</span>);</div> -<div class="line"><a name="l01187"></a><span class="lineno"> 1187</span>  }</div> -<div class="line"><a name="l01188"></a><span class="lineno"> 1188</span> </div> -<div class="line"><a name="l01189"></a><span class="lineno"> 1189</span>  <span class="keyword">private</span>:</div> -<div class="line"><a name="l01190"></a><span class="lineno"> 1190</span>  <span class="comment">// You shouldn't really be copying instances of this class.</span></div> -<div class="line"><a name="l01191"></a><span class="lineno"> 1191</span>  <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac72b54a75e0c329e0ce0b8fab758e256">FlatBufferBuilder</a>(<span class="keyword">const</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html">FlatBufferBuilder</a> &);</div> -<div class="line"><a name="l01192"></a><span class="lineno"> 1192</span>  <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html">FlatBufferBuilder</a> &operator=(<span class="keyword">const</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html">FlatBufferBuilder</a> &);</div> -<div class="line"><a name="l01193"></a><span class="lineno"> 1193</span> </div> -<div class="line"><a name="l01194"></a><span class="lineno"> 1194</span>  <span class="keywordtype">void</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a0c9e507b373d598b51052fab4fa34912">Finish</a>(uoffset_t root, <span class="keyword">const</span> <span class="keywordtype">char</span> *file_identifier, <span class="keywordtype">bool</span> size_prefix) {</div> -<div class="line"><a name="l01195"></a><span class="lineno"> 1195</span>  NotNested();</div> -<div class="line"><a name="l01196"></a><span class="lineno"> 1196</span>  <span class="comment">// This will cause the whole buffer to be aligned.</span></div> -<div class="line"><a name="l01197"></a><span class="lineno"> 1197</span>  PreAlign((size_prefix ? <span class="keyword">sizeof</span>(uoffset_t) : 0) +</div> -<div class="line"><a name="l01198"></a><span class="lineno"> 1198</span>  <span class="keyword">sizeof</span>(uoffset_t) +</div> -<div class="line"><a name="l01199"></a><span class="lineno"> 1199</span>  (file_identifier ? <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#af8c7583c92e1d1d6f438977da5158d19">kFileIdentifierLength</a> : 0),</div> -<div class="line"><a name="l01200"></a><span class="lineno"> 1200</span>  minalign_);</div> -<div class="line"><a name="l01201"></a><span class="lineno"> 1201</span>  <span class="keywordflow">if</span> (file_identifier) {</div> -<div class="line"><a name="l01202"></a><span class="lineno"> 1202</span>  assert(strlen(file_identifier) == <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#af8c7583c92e1d1d6f438977da5158d19">kFileIdentifierLength</a>);</div> -<div class="line"><a name="l01203"></a><span class="lineno"> 1203</span>  buf_.push(reinterpret_cast<const uint8_t *>(file_identifier),</div> -<div class="line"><a name="l01204"></a><span class="lineno"> 1204</span>  <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#af8c7583c92e1d1d6f438977da5158d19">kFileIdentifierLength</a>);</div> -<div class="line"><a name="l01205"></a><span class="lineno"> 1205</span>  }</div> -<div class="line"><a name="l01206"></a><span class="lineno"> 1206</span>  PushElement(ReferTo(root)); <span class="comment">// Location of root.</span></div> -<div class="line"><a name="l01207"></a><span class="lineno"> 1207</span>  <span class="keywordflow">if</span> (size_prefix) {</div> -<div class="line"><a name="l01208"></a><span class="lineno"> 1208</span>  PushElement(<a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>());</div> -<div class="line"><a name="l01209"></a><span class="lineno"> 1209</span>  }</div> -<div class="line"><a name="l01210"></a><span class="lineno"> 1210</span>  finished = <span class="keyword">true</span>;</div> -<div class="line"><a name="l01211"></a><span class="lineno"> 1211</span>  }</div> -<div class="line"><a name="l01212"></a><span class="lineno"> 1212</span> </div> -<div class="line"><a name="l01213"></a><span class="lineno"> 1213</span>  <span class="keyword">struct </span>FieldLoc {</div> -<div class="line"><a name="l01214"></a><span class="lineno"> 1214</span>  uoffset_t off;</div> -<div class="line"><a name="l01215"></a><span class="lineno"> 1215</span>  voffset_t id;</div> -<div class="line"><a name="l01216"></a><span class="lineno"> 1216</span>  };</div> +<div class="line"><a name="l01115"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a8704709a2e25ad04679212ee4126b1a1"> 1115</a></span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T> Offset<Vector<const T *>> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a8704709a2e25ad04679212ee4126b1a1">CreateVectorOfStructs</a>(</div> +<div class="line"><a name="l01116"></a><span class="lineno"> 1116</span>  <span class="keyword">const</span> std::vector<T> &v) {</div> +<div class="line"><a name="l01117"></a><span class="lineno"> 1117</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#afede51fd9c32d146cbb1832f57c5e1b7">CreateVectorOfStructs</a>(data(v), v.size());</div> +<div class="line"><a name="l01118"></a><span class="lineno"> 1118</span>  }</div> +<div class="line"><a name="l01119"></a><span class="lineno"> 1119</span> <span class="comment"></span></div> +<div class="line"><a name="l01120"></a><span class="lineno"> 1120</span> <span class="comment"> /// @cond FLATBUFFERS_INTERNAL</span></div> +<div class="line"><a name="l01121"></a><span class="lineno"> 1121</span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T></div> +<div class="line"><a name="l01122"></a><span class="lineno"> 1122</span>  <span class="keyword">struct </span>TableKeyComparator {</div> +<div class="line"><a name="l01123"></a><span class="lineno"> 1123</span>  TableKeyComparator(vector_downward& buf) : buf_(buf) {}</div> +<div class="line"><a name="l01124"></a><span class="lineno"> 1124</span>  <span class="keywordtype">bool</span> operator()(<span class="keyword">const</span> Offset<T> &a, <span class="keyword">const</span> Offset<T> &b)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01125"></a><span class="lineno"> 1125</span>  <span class="keyword">auto</span> table_a = <span class="keyword">reinterpret_cast<</span>T *<span class="keyword">></span>(buf_.data_at(a.o));</div> +<div class="line"><a name="l01126"></a><span class="lineno"> 1126</span>  <span class="keyword">auto</span> table_b = <span class="keyword">reinterpret_cast<</span>T *<span class="keyword">></span>(buf_.data_at(b.o));</div> +<div class="line"><a name="l01127"></a><span class="lineno"> 1127</span>  <span class="keywordflow">return</span> table_a->KeyCompareLessThan(table_b);</div> +<div class="line"><a name="l01128"></a><span class="lineno"> 1128</span>  }</div> +<div class="line"><a name="l01129"></a><span class="lineno"> 1129</span>  vector_downward& buf_;</div> +<div class="line"><a name="l01130"></a><span class="lineno"> 1130</span> </div> +<div class="line"><a name="l01131"></a><span class="lineno"> 1131</span>  <span class="keyword">private</span>:</div> +<div class="line"><a name="l01132"></a><span class="lineno"> 1132</span>  TableKeyComparator& operator= (<span class="keyword">const</span> TableKeyComparator&);</div> +<div class="line"><a name="l01133"></a><span class="lineno"> 1133</span>  };<span class="comment"></span></div> +<div class="line"><a name="l01134"></a><span class="lineno"> 1134</span> <span class="comment"> /// @endcond</span></div> +<div class="line"><a name="l01135"></a><span class="lineno"> 1135</span> <span class="comment"></span><span class="comment"></span></div> +<div class="line"><a name="l01136"></a><span class="lineno"> 1136</span> <span class="comment"> /// @brief Serialize an array of `table` offsets as a `vector` in the buffer</span></div> +<div class="line"><a name="l01137"></a><span class="lineno"> 1137</span> <span class="comment"> /// in sorted order.</span></div> +<div class="line"><a name="l01138"></a><span class="lineno"> 1138</span> <span class="comment"> /// @tparam T The data type that the offset refers to.</span></div> +<div class="line"><a name="l01139"></a><span class="lineno"> 1139</span> <span class="comment"> /// @param[in] v An array of type `Offset<T>` that contains the `table`</span></div> +<div class="line"><a name="l01140"></a><span class="lineno"> 1140</span> <span class="comment"> /// offsets to store in the buffer in sorted order.</span></div> +<div class="line"><a name="l01141"></a><span class="lineno"> 1141</span> <span class="comment"> /// @param[in] len The number of elements to store in the `vector`.</span></div> +<div class="line"><a name="l01142"></a><span class="lineno"> 1142</span> <span class="comment"> /// @return Returns a typed `Offset` into the serialized data indicating</span></div> +<div class="line"><a name="l01143"></a><span class="lineno"> 1143</span> <span class="comment"> /// where the vector is stored.</span></div> +<div class="line"><a name="l01144"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a2130ef232ff405eebe2e7f184ecd06e6"> 1144</a></span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T> Offset<Vector<Offset<T>>> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a2130ef232ff405eebe2e7f184ecd06e6">CreateVectorOfSortedTables</a>(</div> +<div class="line"><a name="l01145"></a><span class="lineno"> 1145</span>  Offset<T> *v, <span class="keywordtype">size_t</span> len) {</div> +<div class="line"><a name="l01146"></a><span class="lineno"> 1146</span>  std::sort(v, v + len, TableKeyComparator<T>(buf_));</div> +<div class="line"><a name="l01147"></a><span class="lineno"> 1147</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a2cca5c89246a53e80e6ad9487f4c36f3">CreateVector</a>(v, len);</div> +<div class="line"><a name="l01148"></a><span class="lineno"> 1148</span>  }</div> +<div class="line"><a name="l01149"></a><span class="lineno"> 1149</span> <span class="comment"></span></div> +<div class="line"><a name="l01150"></a><span class="lineno"> 1150</span> <span class="comment"> /// @brief Serialize an array of `table` offsets as a `vector` in the buffer</span></div> +<div class="line"><a name="l01151"></a><span class="lineno"> 1151</span> <span class="comment"> /// in sorted order.</span></div> +<div class="line"><a name="l01152"></a><span class="lineno"> 1152</span> <span class="comment"> /// @tparam T The data type that the offset refers to.</span></div> +<div class="line"><a name="l01153"></a><span class="lineno"> 1153</span> <span class="comment"> /// @param[in] v An array of type `Offset<T>` that contains the `table`</span></div> +<div class="line"><a name="l01154"></a><span class="lineno"> 1154</span> <span class="comment"> /// offsets to store in the buffer in sorted order.</span></div> +<div class="line"><a name="l01155"></a><span class="lineno"> 1155</span> <span class="comment"> /// @return Returns a typed `Offset` into the serialized data indicating</span></div> +<div class="line"><a name="l01156"></a><span class="lineno"> 1156</span> <span class="comment"> /// where the vector is stored.</span></div> +<div class="line"><a name="l01157"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#ac64d11c219559ea51567eab556e13135"> 1157</a></span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T> Offset<Vector<Offset<T>>> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac64d11c219559ea51567eab556e13135">CreateVectorOfSortedTables</a>(</div> +<div class="line"><a name="l01158"></a><span class="lineno"> 1158</span>  std::vector<Offset<T>> *v) {</div> +<div class="line"><a name="l01159"></a><span class="lineno"> 1159</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a2130ef232ff405eebe2e7f184ecd06e6">CreateVectorOfSortedTables</a>(data(*v), v->size());</div> +<div class="line"><a name="l01160"></a><span class="lineno"> 1160</span>  }</div> +<div class="line"><a name="l01161"></a><span class="lineno"> 1161</span> <span class="comment"></span></div> +<div class="line"><a name="l01162"></a><span class="lineno"> 1162</span> <span class="comment"> /// @brief Specialized version of `CreateVector` for non-copying use cases.</span></div> +<div class="line"><a name="l01163"></a><span class="lineno"> 1163</span> <span class="comment"> /// Write the data any time later to the returned buffer pointer `buf`.</span></div> +<div class="line"><a name="l01164"></a><span class="lineno"> 1164</span> <span class="comment"> /// @param[in] len The number of elements to store in the `vector`.</span></div> +<div class="line"><a name="l01165"></a><span class="lineno"> 1165</span> <span class="comment"> /// @param[in] elemsize The size of each element in the `vector`.</span></div> +<div class="line"><a name="l01166"></a><span class="lineno"> 1166</span> <span class="comment"> /// @param[out] buf A pointer to a `uint8_t` pointer that can be</span></div> +<div class="line"><a name="l01167"></a><span class="lineno"> 1167</span> <span class="comment"> /// written to at a later time to serialize the data into a `vector`</span></div> +<div class="line"><a name="l01168"></a><span class="lineno"> 1168</span> <span class="comment"> /// in the buffer.</span></div> +<div class="line"><a name="l01169"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#ac2b96292fa0fb1534fe7fd218a094d0c"> 1169</a></span> <span class="comment"></span> uoffset_t <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac2b96292fa0fb1534fe7fd218a094d0c">CreateUninitializedVector</a>(<span class="keywordtype">size_t</span> len, <span class="keywordtype">size_t</span> elemsize,</div> +<div class="line"><a name="l01170"></a><span class="lineno"> 1170</span>  uint8_t **buf) {</div> +<div class="line"><a name="l01171"></a><span class="lineno"> 1171</span>  NotNested();</div> +<div class="line"><a name="l01172"></a><span class="lineno"> 1172</span>  StartVector(len, elemsize);</div> +<div class="line"><a name="l01173"></a><span class="lineno"> 1173</span>  buf_.make_space(len * elemsize);</div> +<div class="line"><a name="l01174"></a><span class="lineno"> 1174</span>  <span class="keyword">auto</span> vec_start = <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>();</div> +<div class="line"><a name="l01175"></a><span class="lineno"> 1175</span>  <span class="keyword">auto</span> vec_end = EndVector(len);</div> +<div class="line"><a name="l01176"></a><span class="lineno"> 1176</span>  *buf = buf_.data_at(vec_start);</div> +<div class="line"><a name="l01177"></a><span class="lineno"> 1177</span>  <span class="keywordflow">return</span> vec_end;</div> +<div class="line"><a name="l01178"></a><span class="lineno"> 1178</span>  }</div> +<div class="line"><a name="l01179"></a><span class="lineno"> 1179</span> <span class="comment"></span></div> +<div class="line"><a name="l01180"></a><span class="lineno"> 1180</span> <span class="comment"> /// @brief Specialized version of `CreateVector` for non-copying use cases.</span></div> +<div class="line"><a name="l01181"></a><span class="lineno"> 1181</span> <span class="comment"> /// Write the data any time later to the returned buffer pointer `buf`.</span></div> +<div class="line"><a name="l01182"></a><span class="lineno"> 1182</span> <span class="comment"> /// @tparam T The data type of the data that will be stored in the buffer</span></div> +<div class="line"><a name="l01183"></a><span class="lineno"> 1183</span> <span class="comment"> /// as a `vector`.</span></div> +<div class="line"><a name="l01184"></a><span class="lineno"> 1184</span> <span class="comment"> /// @param[in] len The number of elements to store in the `vector`.</span></div> +<div class="line"><a name="l01185"></a><span class="lineno"> 1185</span> <span class="comment"> /// @param[out] buf A pointer to a pointer of type `T` that can be</span></div> +<div class="line"><a name="l01186"></a><span class="lineno"> 1186</span> <span class="comment"> /// written to at a later time to serialize the data into a `vector`</span></div> +<div class="line"><a name="l01187"></a><span class="lineno"> 1187</span> <span class="comment"> /// in the buffer.</span></div> +<div class="line"><a name="l01188"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a2305b63d367845972b51669dd995cc50"> 1188</a></span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T> Offset<Vector<T>> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a2305b63d367845972b51669dd995cc50">CreateUninitializedVector</a>(</div> +<div class="line"><a name="l01189"></a><span class="lineno"> 1189</span>  <span class="keywordtype">size_t</span> len, T **buf) {</div> +<div class="line"><a name="l01190"></a><span class="lineno"> 1190</span>  <span class="keywordflow">return</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac2b96292fa0fb1534fe7fd218a094d0c">CreateUninitializedVector</a>(len, <span class="keyword">sizeof</span>(T),</div> +<div class="line"><a name="l01191"></a><span class="lineno"> 1191</span>  reinterpret_cast<uint8_t **>(buf));</div> +<div class="line"><a name="l01192"></a><span class="lineno"> 1192</span>  }</div> +<div class="line"><a name="l01193"></a><span class="lineno"> 1193</span> <span class="comment"></span></div> +<div class="line"><a name="l01194"></a><span class="lineno"> 1194</span> <span class="comment"> /// @brief The length of a FlatBuffer file header.</span></div> +<div class="line"><a name="l01195"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#af8c7583c92e1d1d6f438977da5158d19"> 1195</a></span> <span class="comment"></span> <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">size_t</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#af8c7583c92e1d1d6f438977da5158d19">kFileIdentifierLength</a> = 4;</div> +<div class="line"><a name="l01196"></a><span class="lineno"> 1196</span> <span class="comment"></span></div> +<div class="line"><a name="l01197"></a><span class="lineno"> 1197</span> <span class="comment"> /// @brief Finish serializing a buffer by writing the root offset.</span></div> +<div class="line"><a name="l01198"></a><span class="lineno"> 1198</span> <span class="comment"> /// @param[in] file_identifier If a `file_identifier` is given, the buffer</span></div> +<div class="line"><a name="l01199"></a><span class="lineno"> 1199</span> <span class="comment"> /// will be prefixed with a standard FlatBuffers file header.</span></div> +<div class="line"><a name="l01200"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a0c9e507b373d598b51052fab4fa34912"> 1200</a></span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">void</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a0c9e507b373d598b51052fab4fa34912">Finish</a>(Offset<T> root,</div> +<div class="line"><a name="l01201"></a><span class="lineno"> 1201</span>  <span class="keyword">const</span> <span class="keywordtype">char</span> *file_identifier = <span class="keyword">nullptr</span>) {</div> +<div class="line"><a name="l01202"></a><span class="lineno"> 1202</span> </div> +<div class="line"><a name="l01203"></a><span class="lineno"> 1203</span>  <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a0c9e507b373d598b51052fab4fa34912">Finish</a>(root.o, file_identifier, <span class="keyword">false</span>);</div> +<div class="line"><a name="l01204"></a><span class="lineno"> 1204</span>  }</div> +<div class="line"><a name="l01205"></a><span class="lineno"> 1205</span> <span class="comment"></span></div> +<div class="line"><a name="l01206"></a><span class="lineno"> 1206</span> <span class="comment"> /// @brief Finish a buffer with a 32 bit size field pre-fixed (size of the</span></div> +<div class="line"><a name="l01207"></a><span class="lineno"> 1207</span> <span class="comment"> /// buffer following the size field). These buffers are NOT compatible</span></div> +<div class="line"><a name="l01208"></a><span class="lineno"> 1208</span> <span class="comment"> /// with standard buffers created by Finish, i.e. you can't call GetRoot</span></div> +<div class="line"><a name="l01209"></a><span class="lineno"> 1209</span> <span class="comment"> /// on them, you have to use GetSizePrefixedRoot instead.</span></div> +<div class="line"><a name="l01210"></a><span class="lineno"> 1210</span> <span class="comment"> /// All >32 bit quantities in this buffer will be aligned when the whole</span></div> +<div class="line"><a name="l01211"></a><span class="lineno"> 1211</span> <span class="comment"> /// size pre-fixed buffer is aligned.</span></div> +<div class="line"><a name="l01212"></a><span class="lineno"> 1212</span> <span class="comment"> /// These kinds of buffers are useful for creating a stream of FlatBuffers.</span></div> +<div class="line"><a name="l01213"></a><span class="lineno"><a class="line" href="classflatbuffers_1_1_flat_buffer_builder.html#a7ba8462e408431054c99d25120326220"> 1213</a></span> <span class="comment"></span> <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">void</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a7ba8462e408431054c99d25120326220">FinishSizePrefixed</a>(Offset<T> root,</div> +<div class="line"><a name="l01214"></a><span class="lineno"> 1214</span>  <span class="keyword">const</span> <span class="keywordtype">char</span> *file_identifier = <span class="keyword">nullptr</span>) {</div> +<div class="line"><a name="l01215"></a><span class="lineno"> 1215</span>  <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a0c9e507b373d598b51052fab4fa34912">Finish</a>(root.o, file_identifier, <span class="keyword">true</span>);</div> +<div class="line"><a name="l01216"></a><span class="lineno"> 1216</span>  }</div> <div class="line"><a name="l01217"></a><span class="lineno"> 1217</span> </div> -<div class="line"><a name="l01218"></a><span class="lineno"> 1218</span>  simple_allocator default_allocator;</div> -<div class="line"><a name="l01219"></a><span class="lineno"> 1219</span> </div> -<div class="line"><a name="l01220"></a><span class="lineno"> 1220</span>  vector_downward buf_;</div> -<div class="line"><a name="l01221"></a><span class="lineno"> 1221</span> </div> -<div class="line"><a name="l01222"></a><span class="lineno"> 1222</span>  <span class="comment">// Accumulating offsets of table members while it is being built.</span></div> -<div class="line"><a name="l01223"></a><span class="lineno"> 1223</span>  std::vector<FieldLoc> offsetbuf_;</div> -<div class="line"><a name="l01224"></a><span class="lineno"> 1224</span> </div> -<div class="line"><a name="l01225"></a><span class="lineno"> 1225</span>  <span class="comment">// Ensure objects are not nested.</span></div> -<div class="line"><a name="l01226"></a><span class="lineno"> 1226</span>  <span class="keywordtype">bool</span> nested;</div> -<div class="line"><a name="l01227"></a><span class="lineno"> 1227</span> </div> -<div class="line"><a name="l01228"></a><span class="lineno"> 1228</span>  <span class="comment">// Ensure the buffer is finished before it is being accessed.</span></div> -<div class="line"><a name="l01229"></a><span class="lineno"> 1229</span>  <span class="keywordtype">bool</span> finished;</div> -<div class="line"><a name="l01230"></a><span class="lineno"> 1230</span> </div> -<div class="line"><a name="l01231"></a><span class="lineno"> 1231</span>  std::vector<uoffset_t> vtables_; <span class="comment">// todo: Could make this into a map?</span></div> -<div class="line"><a name="l01232"></a><span class="lineno"> 1232</span> </div> -<div class="line"><a name="l01233"></a><span class="lineno"> 1233</span>  <span class="keywordtype">size_t</span> minalign_;</div> -<div class="line"><a name="l01234"></a><span class="lineno"> 1234</span> </div> -<div class="line"><a name="l01235"></a><span class="lineno"> 1235</span>  <span class="keywordtype">bool</span> force_defaults_; <span class="comment">// Serialize values equal to their defaults anyway.</span></div> -<div class="line"><a name="l01236"></a><span class="lineno"> 1236</span> </div> -<div class="line"><a name="l01237"></a><span class="lineno"> 1237</span>  <span class="keyword">struct </span>StringOffsetCompare {</div> -<div class="line"><a name="l01238"></a><span class="lineno"> 1238</span>  StringOffsetCompare(<span class="keyword">const</span> vector_downward &buf) : buf_(&buf) {}</div> -<div class="line"><a name="l01239"></a><span class="lineno"> 1239</span>  <span class="keywordtype">bool</span> operator() (<span class="keyword">const</span> Offset<String> &a, <span class="keyword">const</span> Offset<String> &b)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01240"></a><span class="lineno"> 1240</span>  <span class="keyword">auto</span> stra = <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>String *<span class="keyword">></span>(buf_->data_at(a.o));</div> -<div class="line"><a name="l01241"></a><span class="lineno"> 1241</span>  <span class="keyword">auto</span> strb = <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>String *<span class="keyword">></span>(buf_->data_at(b.o));</div> -<div class="line"><a name="l01242"></a><span class="lineno"> 1242</span>  <span class="keywordflow">return</span> strncmp(stra->c_str(), strb->c_str(),</div> -<div class="line"><a name="l01243"></a><span class="lineno"> 1243</span>  std::min(stra->size(), strb->size()) + 1) < 0;</div> -<div class="line"><a name="l01244"></a><span class="lineno"> 1244</span>  }</div> -<div class="line"><a name="l01245"></a><span class="lineno"> 1245</span>  <span class="keyword">const</span> vector_downward *buf_;</div> -<div class="line"><a name="l01246"></a><span class="lineno"> 1246</span>  };</div> -<div class="line"><a name="l01247"></a><span class="lineno"> 1247</span> </div> -<div class="line"><a name="l01248"></a><span class="lineno"> 1248</span>  <span class="comment">// For use with CreateSharedString. Instantiated on first use only.</span></div> -<div class="line"><a name="l01249"></a><span class="lineno"> 1249</span>  <span class="keyword">typedef</span> std::set<Offset<String>, StringOffsetCompare> StringOffsetMap;</div> -<div class="line"><a name="l01250"></a><span class="lineno"> 1250</span>  StringOffsetMap *string_pool;</div> -<div class="line"><a name="l01251"></a><span class="lineno"> 1251</span> };<span class="comment"></span></div> -<div class="line"><a name="l01252"></a><span class="lineno"> 1252</span> <span class="comment">/// @}</span></div> -<div class="line"><a name="l01253"></a><span class="lineno"> 1253</span> <span class="comment"></span><span class="comment"></span></div> -<div class="line"><a name="l01254"></a><span class="lineno"> 1254</span> <span class="comment">/// @cond FLATBUFFERS_INTERNAL</span></div> -<div class="line"><a name="l01255"></a><span class="lineno"> 1255</span> <span class="comment"></span><span class="comment">// Helpers to get a typed pointer to the root object contained in the buffer.</span></div> -<div class="line"><a name="l01256"></a><span class="lineno"> 1256</span> <span class="keyword">template</span><<span class="keyword">typename</span> T> T *GetMutableRoot(<span class="keywordtype">void</span> *buf) {</div> -<div class="line"><a name="l01257"></a><span class="lineno"> 1257</span>  EndianCheck();</div> -<div class="line"><a name="l01258"></a><span class="lineno"> 1258</span>  <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span>T *<span class="keyword">></span>(<span class="keyword">reinterpret_cast<</span>uint8_t *<span class="keyword">></span>(buf) +</div> -<div class="line"><a name="l01259"></a><span class="lineno"> 1259</span>  EndianScalar(*reinterpret_cast<uoffset_t *>(buf)));</div> -<div class="line"><a name="l01260"></a><span class="lineno"> 1260</span> }</div> +<div class="line"><a name="l01218"></a><span class="lineno"> 1218</span>  <span class="keyword">private</span>:</div> +<div class="line"><a name="l01219"></a><span class="lineno"> 1219</span>  <span class="comment">// You shouldn't really be copying instances of this class.</span></div> +<div class="line"><a name="l01220"></a><span class="lineno"> 1220</span>  <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac72b54a75e0c329e0ce0b8fab758e256">FlatBufferBuilder</a>(<span class="keyword">const</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html">FlatBufferBuilder</a> &);</div> +<div class="line"><a name="l01221"></a><span class="lineno"> 1221</span>  <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html">FlatBufferBuilder</a> &operator=(<span class="keyword">const</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html">FlatBufferBuilder</a> &);</div> +<div class="line"><a name="l01222"></a><span class="lineno"> 1222</span> </div> +<div class="line"><a name="l01223"></a><span class="lineno"> 1223</span>  <span class="keywordtype">void</span> <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#a0c9e507b373d598b51052fab4fa34912">Finish</a>(uoffset_t root, <span class="keyword">const</span> <span class="keywordtype">char</span> *file_identifier, <span class="keywordtype">bool</span> size_prefix) {</div> +<div class="line"><a name="l01224"></a><span class="lineno"> 1224</span>  NotNested();</div> +<div class="line"><a name="l01225"></a><span class="lineno"> 1225</span>  <span class="comment">// This will cause the whole buffer to be aligned.</span></div> +<div class="line"><a name="l01226"></a><span class="lineno"> 1226</span>  PreAlign((size_prefix ? <span class="keyword">sizeof</span>(uoffset_t) : 0) +</div> +<div class="line"><a name="l01227"></a><span class="lineno"> 1227</span>  <span class="keyword">sizeof</span>(uoffset_t) +</div> +<div class="line"><a name="l01228"></a><span class="lineno"> 1228</span>  (file_identifier ? <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#af8c7583c92e1d1d6f438977da5158d19">kFileIdentifierLength</a> : 0),</div> +<div class="line"><a name="l01229"></a><span class="lineno"> 1229</span>  minalign_);</div> +<div class="line"><a name="l01230"></a><span class="lineno"> 1230</span>  <span class="keywordflow">if</span> (file_identifier) {</div> +<div class="line"><a name="l01231"></a><span class="lineno"> 1231</span>  assert(strlen(file_identifier) == <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#af8c7583c92e1d1d6f438977da5158d19">kFileIdentifierLength</a>);</div> +<div class="line"><a name="l01232"></a><span class="lineno"> 1232</span>  buf_.push(reinterpret_cast<const uint8_t *>(file_identifier),</div> +<div class="line"><a name="l01233"></a><span class="lineno"> 1233</span>  <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#af8c7583c92e1d1d6f438977da5158d19">kFileIdentifierLength</a>);</div> +<div class="line"><a name="l01234"></a><span class="lineno"> 1234</span>  }</div> +<div class="line"><a name="l01235"></a><span class="lineno"> 1235</span>  PushElement(ReferTo(root)); <span class="comment">// Location of root.</span></div> +<div class="line"><a name="l01236"></a><span class="lineno"> 1236</span>  <span class="keywordflow">if</span> (size_prefix) {</div> +<div class="line"><a name="l01237"></a><span class="lineno"> 1237</span>  PushElement(<a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">GetSize</a>());</div> +<div class="line"><a name="l01238"></a><span class="lineno"> 1238</span>  }</div> +<div class="line"><a name="l01239"></a><span class="lineno"> 1239</span>  finished = <span class="keyword">true</span>;</div> +<div class="line"><a name="l01240"></a><span class="lineno"> 1240</span>  }</div> +<div class="line"><a name="l01241"></a><span class="lineno"> 1241</span> </div> +<div class="line"><a name="l01242"></a><span class="lineno"> 1242</span>  <span class="keyword">struct </span>FieldLoc {</div> +<div class="line"><a name="l01243"></a><span class="lineno"> 1243</span>  uoffset_t off;</div> +<div class="line"><a name="l01244"></a><span class="lineno"> 1244</span>  voffset_t id;</div> +<div class="line"><a name="l01245"></a><span class="lineno"> 1245</span>  };</div> +<div class="line"><a name="l01246"></a><span class="lineno"> 1246</span> </div> +<div class="line"><a name="l01247"></a><span class="lineno"> 1247</span>  simple_allocator default_allocator;</div> +<div class="line"><a name="l01248"></a><span class="lineno"> 1248</span> </div> +<div class="line"><a name="l01249"></a><span class="lineno"> 1249</span>  vector_downward buf_;</div> +<div class="line"><a name="l01250"></a><span class="lineno"> 1250</span> </div> +<div class="line"><a name="l01251"></a><span class="lineno"> 1251</span>  <span class="comment">// Accumulating offsets of table members while it is being built.</span></div> +<div class="line"><a name="l01252"></a><span class="lineno"> 1252</span>  std::vector<FieldLoc> offsetbuf_;</div> +<div class="line"><a name="l01253"></a><span class="lineno"> 1253</span> </div> +<div class="line"><a name="l01254"></a><span class="lineno"> 1254</span>  <span class="comment">// Ensure objects are not nested.</span></div> +<div class="line"><a name="l01255"></a><span class="lineno"> 1255</span>  <span class="keywordtype">bool</span> nested;</div> +<div class="line"><a name="l01256"></a><span class="lineno"> 1256</span> </div> +<div class="line"><a name="l01257"></a><span class="lineno"> 1257</span>  <span class="comment">// Ensure the buffer is finished before it is being accessed.</span></div> +<div class="line"><a name="l01258"></a><span class="lineno"> 1258</span>  <span class="keywordtype">bool</span> finished;</div> +<div class="line"><a name="l01259"></a><span class="lineno"> 1259</span> </div> +<div class="line"><a name="l01260"></a><span class="lineno"> 1260</span>  std::vector<uoffset_t> vtables_; <span class="comment">// todo: Could make this into a map?</span></div> <div class="line"><a name="l01261"></a><span class="lineno"> 1261</span> </div> -<div class="line"><a name="l01262"></a><span class="lineno"> 1262</span> <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keyword">const</span> T *GetRoot(<span class="keyword">const</span> <span class="keywordtype">void</span> *buf) {</div> -<div class="line"><a name="l01263"></a><span class="lineno"> 1263</span>  <span class="keywordflow">return</span> GetMutableRoot<T>(<span class="keyword">const_cast<</span><span class="keywordtype">void</span> *<span class="keyword">></span>(buf));</div> -<div class="line"><a name="l01264"></a><span class="lineno"> 1264</span> }</div> +<div class="line"><a name="l01262"></a><span class="lineno"> 1262</span>  <span class="keywordtype">size_t</span> minalign_;</div> +<div class="line"><a name="l01263"></a><span class="lineno"> 1263</span> </div> +<div class="line"><a name="l01264"></a><span class="lineno"> 1264</span>  <span class="keywordtype">bool</span> force_defaults_; <span class="comment">// Serialize values equal to their defaults anyway.</span></div> <div class="line"><a name="l01265"></a><span class="lineno"> 1265</span> </div> -<div class="line"><a name="l01266"></a><span class="lineno"> 1266</span> <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keyword">const</span> T *GetSizePrefixedRoot(<span class="keyword">const</span> <span class="keywordtype">void</span> *buf) {</div> -<div class="line"><a name="l01267"></a><span class="lineno"> 1267</span>  <span class="keywordflow">return</span> GetRoot<T>(<span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>uint8_t *<span class="keyword">></span>(buf) + <span class="keyword">sizeof</span>(uoffset_t));</div> -<div class="line"><a name="l01268"></a><span class="lineno"> 1268</span> }</div> -<div class="line"><a name="l01269"></a><span class="lineno"> 1269</span> <span class="comment"></span></div> -<div class="line"><a name="l01270"></a><span class="lineno"> 1270</span> <span class="comment">/// Helpers to get a typed pointer to objects that are currently being built.</span></div> -<div class="line"><a name="l01271"></a><span class="lineno"> 1271</span> <span class="comment">/// @warning Creating new objects will lead to reallocations and invalidates</span></div> -<div class="line"><a name="l01272"></a><span class="lineno"> 1272</span> <span class="comment">/// the pointer!</span></div> -<div class="line"><a name="l01273"></a><span class="lineno"> 1273</span> <span class="comment"></span><span class="keyword">template</span><<span class="keyword">typename</span> T> T *GetMutableTemporaryPointer(FlatBufferBuilder &fbb,</div> -<div class="line"><a name="l01274"></a><span class="lineno"> 1274</span>  Offset<T> offset) {</div> -<div class="line"><a name="l01275"></a><span class="lineno"> 1275</span>  <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span>T *<span class="keyword">></span>(fbb.GetCurrentBufferPointer() +</div> -<div class="line"><a name="l01276"></a><span class="lineno"> 1276</span>  fbb.GetSize() - offset.o);</div> -<div class="line"><a name="l01277"></a><span class="lineno"> 1277</span> }</div> -<div class="line"><a name="l01278"></a><span class="lineno"> 1278</span> </div> -<div class="line"><a name="l01279"></a><span class="lineno"> 1279</span> <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keyword">const</span> T *GetTemporaryPointer(FlatBufferBuilder &fbb,</div> -<div class="line"><a name="l01280"></a><span class="lineno"> 1280</span>  Offset<T> offset) {</div> -<div class="line"><a name="l01281"></a><span class="lineno"> 1281</span>  <span class="keywordflow">return</span> GetMutableTemporaryPointer<T>(fbb, offset);</div> -<div class="line"><a name="l01282"></a><span class="lineno"> 1282</span> }</div> -<div class="line"><a name="l01283"></a><span class="lineno"> 1283</span> </div> -<div class="line"><a name="l01284"></a><span class="lineno"> 1284</span> <span class="comment">// Helper to see if the identifier in a buffer has the expected value.</span></div> -<div class="line"><a name="l01285"></a><span class="lineno"> 1285</span> <span class="keyword">inline</span> <span class="keywordtype">bool</span> BufferHasIdentifier(<span class="keyword">const</span> <span class="keywordtype">void</span> *buf, <span class="keyword">const</span> <span class="keywordtype">char</span> *identifier) {</div> -<div class="line"><a name="l01286"></a><span class="lineno"> 1286</span>  <span class="keywordflow">return</span> strncmp(reinterpret_cast<const char *>(buf) + <span class="keyword">sizeof</span>(uoffset_t),</div> -<div class="line"><a name="l01287"></a><span class="lineno"> 1287</span>  identifier, <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#af8c7583c92e1d1d6f438977da5158d19">FlatBufferBuilder::kFileIdentifierLength</a>) == 0;</div> -<div class="line"><a name="l01288"></a><span class="lineno"> 1288</span> }</div> -<div class="line"><a name="l01289"></a><span class="lineno"> 1289</span> </div> -<div class="line"><a name="l01290"></a><span class="lineno"> 1290</span> <span class="comment">// Helper class to verify the integrity of a FlatBuffer</span></div> -<div class="line"><a name="l01291"></a><span class="lineno"> 1291</span> <span class="keyword">class </span>Verifier FLATBUFFERS_FINAL_CLASS {</div> -<div class="line"><a name="l01292"></a><span class="lineno"> 1292</span>  <span class="keyword">public</span>:</div> -<div class="line"><a name="l01293"></a><span class="lineno"> 1293</span>  Verifier(<span class="keyword">const</span> uint8_t *buf, <span class="keywordtype">size_t</span> buf_len, <span class="keywordtype">size_t</span> _max_depth = 64,</div> -<div class="line"><a name="l01294"></a><span class="lineno"> 1294</span>  <span class="keywordtype">size_t</span> _max_tables = 1000000)</div> -<div class="line"><a name="l01295"></a><span class="lineno"> 1295</span>  : buf_(buf), end_(buf + buf_len), depth_(0), max_depth_(_max_depth),</div> -<div class="line"><a name="l01296"></a><span class="lineno"> 1296</span>  num_tables_(0), max_tables_(_max_tables)</div> -<div class="line"><a name="l01297"></a><span class="lineno"> 1297</span>  #ifdef FLATBUFFERS_TRACK_VERIFIER_BUFFER_SIZE</div> -<div class="line"><a name="l01298"></a><span class="lineno"> 1298</span>  , upper_bound_(buf)</div> -<div class="line"><a name="l01299"></a><span class="lineno"> 1299</span>  #endif</div> -<div class="line"><a name="l01300"></a><span class="lineno"> 1300</span>  {}</div> -<div class="line"><a name="l01301"></a><span class="lineno"> 1301</span> </div> -<div class="line"><a name="l01302"></a><span class="lineno"> 1302</span>  <span class="comment">// Central location where any verification failures register.</span></div> -<div class="line"><a name="l01303"></a><span class="lineno"> 1303</span>  <span class="keywordtype">bool</span> Check(<span class="keywordtype">bool</span> ok)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01304"></a><span class="lineno"> 1304</span> <span class="preprocessor"> #ifdef FLATBUFFERS_DEBUG_VERIFICATION_FAILURE</span></div> -<div class="line"><a name="l01305"></a><span class="lineno"> 1305</span>  assert(ok);</div> -<div class="line"><a name="l01306"></a><span class="lineno"> 1306</span> <span class="preprocessor"> #endif</span></div> -<div class="line"><a name="l01307"></a><span class="lineno"> 1307</span> <span class="preprocessor"> #ifdef FLATBUFFERS_TRACK_VERIFIER_BUFFER_SIZE</span></div> -<div class="line"><a name="l01308"></a><span class="lineno"> 1308</span>  <span class="keywordflow">if</span> (!ok)</div> -<div class="line"><a name="l01309"></a><span class="lineno"> 1309</span>  upper_bound_ = buf_;</div> -<div class="line"><a name="l01310"></a><span class="lineno"> 1310</span> <span class="preprocessor"> #endif</span></div> -<div class="line"><a name="l01311"></a><span class="lineno"> 1311</span>  <span class="keywordflow">return</span> ok;</div> -<div class="line"><a name="l01312"></a><span class="lineno"> 1312</span>  }</div> -<div class="line"><a name="l01313"></a><span class="lineno"> 1313</span> </div> -<div class="line"><a name="l01314"></a><span class="lineno"> 1314</span>  <span class="comment">// Verify any range within the buffer.</span></div> -<div class="line"><a name="l01315"></a><span class="lineno"> 1315</span>  <span class="keywordtype">bool</span> Verify(<span class="keyword">const</span> <span class="keywordtype">void</span> *elem, <span class="keywordtype">size_t</span> elem_len)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01316"></a><span class="lineno"> 1316</span> <span class="preprocessor"> #ifdef FLATBUFFERS_TRACK_VERIFIER_BUFFER_SIZE</span></div> -<div class="line"><a name="l01317"></a><span class="lineno"> 1317</span>  <span class="keyword">auto</span> upper_bound = <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>uint8_t *<span class="keyword">></span>(elem) + elem_len;</div> -<div class="line"><a name="l01318"></a><span class="lineno"> 1318</span>  <span class="keywordflow">if</span> (upper_bound_ < upper_bound)</div> -<div class="line"><a name="l01319"></a><span class="lineno"> 1319</span>  upper_bound_ = upper_bound;</div> -<div class="line"><a name="l01320"></a><span class="lineno"> 1320</span> <span class="preprocessor"> #endif</span></div> -<div class="line"><a name="l01321"></a><span class="lineno"> 1321</span>  <span class="keywordflow">return</span> Check(elem_len <= (<span class="keywordtype">size_t</span>) (end_ - buf_) &&</div> -<div class="line"><a name="l01322"></a><span class="lineno"> 1322</span>  elem >= buf_ &&</div> -<div class="line"><a name="l01323"></a><span class="lineno"> 1323</span>  elem <= end_ - elem_len);</div> -<div class="line"><a name="l01324"></a><span class="lineno"> 1324</span>  }</div> -<div class="line"><a name="l01325"></a><span class="lineno"> 1325</span> </div> -<div class="line"><a name="l01326"></a><span class="lineno"> 1326</span>  <span class="comment">// Verify a range indicated by sizeof(T).</span></div> -<div class="line"><a name="l01327"></a><span class="lineno"> 1327</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> Verify(<span class="keyword">const</span> <span class="keywordtype">void</span> *elem)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01328"></a><span class="lineno"> 1328</span>  <span class="keywordflow">return</span> Verify(elem, <span class="keyword">sizeof</span>(T));</div> -<div class="line"><a name="l01329"></a><span class="lineno"> 1329</span>  }</div> +<div class="line"><a name="l01266"></a><span class="lineno"> 1266</span>  <span class="keyword">struct </span>StringOffsetCompare {</div> +<div class="line"><a name="l01267"></a><span class="lineno"> 1267</span>  StringOffsetCompare(<span class="keyword">const</span> vector_downward &buf) : buf_(&buf) {}</div> +<div class="line"><a name="l01268"></a><span class="lineno"> 1268</span>  <span class="keywordtype">bool</span> operator() (<span class="keyword">const</span> Offset<String> &a, <span class="keyword">const</span> Offset<String> &b)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01269"></a><span class="lineno"> 1269</span>  <span class="keyword">auto</span> stra = <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>String *<span class="keyword">></span>(buf_->data_at(a.o));</div> +<div class="line"><a name="l01270"></a><span class="lineno"> 1270</span>  <span class="keyword">auto</span> strb = <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>String *<span class="keyword">></span>(buf_->data_at(b.o));</div> +<div class="line"><a name="l01271"></a><span class="lineno"> 1271</span>  <span class="keywordflow">return</span> strncmp(stra->c_str(), strb->c_str(),</div> +<div class="line"><a name="l01272"></a><span class="lineno"> 1272</span>  std::min(stra->size(), strb->size()) + 1) < 0;</div> +<div class="line"><a name="l01273"></a><span class="lineno"> 1273</span>  }</div> +<div class="line"><a name="l01274"></a><span class="lineno"> 1274</span>  <span class="keyword">const</span> vector_downward *buf_;</div> +<div class="line"><a name="l01275"></a><span class="lineno"> 1275</span>  };</div> +<div class="line"><a name="l01276"></a><span class="lineno"> 1276</span> </div> +<div class="line"><a name="l01277"></a><span class="lineno"> 1277</span>  <span class="comment">// For use with CreateSharedString. Instantiated on first use only.</span></div> +<div class="line"><a name="l01278"></a><span class="lineno"> 1278</span>  <span class="keyword">typedef</span> std::set<Offset<String>, StringOffsetCompare> StringOffsetMap;</div> +<div class="line"><a name="l01279"></a><span class="lineno"> 1279</span>  StringOffsetMap *string_pool;</div> +<div class="line"><a name="l01280"></a><span class="lineno"> 1280</span> };<span class="comment"></span></div> +<div class="line"><a name="l01281"></a><span class="lineno"> 1281</span> <span class="comment">/// @}</span></div> +<div class="line"><a name="l01282"></a><span class="lineno"> 1282</span> <span class="comment"></span><span class="comment"></span></div> +<div class="line"><a name="l01283"></a><span class="lineno"> 1283</span> <span class="comment">/// @cond FLATBUFFERS_INTERNAL</span></div> +<div class="line"><a name="l01284"></a><span class="lineno"> 1284</span> <span class="comment"></span><span class="comment">// Helpers to get a typed pointer to the root object contained in the buffer.</span></div> +<div class="line"><a name="l01285"></a><span class="lineno"> 1285</span> <span class="keyword">template</span><<span class="keyword">typename</span> T> T *GetMutableRoot(<span class="keywordtype">void</span> *buf) {</div> +<div class="line"><a name="l01286"></a><span class="lineno"> 1286</span>  EndianCheck();</div> +<div class="line"><a name="l01287"></a><span class="lineno"> 1287</span>  <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span>T *<span class="keyword">></span>(<span class="keyword">reinterpret_cast<</span>uint8_t *<span class="keyword">></span>(buf) +</div> +<div class="line"><a name="l01288"></a><span class="lineno"> 1288</span>  EndianScalar(*reinterpret_cast<uoffset_t *>(buf)));</div> +<div class="line"><a name="l01289"></a><span class="lineno"> 1289</span> }</div> +<div class="line"><a name="l01290"></a><span class="lineno"> 1290</span> </div> +<div class="line"><a name="l01291"></a><span class="lineno"> 1291</span> <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keyword">const</span> T *GetRoot(<span class="keyword">const</span> <span class="keywordtype">void</span> *buf) {</div> +<div class="line"><a name="l01292"></a><span class="lineno"> 1292</span>  <span class="keywordflow">return</span> GetMutableRoot<T>(<span class="keyword">const_cast<</span><span class="keywordtype">void</span> *<span class="keyword">></span>(buf));</div> +<div class="line"><a name="l01293"></a><span class="lineno"> 1293</span> }</div> +<div class="line"><a name="l01294"></a><span class="lineno"> 1294</span> </div> +<div class="line"><a name="l01295"></a><span class="lineno"> 1295</span> <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keyword">const</span> T *GetSizePrefixedRoot(<span class="keyword">const</span> <span class="keywordtype">void</span> *buf) {</div> +<div class="line"><a name="l01296"></a><span class="lineno"> 1296</span>  <span class="keywordflow">return</span> GetRoot<T>(<span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>uint8_t *<span class="keyword">></span>(buf) + <span class="keyword">sizeof</span>(uoffset_t));</div> +<div class="line"><a name="l01297"></a><span class="lineno"> 1297</span> }</div> +<div class="line"><a name="l01298"></a><span class="lineno"> 1298</span> <span class="comment"></span></div> +<div class="line"><a name="l01299"></a><span class="lineno"> 1299</span> <span class="comment">/// Helpers to get a typed pointer to objects that are currently being built.</span></div> +<div class="line"><a name="l01300"></a><span class="lineno"> 1300</span> <span class="comment">/// @warning Creating new objects will lead to reallocations and invalidates</span></div> +<div class="line"><a name="l01301"></a><span class="lineno"> 1301</span> <span class="comment">/// the pointer!</span></div> +<div class="line"><a name="l01302"></a><span class="lineno"> 1302</span> <span class="comment"></span><span class="keyword">template</span><<span class="keyword">typename</span> T> T *GetMutableTemporaryPointer(FlatBufferBuilder &fbb,</div> +<div class="line"><a name="l01303"></a><span class="lineno"> 1303</span>  Offset<T> offset) {</div> +<div class="line"><a name="l01304"></a><span class="lineno"> 1304</span>  <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span>T *<span class="keyword">></span>(fbb.GetCurrentBufferPointer() +</div> +<div class="line"><a name="l01305"></a><span class="lineno"> 1305</span>  fbb.GetSize() - offset.o);</div> +<div class="line"><a name="l01306"></a><span class="lineno"> 1306</span> }</div> +<div class="line"><a name="l01307"></a><span class="lineno"> 1307</span> </div> +<div class="line"><a name="l01308"></a><span class="lineno"> 1308</span> <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keyword">const</span> T *GetTemporaryPointer(FlatBufferBuilder &fbb,</div> +<div class="line"><a name="l01309"></a><span class="lineno"> 1309</span>  Offset<T> offset) {</div> +<div class="line"><a name="l01310"></a><span class="lineno"> 1310</span>  <span class="keywordflow">return</span> GetMutableTemporaryPointer<T>(fbb, offset);</div> +<div class="line"><a name="l01311"></a><span class="lineno"> 1311</span> }</div> +<div class="line"><a name="l01312"></a><span class="lineno"> 1312</span> </div> +<div class="line"><a name="l01313"></a><span class="lineno"> 1313</span> <span class="comment">// Helper to see if the identifier in a buffer has the expected value.</span></div> +<div class="line"><a name="l01314"></a><span class="lineno"> 1314</span> <span class="keyword">inline</span> <span class="keywordtype">bool</span> BufferHasIdentifier(<span class="keyword">const</span> <span class="keywordtype">void</span> *buf, <span class="keyword">const</span> <span class="keywordtype">char</span> *identifier) {</div> +<div class="line"><a name="l01315"></a><span class="lineno"> 1315</span>  <span class="keywordflow">return</span> strncmp(reinterpret_cast<const char *>(buf) + <span class="keyword">sizeof</span>(uoffset_t),</div> +<div class="line"><a name="l01316"></a><span class="lineno"> 1316</span>  identifier, <a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#af8c7583c92e1d1d6f438977da5158d19">FlatBufferBuilder::kFileIdentifierLength</a>) == 0;</div> +<div class="line"><a name="l01317"></a><span class="lineno"> 1317</span> }</div> +<div class="line"><a name="l01318"></a><span class="lineno"> 1318</span> </div> +<div class="line"><a name="l01319"></a><span class="lineno"> 1319</span> <span class="comment">// Helper class to verify the integrity of a FlatBuffer</span></div> +<div class="line"><a name="l01320"></a><span class="lineno"> 1320</span> <span class="keyword">class </span>Verifier FLATBUFFERS_FINAL_CLASS {</div> +<div class="line"><a name="l01321"></a><span class="lineno"> 1321</span>  <span class="keyword">public</span>:</div> +<div class="line"><a name="l01322"></a><span class="lineno"> 1322</span>  Verifier(<span class="keyword">const</span> uint8_t *buf, <span class="keywordtype">size_t</span> buf_len, <span class="keywordtype">size_t</span> _max_depth = 64,</div> +<div class="line"><a name="l01323"></a><span class="lineno"> 1323</span>  <span class="keywordtype">size_t</span> _max_tables = 1000000)</div> +<div class="line"><a name="l01324"></a><span class="lineno"> 1324</span>  : buf_(buf), end_(buf + buf_len), depth_(0), max_depth_(_max_depth),</div> +<div class="line"><a name="l01325"></a><span class="lineno"> 1325</span>  num_tables_(0), max_tables_(_max_tables)</div> +<div class="line"><a name="l01326"></a><span class="lineno"> 1326</span>  #ifdef FLATBUFFERS_TRACK_VERIFIER_BUFFER_SIZE</div> +<div class="line"><a name="l01327"></a><span class="lineno"> 1327</span>  , upper_bound_(buf)</div> +<div class="line"><a name="l01328"></a><span class="lineno"> 1328</span>  #endif</div> +<div class="line"><a name="l01329"></a><span class="lineno"> 1329</span>  {}</div> <div class="line"><a name="l01330"></a><span class="lineno"> 1330</span> </div> -<div class="line"><a name="l01331"></a><span class="lineno"> 1331</span>  <span class="comment">// Verify a pointer (may be NULL) of a table type.</span></div> -<div class="line"><a name="l01332"></a><span class="lineno"> 1332</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> VerifyTable(<span class="keyword">const</span> T *table) {</div> -<div class="line"><a name="l01333"></a><span class="lineno"> 1333</span>  <span class="keywordflow">return</span> !table || table->Verify(*<span class="keyword">this</span>);</div> -<div class="line"><a name="l01334"></a><span class="lineno"> 1334</span>  }</div> -<div class="line"><a name="l01335"></a><span class="lineno"> 1335</span> </div> -<div class="line"><a name="l01336"></a><span class="lineno"> 1336</span>  <span class="comment">// Verify a pointer (may be NULL) of any vector type.</span></div> -<div class="line"><a name="l01337"></a><span class="lineno"> 1337</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> Verify(<span class="keyword">const</span> Vector<T> *vec)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01338"></a><span class="lineno"> 1338</span>  <span class="keyword">const</span> uint8_t *end;</div> -<div class="line"><a name="l01339"></a><span class="lineno"> 1339</span>  <span class="keywordflow">return</span> !vec ||</div> -<div class="line"><a name="l01340"></a><span class="lineno"> 1340</span>  VerifyVector(reinterpret_cast<const uint8_t *>(vec), <span class="keyword">sizeof</span>(T),</div> -<div class="line"><a name="l01341"></a><span class="lineno"> 1341</span>  &end);</div> -<div class="line"><a name="l01342"></a><span class="lineno"> 1342</span>  }</div> -<div class="line"><a name="l01343"></a><span class="lineno"> 1343</span> </div> -<div class="line"><a name="l01344"></a><span class="lineno"> 1344</span>  <span class="comment">// Verify a pointer (may be NULL) of a vector to struct.</span></div> -<div class="line"><a name="l01345"></a><span class="lineno"> 1345</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> Verify(<span class="keyword">const</span> Vector<const T *> *vec)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01346"></a><span class="lineno"> 1346</span>  <span class="keywordflow">return</span> Verify(<span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>Vector<T> *<span class="keyword">></span>(vec));</div> -<div class="line"><a name="l01347"></a><span class="lineno"> 1347</span>  }</div> -<div class="line"><a name="l01348"></a><span class="lineno"> 1348</span> </div> -<div class="line"><a name="l01349"></a><span class="lineno"> 1349</span>  <span class="comment">// Verify a pointer (may be NULL) to string.</span></div> -<div class="line"><a name="l01350"></a><span class="lineno"> 1350</span>  <span class="keywordtype">bool</span> Verify(<span class="keyword">const</span> String *str)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01351"></a><span class="lineno"> 1351</span>  <span class="keyword">const</span> uint8_t *end;</div> -<div class="line"><a name="l01352"></a><span class="lineno"> 1352</span>  <span class="keywordflow">return</span> !str ||</div> -<div class="line"><a name="l01353"></a><span class="lineno"> 1353</span>  (VerifyVector(reinterpret_cast<const uint8_t *>(str), 1, &end) &&</div> -<div class="line"><a name="l01354"></a><span class="lineno"> 1354</span>  Verify(end, 1) && <span class="comment">// Must have terminator</span></div> -<div class="line"><a name="l01355"></a><span class="lineno"> 1355</span>  Check(*end == <span class="charliteral">'\0'</span>)); <span class="comment">// Terminating byte must be 0.</span></div> -<div class="line"><a name="l01356"></a><span class="lineno"> 1356</span>  }</div> -<div class="line"><a name="l01357"></a><span class="lineno"> 1357</span> </div> -<div class="line"><a name="l01358"></a><span class="lineno"> 1358</span>  <span class="comment">// Common code between vectors and strings.</span></div> -<div class="line"><a name="l01359"></a><span class="lineno"> 1359</span>  <span class="keywordtype">bool</span> VerifyVector(<span class="keyword">const</span> uint8_t *vec, <span class="keywordtype">size_t</span> elem_size,</div> -<div class="line"><a name="l01360"></a><span class="lineno"> 1360</span>  <span class="keyword">const</span> uint8_t **end)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01361"></a><span class="lineno"> 1361</span>  <span class="comment">// Check we can read the size field.</span></div> -<div class="line"><a name="l01362"></a><span class="lineno"> 1362</span>  <span class="keywordflow">if</span> (!Verify<uoffset_t>(vec)) <span class="keywordflow">return</span> <span class="keyword">false</span>;</div> -<div class="line"><a name="l01363"></a><span class="lineno"> 1363</span>  <span class="comment">// Check the whole array. If this is a string, the byte past the array</span></div> -<div class="line"><a name="l01364"></a><span class="lineno"> 1364</span>  <span class="comment">// must be 0.</span></div> -<div class="line"><a name="l01365"></a><span class="lineno"> 1365</span>  <span class="keyword">auto</span> size = ReadScalar<uoffset_t>(vec);</div> -<div class="line"><a name="l01366"></a><span class="lineno"> 1366</span>  <span class="keyword">auto</span> max_elems = FLATBUFFERS_MAX_BUFFER_SIZE / elem_size;</div> -<div class="line"><a name="l01367"></a><span class="lineno"> 1367</span>  <span class="keywordflow">if</span> (!Check(size < max_elems))</div> -<div class="line"><a name="l01368"></a><span class="lineno"> 1368</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>; <span class="comment">// Protect against byte_size overflowing.</span></div> -<div class="line"><a name="l01369"></a><span class="lineno"> 1369</span>  <span class="keyword">auto</span> byte_size = <span class="keyword">sizeof</span>(size) + elem_size * size;</div> -<div class="line"><a name="l01370"></a><span class="lineno"> 1370</span>  *end = vec + byte_size;</div> -<div class="line"><a name="l01371"></a><span class="lineno"> 1371</span>  <span class="keywordflow">return</span> Verify(vec, byte_size);</div> -<div class="line"><a name="l01372"></a><span class="lineno"> 1372</span>  }</div> -<div class="line"><a name="l01373"></a><span class="lineno"> 1373</span> </div> -<div class="line"><a name="l01374"></a><span class="lineno"> 1374</span>  <span class="comment">// Special case for string contents, after the above has been called.</span></div> -<div class="line"><a name="l01375"></a><span class="lineno"> 1375</span>  <span class="keywordtype">bool</span> VerifyVectorOfStrings(<span class="keyword">const</span> Vector<Offset<String>> *vec)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01376"></a><span class="lineno"> 1376</span>  <span class="keywordflow">if</span> (vec) {</div> -<div class="line"><a name="l01377"></a><span class="lineno"> 1377</span>  <span class="keywordflow">for</span> (uoffset_t i = 0; i < vec->size(); i++) {</div> -<div class="line"><a name="l01378"></a><span class="lineno"> 1378</span>  <span class="keywordflow">if</span> (!Verify(vec->Get(i))) <span class="keywordflow">return</span> <span class="keyword">false</span>;</div> -<div class="line"><a name="l01379"></a><span class="lineno"> 1379</span>  }</div> -<div class="line"><a name="l01380"></a><span class="lineno"> 1380</span>  }</div> -<div class="line"><a name="l01381"></a><span class="lineno"> 1381</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div> -<div class="line"><a name="l01382"></a><span class="lineno"> 1382</span>  }</div> -<div class="line"><a name="l01383"></a><span class="lineno"> 1383</span> </div> -<div class="line"><a name="l01384"></a><span class="lineno"> 1384</span>  <span class="comment">// Special case for table contents, after the above has been called.</span></div> -<div class="line"><a name="l01385"></a><span class="lineno"> 1385</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> VerifyVectorOfTables(<span class="keyword">const</span> Vector<Offset<T>> *vec) {</div> -<div class="line"><a name="l01386"></a><span class="lineno"> 1386</span>  <span class="keywordflow">if</span> (vec) {</div> -<div class="line"><a name="l01387"></a><span class="lineno"> 1387</span>  <span class="keywordflow">for</span> (uoffset_t i = 0; i < vec->size(); i++) {</div> -<div class="line"><a name="l01388"></a><span class="lineno"> 1388</span>  <span class="keywordflow">if</span> (!vec->Get(i)->Verify(*<span class="keyword">this</span>)) <span class="keywordflow">return</span> <span class="keyword">false</span>;</div> -<div class="line"><a name="l01389"></a><span class="lineno"> 1389</span>  }</div> -<div class="line"><a name="l01390"></a><span class="lineno"> 1390</span>  }</div> -<div class="line"><a name="l01391"></a><span class="lineno"> 1391</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div> -<div class="line"><a name="l01392"></a><span class="lineno"> 1392</span>  }</div> -<div class="line"><a name="l01393"></a><span class="lineno"> 1393</span> </div> -<div class="line"><a name="l01394"></a><span class="lineno"> 1394</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> VerifyBufferFromStart(<span class="keyword">const</span> <span class="keywordtype">char</span> *identifier,</div> -<div class="line"><a name="l01395"></a><span class="lineno"> 1395</span>  <span class="keyword">const</span> uint8_t *start) {</div> -<div class="line"><a name="l01396"></a><span class="lineno"> 1396</span>  <span class="keywordflow">if</span> (identifier &&</div> -<div class="line"><a name="l01397"></a><span class="lineno"> 1397</span>  (<span class="keywordtype">size_t</span>(end_ - start) < 2 * <span class="keyword">sizeof</span>(flatbuffers::uoffset_t) ||</div> -<div class="line"><a name="l01398"></a><span class="lineno"> 1398</span>  !BufferHasIdentifier(start, identifier))) {</div> -<div class="line"><a name="l01399"></a><span class="lineno"> 1399</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>;</div> -<div class="line"><a name="l01400"></a><span class="lineno"> 1400</span>  }</div> -<div class="line"><a name="l01401"></a><span class="lineno"> 1401</span> </div> -<div class="line"><a name="l01402"></a><span class="lineno"> 1402</span>  <span class="comment">// Call T::Verify, which must be in the generated code for this type.</span></div> -<div class="line"><a name="l01403"></a><span class="lineno"> 1403</span>  <span class="keywordflow">return</span> Verify<uoffset_t>(start) &&</div> -<div class="line"><a name="l01404"></a><span class="lineno"> 1404</span>  reinterpret_cast<const T *>(start + ReadScalar<uoffset_t>(start))-></div> -<div class="line"><a name="l01405"></a><span class="lineno"> 1405</span>  Verify(*<span class="keyword">this</span>)</div> -<div class="line"><a name="l01406"></a><span class="lineno"> 1406</span>  <span class="preprocessor">#ifdef FLATBUFFERS_TRACK_VERIFIER_BUFFER_SIZE</span></div> -<div class="line"><a name="l01407"></a><span class="lineno"> 1407</span>  && GetComputedSize()</div> -<div class="line"><a name="l01408"></a><span class="lineno"> 1408</span>  <span class="preprocessor">#endif</span></div> -<div class="line"><a name="l01409"></a><span class="lineno"> 1409</span>  ;</div> -<div class="line"><a name="l01410"></a><span class="lineno"> 1410</span>  }</div> -<div class="line"><a name="l01411"></a><span class="lineno"> 1411</span> </div> -<div class="line"><a name="l01412"></a><span class="lineno"> 1412</span>  <span class="comment">// Verify this whole buffer, starting with root type T.</span></div> -<div class="line"><a name="l01413"></a><span class="lineno"> 1413</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> VerifyBuffer(<span class="keyword">const</span> <span class="keywordtype">char</span> *identifier) {</div> -<div class="line"><a name="l01414"></a><span class="lineno"> 1414</span>  <span class="keywordflow">return</span> VerifyBufferFromStart<T>(identifier, buf_);</div> -<div class="line"><a name="l01415"></a><span class="lineno"> 1415</span>  }</div> -<div class="line"><a name="l01416"></a><span class="lineno"> 1416</span> </div> -<div class="line"><a name="l01417"></a><span class="lineno"> 1417</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> VerifySizePrefixedBuffer(<span class="keyword">const</span> <span class="keywordtype">char</span> *identifier) {</div> -<div class="line"><a name="l01418"></a><span class="lineno"> 1418</span>  <span class="keywordflow">return</span> Verify<uoffset_t>(buf_) &&</div> -<div class="line"><a name="l01419"></a><span class="lineno"> 1419</span>  ReadScalar<uoffset_t>(buf_) == end_ - buf_ - <span class="keyword">sizeof</span>(uoffset_t) &&</div> -<div class="line"><a name="l01420"></a><span class="lineno"> 1420</span>  VerifyBufferFromStart<T>(identifier, buf_ + <span class="keyword">sizeof</span>(uoffset_t));</div> +<div class="line"><a name="l01331"></a><span class="lineno"> 1331</span>  <span class="comment">// Central location where any verification failures register.</span></div> +<div class="line"><a name="l01332"></a><span class="lineno"> 1332</span>  <span class="keywordtype">bool</span> Check(<span class="keywordtype">bool</span> ok)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01333"></a><span class="lineno"> 1333</span> <span class="preprocessor"> #ifdef FLATBUFFERS_DEBUG_VERIFICATION_FAILURE</span></div> +<div class="line"><a name="l01334"></a><span class="lineno"> 1334</span>  assert(ok);</div> +<div class="line"><a name="l01335"></a><span class="lineno"> 1335</span> <span class="preprocessor"> #endif</span></div> +<div class="line"><a name="l01336"></a><span class="lineno"> 1336</span> <span class="preprocessor"> #ifdef FLATBUFFERS_TRACK_VERIFIER_BUFFER_SIZE</span></div> +<div class="line"><a name="l01337"></a><span class="lineno"> 1337</span>  <span class="keywordflow">if</span> (!ok)</div> +<div class="line"><a name="l01338"></a><span class="lineno"> 1338</span>  upper_bound_ = buf_;</div> +<div class="line"><a name="l01339"></a><span class="lineno"> 1339</span> <span class="preprocessor"> #endif</span></div> +<div class="line"><a name="l01340"></a><span class="lineno"> 1340</span>  <span class="keywordflow">return</span> ok;</div> +<div class="line"><a name="l01341"></a><span class="lineno"> 1341</span>  }</div> +<div class="line"><a name="l01342"></a><span class="lineno"> 1342</span> </div> +<div class="line"><a name="l01343"></a><span class="lineno"> 1343</span>  <span class="comment">// Verify any range within the buffer.</span></div> +<div class="line"><a name="l01344"></a><span class="lineno"> 1344</span>  <span class="keywordtype">bool</span> Verify(<span class="keyword">const</span> <span class="keywordtype">void</span> *elem, <span class="keywordtype">size_t</span> elem_len)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01345"></a><span class="lineno"> 1345</span> <span class="preprocessor"> #ifdef FLATBUFFERS_TRACK_VERIFIER_BUFFER_SIZE</span></div> +<div class="line"><a name="l01346"></a><span class="lineno"> 1346</span>  <span class="keyword">auto</span> upper_bound = <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>uint8_t *<span class="keyword">></span>(elem) + elem_len;</div> +<div class="line"><a name="l01347"></a><span class="lineno"> 1347</span>  <span class="keywordflow">if</span> (upper_bound_ < upper_bound)</div> +<div class="line"><a name="l01348"></a><span class="lineno"> 1348</span>  upper_bound_ = upper_bound;</div> +<div class="line"><a name="l01349"></a><span class="lineno"> 1349</span> <span class="preprocessor"> #endif</span></div> +<div class="line"><a name="l01350"></a><span class="lineno"> 1350</span>  <span class="keywordflow">return</span> Check(elem_len <= (<span class="keywordtype">size_t</span>) (end_ - buf_) &&</div> +<div class="line"><a name="l01351"></a><span class="lineno"> 1351</span>  elem >= buf_ &&</div> +<div class="line"><a name="l01352"></a><span class="lineno"> 1352</span>  elem <= end_ - elem_len);</div> +<div class="line"><a name="l01353"></a><span class="lineno"> 1353</span>  }</div> +<div class="line"><a name="l01354"></a><span class="lineno"> 1354</span> </div> +<div class="line"><a name="l01355"></a><span class="lineno"> 1355</span>  <span class="comment">// Verify a range indicated by sizeof(T).</span></div> +<div class="line"><a name="l01356"></a><span class="lineno"> 1356</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> Verify(<span class="keyword">const</span> <span class="keywordtype">void</span> *elem)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01357"></a><span class="lineno"> 1357</span>  <span class="keywordflow">return</span> Verify(elem, <span class="keyword">sizeof</span>(T));</div> +<div class="line"><a name="l01358"></a><span class="lineno"> 1358</span>  }</div> +<div class="line"><a name="l01359"></a><span class="lineno"> 1359</span> </div> +<div class="line"><a name="l01360"></a><span class="lineno"> 1360</span>  <span class="comment">// Verify a pointer (may be NULL) of a table type.</span></div> +<div class="line"><a name="l01361"></a><span class="lineno"> 1361</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> VerifyTable(<span class="keyword">const</span> T *table) {</div> +<div class="line"><a name="l01362"></a><span class="lineno"> 1362</span>  <span class="keywordflow">return</span> !table || table->Verify(*<span class="keyword">this</span>);</div> +<div class="line"><a name="l01363"></a><span class="lineno"> 1363</span>  }</div> +<div class="line"><a name="l01364"></a><span class="lineno"> 1364</span> </div> +<div class="line"><a name="l01365"></a><span class="lineno"> 1365</span>  <span class="comment">// Verify a pointer (may be NULL) of any vector type.</span></div> +<div class="line"><a name="l01366"></a><span class="lineno"> 1366</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> Verify(<span class="keyword">const</span> Vector<T> *vec)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01367"></a><span class="lineno"> 1367</span>  <span class="keyword">const</span> uint8_t *end;</div> +<div class="line"><a name="l01368"></a><span class="lineno"> 1368</span>  <span class="keywordflow">return</span> !vec ||</div> +<div class="line"><a name="l01369"></a><span class="lineno"> 1369</span>  VerifyVector(reinterpret_cast<const uint8_t *>(vec), <span class="keyword">sizeof</span>(T),</div> +<div class="line"><a name="l01370"></a><span class="lineno"> 1370</span>  &end);</div> +<div class="line"><a name="l01371"></a><span class="lineno"> 1371</span>  }</div> +<div class="line"><a name="l01372"></a><span class="lineno"> 1372</span> </div> +<div class="line"><a name="l01373"></a><span class="lineno"> 1373</span>  <span class="comment">// Verify a pointer (may be NULL) of a vector to struct.</span></div> +<div class="line"><a name="l01374"></a><span class="lineno"> 1374</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> Verify(<span class="keyword">const</span> Vector<const T *> *vec)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01375"></a><span class="lineno"> 1375</span>  <span class="keywordflow">return</span> Verify(<span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>Vector<T> *<span class="keyword">></span>(vec));</div> +<div class="line"><a name="l01376"></a><span class="lineno"> 1376</span>  }</div> +<div class="line"><a name="l01377"></a><span class="lineno"> 1377</span> </div> +<div class="line"><a name="l01378"></a><span class="lineno"> 1378</span>  <span class="comment">// Verify a pointer (may be NULL) to string.</span></div> +<div class="line"><a name="l01379"></a><span class="lineno"> 1379</span>  <span class="keywordtype">bool</span> Verify(<span class="keyword">const</span> String *str)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01380"></a><span class="lineno"> 1380</span>  <span class="keyword">const</span> uint8_t *end;</div> +<div class="line"><a name="l01381"></a><span class="lineno"> 1381</span>  <span class="keywordflow">return</span> !str ||</div> +<div class="line"><a name="l01382"></a><span class="lineno"> 1382</span>  (VerifyVector(reinterpret_cast<const uint8_t *>(str), 1, &end) &&</div> +<div class="line"><a name="l01383"></a><span class="lineno"> 1383</span>  Verify(end, 1) && <span class="comment">// Must have terminator</span></div> +<div class="line"><a name="l01384"></a><span class="lineno"> 1384</span>  Check(*end == <span class="charliteral">'\0'</span>)); <span class="comment">// Terminating byte must be 0.</span></div> +<div class="line"><a name="l01385"></a><span class="lineno"> 1385</span>  }</div> +<div class="line"><a name="l01386"></a><span class="lineno"> 1386</span> </div> +<div class="line"><a name="l01387"></a><span class="lineno"> 1387</span>  <span class="comment">// Common code between vectors and strings.</span></div> +<div class="line"><a name="l01388"></a><span class="lineno"> 1388</span>  <span class="keywordtype">bool</span> VerifyVector(<span class="keyword">const</span> uint8_t *vec, <span class="keywordtype">size_t</span> elem_size,</div> +<div class="line"><a name="l01389"></a><span class="lineno"> 1389</span>  <span class="keyword">const</span> uint8_t **end)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01390"></a><span class="lineno"> 1390</span>  <span class="comment">// Check we can read the size field.</span></div> +<div class="line"><a name="l01391"></a><span class="lineno"> 1391</span>  <span class="keywordflow">if</span> (!Verify<uoffset_t>(vec)) <span class="keywordflow">return</span> <span class="keyword">false</span>;</div> +<div class="line"><a name="l01392"></a><span class="lineno"> 1392</span>  <span class="comment">// Check the whole array. If this is a string, the byte past the array</span></div> +<div class="line"><a name="l01393"></a><span class="lineno"> 1393</span>  <span class="comment">// must be 0.</span></div> +<div class="line"><a name="l01394"></a><span class="lineno"> 1394</span>  <span class="keyword">auto</span> size = ReadScalar<uoffset_t>(vec);</div> +<div class="line"><a name="l01395"></a><span class="lineno"> 1395</span>  <span class="keyword">auto</span> max_elems = FLATBUFFERS_MAX_BUFFER_SIZE / elem_size;</div> +<div class="line"><a name="l01396"></a><span class="lineno"> 1396</span>  <span class="keywordflow">if</span> (!Check(size < max_elems))</div> +<div class="line"><a name="l01397"></a><span class="lineno"> 1397</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>; <span class="comment">// Protect against byte_size overflowing.</span></div> +<div class="line"><a name="l01398"></a><span class="lineno"> 1398</span>  <span class="keyword">auto</span> byte_size = <span class="keyword">sizeof</span>(size) + elem_size * size;</div> +<div class="line"><a name="l01399"></a><span class="lineno"> 1399</span>  *end = vec + byte_size;</div> +<div class="line"><a name="l01400"></a><span class="lineno"> 1400</span>  <span class="keywordflow">return</span> Verify(vec, byte_size);</div> +<div class="line"><a name="l01401"></a><span class="lineno"> 1401</span>  }</div> +<div class="line"><a name="l01402"></a><span class="lineno"> 1402</span> </div> +<div class="line"><a name="l01403"></a><span class="lineno"> 1403</span>  <span class="comment">// Special case for string contents, after the above has been called.</span></div> +<div class="line"><a name="l01404"></a><span class="lineno"> 1404</span>  <span class="keywordtype">bool</span> VerifyVectorOfStrings(<span class="keyword">const</span> Vector<Offset<String>> *vec)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01405"></a><span class="lineno"> 1405</span>  <span class="keywordflow">if</span> (vec) {</div> +<div class="line"><a name="l01406"></a><span class="lineno"> 1406</span>  <span class="keywordflow">for</span> (uoffset_t i = 0; i < vec->size(); i++) {</div> +<div class="line"><a name="l01407"></a><span class="lineno"> 1407</span>  <span class="keywordflow">if</span> (!Verify(vec->Get(i))) <span class="keywordflow">return</span> <span class="keyword">false</span>;</div> +<div class="line"><a name="l01408"></a><span class="lineno"> 1408</span>  }</div> +<div class="line"><a name="l01409"></a><span class="lineno"> 1409</span>  }</div> +<div class="line"><a name="l01410"></a><span class="lineno"> 1410</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div> +<div class="line"><a name="l01411"></a><span class="lineno"> 1411</span>  }</div> +<div class="line"><a name="l01412"></a><span class="lineno"> 1412</span> </div> +<div class="line"><a name="l01413"></a><span class="lineno"> 1413</span>  <span class="comment">// Special case for table contents, after the above has been called.</span></div> +<div class="line"><a name="l01414"></a><span class="lineno"> 1414</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> VerifyVectorOfTables(<span class="keyword">const</span> Vector<Offset<T>> *vec) {</div> +<div class="line"><a name="l01415"></a><span class="lineno"> 1415</span>  <span class="keywordflow">if</span> (vec) {</div> +<div class="line"><a name="l01416"></a><span class="lineno"> 1416</span>  <span class="keywordflow">for</span> (uoffset_t i = 0; i < vec->size(); i++) {</div> +<div class="line"><a name="l01417"></a><span class="lineno"> 1417</span>  <span class="keywordflow">if</span> (!vec->Get(i)->Verify(*<span class="keyword">this</span>)) <span class="keywordflow">return</span> <span class="keyword">false</span>;</div> +<div class="line"><a name="l01418"></a><span class="lineno"> 1418</span>  }</div> +<div class="line"><a name="l01419"></a><span class="lineno"> 1419</span>  }</div> +<div class="line"><a name="l01420"></a><span class="lineno"> 1420</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div> <div class="line"><a name="l01421"></a><span class="lineno"> 1421</span>  }</div> <div class="line"><a name="l01422"></a><span class="lineno"> 1422</span> </div> -<div class="line"><a name="l01423"></a><span class="lineno"> 1423</span>  <span class="comment">// Called at the start of a table to increase counters measuring data</span></div> -<div class="line"><a name="l01424"></a><span class="lineno"> 1424</span>  <span class="comment">// structure depth and amount, and possibly bails out with false if</span></div> -<div class="line"><a name="l01425"></a><span class="lineno"> 1425</span>  <span class="comment">// limits set by the constructor have been hit. Needs to be balanced</span></div> -<div class="line"><a name="l01426"></a><span class="lineno"> 1426</span>  <span class="comment">// with EndTable().</span></div> -<div class="line"><a name="l01427"></a><span class="lineno"> 1427</span>  <span class="keywordtype">bool</span> VerifyComplexity() {</div> -<div class="line"><a name="l01428"></a><span class="lineno"> 1428</span>  depth_++;</div> -<div class="line"><a name="l01429"></a><span class="lineno"> 1429</span>  num_tables_++;</div> -<div class="line"><a name="l01430"></a><span class="lineno"> 1430</span>  <span class="keywordflow">return</span> Check(depth_ <= max_depth_ && num_tables_ <= max_tables_);</div> -<div class="line"><a name="l01431"></a><span class="lineno"> 1431</span>  }</div> -<div class="line"><a name="l01432"></a><span class="lineno"> 1432</span> </div> -<div class="line"><a name="l01433"></a><span class="lineno"> 1433</span>  <span class="comment">// Called at the end of a table to pop the depth count.</span></div> -<div class="line"><a name="l01434"></a><span class="lineno"> 1434</span>  <span class="keywordtype">bool</span> EndTable() {</div> -<div class="line"><a name="l01435"></a><span class="lineno"> 1435</span>  depth_--;</div> -<div class="line"><a name="l01436"></a><span class="lineno"> 1436</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div> -<div class="line"><a name="l01437"></a><span class="lineno"> 1437</span>  }</div> -<div class="line"><a name="l01438"></a><span class="lineno"> 1438</span> </div> -<div class="line"><a name="l01439"></a><span class="lineno"> 1439</span> <span class="preprocessor"> #ifdef FLATBUFFERS_TRACK_VERIFIER_BUFFER_SIZE</span></div> -<div class="line"><a name="l01440"></a><span class="lineno"> 1440</span>  <span class="comment">// Returns the message size in bytes</span></div> -<div class="line"><a name="l01441"></a><span class="lineno"> 1441</span>  <span class="keywordtype">size_t</span> GetComputedSize()<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01442"></a><span class="lineno"> 1442</span>  uintptr_t size = upper_bound_ - buf_;</div> -<div class="line"><a name="l01443"></a><span class="lineno"> 1443</span>  <span class="comment">// Align the size to uoffset_t</span></div> -<div class="line"><a name="l01444"></a><span class="lineno"> 1444</span>  size = (size - 1 + <span class="keyword">sizeof</span>(uoffset_t)) & ~(<span class="keyword">sizeof</span>(uoffset_t) - 1);</div> -<div class="line"><a name="l01445"></a><span class="lineno"> 1445</span>  <span class="keywordflow">return</span> (buf_ + size > end_) ? 0 : size;</div> -<div class="line"><a name="l01446"></a><span class="lineno"> 1446</span>  }</div> -<div class="line"><a name="l01447"></a><span class="lineno"> 1447</span> <span class="preprocessor"> #endif</span></div> -<div class="line"><a name="l01448"></a><span class="lineno"> 1448</span> </div> -<div class="line"><a name="l01449"></a><span class="lineno"> 1449</span>  <span class="keyword">private</span>:</div> -<div class="line"><a name="l01450"></a><span class="lineno"> 1450</span>  <span class="keyword">const</span> uint8_t *buf_;</div> -<div class="line"><a name="l01451"></a><span class="lineno"> 1451</span>  <span class="keyword">const</span> uint8_t *end_;</div> -<div class="line"><a name="l01452"></a><span class="lineno"> 1452</span>  <span class="keywordtype">size_t</span> depth_;</div> -<div class="line"><a name="l01453"></a><span class="lineno"> 1453</span>  <span class="keywordtype">size_t</span> max_depth_;</div> -<div class="line"><a name="l01454"></a><span class="lineno"> 1454</span>  <span class="keywordtype">size_t</span> num_tables_;</div> -<div class="line"><a name="l01455"></a><span class="lineno"> 1455</span>  <span class="keywordtype">size_t</span> max_tables_;</div> -<div class="line"><a name="l01456"></a><span class="lineno"> 1456</span> <span class="preprocessor"> #ifdef FLATBUFFERS_TRACK_VERIFIER_BUFFER_SIZE</span></div> -<div class="line"><a name="l01457"></a><span class="lineno"> 1457</span>  <span class="keyword">mutable</span> <span class="keyword">const</span> uint8_t *upper_bound_;</div> -<div class="line"><a name="l01458"></a><span class="lineno"> 1458</span> <span class="preprocessor"> #endif</span></div> -<div class="line"><a name="l01459"></a><span class="lineno"> 1459</span> };</div> -<div class="line"><a name="l01460"></a><span class="lineno"> 1460</span> </div> -<div class="line"><a name="l01461"></a><span class="lineno"> 1461</span> <span class="comment">// Convenient way to bundle a buffer and its length, to pass it around</span></div> -<div class="line"><a name="l01462"></a><span class="lineno"> 1462</span> <span class="comment">// typed by its root.</span></div> -<div class="line"><a name="l01463"></a><span class="lineno"> 1463</span> <span class="comment">// A BufferRef does not own its buffer.</span></div> -<div class="line"><a name="l01464"></a><span class="lineno"> 1464</span> <span class="keyword">struct </span>BufferRefBase {}; <span class="comment">// for std::is_base_of</span></div> -<div class="line"><a name="l01465"></a><span class="lineno"> 1465</span> <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keyword">struct </span>BufferRef : BufferRefBase {</div> -<div class="line"><a name="l01466"></a><span class="lineno"> 1466</span>  BufferRef() : buf(nullptr), len(0), must_free(false) {}</div> -<div class="line"><a name="l01467"></a><span class="lineno"> 1467</span>  BufferRef(uint8_t *_buf, uoffset_t _len)</div> -<div class="line"><a name="l01468"></a><span class="lineno"> 1468</span>  : buf(_buf), len(_len), must_free(false) {}</div> -<div class="line"><a name="l01469"></a><span class="lineno"> 1469</span> </div> -<div class="line"><a name="l01470"></a><span class="lineno"> 1470</span>  ~BufferRef() { <span class="keywordflow">if</span> (must_free) free(buf); }</div> -<div class="line"><a name="l01471"></a><span class="lineno"> 1471</span> </div> -<div class="line"><a name="l01472"></a><span class="lineno"> 1472</span>  <span class="keyword">const</span> T *GetRoot()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> flatbuffers::GetRoot<T>(buf); }</div> -<div class="line"><a name="l01473"></a><span class="lineno"> 1473</span> </div> -<div class="line"><a name="l01474"></a><span class="lineno"> 1474</span>  <span class="keywordtype">bool</span> Verify() {</div> -<div class="line"><a name="l01475"></a><span class="lineno"> 1475</span>  Verifier verifier(buf, len);</div> -<div class="line"><a name="l01476"></a><span class="lineno"> 1476</span>  <span class="keywordflow">return</span> verifier.VerifyBuffer<T>();</div> -<div class="line"><a name="l01477"></a><span class="lineno"> 1477</span>  }</div> -<div class="line"><a name="l01478"></a><span class="lineno"> 1478</span> </div> -<div class="line"><a name="l01479"></a><span class="lineno"> 1479</span>  uint8_t *buf;</div> -<div class="line"><a name="l01480"></a><span class="lineno"> 1480</span>  uoffset_t len;</div> -<div class="line"><a name="l01481"></a><span class="lineno"> 1481</span>  <span class="keywordtype">bool</span> must_free;</div> -<div class="line"><a name="l01482"></a><span class="lineno"> 1482</span> };</div> -<div class="line"><a name="l01483"></a><span class="lineno"> 1483</span> </div> -<div class="line"><a name="l01484"></a><span class="lineno"> 1484</span> <span class="comment">// "structs" are flat structures that do not have an offset table, thus</span></div> -<div class="line"><a name="l01485"></a><span class="lineno"> 1485</span> <span class="comment">// always have all members present and do not support forwards/backwards</span></div> -<div class="line"><a name="l01486"></a><span class="lineno"> 1486</span> <span class="comment">// compatible extensions.</span></div> -<div class="line"><a name="l01487"></a><span class="lineno"> 1487</span> </div> -<div class="line"><a name="l01488"></a><span class="lineno"> 1488</span> <span class="keyword">class </span>Struct FLATBUFFERS_FINAL_CLASS {</div> -<div class="line"><a name="l01489"></a><span class="lineno"> 1489</span>  <span class="keyword">public</span>:</div> -<div class="line"><a name="l01490"></a><span class="lineno"> 1490</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> T GetField(uoffset_t o)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01491"></a><span class="lineno"> 1491</span>  <span class="keywordflow">return</span> ReadScalar<T>(&data_[o]);</div> -<div class="line"><a name="l01492"></a><span class="lineno"> 1492</span>  }</div> -<div class="line"><a name="l01493"></a><span class="lineno"> 1493</span> </div> -<div class="line"><a name="l01494"></a><span class="lineno"> 1494</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> T GetStruct(uoffset_t o)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01495"></a><span class="lineno"> 1495</span>  <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span>T<span class="keyword">></span>(&data_[o]);</div> -<div class="line"><a name="l01496"></a><span class="lineno"> 1496</span>  }</div> -<div class="line"><a name="l01497"></a><span class="lineno"> 1497</span> </div> -<div class="line"><a name="l01498"></a><span class="lineno"> 1498</span>  <span class="keyword">const</span> uint8_t *GetAddressOf(uoffset_t o)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> &data_[o]; }</div> -<div class="line"><a name="l01499"></a><span class="lineno"> 1499</span>  uint8_t *GetAddressOf(uoffset_t o) { <span class="keywordflow">return</span> &data_[o]; }</div> +<div class="line"><a name="l01423"></a><span class="lineno"> 1423</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> VerifyBufferFromStart(<span class="keyword">const</span> <span class="keywordtype">char</span> *identifier,</div> +<div class="line"><a name="l01424"></a><span class="lineno"> 1424</span>  <span class="keyword">const</span> uint8_t *start) {</div> +<div class="line"><a name="l01425"></a><span class="lineno"> 1425</span>  <span class="keywordflow">if</span> (identifier &&</div> +<div class="line"><a name="l01426"></a><span class="lineno"> 1426</span>  (<span class="keywordtype">size_t</span>(end_ - start) < 2 * <span class="keyword">sizeof</span>(flatbuffers::uoffset_t) ||</div> +<div class="line"><a name="l01427"></a><span class="lineno"> 1427</span>  !BufferHasIdentifier(start, identifier))) {</div> +<div class="line"><a name="l01428"></a><span class="lineno"> 1428</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>;</div> +<div class="line"><a name="l01429"></a><span class="lineno"> 1429</span>  }</div> +<div class="line"><a name="l01430"></a><span class="lineno"> 1430</span> </div> +<div class="line"><a name="l01431"></a><span class="lineno"> 1431</span>  <span class="comment">// Call T::Verify, which must be in the generated code for this type.</span></div> +<div class="line"><a name="l01432"></a><span class="lineno"> 1432</span>  <span class="keywordflow">return</span> Verify<uoffset_t>(start) &&</div> +<div class="line"><a name="l01433"></a><span class="lineno"> 1433</span>  reinterpret_cast<const T *>(start + ReadScalar<uoffset_t>(start))-></div> +<div class="line"><a name="l01434"></a><span class="lineno"> 1434</span>  Verify(*<span class="keyword">this</span>)</div> +<div class="line"><a name="l01435"></a><span class="lineno"> 1435</span>  <span class="preprocessor">#ifdef FLATBUFFERS_TRACK_VERIFIER_BUFFER_SIZE</span></div> +<div class="line"><a name="l01436"></a><span class="lineno"> 1436</span>  && GetComputedSize()</div> +<div class="line"><a name="l01437"></a><span class="lineno"> 1437</span>  <span class="preprocessor">#endif</span></div> +<div class="line"><a name="l01438"></a><span class="lineno"> 1438</span>  ;</div> +<div class="line"><a name="l01439"></a><span class="lineno"> 1439</span>  }</div> +<div class="line"><a name="l01440"></a><span class="lineno"> 1440</span> </div> +<div class="line"><a name="l01441"></a><span class="lineno"> 1441</span>  <span class="comment">// Verify this whole buffer, starting with root type T.</span></div> +<div class="line"><a name="l01442"></a><span class="lineno"> 1442</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> VerifyBuffer(<span class="keyword">const</span> <span class="keywordtype">char</span> *identifier) {</div> +<div class="line"><a name="l01443"></a><span class="lineno"> 1443</span>  <span class="keywordflow">return</span> VerifyBufferFromStart<T>(identifier, buf_);</div> +<div class="line"><a name="l01444"></a><span class="lineno"> 1444</span>  }</div> +<div class="line"><a name="l01445"></a><span class="lineno"> 1445</span> </div> +<div class="line"><a name="l01446"></a><span class="lineno"> 1446</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> VerifySizePrefixedBuffer(<span class="keyword">const</span> <span class="keywordtype">char</span> *identifier) {</div> +<div class="line"><a name="l01447"></a><span class="lineno"> 1447</span>  <span class="keywordflow">return</span> Verify<uoffset_t>(buf_) &&</div> +<div class="line"><a name="l01448"></a><span class="lineno"> 1448</span>  ReadScalar<uoffset_t>(buf_) == end_ - buf_ - <span class="keyword">sizeof</span>(uoffset_t) &&</div> +<div class="line"><a name="l01449"></a><span class="lineno"> 1449</span>  VerifyBufferFromStart<T>(identifier, buf_ + <span class="keyword">sizeof</span>(uoffset_t));</div> +<div class="line"><a name="l01450"></a><span class="lineno"> 1450</span>  }</div> +<div class="line"><a name="l01451"></a><span class="lineno"> 1451</span> </div> +<div class="line"><a name="l01452"></a><span class="lineno"> 1452</span>  <span class="comment">// Called at the start of a table to increase counters measuring data</span></div> +<div class="line"><a name="l01453"></a><span class="lineno"> 1453</span>  <span class="comment">// structure depth and amount, and possibly bails out with false if</span></div> +<div class="line"><a name="l01454"></a><span class="lineno"> 1454</span>  <span class="comment">// limits set by the constructor have been hit. Needs to be balanced</span></div> +<div class="line"><a name="l01455"></a><span class="lineno"> 1455</span>  <span class="comment">// with EndTable().</span></div> +<div class="line"><a name="l01456"></a><span class="lineno"> 1456</span>  <span class="keywordtype">bool</span> VerifyComplexity() {</div> +<div class="line"><a name="l01457"></a><span class="lineno"> 1457</span>  depth_++;</div> +<div class="line"><a name="l01458"></a><span class="lineno"> 1458</span>  num_tables_++;</div> +<div class="line"><a name="l01459"></a><span class="lineno"> 1459</span>  <span class="keywordflow">return</span> Check(depth_ <= max_depth_ && num_tables_ <= max_tables_);</div> +<div class="line"><a name="l01460"></a><span class="lineno"> 1460</span>  }</div> +<div class="line"><a name="l01461"></a><span class="lineno"> 1461</span> </div> +<div class="line"><a name="l01462"></a><span class="lineno"> 1462</span>  <span class="comment">// Called at the end of a table to pop the depth count.</span></div> +<div class="line"><a name="l01463"></a><span class="lineno"> 1463</span>  <span class="keywordtype">bool</span> EndTable() {</div> +<div class="line"><a name="l01464"></a><span class="lineno"> 1464</span>  depth_--;</div> +<div class="line"><a name="l01465"></a><span class="lineno"> 1465</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div> +<div class="line"><a name="l01466"></a><span class="lineno"> 1466</span>  }</div> +<div class="line"><a name="l01467"></a><span class="lineno"> 1467</span> </div> +<div class="line"><a name="l01468"></a><span class="lineno"> 1468</span> <span class="preprocessor"> #ifdef FLATBUFFERS_TRACK_VERIFIER_BUFFER_SIZE</span></div> +<div class="line"><a name="l01469"></a><span class="lineno"> 1469</span>  <span class="comment">// Returns the message size in bytes</span></div> +<div class="line"><a name="l01470"></a><span class="lineno"> 1470</span>  <span class="keywordtype">size_t</span> GetComputedSize()<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01471"></a><span class="lineno"> 1471</span>  uintptr_t size = upper_bound_ - buf_;</div> +<div class="line"><a name="l01472"></a><span class="lineno"> 1472</span>  <span class="comment">// Align the size to uoffset_t</span></div> +<div class="line"><a name="l01473"></a><span class="lineno"> 1473</span>  size = (size - 1 + <span class="keyword">sizeof</span>(uoffset_t)) & ~(<span class="keyword">sizeof</span>(uoffset_t) - 1);</div> +<div class="line"><a name="l01474"></a><span class="lineno"> 1474</span>  <span class="keywordflow">return</span> (buf_ + size > end_) ? 0 : size;</div> +<div class="line"><a name="l01475"></a><span class="lineno"> 1475</span>  }</div> +<div class="line"><a name="l01476"></a><span class="lineno"> 1476</span> <span class="preprocessor"> #endif</span></div> +<div class="line"><a name="l01477"></a><span class="lineno"> 1477</span> </div> +<div class="line"><a name="l01478"></a><span class="lineno"> 1478</span>  <span class="keyword">private</span>:</div> +<div class="line"><a name="l01479"></a><span class="lineno"> 1479</span>  <span class="keyword">const</span> uint8_t *buf_;</div> +<div class="line"><a name="l01480"></a><span class="lineno"> 1480</span>  <span class="keyword">const</span> uint8_t *end_;</div> +<div class="line"><a name="l01481"></a><span class="lineno"> 1481</span>  <span class="keywordtype">size_t</span> depth_;</div> +<div class="line"><a name="l01482"></a><span class="lineno"> 1482</span>  <span class="keywordtype">size_t</span> max_depth_;</div> +<div class="line"><a name="l01483"></a><span class="lineno"> 1483</span>  <span class="keywordtype">size_t</span> num_tables_;</div> +<div class="line"><a name="l01484"></a><span class="lineno"> 1484</span>  <span class="keywordtype">size_t</span> max_tables_;</div> +<div class="line"><a name="l01485"></a><span class="lineno"> 1485</span> <span class="preprocessor">#ifdef FLATBUFFERS_TRACK_VERIFIER_BUFFER_SIZE</span></div> +<div class="line"><a name="l01486"></a><span class="lineno"> 1486</span>  <span class="keyword">mutable</span> <span class="keyword">const</span> uint8_t *upper_bound_;</div> +<div class="line"><a name="l01487"></a><span class="lineno"> 1487</span> <span class="preprocessor">#endif</span></div> +<div class="line"><a name="l01488"></a><span class="lineno"> 1488</span> };</div> +<div class="line"><a name="l01489"></a><span class="lineno"> 1489</span> </div> +<div class="line"><a name="l01490"></a><span class="lineno"> 1490</span> <span class="comment">// Convenient way to bundle a buffer and its length, to pass it around</span></div> +<div class="line"><a name="l01491"></a><span class="lineno"> 1491</span> <span class="comment">// typed by its root.</span></div> +<div class="line"><a name="l01492"></a><span class="lineno"> 1492</span> <span class="comment">// A BufferRef does not own its buffer.</span></div> +<div class="line"><a name="l01493"></a><span class="lineno"> 1493</span> <span class="keyword">struct </span>BufferRefBase {}; <span class="comment">// for std::is_base_of</span></div> +<div class="line"><a name="l01494"></a><span class="lineno"> 1494</span> <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keyword">struct </span>BufferRef : BufferRefBase {</div> +<div class="line"><a name="l01495"></a><span class="lineno"> 1495</span>  BufferRef() : buf(nullptr), len(0), must_free(false) {}</div> +<div class="line"><a name="l01496"></a><span class="lineno"> 1496</span>  BufferRef(uint8_t *_buf, uoffset_t _len)</div> +<div class="line"><a name="l01497"></a><span class="lineno"> 1497</span>  : buf(_buf), len(_len), must_free(false) {}</div> +<div class="line"><a name="l01498"></a><span class="lineno"> 1498</span> </div> +<div class="line"><a name="l01499"></a><span class="lineno"> 1499</span>  ~BufferRef() { <span class="keywordflow">if</span> (must_free) free(buf); }</div> <div class="line"><a name="l01500"></a><span class="lineno"> 1500</span> </div> -<div class="line"><a name="l01501"></a><span class="lineno"> 1501</span>  <span class="keyword">private</span>:</div> -<div class="line"><a name="l01502"></a><span class="lineno"> 1502</span>  uint8_t data_[1];</div> -<div class="line"><a name="l01503"></a><span class="lineno"> 1503</span> };</div> -<div class="line"><a name="l01504"></a><span class="lineno"> 1504</span> </div> -<div class="line"><a name="l01505"></a><span class="lineno"> 1505</span> <span class="comment">// "tables" use an offset table (possibly shared) that allows fields to be</span></div> -<div class="line"><a name="l01506"></a><span class="lineno"> 1506</span> <span class="comment">// omitted and added at will, but uses an extra indirection to read.</span></div> -<div class="line"><a name="l01507"></a><span class="lineno"> 1507</span> <span class="keyword">class </span>Table {</div> -<div class="line"><a name="l01508"></a><span class="lineno"> 1508</span>  <span class="keyword">public</span>:</div> -<div class="line"><a name="l01509"></a><span class="lineno"> 1509</span>  <span class="keyword">const</span> uint8_t *GetVTable()<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01510"></a><span class="lineno"> 1510</span>  <span class="keywordflow">return</span> data_ - ReadScalar<soffset_t>(data_);</div> -<div class="line"><a name="l01511"></a><span class="lineno"> 1511</span>  }</div> +<div class="line"><a name="l01501"></a><span class="lineno"> 1501</span>  <span class="keyword">const</span> T *GetRoot()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> flatbuffers::GetRoot<T>(buf); }</div> +<div class="line"><a name="l01502"></a><span class="lineno"> 1502</span> </div> +<div class="line"><a name="l01503"></a><span class="lineno"> 1503</span>  <span class="keywordtype">bool</span> Verify() {</div> +<div class="line"><a name="l01504"></a><span class="lineno"> 1504</span>  Verifier verifier(buf, len);</div> +<div class="line"><a name="l01505"></a><span class="lineno"> 1505</span>  <span class="keywordflow">return</span> verifier.VerifyBuffer<T>(<span class="keyword">nullptr</span>);</div> +<div class="line"><a name="l01506"></a><span class="lineno"> 1506</span>  }</div> +<div class="line"><a name="l01507"></a><span class="lineno"> 1507</span> </div> +<div class="line"><a name="l01508"></a><span class="lineno"> 1508</span>  uint8_t *buf;</div> +<div class="line"><a name="l01509"></a><span class="lineno"> 1509</span>  uoffset_t len;</div> +<div class="line"><a name="l01510"></a><span class="lineno"> 1510</span>  <span class="keywordtype">bool</span> must_free;</div> +<div class="line"><a name="l01511"></a><span class="lineno"> 1511</span> };</div> <div class="line"><a name="l01512"></a><span class="lineno"> 1512</span> </div> -<div class="line"><a name="l01513"></a><span class="lineno"> 1513</span>  <span class="comment">// This gets the field offset for any of the functions below it, or 0</span></div> -<div class="line"><a name="l01514"></a><span class="lineno"> 1514</span>  <span class="comment">// if the field was not present.</span></div> -<div class="line"><a name="l01515"></a><span class="lineno"> 1515</span>  voffset_t GetOptionalFieldOffset(voffset_t field)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01516"></a><span class="lineno"> 1516</span>  <span class="comment">// The vtable offset is always at the start.</span></div> -<div class="line"><a name="l01517"></a><span class="lineno"> 1517</span>  <span class="keyword">auto</span> vtable = GetVTable();</div> -<div class="line"><a name="l01518"></a><span class="lineno"> 1518</span>  <span class="comment">// The first element is the size of the vtable (fields + type id + itself).</span></div> -<div class="line"><a name="l01519"></a><span class="lineno"> 1519</span>  <span class="keyword">auto</span> vtsize = ReadScalar<voffset_t>(vtable);</div> -<div class="line"><a name="l01520"></a><span class="lineno"> 1520</span>  <span class="comment">// If the field we're accessing is outside the vtable, we're reading older</span></div> -<div class="line"><a name="l01521"></a><span class="lineno"> 1521</span>  <span class="comment">// data, so it's the same as if the offset was 0 (not present).</span></div> -<div class="line"><a name="l01522"></a><span class="lineno"> 1522</span>  <span class="keywordflow">return</span> field < vtsize ? ReadScalar<voffset_t>(vtable + field) : 0;</div> -<div class="line"><a name="l01523"></a><span class="lineno"> 1523</span>  }</div> -<div class="line"><a name="l01524"></a><span class="lineno"> 1524</span> </div> -<div class="line"><a name="l01525"></a><span class="lineno"> 1525</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> T GetField(voffset_t field, T defaultval)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01526"></a><span class="lineno"> 1526</span>  <span class="keyword">auto</span> field_offset = GetOptionalFieldOffset(field);</div> -<div class="line"><a name="l01527"></a><span class="lineno"> 1527</span>  <span class="keywordflow">return</span> field_offset ? ReadScalar<T>(data_ + field_offset) : defaultval;</div> -<div class="line"><a name="l01528"></a><span class="lineno"> 1528</span>  }</div> +<div class="line"><a name="l01513"></a><span class="lineno"> 1513</span> <span class="comment">// "structs" are flat structures that do not have an offset table, thus</span></div> +<div class="line"><a name="l01514"></a><span class="lineno"> 1514</span> <span class="comment">// always have all members present and do not support forwards/backwards</span></div> +<div class="line"><a name="l01515"></a><span class="lineno"> 1515</span> <span class="comment">// compatible extensions.</span></div> +<div class="line"><a name="l01516"></a><span class="lineno"> 1516</span> </div> +<div class="line"><a name="l01517"></a><span class="lineno"> 1517</span> <span class="keyword">class </span>Struct FLATBUFFERS_FINAL_CLASS {</div> +<div class="line"><a name="l01518"></a><span class="lineno"> 1518</span>  <span class="keyword">public</span>:</div> +<div class="line"><a name="l01519"></a><span class="lineno"> 1519</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> T GetField(uoffset_t o)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01520"></a><span class="lineno"> 1520</span>  <span class="keywordflow">return</span> ReadScalar<T>(&data_[o]);</div> +<div class="line"><a name="l01521"></a><span class="lineno"> 1521</span>  }</div> +<div class="line"><a name="l01522"></a><span class="lineno"> 1522</span> </div> +<div class="line"><a name="l01523"></a><span class="lineno"> 1523</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> T GetStruct(uoffset_t o)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01524"></a><span class="lineno"> 1524</span>  <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span>T<span class="keyword">></span>(&data_[o]);</div> +<div class="line"><a name="l01525"></a><span class="lineno"> 1525</span>  }</div> +<div class="line"><a name="l01526"></a><span class="lineno"> 1526</span> </div> +<div class="line"><a name="l01527"></a><span class="lineno"> 1527</span>  <span class="keyword">const</span> uint8_t *GetAddressOf(uoffset_t o)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> &data_[o]; }</div> +<div class="line"><a name="l01528"></a><span class="lineno"> 1528</span>  uint8_t *GetAddressOf(uoffset_t o) { <span class="keywordflow">return</span> &data_[o]; }</div> <div class="line"><a name="l01529"></a><span class="lineno"> 1529</span> </div> -<div class="line"><a name="l01530"></a><span class="lineno"> 1530</span>  <span class="keyword">template</span><<span class="keyword">typename</span> P> P GetPointer(voffset_t field) {</div> -<div class="line"><a name="l01531"></a><span class="lineno"> 1531</span>  <span class="keyword">auto</span> field_offset = GetOptionalFieldOffset(field);</div> -<div class="line"><a name="l01532"></a><span class="lineno"> 1532</span>  <span class="keyword">auto</span> p = data_ + field_offset;</div> -<div class="line"><a name="l01533"></a><span class="lineno"> 1533</span>  <span class="keywordflow">return</span> field_offset</div> -<div class="line"><a name="l01534"></a><span class="lineno"> 1534</span>  ? <span class="keyword">reinterpret_cast<</span>P<span class="keyword">></span>(p + ReadScalar<uoffset_t>(p))</div> -<div class="line"><a name="l01535"></a><span class="lineno"> 1535</span>  : nullptr;</div> -<div class="line"><a name="l01536"></a><span class="lineno"> 1536</span>  }</div> -<div class="line"><a name="l01537"></a><span class="lineno"> 1537</span>  <span class="keyword">template</span><<span class="keyword">typename</span> P> P GetPointer(voffset_t field)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01538"></a><span class="lineno"> 1538</span>  <span class="keywordflow">return</span> <span class="keyword">const_cast<</span>Table *<span class="keyword">></span>(<span class="keyword">this</span>)->GetPointer<P>(field);</div> -<div class="line"><a name="l01539"></a><span class="lineno"> 1539</span>  }</div> -<div class="line"><a name="l01540"></a><span class="lineno"> 1540</span> </div> -<div class="line"><a name="l01541"></a><span class="lineno"> 1541</span>  <span class="keyword">template</span><<span class="keyword">typename</span> P> P GetStruct(voffset_t field)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01542"></a><span class="lineno"> 1542</span>  <span class="keyword">auto</span> field_offset = GetOptionalFieldOffset(field);</div> -<div class="line"><a name="l01543"></a><span class="lineno"> 1543</span>  <span class="keyword">auto</span> p = <span class="keyword">const_cast<</span>uint8_t *<span class="keyword">></span>(data_ + field_offset);</div> -<div class="line"><a name="l01544"></a><span class="lineno"> 1544</span>  <span class="keywordflow">return</span> field_offset ? <span class="keyword">reinterpret_cast<</span>P<span class="keyword">></span>(p) : <span class="keyword">nullptr</span>;</div> -<div class="line"><a name="l01545"></a><span class="lineno"> 1545</span>  }</div> -<div class="line"><a name="l01546"></a><span class="lineno"> 1546</span> </div> -<div class="line"><a name="l01547"></a><span class="lineno"> 1547</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> SetField(voffset_t field, T val) {</div> -<div class="line"><a name="l01548"></a><span class="lineno"> 1548</span>  <span class="keyword">auto</span> field_offset = GetOptionalFieldOffset(field);</div> -<div class="line"><a name="l01549"></a><span class="lineno"> 1549</span>  <span class="keywordflow">if</span> (!field_offset) <span class="keywordflow">return</span> <span class="keyword">false</span>;</div> -<div class="line"><a name="l01550"></a><span class="lineno"> 1550</span>  WriteScalar(data_ + field_offset, val);</div> -<div class="line"><a name="l01551"></a><span class="lineno"> 1551</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div> +<div class="line"><a name="l01530"></a><span class="lineno"> 1530</span>  <span class="keyword">private</span>:</div> +<div class="line"><a name="l01531"></a><span class="lineno"> 1531</span>  uint8_t data_[1];</div> +<div class="line"><a name="l01532"></a><span class="lineno"> 1532</span> };</div> +<div class="line"><a name="l01533"></a><span class="lineno"> 1533</span> </div> +<div class="line"><a name="l01534"></a><span class="lineno"> 1534</span> <span class="comment">// "tables" use an offset table (possibly shared) that allows fields to be</span></div> +<div class="line"><a name="l01535"></a><span class="lineno"> 1535</span> <span class="comment">// omitted and added at will, but uses an extra indirection to read.</span></div> +<div class="line"><a name="l01536"></a><span class="lineno"> 1536</span> <span class="keyword">class </span>Table {</div> +<div class="line"><a name="l01537"></a><span class="lineno"> 1537</span>  <span class="keyword">public</span>:</div> +<div class="line"><a name="l01538"></a><span class="lineno"> 1538</span>  <span class="keyword">const</span> uint8_t *GetVTable()<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01539"></a><span class="lineno"> 1539</span>  <span class="keywordflow">return</span> data_ - ReadScalar<soffset_t>(data_);</div> +<div class="line"><a name="l01540"></a><span class="lineno"> 1540</span>  }</div> +<div class="line"><a name="l01541"></a><span class="lineno"> 1541</span> </div> +<div class="line"><a name="l01542"></a><span class="lineno"> 1542</span>  <span class="comment">// This gets the field offset for any of the functions below it, or 0</span></div> +<div class="line"><a name="l01543"></a><span class="lineno"> 1543</span>  <span class="comment">// if the field was not present.</span></div> +<div class="line"><a name="l01544"></a><span class="lineno"> 1544</span>  voffset_t GetOptionalFieldOffset(voffset_t field)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01545"></a><span class="lineno"> 1545</span>  <span class="comment">// The vtable offset is always at the start.</span></div> +<div class="line"><a name="l01546"></a><span class="lineno"> 1546</span>  <span class="keyword">auto</span> vtable = GetVTable();</div> +<div class="line"><a name="l01547"></a><span class="lineno"> 1547</span>  <span class="comment">// The first element is the size of the vtable (fields + type id + itself).</span></div> +<div class="line"><a name="l01548"></a><span class="lineno"> 1548</span>  <span class="keyword">auto</span> vtsize = ReadScalar<voffset_t>(vtable);</div> +<div class="line"><a name="l01549"></a><span class="lineno"> 1549</span>  <span class="comment">// If the field we're accessing is outside the vtable, we're reading older</span></div> +<div class="line"><a name="l01550"></a><span class="lineno"> 1550</span>  <span class="comment">// data, so it's the same as if the offset was 0 (not present).</span></div> +<div class="line"><a name="l01551"></a><span class="lineno"> 1551</span>  <span class="keywordflow">return</span> field < vtsize ? ReadScalar<voffset_t>(vtable + field) : 0;</div> <div class="line"><a name="l01552"></a><span class="lineno"> 1552</span>  }</div> <div class="line"><a name="l01553"></a><span class="lineno"> 1553</span> </div> -<div class="line"><a name="l01554"></a><span class="lineno"> 1554</span>  <span class="keywordtype">bool</span> SetPointer(voffset_t field, <span class="keyword">const</span> uint8_t *val) {</div> +<div class="line"><a name="l01554"></a><span class="lineno"> 1554</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> T GetField(voffset_t field, T defaultval)<span class="keyword"> const </span>{</div> <div class="line"><a name="l01555"></a><span class="lineno"> 1555</span>  <span class="keyword">auto</span> field_offset = GetOptionalFieldOffset(field);</div> -<div class="line"><a name="l01556"></a><span class="lineno"> 1556</span>  <span class="keywordflow">if</span> (!field_offset) <span class="keywordflow">return</span> <span class="keyword">false</span>;</div> -<div class="line"><a name="l01557"></a><span class="lineno"> 1557</span>  WriteScalar(data_ + field_offset,</div> -<div class="line"><a name="l01558"></a><span class="lineno"> 1558</span>  static_cast<uoffset_t>(val - (data_ + field_offset)));</div> -<div class="line"><a name="l01559"></a><span class="lineno"> 1559</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div> -<div class="line"><a name="l01560"></a><span class="lineno"> 1560</span>  }</div> -<div class="line"><a name="l01561"></a><span class="lineno"> 1561</span> </div> -<div class="line"><a name="l01562"></a><span class="lineno"> 1562</span>  uint8_t *GetAddressOf(voffset_t field) {</div> -<div class="line"><a name="l01563"></a><span class="lineno"> 1563</span>  <span class="keyword">auto</span> field_offset = GetOptionalFieldOffset(field);</div> -<div class="line"><a name="l01564"></a><span class="lineno"> 1564</span>  <span class="keywordflow">return</span> field_offset ? data_ + field_offset : <span class="keyword">nullptr</span>;</div> +<div class="line"><a name="l01556"></a><span class="lineno"> 1556</span>  <span class="keywordflow">return</span> field_offset ? ReadScalar<T>(data_ + field_offset) : defaultval;</div> +<div class="line"><a name="l01557"></a><span class="lineno"> 1557</span>  }</div> +<div class="line"><a name="l01558"></a><span class="lineno"> 1558</span> </div> +<div class="line"><a name="l01559"></a><span class="lineno"> 1559</span>  <span class="keyword">template</span><<span class="keyword">typename</span> P> P GetPointer(voffset_t field) {</div> +<div class="line"><a name="l01560"></a><span class="lineno"> 1560</span>  <span class="keyword">auto</span> field_offset = GetOptionalFieldOffset(field);</div> +<div class="line"><a name="l01561"></a><span class="lineno"> 1561</span>  <span class="keyword">auto</span> p = data_ + field_offset;</div> +<div class="line"><a name="l01562"></a><span class="lineno"> 1562</span>  <span class="keywordflow">return</span> field_offset</div> +<div class="line"><a name="l01563"></a><span class="lineno"> 1563</span>  ? <span class="keyword">reinterpret_cast<</span>P<span class="keyword">></span>(p + ReadScalar<uoffset_t>(p))</div> +<div class="line"><a name="l01564"></a><span class="lineno"> 1564</span>  : nullptr;</div> <div class="line"><a name="l01565"></a><span class="lineno"> 1565</span>  }</div> -<div class="line"><a name="l01566"></a><span class="lineno"> 1566</span>  <span class="keyword">const</span> uint8_t *GetAddressOf(voffset_t field)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01567"></a><span class="lineno"> 1567</span>  <span class="keywordflow">return</span> <span class="keyword">const_cast<</span>Table *<span class="keyword">></span>(<span class="keyword">this</span>)->GetAddressOf(field);</div> +<div class="line"><a name="l01566"></a><span class="lineno"> 1566</span>  <span class="keyword">template</span><<span class="keyword">typename</span> P> P GetPointer(voffset_t field)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01567"></a><span class="lineno"> 1567</span>  <span class="keywordflow">return</span> <span class="keyword">const_cast<</span>Table *<span class="keyword">></span>(<span class="keyword">this</span>)->GetPointer<P>(field);</div> <div class="line"><a name="l01568"></a><span class="lineno"> 1568</span>  }</div> <div class="line"><a name="l01569"></a><span class="lineno"> 1569</span> </div> -<div class="line"><a name="l01570"></a><span class="lineno"> 1570</span>  <span class="keywordtype">bool</span> CheckField(voffset_t field)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01571"></a><span class="lineno"> 1571</span>  <span class="keywordflow">return</span> GetOptionalFieldOffset(field) != 0;</div> -<div class="line"><a name="l01572"></a><span class="lineno"> 1572</span>  }</div> -<div class="line"><a name="l01573"></a><span class="lineno"> 1573</span> </div> -<div class="line"><a name="l01574"></a><span class="lineno"> 1574</span>  <span class="comment">// Verify the vtable of this table.</span></div> -<div class="line"><a name="l01575"></a><span class="lineno"> 1575</span>  <span class="comment">// Call this once per table, followed by VerifyField once per field.</span></div> -<div class="line"><a name="l01576"></a><span class="lineno"> 1576</span>  <span class="keywordtype">bool</span> VerifyTableStart(Verifier &verifier)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01577"></a><span class="lineno"> 1577</span>  <span class="comment">// Check the vtable offset.</span></div> -<div class="line"><a name="l01578"></a><span class="lineno"> 1578</span>  <span class="keywordflow">if</span> (!verifier.Verify<soffset_t>(data_)) <span class="keywordflow">return</span> <span class="keyword">false</span>;</div> -<div class="line"><a name="l01579"></a><span class="lineno"> 1579</span>  <span class="keyword">auto</span> vtable = GetVTable();</div> -<div class="line"><a name="l01580"></a><span class="lineno"> 1580</span>  <span class="comment">// Check the vtable size field, then check vtable fits in its entirety.</span></div> -<div class="line"><a name="l01581"></a><span class="lineno"> 1581</span>  <span class="keywordflow">return</span> verifier.VerifyComplexity() &&</div> -<div class="line"><a name="l01582"></a><span class="lineno"> 1582</span>  verifier.Verify<voffset_t>(vtable) &&</div> -<div class="line"><a name="l01583"></a><span class="lineno"> 1583</span>  (ReadScalar<voffset_t>(vtable) & (<span class="keyword">sizeof</span>(voffset_t) - 1)) == 0 &&</div> -<div class="line"><a name="l01584"></a><span class="lineno"> 1584</span>  verifier.Verify(vtable, ReadScalar<voffset_t>(vtable));</div> -<div class="line"><a name="l01585"></a><span class="lineno"> 1585</span>  }</div> -<div class="line"><a name="l01586"></a><span class="lineno"> 1586</span> </div> -<div class="line"><a name="l01587"></a><span class="lineno"> 1587</span>  <span class="comment">// Verify a particular field.</span></div> -<div class="line"><a name="l01588"></a><span class="lineno"> 1588</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> VerifyField(<span class="keyword">const</span> Verifier &verifier,</div> -<div class="line"><a name="l01589"></a><span class="lineno"> 1589</span>  voffset_t field)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01590"></a><span class="lineno"> 1590</span>  <span class="comment">// Calling GetOptionalFieldOffset should be safe now thanks to</span></div> -<div class="line"><a name="l01591"></a><span class="lineno"> 1591</span>  <span class="comment">// VerifyTable().</span></div> +<div class="line"><a name="l01570"></a><span class="lineno"> 1570</span>  <span class="keyword">template</span><<span class="keyword">typename</span> P> P GetStruct(voffset_t field)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01571"></a><span class="lineno"> 1571</span>  <span class="keyword">auto</span> field_offset = GetOptionalFieldOffset(field);</div> +<div class="line"><a name="l01572"></a><span class="lineno"> 1572</span>  <span class="keyword">auto</span> p = <span class="keyword">const_cast<</span>uint8_t *<span class="keyword">></span>(data_ + field_offset);</div> +<div class="line"><a name="l01573"></a><span class="lineno"> 1573</span>  <span class="keywordflow">return</span> field_offset ? <span class="keyword">reinterpret_cast<</span>P<span class="keyword">></span>(p) : <span class="keyword">nullptr</span>;</div> +<div class="line"><a name="l01574"></a><span class="lineno"> 1574</span>  }</div> +<div class="line"><a name="l01575"></a><span class="lineno"> 1575</span> </div> +<div class="line"><a name="l01576"></a><span class="lineno"> 1576</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> SetField(voffset_t field, T val) {</div> +<div class="line"><a name="l01577"></a><span class="lineno"> 1577</span>  <span class="keyword">auto</span> field_offset = GetOptionalFieldOffset(field);</div> +<div class="line"><a name="l01578"></a><span class="lineno"> 1578</span>  <span class="keywordflow">if</span> (!field_offset) <span class="keywordflow">return</span> <span class="keyword">false</span>;</div> +<div class="line"><a name="l01579"></a><span class="lineno"> 1579</span>  WriteScalar(data_ + field_offset, val);</div> +<div class="line"><a name="l01580"></a><span class="lineno"> 1580</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div> +<div class="line"><a name="l01581"></a><span class="lineno"> 1581</span>  }</div> +<div class="line"><a name="l01582"></a><span class="lineno"> 1582</span> </div> +<div class="line"><a name="l01583"></a><span class="lineno"> 1583</span>  <span class="keywordtype">bool</span> SetPointer(voffset_t field, <span class="keyword">const</span> uint8_t *val) {</div> +<div class="line"><a name="l01584"></a><span class="lineno"> 1584</span>  <span class="keyword">auto</span> field_offset = GetOptionalFieldOffset(field);</div> +<div class="line"><a name="l01585"></a><span class="lineno"> 1585</span>  <span class="keywordflow">if</span> (!field_offset) <span class="keywordflow">return</span> <span class="keyword">false</span>;</div> +<div class="line"><a name="l01586"></a><span class="lineno"> 1586</span>  WriteScalar(data_ + field_offset,</div> +<div class="line"><a name="l01587"></a><span class="lineno"> 1587</span>  static_cast<uoffset_t>(val - (data_ + field_offset)));</div> +<div class="line"><a name="l01588"></a><span class="lineno"> 1588</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div> +<div class="line"><a name="l01589"></a><span class="lineno"> 1589</span>  }</div> +<div class="line"><a name="l01590"></a><span class="lineno"> 1590</span> </div> +<div class="line"><a name="l01591"></a><span class="lineno"> 1591</span>  uint8_t *GetAddressOf(voffset_t field) {</div> <div class="line"><a name="l01592"></a><span class="lineno"> 1592</span>  <span class="keyword">auto</span> field_offset = GetOptionalFieldOffset(field);</div> -<div class="line"><a name="l01593"></a><span class="lineno"> 1593</span>  <span class="comment">// Check the actual field.</span></div> -<div class="line"><a name="l01594"></a><span class="lineno"> 1594</span>  <span class="keywordflow">return</span> !field_offset || verifier.Verify<T>(data_ + field_offset);</div> -<div class="line"><a name="l01595"></a><span class="lineno"> 1595</span>  }</div> -<div class="line"><a name="l01596"></a><span class="lineno"> 1596</span> </div> -<div class="line"><a name="l01597"></a><span class="lineno"> 1597</span>  <span class="comment">// VerifyField for required fields.</span></div> -<div class="line"><a name="l01598"></a><span class="lineno"> 1598</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> VerifyFieldRequired(<span class="keyword">const</span> Verifier &verifier,</div> -<div class="line"><a name="l01599"></a><span class="lineno"> 1599</span>  voffset_t field)<span class="keyword"> const </span>{</div> -<div class="line"><a name="l01600"></a><span class="lineno"> 1600</span>  <span class="keyword">auto</span> field_offset = GetOptionalFieldOffset(field);</div> -<div class="line"><a name="l01601"></a><span class="lineno"> 1601</span>  <span class="keywordflow">return</span> verifier.Check(field_offset != 0) &&</div> -<div class="line"><a name="l01602"></a><span class="lineno"> 1602</span>  verifier.Verify<T>(data_ + field_offset);</div> -<div class="line"><a name="l01603"></a><span class="lineno"> 1603</span>  }</div> -<div class="line"><a name="l01604"></a><span class="lineno"> 1604</span> </div> -<div class="line"><a name="l01605"></a><span class="lineno"> 1605</span>  <span class="keyword">private</span>:</div> -<div class="line"><a name="l01606"></a><span class="lineno"> 1606</span>  <span class="comment">// private constructor & copy constructor: you obtain instances of this</span></div> -<div class="line"><a name="l01607"></a><span class="lineno"> 1607</span>  <span class="comment">// class by pointing to existing data only</span></div> -<div class="line"><a name="l01608"></a><span class="lineno"> 1608</span>  Table();</div> -<div class="line"><a name="l01609"></a><span class="lineno"> 1609</span>  Table(<span class="keyword">const</span> Table &other);</div> -<div class="line"><a name="l01610"></a><span class="lineno"> 1610</span> </div> -<div class="line"><a name="l01611"></a><span class="lineno"> 1611</span>  uint8_t data_[1];</div> -<div class="line"><a name="l01612"></a><span class="lineno"> 1612</span> };</div> -<div class="line"><a name="l01613"></a><span class="lineno"> 1613</span> <span class="comment"></span></div> -<div class="line"><a name="l01614"></a><span class="lineno"> 1614</span> <span class="comment">/// @brief This can compute the start of a FlatBuffer from a root pointer, i.e.</span></div> -<div class="line"><a name="l01615"></a><span class="lineno"> 1615</span> <span class="comment">/// it is the opposite transformation of GetRoot().</span></div> -<div class="line"><a name="l01616"></a><span class="lineno"> 1616</span> <span class="comment">/// This may be useful if you want to pass on a root and have the recipient</span></div> -<div class="line"><a name="l01617"></a><span class="lineno"> 1617</span> <span class="comment">/// delete the buffer afterwards.</span></div> -<div class="line"><a name="l01618"></a><span class="lineno"> 1618</span> <span class="comment"></span><span class="keyword">inline</span> <span class="keyword">const</span> uint8_t *GetBufferStartFromRootPointer(<span class="keyword">const</span> <span class="keywordtype">void</span> *root) {</div> -<div class="line"><a name="l01619"></a><span class="lineno"> 1619</span>  <span class="keyword">auto</span> table = <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>Table *<span class="keyword">></span>(root);</div> -<div class="line"><a name="l01620"></a><span class="lineno"> 1620</span>  <span class="keyword">auto</span> vtable = table->GetVTable();</div> -<div class="line"><a name="l01621"></a><span class="lineno"> 1621</span>  <span class="comment">// Either the vtable is before the root or after the root.</span></div> -<div class="line"><a name="l01622"></a><span class="lineno"> 1622</span>  <span class="keyword">auto</span> start = std::min(vtable, reinterpret_cast<const uint8_t *>(root));</div> -<div class="line"><a name="l01623"></a><span class="lineno"> 1623</span>  <span class="comment">// Align to at least sizeof(uoffset_t).</span></div> -<div class="line"><a name="l01624"></a><span class="lineno"> 1624</span>  start = <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>uint8_t *<span class="keyword">></span>(</div> -<div class="line"><a name="l01625"></a><span class="lineno"> 1625</span>  <span class="keyword">reinterpret_cast<</span>uintptr_t<span class="keyword">></span>(start) & ~(<span class="keyword">sizeof</span>(uoffset_t) - 1));</div> -<div class="line"><a name="l01626"></a><span class="lineno"> 1626</span>  <span class="comment">// Additionally, there may be a file_identifier in the buffer, and the root</span></div> -<div class="line"><a name="l01627"></a><span class="lineno"> 1627</span>  <span class="comment">// offset. The buffer may have been aligned to any size between</span></div> -<div class="line"><a name="l01628"></a><span class="lineno"> 1628</span>  <span class="comment">// sizeof(uoffset_t) and FLATBUFFERS_MAX_ALIGNMENT (see "force_align").</span></div> -<div class="line"><a name="l01629"></a><span class="lineno"> 1629</span>  <span class="comment">// Sadly, the exact alignment is only known when constructing the buffer,</span></div> -<div class="line"><a name="l01630"></a><span class="lineno"> 1630</span>  <span class="comment">// since it depends on the presence of values with said alignment properties.</span></div> -<div class="line"><a name="l01631"></a><span class="lineno"> 1631</span>  <span class="comment">// So instead, we simply look at the next uoffset_t values (root,</span></div> -<div class="line"><a name="l01632"></a><span class="lineno"> 1632</span>  <span class="comment">// file_identifier, and alignment padding) to see which points to the root.</span></div> -<div class="line"><a name="l01633"></a><span class="lineno"> 1633</span>  <span class="comment">// None of the other values can "impersonate" the root since they will either</span></div> -<div class="line"><a name="l01634"></a><span class="lineno"> 1634</span>  <span class="comment">// be 0 or four ASCII characters.</span></div> -<div class="line"><a name="l01635"></a><span class="lineno"> 1635</span>  static_assert(<a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#af8c7583c92e1d1d6f438977da5158d19">FlatBufferBuilder::kFileIdentifierLength</a> == <span class="keyword">sizeof</span>(uoffset_t),</div> -<div class="line"><a name="l01636"></a><span class="lineno"> 1636</span>  <span class="stringliteral">"file_identifier is assumed to be the same size as uoffset_t"</span>);</div> -<div class="line"><a name="l01637"></a><span class="lineno"> 1637</span>  <span class="keywordflow">for</span> (<span class="keyword">auto</span> possible_roots = FLATBUFFERS_MAX_ALIGNMENT / <span class="keyword">sizeof</span>(uoffset_t) + 1;</div> -<div class="line"><a name="l01638"></a><span class="lineno"> 1638</span>  possible_roots;</div> -<div class="line"><a name="l01639"></a><span class="lineno"> 1639</span>  possible_roots--) {</div> -<div class="line"><a name="l01640"></a><span class="lineno"> 1640</span>  start -= <span class="keyword">sizeof</span>(uoffset_t);</div> -<div class="line"><a name="l01641"></a><span class="lineno"> 1641</span>  <span class="keywordflow">if</span> (ReadScalar<uoffset_t>(start) + start ==</div> -<div class="line"><a name="l01642"></a><span class="lineno"> 1642</span>  <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>uint8_t *<span class="keyword">></span>(root)) <span class="keywordflow">return</span> start;</div> -<div class="line"><a name="l01643"></a><span class="lineno"> 1643</span>  }</div> -<div class="line"><a name="l01644"></a><span class="lineno"> 1644</span>  <span class="comment">// We didn't find the root, either the "root" passed isn't really a root,</span></div> -<div class="line"><a name="l01645"></a><span class="lineno"> 1645</span>  <span class="comment">// or the buffer is corrupt.</span></div> -<div class="line"><a name="l01646"></a><span class="lineno"> 1646</span>  <span class="comment">// Assert, because calling this function with bad data may cause reads</span></div> -<div class="line"><a name="l01647"></a><span class="lineno"> 1647</span>  <span class="comment">// outside of buffer boundaries.</span></div> -<div class="line"><a name="l01648"></a><span class="lineno"> 1648</span>  assert(<span class="keyword">false</span>);</div> -<div class="line"><a name="l01649"></a><span class="lineno"> 1649</span>  <span class="keywordflow">return</span> <span class="keyword">nullptr</span>;</div> -<div class="line"><a name="l01650"></a><span class="lineno"> 1650</span> }</div> -<div class="line"><a name="l01651"></a><span class="lineno"> 1651</span> </div> -<div class="line"><a name="l01652"></a><span class="lineno"> 1652</span> <span class="comment">// Base class for native objects (FlatBuffer data de-serialized into native</span></div> -<div class="line"><a name="l01653"></a><span class="lineno"> 1653</span> <span class="comment">// C++ data structures).</span></div> -<div class="line"><a name="l01654"></a><span class="lineno"> 1654</span> <span class="comment">// Contains no functionality, purely documentative.</span></div> -<div class="line"><a name="l01655"></a><span class="lineno"> 1655</span> <span class="keyword">struct </span>NativeTable {</div> -<div class="line"><a name="l01656"></a><span class="lineno"> 1656</span> };</div> -<div class="line"><a name="l01657"></a><span class="lineno"> 1657</span> <span class="comment"></span></div> -<div class="line"><a name="l01658"></a><span class="lineno"> 1658</span> <span class="comment">/// @brief Function types to be used with resolving hashes into objects and</span></div> -<div class="line"><a name="l01659"></a><span class="lineno"> 1659</span> <span class="comment">/// back again. The resolver gets a pointer to a field inside an object API</span></div> -<div class="line"><a name="l01660"></a><span class="lineno"> 1660</span> <span class="comment">/// object that is of the type specified in the schema using the attribute</span></div> -<div class="line"><a name="l01661"></a><span class="lineno"> 1661</span> <span class="comment">/// `cpp_type` (it is thus important whatever you write to this address</span></div> -<div class="line"><a name="l01662"></a><span class="lineno"> 1662</span> <span class="comment">/// matches that type). The value of this field is initially null, so you</span></div> -<div class="line"><a name="l01663"></a><span class="lineno"> 1663</span> <span class="comment">/// may choose to implement a delayed binding lookup using this function</span></div> -<div class="line"><a name="l01664"></a><span class="lineno"> 1664</span> <span class="comment">/// if you wish. The resolver does the opposite lookup, for when the object</span></div> -<div class="line"><a name="l01665"></a><span class="lineno"> 1665</span> <span class="comment">/// is being serialized again.</span></div> -<div class="line"><a name="l01666"></a><span class="lineno"> 1666</span> <span class="comment"></span><span class="keyword">typedef</span> uint64_t hash_value_t;</div> -<div class="line"><a name="l01667"></a><span class="lineno"> 1667</span> <span class="preprocessor">#ifdef FLATBUFFERS_CPP98_STL</span></div> -<div class="line"><a name="l01668"></a><span class="lineno"> 1668</span>  <span class="keyword">typedef</span> void (*resolver_function_t)(<span class="keywordtype">void</span> **pointer_adr, hash_value_t hash);</div> -<div class="line"><a name="l01669"></a><span class="lineno"> 1669</span>  <span class="keyword">typedef</span> hash_value_t (*rehasher_function_t)(<span class="keywordtype">void</span> *pointer);</div> -<div class="line"><a name="l01670"></a><span class="lineno"> 1670</span> <span class="preprocessor">#else</span></div> -<div class="line"><a name="l01671"></a><span class="lineno"> 1671</span>  <span class="keyword">typedef</span> std::function<void (void **pointer_adr, hash_value_t hash)></div> -<div class="line"><a name="l01672"></a><span class="lineno"> 1672</span>  resolver_function_t;</div> -<div class="line"><a name="l01673"></a><span class="lineno"> 1673</span>  <span class="keyword">typedef</span> std::function<hash_value_t (void *pointer)> rehasher_function_t;</div> -<div class="line"><a name="l01674"></a><span class="lineno"> 1674</span> <span class="preprocessor">#endif</span></div> -<div class="line"><a name="l01675"></a><span class="lineno"> 1675</span> </div> -<div class="line"><a name="l01676"></a><span class="lineno"> 1676</span> <span class="comment">// Helper function to test if a field is present, using any of the field</span></div> -<div class="line"><a name="l01677"></a><span class="lineno"> 1677</span> <span class="comment">// enums in the generated code.</span></div> -<div class="line"><a name="l01678"></a><span class="lineno"> 1678</span> <span class="comment">// `table` must be a generated table type. Since this is a template parameter,</span></div> -<div class="line"><a name="l01679"></a><span class="lineno"> 1679</span> <span class="comment">// this is not typechecked to be a subclass of Table, so beware!</span></div> -<div class="line"><a name="l01680"></a><span class="lineno"> 1680</span> <span class="comment">// Note: this function will return false for fields equal to the default</span></div> -<div class="line"><a name="l01681"></a><span class="lineno"> 1681</span> <span class="comment">// value, since they're not stored in the buffer (unless force_defaults was</span></div> -<div class="line"><a name="l01682"></a><span class="lineno"> 1682</span> <span class="comment">// used).</span></div> -<div class="line"><a name="l01683"></a><span class="lineno"> 1683</span> <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> IsFieldPresent(<span class="keyword">const</span> T *table, voffset_t field) {</div> -<div class="line"><a name="l01684"></a><span class="lineno"> 1684</span>  <span class="comment">// Cast, since Table is a private baseclass of any table types.</span></div> -<div class="line"><a name="l01685"></a><span class="lineno"> 1685</span>  <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>Table *<span class="keyword">></span>(table)->CheckField(field);</div> -<div class="line"><a name="l01686"></a><span class="lineno"> 1686</span> }</div> -<div class="line"><a name="l01687"></a><span class="lineno"> 1687</span> </div> -<div class="line"><a name="l01688"></a><span class="lineno"> 1688</span> <span class="comment">// Utility function for reverse lookups on the EnumNames*() functions</span></div> -<div class="line"><a name="l01689"></a><span class="lineno"> 1689</span> <span class="comment">// (in the generated C++ code)</span></div> -<div class="line"><a name="l01690"></a><span class="lineno"> 1690</span> <span class="comment">// names must be NULL terminated.</span></div> -<div class="line"><a name="l01691"></a><span class="lineno"> 1691</span> <span class="keyword">inline</span> <span class="keywordtype">int</span> LookupEnum(<span class="keyword">const</span> <span class="keywordtype">char</span> **names, <span class="keyword">const</span> <span class="keywordtype">char</span> *name) {</div> -<div class="line"><a name="l01692"></a><span class="lineno"> 1692</span>  <span class="keywordflow">for</span> (<span class="keyword">const</span> <span class="keywordtype">char</span> **p = names; *p; p++)</div> -<div class="line"><a name="l01693"></a><span class="lineno"> 1693</span>  <span class="keywordflow">if</span> (!strcmp(*p, name))</div> -<div class="line"><a name="l01694"></a><span class="lineno"> 1694</span>  <span class="keywordflow">return</span> <span class="keyword">static_cast<</span><span class="keywordtype">int</span><span class="keyword">></span>(p - names);</div> -<div class="line"><a name="l01695"></a><span class="lineno"> 1695</span>  <span class="keywordflow">return</span> -1;</div> -<div class="line"><a name="l01696"></a><span class="lineno"> 1696</span> }</div> -<div class="line"><a name="l01697"></a><span class="lineno"> 1697</span> </div> -<div class="line"><a name="l01698"></a><span class="lineno"> 1698</span> <span class="comment">// These macros allow us to layout a struct with a guarantee that they'll end</span></div> -<div class="line"><a name="l01699"></a><span class="lineno"> 1699</span> <span class="comment">// up looking the same on different compilers and platforms.</span></div> -<div class="line"><a name="l01700"></a><span class="lineno"> 1700</span> <span class="comment">// It does this by disallowing the compiler to do any padding, and then</span></div> -<div class="line"><a name="l01701"></a><span class="lineno"> 1701</span> <span class="comment">// does padding itself by inserting extra padding fields that make every</span></div> -<div class="line"><a name="l01702"></a><span class="lineno"> 1702</span> <span class="comment">// element aligned to its own size.</span></div> -<div class="line"><a name="l01703"></a><span class="lineno"> 1703</span> <span class="comment">// Additionally, it manually sets the alignment of the struct as a whole,</span></div> -<div class="line"><a name="l01704"></a><span class="lineno"> 1704</span> <span class="comment">// which is typically its largest element, or a custom size set in the schema</span></div> -<div class="line"><a name="l01705"></a><span class="lineno"> 1705</span> <span class="comment">// by the force_align attribute.</span></div> -<div class="line"><a name="l01706"></a><span class="lineno"> 1706</span> <span class="comment">// These are used in the generated code only.</span></div> -<div class="line"><a name="l01707"></a><span class="lineno"> 1707</span> </div> -<div class="line"><a name="l01708"></a><span class="lineno"> 1708</span> <span class="preprocessor">#if defined(_MSC_VER)</span></div> -<div class="line"><a name="l01709"></a><span class="lineno"> 1709</span> <span class="preprocessor"> #define MANUALLY_ALIGNED_STRUCT(alignment) \</span></div> -<div class="line"><a name="l01710"></a><span class="lineno"> 1710</span> <span class="preprocessor"> __pragma(pack(1)); \</span></div> -<div class="line"><a name="l01711"></a><span class="lineno"> 1711</span> <span class="preprocessor"> struct __declspec(align(alignment))</span></div> -<div class="line"><a name="l01712"></a><span class="lineno"> 1712</span> <span class="preprocessor"> #define STRUCT_END(name, size) \</span></div> -<div class="line"><a name="l01713"></a><span class="lineno"> 1713</span> <span class="preprocessor"> __pragma(pack()); \</span></div> -<div class="line"><a name="l01714"></a><span class="lineno"> 1714</span> <span class="preprocessor"> static_assert(sizeof(name) == size, "compiler breaks packing rules")</span></div> -<div class="line"><a name="l01715"></a><span class="lineno"> 1715</span> <span class="preprocessor">#elif defined(__GNUC__) || defined(__clang__)</span></div> -<div class="line"><a name="l01716"></a><span class="lineno"> 1716</span> <span class="preprocessor"> #define MANUALLY_ALIGNED_STRUCT(alignment) \</span></div> -<div class="line"><a name="l01717"></a><span class="lineno"> 1717</span> <span class="preprocessor"> _Pragma("pack(1)") \</span></div> -<div class="line"><a name="l01718"></a><span class="lineno"> 1718</span> <span class="preprocessor"> struct __attribute__((aligned(alignment)))</span></div> -<div class="line"><a name="l01719"></a><span class="lineno"> 1719</span> <span class="preprocessor"> #define STRUCT_END(name, size) \</span></div> -<div class="line"><a name="l01720"></a><span class="lineno"> 1720</span> <span class="preprocessor"> _Pragma("pack()") \</span></div> -<div class="line"><a name="l01721"></a><span class="lineno"> 1721</span> <span class="preprocessor"> static_assert(sizeof(name) == size, "compiler breaks packing rules")</span></div> -<div class="line"><a name="l01722"></a><span class="lineno"> 1722</span> <span class="preprocessor">#else</span></div> -<div class="line"><a name="l01723"></a><span class="lineno"> 1723</span> <span class="preprocessor"> #error Unknown compiler, please define structure alignment macros</span></div> -<div class="line"><a name="l01724"></a><span class="lineno"> 1724</span> <span class="preprocessor">#endif</span></div> -<div class="line"><a name="l01725"></a><span class="lineno"> 1725</span> </div> -<div class="line"><a name="l01726"></a><span class="lineno"> 1726</span> <span class="comment">// String which identifies the current version of FlatBuffers.</span></div> -<div class="line"><a name="l01727"></a><span class="lineno"> 1727</span> <span class="comment">// flatbuffer_version_string is used by Google developers to identify which</span></div> -<div class="line"><a name="l01728"></a><span class="lineno"> 1728</span> <span class="comment">// applications uploaded to Google Play are using this library. This allows</span></div> -<div class="line"><a name="l01729"></a><span class="lineno"> 1729</span> <span class="comment">// the development team at Google to determine the popularity of the library.</span></div> -<div class="line"><a name="l01730"></a><span class="lineno"> 1730</span> <span class="comment">// How it works: Applications that are uploaded to the Google Play Store are</span></div> -<div class="line"><a name="l01731"></a><span class="lineno"> 1731</span> <span class="comment">// scanned for this version string. We track which applications are using it</span></div> -<div class="line"><a name="l01732"></a><span class="lineno"> 1732</span> <span class="comment">// to measure popularity. You are free to remove it (of course) but we would</span></div> -<div class="line"><a name="l01733"></a><span class="lineno"> 1733</span> <span class="comment">// appreciate if you left it in.</span></div> -<div class="line"><a name="l01734"></a><span class="lineno"> 1734</span> </div> -<div class="line"><a name="l01735"></a><span class="lineno"> 1735</span> <span class="comment">// Weak linkage is culled by VS & doesn't work on cygwin.</span></div> -<div class="line"><a name="l01736"></a><span class="lineno"> 1736</span> <span class="preprocessor">#if !defined(_WIN32) && !defined(__CYGWIN__)</span></div> -<div class="line"><a name="l01737"></a><span class="lineno"> 1737</span> </div> -<div class="line"><a name="l01738"></a><span class="lineno"> 1738</span> <span class="keyword">extern</span> <span class="keyword">volatile</span> __attribute__((weak)) const <span class="keywordtype">char</span> *flatbuffer_version_string;</div> -<div class="line"><a name="l01739"></a><span class="lineno"> 1739</span> volatile __attribute__((weak)) const <span class="keywordtype">char</span> *flatbuffer_version_string =</div> -<div class="line"><a name="l01740"></a><span class="lineno"> 1740</span>  "FlatBuffers "</div> -<div class="line"><a name="l01741"></a><span class="lineno"> 1741</span>  FLATBUFFERS_STRING(FLATBUFFERS_VERSION_MAJOR) "."</div> -<div class="line"><a name="l01742"></a><span class="lineno"> 1742</span>  FLATBUFFERS_STRING(FLATBUFFERS_VERSION_MINOR) "."</div> -<div class="line"><a name="l01743"></a><span class="lineno"> 1743</span>  FLATBUFFERS_STRING(FLATBUFFERS_VERSION_REVISION);</div> -<div class="line"><a name="l01744"></a><span class="lineno"> 1744</span> </div> -<div class="line"><a name="l01745"></a><span class="lineno"> 1745</span> <span class="preprocessor">#endif // !defined(_WIN32) && !defined(__CYGWIN__)</span></div> -<div class="line"><a name="l01746"></a><span class="lineno"> 1746</span> </div> -<div class="line"><a name="l01747"></a><span class="lineno"> 1747</span> <span class="preprocessor">#define DEFINE_BITMASK_OPERATORS(E, T)\</span></div> -<div class="line"><a name="l01748"></a><span class="lineno"> 1748</span> <span class="preprocessor"> inline E operator | (E lhs, E rhs){\</span></div> -<div class="line"><a name="l01749"></a><span class="lineno"> 1749</span> <span class="preprocessor"> return E(T(lhs) | T(rhs));\</span></div> -<div class="line"><a name="l01750"></a><span class="lineno"> 1750</span> <span class="preprocessor"> }\</span></div> -<div class="line"><a name="l01751"></a><span class="lineno"> 1751</span> <span class="preprocessor"> inline E operator & (E lhs, E rhs){\</span></div> -<div class="line"><a name="l01752"></a><span class="lineno"> 1752</span> <span class="preprocessor"> return E(T(lhs) & T(rhs));\</span></div> -<div class="line"><a name="l01753"></a><span class="lineno"> 1753</span> <span class="preprocessor"> }\</span></div> -<div class="line"><a name="l01754"></a><span class="lineno"> 1754</span> <span class="preprocessor"> inline E operator ^ (E lhs, E rhs){\</span></div> -<div class="line"><a name="l01755"></a><span class="lineno"> 1755</span> <span class="preprocessor"> return E(T(lhs) ^ T(rhs));\</span></div> -<div class="line"><a name="l01756"></a><span class="lineno"> 1756</span> <span class="preprocessor"> }\</span></div> -<div class="line"><a name="l01757"></a><span class="lineno"> 1757</span> <span class="preprocessor"> inline E operator ~ (E lhs){\</span></div> -<div class="line"><a name="l01758"></a><span class="lineno"> 1758</span> <span class="preprocessor"> return E(~T(lhs));\</span></div> -<div class="line"><a name="l01759"></a><span class="lineno"> 1759</span> <span class="preprocessor"> }\</span></div> -<div class="line"><a name="l01760"></a><span class="lineno"> 1760</span> <span class="preprocessor"> inline E operator |= (E &lhs, E rhs){\</span></div> -<div class="line"><a name="l01761"></a><span class="lineno"> 1761</span> <span class="preprocessor"> lhs = lhs | rhs;\</span></div> -<div class="line"><a name="l01762"></a><span class="lineno"> 1762</span> <span class="preprocessor"> return lhs;\</span></div> -<div class="line"><a name="l01763"></a><span class="lineno"> 1763</span> <span class="preprocessor"> }\</span></div> -<div class="line"><a name="l01764"></a><span class="lineno"> 1764</span> <span class="preprocessor"> inline E operator &= (E &lhs, E rhs){\</span></div> -<div class="line"><a name="l01765"></a><span class="lineno"> 1765</span> <span class="preprocessor"> lhs = lhs & rhs;\</span></div> -<div class="line"><a name="l01766"></a><span class="lineno"> 1766</span> <span class="preprocessor"> return lhs;\</span></div> -<div class="line"><a name="l01767"></a><span class="lineno"> 1767</span> <span class="preprocessor"> }\</span></div> -<div class="line"><a name="l01768"></a><span class="lineno"> 1768</span> <span class="preprocessor"> inline E operator ^= (E &lhs, E rhs){\</span></div> -<div class="line"><a name="l01769"></a><span class="lineno"> 1769</span> <span class="preprocessor"> lhs = lhs ^ rhs;\</span></div> -<div class="line"><a name="l01770"></a><span class="lineno"> 1770</span> <span class="preprocessor"> return lhs;\</span></div> -<div class="line"><a name="l01771"></a><span class="lineno"> 1771</span> <span class="preprocessor"> }\</span></div> -<div class="line"><a name="l01772"></a><span class="lineno"> 1772</span> <span class="preprocessor"> inline bool operator !(E rhs) \</span></div> -<div class="line"><a name="l01773"></a><span class="lineno"> 1773</span> <span class="preprocessor"> {\</span></div> -<div class="line"><a name="l01774"></a><span class="lineno"> 1774</span> <span class="preprocessor"> return !bool(T(rhs)); \</span></div> -<div class="line"><a name="l01775"></a><span class="lineno"> 1775</span> <span class="preprocessor"> }</span></div> -<div class="line"><a name="l01776"></a><span class="lineno"> 1776</span> <span class="comment">/// @endcond</span></div> -<div class="line"><a name="l01777"></a><span class="lineno"> 1777</span> <span class="comment"></span>} <span class="comment">// namespace flatbuffers</span></div> -<div class="line"><a name="l01778"></a><span class="lineno"> 1778</span> </div> -<div class="line"><a name="l01779"></a><span class="lineno"> 1779</span> <span class="preprocessor">#endif // FLATBUFFERS_H_</span></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a1080c9e370e2d9d9d872dadd1131436b"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a1080c9e370e2d9d9d872dadd1131436b">flatbuffers::FlatBufferBuilder::CreateVector</a></div><div class="ttdeci">Offset< Vector< T > > CreateVector(size_t vector_size, const std::function< T(size_t i)> &f)</div><div class="ttdoc">Serialize values returned by a function into a FlatBuffer vector. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1045</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_ac2b96292fa0fb1534fe7fd218a094d0c"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#ac2b96292fa0fb1534fe7fd218a094d0c">flatbuffers::FlatBufferBuilder::CreateUninitializedVector</a></div><div class="ttdeci">uoffset_t CreateUninitializedVector(size_t len, size_t elemsize, uint8_t **buf)</div><div class="ttdoc">Specialized version of CreateVector for non-copying use cases. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1140</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_ac64d11c219559ea51567eab556e13135"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#ac64d11c219559ea51567eab556e13135">flatbuffers::FlatBufferBuilder::CreateVectorOfSortedTables</a></div><div class="ttdeci">Offset< Vector< Offset< T > > > CreateVectorOfSortedTables(std::vector< Offset< T >> *v)</div><div class="ttdoc">Serialize an array of table offsets as a vector in the buffer in sorted order. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1128</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html">flatbuffers::FlatBufferBuilder</a></div><div class="ttdoc">Helper class to hold data needed in creation of a FlatBuffer. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:601</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_ac1bfd609f7f736e9a37cedae77448b63"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">flatbuffers::FlatBufferBuilder::GetSize</a></div><div class="ttdeci">uoffset_t GetSize() const </div><div class="ttdoc">The current size of the serialized buffer, counting from the end. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:641</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_ac72b54a75e0c329e0ce0b8fab758e256"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#ac72b54a75e0c329e0ce0b8fab758e256">flatbuffers::FlatBufferBuilder::FlatBufferBuilder</a></div><div class="ttdeci">FlatBufferBuilder(uoffset_t initial_size=1024, const simple_allocator *allocator=nullptr)</div><div class="ttdoc">Default constructor for FlatBufferBuilder. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:613</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_ae94b94ba71ea0aeb2d9a98c43b713412"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#ae94b94ba71ea0aeb2d9a98c43b713412">flatbuffers::FlatBufferBuilder::Clear</a></div><div class="ttdeci">void Clear()</div><div class="ttdoc">Reset all the state in this FlatBufferBuilder so it can be reused to construct another buffer...</div><div class="ttdef"><b>Definition:</b> flatbuffers.h:629</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a21c7f933d7ff1212f2090763ef9f0c44"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a21c7f933d7ff1212f2090763ef9f0c44">flatbuffers::FlatBufferBuilder::ReleaseBufferPointer</a></div><div class="ttdeci">unique_ptr_t ReleaseBufferPointer()</div><div class="ttdoc">Get the released pointer to the serialized buffer. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:662</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a7ba8462e408431054c99d25120326220"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a7ba8462e408431054c99d25120326220">flatbuffers::FlatBufferBuilder::FinishSizePrefixed</a></div><div class="ttdeci">void FinishSizePrefixed(Offset< T > root, const char *file_identifier=nullptr)</div><div class="ttdoc">Finish a buffer with a 32 bit size field pre-fixed (size of the buffer following the size field)...</div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1184</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a3eb68613e5883dc4b8fff6cf7d1223d7"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a3eb68613e5883dc4b8fff6cf7d1223d7">flatbuffers::FlatBufferBuilder::CreateSharedString</a></div><div class="ttdeci">Offset< String > CreateSharedString(const char *str)</div><div class="ttdoc">Store a string in the buffer, which null-terminated. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:951</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_aec6f9df2a0366b540b24822414d92cbe"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#aec6f9df2a0366b540b24822414d92cbe">flatbuffers::FlatBufferBuilder::CreateString</a></div><div class="ttdeci">Offset< String > CreateString(const char *str, size_t len)</div><div class="ttdoc">Store a string in the buffer, which can contain any binary data. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:891</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a16a8fd46b34ad7727406c37b65b6b27a"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a16a8fd46b34ad7727406c37b65b6b27a">flatbuffers::FlatBufferBuilder::ForceDefaults</a></div><div class="ttdeci">void ForceDefaults(bool fd)</div><div class="ttdoc">In order to save space, fields that are set to their default value don't get serialized into the buff...</div><div class="ttdef"><b>Definition:</b> flatbuffers.h:692</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_af8c7583c92e1d1d6f438977da5158d19"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#af8c7583c92e1d1d6f438977da5158d19">flatbuffers::FlatBufferBuilder::kFileIdentifierLength</a></div><div class="ttdeci">static const size_t kFileIdentifierLength</div><div class="ttdoc">The length of a FlatBuffer file header. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1166</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_ac0b6a1c5d949f20ad84367fc0f9e1506"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#ac0b6a1c5d949f20ad84367fc0f9e1506">flatbuffers::FlatBufferBuilder::CreateString</a></div><div class="ttdeci">Offset< String > CreateString(const String *str)</div><div class="ttdoc">Store a string in the buffer, which can contain any binary data. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:917</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a840b769fbb4148f97d3eed266e4690c3"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a840b769fbb4148f97d3eed266e4690c3">flatbuffers::FlatBufferBuilder::CreateSharedString</a></div><div class="ttdeci">Offset< String > CreateSharedString(const String *str)</div><div class="ttdoc">Store a string in the buffer, which can contain any binary data. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:969</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a592110519a6c8db1926f1365bf2a58e6"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a592110519a6c8db1926f1365bf2a58e6">flatbuffers::FlatBufferBuilder::CreateVectorOfStrings</a></div><div class="ttdeci">Offset< Vector< Offset< String > > > CreateVectorOfStrings(const std::vector< std::string > &v)</div><div class="ttdoc">Serialize a std::vector<std::string> into a FlatBuffer vector. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1059</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_aa1ebce1f3f46832946a95952af1e9c2b"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#aa1ebce1f3f46832946a95952af1e9c2b">flatbuffers::FlatBufferBuilder::GetBufferMinAlignment</a></div><div class="ttdeci">size_t GetBufferMinAlignment()</div><div class="ttdoc">get the minimum alignment this buffer needs to be accessed properly. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:673</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_afede51fd9c32d146cbb1832f57c5e1b7"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#afede51fd9c32d146cbb1832f57c5e1b7">flatbuffers::FlatBufferBuilder::CreateVectorOfStructs</a></div><div class="ttdeci">Offset< Vector< const T * > > CreateVectorOfStructs(const T *v, size_t len)</div><div class="ttdoc">Serialize an array of structs into a FlatBuffer vector. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1073</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_aad93d113ac24e86ed04b5236b3f4c0c5"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#aad93d113ac24e86ed04b5236b3f4c0c5">flatbuffers::FlatBufferBuilder::CreateString</a></div><div class="ttdeci">Offset< String > CreateString(const char *str)</div><div class="ttdoc">Store a string in the buffer, which is null-terminated. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:903</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a8c3af55e64f5cda9aefa38ac5287ef9f"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a8c3af55e64f5cda9aefa38ac5287ef9f">flatbuffers::FlatBufferBuilder::CreateString</a></div><div class="ttdeci">Offset< String > CreateString(const std::string &str)</div><div class="ttdoc">Store a string in the buffer, which can contain any binary data. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:910</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_af715dd24dd37cb0151dc7a980ad0f207"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#af715dd24dd37cb0151dc7a980ad0f207">flatbuffers::FlatBufferBuilder::CreateVector</a></div><div class="ttdeci">Offset< Vector< T > > CreateVector(const std::vector< T > &v)</div><div class="ttdoc">Serialize a std::vector into a FlatBuffer vector. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1022</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a2305b63d367845972b51669dd995cc50"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a2305b63d367845972b51669dd995cc50">flatbuffers::FlatBufferBuilder::CreateUninitializedVector</a></div><div class="ttdeci">Offset< Vector< T > > CreateUninitializedVector(size_t len, T **buf)</div><div class="ttdoc">Specialized version of CreateVector for non-copying use cases. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1159</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a3f4252e9bc005ba6c700469544fdccc9"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a3f4252e9bc005ba6c700469544fdccc9">flatbuffers::FlatBufferBuilder::GetCurrentBufferPointer</a></div><div class="ttdeci">uint8_t * GetCurrentBufferPointer() const </div><div class="ttdoc">Get a pointer to an unfinished buffer. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:653</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a2cca5c89246a53e80e6ad9487f4c36f3"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a2cca5c89246a53e80e6ad9487f4c36f3">flatbuffers::FlatBufferBuilder::CreateVector</a></div><div class="ttdeci">Offset< Vector< T > > CreateVector(const T *v, size_t len)</div><div class="ttdoc">Serialize an array into a FlatBuffer vector. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1008</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a10e8ec7d1c8fbdc21b1c7047bbbe38d9"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a10e8ec7d1c8fbdc21b1c7047bbbe38d9">flatbuffers::FlatBufferBuilder::CreateSharedString</a></div><div class="ttdeci">Offset< String > CreateSharedString(const std::string &str)</div><div class="ttdoc">Store a string in the buffer, which can contain any binary data. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:960</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a2130ef232ff405eebe2e7f184ecd06e6"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a2130ef232ff405eebe2e7f184ecd06e6">flatbuffers::FlatBufferBuilder::CreateVectorOfSortedTables</a></div><div class="ttdeci">Offset< Vector< Offset< T > > > CreateVectorOfSortedTables(Offset< T > *v, size_t len)</div><div class="ttdoc">Serialize an array of table offsets as a vector in the buffer in sorted order. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1115</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_ab478a645216d2d613fc7b7c29b0ff9d1"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#ab478a645216d2d613fc7b7c29b0ff9d1">flatbuffers::FlatBufferBuilder::CreateSharedString</a></div><div class="ttdeci">Offset< String > CreateSharedString(const char *str, size_t len)</div><div class="ttdoc">Store a string in the buffer, which can contain any binary data. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:927</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a8704709a2e25ad04679212ee4126b1a1"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a8704709a2e25ad04679212ee4126b1a1">flatbuffers::FlatBufferBuilder::CreateVectorOfStructs</a></div><div class="ttdeci">Offset< Vector< const T * > > CreateVectorOfStructs(const std::vector< T > &v)</div><div class="ttdoc">Serialize a std::vector of structs into a FlatBuffer vector. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1086</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a0c9e507b373d598b51052fab4fa34912"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a0c9e507b373d598b51052fab4fa34912">flatbuffers::FlatBufferBuilder::Finish</a></div><div class="ttdeci">void Finish(Offset< T > root, const char *file_identifier=nullptr)</div><div class="ttdoc">Finish serializing a buffer by writing the root offset. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1171</div></div> -<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a8dc35f792179df4ca850492c1796d8b8"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a8dc35f792179df4ca850492c1796d8b8">flatbuffers::FlatBufferBuilder::GetBufferPointer</a></div><div class="ttdeci">uint8_t * GetBufferPointer() const </div><div class="ttdoc">Get the serialized buffer (after you call Finish()). </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:646</div></div> +<div class="line"><a name="l01593"></a><span class="lineno"> 1593</span>  <span class="keywordflow">return</span> field_offset ? data_ + field_offset : <span class="keyword">nullptr</span>;</div> +<div class="line"><a name="l01594"></a><span class="lineno"> 1594</span>  }</div> +<div class="line"><a name="l01595"></a><span class="lineno"> 1595</span>  <span class="keyword">const</span> uint8_t *GetAddressOf(voffset_t field)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01596"></a><span class="lineno"> 1596</span>  <span class="keywordflow">return</span> <span class="keyword">const_cast<</span>Table *<span class="keyword">></span>(<span class="keyword">this</span>)->GetAddressOf(field);</div> +<div class="line"><a name="l01597"></a><span class="lineno"> 1597</span>  }</div> +<div class="line"><a name="l01598"></a><span class="lineno"> 1598</span> </div> +<div class="line"><a name="l01599"></a><span class="lineno"> 1599</span>  <span class="keywordtype">bool</span> CheckField(voffset_t field)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01600"></a><span class="lineno"> 1600</span>  <span class="keywordflow">return</span> GetOptionalFieldOffset(field) != 0;</div> +<div class="line"><a name="l01601"></a><span class="lineno"> 1601</span>  }</div> +<div class="line"><a name="l01602"></a><span class="lineno"> 1602</span> </div> +<div class="line"><a name="l01603"></a><span class="lineno"> 1603</span>  <span class="comment">// Verify the vtable of this table.</span></div> +<div class="line"><a name="l01604"></a><span class="lineno"> 1604</span>  <span class="comment">// Call this once per table, followed by VerifyField once per field.</span></div> +<div class="line"><a name="l01605"></a><span class="lineno"> 1605</span>  <span class="keywordtype">bool</span> VerifyTableStart(Verifier &verifier)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01606"></a><span class="lineno"> 1606</span>  <span class="comment">// Check the vtable offset.</span></div> +<div class="line"><a name="l01607"></a><span class="lineno"> 1607</span>  <span class="keywordflow">if</span> (!verifier.Verify<soffset_t>(data_)) <span class="keywordflow">return</span> <span class="keyword">false</span>;</div> +<div class="line"><a name="l01608"></a><span class="lineno"> 1608</span>  <span class="keyword">auto</span> vtable = GetVTable();</div> +<div class="line"><a name="l01609"></a><span class="lineno"> 1609</span>  <span class="comment">// Check the vtable size field, then check vtable fits in its entirety.</span></div> +<div class="line"><a name="l01610"></a><span class="lineno"> 1610</span>  <span class="keywordflow">return</span> verifier.VerifyComplexity() &&</div> +<div class="line"><a name="l01611"></a><span class="lineno"> 1611</span>  verifier.Verify<voffset_t>(vtable) &&</div> +<div class="line"><a name="l01612"></a><span class="lineno"> 1612</span>  (ReadScalar<voffset_t>(vtable) & (<span class="keyword">sizeof</span>(voffset_t) - 1)) == 0 &&</div> +<div class="line"><a name="l01613"></a><span class="lineno"> 1613</span>  verifier.Verify(vtable, ReadScalar<voffset_t>(vtable));</div> +<div class="line"><a name="l01614"></a><span class="lineno"> 1614</span>  }</div> +<div class="line"><a name="l01615"></a><span class="lineno"> 1615</span> </div> +<div class="line"><a name="l01616"></a><span class="lineno"> 1616</span>  <span class="comment">// Verify a particular field.</span></div> +<div class="line"><a name="l01617"></a><span class="lineno"> 1617</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> VerifyField(<span class="keyword">const</span> Verifier &verifier,</div> +<div class="line"><a name="l01618"></a><span class="lineno"> 1618</span>  voffset_t field)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01619"></a><span class="lineno"> 1619</span>  <span class="comment">// Calling GetOptionalFieldOffset should be safe now thanks to</span></div> +<div class="line"><a name="l01620"></a><span class="lineno"> 1620</span>  <span class="comment">// VerifyTable().</span></div> +<div class="line"><a name="l01621"></a><span class="lineno"> 1621</span>  <span class="keyword">auto</span> field_offset = GetOptionalFieldOffset(field);</div> +<div class="line"><a name="l01622"></a><span class="lineno"> 1622</span>  <span class="comment">// Check the actual field.</span></div> +<div class="line"><a name="l01623"></a><span class="lineno"> 1623</span>  <span class="keywordflow">return</span> !field_offset || verifier.Verify<T>(data_ + field_offset);</div> +<div class="line"><a name="l01624"></a><span class="lineno"> 1624</span>  }</div> +<div class="line"><a name="l01625"></a><span class="lineno"> 1625</span> </div> +<div class="line"><a name="l01626"></a><span class="lineno"> 1626</span>  <span class="comment">// VerifyField for required fields.</span></div> +<div class="line"><a name="l01627"></a><span class="lineno"> 1627</span>  <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> VerifyFieldRequired(<span class="keyword">const</span> Verifier &verifier,</div> +<div class="line"><a name="l01628"></a><span class="lineno"> 1628</span>  voffset_t field)<span class="keyword"> const </span>{</div> +<div class="line"><a name="l01629"></a><span class="lineno"> 1629</span>  <span class="keyword">auto</span> field_offset = GetOptionalFieldOffset(field);</div> +<div class="line"><a name="l01630"></a><span class="lineno"> 1630</span>  <span class="keywordflow">return</span> verifier.Check(field_offset != 0) &&</div> +<div class="line"><a name="l01631"></a><span class="lineno"> 1631</span>  verifier.Verify<T>(data_ + field_offset);</div> +<div class="line"><a name="l01632"></a><span class="lineno"> 1632</span>  }</div> +<div class="line"><a name="l01633"></a><span class="lineno"> 1633</span> </div> +<div class="line"><a name="l01634"></a><span class="lineno"> 1634</span>  <span class="keyword">private</span>:</div> +<div class="line"><a name="l01635"></a><span class="lineno"> 1635</span>  <span class="comment">// private constructor & copy constructor: you obtain instances of this</span></div> +<div class="line"><a name="l01636"></a><span class="lineno"> 1636</span>  <span class="comment">// class by pointing to existing data only</span></div> +<div class="line"><a name="l01637"></a><span class="lineno"> 1637</span>  Table();</div> +<div class="line"><a name="l01638"></a><span class="lineno"> 1638</span>  Table(<span class="keyword">const</span> Table &other);</div> +<div class="line"><a name="l01639"></a><span class="lineno"> 1639</span> </div> +<div class="line"><a name="l01640"></a><span class="lineno"> 1640</span>  uint8_t data_[1];</div> +<div class="line"><a name="l01641"></a><span class="lineno"> 1641</span> };</div> +<div class="line"><a name="l01642"></a><span class="lineno"> 1642</span> <span class="comment"></span></div> +<div class="line"><a name="l01643"></a><span class="lineno"> 1643</span> <span class="comment">/// @brief This can compute the start of a FlatBuffer from a root pointer, i.e.</span></div> +<div class="line"><a name="l01644"></a><span class="lineno"> 1644</span> <span class="comment">/// it is the opposite transformation of GetRoot().</span></div> +<div class="line"><a name="l01645"></a><span class="lineno"> 1645</span> <span class="comment">/// This may be useful if you want to pass on a root and have the recipient</span></div> +<div class="line"><a name="l01646"></a><span class="lineno"> 1646</span> <span class="comment">/// delete the buffer afterwards.</span></div> +<div class="line"><a name="l01647"></a><span class="lineno"> 1647</span> <span class="comment"></span><span class="keyword">inline</span> <span class="keyword">const</span> uint8_t *GetBufferStartFromRootPointer(<span class="keyword">const</span> <span class="keywordtype">void</span> *root) {</div> +<div class="line"><a name="l01648"></a><span class="lineno"> 1648</span>  <span class="keyword">auto</span> table = <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>Table *<span class="keyword">></span>(root);</div> +<div class="line"><a name="l01649"></a><span class="lineno"> 1649</span>  <span class="keyword">auto</span> vtable = table->GetVTable();</div> +<div class="line"><a name="l01650"></a><span class="lineno"> 1650</span>  <span class="comment">// Either the vtable is before the root or after the root.</span></div> +<div class="line"><a name="l01651"></a><span class="lineno"> 1651</span>  <span class="keyword">auto</span> start = std::min(vtable, reinterpret_cast<const uint8_t *>(root));</div> +<div class="line"><a name="l01652"></a><span class="lineno"> 1652</span>  <span class="comment">// Align to at least sizeof(uoffset_t).</span></div> +<div class="line"><a name="l01653"></a><span class="lineno"> 1653</span>  start = <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>uint8_t *<span class="keyword">></span>(</div> +<div class="line"><a name="l01654"></a><span class="lineno"> 1654</span>  <span class="keyword">reinterpret_cast<</span>uintptr_t<span class="keyword">></span>(start) & ~(<span class="keyword">sizeof</span>(uoffset_t) - 1));</div> +<div class="line"><a name="l01655"></a><span class="lineno"> 1655</span>  <span class="comment">// Additionally, there may be a file_identifier in the buffer, and the root</span></div> +<div class="line"><a name="l01656"></a><span class="lineno"> 1656</span>  <span class="comment">// offset. The buffer may have been aligned to any size between</span></div> +<div class="line"><a name="l01657"></a><span class="lineno"> 1657</span>  <span class="comment">// sizeof(uoffset_t) and FLATBUFFERS_MAX_ALIGNMENT (see "force_align").</span></div> +<div class="line"><a name="l01658"></a><span class="lineno"> 1658</span>  <span class="comment">// Sadly, the exact alignment is only known when constructing the buffer,</span></div> +<div class="line"><a name="l01659"></a><span class="lineno"> 1659</span>  <span class="comment">// since it depends on the presence of values with said alignment properties.</span></div> +<div class="line"><a name="l01660"></a><span class="lineno"> 1660</span>  <span class="comment">// So instead, we simply look at the next uoffset_t values (root,</span></div> +<div class="line"><a name="l01661"></a><span class="lineno"> 1661</span>  <span class="comment">// file_identifier, and alignment padding) to see which points to the root.</span></div> +<div class="line"><a name="l01662"></a><span class="lineno"> 1662</span>  <span class="comment">// None of the other values can "impersonate" the root since they will either</span></div> +<div class="line"><a name="l01663"></a><span class="lineno"> 1663</span>  <span class="comment">// be 0 or four ASCII characters.</span></div> +<div class="line"><a name="l01664"></a><span class="lineno"> 1664</span>  static_assert(<a class="code" href="classflatbuffers_1_1_flat_buffer_builder.html#af8c7583c92e1d1d6f438977da5158d19">FlatBufferBuilder::kFileIdentifierLength</a> == <span class="keyword">sizeof</span>(uoffset_t),</div> +<div class="line"><a name="l01665"></a><span class="lineno"> 1665</span>  <span class="stringliteral">"file_identifier is assumed to be the same size as uoffset_t"</span>);</div> +<div class="line"><a name="l01666"></a><span class="lineno"> 1666</span>  <span class="keywordflow">for</span> (<span class="keyword">auto</span> possible_roots = FLATBUFFERS_MAX_ALIGNMENT / <span class="keyword">sizeof</span>(uoffset_t) + 1;</div> +<div class="line"><a name="l01667"></a><span class="lineno"> 1667</span>  possible_roots;</div> +<div class="line"><a name="l01668"></a><span class="lineno"> 1668</span>  possible_roots--) {</div> +<div class="line"><a name="l01669"></a><span class="lineno"> 1669</span>  start -= <span class="keyword">sizeof</span>(uoffset_t);</div> +<div class="line"><a name="l01670"></a><span class="lineno"> 1670</span>  <span class="keywordflow">if</span> (ReadScalar<uoffset_t>(start) + start ==</div> +<div class="line"><a name="l01671"></a><span class="lineno"> 1671</span>  <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>uint8_t *<span class="keyword">></span>(root)) <span class="keywordflow">return</span> start;</div> +<div class="line"><a name="l01672"></a><span class="lineno"> 1672</span>  }</div> +<div class="line"><a name="l01673"></a><span class="lineno"> 1673</span>  <span class="comment">// We didn't find the root, either the "root" passed isn't really a root,</span></div> +<div class="line"><a name="l01674"></a><span class="lineno"> 1674</span>  <span class="comment">// or the buffer is corrupt.</span></div> +<div class="line"><a name="l01675"></a><span class="lineno"> 1675</span>  <span class="comment">// Assert, because calling this function with bad data may cause reads</span></div> +<div class="line"><a name="l01676"></a><span class="lineno"> 1676</span>  <span class="comment">// outside of buffer boundaries.</span></div> +<div class="line"><a name="l01677"></a><span class="lineno"> 1677</span>  assert(<span class="keyword">false</span>);</div> +<div class="line"><a name="l01678"></a><span class="lineno"> 1678</span>  <span class="keywordflow">return</span> <span class="keyword">nullptr</span>;</div> +<div class="line"><a name="l01679"></a><span class="lineno"> 1679</span> }</div> +<div class="line"><a name="l01680"></a><span class="lineno"> 1680</span> </div> +<div class="line"><a name="l01681"></a><span class="lineno"> 1681</span> <span class="comment">// Base class for native objects (FlatBuffer data de-serialized into native</span></div> +<div class="line"><a name="l01682"></a><span class="lineno"> 1682</span> <span class="comment">// C++ data structures).</span></div> +<div class="line"><a name="l01683"></a><span class="lineno"> 1683</span> <span class="comment">// Contains no functionality, purely documentative.</span></div> +<div class="line"><a name="l01684"></a><span class="lineno"> 1684</span> <span class="keyword">struct </span>NativeTable {</div> +<div class="line"><a name="l01685"></a><span class="lineno"> 1685</span> };</div> +<div class="line"><a name="l01686"></a><span class="lineno"> 1686</span> <span class="comment"></span></div> +<div class="line"><a name="l01687"></a><span class="lineno"> 1687</span> <span class="comment">/// @brief Function types to be used with resolving hashes into objects and</span></div> +<div class="line"><a name="l01688"></a><span class="lineno"> 1688</span> <span class="comment">/// back again. The resolver gets a pointer to a field inside an object API</span></div> +<div class="line"><a name="l01689"></a><span class="lineno"> 1689</span> <span class="comment">/// object that is of the type specified in the schema using the attribute</span></div> +<div class="line"><a name="l01690"></a><span class="lineno"> 1690</span> <span class="comment">/// `cpp_type` (it is thus important whatever you write to this address</span></div> +<div class="line"><a name="l01691"></a><span class="lineno"> 1691</span> <span class="comment">/// matches that type). The value of this field is initially null, so you</span></div> +<div class="line"><a name="l01692"></a><span class="lineno"> 1692</span> <span class="comment">/// may choose to implement a delayed binding lookup using this function</span></div> +<div class="line"><a name="l01693"></a><span class="lineno"> 1693</span> <span class="comment">/// if you wish. The resolver does the opposite lookup, for when the object</span></div> +<div class="line"><a name="l01694"></a><span class="lineno"> 1694</span> <span class="comment">/// is being serialized again.</span></div> +<div class="line"><a name="l01695"></a><span class="lineno"> 1695</span> <span class="comment"></span><span class="keyword">typedef</span> uint64_t hash_value_t;</div> +<div class="line"><a name="l01696"></a><span class="lineno"> 1696</span> <span class="preprocessor">#ifdef FLATBUFFERS_CPP98_STL</span></div> +<div class="line"><a name="l01697"></a><span class="lineno"> 1697</span>  <span class="keyword">typedef</span> void (*resolver_function_t)(<span class="keywordtype">void</span> **pointer_adr, hash_value_t hash);</div> +<div class="line"><a name="l01698"></a><span class="lineno"> 1698</span>  <span class="keyword">typedef</span> hash_value_t (*rehasher_function_t)(<span class="keywordtype">void</span> *pointer);</div> +<div class="line"><a name="l01699"></a><span class="lineno"> 1699</span> <span class="preprocessor">#else</span></div> +<div class="line"><a name="l01700"></a><span class="lineno"> 1700</span>  <span class="keyword">typedef</span> std::function<void (void **pointer_adr, hash_value_t hash)></div> +<div class="line"><a name="l01701"></a><span class="lineno"> 1701</span>  resolver_function_t;</div> +<div class="line"><a name="l01702"></a><span class="lineno"> 1702</span>  <span class="keyword">typedef</span> std::function<hash_value_t (void *pointer)> rehasher_function_t;</div> +<div class="line"><a name="l01703"></a><span class="lineno"> 1703</span> <span class="preprocessor">#endif</span></div> +<div class="line"><a name="l01704"></a><span class="lineno"> 1704</span> </div> +<div class="line"><a name="l01705"></a><span class="lineno"> 1705</span> <span class="comment">// Helper function to test if a field is present, using any of the field</span></div> +<div class="line"><a name="l01706"></a><span class="lineno"> 1706</span> <span class="comment">// enums in the generated code.</span></div> +<div class="line"><a name="l01707"></a><span class="lineno"> 1707</span> <span class="comment">// `table` must be a generated table type. Since this is a template parameter,</span></div> +<div class="line"><a name="l01708"></a><span class="lineno"> 1708</span> <span class="comment">// this is not typechecked to be a subclass of Table, so beware!</span></div> +<div class="line"><a name="l01709"></a><span class="lineno"> 1709</span> <span class="comment">// Note: this function will return false for fields equal to the default</span></div> +<div class="line"><a name="l01710"></a><span class="lineno"> 1710</span> <span class="comment">// value, since they're not stored in the buffer (unless force_defaults was</span></div> +<div class="line"><a name="l01711"></a><span class="lineno"> 1711</span> <span class="comment">// used).</span></div> +<div class="line"><a name="l01712"></a><span class="lineno"> 1712</span> <span class="keyword">template</span><<span class="keyword">typename</span> T> <span class="keywordtype">bool</span> IsFieldPresent(<span class="keyword">const</span> T *table, voffset_t field) {</div> +<div class="line"><a name="l01713"></a><span class="lineno"> 1713</span>  <span class="comment">// Cast, since Table is a private baseclass of any table types.</span></div> +<div class="line"><a name="l01714"></a><span class="lineno"> 1714</span>  <span class="keywordflow">return</span> <span class="keyword">reinterpret_cast<</span><span class="keyword">const </span>Table *<span class="keyword">></span>(table)->CheckField(field);</div> +<div class="line"><a name="l01715"></a><span class="lineno"> 1715</span> }</div> +<div class="line"><a name="l01716"></a><span class="lineno"> 1716</span> </div> +<div class="line"><a name="l01717"></a><span class="lineno"> 1717</span> <span class="comment">// Utility function for reverse lookups on the EnumNames*() functions</span></div> +<div class="line"><a name="l01718"></a><span class="lineno"> 1718</span> <span class="comment">// (in the generated C++ code)</span></div> +<div class="line"><a name="l01719"></a><span class="lineno"> 1719</span> <span class="comment">// names must be NULL terminated.</span></div> +<div class="line"><a name="l01720"></a><span class="lineno"> 1720</span> <span class="keyword">inline</span> <span class="keywordtype">int</span> LookupEnum(<span class="keyword">const</span> <span class="keywordtype">char</span> **names, <span class="keyword">const</span> <span class="keywordtype">char</span> *name) {</div> +<div class="line"><a name="l01721"></a><span class="lineno"> 1721</span>  <span class="keywordflow">for</span> (<span class="keyword">const</span> <span class="keywordtype">char</span> **p = names; *p; p++)</div> +<div class="line"><a name="l01722"></a><span class="lineno"> 1722</span>  <span class="keywordflow">if</span> (!strcmp(*p, name))</div> +<div class="line"><a name="l01723"></a><span class="lineno"> 1723</span>  <span class="keywordflow">return</span> <span class="keyword">static_cast<</span><span class="keywordtype">int</span><span class="keyword">></span>(p - names);</div> +<div class="line"><a name="l01724"></a><span class="lineno"> 1724</span>  <span class="keywordflow">return</span> -1;</div> +<div class="line"><a name="l01725"></a><span class="lineno"> 1725</span> }</div> +<div class="line"><a name="l01726"></a><span class="lineno"> 1726</span> </div> +<div class="line"><a name="l01727"></a><span class="lineno"> 1727</span> <span class="comment">// These macros allow us to layout a struct with a guarantee that they'll end</span></div> +<div class="line"><a name="l01728"></a><span class="lineno"> 1728</span> <span class="comment">// up looking the same on different compilers and platforms.</span></div> +<div class="line"><a name="l01729"></a><span class="lineno"> 1729</span> <span class="comment">// It does this by disallowing the compiler to do any padding, and then</span></div> +<div class="line"><a name="l01730"></a><span class="lineno"> 1730</span> <span class="comment">// does padding itself by inserting extra padding fields that make every</span></div> +<div class="line"><a name="l01731"></a><span class="lineno"> 1731</span> <span class="comment">// element aligned to its own size.</span></div> +<div class="line"><a name="l01732"></a><span class="lineno"> 1732</span> <span class="comment">// Additionally, it manually sets the alignment of the struct as a whole,</span></div> +<div class="line"><a name="l01733"></a><span class="lineno"> 1733</span> <span class="comment">// which is typically its largest element, or a custom size set in the schema</span></div> +<div class="line"><a name="l01734"></a><span class="lineno"> 1734</span> <span class="comment">// by the force_align attribute.</span></div> +<div class="line"><a name="l01735"></a><span class="lineno"> 1735</span> <span class="comment">// These are used in the generated code only.</span></div> +<div class="line"><a name="l01736"></a><span class="lineno"> 1736</span> </div> +<div class="line"><a name="l01737"></a><span class="lineno"> 1737</span> <span class="preprocessor">#if defined(_MSC_VER)</span></div> +<div class="line"><a name="l01738"></a><span class="lineno"> 1738</span> <span class="preprocessor"> #define MANUALLY_ALIGNED_STRUCT(alignment) \</span></div> +<div class="line"><a name="l01739"></a><span class="lineno"> 1739</span> <span class="preprocessor"> __pragma(pack(1)); \</span></div> +<div class="line"><a name="l01740"></a><span class="lineno"> 1740</span> <span class="preprocessor"> struct __declspec(align(alignment))</span></div> +<div class="line"><a name="l01741"></a><span class="lineno"> 1741</span> <span class="preprocessor"> #define STRUCT_END(name, size) \</span></div> +<div class="line"><a name="l01742"></a><span class="lineno"> 1742</span> <span class="preprocessor"> __pragma(pack()); \</span></div> +<div class="line"><a name="l01743"></a><span class="lineno"> 1743</span> <span class="preprocessor"> static_assert(sizeof(name) == size, "compiler breaks packing rules")</span></div> +<div class="line"><a name="l01744"></a><span class="lineno"> 1744</span> <span class="preprocessor">#elif defined(__GNUC__) || defined(__clang__)</span></div> +<div class="line"><a name="l01745"></a><span class="lineno"> 1745</span> <span class="preprocessor"> #define MANUALLY_ALIGNED_STRUCT(alignment) \</span></div> +<div class="line"><a name="l01746"></a><span class="lineno"> 1746</span> <span class="preprocessor"> _Pragma("pack(1)") \</span></div> +<div class="line"><a name="l01747"></a><span class="lineno"> 1747</span> <span class="preprocessor"> struct __attribute__((aligned(alignment)))</span></div> +<div class="line"><a name="l01748"></a><span class="lineno"> 1748</span> <span class="preprocessor"> #define STRUCT_END(name, size) \</span></div> +<div class="line"><a name="l01749"></a><span class="lineno"> 1749</span> <span class="preprocessor"> _Pragma("pack()") \</span></div> +<div class="line"><a name="l01750"></a><span class="lineno"> 1750</span> <span class="preprocessor"> static_assert(sizeof(name) == size, "compiler breaks packing rules")</span></div> +<div class="line"><a name="l01751"></a><span class="lineno"> 1751</span> <span class="preprocessor">#else</span></div> +<div class="line"><a name="l01752"></a><span class="lineno"> 1752</span> <span class="preprocessor"> #error Unknown compiler, please define structure alignment macros</span></div> +<div class="line"><a name="l01753"></a><span class="lineno"> 1753</span> <span class="preprocessor">#endif</span></div> +<div class="line"><a name="l01754"></a><span class="lineno"> 1754</span> </div> +<div class="line"><a name="l01755"></a><span class="lineno"> 1755</span> <span class="comment">// String which identifies the current version of FlatBuffers.</span></div> +<div class="line"><a name="l01756"></a><span class="lineno"> 1756</span> <span class="comment">// flatbuffer_version_string is used by Google developers to identify which</span></div> +<div class="line"><a name="l01757"></a><span class="lineno"> 1757</span> <span class="comment">// applications uploaded to Google Play are using this library. This allows</span></div> +<div class="line"><a name="l01758"></a><span class="lineno"> 1758</span> <span class="comment">// the development team at Google to determine the popularity of the library.</span></div> +<div class="line"><a name="l01759"></a><span class="lineno"> 1759</span> <span class="comment">// How it works: Applications that are uploaded to the Google Play Store are</span></div> +<div class="line"><a name="l01760"></a><span class="lineno"> 1760</span> <span class="comment">// scanned for this version string. We track which applications are using it</span></div> +<div class="line"><a name="l01761"></a><span class="lineno"> 1761</span> <span class="comment">// to measure popularity. You are free to remove it (of course) but we would</span></div> +<div class="line"><a name="l01762"></a><span class="lineno"> 1762</span> <span class="comment">// appreciate if you left it in.</span></div> +<div class="line"><a name="l01763"></a><span class="lineno"> 1763</span> </div> +<div class="line"><a name="l01764"></a><span class="lineno"> 1764</span> <span class="comment">// Weak linkage is culled by VS & doesn't work on cygwin.</span></div> +<div class="line"><a name="l01765"></a><span class="lineno"> 1765</span> <span class="preprocessor">#if !defined(_WIN32) && !defined(__CYGWIN__)</span></div> +<div class="line"><a name="l01766"></a><span class="lineno"> 1766</span> </div> +<div class="line"><a name="l01767"></a><span class="lineno"> 1767</span> <span class="keyword">extern</span> <span class="keyword">volatile</span> __attribute__((weak)) const <span class="keywordtype">char</span> *flatbuffer_version_string;</div> +<div class="line"><a name="l01768"></a><span class="lineno"> 1768</span> volatile __attribute__((weak)) const <span class="keywordtype">char</span> *flatbuffer_version_string =</div> +<div class="line"><a name="l01769"></a><span class="lineno"> 1769</span>  "FlatBuffers "</div> +<div class="line"><a name="l01770"></a><span class="lineno"> 1770</span>  FLATBUFFERS_STRING(FLATBUFFERS_VERSION_MAJOR) "."</div> +<div class="line"><a name="l01771"></a><span class="lineno"> 1771</span>  FLATBUFFERS_STRING(FLATBUFFERS_VERSION_MINOR) "."</div> +<div class="line"><a name="l01772"></a><span class="lineno"> 1772</span>  FLATBUFFERS_STRING(FLATBUFFERS_VERSION_REVISION);</div> +<div class="line"><a name="l01773"></a><span class="lineno"> 1773</span> </div> +<div class="line"><a name="l01774"></a><span class="lineno"> 1774</span> <span class="preprocessor">#endif // !defined(_WIN32) && !defined(__CYGWIN__)</span></div> +<div class="line"><a name="l01775"></a><span class="lineno"> 1775</span> </div> +<div class="line"><a name="l01776"></a><span class="lineno"> 1776</span> <span class="preprocessor">#define DEFINE_BITMASK_OPERATORS(E, T)\</span></div> +<div class="line"><a name="l01777"></a><span class="lineno"> 1777</span> <span class="preprocessor"> inline E operator | (E lhs, E rhs){\</span></div> +<div class="line"><a name="l01778"></a><span class="lineno"> 1778</span> <span class="preprocessor"> return E(T(lhs) | T(rhs));\</span></div> +<div class="line"><a name="l01779"></a><span class="lineno"> 1779</span> <span class="preprocessor"> }\</span></div> +<div class="line"><a name="l01780"></a><span class="lineno"> 1780</span> <span class="preprocessor"> inline E operator & (E lhs, E rhs){\</span></div> +<div class="line"><a name="l01781"></a><span class="lineno"> 1781</span> <span class="preprocessor"> return E(T(lhs) & T(rhs));\</span></div> +<div class="line"><a name="l01782"></a><span class="lineno"> 1782</span> <span class="preprocessor"> }\</span></div> +<div class="line"><a name="l01783"></a><span class="lineno"> 1783</span> <span class="preprocessor"> inline E operator ^ (E lhs, E rhs){\</span></div> +<div class="line"><a name="l01784"></a><span class="lineno"> 1784</span> <span class="preprocessor"> return E(T(lhs) ^ T(rhs));\</span></div> +<div class="line"><a name="l01785"></a><span class="lineno"> 1785</span> <span class="preprocessor"> }\</span></div> +<div class="line"><a name="l01786"></a><span class="lineno"> 1786</span> <span class="preprocessor"> inline E operator ~ (E lhs){\</span></div> +<div class="line"><a name="l01787"></a><span class="lineno"> 1787</span> <span class="preprocessor"> return E(~T(lhs));\</span></div> +<div class="line"><a name="l01788"></a><span class="lineno"> 1788</span> <span class="preprocessor"> }\</span></div> +<div class="line"><a name="l01789"></a><span class="lineno"> 1789</span> <span class="preprocessor"> inline E operator |= (E &lhs, E rhs){\</span></div> +<div class="line"><a name="l01790"></a><span class="lineno"> 1790</span> <span class="preprocessor"> lhs = lhs | rhs;\</span></div> +<div class="line"><a name="l01791"></a><span class="lineno"> 1791</span> <span class="preprocessor"> return lhs;\</span></div> +<div class="line"><a name="l01792"></a><span class="lineno"> 1792</span> <span class="preprocessor"> }\</span></div> +<div class="line"><a name="l01793"></a><span class="lineno"> 1793</span> <span class="preprocessor"> inline E operator &= (E &lhs, E rhs){\</span></div> +<div class="line"><a name="l01794"></a><span class="lineno"> 1794</span> <span class="preprocessor"> lhs = lhs & rhs;\</span></div> +<div class="line"><a name="l01795"></a><span class="lineno"> 1795</span> <span class="preprocessor"> return lhs;\</span></div> +<div class="line"><a name="l01796"></a><span class="lineno"> 1796</span> <span class="preprocessor"> }\</span></div> +<div class="line"><a name="l01797"></a><span class="lineno"> 1797</span> <span class="preprocessor"> inline E operator ^= (E &lhs, E rhs){\</span></div> +<div class="line"><a name="l01798"></a><span class="lineno"> 1798</span> <span class="preprocessor"> lhs = lhs ^ rhs;\</span></div> +<div class="line"><a name="l01799"></a><span class="lineno"> 1799</span> <span class="preprocessor"> return lhs;\</span></div> +<div class="line"><a name="l01800"></a><span class="lineno"> 1800</span> <span class="preprocessor"> }\</span></div> +<div class="line"><a name="l01801"></a><span class="lineno"> 1801</span> <span class="preprocessor"> inline bool operator !(E rhs) \</span></div> +<div class="line"><a name="l01802"></a><span class="lineno"> 1802</span> <span class="preprocessor"> {\</span></div> +<div class="line"><a name="l01803"></a><span class="lineno"> 1803</span> <span class="preprocessor"> return !bool(T(rhs)); \</span></div> +<div class="line"><a name="l01804"></a><span class="lineno"> 1804</span> <span class="preprocessor"> }</span></div> +<div class="line"><a name="l01805"></a><span class="lineno"> 1805</span> <span class="comment">/// @endcond</span></div> +<div class="line"><a name="l01806"></a><span class="lineno"> 1806</span> <span class="comment"></span>} <span class="comment">// namespace flatbuffers</span></div> +<div class="line"><a name="l01807"></a><span class="lineno"> 1807</span> </div> +<div class="line"><a name="l01808"></a><span class="lineno"> 1808</span> <span class="preprocessor">#endif // FLATBUFFERS_H_</span></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a1080c9e370e2d9d9d872dadd1131436b"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a1080c9e370e2d9d9d872dadd1131436b">flatbuffers::FlatBufferBuilder::CreateVector</a></div><div class="ttdeci">Offset< Vector< T > > CreateVector(size_t vector_size, const std::function< T(size_t i)> &f)</div><div class="ttdoc">Serialize values returned by a function into a FlatBuffer vector. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1074</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_ac2b96292fa0fb1534fe7fd218a094d0c"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#ac2b96292fa0fb1534fe7fd218a094d0c">flatbuffers::FlatBufferBuilder::CreateUninitializedVector</a></div><div class="ttdeci">uoffset_t CreateUninitializedVector(size_t len, size_t elemsize, uint8_t **buf)</div><div class="ttdoc">Specialized version of CreateVector for non-copying use cases. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1169</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_ac64d11c219559ea51567eab556e13135"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#ac64d11c219559ea51567eab556e13135">flatbuffers::FlatBufferBuilder::CreateVectorOfSortedTables</a></div><div class="ttdeci">Offset< Vector< Offset< T > > > CreateVectorOfSortedTables(std::vector< Offset< T >> *v)</div><div class="ttdoc">Serialize an array of table offsets as a vector in the buffer in sorted order. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1157</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html">flatbuffers::FlatBufferBuilder</a></div><div class="ttdoc">Helper class to hold data needed in creation of a FlatBuffer. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:630</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_ac1bfd609f7f736e9a37cedae77448b63"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#ac1bfd609f7f736e9a37cedae77448b63">flatbuffers::FlatBufferBuilder::GetSize</a></div><div class="ttdeci">uoffset_t GetSize() const </div><div class="ttdoc">The current size of the serialized buffer, counting from the end. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:670</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_ac72b54a75e0c329e0ce0b8fab758e256"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#ac72b54a75e0c329e0ce0b8fab758e256">flatbuffers::FlatBufferBuilder::FlatBufferBuilder</a></div><div class="ttdeci">FlatBufferBuilder(uoffset_t initial_size=1024, const simple_allocator *allocator=nullptr)</div><div class="ttdoc">Default constructor for FlatBufferBuilder. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:642</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_ae94b94ba71ea0aeb2d9a98c43b713412"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#ae94b94ba71ea0aeb2d9a98c43b713412">flatbuffers::FlatBufferBuilder::Clear</a></div><div class="ttdeci">void Clear()</div><div class="ttdoc">Reset all the state in this FlatBufferBuilder so it can be reused to construct another buffer...</div><div class="ttdef"><b>Definition:</b> flatbuffers.h:658</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a21c7f933d7ff1212f2090763ef9f0c44"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a21c7f933d7ff1212f2090763ef9f0c44">flatbuffers::FlatBufferBuilder::ReleaseBufferPointer</a></div><div class="ttdeci">unique_ptr_t ReleaseBufferPointer()</div><div class="ttdoc">Get the released pointer to the serialized buffer. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:691</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a7ba8462e408431054c99d25120326220"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a7ba8462e408431054c99d25120326220">flatbuffers::FlatBufferBuilder::FinishSizePrefixed</a></div><div class="ttdeci">void FinishSizePrefixed(Offset< T > root, const char *file_identifier=nullptr)</div><div class="ttdoc">Finish a buffer with a 32 bit size field pre-fixed (size of the buffer following the size field)...</div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1213</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a3eb68613e5883dc4b8fff6cf7d1223d7"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a3eb68613e5883dc4b8fff6cf7d1223d7">flatbuffers::FlatBufferBuilder::CreateSharedString</a></div><div class="ttdeci">Offset< String > CreateSharedString(const char *str)</div><div class="ttdoc">Store a string in the buffer, which null-terminated. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:980</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_aec6f9df2a0366b540b24822414d92cbe"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#aec6f9df2a0366b540b24822414d92cbe">flatbuffers::FlatBufferBuilder::CreateString</a></div><div class="ttdeci">Offset< String > CreateString(const char *str, size_t len)</div><div class="ttdoc">Store a string in the buffer, which can contain any binary data. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:920</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a16a8fd46b34ad7727406c37b65b6b27a"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a16a8fd46b34ad7727406c37b65b6b27a">flatbuffers::FlatBufferBuilder::ForceDefaults</a></div><div class="ttdeci">void ForceDefaults(bool fd)</div><div class="ttdoc">In order to save space, fields that are set to their default value don't get serialized into the buff...</div><div class="ttdef"><b>Definition:</b> flatbuffers.h:721</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_af8c7583c92e1d1d6f438977da5158d19"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#af8c7583c92e1d1d6f438977da5158d19">flatbuffers::FlatBufferBuilder::kFileIdentifierLength</a></div><div class="ttdeci">static const size_t kFileIdentifierLength</div><div class="ttdoc">The length of a FlatBuffer file header. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1195</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_ac0b6a1c5d949f20ad84367fc0f9e1506"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#ac0b6a1c5d949f20ad84367fc0f9e1506">flatbuffers::FlatBufferBuilder::CreateString</a></div><div class="ttdeci">Offset< String > CreateString(const String *str)</div><div class="ttdoc">Store a string in the buffer, which can contain any binary data. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:946</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a840b769fbb4148f97d3eed266e4690c3"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a840b769fbb4148f97d3eed266e4690c3">flatbuffers::FlatBufferBuilder::CreateSharedString</a></div><div class="ttdeci">Offset< String > CreateSharedString(const String *str)</div><div class="ttdoc">Store a string in the buffer, which can contain any binary data. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:998</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a592110519a6c8db1926f1365bf2a58e6"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a592110519a6c8db1926f1365bf2a58e6">flatbuffers::FlatBufferBuilder::CreateVectorOfStrings</a></div><div class="ttdeci">Offset< Vector< Offset< String > > > CreateVectorOfStrings(const std::vector< std::string > &v)</div><div class="ttdoc">Serialize a std::vector<std::string> into a FlatBuffer vector. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1088</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_aa1ebce1f3f46832946a95952af1e9c2b"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#aa1ebce1f3f46832946a95952af1e9c2b">flatbuffers::FlatBufferBuilder::GetBufferMinAlignment</a></div><div class="ttdeci">size_t GetBufferMinAlignment()</div><div class="ttdoc">get the minimum alignment this buffer needs to be accessed properly. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:702</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_afede51fd9c32d146cbb1832f57c5e1b7"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#afede51fd9c32d146cbb1832f57c5e1b7">flatbuffers::FlatBufferBuilder::CreateVectorOfStructs</a></div><div class="ttdeci">Offset< Vector< const T * > > CreateVectorOfStructs(const T *v, size_t len)</div><div class="ttdoc">Serialize an array of structs into a FlatBuffer vector. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1102</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_aad93d113ac24e86ed04b5236b3f4c0c5"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#aad93d113ac24e86ed04b5236b3f4c0c5">flatbuffers::FlatBufferBuilder::CreateString</a></div><div class="ttdeci">Offset< String > CreateString(const char *str)</div><div class="ttdoc">Store a string in the buffer, which is null-terminated. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:932</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a8c3af55e64f5cda9aefa38ac5287ef9f"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a8c3af55e64f5cda9aefa38ac5287ef9f">flatbuffers::FlatBufferBuilder::CreateString</a></div><div class="ttdeci">Offset< String > CreateString(const std::string &str)</div><div class="ttdoc">Store a string in the buffer, which can contain any binary data. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:939</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_af715dd24dd37cb0151dc7a980ad0f207"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#af715dd24dd37cb0151dc7a980ad0f207">flatbuffers::FlatBufferBuilder::CreateVector</a></div><div class="ttdeci">Offset< Vector< T > > CreateVector(const std::vector< T > &v)</div><div class="ttdoc">Serialize a std::vector into a FlatBuffer vector. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1051</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a2305b63d367845972b51669dd995cc50"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a2305b63d367845972b51669dd995cc50">flatbuffers::FlatBufferBuilder::CreateUninitializedVector</a></div><div class="ttdeci">Offset< Vector< T > > CreateUninitializedVector(size_t len, T **buf)</div><div class="ttdoc">Specialized version of CreateVector for non-copying use cases. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1188</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a3f4252e9bc005ba6c700469544fdccc9"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a3f4252e9bc005ba6c700469544fdccc9">flatbuffers::FlatBufferBuilder::GetCurrentBufferPointer</a></div><div class="ttdeci">uint8_t * GetCurrentBufferPointer() const </div><div class="ttdoc">Get a pointer to an unfinished buffer. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:682</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a2cca5c89246a53e80e6ad9487f4c36f3"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a2cca5c89246a53e80e6ad9487f4c36f3">flatbuffers::FlatBufferBuilder::CreateVector</a></div><div class="ttdeci">Offset< Vector< T > > CreateVector(const T *v, size_t len)</div><div class="ttdoc">Serialize an array into a FlatBuffer vector. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1037</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a10e8ec7d1c8fbdc21b1c7047bbbe38d9"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a10e8ec7d1c8fbdc21b1c7047bbbe38d9">flatbuffers::FlatBufferBuilder::CreateSharedString</a></div><div class="ttdeci">Offset< String > CreateSharedString(const std::string &str)</div><div class="ttdoc">Store a string in the buffer, which can contain any binary data. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:989</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a2130ef232ff405eebe2e7f184ecd06e6"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a2130ef232ff405eebe2e7f184ecd06e6">flatbuffers::FlatBufferBuilder::CreateVectorOfSortedTables</a></div><div class="ttdeci">Offset< Vector< Offset< T > > > CreateVectorOfSortedTables(Offset< T > *v, size_t len)</div><div class="ttdoc">Serialize an array of table offsets as a vector in the buffer in sorted order. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1144</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_ab478a645216d2d613fc7b7c29b0ff9d1"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#ab478a645216d2d613fc7b7c29b0ff9d1">flatbuffers::FlatBufferBuilder::CreateSharedString</a></div><div class="ttdeci">Offset< String > CreateSharedString(const char *str, size_t len)</div><div class="ttdoc">Store a string in the buffer, which can contain any binary data. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:956</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a8704709a2e25ad04679212ee4126b1a1"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a8704709a2e25ad04679212ee4126b1a1">flatbuffers::FlatBufferBuilder::CreateVectorOfStructs</a></div><div class="ttdeci">Offset< Vector< const T * > > CreateVectorOfStructs(const std::vector< T > &v)</div><div class="ttdoc">Serialize a std::vector of structs into a FlatBuffer vector. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1115</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a0c9e507b373d598b51052fab4fa34912"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a0c9e507b373d598b51052fab4fa34912">flatbuffers::FlatBufferBuilder::Finish</a></div><div class="ttdeci">void Finish(Offset< T > root, const char *file_identifier=nullptr)</div><div class="ttdoc">Finish serializing a buffer by writing the root offset. </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:1200</div></div> +<div class="ttc" id="classflatbuffers_1_1_flat_buffer_builder_html_a8dc35f792179df4ca850492c1796d8b8"><div class="ttname"><a href="classflatbuffers_1_1_flat_buffer_builder.html#a8dc35f792179df4ca850492c1796d8b8">flatbuffers::FlatBufferBuilder::GetBufferPointer</a></div><div class="ttdeci">uint8_t * GetBufferPointer() const </div><div class="ttdoc">Get the serialized buffer (after you call Finish()). </div><div class="ttdef"><b>Definition:</b> flatbuffers.h:675</div></div> </div><!-- fragment --></div><!-- contents --> </div><!-- doc-content --> <!-- Google Analytics --> diff --git a/flatbuffers_guide_writing_schema.html b/flatbuffers_guide_writing_schema.html index cec93dddbddba577ae376d2206928ad6574f14d8..0c10543397e2330306e70eedc0a991117a8112ee 100644 --- a/flatbuffers_guide_writing_schema.html +++ b/flatbuffers_guide_writing_schema.html @@ -211,12 +211,12 @@ root_type Monster; <li><code>id: n</code> (on a table field): manually set the field identifier to <code>n</code>. If you use this attribute, you must use it on ALL fields of this table, and the numbers must be a contiguous range from 0 onwards. Additionally, since a union type effectively adds two fields, its id must be that of the second field (the first field is the type field and not explicitly declared in the schema). For example, if the last field before the union field had id 6, the union field should have id 8, and the unions type field will implicitly be 7. IDs allow the fields to be placed in any order in the schema. When a new field is added to the schema it must use the next available ID.</li> <li><code>deprecated</code> (on a field): do not generate accessors for this field anymore, code should stop using this data.</li> <li><code>required</code> (on a non-scalar table field): this field must always be set. By default, all fields are optional, i.e. may be left out. This is desirable, as it helps with forwards/backwards compatibility, and flexibility of data structures. It is also a burden on the reading code, since for non-scalar fields it requires you to check against NULL and take appropriate action. By specifying this field, you force code that constructs FlatBuffers to ensure this field is initialized, so the reading code may access it directly, without checking for NULL. If the constructing code does not initialize this field, they will get an assert, and also the verifier will fail on buffers that have missing required fields.</li> -<li><code>original_order</code> (on a table): since elements in a table do not need to be stored in any particular order, they are often optimized for space by sorting them to size. This attribute stops that from happening.</li> <li><code>force_align: size</code> (on a struct): force the alignment of this struct to be something higher than what it is naturally aligned to. Causes these structs to be aligned to that amount inside a buffer, IF that buffer is allocated with that alignment (which is not necessarily the case for buffers accessed directly inside a <code>FlatBufferBuilder</code>).</li> <li><code>bit_flags</code> (on an enum): the values of this field indicate bits, meaning that any value N specified in the schema will end up representing 1<<N, or if you don't specify values at all, you'll get the sequence 1, 2, 4, 8, ...</li> <li><code>nested_flatbuffer: "table_name"</code> (on a field): this indicates that the field (which must be a vector of ubyte) contains flatbuffer data, for which the root type is given by <code>table_name</code>. The generated code will then produce a convenient accessor for the nested FlatBuffer.</li> <li><code>key</code> (on a field): this field is meant to be used as a key when sorting a vector of the type of table it sits in. Can be used for in-place binary search.</li> <li><code>hash</code> (on a field). This is an (un)signed 32/64 bit integer field, whose value during JSON parsing is allowed to be a string, which will then be stored as its hash. The value of attribute is the hashing algorithm to use, one of <code>fnv1_32</code> <code>fnv1_64</code> <code>fnv1a_32</code> <code>fnv1a_64</code>.</li> +<li><code>original_order</code> (on a table): since elements in a table do not need to be stored in any particular order, they are often optimized for space by sorting them to size. This attribute stops that from happening. There should generally not be any reason to use this flag.</li> </ul> <h2>JSON Parsing</h2> <p>The same parser that parses the schema declarations above is also able to parse JSON objects that conform to this schema. So, unlike other JSON parsers, this parser is strongly typed, and parses directly into a FlatBuffer (see the compiler documentation on how to do this from the command line, or the C++ documentation on how to do this at runtime).</p> @@ -242,6 +242,30 @@ root_type Monster; <li><code>\xXX</code> - 8-bit binary hexadecimal number XX. This is the only one that is not in the JSON spec (see <a href="http://json.org/">http://json.org/</a>), but is needed to be able to encode arbitrary binary in strings to text and back without losing information (e.g. the byte 0xFF can't be represented in standard JSON).</li> </ul> <p>It also generates these escape codes back again when generating JSON from a binary representation.</p> +<h2>Guidelines</h2> +<h3>Efficiency</h3> +<p>FlatBuffers is all about efficiency, but to realize that efficiency you require an efficient schema. There are usually multiple choices on how to represent data that have vastly different size characteristics.</p> +<p>It is very common nowadays to represent any kind of data as dictionaries (as in e.g. JSON), because of its flexibility and extensibility. While it is possible to emulate this in FlatBuffers (as a vector of tables with key and value(s)), this is a bad match for a strongly typed system like FlatBuffers, leading to relatively large binaries. FlatBuffer tables are more flexible than classes/structs in most systems, since having a large number of fields only few of which are actually used is still efficient. You should thus try to organize your data as much as possible such that you can use tables where you might be tempted to use a dictionary.</p> +<p>Similarly, strings as values should only be used when they are truely open-ended. If you can, always use an enum instead.</p> +<p>FlatBuffers doesn't have inheritance, so the way to represent a set of related data structures is a union. Unions do have a cost however, so an alternative to a union is to have a single table that has all the fields of all the data structures you are trying to represent, if they are relatively similar / share many fields. Again, this is efficient because optional fields are cheap.</p> +<p>FlatBuffers supports the full range of integer sizes, so try to pick the smallest size needed, rather than defaulting to int/long.</p> +<p>Remember that you can share data (refer to the same string/table within a buffer), so factoring out repeating data into its own data structure may be worth it.</p> +<h3>Style guide</h3> +<p>Identifiers in a schema are meant to translate to many different programming languages, so using the style of your "main" language is generally a bad idea.</p> +<p>For this reason, below is a suggested style guide to adhere to, to keep schemas consistent for interoperation regardless of the target language.</p> +<p>Where possible, the code generators for specific languages will generate identifiers that adhere to the language style, based on the schema identifiers.</p> +<ul> +<li>Table, struct, enum and rpc names (types): UpperCamelCase.</li> +<li>Table and struct field names: snake_case. This is translated to lowerCamelCase automatically for some languages, e.g. Java.</li> +<li>Enum values: UpperCamelCase.</li> +<li>namespaces: UpperCamelCase.</li> +</ul> +<p>Formatting (this is less important, but still worth adhering to):</p> +<ul> +<li>Opening brace: on the same line as the start of the declaration.</li> +<li>Spacing: Indent by 2 spaces. None around <code>:</code> for types, on both sides for <code>=</code>.</li> +</ul> +<p>For an example, see the schema at the top of this file.</p> <h2>Gotchas</h2> <h3>Schemas and version control</h3> <p>FlatBuffers relies on new field declarations being added at the end, and earlier declarations to not be removed, but be marked deprecated when needed. We think this is an improvement over the manual number assignment that happens in Protocol Buffers (and which is still an option using the <code>id</code> attribute mentioned above).</p>