mirror of
https://github.com/google/flatbuffers.git
synced 2026-06-02 20:15:34 +00:00
28a3c939e7
Currently in order to get a value type of [ubyte] in PHP, iteration is necessary which is not efficient. Helper __vector_as_bytes has been implemented in order to return the byte arrays in PHP efficiently. Appropriate methods also been added to use aforementioned method to return the byte array. (e.g. get*Bytes()). The reason the methods are named get*Bytes() and not for instance get*ByteArray() is the fact that PHP doesn't support byte arrays and the binary safe string implementation in PHP is used to simulate byte arrays and since there is chance for PHP users to confuse this with PHP arrays the name get*Bytes() has been chosen. In the future __vector_as_bytebuffer() method can also be implemented to return PHP implementation of ByteBuffer.
136 lines
3.4 KiB
PHP
136 lines
3.4 KiB
PHP
<?php
|
|
/*
|
|
* Copyright 2015 Google Inc.
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
namespace Google\FlatBuffers;
|
|
|
|
abstract class Table
|
|
{
|
|
/**
|
|
* @var int $bb_pos
|
|
*/
|
|
protected $bb_pos;
|
|
/**
|
|
* @var ByteBuffer $bb
|
|
*/
|
|
protected $bb;
|
|
|
|
public function __construct()
|
|
{
|
|
}
|
|
|
|
/**
|
|
* returns actual vtable offset
|
|
*
|
|
* @param $vtable_offset
|
|
* @return int offset > 0 means exist value. 0 means not exist
|
|
*/
|
|
protected function __offset($vtable_offset)
|
|
{
|
|
$vtable = $this->bb_pos - $this->bb->getInt($this->bb_pos);
|
|
return $vtable_offset < $this->bb->getShort($vtable) ? $this->bb->getShort($vtable + $vtable_offset) : 0;
|
|
}
|
|
|
|
/**
|
|
* @param $offset
|
|
* @return mixed
|
|
*/
|
|
protected function __indirect($offset)
|
|
{
|
|
return $offset + $this->bb->getInt($offset);
|
|
}
|
|
|
|
/**
|
|
* fetch utf8 encoded string.
|
|
*
|
|
* @param $offset
|
|
* @return string
|
|
*/
|
|
protected function __string($offset)
|
|
{
|
|
$offset += $this->bb->getInt($offset);
|
|
$len = $this->bb->getInt($offset);
|
|
$startPos = $offset + Constants::SIZEOF_INT;
|
|
return substr($this->bb->_buffer, $startPos, $len);
|
|
}
|
|
|
|
/**
|
|
* @param $offset
|
|
* @return int
|
|
*/
|
|
protected function __vector_len($offset)
|
|
{
|
|
$offset += $this->bb_pos;
|
|
$offset += $this->bb->getInt($offset);
|
|
return $this->bb->getInt($offset);
|
|
}
|
|
|
|
/**
|
|
* @param $offset
|
|
* @return int
|
|
*/
|
|
protected function __vector($offset)
|
|
{
|
|
$offset += $this->bb_pos;
|
|
// data starts after the length
|
|
return $offset + $this->bb->getInt($offset) + Constants::SIZEOF_INT;
|
|
}
|
|
|
|
protected function __vector_as_bytes($vector_offset, $elem_size=1)
|
|
{
|
|
$o = $this->__offset($vector_offset);
|
|
if ($o == 0) {
|
|
return null;
|
|
}
|
|
|
|
return substr($this->bb->_buffer, $this->__vector($o), $this->__vector_len($o) * $elem_size);
|
|
}
|
|
|
|
/**
|
|
* @param Table $table
|
|
* @param int $offset
|
|
* @return Table
|
|
*/
|
|
protected function __union($table, $offset)
|
|
{
|
|
$offset += $this->bb_pos;
|
|
$table->bb_pos = $offset + $this->bb->getInt($offset);
|
|
$table->bb = $this->bb;
|
|
return $table;
|
|
}
|
|
|
|
/**
|
|
* @param ByteBuffer $bb
|
|
* @param string $ident
|
|
* @return bool
|
|
* @throws \ArgumentException
|
|
*/
|
|
protected static function __has_identifier($bb, $ident)
|
|
{
|
|
if (strlen($ident) != Constants::FILE_IDENTIFIER_LENGTH) {
|
|
throw new \ArgumentException("FlatBuffers: file identifier must be length " . Constants::FILE_IDENTIFIER_LENGTH);
|
|
}
|
|
|
|
for ($i = 0; $i < 4; $i++) {
|
|
if ($ident[$i] != $bb->get($bb->getPosition() + Constants::SIZEOF_INT + $i)) {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
return true;
|
|
}
|
|
}
|