/// @file /// @addtogroup flatbuffers_javascript_api /// @{ /// @cond FLATBUFFERS_INTERNAL /** * @const * @namespace */ var flatbuffers = {}; /** * @typedef {number} */ flatbuffers.Offset; /** * @typedef {{ * bb: flatbuffers.ByteBuffer, * bb_pos: number * }} */ flatbuffers.Table; /** * @type {number} * @const */ flatbuffers.SIZEOF_SHORT = 2; /** * @type {number} * @const */ flatbuffers.SIZEOF_INT = 4; /** * @type {number} * @const */ flatbuffers.FILE_IDENTIFIER_LENGTH = 4; /** * @enum {number} */ flatbuffers.Encoding = { UTF8_BYTES: 1, UTF16_STRING: 2 }; /** * @type {Int32Array} * @const */ flatbuffers.int32 = new Int32Array(2); /** * @type {Float32Array} * @const */ flatbuffers.float32 = new Float32Array(flatbuffers.int32.buffer); /** * @type {Float64Array} * @const */ flatbuffers.float64 = new Float64Array(flatbuffers.int32.buffer); /** * @type {boolean} * @const */ flatbuffers.isLittleEndian = new Uint16Array(new Uint8Array([1, 0]).buffer)[0] === 1; //////////////////////////////////////////////////////////////////////////////// /** * @constructor * @param {number} high * @param {number} low */ flatbuffers.Long = function(low, high) { /** * @type {number} * @const */ this.low = low | 0; /** * @type {number} * @const */ this.high = high | 0; }; /** * @param {number} high * @param {number} low * @returns {flatbuffers.Long} */ flatbuffers.Long.create = function(low, high) { // Special-case zero to avoid GC overhead for default values return low == 0 && high == 0 ? flatbuffers.Long.ZERO : new flatbuffers.Long(low, high); }; /** * @returns {number} */ flatbuffers.Long.prototype.toFloat64 = function() { return this.low + this.high * 0x100000000; }; /** * @param {flatbuffers.Long} other * @returns {boolean} */ flatbuffers.Long.prototype.equals = function(other) { return this.low == other.low && this.high == other.high; }; /** * @type {flatbuffers.Long} * @const */ flatbuffers.Long.ZERO = new flatbuffers.Long(0, 0); /// @endcond //////////////////////////////////////////////////////////////////////////////// /** * Create a FlatBufferBuilder. * * @constructor * @param {number=} initial_size */ flatbuffers.Builder = function(initial_size) { if (!initial_size) { initial_size = 1024; } /** * @type {flatbuffers.ByteBuffer} * @private */ this.bb = flatbuffers.ByteBuffer.allocate(initial_size); /** * Remaining space in the ByteBuffer. * * @type {number} * @private */ this.space = initial_size; /** * Minimum alignment encountered so far. * * @type {number} * @private */ this.minalign = 1; /** * The vtable for the current table. * * @type {Array.} * @private */ this.vtable = null; /** * The amount of fields we're actually using. * * @type {number} * @private */ this.vtable_in_use = 0; /** * Whether we are currently serializing a table. * * @type {boolean} * @private */ this.isNested = false; /** * Starting offset of the current struct/table. * * @type {number} * @private */ this.object_start = 0; /** * List of offsets of all vtables. * * @type {Array.} * @private */ this.vtables = []; /** * For the current vector being built. * * @type {number} * @private */ this.vector_num_elems = 0; /** * False omits default values from the serialized data * * @type {boolean} * @private */ this.force_defaults = false; }; /** * In order to save space, fields that are set to their default value * don't get serialized into the buffer. Forcing defaults provides a * way to manually disable this optimization. * * @param {boolean} forceDefaults true always serializes default values */ flatbuffers.Builder.prototype.forceDefaults = function(forceDefaults) { this.force_defaults = forceDefaults; }; /** * Get the ByteBuffer representing the FlatBuffer. Only call this after you've * called finish(). The actual data starts at the ByteBuffer's current position, * not necessarily at 0. * * @returns {flatbuffers.ByteBuffer} */ flatbuffers.Builder.prototype.dataBuffer = function() { return this.bb; }; /** * Get the bytes representing the FlatBuffer. Only call this after you've * called finish(). * * @returns {Uint8Array} */ flatbuffers.Builder.prototype.asUint8Array = function() { return this.bb.bytes().subarray(this.bb.position(), this.bb.position() + this.offset()); }; /// @cond FLATBUFFERS_INTERNAL /** * Prepare to write an element of `size` after `additional_bytes` have been * written, e.g. if you write a string, you need to align such the int length * field is aligned to 4 bytes, and the string data follows it directly. If all * you need to do is alignment, `additional_bytes` will be 0. * * @param {number} size This is the of the new element to write * @param {number} additional_bytes The padding size */ flatbuffers.Builder.prototype.prep = function(size, additional_bytes) { // Track the biggest thing we've ever aligned to. if (size > this.minalign) { this.minalign = size; } // Find the amount of alignment needed such that `size` is properly // aligned after `additional_bytes` var align_size = ((~(this.bb.capacity() - this.space + additional_bytes)) + 1) & (size - 1); // Reallocate the buffer if needed. while (this.space < align_size + size + additional_bytes) { var old_buf_size = this.bb.capacity(); this.bb = flatbuffers.Builder.growByteBuffer(this.bb); this.space += this.bb.capacity() - old_buf_size; } this.pad(align_size); }; /** * @param {number} byte_size */ flatbuffers.Builder.prototype.pad = function(byte_size) { for (var i = 0; i < byte_size; i++) { this.bb.writeInt8(--this.space, 0); } }; /** * @param {number} value */ flatbuffers.Builder.prototype.writeInt8 = function(value) { this.bb.writeInt8(this.space -= 1, value); }; /** * @param {number} value */ flatbuffers.Builder.prototype.writeInt16 = function(value) { this.bb.writeInt16(this.space -= 2, value); }; /** * @param {number} value */ flatbuffers.Builder.prototype.writeInt32 = function(value) { this.bb.writeInt32(this.space -= 4, value); }; /** * @param {flatbuffers.Long} value */ flatbuffers.Builder.prototype.writeInt64 = function(value) { this.bb.writeInt64(this.space -= 8, value); }; /** * @param {number} value */ flatbuffers.Builder.prototype.writeFloat32 = function(value) { this.bb.writeFloat32(this.space -= 4, value); }; /** * @param {number} value */ flatbuffers.Builder.prototype.writeFloat64 = function(value) { this.bb.writeFloat64(this.space -= 8, value); }; /// @endcond /** * Add an `int8` to the buffer, properly aligned, and grows the buffer (if necessary). * @param {number} value The `int8` to add the the buffer. */ flatbuffers.Builder.prototype.addInt8 = function(value) { this.prep(1, 0); this.writeInt8(value); }; /** * Add an `int16` to the buffer, properly aligned, and grows the buffer (if necessary). * @param {number} value The `int16` to add the the buffer. */ flatbuffers.Builder.prototype.addInt16 = function(value) { this.prep(2, 0); this.writeInt16(value); }; /** * Add an `int32` to the buffer, properly aligned, and grows the buffer (if necessary). * @param {number} value The `int32` to add the the buffer. */ flatbuffers.Builder.prototype.addInt32 = function(value) { this.prep(4, 0); this.writeInt32(value); }; /** * Add an `int64` to the buffer, properly aligned, and grows the buffer (if necessary). * @param {flatbuffers.Long} value The `int64` to add the the buffer. */ flatbuffers.Builder.prototype.addInt64 = function(value) { this.prep(8, 0); this.writeInt64(value); }; /** * Add a `float32` to the buffer, properly aligned, and grows the buffer (if necessary). * @param {number} value The `float32` to add the the buffer. */ flatbuffers.Builder.prototype.addFloat32 = function(value) { this.prep(4, 0); this.writeFloat32(value); }; /** * Add a `float64` to the buffer, properly aligned, and grows the buffer (if necessary). * @param {number} value The `float64` to add the the buffer. */ flatbuffers.Builder.prototype.addFloat64 = function(value) { this.prep(8, 0); this.writeFloat64(value); }; /// @cond FLATBUFFERS_INTERNAL /** * @param {number} voffset * @param {number} value * @param {number} defaultValue */ flatbuffers.Builder.prototype.addFieldInt8 = function(voffset, value, defaultValue) { if (this.force_defaults || value != defaultValue) { this.addInt8(value); this.slot(voffset); } }; /** * @param {number} voffset * @param {number} value * @param {number} defaultValue */ flatbuffers.Builder.prototype.addFieldInt16 = function(voffset, value, defaultValue) { if (this.force_defaults || value != defaultValue) { this.addInt16(value); this.slot(voffset); } }; /** * @param {number} voffset * @param {number} value * @param {number} defaultValue */ flatbuffers.Builder.prototype.addFieldInt32 = function(voffset, value, defaultValue) { if (this.force_defaults || value != defaultValue) { this.addInt32(value); this.slot(voffset); } }; /** * @param {number} voffset * @param {flatbuffers.Long} value * @param {flatbuffers.Long} defaultValue */ flatbuffers.Builder.prototype.addFieldInt64 = function(voffset, value, defaultValue) { if (this.force_defaults || !value.equals(defaultValue)) { this.addInt64(value); this.slot(voffset); } }; /** * @param {number} voffset * @param {number} value * @param {number} defaultValue */ flatbuffers.Builder.prototype.addFieldFloat32 = function(voffset, value, defaultValue) { if (this.force_defaults || value != defaultValue) { this.addFloat32(value); this.slot(voffset); } }; /** * @param {number} voffset * @param {number} value * @param {number} defaultValue */ flatbuffers.Builder.prototype.addFieldFloat64 = function(voffset, value, defaultValue) { if (this.force_defaults || value != defaultValue) { this.addFloat64(value); this.slot(voffset); } }; /** * @param {number} voffset * @param {flatbuffers.Offset} value * @param {flatbuffers.Offset} defaultValue */ flatbuffers.Builder.prototype.addFieldOffset = function(voffset, value, defaultValue) { if (this.force_defaults || value != defaultValue) { this.addOffset(value); this.slot(voffset); } }; /** * Structs are stored inline, so nothing additional is being added. `d` is always 0. * * @param {number} voffset * @param {flatbuffers.Offset} value * @param {flatbuffers.Offset} defaultValue */ flatbuffers.Builder.prototype.addFieldStruct = function(voffset, value, defaultValue) { if (value != defaultValue) { this.nested(value); this.slot(voffset); } }; /** * Structures are always stored inline, they need to be created right * where they're used. You'll get this assertion failure if you * created it elsewhere. * * @param {flatbuffers.Offset} obj The offset of the created object */ flatbuffers.Builder.prototype.nested = function(obj) { if (obj != this.offset()) { throw new Error('FlatBuffers: struct must be serialized inline.'); } }; /** * Should not be creating any other object, string or vector * while an object is being constructed */ flatbuffers.Builder.prototype.notNested = function() { if (this.isNested) { throw new Error('FlatBuffers: object serialization must not be nested.'); } }; /** * Set the current vtable at `voffset` to the current location in the buffer. * * @param {number} voffset */ flatbuffers.Builder.prototype.slot = function(voffset) { this.vtable[voffset] = this.offset(); }; /** * @returns {flatbuffers.Offset} Offset relative to the end of the buffer. */ flatbuffers.Builder.prototype.offset = function() { return this.bb.capacity() - this.space; }; /** * Doubles the size of the backing ByteBuffer and copies the old data towards * the end of the new buffer (since we build the buffer backwards). * * @param {flatbuffers.ByteBuffer} bb The current buffer with the existing data * @returns {flatbuffers.ByteBuffer} A new byte buffer with the old data copied * to it. The data is located at the end of the buffer. */ flatbuffers.Builder.growByteBuffer = function(bb) { var old_buf_size = bb.capacity(); // Ensure we don't grow beyond what fits in an int. if (old_buf_size & 0xC0000000) { throw new Error('FlatBuffers: cannot grow buffer beyond 2 gigabytes.'); } var new_buf_size = old_buf_size << 1; var nbb = flatbuffers.ByteBuffer.allocate(new_buf_size); nbb.setPosition(new_buf_size - old_buf_size); nbb.bytes().set(bb.bytes(), new_buf_size - old_buf_size); return nbb; }; /// @endcond /** * Adds on offset, relative to where it will be written. * * @param {flatbuffers.Offset} offset The offset to add. */ flatbuffers.Builder.prototype.addOffset = function(offset) { this.prep(flatbuffers.SIZEOF_INT, 0); // Ensure alignment is already done. this.writeInt32(this.offset() - offset + flatbuffers.SIZEOF_INT); }; /// @cond FLATBUFFERS_INTERNAL /** * Start encoding a new object in the buffer. Users will not usually need to * call this directly. The FlatBuffers compiler will generate helper methods * that call this method internally. * * @param {number} numfields */ flatbuffers.Builder.prototype.startObject = function(numfields) { this.notNested(); if (this.vtable == null) { this.vtable = []; } this.vtable_in_use = numfields; for (var i = 0; i < numfields; i++) { this.vtable[i] = 0; // This will push additional elements as needed } this.isNested = true; this.object_start = this.offset(); }; /** * Finish off writing the object that is under construction. * * @returns {flatbuffers.Offset} The offset to the object inside `dataBuffer` */ flatbuffers.Builder.prototype.endObject = function() { if (this.vtable == null || !this.isNested) { throw new Error('FlatBuffers: endObject called without startObject'); } this.addInt32(0); var vtableloc = this.offset(); // Write out the current vtable. for (var i = this.vtable_in_use - 1; i >= 0; i--) { // Offset relative to the start of the table. this.addInt16(this.vtable[i] != 0 ? vtableloc - this.vtable[i] : 0); } var standard_fields = 2; // The fields below: this.addInt16(vtableloc - this.object_start); this.addInt16((this.vtable_in_use + standard_fields) * flatbuffers.SIZEOF_SHORT); // Search for an existing vtable that matches the current one. var existing_vtable = 0; outer_loop: for (var i = 0; i < this.vtables.length; i++) { var vt1 = this.bb.capacity() - this.vtables[i]; var vt2 = this.space; var len = this.bb.readInt16(vt1); if (len == this.bb.readInt16(vt2)) { for (var j = flatbuffers.SIZEOF_SHORT; j < len; j += flatbuffers.SIZEOF_SHORT) { if (this.bb.readInt16(vt1 + j) != this.bb.readInt16(vt2 + j)) { continue outer_loop; } } existing_vtable = this.vtables[i]; break; } } if (existing_vtable) { // Found a match: // Remove the current vtable. this.space = this.bb.capacity() - vtableloc; // Point table to existing vtable. this.bb.writeInt32(this.space, existing_vtable - vtableloc); } else { // No match: // Add the location of the current vtable to the list of vtables. this.vtables.push(this.offset()); // Point table to current vtable. this.bb.writeInt32(this.bb.capacity() - vtableloc, this.offset() - vtableloc); } this.isNested = false; return vtableloc; }; /// @endcond /** * Finalize a buffer, poiting to the given `root_table`. * * @param {flatbuffers.Offset} root_table * @param {string=} file_identifier */ flatbuffers.Builder.prototype.finish = function(root_table, file_identifier) { if (file_identifier) { this.prep(this.minalign, flatbuffers.SIZEOF_INT + flatbuffers.FILE_IDENTIFIER_LENGTH); if (file_identifier.length != flatbuffers.FILE_IDENTIFIER_LENGTH) { throw new Error('FlatBuffers: file identifier must be length ' + flatbuffers.FILE_IDENTIFIER_LENGTH); } for (var i = flatbuffers.FILE_IDENTIFIER_LENGTH - 1; i >= 0; i--) { this.writeInt8(file_identifier.charCodeAt(i)); } } this.prep(this.minalign, flatbuffers.SIZEOF_INT); this.addOffset(root_table); this.bb.setPosition(this.space); }; /// @cond FLATBUFFERS_INTERNAL /** * This checks a required field has been set in a given table that has * just been constructed. * * @param {flatbuffers.Offset} table * @param {number} field */ flatbuffers.Builder.prototype.requiredField = function(table, field) { var table_start = this.bb.capacity() - table; var vtable_start = table_start - this.bb.readInt32(table_start); var ok = this.bb.readInt16(vtable_start + field) != 0; // If this fails, the caller will show what field needs to be set. if (!ok) { throw new Error('FlatBuffers: field ' + field + ' must be set'); } }; /** * Start a new array/vector of objects. Users usually will not call * this directly. The FlatBuffers compiler will create a start/end * method for vector types in generated code. * * @param {number} elem_size The size of each element in the array * @param {number} num_elems The number of elements in the array * @param {number} alignment The alignment of the array */ flatbuffers.Builder.prototype.startVector = function(elem_size, num_elems, alignment) { this.notNested(); this.vector_num_elems = num_elems; this.prep(flatbuffers.SIZEOF_INT, elem_size * num_elems); this.prep(alignment, elem_size * num_elems); // Just in case alignment > int. }; /** * Finish off the creation of an array and all its elements. The array must be * created with `startVector`. * * @returns {flatbuffers.Offset} The offset at which the newly created array * starts. */ flatbuffers.Builder.prototype.endVector = function() { this.writeInt32(this.vector_num_elems); return this.offset(); }; /// @endcond /** * Encode the string `s` in the buffer using UTF-8. If a Uint8Array is passed * instead of a string, it is assumed to contain valid UTF-8 encoded data. * * @param {string|Uint8Array} s The string to encode * @return {flatbuffers.Offset} The offset in the buffer where the encoded string starts */ flatbuffers.Builder.prototype.createString = function(s) { if (s instanceof Uint8Array) { var utf8 = s; } else { var utf8 = []; var i = 0; while (i < s.length) { var codePoint; // Decode UTF-16 var a = s.charCodeAt(i++); if (a < 0xD800 || a >= 0xDC00) { codePoint = a; } else { var b = s.charCodeAt(i++); codePoint = (a << 10) + b + (0x10000 - (0xD800 << 10) - 0xDC00); } // Encode UTF-8 if (codePoint < 0x80) { utf8.push(codePoint); } else { if (codePoint < 0x800) { utf8.push(((codePoint >> 6) & 0x1F) | 0xC0); } else { if (codePoint < 0x10000) { utf8.push(((codePoint >> 12) & 0x0F) | 0xE0); } else { utf8.push( ((codePoint >> 18) & 0x07) | 0xF0, ((codePoint >> 12) & 0x3F) | 0x80); } utf8.push(((codePoint >> 6) & 0x3F) | 0x80); } utf8.push((codePoint & 0x3F) | 0x80); } } } this.addInt8(0); this.startVector(1, utf8.length, 1); this.bb.setPosition(this.space -= utf8.length); for (var i = 0, offset = this.space, bytes = this.bb.bytes(); i < utf8.length; i++) { bytes[offset++] = utf8[i]; } return this.endVector(); }; /** * A helper function to avoid generated code depending on this file directly. * * @param {number} low * @param {number} high * @returns {flatbuffers.Long} */ flatbuffers.Builder.prototype.createLong = function(low, high) { return flatbuffers.Long.create(low, high); }; //////////////////////////////////////////////////////////////////////////////// /// @cond FLATBUFFERS_INTERNAL /** * Create a new ByteBuffer with a given array of bytes (`Uint8Array`). * * @constructor * @param {Uint8Array} bytes */ flatbuffers.ByteBuffer = function(bytes) { /** * @type {Uint8Array} * @private */ this.bytes_ = bytes; /** * @type {number} * @private */ this.position_ = 0; }; /** * Create and allocate a new ByteBuffer with a given size. * * @param {number} byte_size * @returns {flatbuffers.ByteBuffer} */ flatbuffers.ByteBuffer.allocate = function(byte_size) { return new flatbuffers.ByteBuffer(new Uint8Array(byte_size)); }; /** * Get the underlying `Uint8Array`. * * @returns {Uint8Array} */ flatbuffers.ByteBuffer.prototype.bytes = function() { return this.bytes_; }; /** * Get the buffer's position. * * @returns {number} */ flatbuffers.ByteBuffer.prototype.position = function() { return this.position_; }; /** * Set the buffer's position. * * @param {number} position */ flatbuffers.ByteBuffer.prototype.setPosition = function(position) { this.position_ = position; }; /** * Get the buffer's capacity. * * @returns {number} */ flatbuffers.ByteBuffer.prototype.capacity = function() { return this.bytes_.length; }; /** * @param {number} offset * @returns {number} */ flatbuffers.ByteBuffer.prototype.readInt8 = function(offset) { return this.readUint8(offset) << 24 >> 24; }; /** * @param {number} offset * @returns {number} */ flatbuffers.ByteBuffer.prototype.readUint8 = function(offset) { return this.bytes_[offset]; }; /** * @param {number} offset * @returns {number} */ flatbuffers.ByteBuffer.prototype.readInt16 = function(offset) { return this.readUint16(offset) << 16 >> 16; }; /** * @param {number} offset * @returns {number} */ flatbuffers.ByteBuffer.prototype.readUint16 = function(offset) { return this.bytes_[offset] | this.bytes_[offset + 1] << 8; }; /** * @param {number} offset * @returns {number} */ flatbuffers.ByteBuffer.prototype.readInt32 = function(offset) { return this.bytes_[offset] | this.bytes_[offset + 1] << 8 | this.bytes_[offset + 2] << 16 | this.bytes_[offset + 3] << 24; }; /** * @param {number} offset * @returns {number} */ flatbuffers.ByteBuffer.prototype.readUint32 = function(offset) { return this.readInt32(offset) >>> 0; }; /** * @param {number} offset * @returns {flatbuffers.Long} */ flatbuffers.ByteBuffer.prototype.readInt64 = function(offset) { return new flatbuffers.Long(this.readInt32(offset), this.readInt32(offset + 4)); }; /** * @param {number} offset * @returns {flatbuffers.Long} */ flatbuffers.ByteBuffer.prototype.readUint64 = function(offset) { return new flatbuffers.Long(this.readUint32(offset), this.readUint32(offset + 4)); }; /** * @param {number} offset * @returns {number} */ flatbuffers.ByteBuffer.prototype.readFloat32 = function(offset) { flatbuffers.int32[0] = this.readInt32(offset); return flatbuffers.float32[0]; }; /** * @param {number} offset * @returns {number} */ flatbuffers.ByteBuffer.prototype.readFloat64 = function(offset) { flatbuffers.int32[flatbuffers.isLittleEndian ? 0 : 1] = this.readInt32(offset); flatbuffers.int32[flatbuffers.isLittleEndian ? 1 : 0] = this.readInt32(offset + 4); return flatbuffers.float64[0]; }; /** * @param {number} offset * @param {number} value */ flatbuffers.ByteBuffer.prototype.writeInt8 = function(offset, value) { this.bytes_[offset] = value; }; /** * @param {number} offset * @param {number} value */ flatbuffers.ByteBuffer.prototype.writeInt16 = function(offset, value) { this.bytes_[offset] = value; this.bytes_[offset + 1] = value >> 8; }; /** * @param {number} offset * @param {number} value */ flatbuffers.ByteBuffer.prototype.writeInt32 = function(offset, value) { this.bytes_[offset] = value; this.bytes_[offset + 1] = value >> 8; this.bytes_[offset + 2] = value >> 16; this.bytes_[offset + 3] = value >> 24; }; /** * @param {number} offset * @param {flatbuffers.Long} value */ flatbuffers.ByteBuffer.prototype.writeInt64 = function(offset, value) { this.writeInt32(offset, value.low); this.writeInt32(offset + 4, value.high); }; /** * @param {number} offset * @param {number} value */ flatbuffers.ByteBuffer.prototype.writeFloat32 = function(offset, value) { flatbuffers.float32[0] = value; this.writeInt32(offset, flatbuffers.int32[0]); }; /** * @param {number} offset * @param {number} value */ flatbuffers.ByteBuffer.prototype.writeFloat64 = function(offset, value) { flatbuffers.float64[0] = value; this.writeInt32(offset, flatbuffers.int32[flatbuffers.isLittleEndian ? 0 : 1]); this.writeInt32(offset + 4, flatbuffers.int32[flatbuffers.isLittleEndian ? 1 : 0]); }; /** * Look up a field in the vtable, return an offset into the object, or 0 if the * field is not present. * * @param {number} bb_pos * @param {number} vtable_offset * @returns {number} */ flatbuffers.ByteBuffer.prototype.__offset = function(bb_pos, vtable_offset) { var vtable = bb_pos - this.readInt32(bb_pos); return vtable_offset < this.readInt16(vtable) ? this.readInt16(vtable + vtable_offset) : 0; }; /** * Initialize any Table-derived type to point to the union at the given offset. * * @param {flatbuffers.Table} t * @param {number} offset * @returns {flatbuffers.Table} */ flatbuffers.ByteBuffer.prototype.__union = function(t, offset) { t.bb_pos = offset + this.readInt32(offset); t.bb = this; return t; }; /** * Create a JavaScript string from UTF-8 data stored inside the FlatBuffer. * This allocates a new string and converts to wide chars upon each access. * * To avoid the conversion to UTF-16, pass flatbuffers.Encoding.UTF8_BYTES as * the "optionalEncoding" argument. This is useful for avoiding conversion to * and from UTF-16 when the data will just be packaged back up in another * FlatBuffer later on. * * @param {number} offset * @param {flatbuffers.Encoding=} optionalEncoding Defaults to UTF16_STRING * @returns {string|Uint8Array} */ flatbuffers.ByteBuffer.prototype.__string = function(offset, optionalEncoding) { offset += this.readInt32(offset); var length = this.readInt32(offset); var result = ''; var i = 0; offset += flatbuffers.SIZEOF_INT; if (optionalEncoding === flatbuffers.Encoding.UTF8_BYTES) { return this.bytes_.subarray(offset, offset + length); } while (i < length) { var codePoint; // Decode UTF-8 var a = this.readUint8(offset + i++); if (a < 0xC0) { codePoint = a; } else { var b = this.readUint8(offset + i++); if (a < 0xE0) { codePoint = ((a & 0x1F) << 6) | (b & 0x3F); } else { var c = this.readUint8(offset + i++); if (a < 0xF0) { codePoint = ((a & 0x0F) << 12) | ((b & 0x3F) << 6) | (c & 0x3F); } else { var d = this.readUint8(offset + i++); codePoint = ((a & 0x07) << 18) | ((b & 0x3F) << 12) | ((c & 0x3F) << 6) | (d & 0x3F); } } } // Encode UTF-16 if (codePoint < 0x10000) { result += String.fromCharCode(codePoint); } else { codePoint -= 0x10000; result += String.fromCharCode( (codePoint >> 10) + 0xD800, (codePoint & ((1 << 10) - 1)) + 0xDC00); } } return result; }; /** * Retrieve the relative offset stored at "offset" * @param {number} offset * @returns {number} */ flatbuffers.ByteBuffer.prototype.__indirect = function(offset) { return offset + this.readInt32(offset); }; /** * Get the start of data of a vector whose offset is stored at "offset" in this object. * * @param {number} offset * @returns {number} */ flatbuffers.ByteBuffer.prototype.__vector = function(offset) { return offset + this.readInt32(offset) + flatbuffers.SIZEOF_INT; // data starts after the length }; /** * Get the length of a vector whose offset is stored at "offset" in this object. * * @param {number} offset * @returns {number} */ flatbuffers.ByteBuffer.prototype.__vector_len = function(offset) { return this.readInt32(offset + this.readInt32(offset)); }; /** * @param {string} ident * @returns {boolean} */ flatbuffers.ByteBuffer.prototype.__has_identifier = function(ident) { if (ident.length != flatbuffers.FILE_IDENTIFIER_LENGTH) { throw new Error('FlatBuffers: file identifier must be length ' + flatbuffers.FILE_IDENTIFIER_LENGTH); } for (var i = 0; i < flatbuffers.FILE_IDENTIFIER_LENGTH; i++) { if (ident.charCodeAt(i) != this.readInt8(this.position_ + flatbuffers.SIZEOF_INT + i)) { return false; } } return true; }; /** * A helper function to avoid generated code depending on this file directly. * * @param {number} low * @param {number} high * @returns {flatbuffers.Long} */ flatbuffers.ByteBuffer.prototype.createLong = function(low, high) { return flatbuffers.Long.create(low, high); }; // Exports for Node.js and RequireJS this.flatbuffers = flatbuffers; /// @endcond /// @}