blob: 1e2beee3e94e4453618ad8c69a2558a94c5c211d [file] [log] [blame]
// Protocol Buffers - Google's data interchange format
// Copyright 2008 Google Inc. All rights reserved.
// https://developers.google.com/protocol-buffers/
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
// met:
//
// * Redistributions of source code must retain the above copyright
// notice, this list of conditions and the following disclaimer.
// * Redistributions in binary form must reproduce the above
// copyright notice, this list of conditions and the following disclaimer
// in the documentation and/or other materials provided with the
// distribution.
// * Neither the name of Google Inc. nor the names of its
// contributors may be used to endorse or promote products derived from
// this software without specific prior written permission.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
/**
* @fileoverview This file contains utilities for encoding Javascript objects
* into binary, wire-format protocol buffers (in the form of Uint8Arrays) that
* a server can consume directly.
*
* jspb's BinaryWriter class defines methods for efficiently encoding
* Javascript objects into binary, wire-format protocol buffers and supports
* all the fundamental field types used in protocol buffers.
*
* Major caveat 1 - Users of this library _must_ keep their Javascript proto
* parsing code in sync with the original .proto file - presumably you'll be
* using the typed jspb code generator, but if you bypass that you'll need
* to keep things in sync by hand.
*
* Major caveat 2 - Javascript is unable to accurately represent integers
* larger than 2^53 due to its use of a double-precision floating point format
* for all numbers. BinaryWriter does not make any special effort to preserve
* precision for values above this limit - if you need to pass 64-bit integers
* (hash codes, for example) between the client and server without precision
* loss, do _not_ use this library.
*
* Major caveat 3 - This class uses typed arrays and must not be used on older
* browsers that do not support them.
*
* @suppress {missingRequire} TODO(b/152540451): this shouldn't be needed
* @author aappleby@google.com (Austin Appleby)
*/
goog.provide('jspb.BinaryWriter');
goog.require('goog.asserts');
goog.require('goog.crypt.base64');
goog.require('jspb.BinaryConstants');
goog.require('jspb.BinaryEncoder');
goog.require('jspb.arith.Int64');
goog.require('jspb.arith.UInt64');
goog.require('jspb.utils');
/**
* BinaryWriter implements encoders for all the wire types specified in
* https://developers.google.com/protocol-buffers/docs/encoding.
*
* @constructor
* @struct
*/
jspb.BinaryWriter = function() {
/**
* Blocks of serialized data that will be concatenated once all messages have
* been written.
* @private {!Array<!Uint8Array|!Array<number>>}
*/
this.blocks_ = [];
/**
* Total number of bytes in the blocks_ array. Does _not_ include bytes in
* the encoder below.
* @private {number}
*/
this.totalLength_ = 0;
/**
* Binary encoder holding pieces of a message that we're still serializing.
* When we get to a stopping point (either the start of a new submessage, or
* when we need to append a raw Uint8Array), the encoder's buffer will be
* added to the block array above and the encoder will be reset.
* @private {!jspb.BinaryEncoder}
*/
this.encoder_ = new jspb.BinaryEncoder();
/**
* A stack of bookmarks containing the parent blocks for each message started
* via beginSubMessage(), needed as bookkeeping for endSubMessage().
* TODO(aappleby): Deprecated, users should be calling writeMessage().
* @private {!Array<!Array<number>>}
*/
this.bookmarks_ = [];
};
/**
* Append a typed array of bytes onto the buffer.
*
* @param {!Uint8Array} arr The byte array to append.
* @private
*/
jspb.BinaryWriter.prototype.appendUint8Array_ = function(arr) {
var temp = this.encoder_.end();
this.blocks_.push(temp);
this.blocks_.push(arr);
this.totalLength_ += temp.length + arr.length;
};
/**
* Begins a new message by writing the field header and returning a bookmark
* which we will use to patch in the message length to in endDelimited_ below.
* @param {number} field
* @return {!Array<number>}
* @private
*/
jspb.BinaryWriter.prototype.beginDelimited_ = function(field) {
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.DELIMITED);
var bookmark = this.encoder_.end();
this.blocks_.push(bookmark);
this.totalLength_ += bookmark.length;
bookmark.push(this.totalLength_);
return bookmark;
};
/**
* Ends a message by encoding the _change_ in length of the buffer to the
* parent block and adds the number of bytes needed to encode that length to
* the total byte length.
* @param {!Array<number>} bookmark
* @private
*/
jspb.BinaryWriter.prototype.endDelimited_ = function(bookmark) {
var oldLength = bookmark.pop();
var messageLength = this.totalLength_ + this.encoder_.length() - oldLength;
goog.asserts.assert(messageLength >= 0);
while (messageLength > 127) {
bookmark.push((messageLength & 0x7f) | 0x80);
messageLength = messageLength >>> 7;
this.totalLength_++;
}
bookmark.push(messageLength);
this.totalLength_++;
};
/**
* Writes a pre-serialized message to the buffer.
* @param {!Uint8Array} bytes The array of bytes to write.
* @param {number} start The start of the range to write.
* @param {number} end The end of the range to write.
*/
jspb.BinaryWriter.prototype.writeSerializedMessage = function(
bytes, start, end) {
this.appendUint8Array_(bytes.subarray(start, end));
};
/**
* Writes a pre-serialized message to the buffer if the message and endpoints
* are non-null.
* @param {?Uint8Array} bytes The array of bytes to write.
* @param {?number} start The start of the range to write.
* @param {?number} end The end of the range to write.
*/
jspb.BinaryWriter.prototype.maybeWriteSerializedMessage = function(
bytes, start, end) {
if (bytes != null && start != null && end != null) {
this.writeSerializedMessage(bytes, start, end);
}
};
/**
* Resets the writer, throwing away any accumulated buffers.
*/
jspb.BinaryWriter.prototype.reset = function() {
this.blocks_ = [];
this.encoder_.end();
this.totalLength_ = 0;
this.bookmarks_ = [];
};
/**
* Converts the encoded data into a Uint8Array.
* @return {!Uint8Array}
*/
jspb.BinaryWriter.prototype.getResultBuffer = function() {
goog.asserts.assert(this.bookmarks_.length == 0);
var flat = new Uint8Array(this.totalLength_ + this.encoder_.length());
var blocks = this.blocks_;
var blockCount = blocks.length;
var offset = 0;
for (var i = 0; i < blockCount; i++) {
var block = blocks[i];
flat.set(block, offset);
offset += block.length;
}
var tail = this.encoder_.end();
flat.set(tail, offset);
offset += tail.length;
// Post condition: `flattened` must have had every byte written.
goog.asserts.assert(offset == flat.length);
// Replace our block list with the flattened block, which lets GC reclaim
// the temp blocks sooner.
this.blocks_ = [flat];
return flat;
};
/**
* Converts the encoded data into a base64-encoded string.
* @param {!goog.crypt.base64.Alphabet=} alphabet Which flavor of base64 to use.
* @return {string}
*/
jspb.BinaryWriter.prototype.getResultBase64String = function(alphabet) {
return goog.crypt.base64.encodeByteArray(this.getResultBuffer(), alphabet);
};
/**
* Begins a new sub-message. The client must call endSubMessage() when they're
* done.
* TODO(aappleby): Deprecated. Move callers to writeMessage().
* @param {number} field The field number of the sub-message.
*/
jspb.BinaryWriter.prototype.beginSubMessage = function(field) {
this.bookmarks_.push(this.beginDelimited_(field));
};
/**
* Finishes a sub-message and packs it into the parent messages' buffer.
* TODO(aappleby): Deprecated. Move callers to writeMessage().
*/
jspb.BinaryWriter.prototype.endSubMessage = function() {
goog.asserts.assert(this.bookmarks_.length >= 0);
this.endDelimited_(this.bookmarks_.pop());
};
/**
* Encodes a (field number, wire type) tuple into a wire-format field header
* and stores it in the buffer as a varint.
* @param {number} field The field number.
* @param {number} wireType The wire-type of the field, as specified in the
* protocol buffer documentation.
* @private
*/
jspb.BinaryWriter.prototype.writeFieldHeader_ =
function(field, wireType) {
goog.asserts.assert(field >= 1 && field == Math.floor(field));
var x = field * 8 + wireType;
this.encoder_.writeUnsignedVarint32(x);
};
/**
* Writes a field of any valid scalar type to the binary stream.
* @param {jspb.BinaryConstants.FieldType} fieldType
* @param {number} field
* @param {jspb.AnyFieldType} value
*/
jspb.BinaryWriter.prototype.writeAny = function(fieldType, field, value) {
var fieldTypes = jspb.BinaryConstants.FieldType;
switch (fieldType) {
case fieldTypes.DOUBLE:
this.writeDouble(field, /** @type {number} */(value));
return;
case fieldTypes.FLOAT:
this.writeFloat(field, /** @type {number} */(value));
return;
case fieldTypes.INT64:
this.writeInt64(field, /** @type {number} */(value));
return;
case fieldTypes.UINT64:
this.writeUint64(field, /** @type {number} */(value));
return;
case fieldTypes.INT32:
this.writeInt32(field, /** @type {number} */(value));
return;
case fieldTypes.FIXED64:
this.writeFixed64(field, /** @type {number} */(value));
return;
case fieldTypes.FIXED32:
this.writeFixed32(field, /** @type {number} */(value));
return;
case fieldTypes.BOOL:
this.writeBool(field, /** @type {boolean} */(value));
return;
case fieldTypes.STRING:
this.writeString(field, /** @type {string} */(value));
return;
case fieldTypes.GROUP:
goog.asserts.fail('Group field type not supported in writeAny()');
return;
case fieldTypes.MESSAGE:
goog.asserts.fail('Message field type not supported in writeAny()');
return;
case fieldTypes.BYTES:
this.writeBytes(field, /** @type {?Uint8Array} */(value));
return;
case fieldTypes.UINT32:
this.writeUint32(field, /** @type {number} */(value));
return;
case fieldTypes.ENUM:
this.writeEnum(field, /** @type {number} */(value));
return;
case fieldTypes.SFIXED32:
this.writeSfixed32(field, /** @type {number} */(value));
return;
case fieldTypes.SFIXED64:
this.writeSfixed64(field, /** @type {number} */(value));
return;
case fieldTypes.SINT32:
this.writeSint32(field, /** @type {number} */(value));
return;
case fieldTypes.SINT64:
this.writeSint64(field, /** @type {number} */(value));
return;
case fieldTypes.FHASH64:
this.writeFixedHash64(field, /** @type {string} */(value));
return;
case fieldTypes.VHASH64:
this.writeVarintHash64(field, /** @type {string} */(value));
return;
default:
goog.asserts.fail('Invalid field type in writeAny()');
return;
}
};
/**
* Writes a varint field to the buffer without range checking.
* @param {number} field The field number.
* @param {number?} value The value to write.
* @private
*/
jspb.BinaryWriter.prototype.writeUnsignedVarint32_ = function(field, value) {
if (value == null) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.VARINT);
this.encoder_.writeUnsignedVarint32(value);
};
/**
* Writes a varint field to the buffer without range checking.
* @param {number} field The field number.
* @param {number?} value The value to write.
* @private
*/
jspb.BinaryWriter.prototype.writeSignedVarint32_ = function(field, value) {
if (value == null) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.VARINT);
this.encoder_.writeSignedVarint32(value);
};
/**
* Writes a varint field to the buffer without range checking.
* @param {number} field The field number.
* @param {number?} value The value to write.
* @private
*/
jspb.BinaryWriter.prototype.writeUnsignedVarint64_ = function(field, value) {
if (value == null) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.VARINT);
this.encoder_.writeUnsignedVarint64(value);
};
/**
* Writes a varint field to the buffer without range checking.
* @param {number} field The field number.
* @param {number?} value The value to write.
* @private
*/
jspb.BinaryWriter.prototype.writeSignedVarint64_ = function(field, value) {
if (value == null) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.VARINT);
this.encoder_.writeSignedVarint64(value);
};
/**
* Writes a zigzag varint field to the buffer without range checking.
* @param {number} field The field number.
* @param {number?} value The value to write.
* @private
*/
jspb.BinaryWriter.prototype.writeZigzagVarint32_ = function(field, value) {
if (value == null) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.VARINT);
this.encoder_.writeZigzagVarint32(value);
};
/**
* Writes a zigzag varint field to the buffer without range checking.
* @param {number} field The field number.
* @param {number?} value The value to write.
* @private
*/
jspb.BinaryWriter.prototype.writeZigzagVarint64_ = function(field, value) {
if (value == null) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.VARINT);
this.encoder_.writeZigzagVarint64(value);
};
/**
* Writes a zigzag varint field to the buffer without range checking.
* @param {number} field The field number.
* @param {string?} value The value to write.
* @private
*/
jspb.BinaryWriter.prototype.writeZigzagVarint64String_ = function(
field, value) {
if (value == null) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.VARINT);
this.encoder_.writeZigzagVarint64String(value);
};
/**
* Writes a zigzag varint field to the buffer without range checking.
* @param {number} field The field number.
* @param {string?} value The value to write.
* @private
*/
jspb.BinaryWriter.prototype.writeZigzagVarintHash64_ = function(field, value) {
if (value == null) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.VARINT);
this.encoder_.writeZigzagVarintHash64(value);
};
/**
* Writes an int32 field to the buffer. Numbers outside the range [-2^31,2^31)
* will be truncated.
* @param {number} field The field number.
* @param {number?} value The value to write.
*/
jspb.BinaryWriter.prototype.writeInt32 = function(field, value) {
if (value == null) return;
goog.asserts.assert((value >= -jspb.BinaryConstants.TWO_TO_31) &&
(value < jspb.BinaryConstants.TWO_TO_31));
this.writeSignedVarint32_(field, value);
};
/**
* Writes an int32 field represented as a string to the buffer. Numbers outside
* the range [-2^31,2^31) will be truncated.
* @param {number} field The field number.
* @param {string?} value The value to write.
*/
jspb.BinaryWriter.prototype.writeInt32String = function(field, value) {
if (value == null) return;
var intValue = /** {number} */ parseInt(value, 10);
goog.asserts.assert((intValue >= -jspb.BinaryConstants.TWO_TO_31) &&
(intValue < jspb.BinaryConstants.TWO_TO_31));
this.writeSignedVarint32_(field, intValue);
};
/**
* Writes an int64 field to the buffer. Numbers outside the range [-2^63,2^63)
* will be truncated.
* @param {number} field The field number.
* @param {number?} value The value to write.
*/
jspb.BinaryWriter.prototype.writeInt64 = function(field, value) {
if (value == null) return;
goog.asserts.assert((value >= -jspb.BinaryConstants.TWO_TO_63) &&
(value < jspb.BinaryConstants.TWO_TO_63));
this.writeSignedVarint64_(field, value);
};
/**
* Writes a int64 field (with value as a string) to the buffer.
* @param {number} field The field number.
* @param {string?} value The value to write.
*/
jspb.BinaryWriter.prototype.writeInt64String = function(field, value) {
if (value == null) return;
var num = jspb.arith.Int64.fromString(value);
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.VARINT);
this.encoder_.writeSplitVarint64(num.lo, num.hi);
};
/**
* Writes a uint32 field to the buffer. Numbers outside the range [0,2^32)
* will be truncated.
* @param {number} field The field number.
* @param {number?} value The value to write.
*/
jspb.BinaryWriter.prototype.writeUint32 = function(field, value) {
if (value == null) return;
goog.asserts.assert((value >= 0) &&
(value < jspb.BinaryConstants.TWO_TO_32));
this.writeUnsignedVarint32_(field, value);
};
/**
* Writes a uint32 field represented as a string to the buffer. Numbers outside
* the range [0,2^32) will be truncated.
* @param {number} field The field number.
* @param {string?} value The value to write.
*/
jspb.BinaryWriter.prototype.writeUint32String = function(field, value) {
if (value == null) return;
var intValue = /** {number} */ parseInt(value, 10);
goog.asserts.assert((intValue >= 0) &&
(intValue < jspb.BinaryConstants.TWO_TO_32));
this.writeUnsignedVarint32_(field, intValue);
};
/**
* Writes a uint64 field to the buffer. Numbers outside the range [0,2^64)
* will be truncated.
* @param {number} field The field number.
* @param {number?} value The value to write.
*/
jspb.BinaryWriter.prototype.writeUint64 = function(field, value) {
if (value == null) return;
goog.asserts.assert((value >= 0) &&
(value < jspb.BinaryConstants.TWO_TO_64));
this.writeUnsignedVarint64_(field, value);
};
/**
* Writes a uint64 field (with value as a string) to the buffer.
* @param {number} field The field number.
* @param {string?} value The value to write.
*/
jspb.BinaryWriter.prototype.writeUint64String = function(field, value) {
if (value == null) return;
var num = jspb.arith.UInt64.fromString(value);
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.VARINT);
this.encoder_.writeSplitVarint64(num.lo, num.hi);
};
/**
* Writes an sint32 field to the buffer. Numbers outside the range [-2^31,2^31)
* will be truncated.
* @param {number} field The field number.
* @param {number?} value The value to write.
*/
jspb.BinaryWriter.prototype.writeSint32 = function(field, value) {
if (value == null) return;
goog.asserts.assert((value >= -jspb.BinaryConstants.TWO_TO_31) &&
(value < jspb.BinaryConstants.TWO_TO_31));
this.writeZigzagVarint32_(field, value);
};
/**
* Writes an sint64 field to the buffer. Numbers outside the range [-2^63,2^63)
* will be truncated.
* @param {number} field The field number.
* @param {number?} value The value to write.
*/
jspb.BinaryWriter.prototype.writeSint64 = function(field, value) {
if (value == null) return;
goog.asserts.assert((value >= -jspb.BinaryConstants.TWO_TO_63) &&
(value < jspb.BinaryConstants.TWO_TO_63));
this.writeZigzagVarint64_(field, value);
};
/**
* Writes an sint64 field to the buffer from a hash64 encoded value. Numbers
* outside the range [-2^63,2^63) will be truncated.
* @param {number} field The field number.
* @param {string?} value The hash64 string to write.
*/
jspb.BinaryWriter.prototype.writeSintHash64 = function(field, value) {
if (value == null) return;
this.writeZigzagVarintHash64_(field, value);
};
/**
* Writes an sint64 field to the buffer. Numbers outside the range [-2^63,2^63)
* will be truncated.
* @param {number} field The field number.
* @param {string?} value The decimal string to write.
*/
jspb.BinaryWriter.prototype.writeSint64String = function(field, value) {
if (value == null) return;
this.writeZigzagVarint64String_(field, value);
};
/**
* Writes a fixed32 field to the buffer. Numbers outside the range [0,2^32)
* will be truncated.
* @param {number} field The field number.
* @param {number?} value The value to write.
*/
jspb.BinaryWriter.prototype.writeFixed32 = function(field, value) {
if (value == null) return;
goog.asserts.assert((value >= 0) &&
(value < jspb.BinaryConstants.TWO_TO_32));
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.FIXED32);
this.encoder_.writeUint32(value);
};
/**
* Writes a fixed64 field to the buffer. Numbers outside the range [0,2^64)
* will be truncated.
* @param {number} field The field number.
* @param {number?} value The value to write.
*/
jspb.BinaryWriter.prototype.writeFixed64 = function(field, value) {
if (value == null) return;
goog.asserts.assert((value >= 0) &&
(value < jspb.BinaryConstants.TWO_TO_64));
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.FIXED64);
this.encoder_.writeUint64(value);
};
/**
* Writes a fixed64 field (with value as a string) to the buffer.
* @param {number} field The field number.
* @param {string?} value The value to write.
*/
jspb.BinaryWriter.prototype.writeFixed64String = function(field, value) {
if (value == null) return;
var num = jspb.arith.UInt64.fromString(value);
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.FIXED64);
this.encoder_.writeSplitFixed64(num.lo, num.hi);
};
/**
* Writes a sfixed32 field to the buffer. Numbers outside the range
* [-2^31,2^31) will be truncated.
* @param {number} field The field number.
* @param {number?} value The value to write.
*/
jspb.BinaryWriter.prototype.writeSfixed32 = function(field, value) {
if (value == null) return;
goog.asserts.assert((value >= -jspb.BinaryConstants.TWO_TO_31) &&
(value < jspb.BinaryConstants.TWO_TO_31));
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.FIXED32);
this.encoder_.writeInt32(value);
};
/**
* Writes a sfixed64 field to the buffer. Numbers outside the range
* [-2^63,2^63) will be truncated.
* @param {number} field The field number.
* @param {number?} value The value to write.
*/
jspb.BinaryWriter.prototype.writeSfixed64 = function(field, value) {
if (value == null) return;
goog.asserts.assert((value >= -jspb.BinaryConstants.TWO_TO_63) &&
(value < jspb.BinaryConstants.TWO_TO_63));
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.FIXED64);
this.encoder_.writeInt64(value);
};
/**
* Writes a sfixed64 string field to the buffer. Numbers outside the range
* [-2^63,2^63) will be truncated.
* @param {number} field The field number.
* @param {string?} value The value to write.
*/
jspb.BinaryWriter.prototype.writeSfixed64String = function(field, value) {
if (value == null) return;
var num = jspb.arith.Int64.fromString(value);
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.FIXED64);
this.encoder_.writeSplitFixed64(num.lo, num.hi);
};
/**
* Writes a single-precision floating point field to the buffer. Numbers
* requiring more than 32 bits of precision will be truncated.
* @param {number} field The field number.
* @param {number?} value The value to write.
*/
jspb.BinaryWriter.prototype.writeFloat = function(field, value) {
if (value == null) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.FIXED32);
this.encoder_.writeFloat(value);
};
/**
* Writes a double-precision floating point field to the buffer. As this is the
* native format used by JavaScript, no precision will be lost.
* @param {number} field The field number.
* @param {number?} value The value to write.
*/
jspb.BinaryWriter.prototype.writeDouble = function(field, value) {
if (value == null) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.FIXED64);
this.encoder_.writeDouble(value);
};
/**
* Writes a boolean field to the buffer. We allow numbers as input
* because the JSPB code generator uses 0/1 instead of true/false to save space
* in the string representation of the proto.
* @param {number} field The field number.
* @param {boolean?|number?} value The value to write.
*/
jspb.BinaryWriter.prototype.writeBool = function(field, value) {
if (value == null) return;
goog.asserts.assert(typeof value === 'boolean' || typeof value === 'number');
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.VARINT);
this.encoder_.writeBool(value);
};
/**
* Writes an enum field to the buffer.
* @param {number} field The field number.
* @param {number?} value The value to write.
*/
jspb.BinaryWriter.prototype.writeEnum = function(field, value) {
if (value == null) return;
goog.asserts.assert((value >= -jspb.BinaryConstants.TWO_TO_31) &&
(value < jspb.BinaryConstants.TWO_TO_31));
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.VARINT);
this.encoder_.writeSignedVarint32(value);
};
/**
* Writes a string field to the buffer.
* @param {number} field The field number.
* @param {string?} value The string to write.
*/
jspb.BinaryWriter.prototype.writeString = function(field, value) {
if (value == null) return;
var bookmark = this.beginDelimited_(field);
this.encoder_.writeString(value);
this.endDelimited_(bookmark);
};
/**
* Writes an arbitrary byte field to the buffer. Note - to match the behavior
* of the C++ implementation, empty byte arrays _are_ serialized.
* @param {number} field The field number.
* @param {?jspb.ByteSource} value The array of bytes to write.
*/
jspb.BinaryWriter.prototype.writeBytes = function(field, value) {
if (value == null) return;
var bytes = jspb.utils.byteSourceToUint8Array(value);
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.DELIMITED);
this.encoder_.writeUnsignedVarint32(bytes.length);
this.appendUint8Array_(bytes);
};
/**
* Writes a message to the buffer.
* @param {number} field The field number.
* @param {?MessageType} value The message to write.
* @param {function(MessageTypeNonNull, !jspb.BinaryWriter)} writerCallback
* Will be invoked with the value to write and the writer to write it with.
* @template MessageType
* Use go/closure-ttl to declare a non-nullable version of MessageType. Replace
* the null in blah|null with none. This is necessary because the compiler will
* infer MessageType to be nullable if the value parameter is nullable.
* @template MessageTypeNonNull :=
* cond(isUnknown(MessageType), unknown(),
* mapunion(MessageType, (X) =>
* cond(eq(X, 'null'), none(), X)))
* =:
*/
jspb.BinaryWriter.prototype.writeMessage = function(
field, value, writerCallback) {
if (value == null) return;
var bookmark = this.beginDelimited_(field);
writerCallback(value, this);
this.endDelimited_(bookmark);
};
/**
* Writes a message set extension to the buffer.
* @param {number} field The field number for the extension.
* @param {?MessageType} value The extension message object to write. Note that
* message set can only have extensions with type of optional message.
* @param {function(!MessageTypeNonNull, !jspb.BinaryWriter)} writerCallback
* Will be invoked with the value to write and the writer to write it with.
* @template MessageType
* Use go/closure-ttl to declare a non-nullable version of MessageType. Replace
* the null in blah|null with none. This is necessary because the compiler will
* infer MessageType to be nullable if the value parameter is nullable.
* @template MessageTypeNonNull :=
* cond(isUnknown(MessageType), unknown(),
* mapunion(MessageType, (X) =>
* cond(eq(X, 'null'), none(), X)))
* =:
*/
jspb.BinaryWriter.prototype.writeMessageSet = function(
field, value, writerCallback) {
if (value == null) return;
// The wire format for a message set is defined by
// google3/net/proto/message_set.proto
this.writeFieldHeader_(1, jspb.BinaryConstants.WireType.START_GROUP);
this.writeFieldHeader_(2, jspb.BinaryConstants.WireType.VARINT);
this.encoder_.writeSignedVarint32(field);
var bookmark = this.beginDelimited_(3);
writerCallback(value, this);
this.endDelimited_(bookmark);
this.writeFieldHeader_(1, jspb.BinaryConstants.WireType.END_GROUP);
};
/**
* Writes a group message to the buffer.
*
* @param {number} field The field number.
* @param {?MessageType} value The message to write, wrapped with START_GROUP /
* END_GROUP tags. Will be a no-op if 'value' is null.
* @param {function(MessageTypeNonNull, !jspb.BinaryWriter)} writerCallback
* Will be invoked with the value to write and the writer to write it with.
* @template MessageType
* Use go/closure-ttl to declare a non-nullable version of MessageType. Replace
* the null in blah|null with none. This is necessary because the compiler will
* infer MessageType to be nullable if the value parameter is nullable.
* @template MessageTypeNonNull :=
* cond(isUnknown(MessageType), unknown(),
* mapunion(MessageType, (X) =>
* cond(eq(X, 'null'), none(), X)))
* =:
*/
jspb.BinaryWriter.prototype.writeGroup = function(
field, value, writerCallback) {
if (value == null) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.START_GROUP);
writerCallback(value, this);
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.END_GROUP);
};
/**
* Writes a 64-bit hash string field (8 characters @ 8 bits of data each) to
* the buffer.
* @param {number} field The field number.
* @param {string?} value The hash string.
*/
jspb.BinaryWriter.prototype.writeFixedHash64 = function(field, value) {
if (value == null) return;
goog.asserts.assert(value.length == 8);
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.FIXED64);
this.encoder_.writeFixedHash64(value);
};
/**
* Writes a 64-bit hash string field (8 characters @ 8 bits of data each) to
* the buffer.
* @param {number} field The field number.
* @param {string?} value The hash string.
*/
jspb.BinaryWriter.prototype.writeVarintHash64 = function(field, value) {
if (value == null) return;
goog.asserts.assert(value.length == 8);
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.VARINT);
this.encoder_.writeVarintHash64(value);
};
/**
* Writes a 64-bit field to the buffer as a fixed64.
* @param {number} field The field number.
* @param {number} lowBits The low 32 bits.
* @param {number} highBits The high 32 bits.
*/
jspb.BinaryWriter.prototype.writeSplitFixed64 = function(
field, lowBits, highBits) {
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.FIXED64);
this.encoder_.writeSplitFixed64(lowBits, highBits);
};
/**
* Writes a 64-bit field to the buffer as a varint.
* @param {number} field The field number.
* @param {number} lowBits The low 32 bits.
* @param {number} highBits The high 32 bits.
*/
jspb.BinaryWriter.prototype.writeSplitVarint64 = function(
field, lowBits, highBits) {
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.VARINT);
this.encoder_.writeSplitVarint64(lowBits, highBits);
};
/**
* Writes a 64-bit field to the buffer as a zigzag encoded varint.
* @param {number} field The field number.
* @param {number} lowBits The low 32 bits.
* @param {number} highBits The high 32 bits.
*/
jspb.BinaryWriter.prototype.writeSplitZigzagVarint64 = function(
field, lowBits, highBits) {
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.VARINT);
var encoder = this.encoder_;
jspb.utils.toZigzag64(lowBits, highBits, function(lowBits, highBits) {
encoder.writeSplitVarint64(lowBits >>> 0, highBits >>> 0);
});
};
/**
* Writes an array of numbers to the buffer as a repeated 32-bit int field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedInt32 = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeSignedVarint32_(field, value[i]);
}
};
/**
* Writes an array of numbers formatted as strings to the buffer as a repeated
* 32-bit int field.
* @param {number} field The field number.
* @param {?Array<string>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedInt32String = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeInt32String(field, value[i]);
}
};
/**
* Writes an array of numbers to the buffer as a repeated 64-bit int field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedInt64 = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeSignedVarint64_(field, value[i]);
}
};
/**
* Writes an array of 64-bit values to the buffer as a fixed64.
* @param {number} field The field number.
* @param {?Array<T>} value The value.
* @param {function(T): number} lo Function to get low bits.
* @param {function(T): number} hi Function to get high bits.
* @template T
*/
jspb.BinaryWriter.prototype.writeRepeatedSplitFixed64 = function(
field, value, lo, hi) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeSplitFixed64(field, lo(value[i]), hi(value[i]));
}
};
/**
* Writes an array of 64-bit values to the buffer as a varint.
* @param {number} field The field number.
* @param {?Array<T>} value The value.
* @param {function(T): number} lo Function to get low bits.
* @param {function(T): number} hi Function to get high bits.
* @template T
*/
jspb.BinaryWriter.prototype.writeRepeatedSplitVarint64 = function(
field, value, lo, hi) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeSplitVarint64(field, lo(value[i]), hi(value[i]));
}
};
/**
* Writes an array of 64-bit values to the buffer as a zigzag varint.
* @param {number} field The field number.
* @param {?Array<T>} value The value.
* @param {function(T): number} lo Function to get low bits.
* @param {function(T): number} hi Function to get high bits.
* @template T
*/
jspb.BinaryWriter.prototype.writeRepeatedSplitZigzagVarint64 = function(
field, value, lo, hi) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeSplitZigzagVarint64(field, lo(value[i]), hi(value[i]));
}
};
/**
* Writes an array of numbers formatted as strings to the buffer as a repeated
* 64-bit int field.
* @param {number} field The field number.
* @param {?Array<string>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedInt64String = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeInt64String(field, value[i]);
}
};
/**
* Writes an array numbers to the buffer as a repeated unsigned 32-bit int
* field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedUint32 = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeUnsignedVarint32_(field, value[i]);
}
};
/**
* Writes an array of numbers formatted as strings to the buffer as a repeated
* unsigned 32-bit int field.
* @param {number} field The field number.
* @param {?Array<string>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedUint32String = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeUint32String(field, value[i]);
}
};
/**
* Writes an array numbers to the buffer as a repeated unsigned 64-bit int
* field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedUint64 = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeUnsignedVarint64_(field, value[i]);
}
};
/**
* Writes an array of numbers formatted as strings to the buffer as a repeated
* unsigned 64-bit int field.
* @param {number} field The field number.
* @param {?Array<string>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedUint64String = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeUint64String(field, value[i]);
}
};
/**
* Writes an array numbers to the buffer as a repeated signed 32-bit int field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedSint32 = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeZigzagVarint32_(field, value[i]);
}
};
/**
* Writes an array numbers to the buffer as a repeated signed 64-bit int field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedSint64 = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeZigzagVarint64_(field, value[i]);
}
};
/**
* Writes an array numbers to the buffer as a repeated signed 64-bit int field.
* @param {number} field The field number.
* @param {?Array<string>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedSint64String = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeZigzagVarint64String_(field, value[i]);
}
};
/**
* Writes an array of hash64 strings to the buffer as a repeated signed 64-bit
* int field.
* @param {number} field The field number.
* @param {?Array<string>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedSintHash64 = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeZigzagVarintHash64_(field, value[i]);
}
};
/**
* Writes an array of numbers to the buffer as a repeated fixed32 field. This
* works for both signed and unsigned fixed32s.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedFixed32 = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeFixed32(field, value[i]);
}
};
/**
* Writes an array of numbers to the buffer as a repeated fixed64 field. This
* works for both signed and unsigned fixed64s.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedFixed64 = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeFixed64(field, value[i]);
}
};
/**
* Writes an array of numbers to the buffer as a repeated fixed64 field. This
* works for both signed and unsigned fixed64s.
* @param {number} field The field number.
* @param {?Array<string>} value The array of decimal strings to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedFixed64String = function(
field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeFixed64String(field, value[i]);
}
};
/**
* Writes an array of numbers to the buffer as a repeated sfixed32 field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedSfixed32 = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeSfixed32(field, value[i]);
}
};
/**
* Writes an array of numbers to the buffer as a repeated sfixed64 field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedSfixed64 = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeSfixed64(field, value[i]);
}
};
/**
* Writes an array of decimal strings to the buffer as a repeated sfixed64
* field.
* @param {number} field The field number.
* @param {?Array<string>} value The array of decimal strings to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedSfixed64String = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeSfixed64String(field, value[i]);
}
};
/**
* Writes an array of numbers to the buffer as a repeated float field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedFloat = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeFloat(field, value[i]);
}
};
/**
* Writes an array of numbers to the buffer as a repeated double field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedDouble = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeDouble(field, value[i]);
}
};
/**
* Writes an array of booleans to the buffer as a repeated bool field.
* @param {number} field The field number.
* @param {?Array<boolean>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedBool = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeBool(field, value[i]);
}
};
/**
* Writes an array of enums to the buffer as a repeated enum field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedEnum = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeEnum(field, value[i]);
}
};
/**
* Writes an array of strings to the buffer as a repeated string field.
* @param {number} field The field number.
* @param {?Array<string>} value The array of strings to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedString = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeString(field, value[i]);
}
};
/**
* Writes an array of arbitrary byte fields to the buffer.
* @param {number} field The field number.
* @param {?Array<!jspb.ByteSource>} value The arrays of arrays of bytes to
* write.
*/
jspb.BinaryWriter.prototype.writeRepeatedBytes = function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeBytes(field, value[i]);
}
};
/**
* Writes an array of messages to the buffer.
* @template MessageType
* @param {number} field The field number.
* @param {?Array<MessageType>} value The array of messages to
* write.
* @param {function(MessageType, !jspb.BinaryWriter)} writerCallback
* Will be invoked with the value to write and the writer to write it with.
*/
jspb.BinaryWriter.prototype.writeRepeatedMessage = function(
field, value, writerCallback) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
var bookmark = this.beginDelimited_(field);
writerCallback(value[i], this);
this.endDelimited_(bookmark);
}
};
/**
* Writes an array of group messages to the buffer.
* @template MessageType
* @param {number} field The field number.
* @param {?Array<MessageType>} value The array of messages to
* write.
* @param {function(MessageType, !jspb.BinaryWriter)} writerCallback
* Will be invoked with the value to write and the writer to write it with.
*/
jspb.BinaryWriter.prototype.writeRepeatedGroup = function(
field, value, writerCallback) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.START_GROUP);
writerCallback(value[i], this);
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.END_GROUP);
}
};
/**
* Writes a 64-bit hash string field (8 characters @ 8 bits of data each) to
* the buffer.
* @param {number} field The field number.
* @param {?Array<string>} value The array of hashes to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedFixedHash64 =
function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeFixedHash64(field, value[i]);
}
};
/**
* Writes a repeated 64-bit hash string field (8 characters @ 8 bits of data
* each) to the buffer.
* @param {number} field The field number.
* @param {?Array<string>} value The array of hashes to write.
*/
jspb.BinaryWriter.prototype.writeRepeatedVarintHash64 =
function(field, value) {
if (value == null) return;
for (var i = 0; i < value.length; i++) {
this.writeVarintHash64(field, value[i]);
}
};
/**
* Writes an array of numbers to the buffer as a packed 32-bit int field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writePackedInt32 = function(field, value) {
if (value == null || !value.length) return;
var bookmark = this.beginDelimited_(field);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeSignedVarint32(value[i]);
}
this.endDelimited_(bookmark);
};
/**
* Writes an array of numbers represented as strings to the buffer as a packed
* 32-bit int field.
* @param {number} field
* @param {?Array<string>} value
*/
jspb.BinaryWriter.prototype.writePackedInt32String = function(field, value) {
if (value == null || !value.length) return;
var bookmark = this.beginDelimited_(field);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeSignedVarint32(parseInt(value[i], 10));
}
this.endDelimited_(bookmark);
};
/**
* Writes an array of numbers to the buffer as a packed 64-bit int field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writePackedInt64 = function(field, value) {
if (value == null || !value.length) return;
var bookmark = this.beginDelimited_(field);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeSignedVarint64(value[i]);
}
this.endDelimited_(bookmark);
};
/**
* Writes an array of 64-bit values to the buffer as a fixed64.
* @param {number} field The field number.
* @param {?Array<T>} value The value.
* @param {function(T): number} lo Function to get low bits.
* @param {function(T): number} hi Function to get high bits.
* @template T
*/
jspb.BinaryWriter.prototype.writePackedSplitFixed64 = function(
field, value, lo, hi) {
if (value == null) return;
var bookmark = this.beginDelimited_(field);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeSplitFixed64(lo(value[i]), hi(value[i]));
}
this.endDelimited_(bookmark);
};
/**
* Writes an array of 64-bit values to the buffer as a varint.
* @param {number} field The field number.
* @param {?Array<T>} value The value.
* @param {function(T): number} lo Function to get low bits.
* @param {function(T): number} hi Function to get high bits.
* @template T
*/
jspb.BinaryWriter.prototype.writePackedSplitVarint64 = function(
field, value, lo, hi) {
if (value == null) return;
var bookmark = this.beginDelimited_(field);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeSplitVarint64(lo(value[i]), hi(value[i]));
}
this.endDelimited_(bookmark);
};
/**
* Writes an array of 64-bit values to the buffer as a zigzag varint.
* @param {number} field The field number.
* @param {?Array<T>} value The value.
* @param {function(T): number} lo Function to get low bits.
* @param {function(T): number} hi Function to get high bits.
* @template T
*/
jspb.BinaryWriter.prototype.writePackedSplitZigzagVarint64 = function(
field, value, lo, hi) {
if (value == null) return;
var bookmark = this.beginDelimited_(field);
var encoder = this.encoder_;
for (var i = 0; i < value.length; i++) {
jspb.utils.toZigzag64(
lo(value[i]), hi(value[i]), function(bitsLow, bitsHigh) {
encoder.writeSplitVarint64(bitsLow >>> 0, bitsHigh >>> 0);
});
}
this.endDelimited_(bookmark);
};
/**
* Writes an array of numbers represented as strings to the buffer as a packed
* 64-bit int field.
* @param {number} field
* @param {?Array<string>} value
*/
jspb.BinaryWriter.prototype.writePackedInt64String = function(field, value) {
if (value == null || !value.length) return;
var bookmark = this.beginDelimited_(field);
for (var i = 0; i < value.length; i++) {
var num = jspb.arith.Int64.fromString(value[i]);
this.encoder_.writeSplitVarint64(num.lo, num.hi);
}
this.endDelimited_(bookmark);
};
/**
* Writes an array numbers to the buffer as a packed unsigned 32-bit int field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writePackedUint32 = function(field, value) {
if (value == null || !value.length) return;
var bookmark = this.beginDelimited_(field);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeUnsignedVarint32(value[i]);
}
this.endDelimited_(bookmark);
};
/**
* Writes an array of numbers represented as strings to the buffer as a packed
* unsigned 32-bit int field.
* @param {number} field
* @param {?Array<string>} value
*/
jspb.BinaryWriter.prototype.writePackedUint32String =
function(field, value) {
if (value == null || !value.length) return;
var bookmark = this.beginDelimited_(field);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeUnsignedVarint32(parseInt(value[i], 10));
}
this.endDelimited_(bookmark);
};
/**
* Writes an array numbers to the buffer as a packed unsigned 64-bit int field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writePackedUint64 = function(field, value) {
if (value == null || !value.length) return;
var bookmark = this.beginDelimited_(field);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeUnsignedVarint64(value[i]);
}
this.endDelimited_(bookmark);
};
/**
* Writes an array of numbers represented as strings to the buffer as a packed
* unsigned 64-bit int field.
* @param {number} field
* @param {?Array<string>} value
*/
jspb.BinaryWriter.prototype.writePackedUint64String =
function(field, value) {
if (value == null || !value.length) return;
var bookmark = this.beginDelimited_(field);
for (var i = 0; i < value.length; i++) {
var num = jspb.arith.UInt64.fromString(value[i]);
this.encoder_.writeSplitVarint64(num.lo, num.hi);
}
this.endDelimited_(bookmark);
};
/**
* Writes an array numbers to the buffer as a packed signed 32-bit int field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writePackedSint32 = function(field, value) {
if (value == null || !value.length) return;
var bookmark = this.beginDelimited_(field);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeZigzagVarint32(value[i]);
}
this.endDelimited_(bookmark);
};
/**
* Writes an array of numbers to the buffer as a packed signed 64-bit int field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writePackedSint64 = function(field, value) {
if (value == null || !value.length) return;
var bookmark = this.beginDelimited_(field);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeZigzagVarint64(value[i]);
}
this.endDelimited_(bookmark);
};
/**
* Writes an array of decimal strings to the buffer as a packed signed 64-bit
* int field.
* @param {number} field The field number.
* @param {?Array<string>} value The array of decimal strings to write.
*/
jspb.BinaryWriter.prototype.writePackedSint64String = function(field, value) {
if (value == null || !value.length) return;
var bookmark = this.beginDelimited_(field);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeZigzagVarintHash64(
jspb.utils.decimalStringToHash64(value[i]));
}
this.endDelimited_(bookmark);
};
/**
* Writes an array of hash 64 strings to the buffer as a packed signed 64-bit
* int field.
* @param {number} field The field number.
* @param {?Array<string>} value The array of decimal strings to write.
*/
jspb.BinaryWriter.prototype.writePackedSintHash64 = function(field, value) {
if (value == null || !value.length) return;
var bookmark = this.beginDelimited_(field);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeZigzagVarintHash64(value[i]);
}
this.endDelimited_(bookmark);
};
/**
* Writes an array of numbers to the buffer as a packed fixed32 field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writePackedFixed32 = function(field, value) {
if (value == null || !value.length) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.DELIMITED);
this.encoder_.writeUnsignedVarint32(value.length * 4);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeUint32(value[i]);
}
};
/**
* Writes an array of numbers to the buffer as a packed fixed64 field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writePackedFixed64 = function(field, value) {
if (value == null || !value.length) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.DELIMITED);
this.encoder_.writeUnsignedVarint32(value.length * 8);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeUint64(value[i]);
}
};
/**
* Writes an array of numbers represented as strings to the buffer as a packed
* fixed64 field.
* @param {number} field The field number.
* @param {?Array<string>} value The array of strings to write.
*/
jspb.BinaryWriter.prototype.writePackedFixed64String = function(field, value) {
if (value == null || !value.length) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.DELIMITED);
this.encoder_.writeUnsignedVarint32(value.length * 8);
for (var i = 0; i < value.length; i++) {
var num = jspb.arith.UInt64.fromString(value[i]);
this.encoder_.writeSplitFixed64(num.lo, num.hi);
}
};
/**
* Writes an array of numbers to the buffer as a packed sfixed32 field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writePackedSfixed32 = function(field, value) {
if (value == null || !value.length) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.DELIMITED);
this.encoder_.writeUnsignedVarint32(value.length * 4);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeInt32(value[i]);
}
};
/**
* Writes an array of numbers to the buffer as a packed sfixed64 field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writePackedSfixed64 = function(field, value) {
if (value == null || !value.length) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.DELIMITED);
this.encoder_.writeUnsignedVarint32(value.length * 8);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeInt64(value[i]);
}
};
/**
* Writes an array of numbers to the buffer as a packed sfixed64 field.
* @param {number} field The field number.
* @param {?Array<string>} value The array of decimal strings to write.
*/
jspb.BinaryWriter.prototype.writePackedSfixed64String = function(field, value) {
if (value == null || !value.length) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.DELIMITED);
this.encoder_.writeUnsignedVarint32(value.length * 8);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeInt64String(value[i]);
}
};
/**
* Writes an array of numbers to the buffer as a packed float field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writePackedFloat = function(field, value) {
if (value == null || !value.length) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.DELIMITED);
this.encoder_.writeUnsignedVarint32(value.length * 4);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeFloat(value[i]);
}
};
/**
* Writes an array of numbers to the buffer as a packed double field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writePackedDouble = function(field, value) {
if (value == null || !value.length) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.DELIMITED);
this.encoder_.writeUnsignedVarint32(value.length * 8);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeDouble(value[i]);
}
};
/**
* Writes an array of booleans to the buffer as a packed bool field.
* @param {number} field The field number.
* @param {?Array<boolean>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writePackedBool = function(field, value) {
if (value == null || !value.length) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.DELIMITED);
this.encoder_.writeUnsignedVarint32(value.length);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeBool(value[i]);
}
};
/**
* Writes an array of enums to the buffer as a packed enum field.
* @param {number} field The field number.
* @param {?Array<number>} value The array of ints to write.
*/
jspb.BinaryWriter.prototype.writePackedEnum = function(field, value) {
if (value == null || !value.length) return;
var bookmark = this.beginDelimited_(field);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeEnum(value[i]);
}
this.endDelimited_(bookmark);
};
/**
* Writes a 64-bit hash string field (8 characters @ 8 bits of data each) to
* the buffer.
* @param {number} field The field number.
* @param {?Array<string>} value The array of hashes to write.
*/
jspb.BinaryWriter.prototype.writePackedFixedHash64 = function(field, value) {
if (value == null || !value.length) return;
this.writeFieldHeader_(field, jspb.BinaryConstants.WireType.DELIMITED);
this.encoder_.writeUnsignedVarint32(value.length * 8);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeFixedHash64(value[i]);
}
};
/**
* Writes a 64-bit hash string field (8 characters @ 8 bits of data each) to
* the buffer.
* @param {number} field The field number.
* @param {?Array<string>} value The array of hashes to write.
*/
jspb.BinaryWriter.prototype.writePackedVarintHash64 = function(field, value) {
if (value == null || !value.length) return;
var bookmark = this.beginDelimited_(field);
for (var i = 0; i < value.length; i++) {
this.encoder_.writeVarintHash64(value[i]);
}
this.endDelimited_(bookmark);
};