123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122 |
- /**
- * @fileoverview Kernel is a class to provide type-checked accessing
- * (read/write bool/int32/string/...) on binary data.
- *
- * When creating the Kernel with the binary data, there is no deep
- * decoding done (which requires full type information). The deep decoding is
- * deferred until the first time accessing (when accessors can provide
- * full type information).
- *
- * Because accessors can be statically analyzed and stripped, unlike eager
- * binary decoding (which requires the full type information of all defined
- * fields), Kernel will only need the full type information of used
- * fields.
- */
- goog.module('protobuf.runtime.Kernel');
- const BinaryStorage = goog.require('protobuf.runtime.BinaryStorage');
- const BufferDecoder = goog.require('protobuf.binary.BufferDecoder');
- const ByteString = goog.require('protobuf.ByteString');
- const Int64 = goog.require('protobuf.Int64');
- const InternalMessage = goog.require('protobuf.binary.InternalMessage');
- const Storage = goog.require('protobuf.runtime.Storage');
- const WireType = goog.require('protobuf.binary.WireType');
- const Writer = goog.require('protobuf.binary.Writer');
- const reader = goog.require('protobuf.binary.reader');
- 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');
- const {Field, IndexEntry} = goog.require('protobuf.binary.field');
- const {buildIndex} = goog.require('protobuf.binary.indexer');
- const {createTag, get32BitVarintLength, getTagLength} = goog.require('protobuf.binary.tag');
- /**
- * Validates the index entry has the correct wire type.
- * @param {!IndexEntry} indexEntry
- * @param {!WireType} expected
- */
- function validateWireType(indexEntry, expected) {
- const wireType = Field.getWireType(indexEntry);
- checkCriticalState(
- wireType === expected,
- `Expected wire type: ${expected} but found: ${wireType}`);
- }
- /**
- * Checks if the object implements InternalMessage interface.
- * @param {?} obj
- * @return {!InternalMessage}
- */
- function checkIsInternalMessage(obj) {
- const message = /** @type {!InternalMessage} */ (obj);
- checkFunctionExists(message.internalGetKernel);
- return message;
- }
- /**
- * Checks if the instanceCreator returns an instance that implements the
- * InternalMessage interface.
- * @param {function(!Kernel):T} instanceCreator
- * @template T
- */
- function checkInstanceCreator(instanceCreator) {
- if (CHECK_TYPE) {
- const emptyMessage = instanceCreator(Kernel.createEmpty());
- checkFunctionExists(emptyMessage.internalGetKernel);
- }
- }
- /**
- * Reads the last entry of the index array using the given read function.
- * This is used to implement parsing singular primitive fields.
- * @param {!Array<!IndexEntry>} indexArray
- * @param {!BufferDecoder} bufferDecoder
- * @param {function(!BufferDecoder, number):T} readFunc
- * @param {!WireType} wireType
- * @return {T}
- * @template T
- */
- function readOptional(indexArray, bufferDecoder, readFunc, wireType) {
- const index = indexArray.length - 1;
- checkElementIndex(index, indexArray.length);
- const indexEntry = indexArray[index];
- validateWireType(indexEntry, wireType);
- return readFunc(bufferDecoder, Field.getStartIndex(indexEntry));
- }
- /**
- * Converts all entries of the index array to the template type using given read
- * methods and return an Iterable containing those converted values.
- * Primitive repeated fields may be encoded either packed or unpacked. Thus, two
- * read methods are needed for those two cases.
- * This is used to implement parsing repeated primitive fields.
- * @param {!Array<!IndexEntry>} indexArray
- * @param {!BufferDecoder} bufferDecoder
- * @param {function(!BufferDecoder, number):T} singularReadFunc
- * @param {function(!BufferDecoder, number):!Array<T>} packedReadFunc
- * @param {!WireType} expectedWireType
- * @return {!Array<T>}
- * @template T
- */
- function readRepeatedPrimitive(
- indexArray, bufferDecoder, singularReadFunc, packedReadFunc,
- expectedWireType) {
- // Fast path when there is a single packed entry.
- if (indexArray.length === 1 &&
- Field.getWireType(indexArray[0]) === WireType.DELIMITED) {
- return packedReadFunc(bufferDecoder, Field.getStartIndex(indexArray[0]));
- }
- let /** !Array<T> */ result = [];
- for (const indexEntry of indexArray) {
- const wireType = Field.getWireType(indexEntry);
- const startIndex = Field.getStartIndex(indexEntry);
- if (wireType === WireType.DELIMITED) {
- result = result.concat(packedReadFunc(bufferDecoder, startIndex));
- } else {
- validateWireType(indexEntry, expectedWireType);
- result.push(singularReadFunc(bufferDecoder, startIndex));
- }
- }
- return result;
- }
- /**
- * Converts all entries of the index array to the template type using the given
- * read function and return an Array containing those converted values. This is
- * used to implement parsing repeated non-primitive fields.
- * @param {!Array<!IndexEntry>} indexArray
- * @param {!BufferDecoder} bufferDecoder
- * @param {function(!BufferDecoder, number):T} singularReadFunc
- * @return {!Array<T>}
- * @template T
- */
- function readRepeatedNonPrimitive(indexArray, bufferDecoder, singularReadFunc) {
- const result = new Array(indexArray.length);
- for (let i = 0; i < indexArray.length; i++) {
- validateWireType(indexArray[i], WireType.DELIMITED);
- result[i] =
- singularReadFunc(bufferDecoder, Field.getStartIndex(indexArray[i]));
- }
- return result;
- }
- /**
- * Converts all entries of the index array to the template type using the given
- * read function and return an Array containing those converted values. This is
- * used to implement parsing repeated non-primitive fields.
- * @param {!Array<!IndexEntry>} indexArray
- * @param {!BufferDecoder} bufferDecoder
- * @param {number} fieldNumber
- * @param {function(!Kernel):T} instanceCreator
- * @param {number=} pivot
- * @return {!Array<T>}
- * @template T
- */
- function readRepeatedGroup(
- indexArray, bufferDecoder, fieldNumber, instanceCreator, pivot) {
- const result = new Array(indexArray.length);
- for (let i = 0; i < indexArray.length; i++) {
- result[i] = doReadGroup(
- bufferDecoder, indexArray[i], fieldNumber, instanceCreator, pivot);
- }
- return result;
- }
- /**
- * Creates a new bytes array to contain all data of a submessage.
- * When there are multiple entries, merge them together.
- * @param {!Array<!IndexEntry>} indexArray
- * @param {!BufferDecoder} bufferDecoder
- * @return {!BufferDecoder}
- */
- function mergeMessageArrays(indexArray, bufferDecoder) {
- const dataArrays = indexArray.map(
- indexEntry =>
- reader.readDelimited(bufferDecoder, Field.getStartIndex(indexEntry)));
- return BufferDecoder.merge(dataArrays);
- }
- /**
- * @param {!Array<!IndexEntry>} indexArray
- * @param {!BufferDecoder} bufferDecoder
- * @param {number=} pivot
- * @return {!Kernel}
- */
- function readAccessor(indexArray, bufferDecoder, pivot = undefined) {
- checkState(indexArray.length > 0);
- let accessorBuffer;
- // Faster access for one member.
- if (indexArray.length === 1) {
- const indexEntry = indexArray[0];
- validateWireType(indexEntry, WireType.DELIMITED);
- accessorBuffer =
- reader.readDelimited(bufferDecoder, Field.getStartIndex(indexEntry));
- } else {
- indexArray.forEach(indexEntry => {
- validateWireType(indexEntry, WireType.DELIMITED);
- });
- accessorBuffer = mergeMessageArrays(indexArray, bufferDecoder);
- }
- return Kernel.fromBufferDecoder_(accessorBuffer, pivot);
- }
- /**
- * Merges all index entries of the index array using the given read function.
- * This is used to implement parsing singular message fields.
- * @param {!Array<!IndexEntry>} indexArray
- * @param {!BufferDecoder} bufferDecoder
- * @param {function(!Kernel):T} instanceCreator
- * @param {number=} pivot
- * @return {T}
- * @template T
- */
- function readMessage(indexArray, bufferDecoder, instanceCreator, pivot) {
- checkInstanceCreator(instanceCreator);
- const accessor = readAccessor(indexArray, bufferDecoder, pivot);
- return instanceCreator(accessor);
- }
- /**
- * Merges all index entries of the index array using the given read function.
- * This is used to implement parsing singular group fields.
- * @param {!Array<!IndexEntry>} indexArray
- * @param {!BufferDecoder} bufferDecoder
- * @param {number} fieldNumber
- * @param {function(!Kernel):T} instanceCreator
- * @param {number=} pivot
- * @return {T}
- * @template T
- */
- function readGroup(
- indexArray, bufferDecoder, fieldNumber, instanceCreator, pivot) {
- checkInstanceCreator(instanceCreator);
- checkState(indexArray.length > 0);
- return doReadGroup(
- bufferDecoder, indexArray[indexArray.length - 1], fieldNumber,
- instanceCreator, pivot);
- }
- /**
- * Merges all index entries of the index array using the given read function.
- * This is used to implement parsing singular message fields.
- * @param {!BufferDecoder} bufferDecoder
- * @param {!IndexEntry} indexEntry
- * @param {number} fieldNumber
- * @param {function(!Kernel):T} instanceCreator
- * @param {number=} pivot
- * @return {T}
- * @template T
- */
- function doReadGroup(
- bufferDecoder, indexEntry, fieldNumber, instanceCreator, pivot) {
- validateWireType(indexEntry, WireType.START_GROUP);
- const fieldStartIndex = Field.getStartIndex(indexEntry);
- const tag = createTag(WireType.START_GROUP, fieldNumber);
- const groupTagLength = get32BitVarintLength(tag);
- const groupLength = getTagLength(
- bufferDecoder, fieldStartIndex, WireType.START_GROUP, fieldNumber);
- const accessorBuffer = bufferDecoder.subBufferDecoder(
- fieldStartIndex, groupLength - groupTagLength);
- const kernel = Kernel.fromBufferDecoder_(accessorBuffer, pivot);
- return instanceCreator(kernel);
- }
- /**
- * @param {!Writer} writer
- * @param {number} fieldNumber
- * @param {?InternalMessage} value
- */
- function writeMessage(writer, fieldNumber, value) {
- writer.writeDelimited(
- fieldNumber, checkDefAndNotNull(value).internalGetKernel().serialize());
- }
- /**
- * @param {!Writer} writer
- * @param {number} fieldNumber
- * @param {?InternalMessage} value
- */
- function writeGroup(writer, fieldNumber, value) {
- const kernel = checkDefAndNotNull(value).internalGetKernel();
- writer.writeStartGroup(fieldNumber);
- kernel.serializeToWriter(writer);
- writer.writeEndGroup(fieldNumber);
- }
- /**
- * Writes the array of Messages into the writer for the given field number.
- * @param {!Writer} writer
- * @param {number} fieldNumber
- * @param {!Iterable<!InternalMessage>} values
- */
- function writeRepeatedMessage(writer, fieldNumber, values) {
- for (const value of values) {
- writeMessage(writer, fieldNumber, value);
- }
- }
- /**
- * Writes the array of Messages into the writer for the given field number.
- * @param {!Writer} writer
- * @param {number} fieldNumber
- * @param {!Array<!InternalMessage>} values
- */
- function writeRepeatedGroup(writer, fieldNumber, values) {
- for (const value of values) {
- writeGroup(writer, fieldNumber, value);
- }
- }
- /**
- * Array.from has a weird type definition in google3/javascript/externs/es6.js
- * and wants the mapping function accept strings.
- * @const {function((string|number)): number}
- */
- const fround = /** @type {function((string|number)): number} */ (Math.fround);
- /**
- * Wraps an array and exposes it as an Iterable. This class is used to provide
- * immutable access of the array to the caller.
- * @implements {Iterable<T>}
- * @template T
- */
- class ArrayIterable {
- /**
- * @param {!Array<T>} array
- */
- constructor(array) {
- /** @private @const {!Array<T>} */
- this.array_ = array;
- }
- /** @return {!Iterator<T>} */
- [Symbol.iterator]() {
- return this.array_[Symbol.iterator]();
- }
- }
- /**
- * Accesses protobuf fields on binary format data. Binary data is decoded lazily
- * at the first access.
- * @final
- */
- class Kernel {
- /**
- * Create a Kernel for the given binary bytes.
- * The bytes array is kept by the Kernel. DON'T MODIFY IT.
- * @param {!ArrayBuffer} arrayBuffer Binary bytes.
- * @param {number=} pivot Fields with a field number no greater than the pivot
- * value will be stored in an array for fast access. Other fields will be
- * stored in a map. A higher pivot value can improve runtime performance
- * at the expense of requiring more memory. It's recommended to set the
- * value to the max field number of the message unless the field numbers
- * are too sparse. If the value is not set, a default value specified in
- * storage.js will be used.
- * @return {!Kernel}
- */
- static fromArrayBuffer(arrayBuffer, pivot = undefined) {
- const bufferDecoder = BufferDecoder.fromArrayBuffer(arrayBuffer);
- return Kernel.fromBufferDecoder_(bufferDecoder, pivot);
- }
- /**
- * Creates an empty Kernel.
- * @param {number=} pivot Fields with a field number no greater than the pivot
- * value will be stored in an array for fast access. Other fields will be
- * stored in a map. A higher pivot value can improve runtime performance
- * at the expense of requiring more memory. It's recommended to set the
- * value to the max field number of the message unless the field numbers
- * are too sparse. If the value is not set, a default value specified in
- * storage.js will be used.
- * @return {!Kernel}
- */
- static createEmpty(pivot = undefined) {
- return new Kernel(/* bufferDecoder= */ null, new BinaryStorage(pivot));
- }
- /**
- * Create a Kernel for the given binary bytes.
- * The bytes array is kept by the Kernel. DON'T MODIFY IT.
- * @param {!BufferDecoder} bufferDecoder Binary bytes.
- * @param {number|undefined} pivot
- * @return {!Kernel}
- * @private
- */
- static fromBufferDecoder_(bufferDecoder, pivot) {
- return new Kernel(bufferDecoder, buildIndex(bufferDecoder, pivot));
- }
- /**
- * @param {?BufferDecoder} bufferDecoder Binary bytes. Accessor treats the
- * bytes as immutable and will never attempt to write to it.
- * @param {!Storage<!Field>} fields A map of field number to Field. The
- * IndexEntry in each Field needs to be populated with the location of the
- * field in the binary data.
- * @private
- */
- constructor(bufferDecoder, fields) {
- /** @private @const {?BufferDecoder} */
- this.bufferDecoder_ = bufferDecoder;
- /** @private @const {!Storage<!Field>} */
- this.fields_ = fields;
- }
- /**
- * Creates a shallow copy of the accessor.
- * @return {!Kernel}
- */
- shallowCopy() {
- return new Kernel(this.bufferDecoder_, this.fields_.shallowCopy());
- }
- /**
- * See definition of the pivot parameter on the fromArrayBuffer() method.
- * @return {number}
- */
- getPivot() {
- return this.fields_.getPivot();
- }
- /**
- * Clears the field for the given field number.
- * @param {number} fieldNumber
- */
- clearField(fieldNumber) {
- this.fields_.delete(fieldNumber);
- }
- /**
- * Returns data for a field specified by the given field number. Also cache
- * the data if it doesn't already exist in the cache. When no data is
- * available, return the given default value.
- * @param {number} fieldNumber
- * @param {?T} defaultValue
- * @param {function(!Array<!IndexEntry>, !BufferDecoder):T} readFunc
- * @param {function(!Writer, number, T)=} encoder
- * @return {T}
- * @template T
- * @private
- */
- getFieldWithDefault_(
- fieldNumber, defaultValue, readFunc, encoder = undefined) {
- checkFieldNumber(fieldNumber);
- const field = this.fields_.get(fieldNumber);
- if (field === undefined) {
- return defaultValue;
- }
- if (field.hasDecodedValue()) {
- checkState(!encoder || !!field.getEncoder());
- return field.getDecodedValue();
- }
- const parsed = readFunc(
- checkDefAndNotNull(field.getIndexArray()),
- checkDefAndNotNull(this.bufferDecoder_));
- field.setCache(parsed, encoder);
- return parsed;
- }
- /**
- * Sets data for a singular field specified by the given field number.
- * @param {number} fieldNumber
- * @param {T} value
- * @param {function(!Writer, number, T)} encoder
- * @return {T}
- * @template T
- * @private
- */
- setField_(fieldNumber, value, encoder) {
- checkFieldNumber(fieldNumber);
- this.fields_.set(fieldNumber, Field.fromDecodedValue(value, encoder));
- }
- /**
- * Serializes internal contents to binary format bytes array to the
- * given writer.
- * @param {!Writer} writer
- * @package
- */
- serializeToWriter(writer) {
- // If we use for...of here, jscompiler returns an array of both types for
- // fieldNumber and field without specifying which type is for
- // field, which prevents us to use fieldNumber. Thus, we use
- // forEach here.
- this.fields_.forEach((field, fieldNumber) => {
- // If encoder doesn't exist, there is no need to encode the value
- // because the data in the index is still valid.
- if (field.getEncoder() !== undefined) {
- const encoder = checkDefAndNotNull(field.getEncoder());
- encoder(writer, fieldNumber, field.getDecodedValue());
- return;
- }
- const indexArr = field.getIndexArray();
- if (indexArr) {
- for (const indexEntry of indexArr) {
- writer.writeTag(fieldNumber, Field.getWireType(indexEntry));
- writer.writeBufferDecoder(
- checkDefAndNotNull(this.bufferDecoder_),
- Field.getStartIndex(indexEntry), Field.getWireType(indexEntry),
- fieldNumber);
- }
- }
- });
- }
- /**
- * Serializes internal contents to binary format bytes array.
- * @return {!ArrayBuffer}
- */
- serialize() {
- const writer = new Writer();
- this.serializeToWriter(writer);
- return writer.getAndResetResultBuffer();
- }
- /**
- * Returns whether data exists at the given field number.
- * @param {number} fieldNumber
- * @return {boolean}
- */
- hasFieldNumber(fieldNumber) {
- checkFieldNumber(fieldNumber);
- const field = this.fields_.get(fieldNumber);
- if (field === undefined) {
- return false;
- }
- if (field.getIndexArray() !== null) {
- return true;
- }
- if (Array.isArray(field.getDecodedValue())) {
- // For repeated fields, existence is decided by number of elements.
- return (/** !Array<?> */ (field.getDecodedValue())).length > 0;
- }
- return true;
- }
- /***************************************************************************
- * OPTIONAL GETTER METHODS
- ***************************************************************************/
- /**
- * Returns data as boolean for the given field number.
- * If no default is given, use false as the default.
- * @param {number} fieldNumber
- * @param {boolean=} defaultValue
- * @return {boolean}
- */
- getBoolWithDefault(fieldNumber, defaultValue = false) {
- return this.getFieldWithDefault_(
- fieldNumber, defaultValue,
- (indexArray, bytes) =>
- readOptional(indexArray, bytes, reader.readBool, WireType.VARINT));
- }
- /**
- * Returns data as a ByteString for the given field number.
- * If no default is given, use false as the default.
- * @param {number} fieldNumber
- * @param {!ByteString=} defaultValue
- * @return {!ByteString}
- */
- getBytesWithDefault(fieldNumber, defaultValue = ByteString.EMPTY) {
- return this.getFieldWithDefault_(
- fieldNumber, defaultValue,
- (indexArray, bytes) => readOptional(
- indexArray, bytes, reader.readBytes, WireType.DELIMITED));
- }
- /**
- * Returns a double for the given field number.
- * If no default is given uses zero as the default.
- * @param {number} fieldNumber
- * @param {number=} defaultValue
- * @return {number}
- */
- getDoubleWithDefault(fieldNumber, defaultValue = 0) {
- checkTypeDouble(defaultValue);
- return this.getFieldWithDefault_(
- fieldNumber, defaultValue,
- (indexArray, bytes) => readOptional(
- indexArray, bytes, reader.readDouble, WireType.FIXED64));
- }
- /**
- * Returns a fixed32 for the given field number.
- * If no default is given zero as the default.
- * @param {number} fieldNumber
- * @param {number=} defaultValue
- * @return {number}
- */
- getFixed32WithDefault(fieldNumber, defaultValue = 0) {
- checkTypeUnsignedInt32(defaultValue);
- return this.getFieldWithDefault_(
- fieldNumber, defaultValue,
- (indexArray, bytes) => readOptional(
- indexArray, bytes, reader.readFixed32, WireType.FIXED32));
- }
- /**
- * Returns a fixed64 for the given field number.
- * Note: Since g.m.Long does not support unsigned int64 values we are going
- * the Java route here for now and simply output the number as a signed int64.
- * Users can get to individual bits by themselves.
- * @param {number} fieldNumber
- * @param {!Int64=} defaultValue
- * @return {!Int64}
- */
- getFixed64WithDefault(fieldNumber, defaultValue = Int64.getZero()) {
- return this.getSfixed64WithDefault(fieldNumber, defaultValue);
- }
- /**
- * Returns a float for the given field number.
- * If no default is given zero as the default.
- * @param {number} fieldNumber
- * @param {number=} defaultValue
- * @return {number}
- */
- getFloatWithDefault(fieldNumber, defaultValue = 0) {
- checkTypeFloat(defaultValue);
- return this.getFieldWithDefault_(
- fieldNumber, defaultValue,
- (indexArray, bytes) => readOptional(
- indexArray, bytes, reader.readFloat, WireType.FIXED32));
- }
- /**
- * Returns a int32 for the given field number.
- * If no default is given zero as the default.
- * @param {number} fieldNumber
- * @param {number=} defaultValue
- * @return {number}
- */
- getInt32WithDefault(fieldNumber, defaultValue = 0) {
- checkTypeSignedInt32(defaultValue);
- return this.getFieldWithDefault_(
- fieldNumber, defaultValue,
- (indexArray, bytes) =>
- readOptional(indexArray, bytes, reader.readInt32, WireType.VARINT));
- }
- /**
- * Returns a int64 for the given field number.
- * If no default is given zero as the default.
- * @param {number} fieldNumber
- * @param {!Int64=} defaultValue
- * @return {!Int64}
- */
- getInt64WithDefault(fieldNumber, defaultValue = Int64.getZero()) {
- checkTypeSignedInt64(defaultValue);
- return this.getFieldWithDefault_(
- fieldNumber, defaultValue,
- (indexArray, bytes) =>
- readOptional(indexArray, bytes, reader.readInt64, WireType.VARINT));
- }
- /**
- * Returns a sfixed32 for the given field number.
- * If no default is given zero as the default.
- * @param {number} fieldNumber
- * @param {number=} defaultValue
- * @return {number}
- */
- getSfixed32WithDefault(fieldNumber, defaultValue = 0) {
- checkTypeSignedInt32(defaultValue);
- return this.getFieldWithDefault_(
- fieldNumber, defaultValue,
- (indexArray, bytes) => readOptional(
- indexArray, bytes, reader.readSfixed32, WireType.FIXED32));
- }
- /**
- * Returns a sfixed64 for the given field number.
- * If no default is given zero as the default.
- * @param {number} fieldNumber
- * @param {!Int64=} defaultValue
- * @return {!Int64}
- */
- getSfixed64WithDefault(fieldNumber, defaultValue = Int64.getZero()) {
- checkTypeSignedInt64(defaultValue);
- return this.getFieldWithDefault_(
- fieldNumber, defaultValue,
- (indexArray, bytes) => readOptional(
- indexArray, bytes, reader.readSfixed64, WireType.FIXED64));
- }
- /**
- * Returns a sint32 for the given field number.
- * If no default is given zero as the default.
- * @param {number} fieldNumber
- * @param {number=} defaultValue
- * @return {number}
- */
- getSint32WithDefault(fieldNumber, defaultValue = 0) {
- checkTypeSignedInt32(defaultValue);
- return this.getFieldWithDefault_(
- fieldNumber, defaultValue,
- (indexArray, bytes) => readOptional(
- indexArray, bytes, reader.readSint32, WireType.VARINT));
- }
- /**
- * Returns a sint64 for the given field number.
- * If no default is given zero as the default.
- * @param {number} fieldNumber
- * @param {!Int64=} defaultValue
- * @return {!Int64}
- */
- getSint64WithDefault(fieldNumber, defaultValue = Int64.getZero()) {
- checkTypeSignedInt64(defaultValue);
- return this.getFieldWithDefault_(
- fieldNumber, defaultValue,
- (indexArray, bytes) => readOptional(
- indexArray, bytes, reader.readSint64, WireType.VARINT));
- }
- /**
- * Returns a string for the given field number.
- * If no default is given uses empty string as the default.
- * @param {number} fieldNumber
- * @param {string=} defaultValue
- * @return {string}
- */
- getStringWithDefault(fieldNumber, defaultValue = '') {
- return this.getFieldWithDefault_(
- fieldNumber, defaultValue,
- (indexArray, bytes) => readOptional(
- indexArray, bytes, reader.readString, WireType.DELIMITED));
- }
- /**
- * Returns a uint32 for the given field number.
- * If no default is given zero as the default.
- * @param {number} fieldNumber
- * @param {number=} defaultValue
- * @return {number}
- */
- getUint32WithDefault(fieldNumber, defaultValue = 0) {
- checkTypeUnsignedInt32(defaultValue);
- return this.getFieldWithDefault_(
- fieldNumber, defaultValue,
- (indexArray, bytes) => readOptional(
- indexArray, bytes, reader.readUint32, WireType.VARINT));
- }
- /**
- * Returns a uint64 for the given field number.
- * Note: Since g.m.Long does not support unsigned int64 values we are going
- * the Java route here for now and simply output the number as a signed int64.
- * Users can get to individual bits by themselves.
- * @param {number} fieldNumber
- * @param {!Int64=} defaultValue
- * @return {!Int64}
- */
- getUint64WithDefault(fieldNumber, defaultValue = Int64.getZero()) {
- return this.getInt64WithDefault(fieldNumber, defaultValue);
- }
- /**
- * Returns data as a mutable proto Message for the given field number.
- * If no value has been set, return null.
- * If hasFieldNumber(fieldNumber) == false before calling, it remains false.
- *
- * This method should not be used along with getMessage, since calling
- * getMessageOrNull after getMessage will not register the encoder.
- *
- * @param {number} fieldNumber
- * @param {function(!Kernel):T} instanceCreator
- * @param {number=} pivot
- * @return {?T}
- * @template T
- */
- getMessageOrNull(fieldNumber, instanceCreator, pivot = undefined) {
- return this.getFieldWithDefault_(
- fieldNumber, null,
- (indexArray, bytes) =>
- readMessage(indexArray, bytes, instanceCreator, pivot),
- writeMessage);
- }
- /**
- * Returns data as a mutable proto Message for the given field number.
- * If no value has been set, return null.
- * If hasFieldNumber(fieldNumber) == false before calling, it remains false.
- *
- * This method should not be used along with getMessage, since calling
- * getMessageOrNull after getMessage will not register the encoder.
- *
- * @param {number} fieldNumber
- * @param {function(!Kernel):T} instanceCreator
- * @param {number=} pivot
- * @return {?T}
- * @template T
- */
- getGroupOrNull(fieldNumber, instanceCreator, pivot = undefined) {
- return this.getFieldWithDefault_(
- fieldNumber, null,
- (indexArray, bytes) =>
- readGroup(indexArray, bytes, fieldNumber, instanceCreator, pivot),
- writeGroup);
- }
- /**
- * Returns data as a mutable proto Message for the given field number.
- * If no value has been set previously, creates and attaches an instance.
- * Postcondition: hasFieldNumber(fieldNumber) == true.
- *
- * This method should not be used along with getMessage, since calling
- * getMessageAttach after getMessage will not register the encoder.
- *
- * @param {number} fieldNumber
- * @param {function(!Kernel):T} instanceCreator
- * @param {number=} pivot
- * @return {T}
- * @template T
- */
- getMessageAttach(fieldNumber, instanceCreator, pivot = undefined) {
- checkInstanceCreator(instanceCreator);
- let instance = this.getMessageOrNull(fieldNumber, instanceCreator, pivot);
- if (!instance) {
- instance = instanceCreator(Kernel.createEmpty());
- this.setField_(fieldNumber, instance, writeMessage);
- }
- return instance;
- }
- /**
- * Returns data as a mutable proto Message for the given field number.
- * If no value has been set previously, creates and attaches an instance.
- * Postcondition: hasFieldNumber(fieldNumber) == true.
- *
- * This method should not be used along with getMessage, since calling
- * getMessageAttach after getMessage will not register the encoder.
- *
- * @param {number} fieldNumber
- * @param {function(!Kernel):T} instanceCreator
- * @param {number=} pivot
- * @return {T}
- * @template T
- */
- getGroupAttach(fieldNumber, instanceCreator, pivot = undefined) {
- checkInstanceCreator(instanceCreator);
- let instance = this.getGroupOrNull(fieldNumber, instanceCreator, pivot);
- if (!instance) {
- instance = instanceCreator(Kernel.createEmpty());
- this.setField_(fieldNumber, instance, writeGroup);
- }
- return instance;
- }
- /**
- * Returns data as a proto Message for the given field number.
- * If no value has been set, return a default instance.
- * This default instance is guaranteed to be the same instance, unless this
- * field is cleared.
- * Does not register the encoder, so changes made to the returned
- * sub-message will not be included when serializing the parent message.
- * Use getMessageAttach() if the resulting sub-message should be mutable.
- *
- * This method should not be used along with getMessageOrNull or
- * getMessageAttach, since these methods register the encoder.
- *
- * @param {number} fieldNumber
- * @param {function(!Kernel):T} instanceCreator
- * @param {number=} pivot
- * @return {T}
- * @template T
- */
- getMessage(fieldNumber, instanceCreator, pivot = undefined) {
- checkInstanceCreator(instanceCreator);
- const message = this.getFieldWithDefault_(
- fieldNumber, null,
- (indexArray, bytes) =>
- readMessage(indexArray, bytes, instanceCreator, pivot));
- // Returns an empty message as the default value if the field doesn't exist.
- // We don't pass the default value to getFieldWithDefault_ to reduce object
- // allocation.
- return message === null ? instanceCreator(Kernel.createEmpty()) : message;
- }
- /**
- * Returns data as a proto Message for the given field number.
- * If no value has been set, return a default instance.
- * This default instance is guaranteed to be the same instance, unless this
- * field is cleared.
- * Does not register the encoder, so changes made to the returned
- * sub-message will not be included when serializing the parent message.
- * Use getMessageAttach() if the resulting sub-message should be mutable.
- *
- * This method should not be used along with getMessageOrNull or
- * getMessageAttach, since these methods register the encoder.
- *
- * @param {number} fieldNumber
- * @param {function(!Kernel):T} instanceCreator
- * @param {number=} pivot
- * @return {T}
- * @template T
- */
- getGroup(fieldNumber, instanceCreator, pivot = undefined) {
- checkInstanceCreator(instanceCreator);
- const message = this.getFieldWithDefault_(
- fieldNumber, null,
- (indexArray, bytes) =>
- readGroup(indexArray, bytes, fieldNumber, instanceCreator, pivot));
- // Returns an empty message as the default value if the field doesn't exist.
- // We don't pass the default value to getFieldWithDefault_ to reduce object
- // allocation.
- return message === null ? instanceCreator(Kernel.createEmpty()) : message;
- }
- /**
- * Returns the accessor for the given singular message, or returns null if
- * it hasn't been set.
- * @param {number} fieldNumber
- * @param {number=} pivot
- * @return {?Kernel}
- */
- getMessageAccessorOrNull(fieldNumber, pivot = undefined) {
- checkFieldNumber(fieldNumber);
- const field = this.fields_.get(fieldNumber);
- if (field === undefined) {
- return null;
- }
- if (field.hasDecodedValue()) {
- return checkIsInternalMessage(field.getDecodedValue())
- .internalGetKernel();
- } else {
- return readAccessor(
- checkDefAndNotNull(field.getIndexArray()),
- checkDefAndNotNull(this.bufferDecoder_), pivot);
- }
- }
- /***************************************************************************
- * REPEATED GETTER METHODS
- ***************************************************************************/
- /* Bool */
- /**
- * Returns an Array instance containing boolean values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Array<boolean>}
- * @private
- */
- getRepeatedBoolArray_(fieldNumber) {
- return this.getFieldWithDefault_(
- fieldNumber, /* defaultValue= */[],
- (indexArray, bytes) => readRepeatedPrimitive(
- indexArray, bytes, reader.readBool, reader.readPackedBool,
- WireType.VARINT));
- }
- /**
- * Returns the element at index for the given field number.
- * @param {number} fieldNumber
- * @param {number} index
- * @return {boolean}
- */
- getRepeatedBoolElement(fieldNumber, index) {
- const array = this.getRepeatedBoolArray_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- return array[index];
- }
- /**
- * Returns an Iterable instance containing boolean values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Iterable<boolean>}
- */
- getRepeatedBoolIterable(fieldNumber) {
- // Don't split this statement unless needed. JS compiler thinks
- // getRepeatedBoolArray_ might have side effects and doesn't inline the
- // call in the compiled code. See cl/293894484 for details.
- return new ArrayIterable(this.getRepeatedBoolArray_(fieldNumber));
- }
- /**
- * Returns the size of the repeated field.
- * @param {number} fieldNumber
- * @return {number}
- */
- getRepeatedBoolSize(fieldNumber) {
- return this.getRepeatedBoolArray_(fieldNumber).length;
- }
- /* Double */
- /**
- * Returns an Array instance containing double values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Array<number>}
- * @private
- */
- getRepeatedDoubleArray_(fieldNumber) {
- return this.getFieldWithDefault_(
- fieldNumber, /* defaultValue= */[],
- (indexArray, bytes) => readRepeatedPrimitive(
- indexArray, bytes, reader.readDouble, reader.readPackedDouble,
- WireType.FIXED64));
- }
- /**
- * Returns the element at index for the given field number.
- * @param {number} fieldNumber
- * @param {number} index
- * @return {number}
- */
- getRepeatedDoubleElement(fieldNumber, index) {
- const array = this.getRepeatedDoubleArray_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- return array[index];
- }
- /**
- * Returns an Iterable instance containing double values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Iterable<number>}
- */
- getRepeatedDoubleIterable(fieldNumber) {
- // Don't split this statement unless needed. JS compiler thinks
- // getRepeatedDoubleArray_ might have side effects and doesn't inline the
- // call in the compiled code. See cl/293894484 for details.
- return new ArrayIterable(this.getRepeatedDoubleArray_(fieldNumber));
- }
- /**
- * Returns the size of the repeated field.
- * @param {number} fieldNumber
- * @return {number}
- */
- getRepeatedDoubleSize(fieldNumber) {
- return this.getRepeatedDoubleArray_(fieldNumber).length;
- }
- /* Fixed32 */
- /**
- * Returns an Array instance containing fixed32 values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Array<number>}
- * @private
- */
- getRepeatedFixed32Array_(fieldNumber) {
- return this.getFieldWithDefault_(
- fieldNumber, /* defaultValue= */[],
- (indexArray, bytes) => readRepeatedPrimitive(
- indexArray, bytes, reader.readFixed32, reader.readPackedFixed32,
- WireType.FIXED32));
- }
- /**
- * Returns the element at index for the given field number.
- * @param {number} fieldNumber
- * @param {number} index
- * @return {number}
- */
- getRepeatedFixed32Element(fieldNumber, index) {
- const array = this.getRepeatedFixed32Array_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- return array[index];
- }
- /**
- * Returns an Iterable instance containing fixed32 values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Iterable<number>}
- */
- getRepeatedFixed32Iterable(fieldNumber) {
- // Don't split this statement unless needed. JS compiler thinks
- // getRepeatedFixed32Array_ might have side effects and doesn't inline the
- // call in the compiled code. See cl/293894484 for details.
- return new ArrayIterable(this.getRepeatedFixed32Array_(fieldNumber));
- }
- /**
- * Returns the size of the repeated field.
- * @param {number} fieldNumber
- * @return {number}
- */
- getRepeatedFixed32Size(fieldNumber) {
- return this.getRepeatedFixed32Array_(fieldNumber).length;
- }
- /* Fixed64 */
- /**
- * Returns the element at index for the given field number.
- * @param {number} fieldNumber
- * @param {number} index
- * @return {!Int64}
- */
- getRepeatedFixed64Element(fieldNumber, index) {
- return this.getRepeatedSfixed64Element(fieldNumber, index);
- }
- /**
- * Returns an Iterable instance containing fixed64 values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Iterable<!Int64>}
- */
- getRepeatedFixed64Iterable(fieldNumber) {
- return this.getRepeatedSfixed64Iterable(fieldNumber);
- }
- /**
- * Returns the size of the repeated field.
- * @param {number} fieldNumber
- * @return {number}
- */
- getRepeatedFixed64Size(fieldNumber) {
- return this.getRepeatedSfixed64Size(fieldNumber);
- }
- /* Float */
- /**
- * Returns an Array instance containing float values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Array<number>}
- * @private
- */
- getRepeatedFloatArray_(fieldNumber) {
- return this.getFieldWithDefault_(
- fieldNumber, /* defaultValue= */[],
- (indexArray, bytes) => readRepeatedPrimitive(
- indexArray, bytes, reader.readFloat, reader.readPackedFloat,
- WireType.FIXED32));
- }
- /**
- * Returns the element at index for the given field number.
- * @param {number} fieldNumber
- * @param {number} index
- * @return {number}
- */
- getRepeatedFloatElement(fieldNumber, index) {
- const array = this.getRepeatedFloatArray_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- return array[index];
- }
- /**
- * Returns an Iterable instance containing float values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Iterable<number>}
- */
- getRepeatedFloatIterable(fieldNumber) {
- // Don't split this statement unless needed. JS compiler thinks
- // getRepeatedFloatArray_ might have side effects and doesn't inline the
- // call in the compiled code. See cl/293894484 for details.
- return new ArrayIterable(this.getRepeatedFloatArray_(fieldNumber));
- }
- /**
- * Returns the size of the repeated field.
- * @param {number} fieldNumber
- * @return {number}
- */
- getRepeatedFloatSize(fieldNumber) {
- return this.getRepeatedFloatArray_(fieldNumber).length;
- }
- /* Int32 */
- /**
- * Returns an Array instance containing int32 values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Array<number>}
- * @private
- */
- getRepeatedInt32Array_(fieldNumber) {
- return this.getFieldWithDefault_(
- fieldNumber, /* defaultValue= */[],
- (indexArray, bytes) => readRepeatedPrimitive(
- indexArray, bytes, reader.readInt32, reader.readPackedInt32,
- WireType.VARINT));
- }
- /**
- * Returns the element at index for the given field number.
- * @param {number} fieldNumber
- * @param {number} index
- * @return {number}
- */
- getRepeatedInt32Element(fieldNumber, index) {
- const array = this.getRepeatedInt32Array_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- return array[index];
- }
- /**
- * Returns an Iterable instance containing int32 values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Iterable<number>}
- */
- getRepeatedInt32Iterable(fieldNumber) {
- // Don't split this statement unless needed. JS compiler thinks
- // getRepeatedInt32Array_ might have side effects and doesn't inline the
- // call in the compiled code. See cl/293894484 for details.
- return new ArrayIterable(this.getRepeatedInt32Array_(fieldNumber));
- }
- /**
- * Returns the size of the repeated field.
- * @param {number} fieldNumber
- * @return {number}
- */
- getRepeatedInt32Size(fieldNumber) {
- return this.getRepeatedInt32Array_(fieldNumber).length;
- }
- /* Int64 */
- /**
- * Returns an Array instance containing int64 values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Array<!Int64>}
- * @private
- */
- getRepeatedInt64Array_(fieldNumber) {
- return this.getFieldWithDefault_(
- fieldNumber, /* defaultValue= */[],
- (indexArray, bytes) => readRepeatedPrimitive(
- indexArray, bytes, reader.readInt64, reader.readPackedInt64,
- WireType.VARINT));
- }
- /**
- * Returns the element at index for the given field number.
- * @param {number} fieldNumber
- * @param {number} index
- * @return {!Int64}
- */
- getRepeatedInt64Element(fieldNumber, index) {
- const array = this.getRepeatedInt64Array_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- return array[index];
- }
- /**
- * Returns an Iterable instance containing int64 values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Iterable<!Int64>}
- */
- getRepeatedInt64Iterable(fieldNumber) {
- // Don't split this statement unless needed. JS compiler thinks
- // getRepeatedInt64Array_ might have side effects and doesn't inline the
- // call in the compiled code. See cl/293894484 for details.
- return new ArrayIterable(this.getRepeatedInt64Array_(fieldNumber));
- }
- /**
- * Returns the size of the repeated field.
- * @param {number} fieldNumber
- * @return {number}
- */
- getRepeatedInt64Size(fieldNumber) {
- return this.getRepeatedInt64Array_(fieldNumber).length;
- }
- /* Sfixed32 */
- /**
- * Returns an Array instance containing sfixed32 values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Array<number>}
- * @private
- */
- getRepeatedSfixed32Array_(fieldNumber) {
- return this.getFieldWithDefault_(
- fieldNumber, /* defaultValue= */[],
- (indexArray, bytes) => readRepeatedPrimitive(
- indexArray, bytes, reader.readSfixed32, reader.readPackedSfixed32,
- WireType.FIXED32));
- }
- /**
- * Returns the element at index for the given field number.
- * @param {number} fieldNumber
- * @param {number} index
- * @return {number}
- */
- getRepeatedSfixed32Element(fieldNumber, index) {
- const array = this.getRepeatedSfixed32Array_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- return array[index];
- }
- /**
- * Returns an Iterable instance containing sfixed32 values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Iterable<number>}
- */
- getRepeatedSfixed32Iterable(fieldNumber) {
- // Don't split this statement unless needed. JS compiler thinks
- // getRepeatedSfixed32Array_ might have side effects and doesn't inline the
- // call in the compiled code. See cl/293894484 for details.
- return new ArrayIterable(this.getRepeatedSfixed32Array_(fieldNumber));
- }
- /**
- * Returns the size of the repeated field.
- * @param {number} fieldNumber
- * @return {number}
- */
- getRepeatedSfixed32Size(fieldNumber) {
- return this.getRepeatedSfixed32Array_(fieldNumber).length;
- }
- /* Sfixed64 */
- /**
- * Returns an Array instance containing sfixed64 values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Array<!Int64>}
- * @private
- */
- getRepeatedSfixed64Array_(fieldNumber) {
- return this.getFieldWithDefault_(
- fieldNumber, /* defaultValue= */[],
- (indexArray, bytes) => readRepeatedPrimitive(
- indexArray, bytes, reader.readSfixed64, reader.readPackedSfixed64,
- WireType.FIXED64));
- }
- /**
- * Returns the element at index for the given field number.
- * @param {number} fieldNumber
- * @param {number} index
- * @return {!Int64}
- */
- getRepeatedSfixed64Element(fieldNumber, index) {
- const array = this.getRepeatedSfixed64Array_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- return array[index];
- }
- /**
- * Returns an Iterable instance containing sfixed64 values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Iterable<!Int64>}
- */
- getRepeatedSfixed64Iterable(fieldNumber) {
- // Don't split this statement unless needed. JS compiler thinks
- // getRepeatedSfixed64Array_ might have side effects and doesn't inline the
- // call in the compiled code. See cl/293894484 for details.
- return new ArrayIterable(this.getRepeatedSfixed64Array_(fieldNumber));
- }
- /**
- * Returns the size of the repeated field.
- * @param {number} fieldNumber
- * @return {number}
- */
- getRepeatedSfixed64Size(fieldNumber) {
- return this.getRepeatedSfixed64Array_(fieldNumber).length;
- }
- /* Sint32 */
- /**
- * Returns an Array instance containing sint32 values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Array<number>}
- * @private
- */
- getRepeatedSint32Array_(fieldNumber) {
- return this.getFieldWithDefault_(
- fieldNumber, /* defaultValue= */[],
- (indexArray, bytes) => readRepeatedPrimitive(
- indexArray, bytes, reader.readSint32, reader.readPackedSint32,
- WireType.VARINT));
- }
- /**
- * Returns the element at index for the given field number.
- * @param {number} fieldNumber
- * @param {number} index
- * @return {number}
- */
- getRepeatedSint32Element(fieldNumber, index) {
- const array = this.getRepeatedSint32Array_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- return array[index];
- }
- /**
- * Returns an Iterable instance containing sint32 values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Iterable<number>}
- */
- getRepeatedSint32Iterable(fieldNumber) {
- // Don't split this statement unless needed. JS compiler thinks
- // getRepeatedSint32Array_ might have side effects and doesn't inline the
- // call in the compiled code. See cl/293894484 for details.
- return new ArrayIterable(this.getRepeatedSint32Array_(fieldNumber));
- }
- /**
- * Returns the size of the repeated field.
- * @param {number} fieldNumber
- * @return {number}
- */
- getRepeatedSint32Size(fieldNumber) {
- return this.getRepeatedSint32Array_(fieldNumber).length;
- }
- /* Sint64 */
- /**
- * Returns an Array instance containing sint64 values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Array<!Int64>}
- * @private
- */
- getRepeatedSint64Array_(fieldNumber) {
- return this.getFieldWithDefault_(
- fieldNumber, /* defaultValue= */[],
- (indexArray, bytes) => readRepeatedPrimitive(
- indexArray, bytes, reader.readSint64, reader.readPackedSint64,
- WireType.VARINT));
- }
- /**
- * Returns the element at index for the given field number.
- * @param {number} fieldNumber
- * @param {number} index
- * @return {!Int64}
- */
- getRepeatedSint64Element(fieldNumber, index) {
- const array = this.getRepeatedSint64Array_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- return array[index];
- }
- /**
- * Returns an Iterable instance containing sint64 values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Iterable<!Int64>}
- */
- getRepeatedSint64Iterable(fieldNumber) {
- // Don't split this statement unless needed. JS compiler thinks
- // getRepeatedSint64Array_ might have side effects and doesn't inline the
- // call in the compiled code. See cl/293894484 for details.
- return new ArrayIterable(this.getRepeatedSint64Array_(fieldNumber));
- }
- /**
- * Returns the size of the repeated field.
- * @param {number} fieldNumber
- * @return {number}
- */
- getRepeatedSint64Size(fieldNumber) {
- return this.getRepeatedSint64Array_(fieldNumber).length;
- }
- /* Uint32 */
- /**
- * Returns an Array instance containing uint32 values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Array<number>}
- * @private
- */
- getRepeatedUint32Array_(fieldNumber) {
- return this.getFieldWithDefault_(
- fieldNumber, /* defaultValue= */[],
- (indexArray, bytes) => readRepeatedPrimitive(
- indexArray, bytes, reader.readUint32, reader.readPackedUint32,
- WireType.VARINT));
- }
- /**
- * Returns the element at index for the given field number.
- * @param {number} fieldNumber
- * @param {number} index
- * @return {number}
- */
- getRepeatedUint32Element(fieldNumber, index) {
- const array = this.getRepeatedUint32Array_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- return array[index];
- }
- /**
- * Returns an Iterable instance containing uint32 values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Iterable<number>}
- */
- getRepeatedUint32Iterable(fieldNumber) {
- // Don't split this statement unless needed. JS compiler thinks
- // getRepeatedUint32Array_ might have side effects and doesn't inline the
- // call in the compiled code. See cl/293894484 for details.
- return new ArrayIterable(this.getRepeatedUint32Array_(fieldNumber));
- }
- /**
- * Returns the size of the repeated field.
- * @param {number} fieldNumber
- * @return {number}
- */
- getRepeatedUint32Size(fieldNumber) {
- return this.getRepeatedUint32Array_(fieldNumber).length;
- }
- /* Uint64 */
- /**
- * Returns the element at index for the given field number.
- * @param {number} fieldNumber
- * @param {number} index
- * @return {!Int64}
- */
- getRepeatedUint64Element(fieldNumber, index) {
- return this.getRepeatedInt64Element(fieldNumber, index);
- }
- /**
- * Returns an Iterable instance containing uint64 values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Iterable<!Int64>}
- */
- getRepeatedUint64Iterable(fieldNumber) {
- return this.getRepeatedInt64Iterable(fieldNumber);
- }
- /**
- * Returns the size of the repeated field.
- * @param {number} fieldNumber
- * @return {number}
- */
- getRepeatedUint64Size(fieldNumber) {
- return this.getRepeatedInt64Size(fieldNumber);
- }
- /* Bytes */
- /**
- * Returns an array instance containing bytes values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Array<!ByteString>}
- * @private
- */
- getRepeatedBytesArray_(fieldNumber) {
- return this.getFieldWithDefault_(
- fieldNumber, /* defaultValue= */[],
- (indexArray, bytes) =>
- readRepeatedNonPrimitive(indexArray, bytes, reader.readBytes));
- }
- /**
- * Returns the element at index for the given field number as a bytes.
- * @param {number} fieldNumber
- * @param {number} index
- * @return {!ByteString}
- */
- getRepeatedBytesElement(fieldNumber, index) {
- const array = this.getRepeatedBytesArray_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- return array[index];
- }
- /**
- * Returns an Iterable instance containing bytes values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Iterable<!ByteString>}
- */
- getRepeatedBytesIterable(fieldNumber) {
- // Don't split this statement unless needed. JS compiler thinks
- // getRepeatedBytesArray_ might have side effects and doesn't inline the
- // call in the compiled code. See cl/293894484 for details.
- return new ArrayIterable(this.getRepeatedBytesArray_(fieldNumber));
- }
- /**
- * Returns the size of the repeated field.
- * @param {number} fieldNumber
- * @return {number}
- */
- getRepeatedBytesSize(fieldNumber) {
- return this.getRepeatedBytesArray_(fieldNumber).length;
- }
- /* String */
- /**
- * Returns an array instance containing string values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Array<string>}
- * @private
- */
- getRepeatedStringArray_(fieldNumber) {
- return this.getFieldWithDefault_(
- fieldNumber, /* defaultValue= */[],
- (indexArray, bufferDecoder) => readRepeatedNonPrimitive(
- indexArray, bufferDecoder, reader.readString));
- }
- /**
- * Returns the element at index for the given field number as a string.
- * @param {number} fieldNumber
- * @param {number} index
- * @return {string}
- */
- getRepeatedStringElement(fieldNumber, index) {
- const array = this.getRepeatedStringArray_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- return array[index];
- }
- /**
- * Returns an Iterable instance containing string values for the given field
- * number.
- * @param {number} fieldNumber
- * @return {!Iterable<string>}
- */
- getRepeatedStringIterable(fieldNumber) {
- // Don't split this statement unless needed. JS compiler thinks
- // getRepeatedStringArray_ might have side effects and doesn't inline the
- // call in the compiled code. See cl/293894484 for details.
- return new ArrayIterable(this.getRepeatedStringArray_(fieldNumber));
- }
- /**
- * Returns the size of the repeated field.
- * @param {number} fieldNumber
- * @return {number}
- */
- getRepeatedStringSize(fieldNumber) {
- return this.getRepeatedStringArray_(fieldNumber).length;
- }
- /* Message */
- /**
- * Returns an Array instance containing boolean values for the given field
- * number.
- * @param {number} fieldNumber
- * @param {function(!Kernel):T} instanceCreator
- * @param {number|undefined} pivot
- * @return {!Array<T>}
- * @template T
- * @private
- */
- getRepeatedMessageArray_(fieldNumber, instanceCreator, pivot) {
- // This method can be shortened using getFieldWithDefault and
- // getRepeatedNonPrimitive methods. But that will require creating and
- // passing a reader closure every time getRepeatedMessageArray_ is called,
- // which is expensive.
- checkInstanceCreator(instanceCreator);
- checkFieldNumber(fieldNumber);
- const field = this.fields_.get(fieldNumber);
- if (field === undefined) {
- return [];
- }
- if (field.hasDecodedValue()) {
- return field.getDecodedValue();
- }
- const indexArray = checkDefAndNotNull(field.getIndexArray());
- const result = new Array(indexArray.length);
- for (let i = 0; i < indexArray.length; i++) {
- validateWireType(indexArray[i], WireType.DELIMITED);
- const subMessageBuffer = reader.readDelimited(
- checkDefAndNotNull(this.bufferDecoder_),
- Field.getStartIndex(indexArray[i]));
- result[i] =
- instanceCreator(Kernel.fromBufferDecoder_(subMessageBuffer, pivot));
- }
- field.setCache(result, writeRepeatedMessage);
- return result;
- }
- /**
- * Returns the element at index for the given field number as a message.
- * @param {number} fieldNumber
- * @param {function(!Kernel):T} instanceCreator
- * @param {number} index
- * @param {number=} pivot
- * @return {T}
- * @template T
- */
- getRepeatedMessageElement(
- fieldNumber, instanceCreator, index, pivot = undefined) {
- const array =
- this.getRepeatedMessageArray_(fieldNumber, instanceCreator, pivot);
- checkCriticalElementIndex(index, array.length);
- return array[index];
- }
- /**
- * Returns an Iterable instance containing message values for the given field
- * number.
- * @param {number} fieldNumber
- * @param {function(!Kernel):T} instanceCreator
- * @param {number=} pivot
- * @return {!Iterable<T>}
- * @template T
- */
- getRepeatedMessageIterable(fieldNumber, instanceCreator, pivot = undefined) {
- // Don't split this statement unless needed. JS compiler thinks
- // getRepeatedMessageArray_ might have side effects and doesn't inline the
- // call in the compiled code. See cl/293894484 for details.
- return new ArrayIterable(
- this.getRepeatedMessageArray_(fieldNumber, instanceCreator, pivot));
- }
- /**
- * Returns an Iterable instance containing message accessors for the given
- * field number.
- * @param {number} fieldNumber
- * @param {number=} pivot
- * @return {!Iterable<!Kernel>}
- */
- getRepeatedMessageAccessorIterable(fieldNumber, pivot = undefined) {
- checkFieldNumber(fieldNumber);
- const field = this.fields_.get(fieldNumber);
- if (!field) {
- return [];
- }
- if (field.hasDecodedValue()) {
- return new ArrayIterable(field.getDecodedValue().map(
- value => checkIsInternalMessage(value).internalGetKernel()));
- }
- const readMessageFunc = (bufferDecoder, start) => Kernel.fromBufferDecoder_(
- reader.readDelimited(bufferDecoder, start), pivot);
- const array = readRepeatedNonPrimitive(
- checkDefAndNotNull(field.getIndexArray()),
- checkDefAndNotNull(this.bufferDecoder_), readMessageFunc);
- return new ArrayIterable(array);
- }
- /**
- * Returns the size of the repeated field.
- * @param {number} fieldNumber
- * @param {function(!Kernel):T} instanceCreator
- * @return {number}
- * @param {number=} pivot
- * @template T
- */
- getRepeatedMessageSize(fieldNumber, instanceCreator, pivot = undefined) {
- return this.getRepeatedMessageArray_(fieldNumber, instanceCreator, pivot)
- .length;
- }
- /**
- * Returns an Array instance containing boolean values for the given field
- * number.
- * @param {number} fieldNumber
- * @param {function(!Kernel):T} instanceCreator
- * @param {number|undefined} pivot
- * @return {!Array<T>}
- * @template T
- * @private
- */
- getRepeatedGroupArray_(fieldNumber, instanceCreator, pivot) {
- return this.getFieldWithDefault_(
- fieldNumber, [],
- (indexArray, bufferDecoder) => readRepeatedGroup(
- indexArray, bufferDecoder, fieldNumber, instanceCreator, pivot),
- writeRepeatedGroup);
- }
- /**
- * Returns the element at index for the given field number as a group.
- * @param {number} fieldNumber
- * @param {function(!Kernel):T} instanceCreator
- * @param {number} index
- * @param {number=} pivot
- * @return {T}
- * @template T
- */
- getRepeatedGroupElement(
- fieldNumber, instanceCreator, index, pivot = undefined) {
- const array =
- this.getRepeatedGroupArray_(fieldNumber, instanceCreator, pivot);
- checkCriticalElementIndex(index, array.length);
- return array[index];
- }
- /**
- * Returns an Iterable instance containing group values for the given field
- * number.
- * @param {number} fieldNumber
- * @param {function(!Kernel):T} instanceCreator
- * @param {number=} pivot
- * @return {!Iterable<T>}
- * @template T
- */
- getRepeatedGroupIterable(fieldNumber, instanceCreator, pivot = undefined) {
- // Don't split this statement unless needed. JS compiler thinks
- // getRepeatedMessageArray_ might have side effects and doesn't inline the
- // call in the compiled code. See cl/293894484 for details.
- return new ArrayIterable(
- this.getRepeatedGroupArray_(fieldNumber, instanceCreator, pivot));
- }
- /**
- * Returns the size of the repeated field.
- * @param {number} fieldNumber
- * @param {function(!Kernel):T} instanceCreator
- * @return {number}
- * @param {number=} pivot
- * @template T
- */
- getRepeatedGroupSize(fieldNumber, instanceCreator, pivot = undefined) {
- return this.getRepeatedGroupArray_(fieldNumber, instanceCreator, pivot)
- .length;
- }
- /***************************************************************************
- * OPTIONAL SETTER METHODS
- ***************************************************************************/
- /**
- * Sets a boolean value to the field with the given field number.
- * @param {number} fieldNumber
- * @param {boolean} value
- */
- setBool(fieldNumber, value) {
- checkCriticalTypeBool(value);
- this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
- writer.writeBool(fieldNumber, value);
- });
- }
- /**
- * Sets a boolean value to the field with the given field number.
- * @param {number} fieldNumber
- * @param {!ByteString} value
- */
- setBytes(fieldNumber, value) {
- checkCriticalTypeByteString(value);
- this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
- writer.writeBytes(fieldNumber, value);
- });
- }
- /**
- * Sets a double value to the field with the given field number.
- * @param {number} fieldNumber
- * @param {number} value
- */
- setDouble(fieldNumber, value) {
- checkCriticalTypeDouble(value);
- this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
- writer.writeDouble(fieldNumber, value);
- });
- }
- /**
- * Sets a fixed32 value to the field with the given field number.
- * @param {number} fieldNumber
- * @param {number} value
- */
- setFixed32(fieldNumber, value) {
- checkCriticalTypeUnsignedInt32(value);
- this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
- writer.writeFixed32(fieldNumber, value);
- });
- }
- /**
- * Sets a uint64 value to the field with the given field number.\
- * Note: Since g.m.Long does not support unsigned int64 values we are going
- * the Java route here for now and simply output the number as a signed int64.
- * Users can get to individual bits by themselves.
- * @param {number} fieldNumber
- * @param {!Int64} value
- */
- setFixed64(fieldNumber, value) {
- this.setSfixed64(fieldNumber, value);
- }
- /**
- * Sets a float value to the field with the given field number.
- * @param {number} fieldNumber
- * @param {number} value
- */
- setFloat(fieldNumber, value) {
- checkCriticalTypeFloat(value);
- // Eagerly round to 32-bit precision so that reading back after set will
- // yield the same value a reader will receive after serialization.
- const floatValue = Math.fround(value);
- this.setField_(fieldNumber, floatValue, (writer, fieldNumber, value) => {
- writer.writeFloat(fieldNumber, value);
- });
- }
- /**
- * Sets a int32 value to the field with the given field number.
- * @param {number} fieldNumber
- * @param {number} value
- */
- setInt32(fieldNumber, value) {
- checkCriticalTypeSignedInt32(value);
- this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
- writer.writeInt32(fieldNumber, value);
- });
- }
- /**
- * Sets a int64 value to the field with the given field number.
- * @param {number} fieldNumber
- * @param {!Int64} value
- */
- setInt64(fieldNumber, value) {
- checkCriticalTypeSignedInt64(value);
- this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
- writer.writeInt64(fieldNumber, value);
- });
- }
- /**
- * Sets a sfixed32 value to the field with the given field number.
- * @param {number} fieldNumber
- * @param {number} value
- */
- setSfixed32(fieldNumber, value) {
- checkCriticalTypeSignedInt32(value);
- this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
- writer.writeSfixed32(fieldNumber, value);
- });
- }
- /**
- * Sets a sfixed64 value to the field with the given field number.
- * @param {number} fieldNumber
- * @param {!Int64} value
- */
- setSfixed64(fieldNumber, value) {
- checkCriticalTypeSignedInt64(value);
- this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
- writer.writeSfixed64(fieldNumber, value);
- });
- }
- /**
- * Sets a sint32 value to the field with the given field number.
- * @param {number} fieldNumber
- * @param {number} value
- */
- setSint32(fieldNumber, value) {
- checkCriticalTypeSignedInt32(value);
- this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
- writer.writeSint32(fieldNumber, value);
- });
- }
- /**
- * Sets a sint64 value to the field with the given field number.
- * @param {number} fieldNumber
- * @param {!Int64} value
- */
- setSint64(fieldNumber, value) {
- checkCriticalTypeSignedInt64(value);
- this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
- writer.writeSint64(fieldNumber, value);
- });
- }
- /**
- * Sets a boolean value to the field with the given field number.
- * @param {number} fieldNumber
- * @param {string} value
- */
- setString(fieldNumber, value) {
- checkCriticalTypeString(value);
- this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
- writer.writeString(fieldNumber, value);
- });
- }
- /**
- * Sets a uint32 value to the field with the given field number.
- * @param {number} fieldNumber
- * @param {number} value
- */
- setUint32(fieldNumber, value) {
- checkCriticalTypeUnsignedInt32(value);
- this.setField_(fieldNumber, value, (writer, fieldNumber, value) => {
- writer.writeUint32(fieldNumber, value);
- });
- }
- /**
- * Sets a uint64 value to the field with the given field number.\
- * Note: Since g.m.Long does not support unsigned int64 values we are going
- * the Java route here for now and simply output the number as a signed int64.
- * Users can get to individual bits by themselves.
- * @param {number} fieldNumber
- * @param {!Int64} value
- */
- setUint64(fieldNumber, value) {
- this.setInt64(fieldNumber, value);
- }
- /**
- * Sets a proto Group to the field with the given field number.
- * Instead of working with the Kernel inside of the message directly, we
- * need the message instance to keep its reference equality for subsequent
- * gettings.
- * @param {number} fieldNumber
- * @param {!InternalMessage} value
- */
- setGroup(fieldNumber, value) {
- checkCriticalType(
- value !== null, 'Given value is not a message instance: null');
- this.setField_(fieldNumber, value, writeGroup);
- }
- /**
- * Sets a proto Message to the field with the given field number.
- * Instead of working with the Kernel inside of the message directly, we
- * need the message instance to keep its reference equality for subsequent
- * gettings.
- * @param {number} fieldNumber
- * @param {!InternalMessage} value
- */
- setMessage(fieldNumber, value) {
- checkCriticalType(
- value !== null, 'Given value is not a message instance: null');
- this.setField_(fieldNumber, value, writeMessage);
- }
- /***************************************************************************
- * REPEATED SETTER METHODS
- ***************************************************************************/
- /* Bool */
- /**
- * Adds all boolean values into the field for the given field number.
- * How these values are encoded depends on the given write function.
- * @param {number} fieldNumber
- * @param {!Iterable<boolean>} values
- * @param {function(!Writer, number, !Array<boolean>): undefined} encoder
- * @private
- */
- addRepeatedBoolIterable_(fieldNumber, values, encoder) {
- const array = [...this.getRepeatedBoolArray_(fieldNumber), ...values];
- checkCriticalTypeBoolArray(array);
- // Needs to set it back because the default empty array was not cached.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Adds a single boolean value into the field for the given field number.
- * All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {boolean} value
- */
- addPackedBoolElement(fieldNumber, value) {
- this.addRepeatedBoolIterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writePackedBool(fieldNumber, values);
- });
- }
- /**
- * Adds all boolean values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<boolean>} values
- */
- addPackedBoolIterable(fieldNumber, values) {
- this.addRepeatedBoolIterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writePackedBool(fieldNumber, values);
- });
- }
- /**
- * Adds a single boolean value into the field for the given field number.
- * All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {boolean} value
- */
- addUnpackedBoolElement(fieldNumber, value) {
- this.addRepeatedBoolIterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writeRepeatedBool(fieldNumber, values);
- });
- }
- /**
- * Adds all boolean values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<boolean>} values
- */
- addUnpackedBoolIterable(fieldNumber, values) {
- this.addRepeatedBoolIterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writeRepeatedBool(fieldNumber, values);
- });
- }
- /**
- * Sets a single boolean value into the field for the given field number at
- * the given index. How these values are encoded depends on the given write
- * function.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {boolean} value
- * @param {function(!Writer, number, !Array<boolean>): undefined} encoder
- * @throws {!Error} if index is out of range when check mode is critical
- * @private
- */
- setRepeatedBoolElement_(fieldNumber, index, value, encoder) {
- checkCriticalTypeBool(value);
- const array = this.getRepeatedBoolArray_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- array[index] = value;
- // Needs to set it back to set encoder.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Sets a single boolean value into the field for the given field number at
- * the given index. All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {boolean} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setPackedBoolElement(fieldNumber, index, value) {
- this.setRepeatedBoolElement_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writePackedBool(fieldNumber, values);
- });
- }
- /**
- * Sets all boolean values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<boolean>} values
- */
- setPackedBoolIterable(fieldNumber, values) {
- const /** !Array<boolean> */ array = Array.from(values);
- checkCriticalTypeBoolArray(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writePackedBool(fieldNumber, values);
- });
- }
- /**
- * Sets a single boolean value into the field for the given field number at
- * the given index. All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {boolean} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setUnpackedBoolElement(fieldNumber, index, value) {
- this.setRepeatedBoolElement_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writeRepeatedBool(fieldNumber, values);
- });
- }
- /**
- * Sets all boolean values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<boolean>} values
- */
- setUnpackedBoolIterable(fieldNumber, values) {
- const /** !Array<boolean> */ array = Array.from(values);
- checkCriticalTypeBoolArray(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writeRepeatedBool(fieldNumber, values);
- });
- }
- /* Double */
- /**
- * Adds all double values into the field for the given field number.
- * How these values are encoded depends on the given write function.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- * @param {function(!Writer, number, !Array<number>): undefined} encoder
- * @private
- */
- addRepeatedDoubleIterable_(fieldNumber, values, encoder) {
- const array = [...this.getRepeatedDoubleArray_(fieldNumber), ...values];
- checkCriticalTypeDoubleArray(array);
- // Needs to set it back because the default empty array was not cached.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Adds a single double value into the field for the given field number.
- * All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {number} value
- */
- addPackedDoubleElement(fieldNumber, value) {
- this.addRepeatedDoubleIterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writePackedDouble(fieldNumber, values);
- });
- }
- /**
- * Adds all double values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- addPackedDoubleIterable(fieldNumber, values) {
- this.addRepeatedDoubleIterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writePackedDouble(fieldNumber, values);
- });
- }
- /**
- * Adds a single double value into the field for the given field number.
- * All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {number} value
- */
- addUnpackedDoubleElement(fieldNumber, value) {
- this.addRepeatedDoubleIterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writeRepeatedDouble(fieldNumber, values);
- });
- }
- /**
- * Adds all double values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- addUnpackedDoubleIterable(fieldNumber, values) {
- this.addRepeatedDoubleIterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writeRepeatedDouble(fieldNumber, values);
- });
- }
- /**
- * Sets a single double value into the field for the given field number at the
- * given index.
- * How these values are encoded depends on the given write function.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @param {function(!Writer, number, !Array<number>): undefined} encoder
- * @throws {!Error} if index is out of range when check mode is critical
- * @private
- */
- setRepeatedDoubleElement_(fieldNumber, index, value, encoder) {
- checkCriticalTypeDouble(value);
- const array = this.getRepeatedDoubleArray_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- array[index] = value;
- // Needs to set it back to set encoder.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Sets a single double value into the field for the given field number at the
- * given index.
- * All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setPackedDoubleElement(fieldNumber, index, value) {
- this.setRepeatedDoubleElement_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writePackedDouble(fieldNumber, values);
- });
- }
- /**
- * Sets all double values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- setPackedDoubleIterable(fieldNumber, values) {
- const array = Array.from(values);
- checkCriticalTypeDoubleArray(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writePackedDouble(fieldNumber, values);
- });
- }
- /**
- * Sets a single double value into the field for the given field number at the
- * given index.
- * All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setUnpackedDoubleElement(fieldNumber, index, value) {
- this.setRepeatedDoubleElement_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writeRepeatedDouble(fieldNumber, values);
- });
- }
- /**
- * Sets all double values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- setUnpackedDoubleIterable(fieldNumber, values) {
- const array = Array.from(values);
- checkCriticalTypeDoubleArray(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writeRepeatedDouble(fieldNumber, values);
- });
- }
- /* Fixed32 */
- /**
- * Adds all fixed32 values into the field for the given field number.
- * How these values are encoded depends on the given write function.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- * @param {function(!Writer, number, !Array<number>): undefined} encoder
- * @private
- */
- addRepeatedFixed32Iterable_(fieldNumber, values, encoder) {
- const array = [...this.getRepeatedFixed32Array_(fieldNumber), ...values];
- checkCriticalTypeUnsignedInt32Array(array);
- // Needs to set it back because the default empty array was not cached.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Adds a single fixed32 value into the field for the given field number.
- * All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {number} value
- */
- addPackedFixed32Element(fieldNumber, value) {
- this.addRepeatedFixed32Iterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writePackedFixed32(fieldNumber, values);
- });
- }
- /**
- * Adds all fixed32 values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- addPackedFixed32Iterable(fieldNumber, values) {
- this.addRepeatedFixed32Iterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writePackedFixed32(fieldNumber, values);
- });
- }
- /**
- * Adds a single fixed32 value into the field for the given field number.
- * All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {number} value
- */
- addUnpackedFixed32Element(fieldNumber, value) {
- this.addRepeatedFixed32Iterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writeRepeatedFixed32(fieldNumber, values);
- });
- }
- /**
- * Adds all fixed32 values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- addUnpackedFixed32Iterable(fieldNumber, values) {
- this.addRepeatedFixed32Iterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writeRepeatedFixed32(fieldNumber, values);
- });
- }
- /**
- * Sets a single fixed32 value into the field for the given field number at
- * the given index. How these values are encoded depends on the given write
- * function.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @param {function(!Writer, number, !Array<number>): undefined} encoder
- * @throws {!Error} if index is out of range when check mode is critical
- * @private
- */
- setRepeatedFixed32Element_(fieldNumber, index, value, encoder) {
- checkCriticalTypeUnsignedInt32(value);
- const array = this.getRepeatedFixed32Array_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- array[index] = value;
- // Needs to set it back to set encoder.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Sets a single fixed32 value into the field for the given field number at
- * the given index. All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setPackedFixed32Element(fieldNumber, index, value) {
- this.setRepeatedFixed32Element_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writePackedFixed32(fieldNumber, values);
- });
- }
- /**
- * Sets all fixed32 values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- setPackedFixed32Iterable(fieldNumber, values) {
- const array = Array.from(values);
- checkCriticalTypeUnsignedInt32Array(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writePackedFixed32(fieldNumber, values);
- });
- }
- /**
- * Sets a single fixed32 value into the field for the given field number at
- * the given index. All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setUnpackedFixed32Element(fieldNumber, index, value) {
- this.setRepeatedFixed32Element_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writeRepeatedFixed32(fieldNumber, values);
- });
- }
- /**
- * Sets all fixed32 values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- setUnpackedFixed32Iterable(fieldNumber, values) {
- const array = Array.from(values);
- checkCriticalTypeUnsignedInt32Array(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writeRepeatedFixed32(fieldNumber, values);
- });
- }
- /* Fixed64 */
- /**
- * Adds a single fixed64 value into the field for the given field number.
- * All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Int64} value
- */
- addPackedFixed64Element(fieldNumber, value) {
- this.addPackedSfixed64Element(fieldNumber, value);
- }
- /**
- * Adds all fixed64 values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- */
- addPackedFixed64Iterable(fieldNumber, values) {
- this.addPackedSfixed64Iterable(fieldNumber, values);
- }
- /**
- * Adds a single fixed64 value into the field for the given field number.
- * All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Int64} value
- */
- addUnpackedFixed64Element(fieldNumber, value) {
- this.addUnpackedSfixed64Element(fieldNumber, value);
- }
- /**
- * Adds all fixed64 values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- */
- addUnpackedFixed64Iterable(fieldNumber, values) {
- this.addUnpackedSfixed64Iterable(fieldNumber, values);
- }
- /**
- * Sets a single fixed64 value into the field for the given field number at
- * the given index. All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {!Int64} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setPackedFixed64Element(fieldNumber, index, value) {
- this.setPackedSfixed64Element(fieldNumber, index, value);
- }
- /**
- * Sets all fixed64 values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- */
- setPackedFixed64Iterable(fieldNumber, values) {
- this.setPackedSfixed64Iterable(fieldNumber, values);
- }
- /**
- * Sets a single fixed64 value into the field for the given field number at
- * the given index. All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {!Int64} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setUnpackedFixed64Element(fieldNumber, index, value) {
- this.setUnpackedSfixed64Element(fieldNumber, index, value);
- }
- /**
- * Sets all fixed64 values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- */
- setUnpackedFixed64Iterable(fieldNumber, values) {
- this.setUnpackedSfixed64Iterable(fieldNumber, values);
- }
- /* Float */
- /**
- * Adds all float values into the field for the given field number.
- * How these values are encoded depends on the given write function.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- * @param {function(!Writer, number, !Array<number>): undefined} encoder
- * @private
- */
- addRepeatedFloatIterable_(fieldNumber, values, encoder) {
- checkCriticalTypeFloatIterable(values);
- // Eagerly round to 32-bit precision so that reading back after set will
- // yield the same value a reader will receive after serialization.
- const floatValues = Array.from(values, fround);
- const array = [...this.getRepeatedFloatArray_(fieldNumber), ...floatValues];
- checkCriticalTypeFloatIterable(array);
- // Needs to set it back because the default empty array was not cached.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Adds a single float value into the field for the given field number.
- * All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {number} value
- */
- addPackedFloatElement(fieldNumber, value) {
- this.addRepeatedFloatIterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writePackedFloat(fieldNumber, values);
- });
- }
- /**
- * Adds all float values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- addPackedFloatIterable(fieldNumber, values) {
- this.addRepeatedFloatIterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writePackedFloat(fieldNumber, values);
- });
- }
- /**
- * Adds a single float value into the field for the given field number.
- * All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {number} value
- */
- addUnpackedFloatElement(fieldNumber, value) {
- this.addRepeatedFloatIterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writeRepeatedFloat(fieldNumber, values);
- });
- }
- /**
- * Adds all float values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- addUnpackedFloatIterable(fieldNumber, values) {
- this.addRepeatedFloatIterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writeRepeatedFloat(fieldNumber, values);
- });
- }
- /**
- * Sets a single float value into the field for the given field number at the
- * given index.
- * How these values are encoded depends on the given write function.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @param {function(!Writer, number, !Array<number>): undefined} encoder
- * @throws {!Error} if index is out of range when check mode is critical
- * @private
- */
- setRepeatedFloatElement_(fieldNumber, index, value, encoder) {
- checkCriticalTypeFloat(value);
- // Eagerly round to 32-bit precision so that reading back after set will
- // yield the same value a reader will receive after serialization.
- const floatValue = Math.fround(value);
- const array = this.getRepeatedFloatArray_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- array[index] = floatValue;
- // Needs to set it back to set encoder.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Sets a single float value into the field for the given field number at the
- * given index.
- * All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setPackedFloatElement(fieldNumber, index, value) {
- this.setRepeatedFloatElement_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writePackedFloat(fieldNumber, values);
- });
- }
- /**
- * Sets all float values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- setPackedFloatIterable(fieldNumber, values) {
- checkCriticalTypeFloatIterable(values);
- // Eagerly round to 32-bit precision so that reading back after set will
- // yield the same value a reader will receive after serialization.
- const array = Array.from(values, fround);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writePackedFloat(fieldNumber, values);
- });
- }
- /**
- * Sets a single float value into the field for the given field number at the
- * given index.
- * All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setUnpackedFloatElement(fieldNumber, index, value) {
- this.setRepeatedFloatElement_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writeRepeatedFloat(fieldNumber, values);
- });
- }
- /**
- * Sets all float values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- setUnpackedFloatIterable(fieldNumber, values) {
- checkCriticalTypeFloatIterable(values);
- // Eagerly round to 32-bit precision so that reading back after set will
- // yield the same value a reader will receive after serialization.
- const array = Array.from(values, fround);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writeRepeatedFloat(fieldNumber, values);
- });
- }
- /* Int32 */
- /**
- * Adds all int32 values into the field for the given field number.
- * How these values are encoded depends on the given write function.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- * @param {function(!Writer, number, !Array<number>): undefined} encoder
- * @private
- */
- addRepeatedInt32Iterable_(fieldNumber, values, encoder) {
- const array = [...this.getRepeatedInt32Array_(fieldNumber), ...values];
- checkCriticalTypeSignedInt32Array(array);
- // Needs to set it back because the default empty array was not cached.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Adds a single int32 value into the field for the given field number.
- * All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {number} value
- */
- addPackedInt32Element(fieldNumber, value) {
- this.addRepeatedInt32Iterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writePackedInt32(fieldNumber, values);
- });
- }
- /**
- * Adds all int32 values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- addPackedInt32Iterable(fieldNumber, values) {
- this.addRepeatedInt32Iterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writePackedInt32(fieldNumber, values);
- });
- }
- /**
- * Adds a single int32 value into the field for the given field number.
- * All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {number} value
- */
- addUnpackedInt32Element(fieldNumber, value) {
- this.addRepeatedInt32Iterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writeRepeatedInt32(fieldNumber, values);
- });
- }
- /**
- * Adds all int32 values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- addUnpackedInt32Iterable(fieldNumber, values) {
- this.addRepeatedInt32Iterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writeRepeatedInt32(fieldNumber, values);
- });
- }
- /**
- * Sets a single int32 value into the field for the given field number at
- * the given index. How these values are encoded depends on the given write
- * function.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @param {function(!Writer, number, !Array<number>): undefined} encoder
- * @throws {!Error} if index is out of range when check mode is critical
- * @private
- */
- setRepeatedInt32Element_(fieldNumber, index, value, encoder) {
- checkCriticalTypeSignedInt32(value);
- const array = this.getRepeatedInt32Array_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- array[index] = value;
- // Needs to set it back to set encoder.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Sets a single int32 value into the field for the given field number at
- * the given index. All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setPackedInt32Element(fieldNumber, index, value) {
- this.setRepeatedInt32Element_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writePackedInt32(fieldNumber, values);
- });
- }
- /**
- * Sets all int32 values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- setPackedInt32Iterable(fieldNumber, values) {
- const array = Array.from(values);
- checkCriticalTypeSignedInt32Array(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writePackedInt32(fieldNumber, values);
- });
- }
- /**
- * Sets a single int32 value into the field for the given field number at
- * the given index. All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setUnpackedInt32Element(fieldNumber, index, value) {
- this.setRepeatedInt32Element_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writeRepeatedInt32(fieldNumber, values);
- });
- }
- /**
- * Sets all int32 values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- setUnpackedInt32Iterable(fieldNumber, values) {
- const array = Array.from(values);
- checkCriticalTypeSignedInt32Array(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writeRepeatedInt32(fieldNumber, values);
- });
- }
- /* Int64 */
- /**
- * Adds all int64 values into the field for the given field number.
- * How these values are encoded depends on the given write function.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- * @param {function(!Writer, number, !Array<!Int64>): undefined} encoder
- * @private
- */
- addRepeatedInt64Iterable_(fieldNumber, values, encoder) {
- const array = [...this.getRepeatedInt64Array_(fieldNumber), ...values];
- checkCriticalTypeSignedInt64Array(array);
- // Needs to set it back because the default empty array was not cached.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Adds a single int64 value into the field for the given field number.
- * All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Int64} value
- */
- addPackedInt64Element(fieldNumber, value) {
- this.addRepeatedInt64Iterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writePackedInt64(fieldNumber, values);
- });
- }
- /**
- * Adds all int64 values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- */
- addPackedInt64Iterable(fieldNumber, values) {
- this.addRepeatedInt64Iterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writePackedInt64(fieldNumber, values);
- });
- }
- /**
- * Adds a single int64 value into the field for the given field number.
- * All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Int64} value
- */
- addUnpackedInt64Element(fieldNumber, value) {
- this.addRepeatedInt64Iterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writeRepeatedInt64(fieldNumber, values);
- });
- }
- /**
- * Adds all int64 values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- */
- addUnpackedInt64Iterable(fieldNumber, values) {
- this.addRepeatedInt64Iterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writeRepeatedInt64(fieldNumber, values);
- });
- }
- /**
- * Sets a single int64 value into the field for the given field number at
- * the given index. How these values are encoded depends on the given write
- * function.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {!Int64} value
- * @param {function(!Writer, number, !Array<!Int64>): undefined} encoder
- * @throws {!Error} if index is out of range when check mode is critical
- * @private
- */
- setRepeatedInt64Element_(fieldNumber, index, value, encoder) {
- checkCriticalTypeSignedInt64(value);
- const array = this.getRepeatedInt64Array_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- array[index] = value;
- // Needs to set it back to set encoder.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Sets a single int64 value into the field for the given field number at
- * the given index. All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {!Int64} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setPackedInt64Element(fieldNumber, index, value) {
- this.setRepeatedInt64Element_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writePackedInt64(fieldNumber, values);
- });
- }
- /**
- * Sets all int64 values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- */
- setPackedInt64Iterable(fieldNumber, values) {
- const array = Array.from(values);
- checkCriticalTypeSignedInt64Array(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writePackedInt64(fieldNumber, values);
- });
- }
- /**
- * Sets a single int64 value into the field for the given field number at
- * the given index. All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {!Int64} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setUnpackedInt64Element(fieldNumber, index, value) {
- this.setRepeatedInt64Element_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writeRepeatedInt64(fieldNumber, values);
- });
- }
- /**
- * Sets all int64 values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- */
- setUnpackedInt64Iterable(fieldNumber, values) {
- const array = Array.from(values);
- checkCriticalTypeSignedInt64Array(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writeRepeatedInt64(fieldNumber, values);
- });
- }
- /* Sfixed32 */
- /**
- * Adds all sfixed32 values into the field for the given field number.
- * How these values are encoded depends on the given write function.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- * @param {function(!Writer, number, !Array<number>): undefined} encoder
- * @private
- */
- addRepeatedSfixed32Iterable_(fieldNumber, values, encoder) {
- const array = [...this.getRepeatedSfixed32Array_(fieldNumber), ...values];
- checkCriticalTypeSignedInt32Array(array);
- // Needs to set it back because the default empty array was not cached.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Adds a single sfixed32 value into the field for the given field number.
- * All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {number} value
- */
- addPackedSfixed32Element(fieldNumber, value) {
- this.addRepeatedSfixed32Iterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writePackedSfixed32(fieldNumber, values);
- });
- }
- /**
- * Adds all sfixed32 values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- addPackedSfixed32Iterable(fieldNumber, values) {
- this.addRepeatedSfixed32Iterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writePackedSfixed32(fieldNumber, values);
- });
- }
- /**
- * Adds a single sfixed32 value into the field for the given field number.
- * All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {number} value
- */
- addUnpackedSfixed32Element(fieldNumber, value) {
- this.addRepeatedSfixed32Iterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writeRepeatedSfixed32(fieldNumber, values);
- });
- }
- /**
- * Adds all sfixed32 values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- addUnpackedSfixed32Iterable(fieldNumber, values) {
- this.addRepeatedSfixed32Iterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writeRepeatedSfixed32(fieldNumber, values);
- });
- }
- /**
- * Sets a single sfixed32 value into the field for the given field number at
- * the given index. How these values are encoded depends on the given write
- * function.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @param {function(!Writer, number, !Array<number>): undefined} encoder
- * @throws {!Error} if index is out of range when check mode is critical
- * @private
- */
- setRepeatedSfixed32Element_(fieldNumber, index, value, encoder) {
- checkCriticalTypeSignedInt32(value);
- const array = this.getRepeatedSfixed32Array_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- array[index] = value;
- // Needs to set it back to set encoder.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Sets a single sfixed32 value into the field for the given field number at
- * the given index. All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setPackedSfixed32Element(fieldNumber, index, value) {
- this.setRepeatedSfixed32Element_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writePackedSfixed32(fieldNumber, values);
- });
- }
- /**
- * Sets all sfixed32 values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- setPackedSfixed32Iterable(fieldNumber, values) {
- const array = Array.from(values);
- checkCriticalTypeSignedInt32Array(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writePackedSfixed32(fieldNumber, values);
- });
- }
- /**
- * Sets a single sfixed32 value into the field for the given field number at
- * the given index. All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setUnpackedSfixed32Element(fieldNumber, index, value) {
- this.setRepeatedSfixed32Element_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writeRepeatedSfixed32(fieldNumber, values);
- });
- }
- /**
- * Sets all sfixed32 values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- setUnpackedSfixed32Iterable(fieldNumber, values) {
- const array = Array.from(values);
- checkCriticalTypeSignedInt32Array(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writeRepeatedSfixed32(fieldNumber, values);
- });
- }
- /* Sfixed64 */
- /**
- * Adds all sfixed64 values into the field for the given field number.
- * How these values are encoded depends on the given write function.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- * @param {function(!Writer, number, !Array<!Int64>): undefined} encoder
- * @private
- */
- addRepeatedSfixed64Iterable_(fieldNumber, values, encoder) {
- const array = [...this.getRepeatedSfixed64Array_(fieldNumber), ...values];
- checkCriticalTypeSignedInt64Array(array);
- // Needs to set it back because the default empty array was not cached.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Adds a single sfixed64 value into the field for the given field number.
- * All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Int64} value
- */
- addPackedSfixed64Element(fieldNumber, value) {
- this.addRepeatedSfixed64Iterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writePackedSfixed64(fieldNumber, values);
- });
- }
- /**
- * Adds all sfixed64 values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- */
- addPackedSfixed64Iterable(fieldNumber, values) {
- this.addRepeatedSfixed64Iterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writePackedSfixed64(fieldNumber, values);
- });
- }
- /**
- * Adds a single sfixed64 value into the field for the given field number.
- * All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Int64} value
- */
- addUnpackedSfixed64Element(fieldNumber, value) {
- this.addRepeatedSfixed64Iterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writeRepeatedSfixed64(fieldNumber, values);
- });
- }
- /**
- * Adds all sfixed64 values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- */
- addUnpackedSfixed64Iterable(fieldNumber, values) {
- this.addRepeatedSfixed64Iterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writeRepeatedSfixed64(fieldNumber, values);
- });
- }
- /**
- * Sets a single sfixed64 value into the field for the given field number at
- * the given index. How these values are encoded depends on the given write
- * function.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {!Int64} value
- * @param {function(!Writer, number, !Array<!Int64>): undefined} encoder
- * @throws {!Error} if index is out of range when check mode is critical
- * @private
- */
- setRepeatedSfixed64Element_(fieldNumber, index, value, encoder) {
- checkCriticalTypeSignedInt64(value);
- const array = this.getRepeatedSfixed64Array_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- array[index] = value;
- // Needs to set it back to set encoder.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Sets a single sfixed64 value into the field for the given field number at
- * the given index. All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {!Int64} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setPackedSfixed64Element(fieldNumber, index, value) {
- this.setRepeatedSfixed64Element_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writePackedSfixed64(fieldNumber, values);
- });
- }
- /**
- * Sets all sfixed64 values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- */
- setPackedSfixed64Iterable(fieldNumber, values) {
- const array = Array.from(values);
- checkCriticalTypeSignedInt64Array(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writePackedSfixed64(fieldNumber, values);
- });
- }
- /**
- * Sets a single sfixed64 value into the field for the given field number at
- * the given index. All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {!Int64} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setUnpackedSfixed64Element(fieldNumber, index, value) {
- this.setRepeatedSfixed64Element_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writeRepeatedSfixed64(fieldNumber, values);
- });
- }
- /**
- * Sets all sfixed64 values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- */
- setUnpackedSfixed64Iterable(fieldNumber, values) {
- const array = Array.from(values);
- checkCriticalTypeSignedInt64Array(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writeRepeatedSfixed64(fieldNumber, values);
- });
- }
- /* Sint32 */
- /**
- * Adds all sint32 values into the field for the given field number.
- * How these values are encoded depends on the given write function.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- * @param {function(!Writer, number, !Array<number>): undefined} encoder
- * @private
- */
- addRepeatedSint32Iterable_(fieldNumber, values, encoder) {
- const array = [...this.getRepeatedSint32Array_(fieldNumber), ...values];
- checkCriticalTypeSignedInt32Array(array);
- // Needs to set it back because the default empty array was not cached.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Adds a single sint32 value into the field for the given field number.
- * All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {number} value
- */
- addPackedSint32Element(fieldNumber, value) {
- this.addRepeatedSint32Iterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writePackedSint32(fieldNumber, values);
- });
- }
- /**
- * Adds all sint32 values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- addPackedSint32Iterable(fieldNumber, values) {
- this.addRepeatedSint32Iterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writePackedSint32(fieldNumber, values);
- });
- }
- /**
- * Adds a single sint32 value into the field for the given field number.
- * All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {number} value
- */
- addUnpackedSint32Element(fieldNumber, value) {
- this.addRepeatedSint32Iterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writeRepeatedSint32(fieldNumber, values);
- });
- }
- /**
- * Adds all sint32 values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- addUnpackedSint32Iterable(fieldNumber, values) {
- this.addRepeatedSint32Iterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writeRepeatedSint32(fieldNumber, values);
- });
- }
- /**
- * Sets a single sint32 value into the field for the given field number at
- * the given index. How these values are encoded depends on the given write
- * function.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @param {function(!Writer, number, !Array<number>): undefined} encoder
- * @throws {!Error} if index is out of range when check mode is critical
- * @private
- */
- setRepeatedSint32Element_(fieldNumber, index, value, encoder) {
- checkCriticalTypeSignedInt32(value);
- const array = this.getRepeatedSint32Array_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- array[index] = value;
- // Needs to set it back to set encoder.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Sets a single sint32 value into the field for the given field number at
- * the given index. All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setPackedSint32Element(fieldNumber, index, value) {
- this.setRepeatedSint32Element_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writePackedSint32(fieldNumber, values);
- });
- }
- /**
- * Sets all sint32 values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- setPackedSint32Iterable(fieldNumber, values) {
- const array = Array.from(values);
- checkCriticalTypeSignedInt32Array(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writePackedSint32(fieldNumber, values);
- });
- }
- /**
- * Sets a single sint32 value into the field for the given field number at
- * the given index. All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setUnpackedSint32Element(fieldNumber, index, value) {
- this.setRepeatedSint32Element_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writeRepeatedSint32(fieldNumber, values);
- });
- }
- /**
- * Sets all sint32 values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- setUnpackedSint32Iterable(fieldNumber, values) {
- const array = Array.from(values);
- checkCriticalTypeSignedInt32Array(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writeRepeatedSint32(fieldNumber, values);
- });
- }
- /* Sint64 */
- /**
- * Adds all sint64 values into the field for the given field number.
- * How these values are encoded depends on the given write function.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- * @param {function(!Writer, number, !Array<!Int64>): undefined} encoder
- * @private
- */
- addRepeatedSint64Iterable_(fieldNumber, values, encoder) {
- const array = [...this.getRepeatedSint64Array_(fieldNumber), ...values];
- checkCriticalTypeSignedInt64Array(array);
- // Needs to set it back because the default empty array was not cached.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Adds a single sint64 value into the field for the given field number.
- * All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Int64} value
- */
- addPackedSint64Element(fieldNumber, value) {
- this.addRepeatedSint64Iterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writePackedSint64(fieldNumber, values);
- });
- }
- /**
- * Adds all sint64 values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- */
- addPackedSint64Iterable(fieldNumber, values) {
- this.addRepeatedSint64Iterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writePackedSint64(fieldNumber, values);
- });
- }
- /**
- * Adds a single sint64 value into the field for the given field number.
- * All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Int64} value
- */
- addUnpackedSint64Element(fieldNumber, value) {
- this.addRepeatedSint64Iterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writeRepeatedSint64(fieldNumber, values);
- });
- }
- /**
- * Adds all sint64 values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- */
- addUnpackedSint64Iterable(fieldNumber, values) {
- this.addRepeatedSint64Iterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writeRepeatedSint64(fieldNumber, values);
- });
- }
- /**
- * Sets a single sint64 value into the field for the given field number at
- * the given index. How these values are encoded depends on the given write
- * function.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {!Int64} value
- * @param {function(!Writer, number, !Array<!Int64>): undefined} encoder
- * @throws {!Error} if index is out of range when check mode is critical
- * @private
- */
- setRepeatedSint64Element_(fieldNumber, index, value, encoder) {
- checkCriticalTypeSignedInt64(value);
- const array = this.getRepeatedSint64Array_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- array[index] = value;
- // Needs to set it back to set encoder.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Sets a single sint64 value into the field for the given field number at
- * the given index. All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {!Int64} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setPackedSint64Element(fieldNumber, index, value) {
- this.setRepeatedSint64Element_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writePackedSint64(fieldNumber, values);
- });
- }
- /**
- * Sets all sint64 values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- */
- setPackedSint64Iterable(fieldNumber, values) {
- const array = Array.from(values);
- checkCriticalTypeSignedInt64Array(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writePackedSint64(fieldNumber, values);
- });
- }
- /**
- * Sets a single sint64 value into the field for the given field number at
- * the given index. All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {!Int64} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setUnpackedSint64Element(fieldNumber, index, value) {
- this.setRepeatedSint64Element_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writeRepeatedSint64(fieldNumber, values);
- });
- }
- /**
- * Sets all sint64 values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- */
- setUnpackedSint64Iterable(fieldNumber, values) {
- const array = Array.from(values);
- checkCriticalTypeSignedInt64Array(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writeRepeatedSint64(fieldNumber, values);
- });
- }
- /* Uint32 */
- /**
- * Adds all uint32 values into the field for the given field number.
- * How these values are encoded depends on the given write function.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- * @param {function(!Writer, number, !Array<number>): undefined} encoder
- * @private
- */
- addRepeatedUint32Iterable_(fieldNumber, values, encoder) {
- const array = [...this.getRepeatedUint32Array_(fieldNumber), ...values];
- checkCriticalTypeUnsignedInt32Array(array);
- // Needs to set it back because the default empty array was not cached.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Adds a single uint32 value into the field for the given field number.
- * All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {number} value
- */
- addPackedUint32Element(fieldNumber, value) {
- this.addRepeatedUint32Iterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writePackedUint32(fieldNumber, values);
- });
- }
- /**
- * Adds all uint32 values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- addPackedUint32Iterable(fieldNumber, values) {
- this.addRepeatedUint32Iterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writePackedUint32(fieldNumber, values);
- });
- }
- /**
- * Adds a single uint32 value into the field for the given field number.
- * All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {number} value
- */
- addUnpackedUint32Element(fieldNumber, value) {
- this.addRepeatedUint32Iterable_(
- fieldNumber, [value], (writer, fieldNumber, values) => {
- writer.writeRepeatedUint32(fieldNumber, values);
- });
- }
- /**
- * Adds all uint32 values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- addUnpackedUint32Iterable(fieldNumber, values) {
- this.addRepeatedUint32Iterable_(
- fieldNumber, values, (writer, fieldNumber, values) => {
- writer.writeRepeatedUint32(fieldNumber, values);
- });
- }
- /**
- * Sets a single uint32 value into the field for the given field number at
- * the given index. How these values are encoded depends on the given write
- * function.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @param {function(!Writer, number, !Array<number>): undefined} encoder
- * @throws {!Error} if index is out of range when check mode is critical
- * @private
- */
- setRepeatedUint32Element_(fieldNumber, index, value, encoder) {
- checkCriticalTypeUnsignedInt32(value);
- const array = this.getRepeatedUint32Array_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- array[index] = value;
- // Needs to set it back to set encoder.
- this.setField_(fieldNumber, array, encoder);
- }
- /**
- * Sets a single uint32 value into the field for the given field number at
- * the given index. All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setPackedUint32Element(fieldNumber, index, value) {
- this.setRepeatedUint32Element_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writePackedUint32(fieldNumber, values);
- });
- }
- /**
- * Sets all uint32 values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- setPackedUint32Iterable(fieldNumber, values) {
- const array = Array.from(values);
- checkCriticalTypeUnsignedInt32Array(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writePackedUint32(fieldNumber, values);
- });
- }
- /**
- * Sets a single uint32 value into the field for the given field number at
- * the given index. All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {number} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setUnpackedUint32Element(fieldNumber, index, value) {
- this.setRepeatedUint32Element_(
- fieldNumber, index, value, (writer, fieldNumber, values) => {
- writer.writeRepeatedUint32(fieldNumber, values);
- });
- }
- /**
- * Sets all uint32 values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<number>} values
- */
- setUnpackedUint32Iterable(fieldNumber, values) {
- const array = Array.from(values);
- checkCriticalTypeUnsignedInt32Array(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writeRepeatedUint32(fieldNumber, values);
- });
- }
- /* Uint64 */
- /**
- * Adds a single uint64 value into the field for the given field number.
- * All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Int64} value
- */
- addPackedUint64Element(fieldNumber, value) {
- this.addPackedInt64Element(fieldNumber, value);
- }
- /**
- * Adds all uint64 values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- */
- addPackedUint64Iterable(fieldNumber, values) {
- this.addPackedInt64Iterable(fieldNumber, values);
- }
- /**
- * Adds a single uint64 value into the field for the given field number.
- * All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Int64} value
- */
- addUnpackedUint64Element(fieldNumber, value) {
- this.addUnpackedInt64Element(fieldNumber, value);
- }
- /**
- * Adds all uint64 values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- */
- addUnpackedUint64Iterable(fieldNumber, values) {
- this.addUnpackedInt64Iterable(fieldNumber, values);
- }
- /**
- * Sets a single uint64 value into the field for the given field number at
- * the given index. All values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {!Int64} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setPackedUint64Element(fieldNumber, index, value) {
- this.setPackedInt64Element(fieldNumber, index, value);
- }
- /**
- * Sets all uint64 values into the field for the given field number.
- * All these values will be encoded as packed values.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- */
- setPackedUint64Iterable(fieldNumber, values) {
- this.setPackedInt64Iterable(fieldNumber, values);
- }
- /**
- * Sets a single uint64 value into the field for the given field number at
- * the given index. All values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {!Int64} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setUnpackedUint64Element(fieldNumber, index, value) {
- this.setUnpackedInt64Element(fieldNumber, index, value);
- }
- /**
- * Sets all uint64 values into the field for the given field number.
- * All these values will be encoded as unpacked values.
- * @param {number} fieldNumber
- * @param {!Iterable<!Int64>} values
- */
- setUnpackedUint64Iterable(fieldNumber, values) {
- this.setUnpackedInt64Iterable(fieldNumber, values);
- }
- /* Bytes */
- /**
- * Sets all bytes values into the field for the given field number.
- * @param {number} fieldNumber
- * @param {!Iterable<!ByteString>} values
- */
- setRepeatedBytesIterable(fieldNumber, values) {
- const /** !Array<!ByteString> */ array = Array.from(values);
- checkCriticalTypeByteStringArray(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writeRepeatedBytes(fieldNumber, values);
- });
- }
- /**
- * Adds all bytes values into the field for the given field number.
- * @param {number} fieldNumber
- * @param {!Iterable<!ByteString>} values
- */
- addRepeatedBytesIterable(fieldNumber, values) {
- const array = [...this.getRepeatedBytesArray_(fieldNumber), ...values];
- checkCriticalTypeByteStringArray(array);
- // Needs to set it back because the default empty array was not cached.
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writeRepeatedBytes(fieldNumber, values);
- });
- }
- /**
- * Sets a single bytes value into the field for the given field number at
- * the given index.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {!ByteString} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setRepeatedBytesElement(fieldNumber, index, value) {
- checkCriticalTypeByteString(value);
- const array = this.getRepeatedBytesArray_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- array[index] = value;
- // Needs to set it back to set encoder.
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writeRepeatedBytes(fieldNumber, values);
- });
- }
- /**
- * Adds a single bytes value into the field for the given field number.
- * @param {number} fieldNumber
- * @param {!ByteString} value
- */
- addRepeatedBytesElement(fieldNumber, value) {
- this.addRepeatedBytesIterable(fieldNumber, [value]);
- }
- /* String */
- /**
- * Sets all string values into the field for the given field number.
- * @param {number} fieldNumber
- * @param {!Iterable<string>} values
- */
- setRepeatedStringIterable(fieldNumber, values) {
- const /** !Array<string> */ array = Array.from(values);
- checkCriticalTypeStringArray(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writeRepeatedString(fieldNumber, values);
- });
- }
- /**
- * Adds all string values into the field for the given field number.
- * @param {number} fieldNumber
- * @param {!Iterable<string>} values
- */
- addRepeatedStringIterable(fieldNumber, values) {
- const array = [...this.getRepeatedStringArray_(fieldNumber), ...values];
- checkCriticalTypeStringArray(array);
- // Needs to set it back because the default empty array was not cached.
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writeRepeatedString(fieldNumber, values);
- });
- }
- /**
- * Sets a single string value into the field for the given field number at
- * the given index.
- * @param {number} fieldNumber
- * @param {number} index
- * @param {string} value
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setRepeatedStringElement(fieldNumber, index, value) {
- checkCriticalTypeString(value);
- const array = this.getRepeatedStringArray_(fieldNumber);
- checkCriticalElementIndex(index, array.length);
- array[index] = value;
- // Needs to set it back to set encoder.
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writer.writeRepeatedString(fieldNumber, values);
- });
- }
- /**
- * Adds a single string value into the field for the given field number.
- * @param {number} fieldNumber
- * @param {string} value
- */
- addRepeatedStringElement(fieldNumber, value) {
- this.addRepeatedStringIterable(fieldNumber, [value]);
- }
- /* Message */
- /**
- * Sets all message values into the field for the given field number.
- * @param {number} fieldNumber
- * @param {!Iterable<!InternalMessage>} values
- */
- setRepeatedMessageIterable(fieldNumber, values) {
- const /** !Array<!InternalMessage> */ array = Array.from(values);
- checkCriticalTypeMessageArray(array);
- this.setField_(fieldNumber, array, (writer, fieldNumber, values) => {
- writeRepeatedMessage(writer, fieldNumber, values);
- });
- }
- /**
- * Adds all message values into the field for the given field number.
- * @param {number} fieldNumber
- * @param {!Iterable<!InternalMessage>} values
- * @param {function(!Kernel):!InternalMessage} instanceCreator
- * @param {number=} pivot
- */
- addRepeatedMessageIterable(
- fieldNumber, values, instanceCreator, pivot = undefined) {
- const array = [
- ...this.getRepeatedMessageArray_(fieldNumber, instanceCreator, pivot),
- ...values,
- ];
- checkCriticalTypeMessageArray(array);
- // Needs to set it back with the new array.
- this.setField_(
- fieldNumber, array,
- (writer, fieldNumber, values) =>
- writeRepeatedMessage(writer, fieldNumber, values));
- }
- /**
- * Sets a single message value into the field for the given field number at
- * the given index.
- * @param {number} fieldNumber
- * @param {!InternalMessage} value
- * @param {function(!Kernel):!InternalMessage} instanceCreator
- * @param {number} index
- * @param {number=} pivot
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setRepeatedMessageElement(
- fieldNumber, value, instanceCreator, index, pivot = undefined) {
- checkInstanceCreator(instanceCreator);
- checkCriticalType(
- value !== null, 'Given value is not a message instance: null');
- const array =
- this.getRepeatedMessageArray_(fieldNumber, instanceCreator, pivot);
- checkCriticalElementIndex(index, array.length);
- array[index] = value;
- }
- /**
- * Adds a single message value into the field for the given field number.
- * @param {number} fieldNumber
- * @param {!InternalMessage} value
- * @param {function(!Kernel):!InternalMessage} instanceCreator
- * @param {number=} pivot
- */
- addRepeatedMessageElement(
- fieldNumber, value, instanceCreator, pivot = undefined) {
- this.addRepeatedMessageIterable(
- fieldNumber, [value], instanceCreator, pivot);
- }
- // Groups
- /**
- * Sets all message values into the field for the given field number.
- * @param {number} fieldNumber
- * @param {!Iterable<!InternalMessage>} values
- */
- setRepeatedGroupIterable(fieldNumber, values) {
- const /** !Array<!InternalMessage> */ array = Array.from(values);
- checkCriticalTypeMessageArray(array);
- this.setField_(fieldNumber, array, writeRepeatedGroup);
- }
- /**
- * Adds all message values into the field for the given field number.
- * @param {number} fieldNumber
- * @param {!Iterable<!InternalMessage>} values
- * @param {function(!Kernel):!InternalMessage} instanceCreator
- * @param {number=} pivot
- */
- addRepeatedGroupIterable(
- fieldNumber, values, instanceCreator, pivot = undefined) {
- const array = [
- ...this.getRepeatedGroupArray_(fieldNumber, instanceCreator, pivot),
- ...values,
- ];
- checkCriticalTypeMessageArray(array);
- // Needs to set it back with the new array.
- this.setField_(fieldNumber, array, writeRepeatedGroup);
- }
- /**
- * Sets a single message value into the field for the given field number at
- * the given index.
- * @param {number} fieldNumber
- * @param {!InternalMessage} value
- * @param {function(!Kernel):!InternalMessage} instanceCreator
- * @param {number} index
- * @param {number=} pivot
- * @throws {!Error} if index is out of range when check mode is critical
- */
- setRepeatedGroupElement(
- fieldNumber, value, instanceCreator, index, pivot = undefined) {
- checkInstanceCreator(instanceCreator);
- checkCriticalType(
- value !== null, 'Given value is not a message instance: null');
- const array =
- this.getRepeatedGroupArray_(fieldNumber, instanceCreator, pivot);
- checkCriticalElementIndex(index, array.length);
- array[index] = value;
- }
- /**
- * Adds a single message value into the field for the given field number.
- * @param {number} fieldNumber
- * @param {!InternalMessage} value
- * @param {function(!Kernel):!InternalMessage} instanceCreator
- * @param {number=} pivot
- */
- addRepeatedGroupElement(
- fieldNumber, value, instanceCreator, pivot = undefined) {
- this.addRepeatedGroupIterable(fieldNumber, [value], instanceCreator, pivot);
- }
- }
- exports = Kernel;
|