kernel.js 126 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811
  1. /**
  2. * @fileoverview Kernel is a class to provide type-checked accessing
  3. * (read/write bool/int32/string/...) on binary data.
  4. *
  5. * When creating the Kernel with the binary data, there is no deep
  6. * decoding done (which requires full type information). The deep decoding is
  7. * deferred until the first time accessing (when accessors can provide
  8. * full type information).
  9. *
  10. * Because accessors can be statically analyzed and stripped, unlike eager
  11. * binary decoding (which requires the full type information of all defined
  12. * fields), Kernel will only need the full type information of used
  13. * fields.
  14. */
  15. goog.module('protobuf.runtime.Kernel');
  16. const BinaryStorage = goog.require('protobuf.runtime.BinaryStorage');
  17. const BufferDecoder = goog.require('protobuf.binary.BufferDecoder');
  18. const ByteString = goog.require('protobuf.ByteString');
  19. const Int64 = goog.require('protobuf.Int64');
  20. const InternalMessage = goog.require('protobuf.binary.InternalMessage');
  21. const Storage = goog.require('protobuf.runtime.Storage');
  22. const WireType = goog.require('protobuf.binary.WireType');
  23. const Writer = goog.require('protobuf.binary.Writer');
  24. const reader = goog.require('protobuf.binary.reader');
  25. const {CHECK_TYPE, checkCriticalElementIndex, checkCriticalState, checkCriticalType, checkCriticalTypeBool, checkCriticalTypeBoolArray, checkCriticalTypeByteString, checkCriticalTypeByteStringArray, checkCriticalTypeDouble, checkCriticalTypeDoubleArray, checkCriticalTypeFloat, checkCriticalTypeFloatIterable, checkCriticalTypeMessageArray, checkCriticalTypeSignedInt32, checkCriticalTypeSignedInt32Array, checkCriticalTypeSignedInt64, checkCriticalTypeSignedInt64Array, checkCriticalTypeString, checkCriticalTypeStringArray, checkCriticalTypeUnsignedInt32, checkCriticalTypeUnsignedInt32Array, checkDefAndNotNull, checkElementIndex, checkFieldNumber, checkFunctionExists, checkState, checkTypeDouble, checkTypeFloat, checkTypeSignedInt32, checkTypeSignedInt64, checkTypeUnsignedInt32} = goog.require('protobuf.internal.checks');
  26. const {Field, IndexEntry} = goog.require('protobuf.binary.field');
  27. const {buildIndex} = goog.require('protobuf.binary.indexer');
  28. /**
  29. * Validates the index entry has the correct wire type.
  30. * @param {!IndexEntry} indexEntry
  31. * @param {!WireType} expected
  32. */
  33. function validateWireType(indexEntry, expected) {
  34. const wireType = Field.getWireType(indexEntry);
  35. checkCriticalState(
  36. wireType === expected,
  37. `Expected wire type: ${expected} but found: ${wireType}`);
  38. }
  39. /**
  40. * Checks if the object implements InternalMessage interface.
  41. * @param {?} obj
  42. * @return {!InternalMessage}
  43. */
  44. function checkIsInternalMessage(obj) {
  45. const message = /** @type {!InternalMessage} */ (obj);
  46. checkFunctionExists(message.internalGetKernel);
  47. return message;
  48. }
  49. /**
  50. * Checks if the instanceCreator returns an instance that implements the
  51. * InternalMessage interface.
  52. * @param {function(!Kernel):T} instanceCreator
  53. * @template T
  54. */
  55. function checkInstanceCreator(instanceCreator) {
  56. if (CHECK_TYPE) {
  57. const emptyMessage = instanceCreator(Kernel.createEmpty());
  58. checkFunctionExists(emptyMessage.internalGetKernel);
  59. }
  60. }
  61. /**
  62. * Reads the last entry of the index array using the given read function.
  63. * This is used to implement parsing singular primitive fields.
  64. * @param {!Array<!IndexEntry>} indexArray
  65. * @param {!BufferDecoder} bufferDecoder
  66. * @param {function(!BufferDecoder, number):T} readFunc
  67. * @param {!WireType} wireType
  68. * @return {T}
  69. * @template T
  70. */
  71. function readOptional(indexArray, bufferDecoder, readFunc, wireType) {
  72. const index = indexArray.length - 1;
  73. checkElementIndex(index, indexArray.length);
  74. const indexEntry = indexArray[index];
  75. validateWireType(indexEntry, wireType);
  76. return readFunc(bufferDecoder, Field.getStartIndex(indexEntry));
  77. }
  78. /**
  79. * Converts all entries of the index array to the template type using given read
  80. * methods and return an Iterable containing those converted values.
  81. * Primitive repeated fields may be encoded either packed or unpacked. Thus, two
  82. * read methods are needed for those two cases.
  83. * This is used to implement parsing repeated primitive fields.
  84. * @param {!Array<!IndexEntry>} indexArray
  85. * @param {!BufferDecoder} bufferDecoder
  86. * @param {function(!BufferDecoder, number):T} singularReadFunc
  87. * @param {function(!BufferDecoder, number):!Array<T>} packedReadFunc
  88. * @param {!WireType} expectedWireType
  89. * @return {!Array<T>}
  90. * @template T
  91. */
  92. function readRepeatedPrimitive(
  93. indexArray, bufferDecoder, singularReadFunc, packedReadFunc,
  94. expectedWireType) {
  95. // Fast path when there is a single packed entry.
  96. if (indexArray.length === 1 &&
  97. Field.getWireType(indexArray[0]) === WireType.DELIMITED) {
  98. return packedReadFunc(bufferDecoder, Field.getStartIndex(indexArray[0]));
  99. }
  100. let /** !Array<T> */ result = [];
  101. for (const indexEntry of indexArray) {
  102. const wireType = Field.getWireType(indexEntry);
  103. const startIndex = Field.getStartIndex(indexEntry);
  104. if (wireType === WireType.DELIMITED) {
  105. result = result.concat(packedReadFunc(bufferDecoder, startIndex));
  106. } else {
  107. validateWireType(indexEntry, expectedWireType);
  108. result.push(singularReadFunc(bufferDecoder, startIndex));
  109. }
  110. }
  111. return result;
  112. }
  113. /**
  114. * Converts all entries of the index array to the template type using the given
  115. * read function and return an Array containing those converted values. This is
  116. * used to implement parsing repeated non-primitive fields.
  117. * @param {!Array<!IndexEntry>} indexArray
  118. * @param {!BufferDecoder} bufferDecoder
  119. * @param {function(!BufferDecoder, number):T} singularReadFunc
  120. * @return {!Array<T>}
  121. * @template T
  122. */
  123. function readRepeatedNonPrimitive(indexArray, bufferDecoder, singularReadFunc) {
  124. const result = new Array(indexArray.length);
  125. for (let i = 0; i < indexArray.length; i++) {
  126. validateWireType(indexArray[i], WireType.DELIMITED);
  127. result[i] =
  128. singularReadFunc(bufferDecoder, Field.getStartIndex(indexArray[i]));
  129. }
  130. return result;
  131. }
  132. /**
  133. * Creates a new bytes array to contain all data of a submessage.
  134. * When there are multiple entries, merge them together.
  135. * @param {!Array<!IndexEntry>} indexArray
  136. * @param {!BufferDecoder} bufferDecoder
  137. * @return {!BufferDecoder}
  138. */
  139. function mergeMessageArrays(indexArray, bufferDecoder) {
  140. const dataArrays = indexArray.map(
  141. indexEntry =>
  142. reader.readDelimited(bufferDecoder, Field.getStartIndex(indexEntry)));
  143. return BufferDecoder.merge(dataArrays);
  144. }
  145. /**
  146. * @param {!Array<!IndexEntry>} indexArray
  147. * @param {!BufferDecoder} bufferDecoder
  148. * @param {number=} pivot
  149. * @return {!Kernel}
  150. */
  151. function readAccessor(indexArray, bufferDecoder, pivot = undefined) {
  152. checkState(indexArray.length > 0);
  153. let accessorBuffer;
  154. // Faster access for one member.
  155. if (indexArray.length === 1) {
  156. const indexEntry = indexArray[0];
  157. validateWireType(indexEntry, WireType.DELIMITED);
  158. accessorBuffer =
  159. reader.readDelimited(bufferDecoder, Field.getStartIndex(indexEntry));
  160. } else {
  161. indexArray.forEach(indexEntry => {
  162. validateWireType(indexEntry, WireType.DELIMITED);
  163. });
  164. accessorBuffer = mergeMessageArrays(indexArray, bufferDecoder);
  165. }
  166. return Kernel.fromBufferDecoder_(accessorBuffer, pivot);
  167. }
  168. /**
  169. * Merges all index entries of the index array using the given read function.
  170. * This is used to implement parsing singular message fields.
  171. * @param {!Array<!IndexEntry>} indexArray
  172. * @param {!BufferDecoder} bufferDecoder
  173. * @param {function(!Kernel):T} instanceCreator
  174. * @param {number=} pivot
  175. * @return {T}
  176. * @template T
  177. */
  178. function readMessage(indexArray, bufferDecoder, instanceCreator, pivot) {
  179. checkInstanceCreator(instanceCreator);
  180. const accessor = readAccessor(indexArray, bufferDecoder, pivot);
  181. return instanceCreator(accessor);
  182. }
  183. /**
  184. * @param {!Writer} writer
  185. * @param {number} fieldNumber
  186. * @param {?InternalMessage} value
  187. */
  188. function writeMessage(writer, fieldNumber, value) {
  189. writer.writeDelimited(
  190. fieldNumber, checkDefAndNotNull(value).internalGetKernel().serialize());
  191. }
  192. /**
  193. * Writes the array of Messages into the writer for the given field number.
  194. * @param {!Writer} writer
  195. * @param {number} fieldNumber
  196. * @param {!Iterable<!InternalMessage>} values
  197. */
  198. function writeRepeatedMessage(writer, fieldNumber, values) {
  199. for (const value of values) {
  200. writeMessage(writer, fieldNumber, value);
  201. }
  202. }
  203. /**
  204. * Array.from has a weird type definition in google3/javascript/externs/es6.js
  205. * and wants the mapping function accept strings.
  206. * @const {function((string|number)): number}
  207. */
  208. const fround = /** @type {function((string|number)): number} */ (Math.fround);
  209. /**
  210. * Wraps an array and exposes it as an Iterable. This class is used to provide
  211. * immutable access of the array to the caller.
  212. * @implements {Iterable<T>}
  213. * @template T
  214. */
  215. class ArrayIterable {
  216. /**
  217. * @param {!Array<T>} array
  218. */
  219. constructor(array) {
  220. /** @private @const {!Array<T>} */
  221. this.array_ = array;
  222. }
  223. /** @return {!Iterator<T>} */
  224. [Symbol.iterator]() {
  225. return this.array_[Symbol.iterator]();
  226. }
  227. }
  228. /**
  229. * Accesses protobuf fields on binary format data. Binary data is decoded lazily
  230. * at the first access.
  231. * @final
  232. */
  233. class Kernel {
  234. /**
  235. * Create a Kernel for the given binary bytes.
  236. * The bytes array is kept by the Kernel. DON'T MODIFY IT.
  237. * @param {!ArrayBuffer} arrayBuffer Binary bytes.
  238. * @param {number=} pivot Fields with a field number no greater than the pivot
  239. * value will be stored in an array for fast access. Other fields will be
  240. * stored in a map. A higher pivot value can improve runtime performance
  241. * at the expense of requiring more memory. It's recommended to set the
  242. * value to the max field number of the message unless the field numbers
  243. * are too sparse. If the value is not set, a default value specified in
  244. * storage.js will be used.
  245. * @return {!Kernel}
  246. */
  247. static fromArrayBuffer(arrayBuffer, pivot = undefined) {
  248. const bufferDecoder = BufferDecoder.fromArrayBuffer(arrayBuffer);
  249. return Kernel.fromBufferDecoder_(bufferDecoder, pivot);
  250. }
  251. /**
  252. * Creates an empty Kernel.
  253. * @param {number=} pivot Fields with a field number no greater than the pivot
  254. * value will be stored in an array for fast access. Other fields will be
  255. * stored in a map. A higher pivot value can improve runtime performance
  256. * at the expense of requiring more memory. It's recommended to set the
  257. * value to the max field number of the message unless the field numbers
  258. * are too sparse. If the value is not set, a default value specified in
  259. * storage.js will be used.
  260. * @return {!Kernel}
  261. */
  262. static createEmpty(pivot = undefined) {
  263. return new Kernel(/* bufferDecoder= */ null, new BinaryStorage(pivot));
  264. }
  265. /**
  266. * Create a Kernel for the given binary bytes.
  267. * The bytes array is kept by the Kernel. DON'T MODIFY IT.
  268. * @param {!BufferDecoder} bufferDecoder Binary bytes.
  269. * @param {number|undefined} pivot
  270. * @return {!Kernel}
  271. * @private
  272. */
  273. static fromBufferDecoder_(bufferDecoder, pivot) {
  274. return new Kernel(bufferDecoder, buildIndex(bufferDecoder, pivot));
  275. }
  276. /**
  277. * @param {?BufferDecoder} bufferDecoder Binary bytes. Accessor treats the
  278. * bytes as immutable and will never attempt to write to it.
  279. * @param {!Storage<!Field>} fields A map of field number to Field. The
  280. * IndexEntry in each Field needs to be populated with the location of the
  281. * field in the binary data.
  282. * @private
  283. */
  284. constructor(bufferDecoder, fields) {
  285. /** @private @const {?BufferDecoder} */
  286. this.bufferDecoder_ = bufferDecoder;
  287. /** @private @const {!Storage<!Field>} */
  288. this.fields_ = fields;
  289. }
  290. /**
  291. * Creates a shallow copy of the accessor.
  292. * @return {!Kernel}
  293. */
  294. shallowCopy() {
  295. return new Kernel(this.bufferDecoder_, this.fields_.shallowCopy());
  296. }
  297. /**
  298. * See definition of the pivot parameter on the fromArrayBuffer() method.
  299. * @return {number}
  300. */
  301. getPivot() {
  302. return this.fields_.getPivot();
  303. }
  304. /**
  305. * Clears the field for the given field number.
  306. * @param {number} fieldNumber
  307. */
  308. clearField(fieldNumber) {
  309. this.fields_.delete(fieldNumber);
  310. }
  311. /**
  312. * Returns data for a field specified by the given field number. Also cache
  313. * the data if it doesn't already exist in the cache. When no data is
  314. * available, return the given default value.
  315. * @param {number} fieldNumber
  316. * @param {?T} defaultValue
  317. * @param {function(!Array<!IndexEntry>, !BufferDecoder):T} readFunc
  318. * @param {function(!Writer, number, T)=} encoder
  319. * @return {T}
  320. * @template T
  321. * @private
  322. */
  323. getFieldWithDefault_(
  324. fieldNumber, defaultValue, readFunc, encoder = undefined) {
  325. checkFieldNumber(fieldNumber);
  326. const field = this.fields_.get(fieldNumber);
  327. if (field === undefined) {
  328. return defaultValue;
  329. }
  330. if (field.hasDecodedValue()) {
  331. checkState(!encoder || !!field.getEncoder());
  332. return field.getDecodedValue();
  333. }
  334. const parsed = readFunc(
  335. checkDefAndNotNull(field.getIndexArray()),
  336. checkDefAndNotNull(this.bufferDecoder_));
  337. field.setCache(parsed, encoder);
  338. return parsed;
  339. }
  340. /**
  341. * Sets data for a singular field specified by the given field number.
  342. * @param {number} fieldNumber
  343. * @param {T} value
  344. * @param {function(!Writer, number, T)} encoder
  345. * @return {T}
  346. * @template T
  347. * @private
  348. */
  349. setField_(fieldNumber, value, encoder) {
  350. checkFieldNumber(fieldNumber);
  351. this.fields_.set(fieldNumber, Field.fromDecodedValue(value, encoder));
  352. }
  353. /**
  354. * Serializes internal contents to binary format bytes array to the
  355. * given writer.
  356. * @param {!Writer} writer
  357. * @package
  358. */
  359. serializeToWriter(writer) {
  360. // If we use for...of here, jscompiler returns an array of both types for
  361. // fieldNumber and field without specifying which type is for
  362. // field, which prevents us to use fieldNumber. Thus, we use
  363. // forEach here.
  364. this.fields_.forEach((field, fieldNumber) => {
  365. // If encoder doesn't exist, there is no need to encode the value
  366. // because the data in the index is still valid.
  367. if (field.getEncoder() !== undefined) {
  368. const encoder = checkDefAndNotNull(field.getEncoder());
  369. encoder(writer, fieldNumber, field.getDecodedValue());
  370. return;
  371. }
  372. const indexArr = field.getIndexArray();
  373. if (indexArr) {
  374. for (const indexEntry of indexArr) {
  375. writer.writeTag(fieldNumber, Field.getWireType(indexEntry));
  376. writer.writeBufferDecoder(
  377. checkDefAndNotNull(this.bufferDecoder_),
  378. Field.getStartIndex(indexEntry), Field.getWireType(indexEntry));
  379. }
  380. }
  381. });
  382. }
  383. /**
  384. * Serializes internal contents to binary format bytes array.
  385. * @return {!ArrayBuffer}
  386. */
  387. serialize() {
  388. const writer = new Writer();
  389. this.serializeToWriter(writer);
  390. return writer.getAndResetResultBuffer();
  391. }
  392. /**
  393. * Returns whether data exists at the given field number.
  394. * @param {number} fieldNumber
  395. * @return {boolean}
  396. */
  397. hasFieldNumber(fieldNumber) {
  398. checkFieldNumber(fieldNumber);
  399. const field = this.fields_.get(fieldNumber);
  400. if (field === undefined) {
  401. return false;
  402. }
  403. if (field.getIndexArray() !== null) {
  404. return true;
  405. }
  406. if (Array.isArray(field.getDecodedValue())) {
  407. // For repeated fields, existence is decided by number of elements.
  408. return (/** !Array<?> */ (field.getDecodedValue())).length > 0;
  409. }
  410. return true;
  411. }
  412. /***************************************************************************
  413. * OPTIONAL GETTER METHODS
  414. ***************************************************************************/
  415. /**
  416. * Returns data as boolean for the given field number.
  417. * If no default is given, use false as the default.
  418. * @param {number} fieldNumber
  419. * @param {boolean=} defaultValue
  420. * @return {boolean}
  421. */
  422. getBoolWithDefault(fieldNumber, defaultValue = false) {
  423. return this.getFieldWithDefault_(
  424. fieldNumber, defaultValue,
  425. (indexArray, bytes) =>
  426. readOptional(indexArray, bytes, reader.readBool, WireType.VARINT));
  427. }
  428. /**
  429. * Returns data as a ByteString for the given field number.
  430. * If no default is given, use false as the default.
  431. * @param {number} fieldNumber
  432. * @param {!ByteString=} defaultValue
  433. * @return {!ByteString}
  434. */
  435. getBytesWithDefault(fieldNumber, defaultValue = ByteString.EMPTY) {
  436. return this.getFieldWithDefault_(
  437. fieldNumber, defaultValue,
  438. (indexArray, bytes) => readOptional(
  439. indexArray, bytes, reader.readBytes, WireType.DELIMITED));
  440. }
  441. /**
  442. * Returns a double for the given field number.
  443. * If no default is given uses zero as the default.
  444. * @param {number} fieldNumber
  445. * @param {number=} defaultValue
  446. * @return {number}
  447. */
  448. getDoubleWithDefault(fieldNumber, defaultValue = 0) {
  449. checkTypeDouble(defaultValue);
  450. return this.getFieldWithDefault_(
  451. fieldNumber, defaultValue,
  452. (indexArray, bytes) => readOptional(
  453. indexArray, bytes, reader.readDouble, WireType.FIXED64));
  454. }
  455. /**
  456. * Returns a fixed32 for the given field number.
  457. * If no default is given zero as the default.
  458. * @param {number} fieldNumber
  459. * @param {number=} defaultValue
  460. * @return {number}
  461. */
  462. getFixed32WithDefault(fieldNumber, defaultValue = 0) {
  463. checkTypeUnsignedInt32(defaultValue);
  464. return this.getFieldWithDefault_(
  465. fieldNumber, defaultValue,
  466. (indexArray, bytes) => readOptional(
  467. indexArray, bytes, reader.readFixed32, WireType.FIXED32));
  468. }
  469. /**
  470. * Returns a fixed64 for the given field number.
  471. * Note: Since g.m.Long does not support unsigned int64 values we are going
  472. * the Java route here for now and simply output the number as a signed int64.
  473. * Users can get to individual bits by themselves.
  474. * @param {number} fieldNumber
  475. * @param {!Int64=} defaultValue
  476. * @return {!Int64}
  477. */
  478. getFixed64WithDefault(fieldNumber, defaultValue = Int64.getZero()) {
  479. return this.getSfixed64WithDefault(fieldNumber, defaultValue);
  480. }
  481. /**
  482. * Returns a float for the given field number.
  483. * If no default is given zero as the default.
  484. * @param {number} fieldNumber
  485. * @param {number=} defaultValue
  486. * @return {number}
  487. */
  488. getFloatWithDefault(fieldNumber, defaultValue = 0) {
  489. checkTypeFloat(defaultValue);
  490. return this.getFieldWithDefault_(
  491. fieldNumber, defaultValue,
  492. (indexArray, bytes) => readOptional(
  493. indexArray, bytes, reader.readFloat, WireType.FIXED32));
  494. }
  495. /**
  496. * Returns a int32 for the given field number.
  497. * If no default is given zero as the default.
  498. * @param {number} fieldNumber
  499. * @param {number=} defaultValue
  500. * @return {number}
  501. */
  502. getInt32WithDefault(fieldNumber, defaultValue = 0) {
  503. checkTypeSignedInt32(defaultValue);
  504. return this.getFieldWithDefault_(
  505. fieldNumber, defaultValue,
  506. (indexArray, bytes) =>
  507. readOptional(indexArray, bytes, reader.readInt32, WireType.VARINT));
  508. }
  509. /**
  510. * Returns a int64 for the given field number.
  511. * If no default is given zero as the default.
  512. * @param {number} fieldNumber
  513. * @param {!Int64=} defaultValue
  514. * @return {!Int64}
  515. */
  516. getInt64WithDefault(fieldNumber, defaultValue = Int64.getZero()) {
  517. checkTypeSignedInt64(defaultValue);
  518. return this.getFieldWithDefault_(
  519. fieldNumber, defaultValue,
  520. (indexArray, bytes) =>
  521. readOptional(indexArray, bytes, reader.readInt64, WireType.VARINT));
  522. }
  523. /**
  524. * Returns a sfixed32 for the given field number.
  525. * If no default is given zero as the default.
  526. * @param {number} fieldNumber
  527. * @param {number=} defaultValue
  528. * @return {number}
  529. */
  530. getSfixed32WithDefault(fieldNumber, defaultValue = 0) {
  531. checkTypeSignedInt32(defaultValue);
  532. return this.getFieldWithDefault_(
  533. fieldNumber, defaultValue,
  534. (indexArray, bytes) => readOptional(
  535. indexArray, bytes, reader.readSfixed32, WireType.FIXED32));
  536. }
  537. /**
  538. * Returns a sfixed64 for the given field number.
  539. * If no default is given zero as the default.
  540. * @param {number} fieldNumber
  541. * @param {!Int64=} defaultValue
  542. * @return {!Int64}
  543. */
  544. getSfixed64WithDefault(fieldNumber, defaultValue = Int64.getZero()) {
  545. checkTypeSignedInt64(defaultValue);
  546. return this.getFieldWithDefault_(
  547. fieldNumber, defaultValue,
  548. (indexArray, bytes) => readOptional(
  549. indexArray, bytes, reader.readSfixed64, WireType.FIXED64));
  550. }
  551. /**
  552. * Returns a sint32 for the given field number.
  553. * If no default is given zero as the default.
  554. * @param {number} fieldNumber
  555. * @param {number=} defaultValue
  556. * @return {number}
  557. */
  558. getSint32WithDefault(fieldNumber, defaultValue = 0) {
  559. checkTypeSignedInt32(defaultValue);
  560. return this.getFieldWithDefault_(
  561. fieldNumber, defaultValue,
  562. (indexArray, bytes) => readOptional(
  563. indexArray, bytes, reader.readSint32, WireType.VARINT));
  564. }
  565. /**
  566. * Returns a sint64 for the given field number.
  567. * If no default is given zero as the default.
  568. * @param {number} fieldNumber
  569. * @param {!Int64=} defaultValue
  570. * @return {!Int64}
  571. */
  572. getSint64WithDefault(fieldNumber, defaultValue = Int64.getZero()) {
  573. checkTypeSignedInt64(defaultValue);
  574. return this.getFieldWithDefault_(
  575. fieldNumber, defaultValue,
  576. (indexArray, bytes) => readOptional(
  577. indexArray, bytes, reader.readSint64, WireType.VARINT));
  578. }
  579. /**
  580. * Returns a string for the given field number.
  581. * If no default is given uses empty string as the default.
  582. * @param {number} fieldNumber
  583. * @param {string=} defaultValue
  584. * @return {string}
  585. */
  586. getStringWithDefault(fieldNumber, defaultValue = '') {
  587. return this.getFieldWithDefault_(
  588. fieldNumber, defaultValue,
  589. (indexArray, bytes) => readOptional(
  590. indexArray, bytes, reader.readString, WireType.DELIMITED));
  591. }
  592. /**
  593. * Returns a uint32 for the given field number.
  594. * If no default is given zero as the default.
  595. * @param {number} fieldNumber
  596. * @param {number=} defaultValue
  597. * @return {number}
  598. */
  599. getUint32WithDefault(fieldNumber, defaultValue = 0) {
  600. checkTypeUnsignedInt32(defaultValue);
  601. return this.getFieldWithDefault_(
  602. fieldNumber, defaultValue,
  603. (indexArray, bytes) => readOptional(
  604. indexArray, bytes, reader.readUint32, WireType.VARINT));
  605. }
  606. /**
  607. * Returns a uint64 for the given field number.
  608. * Note: Since g.m.Long does not support unsigned int64 values we are going
  609. * the Java route here for now and simply output the number as a signed int64.
  610. * Users can get to individual bits by themselves.
  611. * @param {number} fieldNumber
  612. * @param {!Int64=} defaultValue
  613. * @return {!Int64}
  614. */
  615. getUint64WithDefault(fieldNumber, defaultValue = Int64.getZero()) {
  616. return this.getInt64WithDefault(fieldNumber, defaultValue);
  617. }
  618. /**
  619. * Returns data as a mutable proto Message for the given field number.
  620. * If no value has been set, return null.
  621. * If hasFieldNumber(fieldNumber) == false before calling, it remains false.
  622. *
  623. * This method should not be used along with getMessage, since calling
  624. * getMessageOrNull after getMessage will not register the encoder.
  625. *
  626. * @param {number} fieldNumber
  627. * @param {function(!Kernel):T} instanceCreator
  628. * @param {number=} pivot
  629. * @return {?T}
  630. * @template T
  631. */
  632. getMessageOrNull(fieldNumber, instanceCreator, pivot = undefined) {
  633. return this.getFieldWithDefault_(
  634. fieldNumber, null,
  635. (indexArray, bytes) =>
  636. readMessage(indexArray, bytes, instanceCreator, pivot),
  637. writeMessage);
  638. }
  639. /**
  640. * Returns data as a mutable proto Message for the given field number.
  641. * If no value has been set previously, creates and attaches an instance.
  642. * Postcondition: hasFieldNumber(fieldNumber) == true.
  643. *
  644. * This method should not be used along with getMessage, since calling
  645. * getMessageAttach after getMessage will not register the encoder.
  646. *
  647. * @param {number} fieldNumber
  648. * @param {function(!Kernel):T} instanceCreator
  649. * @param {number=} pivot
  650. * @return {T}
  651. * @template T
  652. */
  653. getMessageAttach(fieldNumber, instanceCreator, pivot = undefined) {
  654. checkInstanceCreator(instanceCreator);
  655. let instance = this.getMessageOrNull(fieldNumber, instanceCreator, pivot);
  656. if (!instance) {
  657. instance = instanceCreator(Kernel.createEmpty());
  658. this.setField_(fieldNumber, instance, writeMessage);
  659. }
  660. return instance;
  661. }
  662. /**
  663. * Returns data as a proto Message for the given field number.
  664. * If no value has been set, return a default instance.
  665. * This default instance is guaranteed to be the same instance, unless this
  666. * field is cleared.
  667. * Does not register the encoder, so changes made to the returned
  668. * sub-message will not be included when serializing the parent message.
  669. * Use getMessageAttach() if the resulting sub-message should be mutable.
  670. *
  671. * This method should not be used along with getMessageOrNull or
  672. * getMessageAttach, since these methods register the encoder.
  673. *
  674. * @param {number} fieldNumber
  675. * @param {function(!Kernel):T} instanceCreator
  676. * @param {number=} pivot
  677. * @return {T}
  678. * @template T
  679. */
  680. getMessage(fieldNumber, instanceCreator, pivot = undefined) {
  681. checkInstanceCreator(instanceCreator);
  682. const message = this.getFieldWithDefault_(
  683. fieldNumber, null,
  684. (indexArray, bytes) =>
  685. readMessage(indexArray, bytes, instanceCreator, pivot));
  686. // Returns an empty message as the default value if the field doesn't exist.
  687. // We don't pass the default value to getFieldWithDefault_ to reduce object
  688. // allocation.
  689. return message === null ? instanceCreator(Kernel.createEmpty()) : message;
  690. }
  691. /**
  692. * Returns the accessor for the given singular message, or returns null if
  693. * it hasn't been set.
  694. * @param {number} fieldNumber
  695. * @param {number=} pivot
  696. * @return {?Kernel}
  697. */
  698. getMessageAccessorOrNull(fieldNumber, pivot = undefined) {
  699. checkFieldNumber(fieldNumber);
  700. const field = this.fields_.get(fieldNumber);
  701. if (field === undefined) {
  702. return null;
  703. }
  704. if (field.hasDecodedValue()) {
  705. return checkIsInternalMessage(field.getDecodedValue())
  706. .internalGetKernel();
  707. } else {
  708. return readAccessor(
  709. checkDefAndNotNull(field.getIndexArray()),
  710. checkDefAndNotNull(this.bufferDecoder_), pivot);
  711. }
  712. }
  713. /***************************************************************************
  714. * REPEATED GETTER METHODS
  715. ***************************************************************************/
  716. /* Bool */
  717. /**
  718. * Returns an Array instance containing boolean values for the given field
  719. * number.
  720. * @param {number} fieldNumber
  721. * @return {!Array<boolean>}
  722. * @private
  723. */
  724. getRepeatedBoolArray_(fieldNumber) {
  725. return this.getFieldWithDefault_(
  726. fieldNumber, /* defaultValue= */[],
  727. (indexArray, bytes) => readRepeatedPrimitive(
  728. indexArray, bytes, reader.readBool, reader.readPackedBool,
  729. WireType.VARINT));
  730. }
  731. /**
  732. * Returns the element at index for the given field number.
  733. * @param {number} fieldNumber
  734. * @param {number} index
  735. * @return {boolean}
  736. */
  737. getRepeatedBoolElement(fieldNumber, index) {
  738. const array = this.getRepeatedBoolArray_(fieldNumber);
  739. checkCriticalElementIndex(index, array.length);
  740. return array[index];
  741. }
  742. /**
  743. * Returns an Iterable instance containing boolean values for the given field
  744. * number.
  745. * @param {number} fieldNumber
  746. * @return {!Iterable<boolean>}
  747. */
  748. getRepeatedBoolIterable(fieldNumber) {
  749. // Don't split this statement unless needed. JS compiler thinks
  750. // getRepeatedBoolArray_ might have side effects and doesn't inline the
  751. // call in the compiled code. See cl/293894484 for details.
  752. return new ArrayIterable(this.getRepeatedBoolArray_(fieldNumber));
  753. }
  754. /**
  755. * Returns the size of the repeated field.
  756. * @param {number} fieldNumber
  757. * @return {number}
  758. */
  759. getRepeatedBoolSize(fieldNumber) {
  760. return this.getRepeatedBoolArray_(fieldNumber).length;
  761. }
  762. /* Double */
  763. /**
  764. * Returns an Array instance containing double values for the given field
  765. * number.
  766. * @param {number} fieldNumber
  767. * @return {!Array<number>}
  768. * @private
  769. */
  770. getRepeatedDoubleArray_(fieldNumber) {
  771. return this.getFieldWithDefault_(
  772. fieldNumber, /* defaultValue= */[],
  773. (indexArray, bytes) => readRepeatedPrimitive(
  774. indexArray, bytes, reader.readDouble, reader.readPackedDouble,
  775. WireType.FIXED64));
  776. }
  777. /**
  778. * Returns the element at index for the given field number.
  779. * @param {number} fieldNumber
  780. * @param {number} index
  781. * @return {number}
  782. */
  783. getRepeatedDoubleElement(fieldNumber, index) {
  784. const array = this.getRepeatedDoubleArray_(fieldNumber);
  785. checkCriticalElementIndex(index, array.length);
  786. return array[index];
  787. }
  788. /**
  789. * Returns an Iterable instance containing double values for the given field
  790. * number.
  791. * @param {number} fieldNumber
  792. * @return {!Iterable<number>}
  793. */
  794. getRepeatedDoubleIterable(fieldNumber) {
  795. // Don't split this statement unless needed. JS compiler thinks
  796. // getRepeatedDoubleArray_ might have side effects and doesn't inline the
  797. // call in the compiled code. See cl/293894484 for details.
  798. return new ArrayIterable(this.getRepeatedDoubleArray_(fieldNumber));
  799. }
  800. /**
  801. * Returns the size of the repeated field.
  802. * @param {number} fieldNumber
  803. * @return {number}
  804. */
  805. getRepeatedDoubleSize(fieldNumber) {
  806. return this.getRepeatedDoubleArray_(fieldNumber).length;
  807. }
  808. /* Fixed32 */
  809. /**
  810. * Returns an Array instance containing fixed32 values for the given field
  811. * number.
  812. * @param {number} fieldNumber
  813. * @return {!Array<number>}
  814. * @private
  815. */
  816. getRepeatedFixed32Array_(fieldNumber) {
  817. return this.getFieldWithDefault_(
  818. fieldNumber, /* defaultValue= */[],
  819. (indexArray, bytes) => readRepeatedPrimitive(
  820. indexArray, bytes, reader.readFixed32, reader.readPackedFixed32,
  821. WireType.FIXED32));
  822. }
  823. /**
  824. * Returns the element at index for the given field number.
  825. * @param {number} fieldNumber
  826. * @param {number} index
  827. * @return {number}
  828. */
  829. getRepeatedFixed32Element(fieldNumber, index) {
  830. const array = this.getRepeatedFixed32Array_(fieldNumber);
  831. checkCriticalElementIndex(index, array.length);
  832. return array[index];
  833. }
  834. /**
  835. * Returns an Iterable instance containing fixed32 values for the given field
  836. * number.
  837. * @param {number} fieldNumber
  838. * @return {!Iterable<number>}
  839. */
  840. getRepeatedFixed32Iterable(fieldNumber) {
  841. // Don't split this statement unless needed. JS compiler thinks
  842. // getRepeatedFixed32Array_ might have side effects and doesn't inline the
  843. // call in the compiled code. See cl/293894484 for details.
  844. return new ArrayIterable(this.getRepeatedFixed32Array_(fieldNumber));
  845. }
  846. /**
  847. * Returns the size of the repeated field.
  848. * @param {number} fieldNumber
  849. * @return {number}
  850. */
  851. getRepeatedFixed32Size(fieldNumber) {
  852. return this.getRepeatedFixed32Array_(fieldNumber).length;
  853. }
  854. /* Fixed64 */
  855. /**
  856. * Returns the element at index for the given field number.
  857. * @param {number} fieldNumber
  858. * @param {number} index
  859. * @return {!Int64}
  860. */
  861. getRepeatedFixed64Element(fieldNumber, index) {
  862. return this.getRepeatedSfixed64Element(fieldNumber, index);
  863. }
  864. /**
  865. * Returns an Iterable instance containing fixed64 values for the given field
  866. * number.
  867. * @param {number} fieldNumber
  868. * @return {!Iterable<!Int64>}
  869. */
  870. getRepeatedFixed64Iterable(fieldNumber) {
  871. return this.getRepeatedSfixed64Iterable(fieldNumber);
  872. }
  873. /**
  874. * Returns the size of the repeated field.
  875. * @param {number} fieldNumber
  876. * @return {number}
  877. */
  878. getRepeatedFixed64Size(fieldNumber) {
  879. return this.getRepeatedSfixed64Size(fieldNumber);
  880. }
  881. /* Float */
  882. /**
  883. * Returns an Array instance containing float values for the given field
  884. * number.
  885. * @param {number} fieldNumber
  886. * @return {!Array<number>}
  887. * @private
  888. */
  889. getRepeatedFloatArray_(fieldNumber) {
  890. return this.getFieldWithDefault_(
  891. fieldNumber, /* defaultValue= */[],
  892. (indexArray, bytes) => readRepeatedPrimitive(
  893. indexArray, bytes, reader.readFloat, reader.readPackedFloat,
  894. WireType.FIXED32));
  895. }
  896. /**
  897. * Returns the element at index for the given field number.
  898. * @param {number} fieldNumber
  899. * @param {number} index
  900. * @return {number}
  901. */
  902. getRepeatedFloatElement(fieldNumber, index) {
  903. const array = this.getRepeatedFloatArray_(fieldNumber);
  904. checkCriticalElementIndex(index, array.length);
  905. return array[index];
  906. }
  907. /**
  908. * Returns an Iterable instance containing float values for the given field
  909. * number.
  910. * @param {number} fieldNumber
  911. * @return {!Iterable<number>}
  912. */
  913. getRepeatedFloatIterable(fieldNumber) {
  914. // Don't split this statement unless needed. JS compiler thinks
  915. // getRepeatedFloatArray_ might have side effects and doesn't inline the
  916. // call in the compiled code. See cl/293894484 for details.
  917. return new ArrayIterable(this.getRepeatedFloatArray_(fieldNumber));
  918. }
  919. /**
  920. * Returns the size of the repeated field.
  921. * @param {number} fieldNumber
  922. * @return {number}
  923. */
  924. getRepeatedFloatSize(fieldNumber) {
  925. return this.getRepeatedFloatArray_(fieldNumber).length;
  926. }
  927. /* Int32 */
  928. /**
  929. * Returns an Array instance containing int32 values for the given field
  930. * number.
  931. * @param {number} fieldNumber
  932. * @return {!Array<number>}
  933. * @private
  934. */
  935. getRepeatedInt32Array_(fieldNumber) {
  936. return this.getFieldWithDefault_(
  937. fieldNumber, /* defaultValue= */[],
  938. (indexArray, bytes) => readRepeatedPrimitive(
  939. indexArray, bytes, reader.readInt32, reader.readPackedInt32,
  940. WireType.VARINT));
  941. }
  942. /**
  943. * Returns the element at index for the given field number.
  944. * @param {number} fieldNumber
  945. * @param {number} index
  946. * @return {number}
  947. */
  948. getRepeatedInt32Element(fieldNumber, index) {
  949. const array = this.getRepeatedInt32Array_(fieldNumber);
  950. checkCriticalElementIndex(index, array.length);
  951. return array[index];
  952. }
  953. /**
  954. * Returns an Iterable instance containing int32 values for the given field
  955. * number.
  956. * @param {number} fieldNumber
  957. * @return {!Iterable<number>}
  958. */
  959. getRepeatedInt32Iterable(fieldNumber) {
  960. // Don't split this statement unless needed. JS compiler thinks
  961. // getRepeatedInt32Array_ might have side effects and doesn't inline the
  962. // call in the compiled code. See cl/293894484 for details.
  963. return new ArrayIterable(this.getRepeatedInt32Array_(fieldNumber));
  964. }
  965. /**
  966. * Returns the size of the repeated field.
  967. * @param {number} fieldNumber
  968. * @return {number}
  969. */
  970. getRepeatedInt32Size(fieldNumber) {
  971. return this.getRepeatedInt32Array_(fieldNumber).length;
  972. }
  973. /* Int64 */
  974. /**
  975. * Returns an Array instance containing int64 values for the given field
  976. * number.
  977. * @param {number} fieldNumber
  978. * @return {!Array<!Int64>}
  979. * @private
  980. */
  981. getRepeatedInt64Array_(fieldNumber) {
  982. return this.getFieldWithDefault_(
  983. fieldNumber, /* defaultValue= */[],
  984. (indexArray, bytes) => readRepeatedPrimitive(
  985. indexArray, bytes, reader.readInt64, reader.readPackedInt64,
  986. WireType.VARINT));
  987. }
  988. /**
  989. * Returns the element at index for the given field number.
  990. * @param {number} fieldNumber
  991. * @param {number} index
  992. * @return {!Int64}
  993. */
  994. getRepeatedInt64Element(fieldNumber, index) {
  995. const array = this.getRepeatedInt64Array_(fieldNumber);
  996. checkCriticalElementIndex(index, array.length);
  997. return array[index];
  998. }
  999. /**
  1000. * Returns an Iterable instance containing int64 values for the given field
  1001. * number.
  1002. * @param {number} fieldNumber
  1003. * @return {!Iterable<!Int64>}
  1004. */
  1005. getRepeatedInt64Iterable(fieldNumber) {
  1006. // Don't split this statement unless needed. JS compiler thinks
  1007. // getRepeatedInt64Array_ might have side effects and doesn't inline the
  1008. // call in the compiled code. See cl/293894484 for details.
  1009. return new ArrayIterable(this.getRepeatedInt64Array_(fieldNumber));
  1010. }
  1011. /**
  1012. * Returns the size of the repeated field.
  1013. * @param {number} fieldNumber
  1014. * @return {number}
  1015. */
  1016. getRepeatedInt64Size(fieldNumber) {
  1017. return this.getRepeatedInt64Array_(fieldNumber).length;
  1018. }
  1019. /* Sfixed32 */
  1020. /**
  1021. * Returns an Array instance containing sfixed32 values for the given field
  1022. * number.
  1023. * @param {number} fieldNumber
  1024. * @return {!Array<number>}
  1025. * @private
  1026. */
  1027. getRepeatedSfixed32Array_(fieldNumber) {
  1028. return this.getFieldWithDefault_(
  1029. fieldNumber, /* defaultValue= */[],
  1030. (indexArray, bytes) => readRepeatedPrimitive(
  1031. indexArray, bytes, reader.readSfixed32, reader.readPackedSfixed32,
  1032. WireType.FIXED32));
  1033. }
  1034. /**
  1035. * Returns the element at index for the given field number.
  1036. * @param {number} fieldNumber
  1037. * @param {number} index
  1038. * @return {number}
  1039. */
  1040. getRepeatedSfixed32Element(fieldNumber, index) {
  1041. const array = this.getRepeatedSfixed32Array_(fieldNumber);
  1042. checkCriticalElementIndex(index, array.length);
  1043. return array[index];
  1044. }
  1045. /**
  1046. * Returns an Iterable instance containing sfixed32 values for the given field
  1047. * number.
  1048. * @param {number} fieldNumber
  1049. * @return {!Iterable<number>}
  1050. */
  1051. getRepeatedSfixed32Iterable(fieldNumber) {
  1052. // Don't split this statement unless needed. JS compiler thinks
  1053. // getRepeatedSfixed32Array_ might have side effects and doesn't inline the
  1054. // call in the compiled code. See cl/293894484 for details.
  1055. return new ArrayIterable(this.getRepeatedSfixed32Array_(fieldNumber));
  1056. }
  1057. /**
  1058. * Returns the size of the repeated field.
  1059. * @param {number} fieldNumber
  1060. * @return {number}
  1061. */
  1062. getRepeatedSfixed32Size(fieldNumber) {
  1063. return this.getRepeatedSfixed32Array_(fieldNumber).length;
  1064. }
  1065. /* Sfixed64 */
  1066. /**
  1067. * Returns an Array instance containing sfixed64 values for the given field
  1068. * number.
  1069. * @param {number} fieldNumber
  1070. * @return {!Array<!Int64>}
  1071. * @private
  1072. */
  1073. getRepeatedSfixed64Array_(fieldNumber) {
  1074. return this.getFieldWithDefault_(
  1075. fieldNumber, /* defaultValue= */[],
  1076. (indexArray, bytes) => readRepeatedPrimitive(
  1077. indexArray, bytes, reader.readSfixed64, reader.readPackedSfixed64,
  1078. WireType.FIXED64));
  1079. }
  1080. /**
  1081. * Returns the element at index for the given field number.
  1082. * @param {number} fieldNumber
  1083. * @param {number} index
  1084. * @return {!Int64}
  1085. */
  1086. getRepeatedSfixed64Element(fieldNumber, index) {
  1087. const array = this.getRepeatedSfixed64Array_(fieldNumber);
  1088. checkCriticalElementIndex(index, array.length);
  1089. return array[index];
  1090. }
  1091. /**
  1092. * Returns an Iterable instance containing sfixed64 values for the given field
  1093. * number.
  1094. * @param {number} fieldNumber
  1095. * @return {!Iterable<!Int64>}
  1096. */
  1097. getRepeatedSfixed64Iterable(fieldNumber) {
  1098. // Don't split this statement unless needed. JS compiler thinks
  1099. // getRepeatedSfixed64Array_ might have side effects and doesn't inline the
  1100. // call in the compiled code. See cl/293894484 for details.
  1101. return new ArrayIterable(this.getRepeatedSfixed64Array_(fieldNumber));
  1102. }
  1103. /**
  1104. * Returns the size of the repeated field.
  1105. * @param {number} fieldNumber
  1106. * @return {number}
  1107. */
  1108. getRepeatedSfixed64Size(fieldNumber) {
  1109. return this.getRepeatedSfixed64Array_(fieldNumber).length;
  1110. }
  1111. /* Sint32 */
  1112. /**
  1113. * Returns an Array instance containing sint32 values for the given field
  1114. * number.
  1115. * @param {number} fieldNumber
  1116. * @return {!Array<number>}
  1117. * @private
  1118. */
  1119. getRepeatedSint32Array_(fieldNumber) {
  1120. return this.getFieldWithDefault_(
  1121. fieldNumber, /* defaultValue= */[],
  1122. (indexArray, bytes) => readRepeatedPrimitive(
  1123. indexArray, bytes, reader.readSint32, reader.readPackedSint32,
  1124. WireType.VARINT));
  1125. }
  1126. /**
  1127. * Returns the element at index for the given field number.
  1128. * @param {number} fieldNumber
  1129. * @param {number} index
  1130. * @return {number}
  1131. */
  1132. getRepeatedSint32Element(fieldNumber, index) {
  1133. const array = this.getRepeatedSint32Array_(fieldNumber);
  1134. checkCriticalElementIndex(index, array.length);
  1135. return array[index];
  1136. }
  1137. /**
  1138. * Returns an Iterable instance containing sint32 values for the given field
  1139. * number.
  1140. * @param {number} fieldNumber
  1141. * @return {!Iterable<number>}
  1142. */
  1143. getRepeatedSint32Iterable(fieldNumber) {
  1144. // Don't split this statement unless needed. JS compiler thinks
  1145. // getRepeatedSint32Array_ might have side effects and doesn't inline the
  1146. // call in the compiled code. See cl/293894484 for details.
  1147. return new ArrayIterable(this.getRepeatedSint32Array_(fieldNumber));
  1148. }
  1149. /**
  1150. * Returns the size of the repeated field.
  1151. * @param {number} fieldNumber
  1152. * @return {number}
  1153. */
  1154. getRepeatedSint32Size(fieldNumber) {
  1155. return this.getRepeatedSint32Array_(fieldNumber).length;
  1156. }
  1157. /* Sint64 */
  1158. /**
  1159. * Returns an Array instance containing sint64 values for the given field
  1160. * number.
  1161. * @param {number} fieldNumber
  1162. * @return {!Array<!Int64>}
  1163. * @private
  1164. */
  1165. getRepeatedSint64Array_(fieldNumber) {
  1166. return this.getFieldWithDefault_(
  1167. fieldNumber, /* defaultValue= */[],
  1168. (indexArray, bytes) => readRepeatedPrimitive(
  1169. indexArray, bytes, reader.readSint64, reader.readPackedSint64,
  1170. WireType.VARINT));
  1171. }
  1172. /**
  1173. * Returns the element at index for the given field number.
  1174. * @param {number} fieldNumber
  1175. * @param {number} index
  1176. * @return {!Int64}
  1177. */
  1178. getRepeatedSint64Element(fieldNumber, index) {
  1179. const array = this.getRepeatedSint64Array_(fieldNumber);
  1180. checkCriticalElementIndex(index, array.length);
  1181. return array[index];
  1182. }
  1183. /**
  1184. * Returns an Iterable instance containing sint64 values for the given field
  1185. * number.
  1186. * @param {number} fieldNumber
  1187. * @return {!Iterable<!Int64>}
  1188. */
  1189. getRepeatedSint64Iterable(fieldNumber) {
  1190. // Don't split this statement unless needed. JS compiler thinks
  1191. // getRepeatedSint64Array_ might have side effects and doesn't inline the
  1192. // call in the compiled code. See cl/293894484 for details.
  1193. return new ArrayIterable(this.getRepeatedSint64Array_(fieldNumber));
  1194. }
  1195. /**
  1196. * Returns the size of the repeated field.
  1197. * @param {number} fieldNumber
  1198. * @return {number}
  1199. */
  1200. getRepeatedSint64Size(fieldNumber) {
  1201. return this.getRepeatedSint64Array_(fieldNumber).length;
  1202. }
  1203. /* Uint32 */
  1204. /**
  1205. * Returns an Array instance containing uint32 values for the given field
  1206. * number.
  1207. * @param {number} fieldNumber
  1208. * @return {!Array<number>}
  1209. * @private
  1210. */
  1211. getRepeatedUint32Array_(fieldNumber) {
  1212. return this.getFieldWithDefault_(
  1213. fieldNumber, /* defaultValue= */[],
  1214. (indexArray, bytes) => readRepeatedPrimitive(
  1215. indexArray, bytes, reader.readUint32, reader.readPackedUint32,
  1216. WireType.VARINT));
  1217. }
  1218. /**
  1219. * Returns the element at index for the given field number.
  1220. * @param {number} fieldNumber
  1221. * @param {number} index
  1222. * @return {number}
  1223. */
  1224. getRepeatedUint32Element(fieldNumber, index) {
  1225. const array = this.getRepeatedUint32Array_(fieldNumber);
  1226. checkCriticalElementIndex(index, array.length);
  1227. return array[index];
  1228. }
  1229. /**
  1230. * Returns an Iterable instance containing uint32 values for the given field
  1231. * number.
  1232. * @param {number} fieldNumber
  1233. * @return {!Iterable<number>}
  1234. */
  1235. getRepeatedUint32Iterable(fieldNumber) {
  1236. // Don't split this statement unless needed. JS compiler thinks
  1237. // getRepeatedUint32Array_ might have side effects and doesn't inline the
  1238. // call in the compiled code. See cl/293894484 for details.
  1239. return new ArrayIterable(this.getRepeatedUint32Array_(fieldNumber));
  1240. }
  1241. /**
  1242. * Returns the size of the repeated field.
  1243. * @param {number} fieldNumber
  1244. * @return {number}
  1245. */
  1246. getRepeatedUint32Size(fieldNumber) {
  1247. return this.getRepeatedUint32Array_(fieldNumber).length;
  1248. }
  1249. /* Uint64 */
  1250. /**
  1251. * Returns the element at index for the given field number.
  1252. * @param {number} fieldNumber
  1253. * @param {number} index
  1254. * @return {!Int64}
  1255. */
  1256. getRepeatedUint64Element(fieldNumber, index) {
  1257. return this.getRepeatedInt64Element(fieldNumber, index);
  1258. }
  1259. /**
  1260. * Returns an Iterable instance containing uint64 values for the given field
  1261. * number.
  1262. * @param {number} fieldNumber
  1263. * @return {!Iterable<!Int64>}
  1264. */
  1265. getRepeatedUint64Iterable(fieldNumber) {
  1266. return this.getRepeatedInt64Iterable(fieldNumber);
  1267. }
  1268. /**
  1269. * Returns the size of the repeated field.
  1270. * @param {number} fieldNumber
  1271. * @return {number}
  1272. */
  1273. getRepeatedUint64Size(fieldNumber) {
  1274. return this.getRepeatedInt64Size(fieldNumber);
  1275. }
  1276. /* Bytes */
  1277. /**
  1278. * Returns an array instance containing bytes values for the given field
  1279. * number.
  1280. * @param {number} fieldNumber
  1281. * @return {!Array<!ByteString>}
  1282. * @private
  1283. */
  1284. getRepeatedBytesArray_(fieldNumber) {
  1285. return this.getFieldWithDefault_(
  1286. fieldNumber, /* defaultValue= */[],
  1287. (indexArray, bytes) =>
  1288. readRepeatedNonPrimitive(indexArray, bytes, reader.readBytes));
  1289. }
  1290. /**
  1291. * Returns the element at index for the given field number as a bytes.
  1292. * @param {number} fieldNumber
  1293. * @param {number} index
  1294. * @return {!ByteString}
  1295. */
  1296. getRepeatedBytesElement(fieldNumber, index) {
  1297. const array = this.getRepeatedBytesArray_(fieldNumber);
  1298. checkCriticalElementIndex(index, array.length);
  1299. return array[index];
  1300. }
  1301. /**
  1302. * Returns an Iterable instance containing bytes values for the given field
  1303. * number.
  1304. * @param {number} fieldNumber
  1305. * @return {!Iterable<!ByteString>}
  1306. */
  1307. getRepeatedBytesIterable(fieldNumber) {
  1308. // Don't split this statement unless needed. JS compiler thinks
  1309. // getRepeatedBytesArray_ might have side effects and doesn't inline the
  1310. // call in the compiled code. See cl/293894484 for details.
  1311. return new ArrayIterable(this.getRepeatedBytesArray_(fieldNumber));
  1312. }
  1313. /**
  1314. * Returns the size of the repeated field.
  1315. * @param {number} fieldNumber
  1316. * @return {number}
  1317. */
  1318. getRepeatedBytesSize(fieldNumber) {
  1319. return this.getRepeatedBytesArray_(fieldNumber).length;
  1320. }
  1321. /* String */
  1322. /**
  1323. * Returns an array instance containing string values for the given field
  1324. * number.
  1325. * @param {number} fieldNumber
  1326. * @return {!Array<string>}
  1327. * @private
  1328. */
  1329. getRepeatedStringArray_(fieldNumber) {
  1330. return this.getFieldWithDefault_(
  1331. fieldNumber, /* defaultValue= */[],
  1332. (indexArray, bufferDecoder) => readRepeatedNonPrimitive(
  1333. indexArray, bufferDecoder, reader.readString));
  1334. }
  1335. /**
  1336. * Returns the element at index for the given field number as a string.
  1337. * @param {number} fieldNumber
  1338. * @param {number} index
  1339. * @return {string}
  1340. */
  1341. getRepeatedStringElement(fieldNumber, index) {
  1342. const array = this.getRepeatedStringArray_(fieldNumber);
  1343. checkCriticalElementIndex(index, array.length);
  1344. return array[index];
  1345. }
  1346. /**
  1347. * Returns an Iterable instance containing string values for the given field
  1348. * number.
  1349. * @param {number} fieldNumber
  1350. * @return {!Iterable<string>}
  1351. */
  1352. getRepeatedStringIterable(fieldNumber) {
  1353. // Don't split this statement unless needed. JS compiler thinks
  1354. // getRepeatedStringArray_ might have side effects and doesn't inline the
  1355. // call in the compiled code. See cl/293894484 for details.
  1356. return new ArrayIterable(this.getRepeatedStringArray_(fieldNumber));
  1357. }
  1358. /**
  1359. * Returns the size of the repeated field.
  1360. * @param {number} fieldNumber
  1361. * @return {number}
  1362. */
  1363. getRepeatedStringSize(fieldNumber) {
  1364. return this.getRepeatedStringArray_(fieldNumber).length;
  1365. }
  1366. /* Message */
  1367. /**
  1368. * Returns an Array instance containing boolean values for the given field
  1369. * number.
  1370. * @param {number} fieldNumber
  1371. * @param {function(!Kernel):T} instanceCreator
  1372. * @param {number|undefined} pivot
  1373. * @return {!Array<T>}
  1374. * @template T
  1375. * @private
  1376. */
  1377. getRepeatedMessageArray_(fieldNumber, instanceCreator, pivot) {
  1378. // This method can be shortened using getFieldWithDefault and
  1379. // getRepeatedNonPrimitive methods. But that will require creating and
  1380. // passing a reader closure every time getRepeatedMessageArray_ is called,
  1381. // which is expensive.
  1382. checkInstanceCreator(instanceCreator);
  1383. checkFieldNumber(fieldNumber);
  1384. const field = this.fields_.get(fieldNumber);
  1385. if (field === undefined) {
  1386. return [];
  1387. }
  1388. if (field.hasDecodedValue()) {
  1389. return field.getDecodedValue();
  1390. }
  1391. const indexArray = checkDefAndNotNull(field.getIndexArray());
  1392. const result = new Array(indexArray.length);
  1393. for (let i = 0; i < indexArray.length; i++) {
  1394. validateWireType(indexArray[i], WireType.DELIMITED);
  1395. const subMessageBuffer = reader.readDelimited(
  1396. checkDefAndNotNull(this.bufferDecoder_),
  1397. Field.getStartIndex(indexArray[i]));
  1398. result[i] =
  1399. instanceCreator(Kernel.fromBufferDecoder_(subMessageBuffer, pivot));
  1400. }
  1401. field.setCache(result, writeRepeatedMessage);
  1402. return result;
  1403. }
  1404. /**
  1405. * Returns the element at index for the given field number as a message.
  1406. * @param {number} fieldNumber
  1407. * @param {function(!Kernel):T} instanceCreator
  1408. * @param {number} index
  1409. * @param {number=} pivot
  1410. * @return {T}
  1411. * @template T
  1412. */
  1413. getRepeatedMessageElement(
  1414. fieldNumber, instanceCreator, index, pivot = undefined) {
  1415. const array =
  1416. this.getRepeatedMessageArray_(fieldNumber, instanceCreator, pivot);
  1417. checkCriticalElementIndex(index, array.length);
  1418. return array[index];
  1419. }
  1420. /**
  1421. * Returns an Iterable instance containing message values for the given field
  1422. * number.
  1423. * @param {number} fieldNumber
  1424. * @param {function(!Kernel):T} instanceCreator
  1425. * @param {number=} pivot
  1426. * @return {!Iterable<T>}
  1427. * @template T
  1428. */
  1429. getRepeatedMessageIterable(fieldNumber, instanceCreator, pivot = undefined) {
  1430. // Don't split this statement unless needed. JS compiler thinks
  1431. // getRepeatedMessageArray_ might have side effects and doesn't inline the
  1432. // call in the compiled code. See cl/293894484 for details.
  1433. return new ArrayIterable(
  1434. this.getRepeatedMessageArray_(fieldNumber, instanceCreator, pivot));
  1435. }
  1436. /**
  1437. * Returns an Iterable instance containing message accessors for the given
  1438. * field number.
  1439. * @param {number} fieldNumber
  1440. * @param {number=} pivot
  1441. * @return {!Iterable<!Kernel>}
  1442. */
  1443. getRepeatedMessageAccessorIterable(fieldNumber, pivot = undefined) {
  1444. checkFieldNumber(fieldNumber);
  1445. const field = this.fields_.get(fieldNumber);
  1446. if (!field) {
  1447. return [];
  1448. }
  1449. if (field.hasDecodedValue()) {
  1450. return new ArrayIterable(field.getDecodedValue().map(
  1451. value => checkIsInternalMessage(value).internalGetKernel()));
  1452. }
  1453. const readMessageFunc = (bufferDecoder, start) => Kernel.fromBufferDecoder_(
  1454. reader.readDelimited(bufferDecoder, start), pivot);
  1455. const array = readRepeatedNonPrimitive(
  1456. checkDefAndNotNull(field.getIndexArray()),
  1457. checkDefAndNotNull(this.bufferDecoder_), readMessageFunc);
  1458. return new ArrayIterable(array);
  1459. }
  1460. /**
  1461. * Returns the size of the repeated field.
  1462. * @param {number} fieldNumber
  1463. * @param {function(!Kernel):T} instanceCreator
  1464. * @return {number}
  1465. * @param {number=} pivot
  1466. * @template T
  1467. */
  1468. getRepeatedMessageSize(fieldNumber, instanceCreator, pivot = undefined) {
  1469. return this.getRepeatedMessageArray_(fieldNumber, instanceCreator, pivot)
  1470. .length;
  1471. }
  1472. /***************************************************************************
  1473. * OPTIONAL SETTER METHODS
  1474. ***************************************************************************/
  1475. /**
  1476. * Sets a boolean value to the field with the given field number.
  1477. * @param {number} fieldNumber
  1478. * @param {boolean} value
  1479. */
  1480. setBool(fieldNumber, value) {
  1481. checkCriticalTypeBool(value);
  1482. this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
  1483. writer.writeBool(fieldNumber, value);
  1484. });
  1485. }
  1486. /**
  1487. * Sets a boolean value to the field with the given field number.
  1488. * @param {number} fieldNumber
  1489. * @param {!ByteString} value
  1490. */
  1491. setBytes(fieldNumber, value) {
  1492. checkCriticalTypeByteString(value);
  1493. this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
  1494. writer.writeBytes(fieldNumber, value);
  1495. });
  1496. }
  1497. /**
  1498. * Sets a double value to the field with the given field number.
  1499. * @param {number} fieldNumber
  1500. * @param {number} value
  1501. */
  1502. setDouble(fieldNumber, value) {
  1503. checkCriticalTypeDouble(value);
  1504. this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
  1505. writer.writeDouble(fieldNumber, value);
  1506. });
  1507. }
  1508. /**
  1509. * Sets a fixed32 value to the field with the given field number.
  1510. * @param {number} fieldNumber
  1511. * @param {number} value
  1512. */
  1513. setFixed32(fieldNumber, value) {
  1514. checkCriticalTypeUnsignedInt32(value);
  1515. this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
  1516. writer.writeFixed32(fieldNumber, value);
  1517. });
  1518. }
  1519. /**
  1520. * Sets a uint64 value to the field with the given field number.\
  1521. * Note: Since g.m.Long does not support unsigned int64 values we are going
  1522. * the Java route here for now and simply output the number as a signed int64.
  1523. * Users can get to individual bits by themselves.
  1524. * @param {number} fieldNumber
  1525. * @param {!Int64} value
  1526. */
  1527. setFixed64(fieldNumber, value) {
  1528. this.setSfixed64(fieldNumber, value);
  1529. }
  1530. /**
  1531. * Sets a float value to the field with the given field number.
  1532. * @param {number} fieldNumber
  1533. * @param {number} value
  1534. */
  1535. setFloat(fieldNumber, value) {
  1536. checkCriticalTypeFloat(value);
  1537. // Eagerly round to 32-bit precision so that reading back after set will
  1538. // yield the same value a reader will receive after serialization.
  1539. const floatValue = Math.fround(value);
  1540. this.setField_(fieldNumber, floatValue, (writer, fieldNumber, value) => {
  1541. writer.writeFloat(fieldNumber, value);
  1542. });
  1543. }
  1544. /**
  1545. * Sets a int32 value to the field with the given field number.
  1546. * @param {number} fieldNumber
  1547. * @param {number} value
  1548. */
  1549. setInt32(fieldNumber, value) {
  1550. checkCriticalTypeSignedInt32(value);
  1551. this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
  1552. writer.writeInt32(fieldNumber, value);
  1553. });
  1554. }
  1555. /**
  1556. * Sets a int64 value to the field with the given field number.
  1557. * @param {number} fieldNumber
  1558. * @param {!Int64} value
  1559. */
  1560. setInt64(fieldNumber, value) {
  1561. checkCriticalTypeSignedInt64(value);
  1562. this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
  1563. writer.writeInt64(fieldNumber, value);
  1564. });
  1565. }
  1566. /**
  1567. * Sets a sfixed32 value to the field with the given field number.
  1568. * @param {number} fieldNumber
  1569. * @param {number} value
  1570. */
  1571. setSfixed32(fieldNumber, value) {
  1572. checkCriticalTypeSignedInt32(value);
  1573. this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
  1574. writer.writeSfixed32(fieldNumber, value);
  1575. });
  1576. }
  1577. /**
  1578. * Sets a sfixed64 value to the field with the given field number.
  1579. * @param {number} fieldNumber
  1580. * @param {!Int64} value
  1581. */
  1582. setSfixed64(fieldNumber, value) {
  1583. checkCriticalTypeSignedInt64(value);
  1584. this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
  1585. writer.writeSfixed64(fieldNumber, value);
  1586. });
  1587. }
  1588. /**
  1589. * Sets a sint32 value to the field with the given field number.
  1590. * @param {number} fieldNumber
  1591. * @param {number} value
  1592. */
  1593. setSint32(fieldNumber, value) {
  1594. checkCriticalTypeSignedInt32(value);
  1595. this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
  1596. writer.writeSint32(fieldNumber, value);
  1597. });
  1598. }
  1599. /**
  1600. * Sets a sint64 value to the field with the given field number.
  1601. * @param {number} fieldNumber
  1602. * @param {!Int64} value
  1603. */
  1604. setSint64(fieldNumber, value) {
  1605. checkCriticalTypeSignedInt64(value);
  1606. this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
  1607. writer.writeSint64(fieldNumber, value);
  1608. });
  1609. }
  1610. /**
  1611. * Sets a boolean value to the field with the given field number.
  1612. * @param {number} fieldNumber
  1613. * @param {string} value
  1614. */
  1615. setString(fieldNumber, value) {
  1616. checkCriticalTypeString(value);
  1617. this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
  1618. writer.writeString(fieldNumber, value);
  1619. });
  1620. }
  1621. /**
  1622. * Sets a uint32 value to the field with the given field number.
  1623. * @param {number} fieldNumber
  1624. * @param {number} value
  1625. */
  1626. setUint32(fieldNumber, value) {
  1627. checkCriticalTypeUnsignedInt32(value);
  1628. this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
  1629. writer.writeUint32(fieldNumber, value);
  1630. });
  1631. }
  1632. /**
  1633. * Sets a uint64 value to the field with the given field number.\
  1634. * Note: Since g.m.Long does not support unsigned int64 values we are going
  1635. * the Java route here for now and simply output the number as a signed int64.
  1636. * Users can get to individual bits by themselves.
  1637. * @param {number} fieldNumber
  1638. * @param {!Int64} value
  1639. */
  1640. setUint64(fieldNumber, value) {
  1641. this.setInt64(fieldNumber, value);
  1642. }
  1643. /**
  1644. * Sets a proto Message to the field with the given field number.
  1645. * Instead of working with the Kernel inside of the message directly, we
  1646. * need the message instance to keep its reference equality for subsequent
  1647. * gettings.
  1648. * @param {number} fieldNumber
  1649. * @param {!InternalMessage} value
  1650. */
  1651. setMessage(fieldNumber, value) {
  1652. checkCriticalType(
  1653. value !== null, 'Given value is not a message instance: null');
  1654. this.setField_(fieldNumber, value, writeMessage);
  1655. }
  1656. /***************************************************************************
  1657. * REPEATED SETTER METHODS
  1658. ***************************************************************************/
  1659. /* Bool */
  1660. /**
  1661. * Adds all boolean values into the field for the given field number.
  1662. * How these values are encoded depends on the given write function.
  1663. * @param {number} fieldNumber
  1664. * @param {!Iterable<boolean>} values
  1665. * @param {function(!Writer, number, !Array<boolean>): undefined} encoder
  1666. * @private
  1667. */
  1668. addRepeatedBoolIterable_(fieldNumber, values, encoder) {
  1669. const array = [...this.getRepeatedBoolArray_(fieldNumber), ...values];
  1670. checkCriticalTypeBoolArray(array);
  1671. // Needs to set it back because the default empty array was not cached.
  1672. this.setField_(fieldNumber, array, encoder);
  1673. }
  1674. /**
  1675. * Adds a single boolean value into the field for the given field number.
  1676. * All values will be encoded as packed values.
  1677. * @param {number} fieldNumber
  1678. * @param {boolean} value
  1679. */
  1680. addPackedBoolElement(fieldNumber, value) {
  1681. this.addRepeatedBoolIterable_(
  1682. fieldNumber, [value], (writer, fieldNumber, values) => {
  1683. writer.writePackedBool(fieldNumber, values);
  1684. });
  1685. }
  1686. /**
  1687. * Adds all boolean values into the field for the given field number.
  1688. * All these values will be encoded as packed values.
  1689. * @param {number} fieldNumber
  1690. * @param {!Iterable<boolean>} values
  1691. */
  1692. addPackedBoolIterable(fieldNumber, values) {
  1693. this.addRepeatedBoolIterable_(
  1694. fieldNumber, values, (writer, fieldNumber, values) => {
  1695. writer.writePackedBool(fieldNumber, values);
  1696. });
  1697. }
  1698. /**
  1699. * Adds a single boolean value into the field for the given field number.
  1700. * All values will be encoded as unpacked values.
  1701. * @param {number} fieldNumber
  1702. * @param {boolean} value
  1703. */
  1704. addUnpackedBoolElement(fieldNumber, value) {
  1705. this.addRepeatedBoolIterable_(
  1706. fieldNumber, [value], (writer, fieldNumber, values) => {
  1707. writer.writeRepeatedBool(fieldNumber, values);
  1708. });
  1709. }
  1710. /**
  1711. * Adds all boolean values into the field for the given field number.
  1712. * All these values will be encoded as unpacked values.
  1713. * @param {number} fieldNumber
  1714. * @param {!Iterable<boolean>} values
  1715. */
  1716. addUnpackedBoolIterable(fieldNumber, values) {
  1717. this.addRepeatedBoolIterable_(
  1718. fieldNumber, values, (writer, fieldNumber, values) => {
  1719. writer.writeRepeatedBool(fieldNumber, values);
  1720. });
  1721. }
  1722. /**
  1723. * Sets a single boolean value into the field for the given field number at
  1724. * the given index. How these values are encoded depends on the given write
  1725. * function.
  1726. * @param {number} fieldNumber
  1727. * @param {number} index
  1728. * @param {boolean} value
  1729. * @param {function(!Writer, number, !Array<boolean>): undefined} encoder
  1730. * @throws {!Error} if index is out of range when check mode is critical
  1731. * @private
  1732. */
  1733. setRepeatedBoolElement_(fieldNumber, index, value, encoder) {
  1734. checkCriticalTypeBool(value);
  1735. const array = this.getRepeatedBoolArray_(fieldNumber);
  1736. checkCriticalElementIndex(index, array.length);
  1737. array[index] = value;
  1738. // Needs to set it back to set encoder.
  1739. this.setField_(fieldNumber, array, encoder);
  1740. }
  1741. /**
  1742. * Sets a single boolean value into the field for the given field number at
  1743. * the given index. All values will be encoded as packed values.
  1744. * @param {number} fieldNumber
  1745. * @param {number} index
  1746. * @param {boolean} value
  1747. * @throws {!Error} if index is out of range when check mode is critical
  1748. */
  1749. setPackedBoolElement(fieldNumber, index, value) {
  1750. this.setRepeatedBoolElement_(
  1751. fieldNumber, index, value, (writer, fieldNumber, values) => {
  1752. writer.writePackedBool(fieldNumber, values);
  1753. });
  1754. }
  1755. /**
  1756. * Sets all boolean values into the field for the given field number.
  1757. * All these values will be encoded as packed values.
  1758. * @param {number} fieldNumber
  1759. * @param {!Iterable<boolean>} values
  1760. */
  1761. setPackedBoolIterable(fieldNumber, values) {
  1762. const /** !Array<boolean> */ array = Array.from(values);
  1763. checkCriticalTypeBoolArray(array);
  1764. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  1765. writer.writePackedBool(fieldNumber, values);
  1766. });
  1767. }
  1768. /**
  1769. * Sets a single boolean value into the field for the given field number at
  1770. * the given index. All values will be encoded as unpacked values.
  1771. * @param {number} fieldNumber
  1772. * @param {number} index
  1773. * @param {boolean} value
  1774. * @throws {!Error} if index is out of range when check mode is critical
  1775. */
  1776. setUnpackedBoolElement(fieldNumber, index, value) {
  1777. this.setRepeatedBoolElement_(
  1778. fieldNumber, index, value, (writer, fieldNumber, values) => {
  1779. writer.writeRepeatedBool(fieldNumber, values);
  1780. });
  1781. }
  1782. /**
  1783. * Sets all boolean values into the field for the given field number.
  1784. * All these values will be encoded as unpacked values.
  1785. * @param {number} fieldNumber
  1786. * @param {!Iterable<boolean>} values
  1787. */
  1788. setUnpackedBoolIterable(fieldNumber, values) {
  1789. const /** !Array<boolean> */ array = Array.from(values);
  1790. checkCriticalTypeBoolArray(array);
  1791. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  1792. writer.writeRepeatedBool(fieldNumber, values);
  1793. });
  1794. }
  1795. /* Double */
  1796. /**
  1797. * Adds all double values into the field for the given field number.
  1798. * How these values are encoded depends on the given write function.
  1799. * @param {number} fieldNumber
  1800. * @param {!Iterable<number>} values
  1801. * @param {function(!Writer, number, !Array<number>): undefined} encoder
  1802. * @private
  1803. */
  1804. addRepeatedDoubleIterable_(fieldNumber, values, encoder) {
  1805. const array = [...this.getRepeatedDoubleArray_(fieldNumber), ...values];
  1806. checkCriticalTypeDoubleArray(array);
  1807. // Needs to set it back because the default empty array was not cached.
  1808. this.setField_(fieldNumber, array, encoder);
  1809. }
  1810. /**
  1811. * Adds a single double value into the field for the given field number.
  1812. * All values will be encoded as packed values.
  1813. * @param {number} fieldNumber
  1814. * @param {number} value
  1815. */
  1816. addPackedDoubleElement(fieldNumber, value) {
  1817. this.addRepeatedDoubleIterable_(
  1818. fieldNumber, [value], (writer, fieldNumber, values) => {
  1819. writer.writePackedDouble(fieldNumber, values);
  1820. });
  1821. }
  1822. /**
  1823. * Adds all double values into the field for the given field number.
  1824. * All these values will be encoded as packed values.
  1825. * @param {number} fieldNumber
  1826. * @param {!Iterable<number>} values
  1827. */
  1828. addPackedDoubleIterable(fieldNumber, values) {
  1829. this.addRepeatedDoubleIterable_(
  1830. fieldNumber, values, (writer, fieldNumber, values) => {
  1831. writer.writePackedDouble(fieldNumber, values);
  1832. });
  1833. }
  1834. /**
  1835. * Adds a single double value into the field for the given field number.
  1836. * All values will be encoded as unpacked values.
  1837. * @param {number} fieldNumber
  1838. * @param {number} value
  1839. */
  1840. addUnpackedDoubleElement(fieldNumber, value) {
  1841. this.addRepeatedDoubleIterable_(
  1842. fieldNumber, [value], (writer, fieldNumber, values) => {
  1843. writer.writeRepeatedDouble(fieldNumber, values);
  1844. });
  1845. }
  1846. /**
  1847. * Adds all double values into the field for the given field number.
  1848. * All these values will be encoded as unpacked values.
  1849. * @param {number} fieldNumber
  1850. * @param {!Iterable<number>} values
  1851. */
  1852. addUnpackedDoubleIterable(fieldNumber, values) {
  1853. this.addRepeatedDoubleIterable_(
  1854. fieldNumber, values, (writer, fieldNumber, values) => {
  1855. writer.writeRepeatedDouble(fieldNumber, values);
  1856. });
  1857. }
  1858. /**
  1859. * Sets a single double value into the field for the given field number at the
  1860. * given index.
  1861. * How these values are encoded depends on the given write function.
  1862. * @param {number} fieldNumber
  1863. * @param {number} index
  1864. * @param {number} value
  1865. * @param {function(!Writer, number, !Array<number>): undefined} encoder
  1866. * @throws {!Error} if index is out of range when check mode is critical
  1867. * @private
  1868. */
  1869. setRepeatedDoubleElement_(fieldNumber, index, value, encoder) {
  1870. checkCriticalTypeDouble(value);
  1871. const array = this.getRepeatedDoubleArray_(fieldNumber);
  1872. checkCriticalElementIndex(index, array.length);
  1873. array[index] = value;
  1874. // Needs to set it back to set encoder.
  1875. this.setField_(fieldNumber, array, encoder);
  1876. }
  1877. /**
  1878. * Sets a single double value into the field for the given field number at the
  1879. * given index.
  1880. * All values will be encoded as packed values.
  1881. * @param {number} fieldNumber
  1882. * @param {number} index
  1883. * @param {number} value
  1884. * @throws {!Error} if index is out of range when check mode is critical
  1885. */
  1886. setPackedDoubleElement(fieldNumber, index, value) {
  1887. this.setRepeatedDoubleElement_(
  1888. fieldNumber, index, value, (writer, fieldNumber, values) => {
  1889. writer.writePackedDouble(fieldNumber, values);
  1890. });
  1891. }
  1892. /**
  1893. * Sets all double values into the field for the given field number.
  1894. * All these values will be encoded as packed values.
  1895. * @param {number} fieldNumber
  1896. * @param {!Iterable<number>} values
  1897. */
  1898. setPackedDoubleIterable(fieldNumber, values) {
  1899. const array = Array.from(values);
  1900. checkCriticalTypeDoubleArray(array);
  1901. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  1902. writer.writePackedDouble(fieldNumber, values);
  1903. });
  1904. }
  1905. /**
  1906. * Sets a single double value into the field for the given field number at the
  1907. * given index.
  1908. * All values will be encoded as unpacked values.
  1909. * @param {number} fieldNumber
  1910. * @param {number} index
  1911. * @param {number} value
  1912. * @throws {!Error} if index is out of range when check mode is critical
  1913. */
  1914. setUnpackedDoubleElement(fieldNumber, index, value) {
  1915. this.setRepeatedDoubleElement_(
  1916. fieldNumber, index, value, (writer, fieldNumber, values) => {
  1917. writer.writeRepeatedDouble(fieldNumber, values);
  1918. });
  1919. }
  1920. /**
  1921. * Sets all double values into the field for the given field number.
  1922. * All these values will be encoded as unpacked values.
  1923. * @param {number} fieldNumber
  1924. * @param {!Iterable<number>} values
  1925. */
  1926. setUnpackedDoubleIterable(fieldNumber, values) {
  1927. const array = Array.from(values);
  1928. checkCriticalTypeDoubleArray(array);
  1929. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  1930. writer.writeRepeatedDouble(fieldNumber, values);
  1931. });
  1932. }
  1933. /* Fixed32 */
  1934. /**
  1935. * Adds all fixed32 values into the field for the given field number.
  1936. * How these values are encoded depends on the given write function.
  1937. * @param {number} fieldNumber
  1938. * @param {!Iterable<number>} values
  1939. * @param {function(!Writer, number, !Array<number>): undefined} encoder
  1940. * @private
  1941. */
  1942. addRepeatedFixed32Iterable_(fieldNumber, values, encoder) {
  1943. const array = [...this.getRepeatedFixed32Array_(fieldNumber), ...values];
  1944. checkCriticalTypeUnsignedInt32Array(array);
  1945. // Needs to set it back because the default empty array was not cached.
  1946. this.setField_(fieldNumber, array, encoder);
  1947. }
  1948. /**
  1949. * Adds a single fixed32 value into the field for the given field number.
  1950. * All values will be encoded as packed values.
  1951. * @param {number} fieldNumber
  1952. * @param {number} value
  1953. */
  1954. addPackedFixed32Element(fieldNumber, value) {
  1955. this.addRepeatedFixed32Iterable_(
  1956. fieldNumber, [value], (writer, fieldNumber, values) => {
  1957. writer.writePackedFixed32(fieldNumber, values);
  1958. });
  1959. }
  1960. /**
  1961. * Adds all fixed32 values into the field for the given field number.
  1962. * All these values will be encoded as packed values.
  1963. * @param {number} fieldNumber
  1964. * @param {!Iterable<number>} values
  1965. */
  1966. addPackedFixed32Iterable(fieldNumber, values) {
  1967. this.addRepeatedFixed32Iterable_(
  1968. fieldNumber, values, (writer, fieldNumber, values) => {
  1969. writer.writePackedFixed32(fieldNumber, values);
  1970. });
  1971. }
  1972. /**
  1973. * Adds a single fixed32 value into the field for the given field number.
  1974. * All values will be encoded as unpacked values.
  1975. * @param {number} fieldNumber
  1976. * @param {number} value
  1977. */
  1978. addUnpackedFixed32Element(fieldNumber, value) {
  1979. this.addRepeatedFixed32Iterable_(
  1980. fieldNumber, [value], (writer, fieldNumber, values) => {
  1981. writer.writeRepeatedFixed32(fieldNumber, values);
  1982. });
  1983. }
  1984. /**
  1985. * Adds all fixed32 values into the field for the given field number.
  1986. * All these values will be encoded as unpacked values.
  1987. * @param {number} fieldNumber
  1988. * @param {!Iterable<number>} values
  1989. */
  1990. addUnpackedFixed32Iterable(fieldNumber, values) {
  1991. this.addRepeatedFixed32Iterable_(
  1992. fieldNumber, values, (writer, fieldNumber, values) => {
  1993. writer.writeRepeatedFixed32(fieldNumber, values);
  1994. });
  1995. }
  1996. /**
  1997. * Sets a single fixed32 value into the field for the given field number at
  1998. * the given index. How these values are encoded depends on the given write
  1999. * function.
  2000. * @param {number} fieldNumber
  2001. * @param {number} index
  2002. * @param {number} value
  2003. * @param {function(!Writer, number, !Array<number>): undefined} encoder
  2004. * @throws {!Error} if index is out of range when check mode is critical
  2005. * @private
  2006. */
  2007. setRepeatedFixed32Element_(fieldNumber, index, value, encoder) {
  2008. checkCriticalTypeUnsignedInt32(value);
  2009. const array = this.getRepeatedFixed32Array_(fieldNumber);
  2010. checkCriticalElementIndex(index, array.length);
  2011. array[index] = value;
  2012. // Needs to set it back to set encoder.
  2013. this.setField_(fieldNumber, array, encoder);
  2014. }
  2015. /**
  2016. * Sets a single fixed32 value into the field for the given field number at
  2017. * the given index. All values will be encoded as packed values.
  2018. * @param {number} fieldNumber
  2019. * @param {number} index
  2020. * @param {number} value
  2021. * @throws {!Error} if index is out of range when check mode is critical
  2022. */
  2023. setPackedFixed32Element(fieldNumber, index, value) {
  2024. this.setRepeatedFixed32Element_(
  2025. fieldNumber, index, value, (writer, fieldNumber, values) => {
  2026. writer.writePackedFixed32(fieldNumber, values);
  2027. });
  2028. }
  2029. /**
  2030. * Sets all fixed32 values into the field for the given field number.
  2031. * All these values will be encoded as packed values.
  2032. * @param {number} fieldNumber
  2033. * @param {!Iterable<number>} values
  2034. */
  2035. setPackedFixed32Iterable(fieldNumber, values) {
  2036. const array = Array.from(values);
  2037. checkCriticalTypeUnsignedInt32Array(array);
  2038. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  2039. writer.writePackedFixed32(fieldNumber, values);
  2040. });
  2041. }
  2042. /**
  2043. * Sets a single fixed32 value into the field for the given field number at
  2044. * the given index. All values will be encoded as unpacked values.
  2045. * @param {number} fieldNumber
  2046. * @param {number} index
  2047. * @param {number} value
  2048. * @throws {!Error} if index is out of range when check mode is critical
  2049. */
  2050. setUnpackedFixed32Element(fieldNumber, index, value) {
  2051. this.setRepeatedFixed32Element_(
  2052. fieldNumber, index, value, (writer, fieldNumber, values) => {
  2053. writer.writeRepeatedFixed32(fieldNumber, values);
  2054. });
  2055. }
  2056. /**
  2057. * Sets all fixed32 values into the field for the given field number.
  2058. * All these values will be encoded as unpacked values.
  2059. * @param {number} fieldNumber
  2060. * @param {!Iterable<number>} values
  2061. */
  2062. setUnpackedFixed32Iterable(fieldNumber, values) {
  2063. const array = Array.from(values);
  2064. checkCriticalTypeUnsignedInt32Array(array);
  2065. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  2066. writer.writeRepeatedFixed32(fieldNumber, values);
  2067. });
  2068. }
  2069. /* Fixed64 */
  2070. /**
  2071. * Adds a single fixed64 value into the field for the given field number.
  2072. * All values will be encoded as packed values.
  2073. * @param {number} fieldNumber
  2074. * @param {!Int64} value
  2075. */
  2076. addPackedFixed64Element(fieldNumber, value) {
  2077. this.addPackedSfixed64Element(fieldNumber, value);
  2078. }
  2079. /**
  2080. * Adds all fixed64 values into the field for the given field number.
  2081. * All these values will be encoded as packed values.
  2082. * @param {number} fieldNumber
  2083. * @param {!Iterable<!Int64>} values
  2084. */
  2085. addPackedFixed64Iterable(fieldNumber, values) {
  2086. this.addPackedSfixed64Iterable(fieldNumber, values);
  2087. }
  2088. /**
  2089. * Adds a single fixed64 value into the field for the given field number.
  2090. * All values will be encoded as unpacked values.
  2091. * @param {number} fieldNumber
  2092. * @param {!Int64} value
  2093. */
  2094. addUnpackedFixed64Element(fieldNumber, value) {
  2095. this.addUnpackedSfixed64Element(fieldNumber, value);
  2096. }
  2097. /**
  2098. * Adds all fixed64 values into the field for the given field number.
  2099. * All these values will be encoded as unpacked values.
  2100. * @param {number} fieldNumber
  2101. * @param {!Iterable<!Int64>} values
  2102. */
  2103. addUnpackedFixed64Iterable(fieldNumber, values) {
  2104. this.addUnpackedSfixed64Iterable(fieldNumber, values);
  2105. }
  2106. /**
  2107. * Sets a single fixed64 value into the field for the given field number at
  2108. * the given index. All values will be encoded as packed values.
  2109. * @param {number} fieldNumber
  2110. * @param {number} index
  2111. * @param {!Int64} value
  2112. * @throws {!Error} if index is out of range when check mode is critical
  2113. */
  2114. setPackedFixed64Element(fieldNumber, index, value) {
  2115. this.setPackedSfixed64Element(fieldNumber, index, value);
  2116. }
  2117. /**
  2118. * Sets all fixed64 values into the field for the given field number.
  2119. * All these values will be encoded as packed values.
  2120. * @param {number} fieldNumber
  2121. * @param {!Iterable<!Int64>} values
  2122. */
  2123. setPackedFixed64Iterable(fieldNumber, values) {
  2124. this.setPackedSfixed64Iterable(fieldNumber, values);
  2125. }
  2126. /**
  2127. * Sets a single fixed64 value into the field for the given field number at
  2128. * the given index. All values will be encoded as unpacked values.
  2129. * @param {number} fieldNumber
  2130. * @param {number} index
  2131. * @param {!Int64} value
  2132. * @throws {!Error} if index is out of range when check mode is critical
  2133. */
  2134. setUnpackedFixed64Element(fieldNumber, index, value) {
  2135. this.setUnpackedSfixed64Element(fieldNumber, index, value);
  2136. }
  2137. /**
  2138. * Sets all fixed64 values into the field for the given field number.
  2139. * All these values will be encoded as unpacked values.
  2140. * @param {number} fieldNumber
  2141. * @param {!Iterable<!Int64>} values
  2142. */
  2143. setUnpackedFixed64Iterable(fieldNumber, values) {
  2144. this.setUnpackedSfixed64Iterable(fieldNumber, values);
  2145. }
  2146. /* Float */
  2147. /**
  2148. * Adds all float values into the field for the given field number.
  2149. * How these values are encoded depends on the given write function.
  2150. * @param {number} fieldNumber
  2151. * @param {!Iterable<number>} values
  2152. * @param {function(!Writer, number, !Array<number>): undefined} encoder
  2153. * @private
  2154. */
  2155. addRepeatedFloatIterable_(fieldNumber, values, encoder) {
  2156. checkCriticalTypeFloatIterable(values);
  2157. // Eagerly round to 32-bit precision so that reading back after set will
  2158. // yield the same value a reader will receive after serialization.
  2159. const floatValues = Array.from(values, fround);
  2160. const array = [...this.getRepeatedFloatArray_(fieldNumber), ...floatValues];
  2161. checkCriticalTypeFloatIterable(array);
  2162. // Needs to set it back because the default empty array was not cached.
  2163. this.setField_(fieldNumber, array, encoder);
  2164. }
  2165. /**
  2166. * Adds a single float value into the field for the given field number.
  2167. * All values will be encoded as packed values.
  2168. * @param {number} fieldNumber
  2169. * @param {number} value
  2170. */
  2171. addPackedFloatElement(fieldNumber, value) {
  2172. this.addRepeatedFloatIterable_(
  2173. fieldNumber, [value], (writer, fieldNumber, values) => {
  2174. writer.writePackedFloat(fieldNumber, values);
  2175. });
  2176. }
  2177. /**
  2178. * Adds all float values into the field for the given field number.
  2179. * All these values will be encoded as packed values.
  2180. * @param {number} fieldNumber
  2181. * @param {!Iterable<number>} values
  2182. */
  2183. addPackedFloatIterable(fieldNumber, values) {
  2184. this.addRepeatedFloatIterable_(
  2185. fieldNumber, values, (writer, fieldNumber, values) => {
  2186. writer.writePackedFloat(fieldNumber, values);
  2187. });
  2188. }
  2189. /**
  2190. * Adds a single float value into the field for the given field number.
  2191. * All values will be encoded as unpacked values.
  2192. * @param {number} fieldNumber
  2193. * @param {number} value
  2194. */
  2195. addUnpackedFloatElement(fieldNumber, value) {
  2196. this.addRepeatedFloatIterable_(
  2197. fieldNumber, [value], (writer, fieldNumber, values) => {
  2198. writer.writeRepeatedFloat(fieldNumber, values);
  2199. });
  2200. }
  2201. /**
  2202. * Adds all float values into the field for the given field number.
  2203. * All these values will be encoded as unpacked values.
  2204. * @param {number} fieldNumber
  2205. * @param {!Iterable<number>} values
  2206. */
  2207. addUnpackedFloatIterable(fieldNumber, values) {
  2208. this.addRepeatedFloatIterable_(
  2209. fieldNumber, values, (writer, fieldNumber, values) => {
  2210. writer.writeRepeatedFloat(fieldNumber, values);
  2211. });
  2212. }
  2213. /**
  2214. * Sets a single float value into the field for the given field number at the
  2215. * given index.
  2216. * How these values are encoded depends on the given write function.
  2217. * @param {number} fieldNumber
  2218. * @param {number} index
  2219. * @param {number} value
  2220. * @param {function(!Writer, number, !Array<number>): undefined} encoder
  2221. * @throws {!Error} if index is out of range when check mode is critical
  2222. * @private
  2223. */
  2224. setRepeatedFloatElement_(fieldNumber, index, value, encoder) {
  2225. checkCriticalTypeFloat(value);
  2226. // Eagerly round to 32-bit precision so that reading back after set will
  2227. // yield the same value a reader will receive after serialization.
  2228. const floatValue = Math.fround(value);
  2229. const array = this.getRepeatedFloatArray_(fieldNumber);
  2230. checkCriticalElementIndex(index, array.length);
  2231. array[index] = floatValue;
  2232. // Needs to set it back to set encoder.
  2233. this.setField_(fieldNumber, array, encoder);
  2234. }
  2235. /**
  2236. * Sets a single float value into the field for the given field number at the
  2237. * given index.
  2238. * All values will be encoded as packed values.
  2239. * @param {number} fieldNumber
  2240. * @param {number} index
  2241. * @param {number} value
  2242. * @throws {!Error} if index is out of range when check mode is critical
  2243. */
  2244. setPackedFloatElement(fieldNumber, index, value) {
  2245. this.setRepeatedFloatElement_(
  2246. fieldNumber, index, value, (writer, fieldNumber, values) => {
  2247. writer.writePackedFloat(fieldNumber, values);
  2248. });
  2249. }
  2250. /**
  2251. * Sets all float values into the field for the given field number.
  2252. * All these values will be encoded as packed values.
  2253. * @param {number} fieldNumber
  2254. * @param {!Iterable<number>} values
  2255. */
  2256. setPackedFloatIterable(fieldNumber, values) {
  2257. checkCriticalTypeFloatIterable(values);
  2258. // Eagerly round to 32-bit precision so that reading back after set will
  2259. // yield the same value a reader will receive after serialization.
  2260. const array = Array.from(values, fround);
  2261. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  2262. writer.writePackedFloat(fieldNumber, values);
  2263. });
  2264. }
  2265. /**
  2266. * Sets a single float value into the field for the given field number at the
  2267. * given index.
  2268. * All values will be encoded as unpacked values.
  2269. * @param {number} fieldNumber
  2270. * @param {number} index
  2271. * @param {number} value
  2272. * @throws {!Error} if index is out of range when check mode is critical
  2273. */
  2274. setUnpackedFloatElement(fieldNumber, index, value) {
  2275. this.setRepeatedFloatElement_(
  2276. fieldNumber, index, value, (writer, fieldNumber, values) => {
  2277. writer.writeRepeatedFloat(fieldNumber, values);
  2278. });
  2279. }
  2280. /**
  2281. * Sets all float values into the field for the given field number.
  2282. * All these values will be encoded as unpacked values.
  2283. * @param {number} fieldNumber
  2284. * @param {!Iterable<number>} values
  2285. */
  2286. setUnpackedFloatIterable(fieldNumber, values) {
  2287. checkCriticalTypeFloatIterable(values);
  2288. // Eagerly round to 32-bit precision so that reading back after set will
  2289. // yield the same value a reader will receive after serialization.
  2290. const array = Array.from(values, fround);
  2291. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  2292. writer.writeRepeatedFloat(fieldNumber, values);
  2293. });
  2294. }
  2295. /* Int32 */
  2296. /**
  2297. * Adds all int32 values into the field for the given field number.
  2298. * How these values are encoded depends on the given write function.
  2299. * @param {number} fieldNumber
  2300. * @param {!Iterable<number>} values
  2301. * @param {function(!Writer, number, !Array<number>): undefined} encoder
  2302. * @private
  2303. */
  2304. addRepeatedInt32Iterable_(fieldNumber, values, encoder) {
  2305. const array = [...this.getRepeatedInt32Array_(fieldNumber), ...values];
  2306. checkCriticalTypeSignedInt32Array(array);
  2307. // Needs to set it back because the default empty array was not cached.
  2308. this.setField_(fieldNumber, array, encoder);
  2309. }
  2310. /**
  2311. * Adds a single int32 value into the field for the given field number.
  2312. * All values will be encoded as packed values.
  2313. * @param {number} fieldNumber
  2314. * @param {number} value
  2315. */
  2316. addPackedInt32Element(fieldNumber, value) {
  2317. this.addRepeatedInt32Iterable_(
  2318. fieldNumber, [value], (writer, fieldNumber, values) => {
  2319. writer.writePackedInt32(fieldNumber, values);
  2320. });
  2321. }
  2322. /**
  2323. * Adds all int32 values into the field for the given field number.
  2324. * All these values will be encoded as packed values.
  2325. * @param {number} fieldNumber
  2326. * @param {!Iterable<number>} values
  2327. */
  2328. addPackedInt32Iterable(fieldNumber, values) {
  2329. this.addRepeatedInt32Iterable_(
  2330. fieldNumber, values, (writer, fieldNumber, values) => {
  2331. writer.writePackedInt32(fieldNumber, values);
  2332. });
  2333. }
  2334. /**
  2335. * Adds a single int32 value into the field for the given field number.
  2336. * All values will be encoded as unpacked values.
  2337. * @param {number} fieldNumber
  2338. * @param {number} value
  2339. */
  2340. addUnpackedInt32Element(fieldNumber, value) {
  2341. this.addRepeatedInt32Iterable_(
  2342. fieldNumber, [value], (writer, fieldNumber, values) => {
  2343. writer.writeRepeatedInt32(fieldNumber, values);
  2344. });
  2345. }
  2346. /**
  2347. * Adds all int32 values into the field for the given field number.
  2348. * All these values will be encoded as unpacked values.
  2349. * @param {number} fieldNumber
  2350. * @param {!Iterable<number>} values
  2351. */
  2352. addUnpackedInt32Iterable(fieldNumber, values) {
  2353. this.addRepeatedInt32Iterable_(
  2354. fieldNumber, values, (writer, fieldNumber, values) => {
  2355. writer.writeRepeatedInt32(fieldNumber, values);
  2356. });
  2357. }
  2358. /**
  2359. * Sets a single int32 value into the field for the given field number at
  2360. * the given index. How these values are encoded depends on the given write
  2361. * function.
  2362. * @param {number} fieldNumber
  2363. * @param {number} index
  2364. * @param {number} value
  2365. * @param {function(!Writer, number, !Array<number>): undefined} encoder
  2366. * @throws {!Error} if index is out of range when check mode is critical
  2367. * @private
  2368. */
  2369. setRepeatedInt32Element_(fieldNumber, index, value, encoder) {
  2370. checkCriticalTypeSignedInt32(value);
  2371. const array = this.getRepeatedInt32Array_(fieldNumber);
  2372. checkCriticalElementIndex(index, array.length);
  2373. array[index] = value;
  2374. // Needs to set it back to set encoder.
  2375. this.setField_(fieldNumber, array, encoder);
  2376. }
  2377. /**
  2378. * Sets a single int32 value into the field for the given field number at
  2379. * the given index. All values will be encoded as packed values.
  2380. * @param {number} fieldNumber
  2381. * @param {number} index
  2382. * @param {number} value
  2383. * @throws {!Error} if index is out of range when check mode is critical
  2384. */
  2385. setPackedInt32Element(fieldNumber, index, value) {
  2386. this.setRepeatedInt32Element_(
  2387. fieldNumber, index, value, (writer, fieldNumber, values) => {
  2388. writer.writePackedInt32(fieldNumber, values);
  2389. });
  2390. }
  2391. /**
  2392. * Sets all int32 values into the field for the given field number.
  2393. * All these values will be encoded as packed values.
  2394. * @param {number} fieldNumber
  2395. * @param {!Iterable<number>} values
  2396. */
  2397. setPackedInt32Iterable(fieldNumber, values) {
  2398. const array = Array.from(values);
  2399. checkCriticalTypeSignedInt32Array(array);
  2400. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  2401. writer.writePackedInt32(fieldNumber, values);
  2402. });
  2403. }
  2404. /**
  2405. * Sets a single int32 value into the field for the given field number at
  2406. * the given index. All values will be encoded as unpacked values.
  2407. * @param {number} fieldNumber
  2408. * @param {number} index
  2409. * @param {number} value
  2410. * @throws {!Error} if index is out of range when check mode is critical
  2411. */
  2412. setUnpackedInt32Element(fieldNumber, index, value) {
  2413. this.setRepeatedInt32Element_(
  2414. fieldNumber, index, value, (writer, fieldNumber, values) => {
  2415. writer.writeRepeatedInt32(fieldNumber, values);
  2416. });
  2417. }
  2418. /**
  2419. * Sets all int32 values into the field for the given field number.
  2420. * All these values will be encoded as unpacked values.
  2421. * @param {number} fieldNumber
  2422. * @param {!Iterable<number>} values
  2423. */
  2424. setUnpackedInt32Iterable(fieldNumber, values) {
  2425. const array = Array.from(values);
  2426. checkCriticalTypeSignedInt32Array(array);
  2427. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  2428. writer.writeRepeatedInt32(fieldNumber, values);
  2429. });
  2430. }
  2431. /* Int64 */
  2432. /**
  2433. * Adds all int64 values into the field for the given field number.
  2434. * How these values are encoded depends on the given write function.
  2435. * @param {number} fieldNumber
  2436. * @param {!Iterable<!Int64>} values
  2437. * @param {function(!Writer, number, !Array<!Int64>): undefined} encoder
  2438. * @private
  2439. */
  2440. addRepeatedInt64Iterable_(fieldNumber, values, encoder) {
  2441. const array = [...this.getRepeatedInt64Array_(fieldNumber), ...values];
  2442. checkCriticalTypeSignedInt64Array(array);
  2443. // Needs to set it back because the default empty array was not cached.
  2444. this.setField_(fieldNumber, array, encoder);
  2445. }
  2446. /**
  2447. * Adds a single int64 value into the field for the given field number.
  2448. * All values will be encoded as packed values.
  2449. * @param {number} fieldNumber
  2450. * @param {!Int64} value
  2451. */
  2452. addPackedInt64Element(fieldNumber, value) {
  2453. this.addRepeatedInt64Iterable_(
  2454. fieldNumber, [value], (writer, fieldNumber, values) => {
  2455. writer.writePackedInt64(fieldNumber, values);
  2456. });
  2457. }
  2458. /**
  2459. * Adds all int64 values into the field for the given field number.
  2460. * All these values will be encoded as packed values.
  2461. * @param {number} fieldNumber
  2462. * @param {!Iterable<!Int64>} values
  2463. */
  2464. addPackedInt64Iterable(fieldNumber, values) {
  2465. this.addRepeatedInt64Iterable_(
  2466. fieldNumber, values, (writer, fieldNumber, values) => {
  2467. writer.writePackedInt64(fieldNumber, values);
  2468. });
  2469. }
  2470. /**
  2471. * Adds a single int64 value into the field for the given field number.
  2472. * All values will be encoded as unpacked values.
  2473. * @param {number} fieldNumber
  2474. * @param {!Int64} value
  2475. */
  2476. addUnpackedInt64Element(fieldNumber, value) {
  2477. this.addRepeatedInt64Iterable_(
  2478. fieldNumber, [value], (writer, fieldNumber, values) => {
  2479. writer.writeRepeatedInt64(fieldNumber, values);
  2480. });
  2481. }
  2482. /**
  2483. * Adds all int64 values into the field for the given field number.
  2484. * All these values will be encoded as unpacked values.
  2485. * @param {number} fieldNumber
  2486. * @param {!Iterable<!Int64>} values
  2487. */
  2488. addUnpackedInt64Iterable(fieldNumber, values) {
  2489. this.addRepeatedInt64Iterable_(
  2490. fieldNumber, values, (writer, fieldNumber, values) => {
  2491. writer.writeRepeatedInt64(fieldNumber, values);
  2492. });
  2493. }
  2494. /**
  2495. * Sets a single int64 value into the field for the given field number at
  2496. * the given index. How these values are encoded depends on the given write
  2497. * function.
  2498. * @param {number} fieldNumber
  2499. * @param {number} index
  2500. * @param {!Int64} value
  2501. * @param {function(!Writer, number, !Array<!Int64>): undefined} encoder
  2502. * @throws {!Error} if index is out of range when check mode is critical
  2503. * @private
  2504. */
  2505. setRepeatedInt64Element_(fieldNumber, index, value, encoder) {
  2506. checkCriticalTypeSignedInt64(value);
  2507. const array = this.getRepeatedInt64Array_(fieldNumber);
  2508. checkCriticalElementIndex(index, array.length);
  2509. array[index] = value;
  2510. // Needs to set it back to set encoder.
  2511. this.setField_(fieldNumber, array, encoder);
  2512. }
  2513. /**
  2514. * Sets a single int64 value into the field for the given field number at
  2515. * the given index. All values will be encoded as packed values.
  2516. * @param {number} fieldNumber
  2517. * @param {number} index
  2518. * @param {!Int64} value
  2519. * @throws {!Error} if index is out of range when check mode is critical
  2520. */
  2521. setPackedInt64Element(fieldNumber, index, value) {
  2522. this.setRepeatedInt64Element_(
  2523. fieldNumber, index, value, (writer, fieldNumber, values) => {
  2524. writer.writePackedInt64(fieldNumber, values);
  2525. });
  2526. }
  2527. /**
  2528. * Sets all int64 values into the field for the given field number.
  2529. * All these values will be encoded as packed values.
  2530. * @param {number} fieldNumber
  2531. * @param {!Iterable<!Int64>} values
  2532. */
  2533. setPackedInt64Iterable(fieldNumber, values) {
  2534. const array = Array.from(values);
  2535. checkCriticalTypeSignedInt64Array(array);
  2536. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  2537. writer.writePackedInt64(fieldNumber, values);
  2538. });
  2539. }
  2540. /**
  2541. * Sets a single int64 value into the field for the given field number at
  2542. * the given index. All values will be encoded as unpacked values.
  2543. * @param {number} fieldNumber
  2544. * @param {number} index
  2545. * @param {!Int64} value
  2546. * @throws {!Error} if index is out of range when check mode is critical
  2547. */
  2548. setUnpackedInt64Element(fieldNumber, index, value) {
  2549. this.setRepeatedInt64Element_(
  2550. fieldNumber, index, value, (writer, fieldNumber, values) => {
  2551. writer.writeRepeatedInt64(fieldNumber, values);
  2552. });
  2553. }
  2554. /**
  2555. * Sets all int64 values into the field for the given field number.
  2556. * All these values will be encoded as unpacked values.
  2557. * @param {number} fieldNumber
  2558. * @param {!Iterable<!Int64>} values
  2559. */
  2560. setUnpackedInt64Iterable(fieldNumber, values) {
  2561. const array = Array.from(values);
  2562. checkCriticalTypeSignedInt64Array(array);
  2563. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  2564. writer.writeRepeatedInt64(fieldNumber, values);
  2565. });
  2566. }
  2567. /* Sfixed32 */
  2568. /**
  2569. * Adds all sfixed32 values into the field for the given field number.
  2570. * How these values are encoded depends on the given write function.
  2571. * @param {number} fieldNumber
  2572. * @param {!Iterable<number>} values
  2573. * @param {function(!Writer, number, !Array<number>): undefined} encoder
  2574. * @private
  2575. */
  2576. addRepeatedSfixed32Iterable_(fieldNumber, values, encoder) {
  2577. const array = [...this.getRepeatedSfixed32Array_(fieldNumber), ...values];
  2578. checkCriticalTypeSignedInt32Array(array);
  2579. // Needs to set it back because the default empty array was not cached.
  2580. this.setField_(fieldNumber, array, encoder);
  2581. }
  2582. /**
  2583. * Adds a single sfixed32 value into the field for the given field number.
  2584. * All values will be encoded as packed values.
  2585. * @param {number} fieldNumber
  2586. * @param {number} value
  2587. */
  2588. addPackedSfixed32Element(fieldNumber, value) {
  2589. this.addRepeatedSfixed32Iterable_(
  2590. fieldNumber, [value], (writer, fieldNumber, values) => {
  2591. writer.writePackedSfixed32(fieldNumber, values);
  2592. });
  2593. }
  2594. /**
  2595. * Adds all sfixed32 values into the field for the given field number.
  2596. * All these values will be encoded as packed values.
  2597. * @param {number} fieldNumber
  2598. * @param {!Iterable<number>} values
  2599. */
  2600. addPackedSfixed32Iterable(fieldNumber, values) {
  2601. this.addRepeatedSfixed32Iterable_(
  2602. fieldNumber, values, (writer, fieldNumber, values) => {
  2603. writer.writePackedSfixed32(fieldNumber, values);
  2604. });
  2605. }
  2606. /**
  2607. * Adds a single sfixed32 value into the field for the given field number.
  2608. * All values will be encoded as unpacked values.
  2609. * @param {number} fieldNumber
  2610. * @param {number} value
  2611. */
  2612. addUnpackedSfixed32Element(fieldNumber, value) {
  2613. this.addRepeatedSfixed32Iterable_(
  2614. fieldNumber, [value], (writer, fieldNumber, values) => {
  2615. writer.writeRepeatedSfixed32(fieldNumber, values);
  2616. });
  2617. }
  2618. /**
  2619. * Adds all sfixed32 values into the field for the given field number.
  2620. * All these values will be encoded as unpacked values.
  2621. * @param {number} fieldNumber
  2622. * @param {!Iterable<number>} values
  2623. */
  2624. addUnpackedSfixed32Iterable(fieldNumber, values) {
  2625. this.addRepeatedSfixed32Iterable_(
  2626. fieldNumber, values, (writer, fieldNumber, values) => {
  2627. writer.writeRepeatedSfixed32(fieldNumber, values);
  2628. });
  2629. }
  2630. /**
  2631. * Sets a single sfixed32 value into the field for the given field number at
  2632. * the given index. How these values are encoded depends on the given write
  2633. * function.
  2634. * @param {number} fieldNumber
  2635. * @param {number} index
  2636. * @param {number} value
  2637. * @param {function(!Writer, number, !Array<number>): undefined} encoder
  2638. * @throws {!Error} if index is out of range when check mode is critical
  2639. * @private
  2640. */
  2641. setRepeatedSfixed32Element_(fieldNumber, index, value, encoder) {
  2642. checkCriticalTypeSignedInt32(value);
  2643. const array = this.getRepeatedSfixed32Array_(fieldNumber);
  2644. checkCriticalElementIndex(index, array.length);
  2645. array[index] = value;
  2646. // Needs to set it back to set encoder.
  2647. this.setField_(fieldNumber, array, encoder);
  2648. }
  2649. /**
  2650. * Sets a single sfixed32 value into the field for the given field number at
  2651. * the given index. All values will be encoded as packed values.
  2652. * @param {number} fieldNumber
  2653. * @param {number} index
  2654. * @param {number} value
  2655. * @throws {!Error} if index is out of range when check mode is critical
  2656. */
  2657. setPackedSfixed32Element(fieldNumber, index, value) {
  2658. this.setRepeatedSfixed32Element_(
  2659. fieldNumber, index, value, (writer, fieldNumber, values) => {
  2660. writer.writePackedSfixed32(fieldNumber, values);
  2661. });
  2662. }
  2663. /**
  2664. * Sets all sfixed32 values into the field for the given field number.
  2665. * All these values will be encoded as packed values.
  2666. * @param {number} fieldNumber
  2667. * @param {!Iterable<number>} values
  2668. */
  2669. setPackedSfixed32Iterable(fieldNumber, values) {
  2670. const array = Array.from(values);
  2671. checkCriticalTypeSignedInt32Array(array);
  2672. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  2673. writer.writePackedSfixed32(fieldNumber, values);
  2674. });
  2675. }
  2676. /**
  2677. * Sets a single sfixed32 value into the field for the given field number at
  2678. * the given index. All values will be encoded as unpacked values.
  2679. * @param {number} fieldNumber
  2680. * @param {number} index
  2681. * @param {number} value
  2682. * @throws {!Error} if index is out of range when check mode is critical
  2683. */
  2684. setUnpackedSfixed32Element(fieldNumber, index, value) {
  2685. this.setRepeatedSfixed32Element_(
  2686. fieldNumber, index, value, (writer, fieldNumber, values) => {
  2687. writer.writeRepeatedSfixed32(fieldNumber, values);
  2688. });
  2689. }
  2690. /**
  2691. * Sets all sfixed32 values into the field for the given field number.
  2692. * All these values will be encoded as unpacked values.
  2693. * @param {number} fieldNumber
  2694. * @param {!Iterable<number>} values
  2695. */
  2696. setUnpackedSfixed32Iterable(fieldNumber, values) {
  2697. const array = Array.from(values);
  2698. checkCriticalTypeSignedInt32Array(array);
  2699. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  2700. writer.writeRepeatedSfixed32(fieldNumber, values);
  2701. });
  2702. }
  2703. /* Sfixed64 */
  2704. /**
  2705. * Adds all sfixed64 values into the field for the given field number.
  2706. * How these values are encoded depends on the given write function.
  2707. * @param {number} fieldNumber
  2708. * @param {!Iterable<!Int64>} values
  2709. * @param {function(!Writer, number, !Array<!Int64>): undefined} encoder
  2710. * @private
  2711. */
  2712. addRepeatedSfixed64Iterable_(fieldNumber, values, encoder) {
  2713. const array = [...this.getRepeatedSfixed64Array_(fieldNumber), ...values];
  2714. checkCriticalTypeSignedInt64Array(array);
  2715. // Needs to set it back because the default empty array was not cached.
  2716. this.setField_(fieldNumber, array, encoder);
  2717. }
  2718. /**
  2719. * Adds a single sfixed64 value into the field for the given field number.
  2720. * All values will be encoded as packed values.
  2721. * @param {number} fieldNumber
  2722. * @param {!Int64} value
  2723. */
  2724. addPackedSfixed64Element(fieldNumber, value) {
  2725. this.addRepeatedSfixed64Iterable_(
  2726. fieldNumber, [value], (writer, fieldNumber, values) => {
  2727. writer.writePackedSfixed64(fieldNumber, values);
  2728. });
  2729. }
  2730. /**
  2731. * Adds all sfixed64 values into the field for the given field number.
  2732. * All these values will be encoded as packed values.
  2733. * @param {number} fieldNumber
  2734. * @param {!Iterable<!Int64>} values
  2735. */
  2736. addPackedSfixed64Iterable(fieldNumber, values) {
  2737. this.addRepeatedSfixed64Iterable_(
  2738. fieldNumber, values, (writer, fieldNumber, values) => {
  2739. writer.writePackedSfixed64(fieldNumber, values);
  2740. });
  2741. }
  2742. /**
  2743. * Adds a single sfixed64 value into the field for the given field number.
  2744. * All values will be encoded as unpacked values.
  2745. * @param {number} fieldNumber
  2746. * @param {!Int64} value
  2747. */
  2748. addUnpackedSfixed64Element(fieldNumber, value) {
  2749. this.addRepeatedSfixed64Iterable_(
  2750. fieldNumber, [value], (writer, fieldNumber, values) => {
  2751. writer.writeRepeatedSfixed64(fieldNumber, values);
  2752. });
  2753. }
  2754. /**
  2755. * Adds all sfixed64 values into the field for the given field number.
  2756. * All these values will be encoded as unpacked values.
  2757. * @param {number} fieldNumber
  2758. * @param {!Iterable<!Int64>} values
  2759. */
  2760. addUnpackedSfixed64Iterable(fieldNumber, values) {
  2761. this.addRepeatedSfixed64Iterable_(
  2762. fieldNumber, values, (writer, fieldNumber, values) => {
  2763. writer.writeRepeatedSfixed64(fieldNumber, values);
  2764. });
  2765. }
  2766. /**
  2767. * Sets a single sfixed64 value into the field for the given field number at
  2768. * the given index. How these values are encoded depends on the given write
  2769. * function.
  2770. * @param {number} fieldNumber
  2771. * @param {number} index
  2772. * @param {!Int64} value
  2773. * @param {function(!Writer, number, !Array<!Int64>): undefined} encoder
  2774. * @throws {!Error} if index is out of range when check mode is critical
  2775. * @private
  2776. */
  2777. setRepeatedSfixed64Element_(fieldNumber, index, value, encoder) {
  2778. checkCriticalTypeSignedInt64(value);
  2779. const array = this.getRepeatedSfixed64Array_(fieldNumber);
  2780. checkCriticalElementIndex(index, array.length);
  2781. array[index] = value;
  2782. // Needs to set it back to set encoder.
  2783. this.setField_(fieldNumber, array, encoder);
  2784. }
  2785. /**
  2786. * Sets a single sfixed64 value into the field for the given field number at
  2787. * the given index. All values will be encoded as packed values.
  2788. * @param {number} fieldNumber
  2789. * @param {number} index
  2790. * @param {!Int64} value
  2791. * @throws {!Error} if index is out of range when check mode is critical
  2792. */
  2793. setPackedSfixed64Element(fieldNumber, index, value) {
  2794. this.setRepeatedSfixed64Element_(
  2795. fieldNumber, index, value, (writer, fieldNumber, values) => {
  2796. writer.writePackedSfixed64(fieldNumber, values);
  2797. });
  2798. }
  2799. /**
  2800. * Sets all sfixed64 values into the field for the given field number.
  2801. * All these values will be encoded as packed values.
  2802. * @param {number} fieldNumber
  2803. * @param {!Iterable<!Int64>} values
  2804. */
  2805. setPackedSfixed64Iterable(fieldNumber, values) {
  2806. const array = Array.from(values);
  2807. checkCriticalTypeSignedInt64Array(array);
  2808. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  2809. writer.writePackedSfixed64(fieldNumber, values);
  2810. });
  2811. }
  2812. /**
  2813. * Sets a single sfixed64 value into the field for the given field number at
  2814. * the given index. All values will be encoded as unpacked values.
  2815. * @param {number} fieldNumber
  2816. * @param {number} index
  2817. * @param {!Int64} value
  2818. * @throws {!Error} if index is out of range when check mode is critical
  2819. */
  2820. setUnpackedSfixed64Element(fieldNumber, index, value) {
  2821. this.setRepeatedSfixed64Element_(
  2822. fieldNumber, index, value, (writer, fieldNumber, values) => {
  2823. writer.writeRepeatedSfixed64(fieldNumber, values);
  2824. });
  2825. }
  2826. /**
  2827. * Sets all sfixed64 values into the field for the given field number.
  2828. * All these values will be encoded as unpacked values.
  2829. * @param {number} fieldNumber
  2830. * @param {!Iterable<!Int64>} values
  2831. */
  2832. setUnpackedSfixed64Iterable(fieldNumber, values) {
  2833. const array = Array.from(values);
  2834. checkCriticalTypeSignedInt64Array(array);
  2835. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  2836. writer.writeRepeatedSfixed64(fieldNumber, values);
  2837. });
  2838. }
  2839. /* Sint32 */
  2840. /**
  2841. * Adds all sint32 values into the field for the given field number.
  2842. * How these values are encoded depends on the given write function.
  2843. * @param {number} fieldNumber
  2844. * @param {!Iterable<number>} values
  2845. * @param {function(!Writer, number, !Array<number>): undefined} encoder
  2846. * @private
  2847. */
  2848. addRepeatedSint32Iterable_(fieldNumber, values, encoder) {
  2849. const array = [...this.getRepeatedSint32Array_(fieldNumber), ...values];
  2850. checkCriticalTypeSignedInt32Array(array);
  2851. // Needs to set it back because the default empty array was not cached.
  2852. this.setField_(fieldNumber, array, encoder);
  2853. }
  2854. /**
  2855. * Adds a single sint32 value into the field for the given field number.
  2856. * All values will be encoded as packed values.
  2857. * @param {number} fieldNumber
  2858. * @param {number} value
  2859. */
  2860. addPackedSint32Element(fieldNumber, value) {
  2861. this.addRepeatedSint32Iterable_(
  2862. fieldNumber, [value], (writer, fieldNumber, values) => {
  2863. writer.writePackedSint32(fieldNumber, values);
  2864. });
  2865. }
  2866. /**
  2867. * Adds all sint32 values into the field for the given field number.
  2868. * All these values will be encoded as packed values.
  2869. * @param {number} fieldNumber
  2870. * @param {!Iterable<number>} values
  2871. */
  2872. addPackedSint32Iterable(fieldNumber, values) {
  2873. this.addRepeatedSint32Iterable_(
  2874. fieldNumber, values, (writer, fieldNumber, values) => {
  2875. writer.writePackedSint32(fieldNumber, values);
  2876. });
  2877. }
  2878. /**
  2879. * Adds a single sint32 value into the field for the given field number.
  2880. * All values will be encoded as unpacked values.
  2881. * @param {number} fieldNumber
  2882. * @param {number} value
  2883. */
  2884. addUnpackedSint32Element(fieldNumber, value) {
  2885. this.addRepeatedSint32Iterable_(
  2886. fieldNumber, [value], (writer, fieldNumber, values) => {
  2887. writer.writeRepeatedSint32(fieldNumber, values);
  2888. });
  2889. }
  2890. /**
  2891. * Adds all sint32 values into the field for the given field number.
  2892. * All these values will be encoded as unpacked values.
  2893. * @param {number} fieldNumber
  2894. * @param {!Iterable<number>} values
  2895. */
  2896. addUnpackedSint32Iterable(fieldNumber, values) {
  2897. this.addRepeatedSint32Iterable_(
  2898. fieldNumber, values, (writer, fieldNumber, values) => {
  2899. writer.writeRepeatedSint32(fieldNumber, values);
  2900. });
  2901. }
  2902. /**
  2903. * Sets a single sint32 value into the field for the given field number at
  2904. * the given index. How these values are encoded depends on the given write
  2905. * function.
  2906. * @param {number} fieldNumber
  2907. * @param {number} index
  2908. * @param {number} value
  2909. * @param {function(!Writer, number, !Array<number>): undefined} encoder
  2910. * @throws {!Error} if index is out of range when check mode is critical
  2911. * @private
  2912. */
  2913. setRepeatedSint32Element_(fieldNumber, index, value, encoder) {
  2914. checkCriticalTypeSignedInt32(value);
  2915. const array = this.getRepeatedSint32Array_(fieldNumber);
  2916. checkCriticalElementIndex(index, array.length);
  2917. array[index] = value;
  2918. // Needs to set it back to set encoder.
  2919. this.setField_(fieldNumber, array, encoder);
  2920. }
  2921. /**
  2922. * Sets a single sint32 value into the field for the given field number at
  2923. * the given index. All values will be encoded as packed values.
  2924. * @param {number} fieldNumber
  2925. * @param {number} index
  2926. * @param {number} value
  2927. * @throws {!Error} if index is out of range when check mode is critical
  2928. */
  2929. setPackedSint32Element(fieldNumber, index, value) {
  2930. this.setRepeatedSint32Element_(
  2931. fieldNumber, index, value, (writer, fieldNumber, values) => {
  2932. writer.writePackedSint32(fieldNumber, values);
  2933. });
  2934. }
  2935. /**
  2936. * Sets all sint32 values into the field for the given field number.
  2937. * All these values will be encoded as packed values.
  2938. * @param {number} fieldNumber
  2939. * @param {!Iterable<number>} values
  2940. */
  2941. setPackedSint32Iterable(fieldNumber, values) {
  2942. const array = Array.from(values);
  2943. checkCriticalTypeSignedInt32Array(array);
  2944. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  2945. writer.writePackedSint32(fieldNumber, values);
  2946. });
  2947. }
  2948. /**
  2949. * Sets a single sint32 value into the field for the given field number at
  2950. * the given index. All values will be encoded as unpacked values.
  2951. * @param {number} fieldNumber
  2952. * @param {number} index
  2953. * @param {number} value
  2954. * @throws {!Error} if index is out of range when check mode is critical
  2955. */
  2956. setUnpackedSint32Element(fieldNumber, index, value) {
  2957. this.setRepeatedSint32Element_(
  2958. fieldNumber, index, value, (writer, fieldNumber, values) => {
  2959. writer.writeRepeatedSint32(fieldNumber, values);
  2960. });
  2961. }
  2962. /**
  2963. * Sets all sint32 values into the field for the given field number.
  2964. * All these values will be encoded as unpacked values.
  2965. * @param {number} fieldNumber
  2966. * @param {!Iterable<number>} values
  2967. */
  2968. setUnpackedSint32Iterable(fieldNumber, values) {
  2969. const array = Array.from(values);
  2970. checkCriticalTypeSignedInt32Array(array);
  2971. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  2972. writer.writeRepeatedSint32(fieldNumber, values);
  2973. });
  2974. }
  2975. /* Sint64 */
  2976. /**
  2977. * Adds all sint64 values into the field for the given field number.
  2978. * How these values are encoded depends on the given write function.
  2979. * @param {number} fieldNumber
  2980. * @param {!Iterable<!Int64>} values
  2981. * @param {function(!Writer, number, !Array<!Int64>): undefined} encoder
  2982. * @private
  2983. */
  2984. addRepeatedSint64Iterable_(fieldNumber, values, encoder) {
  2985. const array = [...this.getRepeatedSint64Array_(fieldNumber), ...values];
  2986. checkCriticalTypeSignedInt64Array(array);
  2987. // Needs to set it back because the default empty array was not cached.
  2988. this.setField_(fieldNumber, array, encoder);
  2989. }
  2990. /**
  2991. * Adds a single sint64 value into the field for the given field number.
  2992. * All values will be encoded as packed values.
  2993. * @param {number} fieldNumber
  2994. * @param {!Int64} value
  2995. */
  2996. addPackedSint64Element(fieldNumber, value) {
  2997. this.addRepeatedSint64Iterable_(
  2998. fieldNumber, [value], (writer, fieldNumber, values) => {
  2999. writer.writePackedSint64(fieldNumber, values);
  3000. });
  3001. }
  3002. /**
  3003. * Adds all sint64 values into the field for the given field number.
  3004. * All these values will be encoded as packed values.
  3005. * @param {number} fieldNumber
  3006. * @param {!Iterable<!Int64>} values
  3007. */
  3008. addPackedSint64Iterable(fieldNumber, values) {
  3009. this.addRepeatedSint64Iterable_(
  3010. fieldNumber, values, (writer, fieldNumber, values) => {
  3011. writer.writePackedSint64(fieldNumber, values);
  3012. });
  3013. }
  3014. /**
  3015. * Adds a single sint64 value into the field for the given field number.
  3016. * All values will be encoded as unpacked values.
  3017. * @param {number} fieldNumber
  3018. * @param {!Int64} value
  3019. */
  3020. addUnpackedSint64Element(fieldNumber, value) {
  3021. this.addRepeatedSint64Iterable_(
  3022. fieldNumber, [value], (writer, fieldNumber, values) => {
  3023. writer.writeRepeatedSint64(fieldNumber, values);
  3024. });
  3025. }
  3026. /**
  3027. * Adds all sint64 values into the field for the given field number.
  3028. * All these values will be encoded as unpacked values.
  3029. * @param {number} fieldNumber
  3030. * @param {!Iterable<!Int64>} values
  3031. */
  3032. addUnpackedSint64Iterable(fieldNumber, values) {
  3033. this.addRepeatedSint64Iterable_(
  3034. fieldNumber, values, (writer, fieldNumber, values) => {
  3035. writer.writeRepeatedSint64(fieldNumber, values);
  3036. });
  3037. }
  3038. /**
  3039. * Sets a single sint64 value into the field for the given field number at
  3040. * the given index. How these values are encoded depends on the given write
  3041. * function.
  3042. * @param {number} fieldNumber
  3043. * @param {number} index
  3044. * @param {!Int64} value
  3045. * @param {function(!Writer, number, !Array<!Int64>): undefined} encoder
  3046. * @throws {!Error} if index is out of range when check mode is critical
  3047. * @private
  3048. */
  3049. setRepeatedSint64Element_(fieldNumber, index, value, encoder) {
  3050. checkCriticalTypeSignedInt64(value);
  3051. const array = this.getRepeatedSint64Array_(fieldNumber);
  3052. checkCriticalElementIndex(index, array.length);
  3053. array[index] = value;
  3054. // Needs to set it back to set encoder.
  3055. this.setField_(fieldNumber, array, encoder);
  3056. }
  3057. /**
  3058. * Sets a single sint64 value into the field for the given field number at
  3059. * the given index. All values will be encoded as packed values.
  3060. * @param {number} fieldNumber
  3061. * @param {number} index
  3062. * @param {!Int64} value
  3063. * @throws {!Error} if index is out of range when check mode is critical
  3064. */
  3065. setPackedSint64Element(fieldNumber, index, value) {
  3066. this.setRepeatedSint64Element_(
  3067. fieldNumber, index, value, (writer, fieldNumber, values) => {
  3068. writer.writePackedSint64(fieldNumber, values);
  3069. });
  3070. }
  3071. /**
  3072. * Sets all sint64 values into the field for the given field number.
  3073. * All these values will be encoded as packed values.
  3074. * @param {number} fieldNumber
  3075. * @param {!Iterable<!Int64>} values
  3076. */
  3077. setPackedSint64Iterable(fieldNumber, values) {
  3078. const array = Array.from(values);
  3079. checkCriticalTypeSignedInt64Array(array);
  3080. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  3081. writer.writePackedSint64(fieldNumber, values);
  3082. });
  3083. }
  3084. /**
  3085. * Sets a single sint64 value into the field for the given field number at
  3086. * the given index. All values will be encoded as unpacked values.
  3087. * @param {number} fieldNumber
  3088. * @param {number} index
  3089. * @param {!Int64} value
  3090. * @throws {!Error} if index is out of range when check mode is critical
  3091. */
  3092. setUnpackedSint64Element(fieldNumber, index, value) {
  3093. this.setRepeatedSint64Element_(
  3094. fieldNumber, index, value, (writer, fieldNumber, values) => {
  3095. writer.writeRepeatedSint64(fieldNumber, values);
  3096. });
  3097. }
  3098. /**
  3099. * Sets all sint64 values into the field for the given field number.
  3100. * All these values will be encoded as unpacked values.
  3101. * @param {number} fieldNumber
  3102. * @param {!Iterable<!Int64>} values
  3103. */
  3104. setUnpackedSint64Iterable(fieldNumber, values) {
  3105. const array = Array.from(values);
  3106. checkCriticalTypeSignedInt64Array(array);
  3107. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  3108. writer.writeRepeatedSint64(fieldNumber, values);
  3109. });
  3110. }
  3111. /* Uint32 */
  3112. /**
  3113. * Adds all uint32 values into the field for the given field number.
  3114. * How these values are encoded depends on the given write function.
  3115. * @param {number} fieldNumber
  3116. * @param {!Iterable<number>} values
  3117. * @param {function(!Writer, number, !Array<number>): undefined} encoder
  3118. * @private
  3119. */
  3120. addRepeatedUint32Iterable_(fieldNumber, values, encoder) {
  3121. const array = [...this.getRepeatedUint32Array_(fieldNumber), ...values];
  3122. checkCriticalTypeUnsignedInt32Array(array);
  3123. // Needs to set it back because the default empty array was not cached.
  3124. this.setField_(fieldNumber, array, encoder);
  3125. }
  3126. /**
  3127. * Adds a single uint32 value into the field for the given field number.
  3128. * All values will be encoded as packed values.
  3129. * @param {number} fieldNumber
  3130. * @param {number} value
  3131. */
  3132. addPackedUint32Element(fieldNumber, value) {
  3133. this.addRepeatedUint32Iterable_(
  3134. fieldNumber, [value], (writer, fieldNumber, values) => {
  3135. writer.writePackedUint32(fieldNumber, values);
  3136. });
  3137. }
  3138. /**
  3139. * Adds all uint32 values into the field for the given field number.
  3140. * All these values will be encoded as packed values.
  3141. * @param {number} fieldNumber
  3142. * @param {!Iterable<number>} values
  3143. */
  3144. addPackedUint32Iterable(fieldNumber, values) {
  3145. this.addRepeatedUint32Iterable_(
  3146. fieldNumber, values, (writer, fieldNumber, values) => {
  3147. writer.writePackedUint32(fieldNumber, values);
  3148. });
  3149. }
  3150. /**
  3151. * Adds a single uint32 value into the field for the given field number.
  3152. * All values will be encoded as unpacked values.
  3153. * @param {number} fieldNumber
  3154. * @param {number} value
  3155. */
  3156. addUnpackedUint32Element(fieldNumber, value) {
  3157. this.addRepeatedUint32Iterable_(
  3158. fieldNumber, [value], (writer, fieldNumber, values) => {
  3159. writer.writeRepeatedUint32(fieldNumber, values);
  3160. });
  3161. }
  3162. /**
  3163. * Adds all uint32 values into the field for the given field number.
  3164. * All these values will be encoded as unpacked values.
  3165. * @param {number} fieldNumber
  3166. * @param {!Iterable<number>} values
  3167. */
  3168. addUnpackedUint32Iterable(fieldNumber, values) {
  3169. this.addRepeatedUint32Iterable_(
  3170. fieldNumber, values, (writer, fieldNumber, values) => {
  3171. writer.writeRepeatedUint32(fieldNumber, values);
  3172. });
  3173. }
  3174. /**
  3175. * Sets a single uint32 value into the field for the given field number at
  3176. * the given index. How these values are encoded depends on the given write
  3177. * function.
  3178. * @param {number} fieldNumber
  3179. * @param {number} index
  3180. * @param {number} value
  3181. * @param {function(!Writer, number, !Array<number>): undefined} encoder
  3182. * @throws {!Error} if index is out of range when check mode is critical
  3183. * @private
  3184. */
  3185. setRepeatedUint32Element_(fieldNumber, index, value, encoder) {
  3186. checkCriticalTypeUnsignedInt32(value);
  3187. const array = this.getRepeatedUint32Array_(fieldNumber);
  3188. checkCriticalElementIndex(index, array.length);
  3189. array[index] = value;
  3190. // Needs to set it back to set encoder.
  3191. this.setField_(fieldNumber, array, encoder);
  3192. }
  3193. /**
  3194. * Sets a single uint32 value into the field for the given field number at
  3195. * the given index. All values will be encoded as packed values.
  3196. * @param {number} fieldNumber
  3197. * @param {number} index
  3198. * @param {number} value
  3199. * @throws {!Error} if index is out of range when check mode is critical
  3200. */
  3201. setPackedUint32Element(fieldNumber, index, value) {
  3202. this.setRepeatedUint32Element_(
  3203. fieldNumber, index, value, (writer, fieldNumber, values) => {
  3204. writer.writePackedUint32(fieldNumber, values);
  3205. });
  3206. }
  3207. /**
  3208. * Sets all uint32 values into the field for the given field number.
  3209. * All these values will be encoded as packed values.
  3210. * @param {number} fieldNumber
  3211. * @param {!Iterable<number>} values
  3212. */
  3213. setPackedUint32Iterable(fieldNumber, values) {
  3214. const array = Array.from(values);
  3215. checkCriticalTypeUnsignedInt32Array(array);
  3216. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  3217. writer.writePackedUint32(fieldNumber, values);
  3218. });
  3219. }
  3220. /**
  3221. * Sets a single uint32 value into the field for the given field number at
  3222. * the given index. All values will be encoded as unpacked values.
  3223. * @param {number} fieldNumber
  3224. * @param {number} index
  3225. * @param {number} value
  3226. * @throws {!Error} if index is out of range when check mode is critical
  3227. */
  3228. setUnpackedUint32Element(fieldNumber, index, value) {
  3229. this.setRepeatedUint32Element_(
  3230. fieldNumber, index, value, (writer, fieldNumber, values) => {
  3231. writer.writeRepeatedUint32(fieldNumber, values);
  3232. });
  3233. }
  3234. /**
  3235. * Sets all uint32 values into the field for the given field number.
  3236. * All these values will be encoded as unpacked values.
  3237. * @param {number} fieldNumber
  3238. * @param {!Iterable<number>} values
  3239. */
  3240. setUnpackedUint32Iterable(fieldNumber, values) {
  3241. const array = Array.from(values);
  3242. checkCriticalTypeUnsignedInt32Array(array);
  3243. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  3244. writer.writeRepeatedUint32(fieldNumber, values);
  3245. });
  3246. }
  3247. /* Uint64 */
  3248. /**
  3249. * Adds a single uint64 value into the field for the given field number.
  3250. * All values will be encoded as packed values.
  3251. * @param {number} fieldNumber
  3252. * @param {!Int64} value
  3253. */
  3254. addPackedUint64Element(fieldNumber, value) {
  3255. this.addPackedInt64Element(fieldNumber, value);
  3256. }
  3257. /**
  3258. * Adds all uint64 values into the field for the given field number.
  3259. * All these values will be encoded as packed values.
  3260. * @param {number} fieldNumber
  3261. * @param {!Iterable<!Int64>} values
  3262. */
  3263. addPackedUint64Iterable(fieldNumber, values) {
  3264. this.addPackedInt64Iterable(fieldNumber, values);
  3265. }
  3266. /**
  3267. * Adds a single uint64 value into the field for the given field number.
  3268. * All values will be encoded as unpacked values.
  3269. * @param {number} fieldNumber
  3270. * @param {!Int64} value
  3271. */
  3272. addUnpackedUint64Element(fieldNumber, value) {
  3273. this.addUnpackedInt64Element(fieldNumber, value);
  3274. }
  3275. /**
  3276. * Adds all uint64 values into the field for the given field number.
  3277. * All these values will be encoded as unpacked values.
  3278. * @param {number} fieldNumber
  3279. * @param {!Iterable<!Int64>} values
  3280. */
  3281. addUnpackedUint64Iterable(fieldNumber, values) {
  3282. this.addUnpackedInt64Iterable(fieldNumber, values);
  3283. }
  3284. /**
  3285. * Sets a single uint64 value into the field for the given field number at
  3286. * the given index. All values will be encoded as packed values.
  3287. * @param {number} fieldNumber
  3288. * @param {number} index
  3289. * @param {!Int64} value
  3290. * @throws {!Error} if index is out of range when check mode is critical
  3291. */
  3292. setPackedUint64Element(fieldNumber, index, value) {
  3293. this.setPackedInt64Element(fieldNumber, index, value);
  3294. }
  3295. /**
  3296. * Sets all uint64 values into the field for the given field number.
  3297. * All these values will be encoded as packed values.
  3298. * @param {number} fieldNumber
  3299. * @param {!Iterable<!Int64>} values
  3300. */
  3301. setPackedUint64Iterable(fieldNumber, values) {
  3302. this.setPackedInt64Iterable(fieldNumber, values);
  3303. }
  3304. /**
  3305. * Sets a single uint64 value into the field for the given field number at
  3306. * the given index. All values will be encoded as unpacked values.
  3307. * @param {number} fieldNumber
  3308. * @param {number} index
  3309. * @param {!Int64} value
  3310. * @throws {!Error} if index is out of range when check mode is critical
  3311. */
  3312. setUnpackedUint64Element(fieldNumber, index, value) {
  3313. this.setUnpackedInt64Element(fieldNumber, index, value);
  3314. }
  3315. /**
  3316. * Sets all uint64 values into the field for the given field number.
  3317. * All these values will be encoded as unpacked values.
  3318. * @param {number} fieldNumber
  3319. * @param {!Iterable<!Int64>} values
  3320. */
  3321. setUnpackedUint64Iterable(fieldNumber, values) {
  3322. this.setUnpackedInt64Iterable(fieldNumber, values);
  3323. }
  3324. /* Bytes */
  3325. /**
  3326. * Sets all bytes values into the field for the given field number.
  3327. * @param {number} fieldNumber
  3328. * @param {!Iterable<!ByteString>} values
  3329. */
  3330. setRepeatedBytesIterable(fieldNumber, values) {
  3331. const /** !Array<!ByteString> */ array = Array.from(values);
  3332. checkCriticalTypeByteStringArray(array);
  3333. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  3334. writer.writeRepeatedBytes(fieldNumber, values);
  3335. });
  3336. }
  3337. /**
  3338. * Adds all bytes values into the field for the given field number.
  3339. * @param {number} fieldNumber
  3340. * @param {!Iterable<!ByteString>} values
  3341. */
  3342. addRepeatedBytesIterable(fieldNumber, values) {
  3343. const array = [...this.getRepeatedBytesArray_(fieldNumber), ...values];
  3344. checkCriticalTypeByteStringArray(array);
  3345. // Needs to set it back because the default empty array was not cached.
  3346. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  3347. writer.writeRepeatedBytes(fieldNumber, values);
  3348. });
  3349. }
  3350. /**
  3351. * Sets a single bytes value into the field for the given field number at
  3352. * the given index.
  3353. * @param {number} fieldNumber
  3354. * @param {number} index
  3355. * @param {!ByteString} value
  3356. * @throws {!Error} if index is out of range when check mode is critical
  3357. */
  3358. setRepeatedBytesElement(fieldNumber, index, value) {
  3359. checkCriticalTypeByteString(value);
  3360. const array = this.getRepeatedBytesArray_(fieldNumber);
  3361. checkCriticalElementIndex(index, array.length);
  3362. array[index] = value;
  3363. // Needs to set it back to set encoder.
  3364. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  3365. writer.writeRepeatedBytes(fieldNumber, values);
  3366. });
  3367. }
  3368. /**
  3369. * Adds a single bytes value into the field for the given field number.
  3370. * @param {number} fieldNumber
  3371. * @param {!ByteString} value
  3372. */
  3373. addRepeatedBytesElement(fieldNumber, value) {
  3374. this.addRepeatedBytesIterable(fieldNumber, [value]);
  3375. }
  3376. /* String */
  3377. /**
  3378. * Sets all string values into the field for the given field number.
  3379. * @param {number} fieldNumber
  3380. * @param {!Iterable<string>} values
  3381. */
  3382. setRepeatedStringIterable(fieldNumber, values) {
  3383. const /** !Array<string> */ array = Array.from(values);
  3384. checkCriticalTypeStringArray(array);
  3385. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  3386. writer.writeRepeatedString(fieldNumber, values);
  3387. });
  3388. }
  3389. /**
  3390. * Adds all string values into the field for the given field number.
  3391. * @param {number} fieldNumber
  3392. * @param {!Iterable<string>} values
  3393. */
  3394. addRepeatedStringIterable(fieldNumber, values) {
  3395. const array = [...this.getRepeatedStringArray_(fieldNumber), ...values];
  3396. checkCriticalTypeStringArray(array);
  3397. // Needs to set it back because the default empty array was not cached.
  3398. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  3399. writer.writeRepeatedString(fieldNumber, values);
  3400. });
  3401. }
  3402. /**
  3403. * Sets a single string value into the field for the given field number at
  3404. * the given index.
  3405. * @param {number} fieldNumber
  3406. * @param {number} index
  3407. * @param {string} value
  3408. * @throws {!Error} if index is out of range when check mode is critical
  3409. */
  3410. setRepeatedStringElement(fieldNumber, index, value) {
  3411. checkCriticalTypeString(value);
  3412. const array = this.getRepeatedStringArray_(fieldNumber);
  3413. checkCriticalElementIndex(index, array.length);
  3414. array[index] = value;
  3415. // Needs to set it back to set encoder.
  3416. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  3417. writer.writeRepeatedString(fieldNumber, values);
  3418. });
  3419. }
  3420. /**
  3421. * Adds a single string value into the field for the given field number.
  3422. * @param {number} fieldNumber
  3423. * @param {string} value
  3424. */
  3425. addRepeatedStringElement(fieldNumber, value) {
  3426. this.addRepeatedStringIterable(fieldNumber, [value]);
  3427. }
  3428. /* Message */
  3429. /**
  3430. * Sets all message values into the field for the given field number.
  3431. * @param {number} fieldNumber
  3432. * @param {!Iterable<!InternalMessage>} values
  3433. */
  3434. setRepeatedMessageIterable(fieldNumber, values) {
  3435. const /** !Array<!InternalMessage> */ array = Array.from(values);
  3436. checkCriticalTypeMessageArray(array);
  3437. this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
  3438. writeRepeatedMessage(writer, fieldNumber, values);
  3439. });
  3440. }
  3441. /**
  3442. * Adds all message values into the field for the given field number.
  3443. * @param {number} fieldNumber
  3444. * @param {!Iterable<!InternalMessage>} values
  3445. * @param {function(!Kernel):!InternalMessage} instanceCreator
  3446. * @param {number=} pivot
  3447. */
  3448. addRepeatedMessageIterable(
  3449. fieldNumber, values, instanceCreator, pivot = undefined) {
  3450. const array = [
  3451. ...this.getRepeatedMessageArray_(fieldNumber, instanceCreator, pivot),
  3452. ...values,
  3453. ];
  3454. checkCriticalTypeMessageArray(array);
  3455. // Needs to set it back with the new array.
  3456. this.setField_(
  3457. fieldNumber, array,
  3458. (writer, fieldNumber, values) =>
  3459. writeRepeatedMessage(writer, fieldNumber, values));
  3460. }
  3461. /**
  3462. * Sets a single message value into the field for the given field number at
  3463. * the given index.
  3464. * @param {number} fieldNumber
  3465. * @param {!InternalMessage} value
  3466. * @param {function(!Kernel):!InternalMessage} instanceCreator
  3467. * @param {number} index
  3468. * @param {number=} pivot
  3469. * @throws {!Error} if index is out of range when check mode is critical
  3470. */
  3471. setRepeatedMessageElement(
  3472. fieldNumber, value, instanceCreator, index, pivot = undefined) {
  3473. checkInstanceCreator(instanceCreator);
  3474. checkCriticalType(
  3475. value !== null, 'Given value is not a message instance: null');
  3476. const array =
  3477. this.getRepeatedMessageArray_(fieldNumber, instanceCreator, pivot);
  3478. checkCriticalElementIndex(index, array.length);
  3479. array[index] = value;
  3480. }
  3481. /**
  3482. * Adds a single message value into the field for the given field number.
  3483. * @param {number} fieldNumber
  3484. * @param {!InternalMessage} value
  3485. * @param {function(!Kernel):!InternalMessage} instanceCreator
  3486. * @param {number=} pivot
  3487. */
  3488. addRepeatedMessageElement(
  3489. fieldNumber, value, instanceCreator, pivot = undefined) {
  3490. this.addRepeatedMessageIterable(
  3491. fieldNumber, [value], instanceCreator, pivot);
  3492. }
  3493. }
  3494. exports = Kernel;