| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497449844994500450145024503450445054506450745084509451045114512451345144515451645174518451945204521452245234524452545264527452845294530453145324533453445354536453745384539454045414542454345444545454645474548454945504551455245534554455545564557455845594560456145624563456445654566456745684569457045714572457345744575457645774578457945804581458245834584458545864587458845894590459145924593459445954596459745984599460046014602460346044605460646074608460946104611461246134614461546164617461846194620462146224623462446254626462746284629463046314632463346344635463646374638463946404641464246434644464546464647464846494650465146524653465446554656465746584659466046614662466346644665466646674668466946704671467246734674467546764677467846794680468146824683468446854686468746884689469046914692469346944695469646974698469947004701470247034704470547064707470847094710471147124713471447154716471747184719472047214722472347244725472647274728472947304731473247334734473547364737473847394740474147424743474447454746474747484749475047514752475347544755475647574758475947604761476247634764476547664767476847694770477147724773477447754776477747784779478047814782478347844785478647874788478947904791479247934794479547964797479847994800480148024803480448054806480748084809481048114812481348144815481648174818481948204821482248234824482548264827482848294830483148324833483448354836483748384839484048414842484348444845484648474848484948504851485248534854485548564857485848594860486148624863486448654866486748684869487048714872487348744875487648774878487948804881488248834884488548864887488848894890489148924893489448954896489748984899490049014902490349044905490649074908490949104911491249134914491549164917491849194920492149224923492449254926492749284929493049314932493349344935493649374938493949404941494249434944494549464947494849494950495149524953495449554956495749584959496049614962496349644965496649674968496949704971497249734974497549764977497849794980498149824983498449854986498749884989499049914992499349944995499649974998499950005001500250035004500550065007500850095010501150125013501450155016501750185019502050215022502350245025502650275028502950305031503250335034503550365037503850395040504150425043504450455046504750485049505050515052505350545055505650575058505950605061506250635064506550665067506850695070507150725073507450755076507750785079508050815082508350845085508650875088508950905091509250935094509550965097509850995100510151025103510451055106510751085109511051115112511351145115511651175118511951205121512251235124512551265127512851295130513151325133513451355136513751385139514051415142514351445145514651475148514951505151515251535154515551565157515851595160516151625163516451655166516751685169517051715172517351745175517651775178517951805181518251835184518551865187518851895190519151925193519451955196519751985199520052015202520352045205520652075208520952105211521252135214521552165217521852195220522152225223522452255226522752285229523052315232523352345235523652375238523952405241524252435244524552465247524852495250525152525253525452555256525752585259526052615262526352645265526652675268526952705271527252735274527552765277527852795280528152825283528452855286528752885289529052915292529352945295529652975298529953005301530253035304530553065307530853095310531153125313531453155316531753185319532053215322532353245325532653275328532953305331533253335334533553365337533853395340534153425343534453455346534753485349535053515352535353545355535653575358535953605361536253635364536553665367536853695370537153725373537453755376537753785379538053815382538353845385538653875388538953905391539253935394539553965397539853995400540154025403540454055406540754085409541054115412541354145415541654175418541954205421542254235424542554265427542854295430543154325433543454355436543754385439544054415442544354445445544654475448544954505451545254535454545554565457545854595460546154625463546454655466546754685469547054715472547354745475547654775478547954805481548254835484548554865487548854895490549154925493549454955496549754985499550055015502550355045505550655075508550955105511551255135514551555165517551855195520552155225523552455255526552755285529553055315532553355345535553655375538553955405541554255435544554555465547554855495550555155525553555455555556555755585559556055615562556355645565556655675568556955705571557255735574557555765577557855795580558155825583558455855586558755885589559055915592559355945595559655975598559956005601560256035604560556065607560856095610561156125613561456155616561756185619562056215622562356245625562656275628562956305631563256335634563556365637563856395640564156425643564456455646564756485649565056515652565356545655565656575658565956605661566256635664566556665667566856695670567156725673567456755676567756785679568056815682568356845685568656875688568956905691569256935694569556965697569856995700570157025703570457055706570757085709571057115712571357145715571657175718571957205721572257235724572557265727572857295730573157325733573457355736573757385739574057415742574357445745574657475748574957505751575257535754575557565757575857595760576157625763576457655766576757685769577057715772577357745775577657775778577957805781578257835784578557865787578857895790579157925793579457955796579757985799580058015802580358045805580658075808580958105811581258135814581558165817581858195820582158225823582458255826582758285829583058315832583358345835583658375838583958405841584258435844584558465847584858495850585158525853585458555856585758585859586058615862586358645865586658675868586958705871587258735874587558765877587858795880588158825883588458855886588758885889589058915892589358945895589658975898589959005901590259035904590559065907590859095910591159125913591459155916591759185919592059215922 |
- 10.1.1 - 2023-08-28
- -------------------
- * Added formatters for ``std::atomic`` and ``atomic_flag``
- (`#3574 <https://github.com/fmtlib/fmt/pull/3574>`_,
- `#3594 <https://github.com/fmtlib/fmt/pull/3594>`_).
- Thanks `@wangzw (Zhanwei Wang) <https://github.com/wangzw>`_ and
- `@AlexGuteniev (Alex Guteniev) <https://github.com/AlexGuteniev>`_.
- * Fixed an error about partial specialization of ``formatter<string>``
- after instantiation when compiled with gcc and C++20
- (`#3584 <https://github.com/fmtlib/fmt/issues/3584>`_).
- * Fixed compilation as a C++20 module with gcc and clang
- (`#3587 <https://github.com/fmtlib/fmt/issues/3587>`_,
- `#3597 <https://github.com/fmtlib/fmt/pull/3597>`_,
- `#3605 <https://github.com/fmtlib/fmt/pull/3605>`_). Thanks
- `@MathewBensonCode (Mathew Benson) <https://github.com/MathewBensonCode>`_.
- * Made ``fmt::to_string`` work with types that have ``format_as`` overloads
- (`#3575 <https://github.com/fmtlib/fmt/pull/3575>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Made ``formatted_size`` work with integral format specifiers at compile time
- (`#3591 <https://github.com/fmtlib/fmt/pull/3591>`_).
- Thanks `@elbeno (Ben Deane) <https://github.com/elbeno>`_.
- * Fixed a warning about the ``no_unique_address`` attribute on clang-cl
- (`#3599 <https://github.com/fmtlib/fmt/pull/3599>`_).
- Thanks `@lukester1975 <https://github.com/lukester1975>`_.
- * Improved compatibility with the legacy GBK encoding
- (`#3598 <https://github.com/fmtlib/fmt/issues/3598>`_,
- `#3599 <https://github.com/fmtlib/fmt/pull/3599>`_).
- Thanks `@YuHuanTin <https://github.com/YuHuanTin>`_.
- * Added OpenSSF Scorecard analysis
- (`#3530 <https://github.com/fmtlib/fmt/issues/3530>`_,
- `#3571 <https://github.com/fmtlib/fmt/pull/3571>`_).
- Thanks `@joycebrum (Joyce) <https://github.com/joycebrum>`_.
- * Updated CI dependencies
- (`#3591 <https://github.com/fmtlib/fmt/pull/3591>`_,
- `#3592 <https://github.com/fmtlib/fmt/pull/3592>`_,
- `#3593 <https://github.com/fmtlib/fmt/pull/3593>`_,
- `#3602 <https://github.com/fmtlib/fmt/pull/3602>`_).
- 10.1.0 - 2023-08-12
- -------------------
- * Optimized format string compilation resulting in up to 40% speed up in
- compiled ``format_to`` and ~4x speed up in compiled ``format_to_n`` on a
- concatenation benchmark (`#3133 <https://github.com/fmtlib/fmt/issues/3133>`_,
- `#3484 <https://github.com/fmtlib/fmt/issues/3484>`_).
- {fmt} 10.0::
- ---------------------------------------------------------
- Benchmark Time CPU Iterations
- ---------------------------------------------------------
- BM_format_to 78.9 ns 78.9 ns 8881746
- BM_format_to_n 568 ns 568 ns 1232089
- {fmt} 10.1::
- ---------------------------------------------------------
- Benchmark Time CPU Iterations
- ---------------------------------------------------------
- BM_format_to 54.9 ns 54.9 ns 12727944
- BM_format_to_n 133 ns 133 ns 5257795
- * Optimized storage of an empty allocator in ``basic_memory_buffer``
- (`#3485 <https://github.com/fmtlib/fmt/pull/3485>`_).
- Thanks `@Minty-Meeo <https://github.com/Minty-Meeo>`_.
- * Added formatters for proxy references to elements of ``std::vector<bool>`` and
- ``std::bitset<N>`` (`#3567 <https://github.com/fmtlib/fmt/issues/3567>`_,
- `#3570 <https://github.com/fmtlib/fmt/pull/3570>`_).
- For example (`godbolt <https://godbolt.org/z/zYb79Pvn8>`__):
- .. code:: c++
- #include <vector>
- #include <fmt/std.h>
- int main() {
- auto v = std::vector<bool>{true};
- fmt::print("{}", v[0]);
- }
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_ and
- `@felix642 (Félix-Antoine Constantin) <https://github.com/felix642>`_.
- * Fixed an ambiguous formatter specialization for containers that look like
- container adaptors such as ``boost::flat_set``
- (`#3556 <https://github.com/fmtlib/fmt/issues/3556>`_,
- `#3561 <https://github.com/fmtlib/fmt/pull/3561>`_).
- Thanks `@5chmidti <https://github.com/5chmidti>`_.
- * Fixed compilation when formatting durations not convertible from
- ``std::chrono::seconds`` (`#3430 <https://github.com/fmtlib/fmt/pull/3430>`_).
- Thanks `@patlkli (Patrick Geltinger) <https://github.com/patlkli>`_.
- * Made the ``formatter`` specialization for ``char*`` const-correct
- (`#3432 <https://github.com/fmtlib/fmt/pull/3432>`_).
- Thanks `@timsong-cpp <https://github.com/timsong-cpp>`_.
- * Made ``{}`` and ``{:}`` handled consistently during compile-time checks
- (`#3526 <https://github.com/fmtlib/fmt/issues/3526>`_).
- * Disallowed passing temporaries to ``make_format_args`` to improve API safety
- by preventing dangling references.
- * Improved the compile-time error for unformattable types
- (`#3478 <https://github.com/fmtlib/fmt/pull/3478>`_).
- Thanks `@BRevzin (Barry Revzin) <https://github.com/BRevzin>`_.
- * Improved the floating-point formatter
- (`#3448 <https://github.com/fmtlib/fmt/pull/3448>`_,
- `#3450 <https://github.com/fmtlib/fmt/pull/3450>`_).
- Thanks `@florimond-collette (Florimond Collette)
- <https://github.com/florimond-collette>`_.
- * Fixed handling of precision for ``long double`` larger than 64 bits.
- (`#3539 <https://github.com/fmtlib/fmt/issues/3539>`_,
- `#3564 <https://github.com/fmtlib/fmt/issues/3564>`_).
- * Made floating-point and chrono tests less platform-dependent
- (`#3337 <https://github.com/fmtlib/fmt/issues/3337>`_,
- `#3433 <https://github.com/fmtlib/fmt/issues/3433>`_,
- `#3434 <https://github.com/fmtlib/fmt/pull/3434>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Removed the remnants of the Grisu floating-point formatter that has been
- replaced by Dragonbox in earlier versions.
- * Added ``throw_format_error`` to the public API
- (`#3551 <https://github.com/fmtlib/fmt/pull/3551>`_).
- Thanks `@mjerabek (Martin Jeřábek) <https://github.com/mjerabek>`_.
- * Made ``FMT_THROW`` assert even if assertions are disabled when compiling with
- exceptions disabled (`#3418 <https://github.com/fmtlib/fmt/issues/3418>`_,
- `#3439 <https://github.com/fmtlib/fmt/pull/3439>`_).
- Thanks `@BRevzin (Barry Revzin) <https://github.com/BRevzin>`_.
- * Made ``format_as`` and ``std::filesystem::path`` formatter work with exotic
- code unit types.
- (`#3457 <https://github.com/fmtlib/fmt/pull/3457>`_,
- `#3476 <https://github.com/fmtlib/fmt/pull/3476>`_).
- Thanks `@gix (Nico Rieck) <https://github.com/gix>`_,
- `@hmbj (Hans-Martin B. Jensen) <https://github.com/hmbj>`_.
- * Added support for the ``?`` format specifier to ``std::filesystem::path`` and
- made the default unescaped for consistency with strings.
- * Deprecated the wide stream overload of ``printf``.
- * Removed unused ``basic_printf_parse_context``.
- * Improved RTTI detection used when formatting exceptions
- (`#3468 <https://github.com/fmtlib/fmt/pull/3468>`_).
- Thanks `@danakj (Dana Jansens) <https://github.com/danakj>`_.
- * Improved compatibility with VxWorks7
- (`#3467 <https://github.com/fmtlib/fmt/pull/3467>`_).
- Thanks `@wenshan1 (Bin Lan) <https://github.com/wenshan1>`_.
- * Improved documentation
- (`#3174 <https://github.com/fmtlib/fmt/issues/3174>`_,
- `#3423 <https://github.com/fmtlib/fmt/issues/3423>`_,
- `#3454 <https://github.com/fmtlib/fmt/pull/3454>`_,
- `#3458 <https://github.com/fmtlib/fmt/issues/3458>`_,
- `#3461 <https://github.com/fmtlib/fmt/pull/3461>`_,
- `#3487 <https://github.com/fmtlib/fmt/issues/3487>`_,
- `#3515 <https://github.com/fmtlib/fmt/pull/3515>`_).
- Thanks `@zencatalyst (Kasra Hashemi) <https://github.com/zencatalyst>`_,
- `@rlalik <https://github.com/rlalik>`_,
- `@mikecrowe (Mike Crowe) <https://github.com/mikecrowe>`_.
- * Improved build and CI configurations
- (`#3449 <https://github.com/fmtlib/fmt/issues/3449>`_,
- `#3451 <https://github.com/fmtlib/fmt/pull/3451>`_,
- `#3452 <https://github.com/fmtlib/fmt/pull/3452>`_,
- `#3453 <https://github.com/fmtlib/fmt/pull/3453>`_,
- `#3459 <https://github.com/fmtlib/fmt/pull/3459>`_,
- `#3481 <https://github.com/fmtlib/fmt/issues/3481>`_,
- `#3486 <https://github.com/fmtlib/fmt/pull/3486>`_,
- `#3489 <https://github.com/fmtlib/fmt/issues/3489>`_,
- `#3496 <https://github.com/fmtlib/fmt/pull/3496>`_,
- `#3517 <https://github.com/fmtlib/fmt/issues/3517>`_,
- `#3523 <https://github.com/fmtlib/fmt/pull/3523>`_,
- `#3563 <https://github.com/fmtlib/fmt/pull/3563>`_).
- Thanks `@joycebrum (Joyce) <https://github.com/joycebrum>`_,
- `@glebm (Gleb Mazovetskiy) <https://github.com/glebm>`_,
- `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_,
- `@petrmanek (Petr Mánek) <https://github.com/petrmanek>`_,
- `@setoye (Alta) <https://github.com/setoye>`_,
- `@abouvier (Alexandre Bouvier) <https://github.com/abouvier>`_.
- * Fixed various warnings and compilation issues
- (`#3408 <https://github.com/fmtlib/fmt/issues/3408>`_,
- `#3424 <https://github.com/fmtlib/fmt/issues/3424>`_,
- `#3444 <https://github.com/fmtlib/fmt/issues/3444>`_,
- `#3446 <https://github.com/fmtlib/fmt/pull/3446>`_,
- `#3475 <https://github.com/fmtlib/fmt/pull/3475>`_,
- `#3482 <https://github.com/fmtlib/fmt/pull/3482>`_,
- `#3492 <https://github.com/fmtlib/fmt/issues/3492>`_,
- `#3493 <https://github.com/fmtlib/fmt/pull/3493>`_,
- `#3508 <https://github.com/fmtlib/fmt/pull/3508>`_,
- `#3509 <https://github.com/fmtlib/fmt/issues/3509>`_,
- `#3533 <https://github.com/fmtlib/fmt/issues/3533>`_,
- `#3542 <https://github.com/fmtlib/fmt/pull/3542>`_,
- `#3543 <https://github.com/fmtlib/fmt/issues/3543>`_,
- `#3540 <https://github.com/fmtlib/fmt/issues/3540>`_,
- `#3544 <https://github.com/fmtlib/fmt/pull/3544>`_,
- `#3548 <https://github.com/fmtlib/fmt/issues/3548>`_,
- `#3549 <https://github.com/fmtlib/fmt/pull/3549>`_,
- `#3550 <https://github.com/fmtlib/fmt/pull/3550>`_,
- `#3552 <https://github.com/fmtlib/fmt/pull/3552>`_).
- Thanks `@adesitter (Arnaud Desitter) <https://github.com/adesitter>`_,
- `@hmbj (Hans-Martin B. Jensen) <https://github.com/hmbj>`_,
- `@Minty-Meeo <https://github.com/Minty-Meeo>`_,
- `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_,
- `@TobiSchluter (Tobias Schlüter) <https://github.com/TobiSchluter>`_,
- `@kieranclancy (Kieran Clancy) <https://github.com/kieranclancy>`_,
- `@alexeedm (Dmitry Alexeev) <https://github.com/alexeedm>`_,
- `@jurihock (Jürgen Hock) <https://github.com/jurihock>`_,
- `@Ozomahtli <https://github.com/Ozomahtli>`_,
- `@razaqq <https://github.com/razaqq>`_.
- 10.0.0 - 2023-05-09
- -------------------
- * Replaced Grisu with a new floating-point formatting algorithm for given
- precision (`#3262 <https://github.com/fmtlib/fmt/issues/3262>`_,
- `#2750 <https://github.com/fmtlib/fmt/issues/2750>`_,
- `#3269 <https://github.com/fmtlib/fmt/pull/3269>`_,
- `#3276 <https://github.com/fmtlib/fmt/pull/3276>`_).
- The new algorithm is based on Dragonbox already used for the
- shortest representation and gives substantial performance improvement:
- .. image:: https://user-images.githubusercontent.com/33922675/
- 211956670-84891a09-6867-47d9-82fc-3230da7abe0f.png
- * Red: new algorithm
- * Green: new algorithm with ``FMT_USE_FULL_CACHE_DRAGONBOX`` defined to 1
- * Blue: old algorithm
- Thanks `@jk-jeon (Junekey Jeon) <https://github.com/jk-jeon>`_.
- * Replaced ``snprintf``-based hex float formatter with an internal
- implementation (`#3179 <https://github.com/fmtlib/fmt/pull/3179>`_,
- `#3203 <https://github.com/fmtlib/fmt/pull/3203>`_).
- This removes the last usage of ``s(n)printf`` in {fmt}.
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Fixed alignment of floating-point numbers with localization
- (`#3263 <https://github.com/fmtlib/fmt/issues/3263>`_,
- `#3272 <https://github.com/fmtlib/fmt/pull/3272>`_).
- Thanks `@ShawnZhong (Shawn Zhong) <https://github.com/ShawnZhong>`_.
- * Made handling of ``#`` consistent with ``std::format``.
- * Improved C++20 module support
- (`#3134 <https://github.com/fmtlib/fmt/pull/3134>`_,
- `#3254 <https://github.com/fmtlib/fmt/pull/3254>`_,
- `#3386 <https://github.com/fmtlib/fmt/pull/3386>`_,
- `#3387 <https://github.com/fmtlib/fmt/pull/3387>`_,
- `#3388 <https://github.com/fmtlib/fmt/pull/3388>`_,
- `#3392 <https://github.com/fmtlib/fmt/pull/3392>`_,
- `#3397 <https://github.com/fmtlib/fmt/pull/3397>`_,
- `#3399 <https://github.com/fmtlib/fmt/pull/3399>`_,
- `#3400 <https://github.com/fmtlib/fmt/pull/3400>`_).
- Thanks `@laitingsheng (Tinson Lai) <https://github.com/laitingsheng>`_,
- `@Orvid (Orvid King) <https://github.com/Orvid>`_,
- `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_.
- Switched to the `modules CMake library <https://github.com/vitaut/modules>`_
- which allows building {fmt} as a C++20 module with clang::
- CXX=clang++ cmake -DFMT_MODULE=ON .
- make
- * Made ``format_as`` work with any user-defined type and not just enums.
- For example (`godbolt <https://godbolt.org/z/b7rqhq5Kh>`__):
- .. code:: c++
- #include <fmt/format.h>
- struct floaty_mc_floatface {
- double value;
- };
- auto format_as(floaty_mc_floatface f) { return f.value; }
- int main() {
- fmt::print("{:8}\n", floaty_mc_floatface{0.42}); // prints " 0.42"
- }
- * Removed deprecated implicit conversions for enums and conversions to primitive
- types for compatibility with ``std::format`` and to prevent potential ODR
- violations. Use ``format_as`` instead.
- * Added support for fill, align and width to the time point formatter
- (`#3237 <https://github.com/fmtlib/fmt/issues/3237>`_,
- `#3260 <https://github.com/fmtlib/fmt/pull/3260>`_,
- `#3275 <https://github.com/fmtlib/fmt/pull/3275>`_).
- For example (`godbolt <https://godbolt.org/z/rKP6MGz6c>`__):
- .. code:: c++
- #include <fmt/chrono.h>
- int main() {
- // prints " 2023"
- fmt::print("{:>8%Y}\n", std::chrono::system_clock::now());
- }
- Thanks `@ShawnZhong (Shawn Zhong) <https://github.com/ShawnZhong>`_.
- * Implemented formatting of subseconds
- (`#2207 <https://github.com/fmtlib/fmt/issues/2207>`_,
- `#3117 <https://github.com/fmtlib/fmt/issues/3117>`_,
- `#3115 <https://github.com/fmtlib/fmt/pull/3115>`_,
- `#3143 <https://github.com/fmtlib/fmt/pull/3143>`_,
- `#3144 <https://github.com/fmtlib/fmt/pull/3144>`_,
- `#3349 <https://github.com/fmtlib/fmt/pull/3349>`_).
- For example (`godbolt <https://godbolt.org/z/45738oGEo>`__):
- .. code:: c++
- #include <fmt/chrono.h>
- int main() {
- // prints 01.234567
- fmt::print("{:%S}\n", std::chrono::microseconds(1234567));
- }
- Thanks `@patrickroocks (Patrick Roocks) <https://github.com/patrickroocks>`_
- `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_,
- `@BRevzin (Barry Revzin) <https://github.com/BRevzin>`_.
- * Added precision support to ``%S``
- (`#3148 <https://github.com/fmtlib/fmt/pull/3148>`_).
- Thanks `@SappyJoy (Stepan Ponomaryov) <https://github.com/SappyJoy>`_
- * Added support for ``std::utc_time``
- (`#3098 <https://github.com/fmtlib/fmt/issues/3098>`_,
- `#3110 <https://github.com/fmtlib/fmt/pull/3110>`_).
- Thanks `@patrickroocks (Patrick Roocks) <https://github.com/patrickroocks>`_.
- * Switched formatting of ``std::chrono::system_clock`` from local time to UTC
- for compatibility with the standard
- (`#3199 <https://github.com/fmtlib/fmt/issues/3199>`_,
- `#3230 <https://github.com/fmtlib/fmt/pull/3230>`_).
- Thanks `@ned14 (Niall Douglas) <https://github.com/ned14>`_.
- * Added support for ``%Ez`` and ``%Oz`` to chrono formatters.
- (`#3220 <https://github.com/fmtlib/fmt/issues/3220>`_,
- `#3222 <https://github.com/fmtlib/fmt/pull/3222>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Improved validation of format specifiers for ``std::chrono::duration``
- (`#3219 <https://github.com/fmtlib/fmt/issues/3219>`_,
- `#3232 <https://github.com/fmtlib/fmt/pull/3232>`_).
- Thanks `@ShawnZhong (Shawn Zhong) <https://github.com/ShawnZhong>`_.
- * Fixed formatting of time points before the epoch
- (`#3117 <https://github.com/fmtlib/fmt/issues/3117>`_,
- `#3261 <https://github.com/fmtlib/fmt/pull/3261>`_).
- For example (`godbolt <https://godbolt.org/z/f7bcznb3W>`__):
- .. code:: c++
- #include <fmt/chrono.h>
- int main() {
- auto t = std::chrono::system_clock::from_time_t(0) -
- std::chrono::milliseconds(250);
- fmt::print("{:%S}\n", t); // prints 59.750000000
- }
- Thanks `@ShawnZhong (Shawn Zhong) <https://github.com/ShawnZhong>`_.
- * Experimental: implemented glibc extension for padding seconds, minutes and
- hours (`#2959 <https://github.com/fmtlib/fmt/issues/2959>`_,
- `#3271 <https://github.com/fmtlib/fmt/pull/3271>`_).
- Thanks `@ShawnZhong (Shawn Zhong) <https://github.com/ShawnZhong>`_.
- * Added a formatter for ``std::exception``
- (`#2977 <https://github.com/fmtlib/fmt/issues/2977>`_,
- `#3012 <https://github.com/fmtlib/fmt/issues/3012>`_,
- `#3062 <https://github.com/fmtlib/fmt/pull/3062>`_,
- `#3076 <https://github.com/fmtlib/fmt/pull/3076>`_,
- `#3119 <https://github.com/fmtlib/fmt/pull/3119>`_).
- For example (`godbolt <https://godbolt.org/z/8xoWGs9e4>`__):
- .. code:: c++
- #include <fmt/std.h>
- #include <vector>
- int main() {
- try {
- std::vector<bool>().at(0);
- } catch(const std::exception& e) {
- fmt::print("{}", e);
- }
- }
- prints::
- vector<bool>::_M_range_check: __n (which is 0) >= this->size() (which is 0)
- on libstdc++.
- Thanks `@zach2good (Zach Toogood) <https://github.com/zach2good>`_ and
- `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Moved ``std::error_code`` formatter from ``fmt/os.h`` to ``fmt/std.h``.
- (`#3125 <https://github.com/fmtlib/fmt/pull/3125>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Added formatters for standard container adapters: ``std::priority_queue``,
- ``std::queue`` and ``std::stack``
- (`#3215 <https://github.com/fmtlib/fmt/issues/3215>`_,
- `#3279 <https://github.com/fmtlib/fmt/pull/3279>`_).
- For example (`godbolt <https://godbolt.org/z/74h1xY9qK>`__):
- .. code:: c++
- #include <fmt/ranges.h>
- #include <stack>
- #include <vector>
- int main() {
- auto s = std::stack<bool, std::vector<bool>>();
- for (auto b: {true, false, true}) s.push(b);
- fmt::print("{}\n", s); // prints [true, false, true]
- }
- Thanks `@ShawnZhong (Shawn Zhong) <https://github.com/ShawnZhong>`_.
- * Added a formatter for ``std::optional`` to ``fmt/std.h``.
- Thanks `@tom-huntington <https://github.com/tom-huntington>`_.
- * Fixed formatting of valueless by exception variants
- (`#3347 <https://github.com/fmtlib/fmt/pull/3347>`_).
- Thanks `@TheOmegaCarrot <https://github.com/TheOmegaCarrot>`_.
- * Made ``fmt::ptr`` accept ``unique_ptr`` with a custom deleter
- (`#3177 <https://github.com/fmtlib/fmt/pull/3177>`_).
- Thanks `@hmbj (Hans-Martin B. Jensen) <https://github.com/hmbj>`_.
- * Fixed formatting of noncopyable ranges and nested ranges of chars
- (`#3158 <https://github.com/fmtlib/fmt/pull/3158>`_
- `#3286 <https://github.com/fmtlib/fmt/issues/3286>`_,
- `#3290 <https://github.com/fmtlib/fmt/pull/3290>`_).
- Thanks `@BRevzin (Barry Revzin) <https://github.com/BRevzin>`_.
- * Fixed issues with formatting of paths and ranges of paths
- (`#3319 <https://github.com/fmtlib/fmt/issues/3319>`_,
- `#3321 <https://github.com/fmtlib/fmt/pull/3321>`_
- `#3322 <https://github.com/fmtlib/fmt/issues/3322>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Improved handling of invalid Unicode in paths.
- * Enabled compile-time checks on Apple clang 14 and later
- (`#3331 <https://github.com/fmtlib/fmt/pull/3331>`_).
- Thanks `@cloyce (Cloyce D. Spradling) <https://github.com/cloyce>`_.
- * Improved compile-time checks of named arguments
- (`#3105 <https://github.com/fmtlib/fmt/issues/3105>`_,
- `#3214 <https://github.com/fmtlib/fmt/pull/3214>`_).
- Thanks `@rbrich (Radek Brich) <https://github.com/rbrich>`_.
- * Fixed formatting when both alignment and ``0`` are given
- (`#3236 <https://github.com/fmtlib/fmt/issues/3236>`_,
- `#3248 <https://github.com/fmtlib/fmt/pull/3248>`_).
- Thanks `@ShawnZhong (Shawn Zhong) <https://github.com/ShawnZhong>`_.
- * Improved Unicode support in the experimental file API on Windows
- (`#3234 <https://github.com/fmtlib/fmt/issues/3234>`_,
- `#3293 <https://github.com/fmtlib/fmt/pull/3293>`_).
- Thanks `@Fros1er (Froster) <https://github.com/Fros1er>`_.
- * Unified UTF transcoding
- (`#3416 <https://github.com/fmtlib/fmt/pull/3416>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Added support for UTF-8 digit separators via an experimental locale facet
- (`#1861 <https://github.com/fmtlib/fmt/issues/1861>`_).
- For example (`godbolt <https://godbolt.org/z/f7bcznb3W>`__):
- .. code:: c++
- auto loc = std::locale(
- std::locale(), new fmt::format_facet<std::locale>("’"));
- auto s = fmt::format(loc, "{:L}", 1000);
- where ``’`` is U+2019 used as a digit separator in the de_CH locale.
- * Added an overload of ``formatted_size`` that takes a locale
- (`#3084 <https://github.com/fmtlib/fmt/issues/3084>`_,
- `#3087 <https://github.com/fmtlib/fmt/pull/3087>`_).
- Thanks `@gerboengels <https://github.com/gerboengels>`_.
- * Removed the deprecated ``FMT_DEPRECATED_OSTREAM``.
- * Fixed a UB when using a null ``std::string_view`` with ``fmt::to_string``
- or format string compilation
- (`#3241 <https://github.com/fmtlib/fmt/issues/3241>`_,
- `#3244 <https://github.com/fmtlib/fmt/pull/3244>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Added ``starts_with`` to the fallback ``string_view`` implementation
- (`#3080 <https://github.com/fmtlib/fmt/pull/3080>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Added ``fmt::basic_format_string::get()`` for compatibility with
- ``basic_format_string`` (`#3111 <https://github.com/fmtlib/fmt/pull/3111>`_).
- Thanks `@huangqinjin <https://github.com/huangqinjin>`_.
- * Added ``println`` for compatibility with C++23
- (`#3267 <https://github.com/fmtlib/fmt/pull/3267>`_).
- Thanks `@ShawnZhong (Shawn Zhong) <https://github.com/ShawnZhong>`_.
- * Renamed the ``FMT_EXPORT`` macro for shared library usage to
- ``FMT_LIB_EXPORT``.
- * Improved documentation
- (`#3108 <https://github.com/fmtlib/fmt/issues/3108>`_,
- `#3169 <https://github.com/fmtlib/fmt/issues/3169>`_,
- `#3243 <https://github.com/fmtlib/fmt/pull/3243>`_).
- `#3404 <https://github.com/fmtlib/fmt/pull/3404>`_).
- Thanks `@Cleroth <https://github.com/Cleroth>`_ and
- `@Vertexwahn <https://github.com/Vertexwahn>`_.
- * Improved build configuration and tests
- (`#3118 <https://github.com/fmtlib/fmt/pull/3118>`_,
- `#3120 <https://github.com/fmtlib/fmt/pull/3120>`_,
- `#3188 <https://github.com/fmtlib/fmt/pull/3188>`_,
- `#3189 <https://github.com/fmtlib/fmt/issues/3189>`_,
- `#3198 <https://github.com/fmtlib/fmt/pull/3198>`_,
- `#3205 <https://github.com/fmtlib/fmt/pull/3205>`_,
- `#3207 <https://github.com/fmtlib/fmt/pull/3207>`_,
- `#3210 <https://github.com/fmtlib/fmt/pull/3210>`_,
- `#3240 <https://github.com/fmtlib/fmt/pull/3240>`_,
- `#3256 <https://github.com/fmtlib/fmt/pull/3256>`_,
- `#3264 <https://github.com/fmtlib/fmt/pull/3264>`_,
- `#3299 <https://github.com/fmtlib/fmt/issues/3299>`_,
- `#3302 <https://github.com/fmtlib/fmt/pull/3302>`_,
- `#3312 <https://github.com/fmtlib/fmt/pull/3312>`_,
- `#3317 <https://github.com/fmtlib/fmt/issues/3317>`_,
- `#3328 <https://github.com/fmtlib/fmt/pull/3328>`_,
- `#3333 <https://github.com/fmtlib/fmt/pull/3333>`_,
- `#3369 <https://github.com/fmtlib/fmt/pull/3369>`_,
- `#3373 <https://github.com/fmtlib/fmt/issues/3373>`_,
- `#3395 <https://github.com/fmtlib/fmt/pull/3395>`_,
- `#3406 <https://github.com/fmtlib/fmt/pull/3406>`_,
- `#3411 <https://github.com/fmtlib/fmt/pull/3411>`_).
- Thanks `@dimztimz (Dimitrij Mijoski) <https://github.com/dimztimz>`_,
- `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_,
- `@DavidKorczynski <https://github.com/DavidKorczynski>`_,
- `@ChrisThrasher (Chris Thrasher) <https://github.com/ChrisThrasher>`_,
- `@FrancoisCarouge (François Carouge) <https://github.com/FrancoisCarouge>`_,
- `@kennyweiss (Kenny Weiss) <https://github.com/kennyweiss>`_,
- `@luzpaz <https://github.com/luzpaz>`_,
- `@codeinred (Alecto Irene Perez) <https://github.com/codeinred>`_,
- `@Mixaill (Mikhail Paulyshka) <https://github.com/Mixaill>`_,
- `@joycebrum (Joyce) <https://github.com/joycebrum>`_,
- `@kevinhwang (Kevin Hwang) <https://github.com/kevinhwang>`_,
- `@Vertexwahn <https://github.com/Vertexwahn>`_.
- * Fixed a regression in handling empty format specifiers after a colon (``{:}``)
- (`#3086 <https://github.com/fmtlib/fmt/pull/3086>`_).
- Thanks `@oxidase (Michael Krasnyk) <https://github.com/oxidase>`_.
- * Worked around a broken implementation of ``std::is_constant_evaluated`` in
- some versions of libstdc++ on clang
- (`#3247 <https://github.com/fmtlib/fmt/issues/3247>`_,
- `#3281 <https://github.com/fmtlib/fmt/pull/3281>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Fixed formatting of volatile variables
- (`#3068 <https://github.com/fmtlib/fmt/pull/3068>`_).
- * Fixed various warnings and compilation issues
- (`#3057 <https://github.com/fmtlib/fmt/pull/3057>`_,
- `#3066 <https://github.com/fmtlib/fmt/pull/3066>`_,
- `#3072 <https://github.com/fmtlib/fmt/pull/3072>`_,
- `#3082 <https://github.com/fmtlib/fmt/pull/3082>`_,
- `#3091 <https://github.com/fmtlib/fmt/pull/3091>`_,
- `#3092 <https://github.com/fmtlib/fmt/issues/3092>`_,
- `#3093 <https://github.com/fmtlib/fmt/pull/3093>`_,
- `#3095 <https://github.com/fmtlib/fmt/pull/3095>`_,
- `#3096 <https://github.com/fmtlib/fmt/issues/3096>`_,
- `#3097 <https://github.com/fmtlib/fmt/pull/3097>`_,
- `#3128 <https://github.com/fmtlib/fmt/issues/3128>`_,
- `#3129 <https://github.com/fmtlib/fmt/pull/3129>`_,
- `#3137 <https://github.com/fmtlib/fmt/pull/3137>`_,
- `#3139 <https://github.com/fmtlib/fmt/pull/3139>`_,
- `#3140 <https://github.com/fmtlib/fmt/issues/3140>`_,
- `#3142 <https://github.com/fmtlib/fmt/pull/3142>`_,
- `#3149 <https://github.com/fmtlib/fmt/issues/3149>`_,
- `#3150 <https://github.com/fmtlib/fmt/pull/3150>`_,
- `#3154 <https://github.com/fmtlib/fmt/issues/3154>`_,
- `#3163 <https://github.com/fmtlib/fmt/issues/3163>`_,
- `#3178 <https://github.com/fmtlib/fmt/issues/3178>`_,
- `#3184 <https://github.com/fmtlib/fmt/pull/3184>`_,
- `#3196 <https://github.com/fmtlib/fmt/pull/3196>`_,
- `#3204 <https://github.com/fmtlib/fmt/issues/3204>`_,
- `#3206 <https://github.com/fmtlib/fmt/pull/3206>`_,
- `#3208 <https://github.com/fmtlib/fmt/pull/3208>`_,
- `#3213 <https://github.com/fmtlib/fmt/issues/3213>`_,
- `#3216 <https://github.com/fmtlib/fmt/pull/3216>`_,
- `#3224 <https://github.com/fmtlib/fmt/issues/3224>`_,
- `#3226 <https://github.com/fmtlib/fmt/issues/3226>`_,
- `#3228 <https://github.com/fmtlib/fmt/issues/3228>`_,
- `#3229 <https://github.com/fmtlib/fmt/pull/3229>`_,
- `#3259 <https://github.com/fmtlib/fmt/pull/3259>`_,
- `#3274 <https://github.com/fmtlib/fmt/issues/3274>`_,
- `#3287 <https://github.com/fmtlib/fmt/issues/3287>`_,
- `#3288 <https://github.com/fmtlib/fmt/pull/3288>`_,
- `#3292 <https://github.com/fmtlib/fmt/issues/3292>`_,
- `#3295 <https://github.com/fmtlib/fmt/pull/3295>`_,
- `#3296 <https://github.com/fmtlib/fmt/pull/3296>`_,
- `#3298 <https://github.com/fmtlib/fmt/issues/3298>`_,
- `#3325 <https://github.com/fmtlib/fmt/issues/3325>`_,
- `#3326 <https://github.com/fmtlib/fmt/pull/3326>`_,
- `#3334 <https://github.com/fmtlib/fmt/issues/3334>`_,
- `#3342 <https://github.com/fmtlib/fmt/issues/3342>`_,
- `#3343 <https://github.com/fmtlib/fmt/pull/3343>`_,
- `#3351 <https://github.com/fmtlib/fmt/issues/3351>`_,
- `#3352 <https://github.com/fmtlib/fmt/pull/3352>`_,
- `#3362 <https://github.com/fmtlib/fmt/pull/3362>`_,
- `#3365 <https://github.com/fmtlib/fmt/issues/3365>`_,
- `#3366 <https://github.com/fmtlib/fmt/pull/3366>`_,
- `#3374 <https://github.com/fmtlib/fmt/pull/3374>`_,
- `#3377 <https://github.com/fmtlib/fmt/issues/3377>`_,
- `#3378 <https://github.com/fmtlib/fmt/pull/3378>`_,
- `#3381 <https://github.com/fmtlib/fmt/issues/3381>`_,
- `#3398 <https://github.com/fmtlib/fmt/pull/3398>`_,
- `#3413 <https://github.com/fmtlib/fmt/pull/3413>`_,
- `#3415 <https://github.com/fmtlib/fmt/issues/3415>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_,
- `@gsjaardema (Greg Sjaardema) <https://github.com/gsjaardema>`_,
- `@NewbieOrange <https://github.com/NewbieOrange>`_,
- `@EngineLessCC (VivyaCC) <https://github.com/EngineLessCC>`_,
- `@asmaloney (Andy Maloney) <https://github.com/asmaloney>`_,
- `@HazardyKnusperkeks (Björn Schäpers)
- <https://github.com/HazardyKnusperkeks>`_,
- `@sergiud (Sergiu Deitsch) <https://github.com/sergiud>`_,
- `@Youw (Ihor Dutchak) <https://github.com/Youw>`_,
- `@thesmurph <https://github.com/thesmurph>`_,
- `@czudziakm (Maksymilian Czudziak) <https://github.com/czudziakm>`_,
- `@Roman-Koshelev <https://github.com/Roman-Koshelev>`_,
- `@chronoxor (Ivan Shynkarenka) <https://github.com/chronoxor>`_,
- `@ShawnZhong (Shawn Zhong) <https://github.com/ShawnZhong>`_,
- `@russelltg (Russell Greene) <https://github.com/russelltg>`_,
- `@glebm (Gleb Mazovetskiy) <https://github.com/glebm>`_,
- `@tmartin-gh <https://github.com/tmartin-gh>`_,
- `@Zhaojun-Liu (June Liu) <https://github.com/Zhaojun-Liu>`_,
- `@louiswins (Louis Wilson) <https://github.com/louiswins>`_,
- `@mogemimi <https://github.com/mogemimi>`_.
- 9.1.0 - 2022-08-27
- ------------------
- * ``fmt::formatted_size`` now works at compile time
- (`#3026 <https://github.com/fmtlib/fmt/pull/3026>`_). For example
- (`godbolt <https://godbolt.org/z/1MW5rMdf8>`__):
- .. code:: c++
- #include <fmt/compile.h>
- int main() {
- using namespace fmt::literals;
- constexpr size_t n = fmt::formatted_size("{}"_cf, 42);
- fmt::print("{}\n", n); // prints 2
- }
- Thanks `@marksantaniello (Mark Santaniello)
- <https://github.com/marksantaniello>`_.
- * Fixed handling of invalid UTF-8
- (`#3038 <https://github.com/fmtlib/fmt/pull/3038>`_,
- `#3044 <https://github.com/fmtlib/fmt/pull/3044>`_,
- `#3056 <https://github.com/fmtlib/fmt/pull/3056>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_ and
- `@skeeto (Christopher Wellons) <https://github.com/skeeto>`_.
- * Improved Unicode support in ``ostream`` overloads of ``print``
- (`#2994 <https://github.com/fmtlib/fmt/pull/2994>`_,
- `#3001 <https://github.com/fmtlib/fmt/pull/3001>`_,
- `#3025 <https://github.com/fmtlib/fmt/pull/3025>`_).
- Thanks `@dimztimz (Dimitrij Mijoski) <https://github.com/dimztimz>`_.
- * Fixed handling of the sign specifier in localized formatting on systems with
- 32-bit ``wchar_t`` (`#3041 <https://github.com/fmtlib/fmt/issues/3041>`_).
- * Added support for wide streams to ``fmt::streamed``
- (`#2994 <https://github.com/fmtlib/fmt/pull/2994>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Added the ``n`` specifier that disables the output of delimiters when
- formatting ranges (`#2981 <https://github.com/fmtlib/fmt/pull/2981>`_,
- `#2983 <https://github.com/fmtlib/fmt/pull/2983>`_).
- For example (`godbolt <https://godbolt.org/z/roKqGdj8c>`__):
- .. code:: c++
- #include <fmt/ranges.h>
- #include <vector>
- int main() {
- auto v = std::vector{1, 2, 3};
- fmt::print("{:n}\n", v); // prints 1, 2, 3
- }
- Thanks `@BRevzin (Barry Revzin) <https://github.com/BRevzin>`_.
- * Worked around problematic ``std::string_view`` constructors introduced in
- C++23 (`#3030 <https://github.com/fmtlib/fmt/issues/3030>`_,
- `#3050 <https://github.com/fmtlib/fmt/issues/3050>`_).
- Thanks `@strega-nil-ms (nicole mazzuca) <https://github.com/strega-nil-ms>`_.
- * Improve handling (exclusion) of recursive ranges
- (`#2968 <https://github.com/fmtlib/fmt/issues/2968>`_,
- `#2974 <https://github.com/fmtlib/fmt/pull/2974>`_).
- Thanks `@Dani-Hub (Daniel Krügler) <https://github.com/Dani-Hub>`_.
- * Improved error reporting in format string compilation
- (`#3055 <https://github.com/fmtlib/fmt/issues/3055>`_).
- * Improved the implementation of
- `Dragonbox <https://github.com/jk-jeon/dragonbox>`_, the algorithm used for
- the default floating-point formatting
- (`#2984 <https://github.com/fmtlib/fmt/pull/2984>`_).
- Thanks `@jk-jeon (Junekey Jeon) <https://github.com/jk-jeon>`_.
- * Fixed issues with floating-point formatting on exotic platforms.
- * Improved the implementation of chrono formatting
- (`#3010 <https://github.com/fmtlib/fmt/pull/3010>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Improved documentation
- (`#2966 <https://github.com/fmtlib/fmt/pull/2966>`_,
- `#3009 <https://github.com/fmtlib/fmt/pull/3009>`_,
- `#3020 <https://github.com/fmtlib/fmt/issues/3020>`_,
- `#3037 <https://github.com/fmtlib/fmt/pull/3037>`_).
- Thanks `@mwinterb <https://github.com/mwinterb>`_,
- `@jcelerier (Jean-Michaël Celerier) <https://github.com/jcelerier>`_
- and `@remiburtin (Rémi Burtin) <https://github.com/remiburtin>`_.
- * Improved build configuration
- (`#2991 <https://github.com/fmtlib/fmt/pull/2991>`_,
- `#2995 <https://github.com/fmtlib/fmt/pull/2995>`_,
- `#3004 <https://github.com/fmtlib/fmt/issues/3004>`_,
- `#3007 <https://github.com/fmtlib/fmt/pull/3007>`_,
- `#3040 <https://github.com/fmtlib/fmt/pull/3040>`_).
- Thanks `@dimztimz (Dimitrij Mijoski) <https://github.com/dimztimz>`_ and
- `@hwhsu1231 (Haowei Hsu) <https://github.com/hwhsu1231>`_.
- * Fixed various warnings and compilation issues
- (`#2969 <https://github.com/fmtlib/fmt/issues/2969>`_,
- `#2971 <https://github.com/fmtlib/fmt/pull/2971>`_,
- `#2975 <https://github.com/fmtlib/fmt/issues/2975>`_,
- `#2982 <https://github.com/fmtlib/fmt/pull/2982>`_,
- `#2985 <https://github.com/fmtlib/fmt/pull/2985>`_,
- `#2988 <https://github.com/fmtlib/fmt/issues/2988>`_,
- `#2989 <https://github.com/fmtlib/fmt/issues/2989>`_,
- `#3000 <https://github.com/fmtlib/fmt/issues/3000>`_,
- `#3006 <https://github.com/fmtlib/fmt/issues/3006>`_,
- `#3014 <https://github.com/fmtlib/fmt/issues/3014>`_,
- `#3015 <https://github.com/fmtlib/fmt/issues/3015>`_,
- `#3021 <https://github.com/fmtlib/fmt/pull/3021>`_,
- `#3023 <https://github.com/fmtlib/fmt/issues/3023>`_,
- `#3024 <https://github.com/fmtlib/fmt/pull/3024>`_,
- `#3029 <https://github.com/fmtlib/fmt/pull/3029>`_,
- `#3043 <https://github.com/fmtlib/fmt/pull/3043>`_,
- `#3052 <https://github.com/fmtlib/fmt/issues/3052>`_,
- `#3053 <https://github.com/fmtlib/fmt/pull/3053>`_,
- `#3054 <https://github.com/fmtlib/fmt/pull/3054>`_).
- Thanks `@h-friederich (Hannes Friederich) <https://github.com/h-friederich>`_,
- `@dimztimz (Dimitrij Mijoski) <https://github.com/dimztimz>`_,
- `@olupton (Olli Lupton) <https://github.com/olupton>`_,
- `@bernhardmgruber (Bernhard Manfred Gruber)
- <https://github.com/bernhardmgruber>`_,
- `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- 9.0.0 - 2022-07-04
- ------------------
- * Switched to the internal floating point formatter for all decimal presentation
- formats. In particular this results in consistent rounding on all platforms
- and removing the ``s[n]printf`` fallback for decimal FP formatting.
- * Compile-time floating point formatting no longer requires the header-only
- mode. For example (`godbolt <https://godbolt.org/z/G37PTeG3b>`__):
- .. code:: c++
- #include <array>
- #include <fmt/compile.h>
- consteval auto compile_time_dtoa(double value) -> std::array<char, 10> {
- auto result = std::array<char, 10>();
- fmt::format_to(result.data(), FMT_COMPILE("{}"), value);
- return result;
- }
- constexpr auto answer = compile_time_dtoa(0.42);
- works with the default settings.
- * Improved the implementation of
- `Dragonbox <https://github.com/jk-jeon/dragonbox>`_, the algorithm used for
- the default floating-point formatting
- (`#2713 <https://github.com/fmtlib/fmt/pull/2713>`_,
- `#2750 <https://github.com/fmtlib/fmt/pull/2750>`_).
- Thanks `@jk-jeon (Junekey Jeon) <https://github.com/jk-jeon>`_.
- * Made ``fmt::to_string`` work with ``__float128``. This uses the internal
- FP formatter and works even on system without ``__float128`` support in
- ``[s]printf``.
- * Disabled automatic ``std::ostream`` insertion operator (``operator<<``)
- discovery when ``fmt/ostream.h`` is included to prevent ODR violations.
- You can get the old behavior by defining ``FMT_DEPRECATED_OSTREAM`` but this
- will be removed in the next major release. Use ``fmt::streamed`` or
- ``fmt::ostream_formatter`` to enable formatting via ``std::ostream`` instead.
-
- * Added ``fmt::ostream_formatter`` that can be used to write ``formatter``
- specializations that perform formatting via ``std::ostream``.
- For example (`godbolt <https://godbolt.org/z/5sEc5qMsf>`__):
- .. code:: c++
- #include <fmt/ostream.h>
- struct date {
- int year, month, day;
- friend std::ostream& operator<<(std::ostream& os, const date& d) {
- return os << d.year << '-' << d.month << '-' << d.day;
- }
- };
- template <> struct fmt::formatter<date> : ostream_formatter {};
- std::string s = fmt::format("The date is {}", date{2012, 12, 9});
- // s == "The date is 2012-12-9"
- * Added the ``fmt::streamed`` function that takes an object and formats it
- via ``std::ostream``.
- For example (`godbolt <https://godbolt.org/z/5G3346G1f>`__):
- .. code:: c++
- #include <thread>
- #include <fmt/ostream.h>
- int main() {
- fmt::print("Current thread id: {}\n",
- fmt::streamed(std::this_thread::get_id()));
- }
- Note that ``fmt/std.h`` provides a ``formatter`` specialization for
- ``std::thread::id`` so you don't need to format it via ``std::ostream``.
- * Deprecated implicit conversions of unscoped enums to integers for consistency
- with scoped enums.
- * Added an argument-dependent lookup based ``format_as`` extension API to
- simplify formatting of enums.
- * Added experimental ``std::variant`` formatting support
- (`#2941 <https://github.com/fmtlib/fmt/pull/2941>`_).
- For example (`godbolt <https://godbolt.org/z/KG9z6cq68>`__):
- .. code:: c++
- #include <variant>
- #include <fmt/std.h>
- int main() {
- auto v = std::variant<int, std::string>(42);
- fmt::print("{}\n", v);
- }
- prints::
- variant(42)
- Thanks `@jehelset <https://github.com/jehelset>`_.
- * Added experimental ``std::filesystem::path`` formatting support
- (`#2865 <https://github.com/fmtlib/fmt/issues/2865>`_,
- `#2902 <https://github.com/fmtlib/fmt/pull/2902>`_,
- `#2917 <https://github.com/fmtlib/fmt/issues/2917>`_,
- `#2918 <https://github.com/fmtlib/fmt/pull/2918>`_).
- For example (`godbolt <https://godbolt.org/z/o44dMexEb>`__):
- .. code:: c++
- #include <filesystem>
- #include <fmt/std.h>
- int main() {
- fmt::print("There is no place like {}.", std::filesystem::path("/home"));
- }
- prints::
- There is no place like "/home".
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Added a ``std::thread::id`` formatter to ``fmt/std.h``.
- For example (`godbolt <https://godbolt.org/z/j1azbYf3E>`__):
- .. code:: c++
- #include <thread>
- #include <fmt/std.h>
- int main() {
- fmt::print("Current thread id: {}\n", std::this_thread::get_id());
- }
- * Added ``fmt::styled`` that applies a text style to an individual argument
- (`#2793 <https://github.com/fmtlib/fmt/pull/2793>`_).
- For example (`godbolt <https://godbolt.org/z/vWGW7v5M6>`__):
- .. code:: c++
- #include <fmt/chrono.h>
- #include <fmt/color.h>
- int main() {
- auto now = std::chrono::system_clock::now();
- fmt::print(
- "[{}] {}: {}\n",
- fmt::styled(now, fmt::emphasis::bold),
- fmt::styled("error", fg(fmt::color::red)),
- "something went wrong");
- }
- prints
- .. image:: https://user-images.githubusercontent.com/576385/
- 175071215-12809244-dab0-4005-96d8-7cd911c964d5.png
- Thanks `@rbrugo (Riccardo Brugo) <https://github.com/rbrugo>`_.
- * Made ``fmt::print`` overload for text styles correctly handle UTF-8
- (`#2681 <https://github.com/fmtlib/fmt/issues/2681>`_,
- `#2701 <https://github.com/fmtlib/fmt/pull/2701>`_).
- Thanks `@AlexGuteniev (Alex Guteniev) <https://github.com/AlexGuteniev>`_.
- * Fixed Unicode handling when writing to an ostream.
- * Added support for nested specifiers to range formatting
- (`#2673 <https://github.com/fmtlib/fmt/pull/2673>`_).
- For example (`godbolt <https://godbolt.org/z/xd3Gj38cf>`__):
- .. code:: c++
- #include <vector>
- #include <fmt/ranges.h>
- int main() {
- fmt::print("{::#x}\n", std::vector{10, 20, 30});
- }
- prints ``[0xa, 0x14, 0x1e]``.
- Thanks `@BRevzin (Barry Revzin) <https://github.com/BRevzin>`_.
- * Implemented escaping of wide strings in ranges
- (`#2904 <https://github.com/fmtlib/fmt/pull/2904>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Added support for ranges with ``begin`` / ``end`` found via the
- argument-dependent lookup
- (`#2807 <https://github.com/fmtlib/fmt/pull/2807>`_).
- Thanks `@rbrugo (Riccardo Brugo) <https://github.com/rbrugo>`_.
- * Fixed formatting of certain kinds of ranges of ranges
- (`#2787 <https://github.com/fmtlib/fmt/pull/2787>`_).
- Thanks `@BRevzin (Barry Revzin) <https://github.com/BRevzin>`_.
- * Fixed handling of maps with element types other than ``std::pair``
- (`#2944 <https://github.com/fmtlib/fmt/pull/2944>`_).
- Thanks `@BrukerJWD (Jonathan W) <https://github.com/BrukerJWD>`_.
- * Made tuple formatter enabled only if elements are formattable
- (`#2939 <https://github.com/fmtlib/fmt/issues/2939>`_,
- `#2940 <https://github.com/fmtlib/fmt/pull/2940>`_).
- Thanks `@jehelset <https://github.com/jehelset>`_.
- * Made ``fmt::join`` compatible with format string compilation
- (`#2719 <https://github.com/fmtlib/fmt/issues/2719>`_,
- `#2720 <https://github.com/fmtlib/fmt/pull/2720>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Made compile-time checks work with named arguments of custom types and
- ``std::ostream`` ``print`` overloads
- (`#2816 <https://github.com/fmtlib/fmt/issues/2816>`_,
- `#2817 <https://github.com/fmtlib/fmt/issues/2817>`_,
- `#2819 <https://github.com/fmtlib/fmt/pull/2819>`_).
- Thanks `@timsong-cpp <https://github.com/timsong-cpp>`_.
- * Removed ``make_args_checked`` because it is no longer needed for compile-time
- checks (`#2760 <https://github.com/fmtlib/fmt/pull/2760>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Removed the following deprecated APIs: ``_format``, ``arg_join``,
- the ``format_to`` overload that takes a memory buffer,
- ``[v]fprintf`` that takes an ``ostream``.
- * Removed the deprecated implicit conversion of ``[const] signed char*`` and
- ``[const] unsigned char*`` to C strings.
- * Removed the deprecated ``fmt/locale.h``.
- * Replaced the deprecated ``fileno()`` with ``descriptor()`` in
- ``buffered_file``.
- * Moved ``to_string_view`` to the ``detail`` namespace since it's an
- implementation detail.
- * Made access mode of a created file consistent with ``fopen`` by setting
- ``S_IWGRP`` and ``S_IWOTH``
- (`#2733 <https://github.com/fmtlib/fmt/pull/2733>`_).
- Thanks `@arogge (Andreas Rogge) <https://github.com/arogge>`_.
- * Removed a redundant buffer resize when formatting to ``std::ostream``
- (`#2842 <https://github.com/fmtlib/fmt/issues/2842>`_,
- `#2843 <https://github.com/fmtlib/fmt/pull/2843>`_).
- Thanks `@jcelerier (Jean-Michaël Celerier) <https://github.com/jcelerier>`_.
- * Made precision computation for strings consistent with width
- (`#2888 <https://github.com/fmtlib/fmt/issues/2888>`_).
- * Fixed handling of locale separators in floating point formatting
- (`#2830 <https://github.com/fmtlib/fmt/issues/2830>`_).
- * Made sign specifiers work with ``__int128_t``
- (`#2773 <https://github.com/fmtlib/fmt/issues/2773>`_).
- * Improved support for systems such as CHERI with extra data stored in pointers
- (`#2932 <https://github.com/fmtlib/fmt/pull/2932>`_).
- Thanks `@davidchisnall (David Chisnall) <https://github.com/davidchisnall>`_.
- * Improved documentation
- (`#2706 <https://github.com/fmtlib/fmt/pull/2706>`_,
- `#2712 <https://github.com/fmtlib/fmt/pull/2712>`_,
- `#2789 <https://github.com/fmtlib/fmt/pull/2789>`_,
- `#2803 <https://github.com/fmtlib/fmt/pull/2803>`_,
- `#2805 <https://github.com/fmtlib/fmt/pull/2805>`_,
- `#2815 <https://github.com/fmtlib/fmt/pull/2815>`_,
- `#2924 <https://github.com/fmtlib/fmt/pull/2924>`_).
- Thanks `@BRevzin (Barry Revzin) <https://github.com/BRevzin>`_,
- `@Pokechu22 <https://github.com/Pokechu22>`_,
- `@setoye (Alta) <https://github.com/setoye>`_,
- `@rtobar <https://github.com/rtobar>`_,
- `@rbrugo (Riccardo Brugo) <https://github.com/rbrugo>`_,
- `@anoonD (cre) <https://github.com/anoonD>`_,
- `@leha-bot (Alex) <https://github.com/leha-bot>`_.
- * Improved build configuration
- (`#2766 <https://github.com/fmtlib/fmt/pull/2766>`_,
- `#2772 <https://github.com/fmtlib/fmt/pull/2772>`_,
- `#2836 <https://github.com/fmtlib/fmt/pull/2836>`_,
- `#2852 <https://github.com/fmtlib/fmt/pull/2852>`_,
- `#2907 <https://github.com/fmtlib/fmt/pull/2907>`_,
- `#2913 <https://github.com/fmtlib/fmt/pull/2913>`_,
- `#2914 <https://github.com/fmtlib/fmt/pull/2914>`_).
- Thanks `@kambala-decapitator (Andrey Filipenkov)
- <https://github.com/kambala-decapitator>`_,
- `@mattiasljungstrom (Mattias Ljungström)
- <https://github.com/mattiasljungstrom>`_,
- `@kieselnb (Nick Kiesel) <https://github.com/kieselnb>`_,
- `@nathannaveen <https://github.com/nathannaveen>`_,
- `@Vertexwahn <https://github.com/Vertexwahn>`_.
- * Fixed various warnings and compilation issues
- (`#2408 <https://github.com/fmtlib/fmt/issues/2408>`_,
- `#2507 <https://github.com/fmtlib/fmt/issues/2507>`_,
- `#2697 <https://github.com/fmtlib/fmt/issues/2697>`_,
- `#2715 <https://github.com/fmtlib/fmt/issues/2715>`_,
- `#2717 <https://github.com/fmtlib/fmt/issues/2717>`_,
- `#2722 <https://github.com/fmtlib/fmt/pull/2722>`_,
- `#2724 <https://github.com/fmtlib/fmt/pull/2724>`_,
- `#2725 <https://github.com/fmtlib/fmt/pull/2725>`_,
- `#2726 <https://github.com/fmtlib/fmt/issues/2726>`_,
- `#2728 <https://github.com/fmtlib/fmt/pull/2728>`_,
- `#2732 <https://github.com/fmtlib/fmt/pull/2732>`_,
- `#2738 <https://github.com/fmtlib/fmt/issues/2738>`_,
- `#2742 <https://github.com/fmtlib/fmt/pull/2742>`_,
- `#2744 <https://github.com/fmtlib/fmt/issues/2744>`_,
- `#2745 <https://github.com/fmtlib/fmt/issues/2745>`_,
- `#2746 <https://github.com/fmtlib/fmt/issues/2746>`_,
- `#2754 <https://github.com/fmtlib/fmt/issues/2754>`_,
- `#2755 <https://github.com/fmtlib/fmt/pull/2755>`_,
- `#2757 <https://github.com/fmtlib/fmt/issues/2757>`_,
- `#2758 <https://github.com/fmtlib/fmt/pull/2758>`_,
- `#2761 <https://github.com/fmtlib/fmt/issues/2761>`_,
- `#2762 <https://github.com/fmtlib/fmt/pull/2762>`_,
- `#2763 <https://github.com/fmtlib/fmt/issues/2763>`_,
- `#2765 <https://github.com/fmtlib/fmt/pull/2765>`_,
- `#2769 <https://github.com/fmtlib/fmt/issues/2769>`_,
- `#2770 <https://github.com/fmtlib/fmt/pull/2770>`_,
- `#2771 <https://github.com/fmtlib/fmt/issues/2771>`_,
- `#2777 <https://github.com/fmtlib/fmt/issues/2777>`_,
- `#2779 <https://github.com/fmtlib/fmt/pull/2779>`_,
- `#2782 <https://github.com/fmtlib/fmt/pull/2782>`_,
- `#2783 <https://github.com/fmtlib/fmt/pull/2783>`_,
- `#2794 <https://github.com/fmtlib/fmt/issues/2794>`_,
- `#2796 <https://github.com/fmtlib/fmt/issues/2796>`_,
- `#2797 <https://github.com/fmtlib/fmt/pull/2797>`_,
- `#2801 <https://github.com/fmtlib/fmt/pull/2801>`_,
- `#2802 <https://github.com/fmtlib/fmt/pull/2802>`_,
- `#2808 <https://github.com/fmtlib/fmt/issues/2808>`_,
- `#2818 <https://github.com/fmtlib/fmt/issues/2818>`_,
- `#2819 <https://github.com/fmtlib/fmt/pull/2819>`_,
- `#2829 <https://github.com/fmtlib/fmt/issues/2829>`_,
- `#2835 <https://github.com/fmtlib/fmt/issues/2835>`_,
- `#2848 <https://github.com/fmtlib/fmt/issues/2848>`_,
- `#2860 <https://github.com/fmtlib/fmt/issues/2860>`_,
- `#2861 <https://github.com/fmtlib/fmt/pull/2861>`_,
- `#2882 <https://github.com/fmtlib/fmt/pull/2882>`_,
- `#2886 <https://github.com/fmtlib/fmt/issues/2886>`_,
- `#2891 <https://github.com/fmtlib/fmt/issues/2891>`_,
- `#2892 <https://github.com/fmtlib/fmt/pull/2892>`_,
- `#2895 <https://github.com/fmtlib/fmt/issues/2895>`_,
- `#2896 <https://github.com/fmtlib/fmt/issues/2896>`_,
- `#2903 <https://github.com/fmtlib/fmt/pull/2903>`_,
- `#2906 <https://github.com/fmtlib/fmt/issues/2906>`_,
- `#2908 <https://github.com/fmtlib/fmt/issues/2908>`_,
- `#2909 <https://github.com/fmtlib/fmt/pull/2909>`_,
- `#2920 <https://github.com/fmtlib/fmt/issues/2920>`_,
- `#2922 <https://github.com/fmtlib/fmt/pull/2922>`_,
- `#2927 <https://github.com/fmtlib/fmt/pull/2927>`_,
- `#2929 <https://github.com/fmtlib/fmt/pull/2929>`_,
- `#2936 <https://github.com/fmtlib/fmt/issues/2936>`_,
- `#2937 <https://github.com/fmtlib/fmt/pull/2937>`_,
- `#2938 <https://github.com/fmtlib/fmt/pull/2938>`_,
- `#2951 <https://github.com/fmtlib/fmt/pull/2951>`_,
- `#2954 <https://github.com/fmtlib/fmt/issues/2954>`_,
- `#2957 <https://github.com/fmtlib/fmt/pull/2957>`_,
- `#2958 <https://github.com/fmtlib/fmt/issues/2958>`_,
- `#2960 <https://github.com/fmtlib/fmt/pull/2960>`_).
- Thanks `@matrackif <https://github.com/matrackif>`_
- `@Tobi823 (Tobias Hellmann) <https://github.com/Tobi823>`_,
- `@ivan-volnov (Ivan Volnov) <https://github.com/ivan-volnov>`_,
- `@VasiliPupkin256 <https://github.com/VasiliPupkin256>`_,
- `@federico-busato (Federico) <https://github.com/federico-busato>`_,
- `@barcharcraz (Charlie Barto) <https://github.com/barcharcraz>`_,
- `@jk-jeon (Junekey Jeon) <https://github.com/jk-jeon>`_,
- `@HazardyKnusperkeks (Björn Schäpers)
- <https://github.com/HazardyKnusperkeks>`_,
- `@dalboris (Boris Dalstein) <https://github.com/dalboris>`_,
- `@seanm (Sean McBride) <https://github.com/seanm>`_,
- `@gsjaardema (Greg Sjaardema) <https://github.com/gsjaardema>`_,
- `@timsong-cpp <https://github.com/timsong-cpp>`_,
- `@seanm (Sean McBride) <https://github.com/seanm>`_,
- `@frithrah <https://github.com/frithrah>`_,
- `@chronoxor (Ivan Shynkarenka) <https://github.com/chronoxor>`_,
- `@Agga <https://github.com/Agga>`_,
- `@madmaxoft (Mattes D) <https://github.com/madmaxoft>`_,
- `@JurajX (Juraj) <https://github.com/JurajX>`_,
- `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_,
- `@Dani-Hub (Daniel Krügler) <https://github.com/Dani-Hub>`_.
- 8.1.1 - 2022-01-06
- ------------------
- * Restored ABI compatibility with version 8.0.x
- (`#2695 <https://github.com/fmtlib/fmt/issues/2695>`_,
- `#2696 <https://github.com/fmtlib/fmt/pull/2696>`_).
- Thanks `@saraedum (Julian Rüth) <https://github.com/saraedum>`_.
- * Fixed chrono formatting on big endian systems
- (`#2698 <https://github.com/fmtlib/fmt/issues/2698>`_,
- `#2699 <https://github.com/fmtlib/fmt/pull/2699>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_ and
- `@xvitaly (Vitaly Zaitsev) <https://github.com/xvitaly>`_.
- * Fixed a linkage error with mingw
- (`#2691 <https://github.com/fmtlib/fmt/issues/2691>`_,
- `#2692 <https://github.com/fmtlib/fmt/pull/2692>`_).
- Thanks `@rbberger (Richard Berger) <https://github.com/rbberger>`_.
- 8.1.0 - 2022-01-02
- ------------------
- * Optimized chrono formatting
- (`#2500 <https://github.com/fmtlib/fmt/pull/2500>`_,
- `#2537 <https://github.com/fmtlib/fmt/pull/2537>`_,
- `#2541 <https://github.com/fmtlib/fmt/issues/2541>`_,
- `#2544 <https://github.com/fmtlib/fmt/pull/2544>`_,
- `#2550 <https://github.com/fmtlib/fmt/pull/2550>`_,
- `#2551 <https://github.com/fmtlib/fmt/pull/2551>`_,
- `#2576 <https://github.com/fmtlib/fmt/pull/2576>`_,
- `#2577 <https://github.com/fmtlib/fmt/issues/2577>`_,
- `#2586 <https://github.com/fmtlib/fmt/pull/2586>`_,
- `#2591 <https://github.com/fmtlib/fmt/pull/2591>`_,
- `#2594 <https://github.com/fmtlib/fmt/pull/2594>`_,
- `#2602 <https://github.com/fmtlib/fmt/pull/2602>`_,
- `#2617 <https://github.com/fmtlib/fmt/pull/2617>`_,
- `#2628 <https://github.com/fmtlib/fmt/issues/2628>`_,
- `#2633 <https://github.com/fmtlib/fmt/pull/2633>`_,
- `#2670 <https://github.com/fmtlib/fmt/issues/2670>`_,
- `#2671 <https://github.com/fmtlib/fmt/pull/2671>`_).
- Processing of some specifiers such as ``%z`` and ``%Y`` is now up to 10-20
- times faster, for example on GCC 11 with libstdc++::
- ----------------------------------------------------------------------------
- Benchmark Before After
- ----------------------------------------------------------------------------
- FMTFormatter_z 261 ns 26.3 ns
- FMTFormatterCompile_z 246 ns 11.6 ns
- FMTFormatter_Y 263 ns 26.1 ns
- FMTFormatterCompile_Y 244 ns 10.5 ns
- ----------------------------------------------------------------------------
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_ and
- `@toughengineer (Pavel Novikov) <https://github.com/toughengineer>`_.
- * Implemented subsecond formatting for chrono durations
- (`#2623 <https://github.com/fmtlib/fmt/pull/2623>`_).
- For example (`godbolt <https://godbolt.org/z/es7vWTETe>`__):
- .. code:: c++
- #include <fmt/chrono.h>
- int main() {
- fmt::print("{:%S}", std::chrono::milliseconds(1234));
- }
- prints "01.234".
- Thanks `@matrackif <https://github.com/matrackif>`_.
- * Fixed handling of precision 0 when formatting chrono durations
- (`#2587 <https://github.com/fmtlib/fmt/issues/2587>`_,
- `#2588 <https://github.com/fmtlib/fmt/pull/2588>`_).
- Thanks `@lukester1975 <https://github.com/lukester1975>`_.
- * Fixed an overflow on invalid inputs in the ``tm`` formatter
- (`#2564 <https://github.com/fmtlib/fmt/pull/2564>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Added ``fmt::group_digits`` that formats integers with a non-localized digit
- separator (comma) for groups of three digits.
- For example (`godbolt <https://godbolt.org/z/TxGxG9Poq>`__):
- .. code:: c++
- #include <fmt/format.h>
- int main() {
- fmt::print("{} dollars", fmt::group_digits(1000000));
- }
- prints "1,000,000 dollars".
- * Added support for faint, conceal, reverse and blink text styles
- (`#2394 <https://github.com/fmtlib/fmt/pull/2394>`_):
- https://user-images.githubusercontent.com/576385/147710227-c68f5317-f8fa-42c3-9123-7c4ba3c398cb.mp4
- Thanks `@benit8 (Benoît Lormeau) <https://github.com/benit8>`_ and
- `@data-man (Dmitry Atamanov) <https://github.com/data-man>`_.
- * Added experimental support for compile-time floating point formatting
- (`#2426 <https://github.com/fmtlib/fmt/pull/2426>`_,
- `#2470 <https://github.com/fmtlib/fmt/pull/2470>`_).
- It is currently limited to the header-only mode.
- Thanks `@alexezeder (Alexey Ochapov) <https://github.com/alexezeder>`_.
- * Added UDL-based named argument support to compile-time format string checks
- (`#2640 <https://github.com/fmtlib/fmt/issues/2640>`_,
- `#2649 <https://github.com/fmtlib/fmt/pull/2649>`_).
- For example (`godbolt <https://godbolt.org/z/ohGbbvonv>`__):
- .. code:: c++
- #include <fmt/format.h>
- int main() {
- using namespace fmt::literals;
- fmt::print("{answer:s}", "answer"_a=42);
- }
- gives a compile-time error on compilers with C++20 ``consteval`` and non-type
- template parameter support (gcc 10+) because ``s`` is not a valid format
- specifier for an integer.
- Thanks `@alexezeder (Alexey Ochapov) <https://github.com/alexezeder>`_.
- * Implemented escaping of string range elements.
- For example (`godbolt <https://godbolt.org/z/rKvM1vKf3>`__):
- .. code:: c++
- #include <fmt/ranges.h>
- #include <vector>
- int main() {
- fmt::print("{}", std::vector<std::string>{"\naan"});
- }
- is now printed as::
- ["\naan"]
- instead of::
-
- ["
- aan"]
- * Added an experimental ``?`` specifier for escaping strings.
- (`#2674 <https://github.com/fmtlib/fmt/pull/2674>`_).
- Thanks `@BRevzin (Barry Revzin) <https://github.com/BRevzin>`_.
- * Switched to JSON-like representation of maps and sets for consistency with
- Python's ``str.format``.
- For example (`godbolt <https://godbolt.org/z/seKjoY9W5>`__):
- .. code:: c++
- #include <fmt/ranges.h>
- #include <map>
- int main() {
- fmt::print("{}", std::map<std::string, int>{{"answer", 42}});
- }
- is now printed as::
- {"answer": 42}
- * Extended ``fmt::join`` to support C++20-only ranges
- (`#2549 <https://github.com/fmtlib/fmt/pull/2549>`_).
- Thanks `@BRevzin (Barry Revzin) <https://github.com/BRevzin>`_.
- * Optimized handling of non-const-iterable ranges and implemented initial
- support for non-const-formattable types.
- * Disabled implicit conversions of scoped enums to integers that was
- accidentally introduced in earlier versions
- (`#1841 <https://github.com/fmtlib/fmt/pull/1841>`_).
- * Deprecated implicit conversion of ``[const] signed char*`` and
- ``[const] unsigned char*`` to C strings.
- * Deprecated ``_format``, a legacy UDL-based format API
- (`#2646 <https://github.com/fmtlib/fmt/pull/2646>`_).
- Thanks `@alexezeder (Alexey Ochapov) <https://github.com/alexezeder>`_.
- * Marked ``format``, ``formatted_size`` and ``to_string`` as ``[[nodiscard]]``
- (`#2612 <https://github.com/fmtlib/fmt/pull/2612>`_).
- `@0x8000-0000 (Florin Iucha) <https://github.com/0x8000-0000>`_.
- * Added missing diagnostic when trying to format function and member pointers
- as well as objects convertible to pointers which is explicitly disallowed
- (`#2598 <https://github.com/fmtlib/fmt/issues/2598>`_,
- `#2609 <https://github.com/fmtlib/fmt/pull/2609>`_,
- `#2610 <https://github.com/fmtlib/fmt/pull/2610>`_).
- Thanks `@AlexGuteniev (Alex Guteniev) <https://github.com/AlexGuteniev>`_.
- * Optimized writing to a contiguous buffer with ``format_to_n``
- (`#2489 <https://github.com/fmtlib/fmt/pull/2489>`_).
- Thanks `@Roman-Koshelev <https://github.com/Roman-Koshelev>`_.
- * Optimized writing to non-``char`` buffers
- (`#2477 <https://github.com/fmtlib/fmt/pull/2477>`_).
- Thanks `@Roman-Koshelev <https://github.com/Roman-Koshelev>`_.
- * Decimal point is now localized when using the ``L`` specifier.
- * Improved floating point formatter implementation
- (`#2498 <https://github.com/fmtlib/fmt/pull/2498>`_,
- `#2499 <https://github.com/fmtlib/fmt/pull/2499>`_).
- Thanks `@Roman-Koshelev <https://github.com/Roman-Koshelev>`_.
- * Fixed handling of very large precision in fixed format
- (`#2616 <https://github.com/fmtlib/fmt/pull/2616>`_).
- * Made a table of cached powers used in FP formatting static
- (`#2509 <https://github.com/fmtlib/fmt/pull/2509>`_).
- Thanks `@jk-jeon (Junekey Jeon) <https://github.com/jk-jeon>`_.
- * Resolved a lookup ambiguity with C++20 format-related functions due to ADL
- (`#2639 <https://github.com/fmtlib/fmt/issues/2639>`_,
- `#2641 <https://github.com/fmtlib/fmt/pull/2641>`_).
- Thanks `@mkurdej (Marek Kurdej) <https://github.com/mkurdej>`_.
- * Removed unnecessary inline namespace qualification
- (`#2642 <https://github.com/fmtlib/fmt/issues/2642>`_,
- `#2643 <https://github.com/fmtlib/fmt/pull/2643>`_).
- Thanks `@mkurdej (Marek Kurdej) <https://github.com/mkurdej>`_.
- * Implemented argument forwarding in ``format_to_n``
- (`#2462 <https://github.com/fmtlib/fmt/issues/2462>`_,
- `#2463 <https://github.com/fmtlib/fmt/pull/2463>`_).
- Thanks `@owent (WenTao Ou) <https://github.com/owent>`_.
- * Fixed handling of implicit conversions in ``fmt::to_string`` and format string
- compilation (`#2565 <https://github.com/fmtlib/fmt/issues/2565>`_).
- * Changed the default access mode of files created by ``fmt::output_file`` to
- ``-rw-r--r--`` for consistency with ``fopen``
- (`#2530 <https://github.com/fmtlib/fmt/issues/2530>`_).
- * Make ``fmt::ostream::flush`` public
- (`#2435 <https://github.com/fmtlib/fmt/issues/2435>`_).
- * Improved C++14/17 attribute detection
- (`#2615 <https://github.com/fmtlib/fmt/pull/2615>`_).
- Thanks `@AlexGuteniev (Alex Guteniev) <https://github.com/AlexGuteniev>`_.
- * Improved ``consteval`` detection for MSVC
- (`#2559 <https://github.com/fmtlib/fmt/pull/2559>`_).
- Thanks `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_.
- * Improved documentation
- (`#2406 <https://github.com/fmtlib/fmt/issues/2406>`_,
- `#2446 <https://github.com/fmtlib/fmt/pull/2446>`_,
- `#2493 <https://github.com/fmtlib/fmt/issues/2493>`_,
- `#2513 <https://github.com/fmtlib/fmt/issues/2513>`_,
- `#2515 <https://github.com/fmtlib/fmt/pull/2515>`_,
- `#2522 <https://github.com/fmtlib/fmt/issues/2522>`_,
- `#2562 <https://github.com/fmtlib/fmt/pull/2562>`_,
- `#2575 <https://github.com/fmtlib/fmt/pull/2575>`_,
- `#2606 <https://github.com/fmtlib/fmt/pull/2606>`_,
- `#2620 <https://github.com/fmtlib/fmt/pull/2620>`_,
- `#2676 <https://github.com/fmtlib/fmt/issues/2676>`_).
- Thanks `@sobolevn (Nikita Sobolev) <https://github.com/sobolevn>`_,
- `@UnePierre (Max FERGER) <https://github.com/UnePierre>`_,
- `@zhsj <https://github.com/zhsj>`_,
- `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_,
- `@ericcurtin (Eric Curtin) <https://github.com/ericcurtin>`_,
- `@Lounarok <https://github.com/Lounarok>`_.
- * Improved fuzzers and added a fuzzer for chrono timepoint formatting
- (`#2461 <https://github.com/fmtlib/fmt/pull/2461>`_,
- `#2469 <https://github.com/fmtlib/fmt/pull/2469>`_).
- `@pauldreik (Paul Dreik) <https://github.com/pauldreik>`_,
- * Added the ``FMT_SYSTEM_HEADERS`` CMake option setting which marks {fmt}'s
- headers as system. It can be used to suppress warnings
- (`#2644 <https://github.com/fmtlib/fmt/issues/2644>`_,
- `#2651 <https://github.com/fmtlib/fmt/pull/2651>`_).
- Thanks `@alexezeder (Alexey Ochapov) <https://github.com/alexezeder>`_.
- * Added the Bazel build system support
- (`#2505 <https://github.com/fmtlib/fmt/pull/2505>`_,
- `#2516 <https://github.com/fmtlib/fmt/pull/2516>`_).
- Thanks `@Vertexwahn <https://github.com/Vertexwahn>`_.
- * Improved build configuration and tests
- (`#2437 <https://github.com/fmtlib/fmt/issues/2437>`_,
- `#2558 <https://github.com/fmtlib/fmt/pull/2558>`_,
- `#2648 <https://github.com/fmtlib/fmt/pull/2648>`_,
- `#2650 <https://github.com/fmtlib/fmt/pull/2650>`_,
- `#2663 <https://github.com/fmtlib/fmt/pull/2663>`_,
- `#2677 <https://github.com/fmtlib/fmt/pull/2677>`_).
- Thanks `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_,
- `@alexezeder (Alexey Ochapov) <https://github.com/alexezeder>`_,
- `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Fixed various warnings and compilation issues
- (`#2353 <https://github.com/fmtlib/fmt/pull/2353>`_,
- `#2356 <https://github.com/fmtlib/fmt/pull/2356>`_,
- `#2399 <https://github.com/fmtlib/fmt/pull/2399>`_,
- `#2408 <https://github.com/fmtlib/fmt/issues/2408>`_,
- `#2414 <https://github.com/fmtlib/fmt/pull/2414>`_,
- `#2427 <https://github.com/fmtlib/fmt/pull/2427>`_,
- `#2432 <https://github.com/fmtlib/fmt/pull/2432>`_,
- `#2442 <https://github.com/fmtlib/fmt/pull/2442>`_,
- `#2434 <https://github.com/fmtlib/fmt/pull/2434>`_,
- `#2439 <https://github.com/fmtlib/fmt/issues/2439>`_,
- `#2447 <https://github.com/fmtlib/fmt/pull/2447>`_,
- `#2450 <https://github.com/fmtlib/fmt/pull/2450>`_,
- `#2455 <https://github.com/fmtlib/fmt/issues/2455>`_,
- `#2465 <https://github.com/fmtlib/fmt/issues/2465>`_,
- `#2472 <https://github.com/fmtlib/fmt/issues/2472>`_,
- `#2474 <https://github.com/fmtlib/fmt/issues/2474>`_,
- `#2476 <https://github.com/fmtlib/fmt/pull/2476>`_,
- `#2478 <https://github.com/fmtlib/fmt/issues/2478>`_,
- `#2479 <https://github.com/fmtlib/fmt/issues/2479>`_,
- `#2481 <https://github.com/fmtlib/fmt/issues/2481>`_,
- `#2482 <https://github.com/fmtlib/fmt/pull/2482>`_,
- `#2483 <https://github.com/fmtlib/fmt/pull/2483>`_,
- `#2490 <https://github.com/fmtlib/fmt/issues/2490>`_,
- `#2491 <https://github.com/fmtlib/fmt/pull/2491>`_,
- `#2510 <https://github.com/fmtlib/fmt/pull/2510>`_,
- `#2518 <https://github.com/fmtlib/fmt/pull/2518>`_,
- `#2528 <https://github.com/fmtlib/fmt/issues/2528>`_,
- `#2529 <https://github.com/fmtlib/fmt/pull/2529>`_,
- `#2539 <https://github.com/fmtlib/fmt/pull/2539>`_,
- `#2540 <https://github.com/fmtlib/fmt/issues/2540>`_,
- `#2545 <https://github.com/fmtlib/fmt/pull/2545>`_,
- `#2555 <https://github.com/fmtlib/fmt/pull/2555>`_,
- `#2557 <https://github.com/fmtlib/fmt/issues/2557>`_,
- `#2570 <https://github.com/fmtlib/fmt/issues/2570>`_,
- `#2573 <https://github.com/fmtlib/fmt/pull/2573>`_,
- `#2582 <https://github.com/fmtlib/fmt/pull/2582>`_,
- `#2605 <https://github.com/fmtlib/fmt/issues/2605>`_,
- `#2611 <https://github.com/fmtlib/fmt/pull/2611>`_,
- `#2647 <https://github.com/fmtlib/fmt/pull/2647>`_,
- `#2627 <https://github.com/fmtlib/fmt/issues/2627>`_,
- `#2630 <https://github.com/fmtlib/fmt/pull/2630>`_,
- `#2635 <https://github.com/fmtlib/fmt/issues/2635>`_,
- `#2638 <https://github.com/fmtlib/fmt/issues/2638>`_,
- `#2653 <https://github.com/fmtlib/fmt/issues/2653>`_,
- `#2654 <https://github.com/fmtlib/fmt/issues/2654>`_,
- `#2661 <https://github.com/fmtlib/fmt/issues/2661>`_,
- `#2664 <https://github.com/fmtlib/fmt/pull/2664>`_,
- `#2684 <https://github.com/fmtlib/fmt/pull/2684>`_).
- Thanks `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_,
- `@mwinterb <https://github.com/mwinterb>`_,
- `@cdacamar (Cameron DaCamara) <https://github.com/cdacamar>`_,
- `@TrebledJ (Johnathan) <https://github.com/TrebledJ>`_,
- `@bodomartin (brm) <https://github.com/bodomartin>`_,
- `@cquammen (Cory Quammen) <https://github.com/cquammen>`_,
- `@white238 (Chris White) <https://github.com/white238>`_,
- `@mmarkeloff (Max) <https://github.com/mmarkeloff>`_,
- `@palacaze (Pierre-Antoine Lacaze) <https://github.com/palacaze>`_,
- `@jcelerier (Jean-Michaël Celerier) <https://github.com/jcelerier>`_,
- `@mborn-adi (Mathias Born) <https://github.com/mborn-adi>`_,
- `@BrukerJWD (Jonathan W) <https://github.com/BrukerJWD>`_,
- `@spyridon97 (Spiros Tsalikis) <https://github.com/spyridon97>`_,
- `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_,
- `@oliverlee (Oliver Lee) <https://github.com/oliverlee>`_,
- `@joshessman-llnl (Josh Essman) <https://github.com/joshessman-llnl>`_,
- `@akohlmey (Axel Kohlmeyer) <https://github.com/akohlmey>`_,
- `@timkalu <https://github.com/timkalu>`_,
- `@olupton (Olli Lupton) <https://github.com/olupton>`_,
- `@Acretock <https://github.com/Acretock>`_,
- `@alexezeder (Alexey Ochapov) <https://github.com/alexezeder>`_,
- `@andrewcorrigan (Andrew Corrigan) <https://github.com/andrewcorrigan>`_,
- `@lucpelletier <https://github.com/lucpelletier>`_,
- `@HazardyKnusperkeks (Björn Schäpers)
- <https://github.com/HazardyKnusperkeks>`_.
- 8.0.1 - 2021-07-02
- ------------------
- * Fixed the version number in the inline namespace
- (`#2374 <https://github.com/fmtlib/fmt/issues/2374>`_).
- * Added a missing presentation type check for ``std::string``
- (`#2402 <https://github.com/fmtlib/fmt/issues/2402>`_).
- * Fixed a linkage error when mixing code built with clang and gcc
- (`#2377 <https://github.com/fmtlib/fmt/issues/2377>`_).
- * Fixed documentation issues
- (`#2396 <https://github.com/fmtlib/fmt/pull/2396>`_,
- `#2403 <https://github.com/fmtlib/fmt/issues/2403>`_,
- `#2406 <https://github.com/fmtlib/fmt/issues/2406>`_).
- Thanks `@mkurdej (Marek Kurdej) <https://github.com/mkurdej>`_.
- * Removed dead code in FP formatter (
- `#2398 <https://github.com/fmtlib/fmt/pull/2398>`_).
- Thanks `@javierhonduco (Javier Honduvilla Coto)
- <https://github.com/javierhonduco>`_.
- * Fixed various warnings and compilation issues
- (`#2351 <https://github.com/fmtlib/fmt/issues/2351>`_,
- `#2359 <https://github.com/fmtlib/fmt/issues/2359>`_,
- `#2365 <https://github.com/fmtlib/fmt/pull/2365>`_,
- `#2368 <https://github.com/fmtlib/fmt/issues/2368>`_,
- `#2370 <https://github.com/fmtlib/fmt/pull/2370>`_,
- `#2376 <https://github.com/fmtlib/fmt/pull/2376>`_,
- `#2381 <https://github.com/fmtlib/fmt/pull/2381>`_,
- `#2382 <https://github.com/fmtlib/fmt/pull/2382>`_,
- `#2386 <https://github.com/fmtlib/fmt/issues/2386>`_,
- `#2389 <https://github.com/fmtlib/fmt/pull/2389>`_,
- `#2395 <https://github.com/fmtlib/fmt/pull/2395>`_,
- `#2397 <https://github.com/fmtlib/fmt/pull/2397>`_,
- `#2400 <https://github.com/fmtlib/fmt/issues/2400>`_,
- `#2401 <https://github.com/fmtlib/fmt/issues/2401>`_,
- `#2407 <https://github.com/fmtlib/fmt/pull/2407>`_).
- Thanks `@zx2c4 (Jason A. Donenfeld) <https://github.com/zx2c4>`_,
- `@AidanSun05 (Aidan Sun) <https://github.com/AidanSun05>`_,
- `@mattiasljungstrom (Mattias Ljungström)
- <https://github.com/mattiasljungstrom>`_,
- `@joemmett (Jonathan Emmett) <https://github.com/joemmett>`_,
- `@erengy (Eren Okka) <https://github.com/erengy>`_,
- `@patlkli (Patrick Geltinger) <https://github.com/patlkli>`_,
- `@gsjaardema (Greg Sjaardema) <https://github.com/gsjaardema>`_,
- `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- 8.0.0 - 2021-06-21
- ------------------
- * Enabled compile-time format string checks by default.
- For example (`godbolt <https://godbolt.org/z/sMxcohGjz>`__):
- .. code:: c++
- #include <fmt/core.h>
- int main() {
- fmt::print("{:d}", "I am not a number");
- }
- gives a compile-time error on compilers with C++20 ``consteval`` support
- (gcc 10+, clang 11+) because ``d`` is not a valid format specifier for a
- string.
- To pass a runtime string wrap it in ``fmt::runtime``:
- .. code:: c++
- fmt::print(fmt::runtime("{:d}"), "I am not a number");
- * Added compile-time formatting
- (`#2019 <https://github.com/fmtlib/fmt/pull/2019>`_,
- `#2044 <https://github.com/fmtlib/fmt/pull/2044>`_,
- `#2056 <https://github.com/fmtlib/fmt/pull/2056>`_,
- `#2072 <https://github.com/fmtlib/fmt/pull/2072>`_,
- `#2075 <https://github.com/fmtlib/fmt/pull/2075>`_,
- `#2078 <https://github.com/fmtlib/fmt/issues/2078>`_,
- `#2129 <https://github.com/fmtlib/fmt/pull/2129>`_,
- `#2326 <https://github.com/fmtlib/fmt/pull/2326>`_).
- For example (`godbolt <https://godbolt.org/z/Mxx9d89jM>`__):
- .. code:: c++
- #include <fmt/compile.h>
- consteval auto compile_time_itoa(int value) -> std::array<char, 10> {
- auto result = std::array<char, 10>();
- fmt::format_to(result.data(), FMT_COMPILE("{}"), value);
- return result;
- }
- constexpr auto answer = compile_time_itoa(42);
- Most of the formatting functionality is available at compile time with a
- notable exception of floating-point numbers and pointers.
- Thanks `@alexezeder (Alexey Ochapov) <https://github.com/alexezeder>`_.
- * Optimized handling of format specifiers during format string compilation.
- For example, hexadecimal formatting (``"{:x}"``) is now 3-7x faster than
- before when using ``format_to`` with format string compilation and a
- stack-allocated buffer (`#1944 <https://github.com/fmtlib/fmt/issues/1944>`_).
- Before (7.1.3)::
- ----------------------------------------------------------------------------
- Benchmark Time CPU Iterations
- ----------------------------------------------------------------------------
- FMTCompileOld/0 15.5 ns 15.5 ns 43302898
- FMTCompileOld/42 16.6 ns 16.6 ns 43278267
- FMTCompileOld/273123 18.7 ns 18.6 ns 37035861
- FMTCompileOld/9223372036854775807 19.4 ns 19.4 ns 35243000
- ----------------------------------------------------------------------------
- After (8.x)::
- ----------------------------------------------------------------------------
- Benchmark Time CPU Iterations
- ----------------------------------------------------------------------------
- FMTCompileNew/0 1.99 ns 1.99 ns 360523686
- FMTCompileNew/42 2.33 ns 2.33 ns 279865664
- FMTCompileNew/273123 3.72 ns 3.71 ns 190230315
- FMTCompileNew/9223372036854775807 5.28 ns 5.26 ns 130711631
- ----------------------------------------------------------------------------
- It is even faster than ``std::to_chars`` from libc++ compiled with clang on
- macOS::
- ----------------------------------------------------------------------------
- Benchmark Time CPU Iterations
- ----------------------------------------------------------------------------
- ToChars/0 4.42 ns 4.41 ns 160196630
- ToChars/42 5.00 ns 4.98 ns 140735201
- ToChars/273123 7.26 ns 7.24 ns 95784130
- ToChars/9223372036854775807 8.77 ns 8.75 ns 75872534
- ----------------------------------------------------------------------------
- In other cases, especially involving ``std::string`` construction, the
- speed up is usually lower because handling format specifiers takes a smaller
- fraction of the total time.
- * Added the ``_cf`` user-defined literal to represent a compiled format string.
- It can be used instead of the ``FMT_COMPILE`` macro
- (`#2043 <https://github.com/fmtlib/fmt/pull/2043>`_,
- `#2242 <https://github.com/fmtlib/fmt/pull/2242>`_):
- .. code:: c++
- #include <fmt/compile.h>
- using namespace fmt::literals;
- auto s = fmt::format(FMT_COMPILE("{}"), 42); // 🙁 not modern
- auto s = fmt::format("{}"_cf, 42); // 🙂 modern as hell
- It requires compiler support for class types in non-type template parameters
- (a C++20 feature) which is available in GCC 9.3+.
- Thanks `@alexezeder (Alexey Ochapov) <https://github.com/alexezeder>`_.
- * Format string compilation now requires ``format`` functions of ``formatter``
- specializations for user-defined types to be ``const``:
- .. code:: c++
- template <> struct fmt::formatter<my_type>: formatter<string_view> {
- template <typename FormatContext>
- auto format(my_type obj, FormatContext& ctx) const { // Note const here.
- // ...
- }
- };
- * Added UDL-based named argument support to format string compilation
- (`#2243 <https://github.com/fmtlib/fmt/pull/2243>`_,
- `#2281 <https://github.com/fmtlib/fmt/pull/2281>`_). For example:
- .. code:: c++
- #include <fmt/compile.h>
- using namespace fmt::literals;
- auto s = fmt::format(FMT_COMPILE("{answer}"), "answer"_a = 42);
- Here the argument named "answer" is resolved at compile time with no
- runtime overhead.
- Thanks `@alexezeder (Alexey Ochapov) <https://github.com/alexezeder>`_.
- * Added format string compilation support to ``fmt::print``
- (`#2280 <https://github.com/fmtlib/fmt/issues/2280>`_,
- `#2304 <https://github.com/fmtlib/fmt/pull/2304>`_).
- Thanks `@alexezeder (Alexey Ochapov) <https://github.com/alexezeder>`_.
- * Added initial support for compiling {fmt} as a C++20 module
- (`#2235 <https://github.com/fmtlib/fmt/pull/2235>`_,
- `#2240 <https://github.com/fmtlib/fmt/pull/2240>`_,
- `#2260 <https://github.com/fmtlib/fmt/pull/2260>`_,
- `#2282 <https://github.com/fmtlib/fmt/pull/2282>`_,
- `#2283 <https://github.com/fmtlib/fmt/pull/2283>`_,
- `#2288 <https://github.com/fmtlib/fmt/pull/2288>`_,
- `#2298 <https://github.com/fmtlib/fmt/pull/2298>`_,
- `#2306 <https://github.com/fmtlib/fmt/pull/2306>`_,
- `#2307 <https://github.com/fmtlib/fmt/pull/2307>`_,
- `#2309 <https://github.com/fmtlib/fmt/pull/2309>`_,
- `#2318 <https://github.com/fmtlib/fmt/pull/2318>`_,
- `#2324 <https://github.com/fmtlib/fmt/pull/2324>`_,
- `#2332 <https://github.com/fmtlib/fmt/pull/2332>`_,
- `#2340 <https://github.com/fmtlib/fmt/pull/2340>`_).
- Thanks `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_.
- * Made symbols private by default reducing shared library size
- (`#2301 <https://github.com/fmtlib/fmt/pull/2301>`_). For example there was
- a ~15% reported reduction on one platform.
- Thanks `@sergiud (Sergiu Deitsch) <https://github.com/sergiud>`_.
- * Optimized includes making the result of preprocessing ``fmt/format.h``
- ~20% smaller with libstdc++/C++20 and slightly improving build times
- (`#1998 <https://github.com/fmtlib/fmt/issues/1998>`_).
- * Added support of ranges with non-const ``begin`` / ``end``
- (`#1953 <https://github.com/fmtlib/fmt/pull/1953>`_).
- Thanks `@kitegi (sarah) <https://github.com/kitegi>`_.
- * Added support of ``std::byte`` and other formattable types to ``fmt::join``
- (`#1981 <https://github.com/fmtlib/fmt/issues/1981>`_,
- `#2040 <https://github.com/fmtlib/fmt/issues/2040>`_,
- `#2050 <https://github.com/fmtlib/fmt/pull/2050>`_,
- `#2262 <https://github.com/fmtlib/fmt/issues/2262>`_). For example:
- .. code:: c++
- #include <fmt/format.h>
- #include <cstddef>
- #include <vector>
- int main() {
- auto bytes = std::vector{std::byte(4), std::byte(2)};
- fmt::print("{}", fmt::join(bytes, ""));
- }
- prints "42".
- Thanks `@kamibo (Camille Bordignon) <https://github.com/kamibo>`_.
- * Implemented the default format for ``std::chrono::system_clock``
- (`#2319 <https://github.com/fmtlib/fmt/issues/2319>`_,
- `#2345 <https://github.com/fmtlib/fmt/pull/2345>`_). For example:
- .. code:: c++
- #include <fmt/chrono.h>
- int main() {
- fmt::print("{}", std::chrono::system_clock::now());
- }
- prints "2021-06-18 15:22:00" (the output depends on the current date and
- time). Thanks `@sunmy2019 <https://github.com/sunmy2019>`_.
- * Made more chrono specifiers locale independent by default. Use the ``'L'``
- specifier to get localized formatting. For example:
- .. code:: c++
- #include <fmt/chrono.h>
- int main() {
- std::locale::global(std::locale("ru_RU.UTF-8"));
- auto monday = std::chrono::weekday(1);
- fmt::print("{}\n", monday); // prints "Mon"
- fmt::print("{:L}\n", monday); // prints "пн"
- }
- * Improved locale handling in chrono formatting
- (`#2337 <https://github.com/fmtlib/fmt/issues/2337>`_,
- `#2349 <https://github.com/fmtlib/fmt/pull/2349>`_,
- `#2350 <https://github.com/fmtlib/fmt/pull/2350>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Deprecated ``fmt/locale.h`` moving the formatting functions that take a
- locale to ``fmt/format.h`` (``char``) and ``fmt/xchar`` (other overloads).
- This doesn't introduce a dependency on ``<locale>`` so there is virtually no
- compile time effect.
- * Deprecated an undocumented ``format_to`` overload that takes
- ``basic_memory_buffer``.
- * Made parameter order in ``vformat_to`` consistent with ``format_to``
- (`#2327 <https://github.com/fmtlib/fmt/issues/2327>`_).
- * Added support for time points with arbitrary durations
- (`#2208 <https://github.com/fmtlib/fmt/issues/2208>`_). For example:
- .. code:: c++
- #include <fmt/chrono.h>
- int main() {
- using tp = std::chrono::time_point<
- std::chrono::system_clock, std::chrono::seconds>;
- fmt::print("{:%S}", tp(std::chrono::seconds(42)));
- }
- prints "42".
- * Formatting floating-point numbers no longer produces trailing zeros by default
- for consistency with ``std::format``. For example:
- .. code:: c++
- #include <fmt/core.h>
- int main() {
- fmt::print("{0:.3}", 1.1);
- }
- prints "1.1". Use the ``'#'`` specifier to keep trailing zeros.
- * Dropped a limit on the number of elements in a range and replaced ``{}`` with
- ``[]`` as range delimiters for consistency with Python's ``str.format``.
- * The ``'L'`` specifier for locale-specific numeric formatting can now be
- combined with presentation specifiers as in ``std::format``. For example:
- .. code:: c++
- #include <fmt/core.h>
- #include <locale>
- int main() {
- std::locale::global(std::locale("fr_FR.UTF-8"));
- fmt::print("{0:.2Lf}", 0.42);
- }
- prints "0,42". The deprecated ``'n'`` specifier has been removed.
- * Made the ``0`` specifier ignored for infinity and NaN
- (`#2305 <https://github.com/fmtlib/fmt/issues/2305>`_,
- `#2310 <https://github.com/fmtlib/fmt/pull/2310>`_).
- Thanks `@Liedtke (Matthias Liedtke) <https://github.com/Liedtke>`_.
- * Made the hexfloat formatting use the right alignment by default
- (`#2308 <https://github.com/fmtlib/fmt/issues/2308>`_,
- `#2317 <https://github.com/fmtlib/fmt/pull/2317>`_).
- Thanks `@Liedtke (Matthias Liedtke) <https://github.com/Liedtke>`_.
- * Removed the deprecated numeric alignment (``'='``). Use the ``'0'`` specifier
- instead.
- * Removed the deprecated ``fmt/posix.h`` header that has been replaced with
- ``fmt/os.h``.
- * Removed the deprecated ``format_to_n_context``, ``format_to_n_args`` and
- ``make_format_to_n_args``. They have been replaced with ``format_context``,
- ``format_args` and ``make_format_args`` respectively.
- * Moved ``wchar_t``-specific functions and types to ``fmt/xchar.h``.
- You can define ``FMT_DEPRECATED_INCLUDE_XCHAR`` to automatically include
- ``fmt/xchar.h`` from ``fmt/format.h`` but this will be disabled in the next
- major release.
- * Fixed handling of the ``'+'`` specifier in localized formatting
- (`#2133 <https://github.com/fmtlib/fmt/issues/2133>`_).
- * Added support for the ``'s'`` format specifier that gives textual
- representation of ``bool``
- (`#2094 <https://github.com/fmtlib/fmt/issues/2094>`_,
- `#2109 <https://github.com/fmtlib/fmt/pull/2109>`_). For example:
- .. code:: c++
- #include <fmt/core.h>
- int main() {
- fmt::print("{:s}", true);
- }
- prints "true".
- Thanks `@powercoderlol (Ivan Polyakov) <https://github.com/powercoderlol>`_.
- * Made ``fmt::ptr`` work with function pointers
- (`#2131 <https://github.com/fmtlib/fmt/pull/2131>`_). For example:
- .. code:: c++
- #include <fmt/format.h>
- int main() {
- fmt::print("My main: {}\n", fmt::ptr(main));
- }
- Thanks `@mikecrowe (Mike Crowe) <https://github.com/mikecrowe>`_.
- * The undocumented support for specializing ``formatter`` for pointer types
- has been removed.
- * Fixed ``fmt::formatted_size`` with format string compilation
- (`#2141 <https://github.com/fmtlib/fmt/pull/2141>`_,
- `#2161 <https://github.com/fmtlib/fmt/pull/2161>`_).
- Thanks `@alexezeder (Alexey Ochapov) <https://github.com/alexezeder>`_.
- * Fixed handling of empty format strings during format string compilation
- (`#2042 <https://github.com/fmtlib/fmt/issues/2042>`_):
- .. code:: c++
- auto s = fmt::format(FMT_COMPILE(""));
- Thanks `@alexezeder (Alexey Ochapov) <https://github.com/alexezeder>`_.
- * Fixed handling of enums in ``fmt::to_string``
- (`#2036 <https://github.com/fmtlib/fmt/issues/2036>`_).
- * Improved width computation
- (`#2033 <https://github.com/fmtlib/fmt/issues/2033>`_,
- `#2091 <https://github.com/fmtlib/fmt/issues/2091>`_). For example:
- .. code:: c++
- #include <fmt/core.h>
- int main() {
- fmt::print("{:-<10}{}\n", "你好", "世界");
- fmt::print("{:-<10}{}\n", "hello", "world");
- }
- prints
- .. image:: https://user-images.githubusercontent.com/576385/
- 119840373-cea3ca80-beb9-11eb-91e0-54266c48e181.png
- on a modern terminal.
- * The experimental fast output stream (``fmt::ostream``) is now truncated by
- default for consistency with ``fopen``
- (`#2018 <https://github.com/fmtlib/fmt/issues/2018>`_). For example:
- .. code:: c++
- #include <fmt/os.h>
- int main() {
- fmt::ostream out1 = fmt::output_file("guide");
- out1.print("Zaphod");
- out1.close();
- fmt::ostream out2 = fmt::output_file("guide");
- out2.print("Ford");
- }
- writes "Ford" to the file "guide". To preserve the old file content if any
- pass ``fmt::file::WRONLY | fmt::file::CREATE`` flags to ``fmt::output_file``.
- * Fixed moving of ``fmt::ostream`` that holds buffered data
- (`#2197 <https://github.com/fmtlib/fmt/issues/2197>`_,
- `#2198 <https://github.com/fmtlib/fmt/pull/2198>`_).
- Thanks `@vtta <https://github.com/vtta>`_.
- * Replaced the ``fmt::system_error`` exception with a function of the same
- name that constructs ``std::system_error``
- (`#2266 <https://github.com/fmtlib/fmt/issues/2266>`_).
- * Replaced the ``fmt::windows_error`` exception with a function of the same
- name that constructs ``std::system_error`` with the category returned by
- ``fmt::system_category()``
- (`#2274 <https://github.com/fmtlib/fmt/issues/2274>`_,
- `#2275 <https://github.com/fmtlib/fmt/pull/2275>`_).
- The latter is similar to ``std::sytem_category`` but correctly handles UTF-8.
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Replaced ``fmt::error_code`` with ``std::error_code`` and made it formattable
- (`#2269 <https://github.com/fmtlib/fmt/issues/2269>`_,
- `#2270 <https://github.com/fmtlib/fmt/pull/2270>`_,
- `#2273 <https://github.com/fmtlib/fmt/pull/2273>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
-
- * Added speech synthesis support
- (`#2206 <https://github.com/fmtlib/fmt/pull/2206>`_).
- * Made ``format_to`` work with a memory buffer that has a custom allocator
- (`#2300 <https://github.com/fmtlib/fmt/pull/2300>`_).
- Thanks `@voxmea <https://github.com/voxmea>`_.
- * Added ``Allocator::max_size`` support to ``basic_memory_buffer``.
- (`#1960 <https://github.com/fmtlib/fmt/pull/1960>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Added wide string support to ``fmt::join``
- (`#2236 <https://github.com/fmtlib/fmt/pull/2236>`_).
- Thanks `@crbrz <https://github.com/crbrz>`_.
- * Made iterators passed to ``formatter`` specializations via a format context
- satisfy C++20 ``std::output_iterator`` requirements
- (`#2156 <https://github.com/fmtlib/fmt/issues/2156>`_,
- `#2158 <https://github.com/fmtlib/fmt/pull/2158>`_,
- `#2195 <https://github.com/fmtlib/fmt/issues/2195>`_,
- `#2204 <https://github.com/fmtlib/fmt/pull/2204>`_).
- Thanks `@randomnetcat (Jason Cobb) <https://github.com/randomnetcat>`_.
- * Optimized the ``printf`` implementation
- (`#1982 <https://github.com/fmtlib/fmt/pull/1982>`_,
- `#1984 <https://github.com/fmtlib/fmt/pull/1984>`_,
- `#2016 <https://github.com/fmtlib/fmt/pull/2016>`_,
- `#2164 <https://github.com/fmtlib/fmt/pull/2164>`_).
- Thanks `@rimathia <https://github.com/rimathia>`_ and
- `@moiwi <https://github.com/moiwi>`_.
- * Improved detection of ``constexpr`` ``char_traits``
- (`#2246 <https://github.com/fmtlib/fmt/pull/2246>`_,
- `#2257 <https://github.com/fmtlib/fmt/pull/2257>`_).
- Thanks `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_.
- * Fixed writing to ``stdout`` when it is redirected to ``NUL`` on Windows
- (`#2080 <https://github.com/fmtlib/fmt/issues/2080>`_).
- * Fixed exception propagation from iterators
- (`#2097 <https://github.com/fmtlib/fmt/issues/2097>`_).
-
- * Improved ``strftime`` error handling
- (`#2238 <https://github.com/fmtlib/fmt/issues/2238>`_,
- `#2244 <https://github.com/fmtlib/fmt/pull/2244>`_).
- Thanks `@yumeyao <https://github.com/yumeyao>`_.
- * Stopped using deprecated GCC UDL template extension.
- * Added ``fmt/args.h`` to the install target
- (`#2096 <https://github.com/fmtlib/fmt/issues/2096>`_).
- * Error messages are now passed to assert when exceptions are disabled
- (`#2145 <https://github.com/fmtlib/fmt/pull/2145>`_).
- Thanks `@NobodyXu (Jiahao XU) <https://github.com/NobodyXu>`_.
- * Added the ``FMT_MASTER_PROJECT`` CMake option to control build and install
- targets when {fmt} is included via ``add_subdirectory``
- (`#2098 <https://github.com/fmtlib/fmt/issues/2098>`_,
- `#2100 <https://github.com/fmtlib/fmt/pull/2100>`_).
- Thanks `@randomizedthinking <https://github.com/randomizedthinking>`_.
- * Improved build configuration
- (`#2026 <https://github.com/fmtlib/fmt/pull/2026>`_,
- `#2122 <https://github.com/fmtlib/fmt/pull/2122>`_).
- Thanks `@luncliff (Park DongHa) <https://github.com/luncliff>`_ and
- `@ibaned (Dan Ibanez) <https://github.com/ibaned>`_.
- * Fixed various warnings and compilation issues
- (`#1947 <https://github.com/fmtlib/fmt/issues/1947>`_,
- `#1959 <https://github.com/fmtlib/fmt/pull/1959>`_,
- `#1963 <https://github.com/fmtlib/fmt/pull/1963>`_,
- `#1965 <https://github.com/fmtlib/fmt/pull/1965>`_,
- `#1966 <https://github.com/fmtlib/fmt/issues/1966>`_,
- `#1974 <https://github.com/fmtlib/fmt/pull/1974>`_,
- `#1975 <https://github.com/fmtlib/fmt/pull/1975>`_,
- `#1990 <https://github.com/fmtlib/fmt/pull/1990>`_,
- `#2000 <https://github.com/fmtlib/fmt/issues/2000>`_,
- `#2001 <https://github.com/fmtlib/fmt/pull/2001>`_,
- `#2002 <https://github.com/fmtlib/fmt/issues/2002>`_,
- `#2004 <https://github.com/fmtlib/fmt/issues/2004>`_,
- `#2006 <https://github.com/fmtlib/fmt/pull/2006>`_,
- `#2009 <https://github.com/fmtlib/fmt/pull/2009>`_,
- `#2010 <https://github.com/fmtlib/fmt/pull/2010>`_,
- `#2038 <https://github.com/fmtlib/fmt/issues/2038>`_,
- `#2039 <https://github.com/fmtlib/fmt/issues/2039>`_,
- `#2047 <https://github.com/fmtlib/fmt/issues/2047>`_,
- `#2053 <https://github.com/fmtlib/fmt/pull/2053>`_,
- `#2059 <https://github.com/fmtlib/fmt/issues/2059>`_,
- `#2065 <https://github.com/fmtlib/fmt/pull/2065>`_,
- `#2067 <https://github.com/fmtlib/fmt/pull/2067>`_,
- `#2068 <https://github.com/fmtlib/fmt/pull/2068>`_,
- `#2073 <https://github.com/fmtlib/fmt/pull/2073>`_,
- `#2103 <https://github.com/fmtlib/fmt/issues/2103>`_,
- `#2105 <https://github.com/fmtlib/fmt/issues/2105>`_,
- `#2106 <https://github.com/fmtlib/fmt/pull/2106>`_,
- `#2107 <https://github.com/fmtlib/fmt/pull/2107>`_,
- `#2116 <https://github.com/fmtlib/fmt/issues/2116>`_,
- `#2117 <https://github.com/fmtlib/fmt/pull/2117>`_,
- `#2118 <https://github.com/fmtlib/fmt/issues/2118>`_,
- `#2119 <https://github.com/fmtlib/fmt/pull/2119>`_,
- `#2127 <https://github.com/fmtlib/fmt/issues/2127>`_,
- `#2128 <https://github.com/fmtlib/fmt/pull/2128>`_,
- `#2140 <https://github.com/fmtlib/fmt/issues/2140>`_,
- `#2142 <https://github.com/fmtlib/fmt/issues/2142>`_,
- `#2143 <https://github.com/fmtlib/fmt/pull/2143>`_,
- `#2144 <https://github.com/fmtlib/fmt/pull/2144>`_,
- `#2147 <https://github.com/fmtlib/fmt/issues/2147>`_,
- `#2148 <https://github.com/fmtlib/fmt/issues/2148>`_,
- `#2149 <https://github.com/fmtlib/fmt/issues/2149>`_,
- `#2152 <https://github.com/fmtlib/fmt/pull/2152>`_,
- `#2160 <https://github.com/fmtlib/fmt/pull/2160>`_,
- `#2170 <https://github.com/fmtlib/fmt/issues/2170>`_,
- `#2175 <https://github.com/fmtlib/fmt/issues/2175>`_,
- `#2176 <https://github.com/fmtlib/fmt/issues/2176>`_,
- `#2177 <https://github.com/fmtlib/fmt/pull/2177>`_,
- `#2178 <https://github.com/fmtlib/fmt/issues/2178>`_,
- `#2179 <https://github.com/fmtlib/fmt/pull/2179>`_,
- `#2180 <https://github.com/fmtlib/fmt/issues/2180>`_,
- `#2181 <https://github.com/fmtlib/fmt/issues/2181>`_,
- `#2183 <https://github.com/fmtlib/fmt/pull/2183>`_,
- `#2184 <https://github.com/fmtlib/fmt/issues/2184>`_,
- `#2185 <https://github.com/fmtlib/fmt/issues/2185>`_,
- `#2186 <https://github.com/fmtlib/fmt/pull/2186>`_,
- `#2187 <https://github.com/fmtlib/fmt/pull/2187>`_,
- `#2190 <https://github.com/fmtlib/fmt/pull/2190>`_,
- `#2192 <https://github.com/fmtlib/fmt/pull/2192>`_,
- `#2194 <https://github.com/fmtlib/fmt/pull/2194>`_,
- `#2205 <https://github.com/fmtlib/fmt/pull/2205>`_,
- `#2210 <https://github.com/fmtlib/fmt/issues/2210>`_,
- `#2211 <https://github.com/fmtlib/fmt/pull/2211>`_,
- `#2215 <https://github.com/fmtlib/fmt/pull/2215>`_,
- `#2216 <https://github.com/fmtlib/fmt/pull/2216>`_,
- `#2218 <https://github.com/fmtlib/fmt/pull/2218>`_,
- `#2220 <https://github.com/fmtlib/fmt/pull/2220>`_,
- `#2228 <https://github.com/fmtlib/fmt/issues/2228>`_,
- `#2229 <https://github.com/fmtlib/fmt/pull/2229>`_,
- `#2230 <https://github.com/fmtlib/fmt/pull/2230>`_,
- `#2233 <https://github.com/fmtlib/fmt/issues/2233>`_,
- `#2239 <https://github.com/fmtlib/fmt/pull/2239>`_,
- `#2248 <https://github.com/fmtlib/fmt/issues/2248>`_,
- `#2252 <https://github.com/fmtlib/fmt/issues/2252>`_,
- `#2253 <https://github.com/fmtlib/fmt/pull/2253>`_,
- `#2255 <https://github.com/fmtlib/fmt/pull/2255>`_,
- `#2261 <https://github.com/fmtlib/fmt/issues/2261>`_,
- `#2278 <https://github.com/fmtlib/fmt/issues/2278>`_,
- `#2284 <https://github.com/fmtlib/fmt/issues/2284>`_,
- `#2287 <https://github.com/fmtlib/fmt/pull/2287>`_,
- `#2289 <https://github.com/fmtlib/fmt/pull/2289>`_,
- `#2290 <https://github.com/fmtlib/fmt/pull/2290>`_,
- `#2293 <https://github.com/fmtlib/fmt/pull/2293>`_,
- `#2295 <https://github.com/fmtlib/fmt/issues/2295>`_,
- `#2296 <https://github.com/fmtlib/fmt/pull/2296>`_,
- `#2297 <https://github.com/fmtlib/fmt/pull/2297>`_,
- `#2311 <https://github.com/fmtlib/fmt/issues/2311>`_,
- `#2313 <https://github.com/fmtlib/fmt/pull/2313>`_,
- `#2315 <https://github.com/fmtlib/fmt/pull/2315>`_,
- `#2320 <https://github.com/fmtlib/fmt/issues/2320>`_,
- `#2321 <https://github.com/fmtlib/fmt/pull/2321>`_,
- `#2323 <https://github.com/fmtlib/fmt/pull/2323>`_,
- `#2328 <https://github.com/fmtlib/fmt/issues/2328>`_,
- `#2329 <https://github.com/fmtlib/fmt/pull/2329>`_,
- `#2333 <https://github.com/fmtlib/fmt/pull/2333>`_,
- `#2338 <https://github.com/fmtlib/fmt/pull/2338>`_,
- `#2341 <https://github.com/fmtlib/fmt/pull/2341>`_).
- Thanks `@darklukee <https://github.com/darklukee>`_,
- `@fagg (Ashton Fagg) <https://github.com/fagg>`_,
- `@killerbot242 (Lieven de Cock) <https://github.com/killerbot242>`_,
- `@jgopel (Jonathan Gopel) <https://github.com/jgopel>`_,
- `@yeswalrus (Walter Gray) <https://github.com/yeswalrus>`_,
- `@Finkman <https://github.com/Finkman>`_,
- `@HazardyKnusperkeks (Björn Schäpers) <https://github.com/HazardyKnusperkeks>`_,
- `@dkavolis (Daumantas Kavolis) <https://github.com/dkavolis>`_,
- `@concatime (Issam Maghni) <https://github.com/concatime>`_,
- `@chronoxor (Ivan Shynkarenka) <https://github.com/chronoxor>`_,
- `@summivox (Yin Zhong) <https://github.com/summivox>`_,
- `@yNeo <https://github.com/yNeo>`_,
- `@Apache-HB (Elliot) <https://github.com/Apache-HB>`_,
- `@alexezeder (Alexey Ochapov) <https://github.com/alexezeder>`_,
- `@toojays (John Steele Scott) <https://github.com/toojays>`_,
- `@Brainy0207 <https://github.com/Brainy0207>`_,
- `@vadz (VZ) <https://github.com/vadz>`_,
- `@imsherlock (Ryan Sherlock) <https://github.com/imsherlock>`_,
- `@phprus (Vladislav Shchapov) <https://github.com/phprus>`_,
- `@white238 (Chris White) <https://github.com/white238>`_,
- `@yafshar (Yaser Afshar) <https://github.com/yafshar>`_,
- `@BillyDonahue (Billy Donahue) <https://github.com/BillyDonahue>`_,
- `@jstaahl <https://github.com/jstaahl>`_,
- `@denchat <https://github.com/denchat>`_,
- `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_,
- `@ilyakurdyukov (Ilya Kurdyukov) <https://github.com/ilyakurdyukov>`_,
- `@ilmai <https://github.com/ilmai>`_,
- `@JessyDL (Jessy De Lannoit) <https://github.com/JessyDL>`_,
- `@sergiud (Sergiu Deitsch) <https://github.com/sergiud>`_,
- `@mwinterb <https://github.com/mwinterb>`_,
- `@sven-herrmann <https://github.com/sven-herrmann>`_,
- `@jmelas (John Melas) <https://github.com/jmelas>`_,
- `@twoixter (Jose Miguel Pérez) <https://github.com/twoixter>`_,
- `@crbrz <https://github.com/crbrz>`_,
- `@upsj (Tobias Ribizel) <https://github.com/upsj>`_.
- * Improved documentation
- (`#1986 <https://github.com/fmtlib/fmt/issues/1986>`_,
- `#2051 <https://github.com/fmtlib/fmt/pull/2051>`_,
- `#2057 <https://github.com/fmtlib/fmt/issues/2057>`_,
- `#2081 <https://github.com/fmtlib/fmt/pull/2081>`_,
- `#2084 <https://github.com/fmtlib/fmt/issues/2084>`_,
- `#2312 <https://github.com/fmtlib/fmt/pull/2312>`_).
- Thanks `@imba-tjd (谭九鼎) <https://github.com/imba-tjd>`_,
- `@0x416c69 (AlιAѕѕaѕѕιN) <https://github.com/0x416c69>`_,
- `@mordante <https://github.com/mordante>`_.
- * Continuous integration and test improvements
- (`#1969 <https://github.com/fmtlib/fmt/issues/1969>`_,
- `#1991 <https://github.com/fmtlib/fmt/pull/1991>`_,
- `#2020 <https://github.com/fmtlib/fmt/pull/2020>`_,
- `#2110 <https://github.com/fmtlib/fmt/pull/2110>`_,
- `#2114 <https://github.com/fmtlib/fmt/pull/2114>`_,
- `#2196 <https://github.com/fmtlib/fmt/issues/2196>`_,
- `#2217 <https://github.com/fmtlib/fmt/pull/2217>`_,
- `#2247 <https://github.com/fmtlib/fmt/pull/2247>`_,
- `#2256 <https://github.com/fmtlib/fmt/pull/2256>`_,
- `#2336 <https://github.com/fmtlib/fmt/pull/2336>`_,
- `#2346 <https://github.com/fmtlib/fmt/pull/2346>`_).
- Thanks `@jgopel (Jonathan Gopel) <https://github.com/jgopel>`_,
- `@alexezeder (Alexey Ochapov) <https://github.com/alexezeder>`_ and
- `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_.
-
- 7.1.3 - 2020-11-24
- ------------------
- * Fixed handling of buffer boundaries in ``format_to_n``
- (`#1996 <https://github.com/fmtlib/fmt/issues/1996>`_,
- `#2029 <https://github.com/fmtlib/fmt/issues/2029>`_).
- * Fixed linkage errors when linking with a shared library
- (`#2011 <https://github.com/fmtlib/fmt/issues/2011>`_).
- * Reintroduced ostream support to range formatters
- (`#2014 <https://github.com/fmtlib/fmt/issues/2014>`_).
- * Worked around an issue with mixing std versions in gcc
- (`#2017 <https://github.com/fmtlib/fmt/issues/2017>`_).
- 7.1.2 - 2020-11-04
- ------------------
- * Fixed floating point formatting with large precision
- (`#1976 <https://github.com/fmtlib/fmt/issues/1976>`_).
- 7.1.1 - 2020-11-01
- ------------------
- * Fixed ABI compatibility with 7.0.x
- (`#1961 <https://github.com/fmtlib/fmt/issues/1961>`_).
- * Added the ``FMT_ARM_ABI_COMPATIBILITY`` macro to work around ABI
- incompatibility between GCC and Clang on ARM
- (`#1919 <https://github.com/fmtlib/fmt/issues/1919>`_).
- * Worked around a SFINAE bug in GCC 8
- (`#1957 <https://github.com/fmtlib/fmt/issues/1957>`_).
- * Fixed linkage errors when building with GCC's LTO
- (`#1955 <https://github.com/fmtlib/fmt/issues/1955>`_).
- * Fixed a compilation error when building without ``__builtin_clz`` or equivalent
- (`#1968 <https://github.com/fmtlib/fmt/pull/1968>`_).
- Thanks `@tohammer (Tobias Hammer) <https://github.com/tohammer>`_.
- * Fixed a sign conversion warning
- (`#1964 <https://github.com/fmtlib/fmt/pull/1964>`_).
- Thanks `@OptoCloud <https://github.com/OptoCloud>`_.
- 7.1.0 - 2020-10-25
- ------------------
- * Switched from `Grisu3
- <https://www.cs.tufts.edu/~nr/cs257/archive/florian-loitsch/printf.pdf>`_
- to `Dragonbox <https://github.com/jk-jeon/dragonbox>`_ for the default
- floating-point formatting which gives the shortest decimal representation
- with round-trip guarantee and correct rounding
- (`#1882 <https://github.com/fmtlib/fmt/pull/1882>`_,
- `#1887 <https://github.com/fmtlib/fmt/pull/1887>`_,
- `#1894 <https://github.com/fmtlib/fmt/pull/1894>`_). This makes {fmt} up to
- 20-30x faster than common implementations of ``std::ostringstream`` and
- ``sprintf`` on `dtoa-benchmark <https://github.com/fmtlib/dtoa-benchmark>`_
- and faster than double-conversion and Ryū:
- .. image:: https://user-images.githubusercontent.com/576385/
- 95684665-11719600-0ba8-11eb-8e5b-972ff4e49428.png
- It is possible to get even better performance at the cost of larger binary
- size by compiling with the ``FMT_USE_FULL_CACHE_DRAGONBOX`` macro set to 1.
- Thanks `@jk-jeon (Junekey Jeon) <https://github.com/jk-jeon>`_.
- * Added an experimental unsynchronized file output API which, together with
- `format string compilation <https://fmt.dev/latest/api.html#compile-api>`_,
- can give `5-9 times speed up compared to fprintf
- <https://www.zverovich.net/2020/08/04/optimal-file-buffer-size.html>`_
- on common platforms (`godbolt <https://godbolt.org/z/nsTcG8>`__):
- .. code:: c++
- #include <fmt/os.h>
- int main() {
- auto f = fmt::output_file("guide");
- f.print("The answer is {}.", 42);
- }
- * Added a formatter for ``std::chrono::time_point<system_clock>``
- (`#1819 <https://github.com/fmtlib/fmt/issues/1819>`_,
- `#1837 <https://github.com/fmtlib/fmt/pull/1837>`_). For example
- (`godbolt <https://godbolt.org/z/c4M6fh>`__):
- .. code:: c++
- #include <fmt/chrono.h>
- int main() {
- auto now = std::chrono::system_clock::now();
- fmt::print("The time is {:%H:%M:%S}.\n", now);
- }
- Thanks `@adamburgess (Adam Burgess) <https://github.com/adamburgess>`_.
- * Added support for ranges with non-const ``begin``/``end`` to ``fmt::join``
- (`#1784 <https://github.com/fmtlib/fmt/issues/1784>`_,
- `#1786 <https://github.com/fmtlib/fmt/pull/1786>`_). For example
- (`godbolt <https://godbolt.org/z/jP63Tv>`__):
- .. code:: c++
- #include <fmt/ranges.h>
- #include <range/v3/view/filter.hpp>
- int main() {
- using std::literals::string_literals::operator""s;
- auto strs = std::array{"a"s, "bb"s, "ccc"s};
- auto range = strs | ranges::views::filter(
- [] (const std::string &x) { return x.size() != 2; }
- );
- fmt::print("{}\n", fmt::join(range, ""));
- }
- prints "accc".
- Thanks `@tonyelewis (Tony E Lewis) <https://github.com/tonyelewis>`_.
- * Added a ``memory_buffer::append`` overload that takes a range
- (`#1806 <https://github.com/fmtlib/fmt/pull/1806>`_).
- Thanks `@BRevzin (Barry Revzin) <https://github.com/BRevzin>`_.
- * Improved handling of single code units in ``FMT_COMPILE``. For example:
- .. code:: c++
- #include <fmt/compile.h>
- char* f(char* buf) {
- return fmt::format_to(buf, FMT_COMPILE("x{}"), 42);
- }
- compiles to just (`godbolt <https://godbolt.org/z/5vncz3>`__):
- .. code:: asm
- _Z1fPc:
- movb $120, (%rdi)
- xorl %edx, %edx
- cmpl $42, _ZN3fmt2v76detail10basic_dataIvE23zero_or_powers_of_10_32E+8(%rip)
- movl $3, %eax
- seta %dl
- subl %edx, %eax
- movzwl _ZN3fmt2v76detail10basic_dataIvE6digitsE+84(%rip), %edx
- cltq
- addq %rdi, %rax
- movw %dx, -2(%rax)
- ret
- Here a single ``mov`` instruction writes ``'x'`` (``$120``) to the output
- buffer.
- * Added dynamic width support to format string compilation
- (`#1809 <https://github.com/fmtlib/fmt/issues/1809>`_).
- * Improved error reporting for unformattable types: now you'll get the type name
- directly in the error message instead of the note:
- .. code:: c++
- #include <fmt/core.h>
- struct how_about_no {};
- int main() {
- fmt::print("{}", how_about_no());
- }
- Error (`godbolt <https://godbolt.org/z/GoxM4e>`__):
- ``fmt/core.h:1438:3: error: static_assert failed due to requirement
- 'fmt::v7::formattable<how_about_no>()' "Cannot format an argument.
- To make type T formattable provide a formatter<T> specialization:
- https://fmt.dev/latest/api.html#udt"
- ...``
- * Added the `make_args_checked <https://fmt.dev/7.1.0/api.html#argument-lists>`_
- function template that allows you to write formatting functions with
- compile-time format string checks and avoid binary code bloat
- (`godbolt <https://godbolt.org/z/PEf9qr>`__):
- .. code:: c++
- void vlog(const char* file, int line, fmt::string_view format,
- fmt::format_args args) {
- fmt::print("{}: {}: ", file, line);
- fmt::vprint(format, args);
- }
- template <typename S, typename... Args>
- void log(const char* file, int line, const S& format, Args&&... args) {
- vlog(file, line, format,
- fmt::make_args_checked<Args...>(format, args...));
- }
- #define MY_LOG(format, ...) \
- log(__FILE__, __LINE__, FMT_STRING(format), __VA_ARGS__)
- MY_LOG("invalid squishiness: {}", 42);
- * Replaced ``snprintf`` fallback with a faster internal IEEE 754 ``float`` and
- ``double`` formatter for arbitrary precision. For example
- (`godbolt <https://godbolt.org/z/dPhWvj>`__):
- .. code:: c++
- #include <fmt/core.h>
- int main() {
- fmt::print("{:.500}\n", 4.9406564584124654E-324);
- }
- prints
- ``4.9406564584124654417656879286822137236505980261432476442558568250067550727020875186529983636163599237979656469544571773092665671035593979639877479601078187812630071319031140452784581716784898210368871863605699873072305000638740915356498438731247339727316961514003171538539807412623856559117102665855668676818703956031062493194527159149245532930545654440112748012970999954193198940908041656332452475714786901472678015935523861155013480352649347201937902681071074917033322268447533357208324319360923829e-324``.
- * Made ``format_to_n`` and ``formatted_size`` part of the `core API
- <https://fmt.dev/latest/api.html#core-api>`__
- (`godbolt <https://godbolt.org/z/sPjY1K>`__):
- .. code:: c++
- #include <fmt/core.h>
- int main() {
- char buffer[10];
- auto result = fmt::format_to_n(buffer, sizeof(buffer), "{}", 42);
- }
- * Added ``fmt::format_to_n`` overload with format string compilation
- (`#1764 <https://github.com/fmtlib/fmt/issues/1764>`_,
- `#1767 <https://github.com/fmtlib/fmt/pull/1767>`_,
- `#1869 <https://github.com/fmtlib/fmt/pull/1869>`_). For example
- (`godbolt <https://godbolt.org/z/93h86q>`__):
- .. code:: c++
- #include <fmt/compile.h>
- int main() {
- char buffer[8];
- fmt::format_to_n(buffer, sizeof(buffer), FMT_COMPILE("{}"), 42);
- }
- Thanks `@Kurkin (Dmitry Kurkin) <https://github.com/Kurkin>`_,
- `@alexezeder (Alexey Ochapov) <https://github.com/alexezeder>`_.
- * Added ``fmt::format_to`` overload that take ``text_style``
- (`#1593 <https://github.com/fmtlib/fmt/issues/1593>`_,
- `#1842 <https://github.com/fmtlib/fmt/issues/1842>`_,
- `#1843 <https://github.com/fmtlib/fmt/pull/1843>`_). For example
- (`godbolt <https://godbolt.org/z/91153r>`__):
- .. code:: c++
- #include <fmt/color.h>
- int main() {
- std::string out;
- fmt::format_to(std::back_inserter(out),
- fmt::emphasis::bold | fg(fmt::color::red),
- "The answer is {}.", 42);
- }
- Thanks `@Naios (Denis Blank) <https://github.com/Naios>`_.
- * Made the ``'#'`` specifier emit trailing zeros in addition to the decimal
- point (`#1797 <https://github.com/fmtlib/fmt/issues/1797>`_). For example
- (`godbolt <https://godbolt.org/z/bhdcW9>`__):
- .. code:: c++
- #include <fmt/core.h>
- int main() {
- fmt::print("{:#.2g}", 0.5);
- }
- prints ``0.50``.
- * Changed the default floating point format to not include ``.0`` for
- consistency with ``std::format`` and ``std::to_chars``
- (`#1893 <https://github.com/fmtlib/fmt/issues/1893>`_,
- `#1943 <https://github.com/fmtlib/fmt/issues/1943>`_). It is possible to get
- the decimal point and trailing zero with the ``#`` specifier.
- * Fixed an issue with floating-point formatting that could result in addition of
- a non-significant trailing zero in rare cases e.g. ``1.00e-34`` instead of
- ``1.0e-34`` (`#1873 <https://github.com/fmtlib/fmt/issues/1873>`_,
- `#1917 <https://github.com/fmtlib/fmt/issues/1917>`_).
- * Made ``fmt::to_string`` fallback on ``ostream`` insertion operator if
- the ``formatter`` specialization is not provided
- (`#1815 <https://github.com/fmtlib/fmt/issues/1815>`_,
- `#1829 <https://github.com/fmtlib/fmt/pull/1829>`_).
- Thanks `@alexezeder (Alexey Ochapov) <https://github.com/alexezeder>`_.
- * Added support for the append mode to the experimental file API and
- improved ``fcntl.h`` detection.
- (`#1847 <https://github.com/fmtlib/fmt/pull/1847>`_,
- `#1848 <https://github.com/fmtlib/fmt/pull/1848>`_).
- Thanks `@t-wiser <https://github.com/t-wiser>`_.
- * Fixed handling of types that have both an implicit conversion operator and
- an overloaded ``ostream`` insertion operator
- (`#1766 <https://github.com/fmtlib/fmt/issues/1766>`_).
- * Fixed a slicing issue in an internal iterator type
- (`#1822 <https://github.com/fmtlib/fmt/pull/1822>`_).
- Thanks `@BRevzin (Barry Revzin) <https://github.com/BRevzin>`_.
- * Fixed an issue in locale-specific integer formatting
- (`#1927 <https://github.com/fmtlib/fmt/issues/1927>`_).
- * Fixed handling of exotic code unit types
- (`#1870 <https://github.com/fmtlib/fmt/issues/1870>`_,
- `#1932 <https://github.com/fmtlib/fmt/issues/1932>`_).
- * Improved ``FMT_ALWAYS_INLINE``
- (`#1878 <https://github.com/fmtlib/fmt/pull/1878>`_).
- Thanks `@jk-jeon (Junekey Jeon) <https://github.com/jk-jeon>`_.
- * Removed dependency on ``windows.h``
- (`#1900 <https://github.com/fmtlib/fmt/pull/1900>`_).
- Thanks `@bernd5 (Bernd Baumanns) <https://github.com/bernd5>`_.
- * Optimized counting of decimal digits on MSVC
- (`#1890 <https://github.com/fmtlib/fmt/pull/1890>`_).
- Thanks `@mwinterb <https://github.com/mwinterb>`_.
- * Improved documentation
- (`#1772 <https://github.com/fmtlib/fmt/issues/1772>`_,
- `#1775 <https://github.com/fmtlib/fmt/pull/1775>`_,
- `#1792 <https://github.com/fmtlib/fmt/pull/1792>`_,
- `#1838 <https://github.com/fmtlib/fmt/pull/1838>`_,
- `#1888 <https://github.com/fmtlib/fmt/pull/1888>`_,
- `#1918 <https://github.com/fmtlib/fmt/pull/1918>`_,
- `#1939 <https://github.com/fmtlib/fmt/pull/1939>`_).
- Thanks `@leolchat (Léonard Gérard) <https://github.com/leolchat>`_,
- `@pepsiman (Malcolm Parsons) <https://github.com/pepsiman>`_,
- `@Klaim (Joël Lamotte) <https://github.com/Klaim>`_,
- `@ravijanjam (Ravi J) <https://github.com/ravijanjam>`_,
- `@francesco-st <https://github.com/francesco-st>`_,
- `@udnaan (Adnan) <https://github.com/udnaan>`_.
- * Added the ``FMT_REDUCE_INT_INSTANTIATIONS`` CMake option that reduces the
- binary code size at the cost of some integer formatting performance. This can
- be useful for extremely memory-constrained embedded systems
- (`#1778 <https://github.com/fmtlib/fmt/issues/1778>`_,
- `#1781 <https://github.com/fmtlib/fmt/pull/1781>`_).
- Thanks `@kammce (Khalil Estell) <https://github.com/kammce>`_.
- * Added the ``FMT_USE_INLINE_NAMESPACES`` macro to control usage of inline
- namespaces (`#1945 <https://github.com/fmtlib/fmt/pull/1945>`_).
- Thanks `@darklukee <https://github.com/darklukee>`_.
- * Improved build configuration
- (`#1760 <https://github.com/fmtlib/fmt/pull/1760>`_,
- `#1770 <https://github.com/fmtlib/fmt/pull/1770>`_,
- `#1779 <https://github.com/fmtlib/fmt/issues/1779>`_,
- `#1783 <https://github.com/fmtlib/fmt/pull/1783>`_,
- `#1823 <https://github.com/fmtlib/fmt/pull/1823>`_).
- Thanks `@dvetutnev (Dmitriy Vetutnev) <https://github.com/dvetutnev>`_,
- `@xvitaly (Vitaly Zaitsev) <https://github.com/xvitaly>`_,
- `@tambry (Raul Tambre) <https://github.com/tambry>`_,
- `@medithe <https://github.com/medithe>`_,
- `@martinwuehrer (Martin Wührer) <https://github.com/martinwuehrer>`_.
- * Fixed various warnings and compilation issues
- (`#1790 <https://github.com/fmtlib/fmt/pull/1790>`_,
- `#1802 <https://github.com/fmtlib/fmt/pull/1802>`_,
- `#1808 <https://github.com/fmtlib/fmt/pull/1808>`_,
- `#1810 <https://github.com/fmtlib/fmt/issues/1810>`_,
- `#1811 <https://github.com/fmtlib/fmt/issues/1811>`_,
- `#1812 <https://github.com/fmtlib/fmt/pull/1812>`_,
- `#1814 <https://github.com/fmtlib/fmt/pull/1814>`_,
- `#1816 <https://github.com/fmtlib/fmt/pull/1816>`_,
- `#1817 <https://github.com/fmtlib/fmt/pull/1817>`_,
- `#1818 <https://github.com/fmtlib/fmt/pull/1818>`_,
- `#1825 <https://github.com/fmtlib/fmt/issues/1825>`_,
- `#1836 <https://github.com/fmtlib/fmt/pull/1836>`_,
- `#1855 <https://github.com/fmtlib/fmt/pull/1855>`_,
- `#1856 <https://github.com/fmtlib/fmt/pull/1856>`_,
- `#1860 <https://github.com/fmtlib/fmt/pull/1860>`_,
- `#1877 <https://github.com/fmtlib/fmt/pull/1877>`_,
- `#1879 <https://github.com/fmtlib/fmt/pull/1879>`_,
- `#1880 <https://github.com/fmtlib/fmt/pull/1880>`_,
- `#1896 <https://github.com/fmtlib/fmt/issues/1896>`_,
- `#1897 <https://github.com/fmtlib/fmt/pull/1897>`_,
- `#1898 <https://github.com/fmtlib/fmt/pull/1898>`_,
- `#1904 <https://github.com/fmtlib/fmt/issues/1904>`_,
- `#1908 <https://github.com/fmtlib/fmt/pull/1908>`_,
- `#1911 <https://github.com/fmtlib/fmt/issues/1911>`_,
- `#1912 <https://github.com/fmtlib/fmt/issues/1912>`_,
- `#1928 <https://github.com/fmtlib/fmt/issues/1928>`_,
- `#1929 <https://github.com/fmtlib/fmt/pull/1929>`_,
- `#1935 <https://github.com/fmtlib/fmt/issues/1935>`_,
- `#1937 <https://github.com/fmtlib/fmt/pull/1937>`_,
- `#1942 <https://github.com/fmtlib/fmt/pull/1942>`_,
- `#1949 <https://github.com/fmtlib/fmt/issues/1949>`_).
- Thanks `@TheQwertiest <https://github.com/TheQwertiest>`_,
- `@medithe <https://github.com/medithe>`_,
- `@martinwuehrer (Martin Wührer) <https://github.com/martinwuehrer>`_,
- `@n16h7hunt3r <https://github.com/n16h7hunt3r>`_,
- `@Othereum (Seokjin Lee) <https://github.com/Othereum>`_,
- `@gsjaardema (Greg Sjaardema) <https://github.com/gsjaardema>`_,
- `@AlexanderLanin (Alexander Lanin) <https://github.com/AlexanderLanin>`_,
- `@gcerretani (Giovanni Cerretani) <https://github.com/gcerretani>`_,
- `@chronoxor (Ivan Shynkarenka) <https://github.com/chronoxor>`_,
- `@noizefloor (Jan Schwers) <https://github.com/noizefloor>`_,
- `@akohlmey (Axel Kohlmeyer) <https://github.com/akohlmey>`_,
- `@jk-jeon (Junekey Jeon) <https://github.com/jk-jeon>`_,
- `@rimathia <https://github.com/rimathia>`_,
- `@rglarix (Riccardo Ghetta (larix)) <https://github.com/rglarix>`_,
- `@moiwi <https://github.com/moiwi>`_,
- `@heckad (Kazantcev Andrey) <https://github.com/heckad>`_,
- `@MarcDirven <https://github.com/MarcDirven>`_.
- `@BartSiwek (Bart Siwek) <https://github.com/BartSiwek>`_,
- `@darklukee <https://github.com/darklukee>`_.
- 7.0.3 - 2020-08-06
- ------------------
- * Worked around broken ``numeric_limits`` for 128-bit integers
- (`#1787 <https://github.com/fmtlib/fmt/issues/1787>`_).
- * Added error reporting on missing named arguments
- (`#1796 <https://github.com/fmtlib/fmt/issues/1796>`_).
- * Stopped using 128-bit integers with clang-cl
- (`#1800 <https://github.com/fmtlib/fmt/pull/1800>`_).
- Thanks `@Kingcom <https://github.com/Kingcom>`_.
- * Fixed issues in locale-specific integer formatting
- (`#1782 <https://github.com/fmtlib/fmt/issues/1782>`_,
- `#1801 <https://github.com/fmtlib/fmt/issues/1801>`_).
- 7.0.2 - 2020-07-29
- ------------------
- * Worked around broken ``numeric_limits`` for 128-bit integers
- (`#1725 <https://github.com/fmtlib/fmt/issues/1725>`_).
- * Fixed compatibility with CMake 3.4
- (`#1779 <https://github.com/fmtlib/fmt/issues/1779>`_).
- * Fixed handling of digit separators in locale-specific formatting
- (`#1782 <https://github.com/fmtlib/fmt/issues/1782>`_).
- 7.0.1 - 2020-07-07
- ------------------
- * Updated the inline version namespace name.
- * Worked around a gcc bug in mangling of alias templates
- (`#1753 <https://github.com/fmtlib/fmt/issues/1753>`_).
- * Fixed a linkage error on Windows
- (`#1757 <https://github.com/fmtlib/fmt/issues/1757>`_).
- Thanks `@Kurkin (Dmitry Kurkin) <https://github.com/Kurkin>`_.
- * Fixed minor issues with the documentation.
- 7.0.0 - 2020-07-05
- ------------------
- * Reduced the library size. For example, on macOS a stripped test binary
- statically linked with {fmt} `shrank from ~368k to less than 100k
- <http://www.zverovich.net/2020/05/21/reducing-library-size.html>`_.
- * Added a simpler and more efficient `format string compilation API
- <https://fmt.dev/7.0.0/api.html#compile-api>`_:
- .. code:: c++
- #include <fmt/compile.h>
- // Converts 42 into std::string using the most efficient method and no
- // runtime format string processing.
- std::string s = fmt::format(FMT_COMPILE("{}"), 42);
- The old ``fmt::compile`` API is now deprecated.
- * Optimized integer formatting: ``format_to`` with format string compilation
- and a stack-allocated buffer is now `faster than to_chars on both
- libc++ and libstdc++
- <http://www.zverovich.net/2020/06/13/fast-int-to-string-revisited.html>`_.
- * Optimized handling of small format strings. For example,
- .. code:: c++
- fmt::format("Result: {}: ({},{},{},{})", str1, str2, str3, str4, str5)
- is now ~40% faster (`#1685 <https://github.com/fmtlib/fmt/issues/1685>`_).
- * Applied extern templates to improve compile times when using the core API
- and ``fmt/format.h`` (`#1452 <https://github.com/fmtlib/fmt/issues/1452>`_).
- For example, on macOS with clang the compile time of a test translation unit
- dropped from 2.3s to 0.3s with ``-O2`` and from 0.6s to 0.3s with the default
- settings (``-O0``).
- Before (``-O2``)::
- % time c++ -c test.cc -I include -std=c++17 -O2
- c++ -c test.cc -I include -std=c++17 -O2 2.22s user 0.08s system 99% cpu 2.311 total
- After (``-O2``)::
- % time c++ -c test.cc -I include -std=c++17 -O2
- c++ -c test.cc -I include -std=c++17 -O2 0.26s user 0.04s system 98% cpu 0.303 total
- Before (default)::
- % time c++ -c test.cc -I include -std=c++17
- c++ -c test.cc -I include -std=c++17 0.53s user 0.06s system 98% cpu 0.601 total
- After (default)::
- % time c++ -c test.cc -I include -std=c++17
- c++ -c test.cc -I include -std=c++17 0.24s user 0.06s system 98% cpu 0.301 total
- It is still recommended to use ``fmt/core.h`` instead of ``fmt/format.h`` but
- the compile time difference is now smaller. Thanks
- `@alex3d <https://github.com/alex3d>`_ for the suggestion.
- * Named arguments are now stored on stack (no dynamic memory allocations) and
- the compiled code is more compact and efficient. For example
- .. code:: c++
- #include <fmt/core.h>
- int main() {
- fmt::print("The answer is {answer}\n", fmt::arg("answer", 42));
- }
- compiles to just (`godbolt <https://godbolt.org/z/NcfEp_>`__)
- .. code:: asm
- .LC0:
- .string "answer"
- .LC1:
- .string "The answer is {answer}\n"
- main:
- sub rsp, 56
- mov edi, OFFSET FLAT:.LC1
- mov esi, 23
- movabs rdx, 4611686018427387905
- lea rax, [rsp+32]
- lea rcx, [rsp+16]
- mov QWORD PTR [rsp+8], 1
- mov QWORD PTR [rsp], rax
- mov DWORD PTR [rsp+16], 42
- mov QWORD PTR [rsp+32], OFFSET FLAT:.LC0
- mov DWORD PTR [rsp+40], 0
- call fmt::v6::vprint(fmt::v6::basic_string_view<char>,
- fmt::v6::format_args)
- xor eax, eax
- add rsp, 56
- ret
- .L.str.1:
- .asciz "answer"
- * Implemented compile-time checks for dynamic width and precision
- (`#1614 <https://github.com/fmtlib/fmt/issues/1614>`_):
- .. code:: c++
- #include <fmt/format.h>
- int main() {
- fmt::print(FMT_STRING("{0:{1}}"), 42);
- }
- now gives a compilation error because argument 1 doesn't exist::
- In file included from test.cc:1:
- include/fmt/format.h:2726:27: error: constexpr variable 'invalid_format' must be
- initialized by a constant expression
- FMT_CONSTEXPR_DECL bool invalid_format =
- ^
- ...
- include/fmt/core.h:569:26: note: in call to
- '&checker(s, {}).context_->on_error(&"argument not found"[0])'
- if (id >= num_args_) on_error("argument not found");
- ^
- * Added sentinel support to ``fmt::join``
- (`#1689 <https://github.com/fmtlib/fmt/pull/1689>`_)
- .. code:: c++
- struct zstring_sentinel {};
- bool operator==(const char* p, zstring_sentinel) { return *p == '\0'; }
- bool operator!=(const char* p, zstring_sentinel) { return *p != '\0'; }
- struct zstring {
- const char* p;
- const char* begin() const { return p; }
- zstring_sentinel end() const { return {}; }
- };
- auto s = fmt::format("{}", fmt::join(zstring{"hello"}, "_"));
- // s == "h_e_l_l_o"
- Thanks `@BRevzin (Barry Revzin) <https://github.com/BRevzin>`_.
- * Added support for named arguments, ``clear`` and ``reserve`` to
- ``dynamic_format_arg_store``
- (`#1655 <https://github.com/fmtlib/fmt/issues/1655>`_,
- `#1663 <https://github.com/fmtlib/fmt/pull/1663>`_,
- `#1674 <https://github.com/fmtlib/fmt/pull/1674>`_,
- `#1677 <https://github.com/fmtlib/fmt/pull/1677>`_).
- Thanks `@vsolontsov-ll (Vladimir Solontsov)
- <https://github.com/vsolontsov-ll>`_.
- * Added support for the ``'c'`` format specifier to integral types for
- compatibility with ``std::format``
- (`#1652 <https://github.com/fmtlib/fmt/issues/1652>`_).
- * Replaced the ``'n'`` format specifier with ``'L'`` for compatibility with
- ``std::format`` (`#1624 <https://github.com/fmtlib/fmt/issues/1624>`_).
- The ``'n'`` specifier can be enabled via the ``FMT_DEPRECATED_N_SPECIFIER``
- macro.
- * The ``'='`` format specifier is now disabled by default for compatibility with
- ``std::format``. It can be enabled via the ``FMT_DEPRECATED_NUMERIC_ALIGN``
- macro.
- * Removed the following deprecated APIs:
- * ``FMT_STRING_ALIAS`` and ``fmt`` macros - replaced by ``FMT_STRING``
- * ``fmt::basic_string_view::char_type`` - replaced by
- ``fmt::basic_string_view::value_type``
- * ``convert_to_int``
- * ``format_arg_store::types``
- * ``*parse_context`` - replaced by ``*format_parse_context``
- * ``FMT_DEPRECATED_INCLUDE_OS``
- * ``FMT_DEPRECATED_PERCENT`` - incompatible with ``std::format``
- * ``*writer`` - replaced by compiled format API
- * Renamed the ``internal`` namespace to ``detail``
- (`#1538 <https://github.com/fmtlib/fmt/issues/1538>`_). The former is still
- provided as an alias if the ``FMT_USE_INTERNAL`` macro is defined.
- * Improved compatibility between ``fmt::printf`` with the standard specs
- (`#1595 <https://github.com/fmtlib/fmt/issues/1595>`_,
- `#1682 <https://github.com/fmtlib/fmt/pull/1682>`_,
- `#1683 <https://github.com/fmtlib/fmt/pull/1683>`_,
- `#1687 <https://github.com/fmtlib/fmt/pull/1687>`_,
- `#1699 <https://github.com/fmtlib/fmt/pull/1699>`_).
- Thanks `@rimathia <https://github.com/rimathia>`_.
- * Fixed handling of ``operator<<`` overloads that use ``copyfmt``
- (`#1666 <https://github.com/fmtlib/fmt/issues/1666>`_).
- * Added the ``FMT_OS`` CMake option to control inclusion of OS-specific APIs
- in the fmt target. This can be useful for embedded platforms
- (`#1654 <https://github.com/fmtlib/fmt/issues/1654>`_,
- `#1656 <https://github.com/fmtlib/fmt/pull/1656>`_).
- Thanks `@kwesolowski (Krzysztof Wesolowski)
- <https://github.com/kwesolowski>`_.
- * Replaced ``FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION`` with the ``FMT_FUZZ``
- macro to prevent interfering with fuzzing of projects using {fmt}
- (`#1650 <https://github.com/fmtlib/fmt/pull/1650>`_).
- Thanks `@asraa (Asra Ali) <https://github.com/asraa>`_.
- * Fixed compatibility with emscripten
- (`#1636 <https://github.com/fmtlib/fmt/issues/1636>`_,
- `#1637 <https://github.com/fmtlib/fmt/pull/1637>`_).
- Thanks `@ArthurSonzogni (Arthur Sonzogni)
- <https://github.com/ArthurSonzogni>`_.
- * Improved documentation
- (`#704 <https://github.com/fmtlib/fmt/issues/704>`_,
- `#1643 <https://github.com/fmtlib/fmt/pull/1643>`_,
- `#1660 <https://github.com/fmtlib/fmt/pull/1660>`_,
- `#1681 <https://github.com/fmtlib/fmt/pull/1681>`_,
- `#1691 <https://github.com/fmtlib/fmt/pull/1691>`_,
- `#1706 <https://github.com/fmtlib/fmt/pull/1706>`_,
- `#1714 <https://github.com/fmtlib/fmt/pull/1714>`_,
- `#1721 <https://github.com/fmtlib/fmt/pull/1721>`_,
- `#1739 <https://github.com/fmtlib/fmt/pull/1739>`_,
- `#1740 <https://github.com/fmtlib/fmt/pull/1740>`_,
- `#1741 <https://github.com/fmtlib/fmt/pull/1741>`_,
- `#1751 <https://github.com/fmtlib/fmt/pull/1751>`_).
- Thanks `@senior7515 (Alexander Gallego) <https://github.com/senior7515>`_,
- `@lsr0 (Lindsay Roberts) <https://github.com/lsr0>`_,
- `@puetzk (Kevin Puetz) <https://github.com/puetzk>`_,
- `@fpelliccioni (Fernando Pelliccioni) <https://github.com/fpelliccioni>`_,
- Alexey Kuzmenko, `@jelly (jelle van der Waa) <https://github.com/jelly>`_,
- `@claremacrae (Clare Macrae) <https://github.com/claremacrae>`_,
- `@jiapengwen (文佳鹏) <https://github.com/jiapengwen>`_,
- `@gsjaardema (Greg Sjaardema) <https://github.com/gsjaardema>`_,
- `@alexey-milovidov <https://github.com/alexey-milovidov>`_.
- * Implemented various build configuration fixes and improvements
- (`#1603 <https://github.com/fmtlib/fmt/pull/1603>`_,
- `#1657 <https://github.com/fmtlib/fmt/pull/1657>`_,
- `#1702 <https://github.com/fmtlib/fmt/pull/1702>`_,
- `#1728 <https://github.com/fmtlib/fmt/pull/1728>`_).
- Thanks `@scramsby (Scott Ramsby) <https://github.com/scramsby>`_,
- `@jtojnar (Jan Tojnar) <https://github.com/jtojnar>`_,
- `@orivej (Orivej Desh) <https://github.com/orivej>`_,
- `@flagarde <https://github.com/flagarde>`_.
- * Fixed various warnings and compilation issues
- (`#1616 <https://github.com/fmtlib/fmt/pull/1616>`_,
- `#1620 <https://github.com/fmtlib/fmt/issues/1620>`_,
- `#1622 <https://github.com/fmtlib/fmt/issues/1622>`_,
- `#1625 <https://github.com/fmtlib/fmt/issues/1625>`_,
- `#1627 <https://github.com/fmtlib/fmt/pull/1627>`_,
- `#1628 <https://github.com/fmtlib/fmt/issues/1628>`_,
- `#1629 <https://github.com/fmtlib/fmt/pull/1629>`_,
- `#1631 <https://github.com/fmtlib/fmt/issues/1631>`_,
- `#1633 <https://github.com/fmtlib/fmt/pull/1633>`_,
- `#1649 <https://github.com/fmtlib/fmt/pull/1649>`_,
- `#1658 <https://github.com/fmtlib/fmt/issues/1658>`_,
- `#1661 <https://github.com/fmtlib/fmt/pull/1661>`_,
- `#1667 <https://github.com/fmtlib/fmt/pull/1667>`_,
- `#1668 <https://github.com/fmtlib/fmt/issues/1668>`_,
- `#1669 <https://github.com/fmtlib/fmt/pull/1669>`_,
- `#1692 <https://github.com/fmtlib/fmt/issues/1692>`_,
- `#1696 <https://github.com/fmtlib/fmt/pull/1696>`_,
- `#1697 <https://github.com/fmtlib/fmt/pull/1697>`_,
- `#1707 <https://github.com/fmtlib/fmt/issues/1707>`_,
- `#1712 <https://github.com/fmtlib/fmt/pull/1712>`_,
- `#1716 <https://github.com/fmtlib/fmt/pull/1716>`_,
- `#1722 <https://github.com/fmtlib/fmt/pull/1722>`_,
- `#1724 <https://github.com/fmtlib/fmt/issues/1724>`_,
- `#1729 <https://github.com/fmtlib/fmt/pull/1729>`_,
- `#1738 <https://github.com/fmtlib/fmt/pull/1738>`_,
- `#1742 <https://github.com/fmtlib/fmt/issues/1742>`_,
- `#1743 <https://github.com/fmtlib/fmt/issues/1743>`_,
- `#1744 <https://github.com/fmtlib/fmt/pull/1744>`_,
- `#1747 <https://github.com/fmtlib/fmt/issues/1747>`_,
- `#1750 <https://github.com/fmtlib/fmt/pull/1750>`_).
- Thanks `@gsjaardema (Greg Sjaardema) <https://github.com/gsjaardema>`_,
- `@gabime (Gabi Melman) <https://github.com/gabime>`_,
- `@johnor (Johan) <https://github.com/johnor>`_,
- `@Kurkin (Dmitry Kurkin) <https://github.com/Kurkin>`_,
- `@invexed (James Beach) <https://github.com/invexed>`_,
- `@peterbell10 <https://github.com/peterbell10>`_,
- `@daixtrose (Markus Werle) <https://github.com/daixtrose>`_,
- `@petrutlucian94 (Lucian Petrut) <https://github.com/petrutlucian94>`_,
- `@Neargye (Daniil Goncharov) <https://github.com/Neargye>`_,
- `@ambitslix (Attila M. Szilagyi) <https://github.com/ambitslix>`_,
- `@gabime (Gabi Melman) <https://github.com/gabime>`_,
- `@erthink (Leonid Yuriev) <https://github.com/erthink>`_,
- `@tohammer (Tobias Hammer) <https://github.com/tohammer>`_,
- `@0x8000-0000 (Florin Iucha) <https://github.com/0x8000-0000>`_.
- 6.2.1 - 2020-05-09
- ------------------
- * Fixed ostream support in ``sprintf``
- (`#1631 <https://github.com/fmtlib/fmt/issues/1631>`_).
- * Fixed type detection when using implicit conversion to ``string_view`` and
- ostream ``operator<<`` inconsistently
- (`#1662 <https://github.com/fmtlib/fmt/issues/1662>`_).
- 6.2.0 - 2020-04-05
- ------------------
- * Improved error reporting when trying to format an object of a non-formattable
- type:
- .. code:: c++
- fmt::format("{}", S());
- now gives::
- include/fmt/core.h:1015:5: error: static_assert failed due to requirement
- 'formattable' "Cannot format argument. To make type T formattable provide a
- formatter<T> specialization:
- https://fmt.dev/latest/api.html#formatting-user-defined-types"
- static_assert(
- ^
- ...
- note: in instantiation of function template specialization
- 'fmt::v6::format<char [3], S, char>' requested here
- fmt::format("{}", S());
- ^
- if ``S`` is not formattable.
- * Reduced the library size by ~10%.
- * Always print decimal point if ``#`` is specified
- (`#1476 <https://github.com/fmtlib/fmt/issues/1476>`_,
- `#1498 <https://github.com/fmtlib/fmt/issues/1498>`_):
- .. code:: c++
- fmt::print("{:#.0f}", 42.0);
- now prints ``42.``
- * Implemented the ``'L'`` specifier for locale-specific numeric formatting to
- improve compatibility with ``std::format``. The ``'n'`` specifier is now
- deprecated and will be removed in the next major release.
- * Moved OS-specific APIs such as ``windows_error`` from ``fmt/format.h`` to
- ``fmt/os.h``. You can define ``FMT_DEPRECATED_INCLUDE_OS`` to automatically
- include ``fmt/os.h`` from ``fmt/format.h`` for compatibility but this will be
- disabled in the next major release.
- * Added precision overflow detection in floating-point formatting.
- * Implemented detection of invalid use of ``fmt::arg``.
- * Used ``type_identity`` to block unnecessary template argument deduction.
- Thanks Tim Song.
- * Improved UTF-8 handling
- (`#1109 <https://github.com/fmtlib/fmt/issues/1109>`_):
- .. code:: c++
- fmt::print("┌{0:─^{2}}┐\n"
- "│{1: ^{2}}│\n"
- "└{0:─^{2}}┘\n", "", "Привет, мир!", 20);
- now prints::
- ┌────────────────────┐
- │ Привет, мир! │
- └────────────────────┘
- on systems that support Unicode.
- * Added experimental dynamic argument storage
- (`#1170 <https://github.com/fmtlib/fmt/issues/1170>`_,
- `#1584 <https://github.com/fmtlib/fmt/pull/1584>`_):
- .. code:: c++
- fmt::dynamic_format_arg_store<fmt::format_context> store;
- store.push_back("answer");
- store.push_back(42);
- fmt::vprint("The {} is {}.\n", store);
-
- prints::
- The answer is 42.
- Thanks `@vsolontsov-ll (Vladimir Solontsov)
- <https://github.com/vsolontsov-ll>`_.
- * Made ``fmt::join`` accept ``initializer_list``
- (`#1591 <https://github.com/fmtlib/fmt/pull/1591>`_).
- Thanks `@Rapotkinnik (Nikolay Rapotkin) <https://github.com/Rapotkinnik>`_.
- * Fixed handling of empty tuples
- (`#1588 <https://github.com/fmtlib/fmt/issues/1588>`_).
- * Fixed handling of output iterators in ``format_to_n``
- (`#1506 <https://github.com/fmtlib/fmt/issues/1506>`_).
- * Fixed formatting of ``std::chrono::duration`` types to wide output
- (`#1533 <https://github.com/fmtlib/fmt/pull/1533>`_).
- Thanks `@zeffy (pilao) <https://github.com/zeffy>`_.
- * Added const ``begin`` and ``end`` overload to buffers
- (`#1553 <https://github.com/fmtlib/fmt/pull/1553>`_).
- Thanks `@dominicpoeschko <https://github.com/dominicpoeschko>`_.
- * Added the ability to disable floating-point formatting via ``FMT_USE_FLOAT``,
- ``FMT_USE_DOUBLE`` and ``FMT_USE_LONG_DOUBLE`` macros for extremely
- memory-constrained embedded system
- (`#1590 <https://github.com/fmtlib/fmt/pull/1590>`_).
- Thanks `@albaguirre (Alberto Aguirre) <https://github.com/albaguirre>`_.
- * Made ``FMT_STRING`` work with ``constexpr`` ``string_view``
- (`#1589 <https://github.com/fmtlib/fmt/pull/1589>`_).
- Thanks `@scramsby (Scott Ramsby) <https://github.com/scramsby>`_.
- * Implemented a minor optimization in the format string parser
- (`#1560 <https://github.com/fmtlib/fmt/pull/1560>`_).
- Thanks `@IkarusDeveloper <https://github.com/IkarusDeveloper>`_.
- * Improved attribute detection
- (`#1469 <https://github.com/fmtlib/fmt/pull/1469>`_,
- `#1475 <https://github.com/fmtlib/fmt/pull/1475>`_,
- `#1576 <https://github.com/fmtlib/fmt/pull/1576>`_).
- Thanks `@federico-busato (Federico) <https://github.com/federico-busato>`_,
- `@chronoxor (Ivan Shynkarenka) <https://github.com/chronoxor>`_,
- `@refnum <https://github.com/refnum>`_.
- * Improved documentation
- (`#1481 <https://github.com/fmtlib/fmt/pull/1481>`_,
- `#1523 <https://github.com/fmtlib/fmt/pull/1523>`_).
- Thanks `@JackBoosY (Jack·Boos·Yu) <https://github.com/JackBoosY>`_,
- `@imba-tjd (谭九鼎) <https://github.com/imba-tjd>`_.
- * Fixed symbol visibility on Linux when compiling with ``-fvisibility=hidden``
- (`#1535 <https://github.com/fmtlib/fmt/pull/1535>`_).
- Thanks `@milianw (Milian Wolff) <https://github.com/milianw>`_.
- * Implemented various build configuration fixes and improvements
- (`#1264 <https://github.com/fmtlib/fmt/issues/1264>`_,
- `#1460 <https://github.com/fmtlib/fmt/issues/1460>`_,
- `#1534 <https://github.com/fmtlib/fmt/pull/1534>`_,
- `#1536 <https://github.com/fmtlib/fmt/issues/1536>`_,
- `#1545 <https://github.com/fmtlib/fmt/issues/1545>`_,
- `#1546 <https://github.com/fmtlib/fmt/pull/1546>`_,
- `#1566 <https://github.com/fmtlib/fmt/issues/1566>`_,
- `#1582 <https://github.com/fmtlib/fmt/pull/1582>`_,
- `#1597 <https://github.com/fmtlib/fmt/issues/1597>`_,
- `#1598 <https://github.com/fmtlib/fmt/pull/1598>`_).
- Thanks `@ambitslix (Attila M. Szilagyi) <https://github.com/ambitslix>`_,
- `@jwillikers (Jordan Williams) <https://github.com/jwillikers>`_,
- `@stac47 (Laurent Stacul) <https://github.com/stac47>`_.
- * Fixed various warnings and compilation issues
- (`#1433 <https://github.com/fmtlib/fmt/pull/1433>`_,
- `#1461 <https://github.com/fmtlib/fmt/issues/1461>`_,
- `#1470 <https://github.com/fmtlib/fmt/pull/1470>`_,
- `#1480 <https://github.com/fmtlib/fmt/pull/1480>`_,
- `#1485 <https://github.com/fmtlib/fmt/pull/1485>`_,
- `#1492 <https://github.com/fmtlib/fmt/pull/1492>`_,
- `#1493 <https://github.com/fmtlib/fmt/issues/1493>`_,
- `#1504 <https://github.com/fmtlib/fmt/issues/1504>`_,
- `#1505 <https://github.com/fmtlib/fmt/pull/1505>`_,
- `#1512 <https://github.com/fmtlib/fmt/pull/1512>`_,
- `#1515 <https://github.com/fmtlib/fmt/issues/1515>`_,
- `#1516 <https://github.com/fmtlib/fmt/pull/1516>`_,
- `#1518 <https://github.com/fmtlib/fmt/pull/1518>`_,
- `#1519 <https://github.com/fmtlib/fmt/pull/1519>`_,
- `#1520 <https://github.com/fmtlib/fmt/pull/1520>`_,
- `#1521 <https://github.com/fmtlib/fmt/pull/1521>`_,
- `#1522 <https://github.com/fmtlib/fmt/pull/1522>`_,
- `#1524 <https://github.com/fmtlib/fmt/issues/1524>`_,
- `#1530 <https://github.com/fmtlib/fmt/pull/1530>`_,
- `#1531 <https://github.com/fmtlib/fmt/issues/1531>`_,
- `#1532 <https://github.com/fmtlib/fmt/pull/1532>`_,
- `#1539 <https://github.com/fmtlib/fmt/issues/1539>`_,
- `#1547 <https://github.com/fmtlib/fmt/issues/1547>`_,
- `#1548 <https://github.com/fmtlib/fmt/issues/1548>`_,
- `#1554 <https://github.com/fmtlib/fmt/pull/1554>`_,
- `#1567 <https://github.com/fmtlib/fmt/issues/1567>`_,
- `#1568 <https://github.com/fmtlib/fmt/pull/1568>`_,
- `#1569 <https://github.com/fmtlib/fmt/pull/1569>`_,
- `#1571 <https://github.com/fmtlib/fmt/pull/1571>`_,
- `#1573 <https://github.com/fmtlib/fmt/pull/1573>`_,
- `#1575 <https://github.com/fmtlib/fmt/pull/1575>`_,
- `#1581 <https://github.com/fmtlib/fmt/pull/1581>`_,
- `#1583 <https://github.com/fmtlib/fmt/issues/1583>`_,
- `#1586 <https://github.com/fmtlib/fmt/issues/1586>`_,
- `#1587 <https://github.com/fmtlib/fmt/issues/1587>`_,
- `#1594 <https://github.com/fmtlib/fmt/issues/1594>`_,
- `#1596 <https://github.com/fmtlib/fmt/pull/1596>`_,
- `#1604 <https://github.com/fmtlib/fmt/issues/1604>`_,
- `#1606 <https://github.com/fmtlib/fmt/pull/1606>`_,
- `#1607 <https://github.com/fmtlib/fmt/issues/1607>`_,
- `#1609 <https://github.com/fmtlib/fmt/issues/1609>`_).
- Thanks `@marti4d (Chris Martin) <https://github.com/marti4d>`_,
- `@iPherian <https://github.com/iPherian>`_,
- `@parkertomatoes <https://github.com/parkertomatoes>`_,
- `@gsjaardema (Greg Sjaardema) <https://github.com/gsjaardema>`_,
- `@chronoxor (Ivan Shynkarenka) <https://github.com/chronoxor>`_,
- `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_,
- `@torsten48 <https://github.com/torsten48>`_,
- `@tohammer (Tobias Hammer) <https://github.com/tohammer>`_,
- `@lefticus (Jason Turner) <https://github.com/lefticus>`_,
- `@ryusakki (Haise) <https://github.com/ryusakki>`_,
- `@adnsv (Alex Denisov) <https://github.com/adnsv>`_,
- `@fghzxm <https://github.com/fghzxm>`_,
- `@refnum <https://github.com/refnum>`_,
- `@pramodk (Pramod Kumbhar) <https://github.com/pramodk>`_,
- `@Spirrwell <https://github.com/Spirrwell>`_,
- `@scramsby (Scott Ramsby) <https://github.com/scramsby>`_.
- 6.1.2 - 2019-12-11
- ------------------
- * Fixed ABI compatibility with ``libfmt.so.6.0.0``
- (`#1471 <https://github.com/fmtlib/fmt/issues/1471>`_).
- * Fixed handling types convertible to ``std::string_view``
- (`#1451 <https://github.com/fmtlib/fmt/pull/1451>`_).
- Thanks `@denizevrenci (Deniz Evrenci) <https://github.com/denizevrenci>`_.
- * Made CUDA test an opt-in enabled via the ``FMT_CUDA_TEST`` CMake option.
- * Fixed sign conversion warnings
- (`#1440 <https://github.com/fmtlib/fmt/pull/1440>`_).
- Thanks `@0x8000-0000 (Florin Iucha) <https://github.com/0x8000-0000>`_.
- 6.1.1 - 2019-12-04
- ------------------
- * Fixed shared library build on Windows
- (`#1443 <https://github.com/fmtlib/fmt/pull/1443>`_,
- `#1445 <https://github.com/fmtlib/fmt/issues/1445>`_,
- `#1446 <https://github.com/fmtlib/fmt/pull/1446>`_,
- `#1450 <https://github.com/fmtlib/fmt/issues/1450>`_).
- Thanks `@egorpugin (Egor Pugin) <https://github.com/egorpugin>`_,
- `@bbolli (Beat Bolli) <https://github.com/bbolli>`_.
- * Added a missing decimal point in exponent notation with trailing zeros.
- * Removed deprecated ``format_arg_store::TYPES``.
- 6.1.0 - 2019-12-01
- ------------------
- * {fmt} now formats IEEE 754 ``float`` and ``double`` using the shortest decimal
- representation with correct rounding by default:
- .. code:: c++
- #include <cmath>
- #include <fmt/core.h>
- int main() {
- fmt::print("{}", M_PI);
- }
- prints ``3.141592653589793``.
- * Made the fast binary to decimal floating-point formatter the default,
- simplified it and improved performance. {fmt} is now 15 times faster than
- libc++'s ``std::ostringstream``, 11 times faster than ``printf`` and 10%
- faster than double-conversion on `dtoa-benchmark
- <https://github.com/fmtlib/dtoa-benchmark>`_:
- ================== ========= =======
- Function Time (ns) Speedup
- ================== ========= =======
- ostringstream 1,346.30 1.00x
- ostrstream 1,195.74 1.13x
- sprintf 995.08 1.35x
- doubleconv 99.10 13.59x
- fmt 88.34 15.24x
- ================== ========= =======
- .. image:: https://user-images.githubusercontent.com/576385/
- 69767160-cdaca400-112f-11ea-9fc5-347c9f83caad.png
- * {fmt} no longer converts ``float`` arguments to ``double``. In particular this
- improves the default (shortest) representation of floats and makes
- ``fmt::format`` consistent with ``std::format`` specs
- (`#1336 <https://github.com/fmtlib/fmt/issues/1336>`_,
- `#1353 <https://github.com/fmtlib/fmt/issues/1353>`_,
- `#1360 <https://github.com/fmtlib/fmt/pull/1360>`_,
- `#1361 <https://github.com/fmtlib/fmt/pull/1361>`_):
- .. code:: c++
- fmt::print("{}", 0.1f);
- prints ``0.1`` instead of ``0.10000000149011612``.
- Thanks `@orivej (Orivej Desh) <https://github.com/orivej>`_.
- * Made floating-point formatting output consistent with ``printf``/iostreams
- (`#1376 <https://github.com/fmtlib/fmt/issues/1376>`_,
- `#1417 <https://github.com/fmtlib/fmt/issues/1417>`_).
- * Added support for 128-bit integers
- (`#1287 <https://github.com/fmtlib/fmt/pull/1287>`_):
- .. code:: c++
- fmt::print("{}", std::numeric_limits<__int128_t>::max());
- prints ``170141183460469231731687303715884105727``.
- Thanks `@denizevrenci (Deniz Evrenci) <https://github.com/denizevrenci>`_.
- * The overload of ``print`` that takes ``text_style`` is now atomic, i.e. the
- output from different threads doesn't interleave
- (`#1351 <https://github.com/fmtlib/fmt/pull/1351>`_).
- Thanks `@tankiJong (Tanki Zhang) <https://github.com/tankiJong>`_.
- * Made compile time in the header-only mode ~20% faster by reducing the number
- of template instantiations. ``wchar_t`` overload of ``vprint`` was moved from
- ``fmt/core.h`` to ``fmt/format.h``.
- * Added an overload of ``fmt::join`` that works with tuples
- (`#1322 <https://github.com/fmtlib/fmt/issues/1322>`_,
- `#1330 <https://github.com/fmtlib/fmt/pull/1330>`_):
- .. code:: c++
- #include <tuple>
- #include <fmt/ranges.h>
- int main() {
- std::tuple<char, int, float> t{'a', 1, 2.0f};
- fmt::print("{}", t);
- }
- prints ``('a', 1, 2.0)``.
- Thanks `@jeremyong (Jeremy Ong) <https://github.com/jeremyong>`_.
- * Changed formatting of octal zero with prefix from "00" to "0":
- .. code:: c++
- fmt::print("{:#o}", 0);
- prints ``0``.
- * The locale is now passed to ostream insertion (``<<``) operators
- (`#1406 <https://github.com/fmtlib/fmt/pull/1406>`_):
- .. code:: c++
- #include <fmt/locale.h>
- #include <fmt/ostream.h>
- struct S {
- double value;
- };
- std::ostream& operator<<(std::ostream& os, S s) {
- return os << s.value;
- }
- int main() {
- auto s = fmt::format(std::locale("fr_FR.UTF-8"), "{}", S{0.42});
- // s == "0,42"
- }
- Thanks `@dlaugt (Daniel Laügt) <https://github.com/dlaugt>`_.
- * Locale-specific number formatting now uses grouping
- (`#1393 <https://github.com/fmtlib/fmt/issues/1393>`_
- `#1394 <https://github.com/fmtlib/fmt/pull/1394>`_).
- Thanks `@skrdaniel <https://github.com/skrdaniel>`_.
- * Fixed handling of types with deleted implicit rvalue conversion to
- ``const char**`` (`#1421 <https://github.com/fmtlib/fmt/issues/1421>`_):
- .. code:: c++
- struct mystring {
- operator const char*() const&;
- operator const char*() &;
- operator const char*() const&& = delete;
- operator const char*() && = delete;
- };
- mystring str;
- fmt::print("{}", str); // now compiles
- * Enums are now mapped to correct underlying types instead of ``int``
- (`#1286 <https://github.com/fmtlib/fmt/pull/1286>`_).
- Thanks `@agmt (Egor Seredin) <https://github.com/agmt>`_.
- * Enum classes are no longer implicitly converted to ``int``
- (`#1424 <https://github.com/fmtlib/fmt/issues/1424>`_).
- * Added ``basic_format_parse_context`` for consistency with C++20
- ``std::format`` and deprecated ``basic_parse_context``.
- * Fixed handling of UTF-8 in precision
- (`#1389 <https://github.com/fmtlib/fmt/issues/1389>`_,
- `#1390 <https://github.com/fmtlib/fmt/pull/1390>`_).
- Thanks `@tajtiattila (Attila Tajti) <https://github.com/tajtiattila>`_.
- * {fmt} can now be installed on Linux, macOS and Windows with
- `Conda <https://docs.conda.io/en/latest/>`__ using its
- `conda-forge <https://conda-forge.org>`__
- `package <https://github.com/conda-forge/fmt-feedstock>`__
- (`#1410 <https://github.com/fmtlib/fmt/pull/1410>`_)::
- conda install -c conda-forge fmt
- Thanks `@tdegeus (Tom de Geus) <https://github.com/tdegeus>`_.
- * Added a CUDA test (`#1285 <https://github.com/fmtlib/fmt/pull/1285>`_,
- `#1317 <https://github.com/fmtlib/fmt/pull/1317>`_).
- Thanks `@luncliff (Park DongHa) <https://github.com/luncliff>`_ and
- `@risa2000 <https://github.com/risa2000>`_.
- * Improved documentation (`#1276 <https://github.com/fmtlib/fmt/pull/1276>`_,
- `#1291 <https://github.com/fmtlib/fmt/issues/1291>`_,
- `#1296 <https://github.com/fmtlib/fmt/issues/1296>`_,
- `#1315 <https://github.com/fmtlib/fmt/pull/1315>`_,
- `#1332 <https://github.com/fmtlib/fmt/pull/1332>`_,
- `#1337 <https://github.com/fmtlib/fmt/pull/1337>`_,
- `#1395 <https://github.com/fmtlib/fmt/issues/1395>`_
- `#1418 <https://github.com/fmtlib/fmt/pull/1418>`_).
- Thanks
- `@waywardmonkeys (Bruce Mitchener) <https://github.com/waywardmonkeys>`_,
- `@pauldreik (Paul Dreik) <https://github.com/pauldreik>`_,
- `@jackoalan (Jack Andersen) <https://github.com/jackoalan>`_.
- * Various code improvements
- (`#1358 <https://github.com/fmtlib/fmt/pull/1358>`_,
- `#1407 <https://github.com/fmtlib/fmt/pull/1407>`_).
- Thanks `@orivej (Orivej Desh) <https://github.com/orivej>`_,
- `@dpacbach (David P. Sicilia) <https://github.com/dpacbach>`_,
- * Fixed compile-time format string checks for user-defined types
- (`#1292 <https://github.com/fmtlib/fmt/issues/1292>`_).
- * Worked around a false positive in ``unsigned-integer-overflow`` sanitizer
- (`#1377 <https://github.com/fmtlib/fmt/issues/1377>`_).
- * Fixed various warnings and compilation issues
- (`#1273 <https://github.com/fmtlib/fmt/issues/1273>`_,
- `#1278 <https://github.com/fmtlib/fmt/pull/1278>`_,
- `#1280 <https://github.com/fmtlib/fmt/pull/1280>`_,
- `#1281 <https://github.com/fmtlib/fmt/issues/1281>`_,
- `#1288 <https://github.com/fmtlib/fmt/issues/1288>`_,
- `#1290 <https://github.com/fmtlib/fmt/pull/1290>`_,
- `#1301 <https://github.com/fmtlib/fmt/pull/1301>`_,
- `#1305 <https://github.com/fmtlib/fmt/issues/1305>`_,
- `#1306 <https://github.com/fmtlib/fmt/issues/1306>`_,
- `#1309 <https://github.com/fmtlib/fmt/issues/1309>`_,
- `#1312 <https://github.com/fmtlib/fmt/pull/1312>`_,
- `#1313 <https://github.com/fmtlib/fmt/issues/1313>`_,
- `#1316 <https://github.com/fmtlib/fmt/issues/1316>`_,
- `#1319 <https://github.com/fmtlib/fmt/issues/1319>`_,
- `#1320 <https://github.com/fmtlib/fmt/pull/1320>`_,
- `#1326 <https://github.com/fmtlib/fmt/pull/1326>`_,
- `#1328 <https://github.com/fmtlib/fmt/pull/1328>`_,
- `#1344 <https://github.com/fmtlib/fmt/issues/1344>`_,
- `#1345 <https://github.com/fmtlib/fmt/pull/1345>`_,
- `#1347 <https://github.com/fmtlib/fmt/pull/1347>`_,
- `#1349 <https://github.com/fmtlib/fmt/pull/1349>`_,
- `#1354 <https://github.com/fmtlib/fmt/issues/1354>`_,
- `#1362 <https://github.com/fmtlib/fmt/issues/1362>`_,
- `#1366 <https://github.com/fmtlib/fmt/issues/1366>`_,
- `#1364 <https://github.com/fmtlib/fmt/pull/1364>`_,
- `#1370 <https://github.com/fmtlib/fmt/pull/1370>`_,
- `#1371 <https://github.com/fmtlib/fmt/pull/1371>`_,
- `#1385 <https://github.com/fmtlib/fmt/issues/1385>`_,
- `#1388 <https://github.com/fmtlib/fmt/issues/1388>`_,
- `#1397 <https://github.com/fmtlib/fmt/pull/1397>`_,
- `#1414 <https://github.com/fmtlib/fmt/pull/1414>`_,
- `#1416 <https://github.com/fmtlib/fmt/pull/1416>`_,
- `#1422 <https://github.com/fmtlib/fmt/issues/1422>`_
- `#1427 <https://github.com/fmtlib/fmt/pull/1427>`_,
- `#1431 <https://github.com/fmtlib/fmt/issues/1431>`_,
- `#1433 <https://github.com/fmtlib/fmt/pull/1433>`_).
- Thanks `@hhb <https://github.com/hhb>`_,
- `@gsjaardema (Greg Sjaardema) <https://github.com/gsjaardema>`_,
- `@gabime (Gabi Melman) <https://github.com/gabime>`_,
- `@neheb (Rosen Penev) <https://github.com/neheb>`_,
- `@vedranmiletic (Vedran Miletić) <https://github.com/vedranmiletic>`_,
- `@dkavolis (Daumantas Kavolis) <https://github.com/dkavolis>`_,
- `@mwinterb <https://github.com/mwinterb>`_,
- `@orivej (Orivej Desh) <https://github.com/orivej>`_,
- `@denizevrenci (Deniz Evrenci) <https://github.com/denizevrenci>`_
- `@leonklingele <https://github.com/leonklingele>`_,
- `@chronoxor (Ivan Shynkarenka) <https://github.com/chronoxor>`_,
- `@kent-tri <https://github.com/kent-tri>`_,
- `@0x8000-0000 (Florin Iucha) <https://github.com/0x8000-0000>`_,
- `@marti4d (Chris Martin) <https://github.com/marti4d>`_.
- 6.0.0 - 2019-08-26
- ------------------
- * Switched to the `MIT license
- <https://github.com/fmtlib/fmt/blob/5a4b24613ba16cc689977c3b5bd8274a3ba1dd1f/LICENSE.rst>`_
- with an optional exception that allows distributing binary code without
- attribution.
- * Floating-point formatting is now locale-independent by default:
- .. code:: c++
- #include <locale>
- #include <fmt/core.h>
- int main() {
- std::locale::global(std::locale("ru_RU.UTF-8"));
- fmt::print("value = {}", 4.2);
- }
- prints "value = 4.2" regardless of the locale.
- For locale-specific formatting use the ``n`` specifier:
- .. code:: c++
- std::locale::global(std::locale("ru_RU.UTF-8"));
- fmt::print("value = {:n}", 4.2);
- prints "value = 4,2".
- * Added an experimental Grisu floating-point formatting algorithm
- implementation (disabled by default). To enable it compile with the
- ``FMT_USE_GRISU`` macro defined to 1:
- .. code:: c++
- #define FMT_USE_GRISU 1
- #include <fmt/format.h>
- auto s = fmt::format("{}", 4.2); // formats 4.2 using Grisu
- With Grisu enabled, {fmt} is 13x faster than ``std::ostringstream`` (libc++)
- and 10x faster than ``sprintf`` on `dtoa-benchmark
- <https://github.com/fmtlib/dtoa-benchmark>`_ (`full results
- <https://fmt.dev/unknown_mac64_clang10.0.html>`_):
- .. image:: https://user-images.githubusercontent.com/576385/
- 54883977-9fe8c000-4e28-11e9-8bde-272d122e7c52.jpg
- * Separated formatting and parsing contexts for consistency with
- `C++20 std::format <http://eel.is/c++draft/format>`_, removing the
- undocumented ``basic_format_context::parse_context()`` function.
- * Added `oss-fuzz <https://github.com/google/oss-fuzz>`_ support
- (`#1199 <https://github.com/fmtlib/fmt/pull/1199>`_).
- Thanks `@pauldreik (Paul Dreik) <https://github.com/pauldreik>`_.
- * ``formatter`` specializations now always take precedence over ``operator<<``
- (`#952 <https://github.com/fmtlib/fmt/issues/952>`_):
- .. code:: c++
- #include <iostream>
- #include <fmt/ostream.h>
- struct S {};
- std::ostream& operator<<(std::ostream& os, S) {
- return os << 1;
- }
- template <>
- struct fmt::formatter<S> : fmt::formatter<int> {
- auto format(S, format_context& ctx) {
- return formatter<int>::format(2, ctx);
- }
- };
- int main() {
- std::cout << S() << "\n"; // prints 1 using operator<<
- fmt::print("{}\n", S()); // prints 2 using formatter
- }
- * Introduced the experimental ``fmt::compile`` function that does format string
- compilation (`#618 <https://github.com/fmtlib/fmt/issues/618>`_,
- `#1169 <https://github.com/fmtlib/fmt/issues/1169>`_,
- `#1171 <https://github.com/fmtlib/fmt/pull/1171>`_):
- .. code:: c++
- #include <fmt/compile.h>
- auto f = fmt::compile<int>("{}");
- std::string s = fmt::format(f, 42); // can be called multiple times to
- // format different values
- // s == "42"
- It moves the cost of parsing a format string outside of the format function
- which can be beneficial when identically formatting many objects of the same
- types. Thanks `@stryku (Mateusz Janek) <https://github.com/stryku>`_.
- * Added experimental ``%`` format specifier that formats floating-point values
- as percentages (`#1060 <https://github.com/fmtlib/fmt/pull/1060>`_,
- `#1069 <https://github.com/fmtlib/fmt/pull/1069>`_,
- `#1071 <https://github.com/fmtlib/fmt/pull/1071>`_):
- .. code:: c++
- auto s = fmt::format("{:.1%}", 0.42); // s == "42.0%"
- Thanks `@gawain-bolton (Gawain Bolton) <https://github.com/gawain-bolton>`_.
- * Implemented precision for floating-point durations
- (`#1004 <https://github.com/fmtlib/fmt/issues/1004>`_,
- `#1012 <https://github.com/fmtlib/fmt/pull/1012>`_):
- .. code:: c++
- auto s = fmt::format("{:.1}", std::chrono::duration<double>(1.234));
- // s == 1.2s
- Thanks `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_.
- * Implemented ``chrono`` format specifiers ``%Q`` and ``%q`` that give the value
- and the unit respectively (`#1019 <https://github.com/fmtlib/fmt/pull/1019>`_):
- .. code:: c++
- auto value = fmt::format("{:%Q}", 42s); // value == "42"
- auto unit = fmt::format("{:%q}", 42s); // unit == "s"
- Thanks `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_.
- * Fixed handling of dynamic width in chrono formatter:
- .. code:: c++
- auto s = fmt::format("{0:{1}%H:%M:%S}", std::chrono::seconds(12345), 12);
- // ^ width argument index ^ width
- // s == "03:25:45 "
- Thanks Howard Hinnant.
- * Removed deprecated ``fmt/time.h``. Use ``fmt/chrono.h`` instead.
- * Added ``fmt::format`` and ``fmt::vformat`` overloads that take ``text_style``
- (`#993 <https://github.com/fmtlib/fmt/issues/993>`_,
- `#994 <https://github.com/fmtlib/fmt/pull/994>`_):
- .. code:: c++
- #include <fmt/color.h>
- std::string message = fmt::format(fmt::emphasis::bold | fg(fmt::color::red),
- "The answer is {}.", 42);
- Thanks `@Naios (Denis Blank) <https://github.com/Naios>`_.
- * Removed the deprecated color API (``print_colored``). Use the new API, namely
- ``print`` overloads that take ``text_style`` instead.
- * Made ``std::unique_ptr`` and ``std::shared_ptr`` formattable as pointers via
- ``fmt::ptr`` (`#1121 <https://github.com/fmtlib/fmt/pull/1121>`_):
- .. code:: c++
- std::unique_ptr<int> p = ...;
- fmt::print("{}", fmt::ptr(p)); // prints p as a pointer
- Thanks `@sighingnow (Tao He) <https://github.com/sighingnow>`_.
- * Made ``print`` and ``vprint`` report I/O errors
- (`#1098 <https://github.com/fmtlib/fmt/issues/1098>`_,
- `#1099 <https://github.com/fmtlib/fmt/pull/1099>`_).
- Thanks `@BillyDonahue (Billy Donahue) <https://github.com/BillyDonahue>`_.
- * Marked deprecated APIs with the ``[[deprecated]]`` attribute and removed
- internal uses of deprecated APIs
- (`#1022 <https://github.com/fmtlib/fmt/pull/1022>`_).
- Thanks `@eliaskosunen (Elias Kosunen) <https://github.com/eliaskosunen>`_.
- * Modernized the codebase using more C++11 features and removing workarounds.
- Most importantly, ``buffer_context`` is now an alias template, so
- use ``buffer_context<T>`` instead of ``buffer_context<T>::type``.
- These features require GCC 4.8 or later.
- * ``formatter`` specializations now always take precedence over implicit
- conversions to ``int`` and the undocumented ``convert_to_int`` trait
- is now deprecated.
- * Moved the undocumented ``basic_writer``, ``writer``, and ``wwriter`` types
- to the ``internal`` namespace.
- * Removed deprecated ``basic_format_context::begin()``. Use ``out()`` instead.
- * Disallowed passing the result of ``join`` as an lvalue to prevent misuse.
- * Refactored the undocumented structs that represent parsed format specifiers
- to simplify the API and allow multibyte fill.
- * Moved SFINAE to template parameters to reduce symbol sizes.
- * Switched to ``fputws`` for writing wide strings so that it's no longer
- required to call ``_setmode`` on Windows
- (`#1229 <https://github.com/fmtlib/fmt/issues/1229>`_,
- `#1243 <https://github.com/fmtlib/fmt/pull/1243>`_).
- Thanks `@jackoalan (Jack Andersen) <https://github.com/jackoalan>`_.
- * Improved literal-based API
- (`#1254 <https://github.com/fmtlib/fmt/pull/1254>`_).
- Thanks `@sylveon (Charles Milette) <https://github.com/sylveon>`_.
- * Added support for exotic platforms without ``uintptr_t`` such as IBM i
- (AS/400) which has 128-bit pointers and only 64-bit integers
- (`#1059 <https://github.com/fmtlib/fmt/issues/1059>`_).
- * Added `Sublime Text syntax highlighting config
- <https://github.com/fmtlib/fmt/blob/master/support/C%2B%2B.sublime-syntax>`_
- (`#1037 <https://github.com/fmtlib/fmt/issues/1037>`_).
- Thanks `@Kronuz (Germán Méndez Bravo) <https://github.com/Kronuz>`_.
- * Added the ``FMT_ENFORCE_COMPILE_STRING`` macro to enforce the use of
- compile-time format strings
- (`#1231 <https://github.com/fmtlib/fmt/pull/1231>`_).
- Thanks `@jackoalan (Jack Andersen) <https://github.com/jackoalan>`_.
- * Stopped setting ``CMAKE_BUILD_TYPE`` if {fmt} is a subproject
- (`#1081 <https://github.com/fmtlib/fmt/issues/1081>`_).
- * Various build improvements
- (`#1039 <https://github.com/fmtlib/fmt/pull/1039>`_,
- `#1078 <https://github.com/fmtlib/fmt/pull/1078>`_,
- `#1091 <https://github.com/fmtlib/fmt/pull/1091>`_,
- `#1103 <https://github.com/fmtlib/fmt/pull/1103>`_,
- `#1177 <https://github.com/fmtlib/fmt/pull/1177>`_).
- Thanks `@luncliff (Park DongHa) <https://github.com/luncliff>`_,
- `@jasonszang (Jason Shuo Zang) <https://github.com/jasonszang>`_,
- `@olafhering (Olaf Hering) <https://github.com/olafhering>`_,
- `@Lecetem <https://github.com/Lectem>`_,
- `@pauldreik (Paul Dreik) <https://github.com/pauldreik>`_.
- * Improved documentation
- (`#1049 <https://github.com/fmtlib/fmt/issues/1049>`_,
- `#1051 <https://github.com/fmtlib/fmt/pull/1051>`_,
- `#1083 <https://github.com/fmtlib/fmt/pull/1083>`_,
- `#1113 <https://github.com/fmtlib/fmt/pull/1113>`_,
- `#1114 <https://github.com/fmtlib/fmt/pull/1114>`_,
- `#1146 <https://github.com/fmtlib/fmt/issues/1146>`_,
- `#1180 <https://github.com/fmtlib/fmt/issues/1180>`_,
- `#1250 <https://github.com/fmtlib/fmt/pull/1250>`_,
- `#1252 <https://github.com/fmtlib/fmt/pull/1252>`_,
- `#1265 <https://github.com/fmtlib/fmt/pull/1265>`_).
- Thanks `@mikelui (Michael Lui) <https://github.com/mikelui>`_,
- `@foonathan (Jonathan Müller) <https://github.com/foonathan>`_,
- `@BillyDonahue (Billy Donahue) <https://github.com/BillyDonahue>`_,
- `@jwakely (Jonathan Wakely) <https://github.com/jwakely>`_,
- `@kaisbe (Kais Ben Salah) <https://github.com/kaisbe>`_,
- `@sdebionne (Samuel Debionne) <https://github.com/sdebionne>`_.
- * Fixed ambiguous formatter specialization in ``fmt/ranges.h``
- (`#1123 <https://github.com/fmtlib/fmt/issues/1123>`_).
- * Fixed formatting of a non-empty ``std::filesystem::path`` which is an
- infinitely deep range of its components
- (`#1268 <https://github.com/fmtlib/fmt/issues/1268>`_).
- * Fixed handling of general output iterators when formatting characters
- (`#1056 <https://github.com/fmtlib/fmt/issues/1056>`_,
- `#1058 <https://github.com/fmtlib/fmt/pull/1058>`_).
- Thanks `@abolz (Alexander Bolz) <https://github.com/abolz>`_.
- * Fixed handling of output iterators in ``formatter`` specialization for
- ranges (`#1064 <https://github.com/fmtlib/fmt/issues/1064>`_).
- * Fixed handling of exotic character types
- (`#1188 <https://github.com/fmtlib/fmt/issues/1188>`_).
- * Made chrono formatting work with exceptions disabled
- (`#1062 <https://github.com/fmtlib/fmt/issues/1062>`_).
- * Fixed DLL visibility issues
- (`#1134 <https://github.com/fmtlib/fmt/pull/1134>`_,
- `#1147 <https://github.com/fmtlib/fmt/pull/1147>`_).
- Thanks `@denchat <https://github.com/denchat>`_.
- * Disabled the use of UDL template extension on GCC 9
- (`#1148 <https://github.com/fmtlib/fmt/issues/1148>`_).
- * Removed misplaced ``format`` compile-time checks from ``printf``
- (`#1173 <https://github.com/fmtlib/fmt/issues/1173>`_).
- * Fixed issues in the experimental floating-point formatter
- (`#1072 <https://github.com/fmtlib/fmt/issues/1072>`_,
- `#1129 <https://github.com/fmtlib/fmt/issues/1129>`_,
- `#1153 <https://github.com/fmtlib/fmt/issues/1153>`_,
- `#1155 <https://github.com/fmtlib/fmt/pull/1155>`_,
- `#1210 <https://github.com/fmtlib/fmt/issues/1210>`_,
- `#1222 <https://github.com/fmtlib/fmt/issues/1222>`_).
- Thanks `@alabuzhev (Alex Alabuzhev) <https://github.com/alabuzhev>`_.
- * Fixed bugs discovered by fuzzing or during fuzzing integration
- (`#1124 <https://github.com/fmtlib/fmt/issues/1124>`_,
- `#1127 <https://github.com/fmtlib/fmt/issues/1127>`_,
- `#1132 <https://github.com/fmtlib/fmt/issues/1132>`_,
- `#1135 <https://github.com/fmtlib/fmt/pull/1135>`_,
- `#1136 <https://github.com/fmtlib/fmt/issues/1136>`_,
- `#1141 <https://github.com/fmtlib/fmt/issues/1141>`_,
- `#1142 <https://github.com/fmtlib/fmt/issues/1142>`_,
- `#1178 <https://github.com/fmtlib/fmt/issues/1178>`_,
- `#1179 <https://github.com/fmtlib/fmt/issues/1179>`_,
- `#1194 <https://github.com/fmtlib/fmt/issues/1194>`_).
- Thanks `@pauldreik (Paul Dreik) <https://github.com/pauldreik>`_.
- * Fixed building tests on FreeBSD and Hurd
- (`#1043 <https://github.com/fmtlib/fmt/issues/1043>`_).
- Thanks `@jackyf (Eugene V. Lyubimkin) <https://github.com/jackyf>`_.
- * Fixed various warnings and compilation issues
- (`#998 <https://github.com/fmtlib/fmt/pull/998>`_,
- `#1006 <https://github.com/fmtlib/fmt/pull/1006>`_,
- `#1008 <https://github.com/fmtlib/fmt/issues/1008>`_,
- `#1011 <https://github.com/fmtlib/fmt/issues/1011>`_,
- `#1025 <https://github.com/fmtlib/fmt/issues/1025>`_,
- `#1027 <https://github.com/fmtlib/fmt/pull/1027>`_,
- `#1028 <https://github.com/fmtlib/fmt/pull/1028>`_,
- `#1029 <https://github.com/fmtlib/fmt/pull/1029>`_,
- `#1030 <https://github.com/fmtlib/fmt/pull/1030>`_,
- `#1031 <https://github.com/fmtlib/fmt/pull/1031>`_,
- `#1054 <https://github.com/fmtlib/fmt/pull/1054>`_,
- `#1063 <https://github.com/fmtlib/fmt/issues/1063>`_,
- `#1068 <https://github.com/fmtlib/fmt/pull/1068>`_,
- `#1074 <https://github.com/fmtlib/fmt/pull/1074>`_,
- `#1075 <https://github.com/fmtlib/fmt/pull/1075>`_,
- `#1079 <https://github.com/fmtlib/fmt/pull/1079>`_,
- `#1086 <https://github.com/fmtlib/fmt/pull/1086>`_,
- `#1088 <https://github.com/fmtlib/fmt/issues/1088>`_,
- `#1089 <https://github.com/fmtlib/fmt/pull/1089>`_,
- `#1094 <https://github.com/fmtlib/fmt/pull/1094>`_,
- `#1101 <https://github.com/fmtlib/fmt/issues/1101>`_,
- `#1102 <https://github.com/fmtlib/fmt/pull/1102>`_,
- `#1105 <https://github.com/fmtlib/fmt/issues/1105>`_,
- `#1107 <https://github.com/fmtlib/fmt/pull/1107>`_,
- `#1115 <https://github.com/fmtlib/fmt/issues/1115>`_,
- `#1117 <https://github.com/fmtlib/fmt/issues/1117>`_,
- `#1118 <https://github.com/fmtlib/fmt/issues/1118>`_,
- `#1120 <https://github.com/fmtlib/fmt/issues/1120>`_,
- `#1123 <https://github.com/fmtlib/fmt/issues/1123>`_,
- `#1139 <https://github.com/fmtlib/fmt/pull/1139>`_,
- `#1140 <https://github.com/fmtlib/fmt/issues/1140>`_,
- `#1143 <https://github.com/fmtlib/fmt/issues/1143>`_,
- `#1144 <https://github.com/fmtlib/fmt/pull/1144>`_,
- `#1150 <https://github.com/fmtlib/fmt/pull/1150>`_,
- `#1151 <https://github.com/fmtlib/fmt/pull/1151>`_,
- `#1152 <https://github.com/fmtlib/fmt/issues/1152>`_,
- `#1154 <https://github.com/fmtlib/fmt/issues/1154>`_,
- `#1156 <https://github.com/fmtlib/fmt/issues/1156>`_,
- `#1159 <https://github.com/fmtlib/fmt/pull/1159>`_,
- `#1175 <https://github.com/fmtlib/fmt/issues/1175>`_,
- `#1181 <https://github.com/fmtlib/fmt/issues/1181>`_,
- `#1186 <https://github.com/fmtlib/fmt/issues/1186>`_,
- `#1187 <https://github.com/fmtlib/fmt/pull/1187>`_,
- `#1191 <https://github.com/fmtlib/fmt/pull/1191>`_,
- `#1197 <https://github.com/fmtlib/fmt/issues/1197>`_,
- `#1200 <https://github.com/fmtlib/fmt/issues/1200>`_,
- `#1203 <https://github.com/fmtlib/fmt/issues/1203>`_,
- `#1205 <https://github.com/fmtlib/fmt/issues/1205>`_,
- `#1206 <https://github.com/fmtlib/fmt/pull/1206>`_,
- `#1213 <https://github.com/fmtlib/fmt/issues/1213>`_,
- `#1214 <https://github.com/fmtlib/fmt/issues/1214>`_,
- `#1217 <https://github.com/fmtlib/fmt/pull/1217>`_,
- `#1228 <https://github.com/fmtlib/fmt/issues/1228>`_,
- `#1230 <https://github.com/fmtlib/fmt/pull/1230>`_,
- `#1232 <https://github.com/fmtlib/fmt/issues/1232>`_,
- `#1235 <https://github.com/fmtlib/fmt/pull/1235>`_,
- `#1236 <https://github.com/fmtlib/fmt/pull/1236>`_,
- `#1240 <https://github.com/fmtlib/fmt/issues/1240>`_).
- Thanks `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_,
- `@mwinterb <https://github.com/mwinterb>`_,
- `@eliaskosunen (Elias Kosunen) <https://github.com/eliaskosunen>`_,
- `@morinmorin <https://github.com/morinmorin>`_,
- `@ricco19 (Brian Ricciardelli) <https://github.com/ricco19>`_,
- `@waywardmonkeys (Bruce Mitchener) <https://github.com/waywardmonkeys>`_,
- `@chronoxor (Ivan Shynkarenka) <https://github.com/chronoxor>`_,
- `@remyabel <https://github.com/remyabel>`_,
- `@pauldreik (Paul Dreik) <https://github.com/pauldreik>`_,
- `@gsjaardema (Greg Sjaardema) <https://github.com/gsjaardema>`_,
- `@rcane (Ronny Krüger) <https://github.com/rcane>`_,
- `@mocabe <https://github.com/mocabe>`_,
- `@denchat <https://github.com/denchat>`_,
- `@cjdb (Christopher Di Bella) <https://github.com/cjdb>`_,
- `@HazardyKnusperkeks (Björn Schäpers) <https://github.com/HazardyKnusperkeks>`_,
- `@vedranmiletic (Vedran Miletić) <https://github.com/vedranmiletic>`_,
- `@jackoalan (Jack Andersen) <https://github.com/jackoalan>`_,
- `@DaanDeMeyer (Daan De Meyer) <https://github.com/DaanDeMeyer>`_,
- `@starkmapper (Mark Stapper) <https://github.com/starkmapper>`_.
- 5.3.0 - 2018-12-28
- ------------------
- * Introduced experimental chrono formatting support:
- .. code:: c++
- #include <fmt/chrono.h>
- int main() {
- using namespace std::literals::chrono_literals;
- fmt::print("Default format: {} {}\n", 42s, 100ms);
- fmt::print("strftime-like format: {:%H:%M:%S}\n", 3h + 15min + 30s);
- }
- prints::
- Default format: 42s 100ms
- strftime-like format: 03:15:30
- * Added experimental support for emphasis (bold, italic, underline,
- strikethrough), colored output to a file stream, and improved colored
- formatting API
- (`#961 <https://github.com/fmtlib/fmt/pull/961>`_,
- `#967 <https://github.com/fmtlib/fmt/pull/967>`_,
- `#973 <https://github.com/fmtlib/fmt/pull/973>`_):
- .. code:: c++
- #include <fmt/color.h>
- int main() {
- print(fg(fmt::color::crimson) | fmt::emphasis::bold,
- "Hello, {}!\n", "world");
- print(fg(fmt::color::floral_white) | bg(fmt::color::slate_gray) |
- fmt::emphasis::underline, "Hello, {}!\n", "мир");
- print(fg(fmt::color::steel_blue) | fmt::emphasis::italic,
- "Hello, {}!\n", "世界");
- }
- prints the following on modern terminals with RGB color support:
- .. image:: https://user-images.githubusercontent.com/576385/
- 50405788-b66e7500-076e-11e9-9592-7324d1f951d8.png
- Thanks `@Rakete1111 (Nicolas) <https://github.com/Rakete1111>`_.
- * Added support for 4-bit terminal colors
- (`#968 <https://github.com/fmtlib/fmt/issues/968>`_,
- `#974 <https://github.com/fmtlib/fmt/pull/974>`_)
- .. code:: c++
- #include <fmt/color.h>
- int main() {
- print(fg(fmt::terminal_color::red), "stop\n");
- }
- Note that these colors vary by terminal:
- .. image:: https://user-images.githubusercontent.com/576385/
- 50405925-dbfc7e00-0770-11e9-9b85-333fab0af9ac.png
- Thanks `@Rakete1111 (Nicolas) <https://github.com/Rakete1111>`_.
- * Parameterized formatting functions on the type of the format string
- (`#880 <https://github.com/fmtlib/fmt/issues/880>`_,
- `#881 <https://github.com/fmtlib/fmt/pull/881>`_,
- `#883 <https://github.com/fmtlib/fmt/pull/883>`_,
- `#885 <https://github.com/fmtlib/fmt/pull/885>`_,
- `#897 <https://github.com/fmtlib/fmt/pull/897>`_,
- `#920 <https://github.com/fmtlib/fmt/issues/920>`_).
- Any object of type ``S`` that has an overloaded ``to_string_view(const S&)``
- returning ``fmt::string_view`` can be used as a format string:
- .. code:: c++
- namespace my_ns {
- inline string_view to_string_view(const my_string& s) {
- return {s.data(), s.length()};
- }
- }
- std::string message = fmt::format(my_string("The answer is {}."), 42);
- Thanks `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_.
- * Made ``std::string_view`` work as a format string
- (`#898 <https://github.com/fmtlib/fmt/pull/898>`_):
- .. code:: c++
- auto message = fmt::format(std::string_view("The answer is {}."), 42);
- Thanks `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_.
- * Added wide string support to compile-time format string checks
- (`#924 <https://github.com/fmtlib/fmt/pull/924>`_):
- .. code:: c++
- print(fmt(L"{:f}"), 42); // compile-time error: invalid type specifier
- Thanks `@XZiar <https://github.com/XZiar>`_.
- * Made colored print functions work with wide strings
- (`#867 <https://github.com/fmtlib/fmt/pull/867>`_):
- .. code:: c++
- #include <fmt/color.h>
- int main() {
- print(fg(fmt::color::red), L"{}\n", 42);
- }
- Thanks `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_.
- * Introduced experimental Unicode support
- (`#628 <https://github.com/fmtlib/fmt/issues/628>`_,
- `#891 <https://github.com/fmtlib/fmt/pull/891>`_):
- .. code:: c++
- using namespace fmt::literals;
- auto s = fmt::format("{:*^5}"_u, "🤡"_u); // s == "**🤡**"_u
- * Improved locale support:
- .. code:: c++
- #include <fmt/locale.h>
- struct numpunct : std::numpunct<char> {
- protected:
- char do_thousands_sep() const override { return '~'; }
- };
- std::locale loc;
- auto s = fmt::format(std::locale(loc, new numpunct()), "{:n}", 1234567);
- // s == "1~234~567"
- * Constrained formatting functions on proper iterator types
- (`#921 <https://github.com/fmtlib/fmt/pull/921>`_).
- Thanks `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_.
- * Added ``make_printf_args`` and ``make_wprintf_args`` functions
- (`#934 <https://github.com/fmtlib/fmt/pull/934>`_).
- Thanks `@tnovotny <https://github.com/tnovotny>`_.
- * Deprecated ``fmt::visit``, ``parse_context``, and ``wparse_context``.
- Use ``fmt::visit_format_arg``, ``format_parse_context``, and
- ``wformat_parse_context`` instead.
- * Removed undocumented ``basic_fixed_buffer`` which has been superseded by the
- iterator-based API
- (`#873 <https://github.com/fmtlib/fmt/issues/873>`_,
- `#902 <https://github.com/fmtlib/fmt/pull/902>`_).
- Thanks `@superfunc (hollywood programmer) <https://github.com/superfunc>`_.
- * Disallowed repeated leading zeros in an argument ID:
- .. code:: c++
- fmt::print("{000}", 42); // error
- * Reintroduced support for gcc 4.4.
- * Fixed compilation on platforms with exotic ``double``
- (`#878 <https://github.com/fmtlib/fmt/issues/878>`_).
- * Improved documentation
- (`#164 <https://github.com/fmtlib/fmt/issues/164>`_,
- `#877 <https://github.com/fmtlib/fmt/issues/877>`_,
- `#901 <https://github.com/fmtlib/fmt/pull/901>`_,
- `#906 <https://github.com/fmtlib/fmt/pull/906>`_,
- `#979 <https://github.com/fmtlib/fmt/pull/979>`_).
- Thanks `@kookjr (Mathew Cucuzella) <https://github.com/kookjr>`_,
- `@DarkDimius (Dmitry Petrashko) <https://github.com/DarkDimius>`_,
- `@HecticSerenity <https://github.com/HecticSerenity>`_.
- * Added pkgconfig support which makes it easier to consume the library from
- meson and other build systems
- (`#916 <https://github.com/fmtlib/fmt/pull/916>`_).
- Thanks `@colemickens (Cole Mickens) <https://github.com/colemickens>`_.
- * Various build improvements
- (`#909 <https://github.com/fmtlib/fmt/pull/909>`_,
- `#926 <https://github.com/fmtlib/fmt/pull/926>`_,
- `#937 <https://github.com/fmtlib/fmt/pull/937>`_,
- `#953 <https://github.com/fmtlib/fmt/pull/953>`_,
- `#959 <https://github.com/fmtlib/fmt/pull/959>`_).
- Thanks `@tchaikov (Kefu Chai) <https://github.com/tchaikov>`_,
- `@luncliff (Park DongHa) <https://github.com/luncliff>`_,
- `@AndreasSchoenle (Andreas Schönle) <https://github.com/AndreasSchoenle>`_,
- `@hotwatermorning <https://github.com/hotwatermorning>`_,
- `@Zefz (JohanJansen) <https://github.com/Zefz>`_.
- * Improved ``string_view`` construction performance
- (`#914 <https://github.com/fmtlib/fmt/pull/914>`_).
- Thanks `@gabime (Gabi Melman) <https://github.com/gabime>`_.
- * Fixed non-matching char types
- (`#895 <https://github.com/fmtlib/fmt/pull/895>`_).
- Thanks `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_.
- * Fixed ``format_to_n`` with ``std::back_insert_iterator``
- (`#913 <https://github.com/fmtlib/fmt/pull/913>`_).
- Thanks `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_.
- * Fixed locale-dependent formatting
- (`#905 <https://github.com/fmtlib/fmt/issues/905>`_).
- * Fixed various compiler warnings and errors
- (`#882 <https://github.com/fmtlib/fmt/pull/882>`_,
- `#886 <https://github.com/fmtlib/fmt/pull/886>`_,
- `#933 <https://github.com/fmtlib/fmt/pull/933>`_,
- `#941 <https://github.com/fmtlib/fmt/pull/941>`_,
- `#931 <https://github.com/fmtlib/fmt/issues/931>`_,
- `#943 <https://github.com/fmtlib/fmt/pull/943>`_,
- `#954 <https://github.com/fmtlib/fmt/pull/954>`_,
- `#956 <https://github.com/fmtlib/fmt/pull/956>`_,
- `#962 <https://github.com/fmtlib/fmt/pull/962>`_,
- `#965 <https://github.com/fmtlib/fmt/issues/965>`_,
- `#977 <https://github.com/fmtlib/fmt/issues/977>`_,
- `#983 <https://github.com/fmtlib/fmt/pull/983>`_,
- `#989 <https://github.com/fmtlib/fmt/pull/989>`_).
- Thanks `@Luthaf (Guillaume Fraux) <https://github.com/Luthaf>`_,
- `@stevenhoving (Steven Hoving) <https://github.com/stevenhoving>`_,
- `@christinaa (Kristina Brooks) <https://github.com/christinaa>`_,
- `@lgritz (Larry Gritz) <https://github.com/lgritz>`_,
- `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_,
- `@0x8000-0000 (Sign Bit) <https://github.com/0x8000-0000>`_,
- `@liuping1997 <https://github.com/liuping1997>`_.
- 5.2.1 - 2018-09-21
- ------------------
- * Fixed ``visit`` lookup issues on gcc 7 & 8
- (`#870 <https://github.com/fmtlib/fmt/pull/870>`_).
- Thanks `@medithe <https://github.com/medithe>`_.
- * Fixed linkage errors on older gcc.
- * Prevented ``fmt/range.h`` from specializing ``fmt::basic_string_view``
- (`#865 <https://github.com/fmtlib/fmt/issues/865>`_,
- `#868 <https://github.com/fmtlib/fmt/pull/868>`_).
- Thanks `@hhggit (dual) <https://github.com/hhggit>`_.
- * Improved error message when formatting unknown types
- (`#872 <https://github.com/fmtlib/fmt/pull/872>`_).
- Thanks `@foonathan (Jonathan Müller) <https://github.com/foonathan>`_,
- * Disabled templated user-defined literals when compiled under nvcc
- (`#875 <https://github.com/fmtlib/fmt/pull/875>`_).
- Thanks `@CandyGumdrop (Candy Gumdrop) <https://github.com/CandyGumdrop>`_,
- * Fixed ``format_to`` formatting to ``wmemory_buffer``
- (`#874 <https://github.com/fmtlib/fmt/issues/874>`_).
- 5.2.0 - 2018-09-13
- ------------------
- * Optimized format string parsing and argument processing which resulted in up
- to 5x speed up on long format strings and significant performance boost on
- various benchmarks. For example, version 5.2 is 2.22x faster than 5.1 on
- decimal integer formatting with ``format_to`` (macOS, clang-902.0.39.2):
- ================== ======= =======
- Method Time, s Speedup
- ================== ======= =======
- fmt::format 5.1 0.58
- fmt::format 5.2 0.35 1.66x
- fmt::format_to 5.1 0.51
- fmt::format_to 5.2 0.23 2.22x
- sprintf 0.71
- std::to_string 1.01
- std::stringstream 1.73
- ================== ======= =======
- * Changed the ``fmt`` macro from opt-out to opt-in to prevent name collisions.
- To enable it define the ``FMT_STRING_ALIAS`` macro to 1 before including
- ``fmt/format.h``:
- .. code:: c++
- #define FMT_STRING_ALIAS 1
- #include <fmt/format.h>
- std::string answer = format(fmt("{}"), 42);
- * Added compile-time format string checks to ``format_to`` overload that takes
- ``fmt::memory_buffer`` (`#783 <https://github.com/fmtlib/fmt/issues/783>`_):
- .. code:: c++
- fmt::memory_buffer buf;
- // Compile-time error: invalid type specifier.
- fmt::format_to(buf, fmt("{:d}"), "foo");
- * Moved experimental color support to ``fmt/color.h`` and enabled the
- new API by default. The old API can be enabled by defining the
- ``FMT_DEPRECATED_COLORS`` macro.
- * Added formatting support for types explicitly convertible to
- ``fmt::string_view``:
- .. code:: c++
- struct foo {
- explicit operator fmt::string_view() const { return "foo"; }
- };
- auto s = format("{}", foo());
- In particular, this makes formatting function work with
- ``folly::StringPiece``.
- * Implemented preliminary support for ``char*_t`` by replacing the ``format``
- function overloads with a single function template parameterized on the string
- type.
- * Added support for dynamic argument lists
- (`#814 <https://github.com/fmtlib/fmt/issues/814>`_,
- `#819 <https://github.com/fmtlib/fmt/pull/819>`_).
- Thanks `@MikePopoloski (Michael Popoloski)
- <https://github.com/MikePopoloski>`_.
- * Reduced executable size overhead for embedded targets using newlib nano by
- making locale dependency optional
- (`#839 <https://github.com/fmtlib/fmt/pull/839>`_).
- Thanks `@teajay-fr (Thomas Benard) <https://github.com/teajay-fr>`_.
- * Keep ``noexcept`` specifier when exceptions are disabled
- (`#801 <https://github.com/fmtlib/fmt/issues/801>`_,
- `#810 <https://github.com/fmtlib/fmt/pull/810>`_).
- Thanks `@qis (Alexej Harm) <https://github.com/qis>`_.
- * Fixed formatting of user-defined types providing ``operator<<`` with
- ``format_to_n``
- (`#806 <https://github.com/fmtlib/fmt/pull/806>`_).
- Thanks `@mkurdej (Marek Kurdej) <https://github.com/mkurdej>`_.
- * Fixed dynamic linkage of new symbols
- (`#808 <https://github.com/fmtlib/fmt/issues/808>`_).
- * Fixed global initialization issue
- (`#807 <https://github.com/fmtlib/fmt/issues/807>`_):
- .. code:: c++
- // This works on compilers with constexpr support.
- static const std::string answer = fmt::format("{}", 42);
- * Fixed various compiler warnings and errors
- (`#804 <https://github.com/fmtlib/fmt/pull/804>`_,
- `#809 <https://github.com/fmtlib/fmt/issues/809>`_,
- `#811 <https://github.com/fmtlib/fmt/pull/811>`_,
- `#822 <https://github.com/fmtlib/fmt/issues/822>`_,
- `#827 <https://github.com/fmtlib/fmt/pull/827>`_,
- `#830 <https://github.com/fmtlib/fmt/issues/830>`_,
- `#838 <https://github.com/fmtlib/fmt/pull/838>`_,
- `#843 <https://github.com/fmtlib/fmt/issues/843>`_,
- `#844 <https://github.com/fmtlib/fmt/pull/844>`_,
- `#851 <https://github.com/fmtlib/fmt/issues/851>`_,
- `#852 <https://github.com/fmtlib/fmt/pull/852>`_,
- `#854 <https://github.com/fmtlib/fmt/pull/854>`_).
- Thanks `@henryiii (Henry Schreiner) <https://github.com/henryiii>`_,
- `@medithe <https://github.com/medithe>`_, and
- `@eliasdaler (Elias Daler) <https://github.com/eliasdaler>`_.
- 5.1.0 - 2018-07-05
- ------------------
- * Added experimental support for RGB color output enabled with
- the ``FMT_EXTENDED_COLORS`` macro:
- .. code:: c++
- #define FMT_EXTENDED_COLORS
- #define FMT_HEADER_ONLY // or compile fmt with FMT_EXTENDED_COLORS defined
- #include <fmt/format.h>
- fmt::print(fmt::color::steel_blue, "Some beautiful text");
- The old API (the ``print_colored`` and ``vprint_colored`` functions and the
- ``color`` enum) is now deprecated.
- (`#762 <https://github.com/fmtlib/fmt/issues/762>`_
- `#767 <https://github.com/fmtlib/fmt/pull/767>`_).
- thanks `@Remotion (Remo) <https://github.com/Remotion>`_.
- * Added quotes to strings in ranges and tuples
- (`#766 <https://github.com/fmtlib/fmt/pull/766>`_).
- Thanks `@Remotion (Remo) <https://github.com/Remotion>`_.
- * Made ``format_to`` work with ``basic_memory_buffer``
- (`#776 <https://github.com/fmtlib/fmt/issues/776>`_).
- * Added ``vformat_to_n`` and ``wchar_t`` overload of ``format_to_n``
- (`#764 <https://github.com/fmtlib/fmt/issues/764>`_,
- `#769 <https://github.com/fmtlib/fmt/issues/769>`_).
- * Made ``is_range`` and ``is_tuple_like`` part of public (experimental) API
- to allow specialization for user-defined types
- (`#751 <https://github.com/fmtlib/fmt/issues/751>`_,
- `#759 <https://github.com/fmtlib/fmt/pull/759>`_).
- Thanks `@drrlvn (Dror Levin) <https://github.com/drrlvn>`_.
- * Added more compilers to continuous integration and increased ``FMT_PEDANTIC``
- warning levels
- (`#736 <https://github.com/fmtlib/fmt/pull/736>`_).
- Thanks `@eliaskosunen (Elias Kosunen) <https://github.com/eliaskosunen>`_.
- * Fixed compilation with MSVC 2013.
- * Fixed handling of user-defined types in ``format_to``
- (`#793 <https://github.com/fmtlib/fmt/issues/793>`_).
- * Forced linking of inline ``vformat`` functions into the library
- (`#795 <https://github.com/fmtlib/fmt/issues/795>`_).
- * Fixed incorrect call to on_align in ``'{:}='``
- (`#750 <https://github.com/fmtlib/fmt/issues/750>`_).
- * Fixed floating-point formatting to a non-back_insert_iterator with sign &
- numeric alignment specified
- (`#756 <https://github.com/fmtlib/fmt/issues/756>`_).
- * Fixed formatting to an array with ``format_to_n``
- (`#778 <https://github.com/fmtlib/fmt/issues/778>`_).
- * Fixed formatting of more than 15 named arguments
- (`#754 <https://github.com/fmtlib/fmt/issues/754>`_).
- * Fixed handling of compile-time strings when including ``fmt/ostream.h``.
- (`#768 <https://github.com/fmtlib/fmt/issues/768>`_).
- * Fixed various compiler warnings and errors
- (`#742 <https://github.com/fmtlib/fmt/issues/742>`_,
- `#748 <https://github.com/fmtlib/fmt/issues/748>`_,
- `#752 <https://github.com/fmtlib/fmt/issues/752>`_,
- `#770 <https://github.com/fmtlib/fmt/issues/770>`_,
- `#775 <https://github.com/fmtlib/fmt/pull/775>`_,
- `#779 <https://github.com/fmtlib/fmt/issues/779>`_,
- `#780 <https://github.com/fmtlib/fmt/pull/780>`_,
- `#790 <https://github.com/fmtlib/fmt/pull/790>`_,
- `#792 <https://github.com/fmtlib/fmt/pull/792>`_,
- `#800 <https://github.com/fmtlib/fmt/pull/800>`_).
- Thanks `@Remotion (Remo) <https://github.com/Remotion>`_,
- `@gabime (Gabi Melman) <https://github.com/gabime>`_,
- `@foonathan (Jonathan Müller) <https://github.com/foonathan>`_,
- `@Dark-Passenger (Dhruv Paranjape) <https://github.com/Dark-Passenger>`_, and
- `@0x8000-0000 (Sign Bit) <https://github.com/0x8000-0000>`_.
- 5.0.0 - 2018-05-21
- ------------------
- * Added a requirement for partial C++11 support, most importantly variadic
- templates and type traits, and dropped ``FMT_VARIADIC_*`` emulation macros.
- Variadic templates are available since GCC 4.4, Clang 2.9 and MSVC 18.0 (2013).
- For older compilers use {fmt} `version 4.x
- <https://github.com/fmtlib/fmt/releases/tag/4.1.0>`_ which continues to be
- maintained and works with C++98 compilers.
- * Renamed symbols to follow standard C++ naming conventions and proposed a subset
- of the library for standardization in `P0645R2 Text Formatting
- <https://wg21.link/P0645>`_.
- * Implemented ``constexpr`` parsing of format strings and `compile-time format
- string checks
- <https://fmt.dev/latest/api.html#compile-time-format-string-checks>`_. For
- example
- .. code:: c++
- #include <fmt/format.h>
- std::string s = format(fmt("{:d}"), "foo");
- gives a compile-time error because ``d`` is an invalid specifier for strings
- (`godbolt <https://godbolt.org/g/rnCy9Q>`__)::
- ...
- <source>:4:19: note: in instantiation of function template specialization 'fmt::v5::format<S, char [4]>' requested here
- std::string s = format(fmt("{:d}"), "foo");
- ^
- format.h:1337:13: note: non-constexpr function 'on_error' cannot be used in a constant expression
- handler.on_error("invalid type specifier");
- Compile-time checks require relaxed ``constexpr`` (C++14 feature) support. If
- the latter is not available, checks will be performed at runtime.
- * Separated format string parsing and formatting in the extension API to enable
- compile-time format string processing. For example
- .. code:: c++
- struct Answer {};
- namespace fmt {
- template <>
- struct formatter<Answer> {
- constexpr auto parse(parse_context& ctx) {
- auto it = ctx.begin();
- spec = *it;
- if (spec != 'd' && spec != 's')
- throw format_error("invalid specifier");
- return ++it;
- }
- template <typename FormatContext>
- auto format(Answer, FormatContext& ctx) {
- return spec == 's' ?
- format_to(ctx.begin(), "{}", "fourty-two") :
- format_to(ctx.begin(), "{}", 42);
- }
- char spec = 0;
- };
- }
- std::string s = format(fmt("{:x}"), Answer());
- gives a compile-time error due to invalid format specifier (`godbolt
- <https://godbolt.org/g/2jQ1Dv>`__)::
- ...
- <source>:12:45: error: expression '<throw-expression>' is not a constant expression
- throw format_error("invalid specifier");
- * Added `iterator support
- <https://fmt.dev/latest/api.html#output-iterator-support>`_:
- .. code:: c++
- #include <vector>
- #include <fmt/format.h>
- std::vector<char> out;
- fmt::format_to(std::back_inserter(out), "{}", 42);
- * Added the `format_to_n
- <https://fmt.dev/latest/api.html#_CPPv2N3fmt11format_to_nE8OutputItNSt6size_tE11string_viewDpRK4Args>`_
- function that restricts the output to the specified number of characters
- (`#298 <https://github.com/fmtlib/fmt/issues/298>`_):
- .. code:: c++
- char out[4];
- fmt::format_to_n(out, sizeof(out), "{}", 12345);
- // out == "1234" (without terminating '\0')
- * Added the `formatted_size
- <https://fmt.dev/latest/api.html#_CPPv2N3fmt14formatted_sizeE11string_viewDpRK4Args>`_
- function for computing the output size:
- .. code:: c++
- #include <fmt/format.h>
- auto size = fmt::formatted_size("{}", 12345); // size == 5
- * Improved compile times by reducing dependencies on standard headers and
- providing a lightweight `core API <https://fmt.dev/latest/api.html#core-api>`_:
- .. code:: c++
- #include <fmt/core.h>
- fmt::print("The answer is {}.", 42);
- See `Compile time and code bloat
- <https://github.com/fmtlib/fmt#compile-time-and-code-bloat>`_.
- * Added the `make_format_args
- <https://fmt.dev/latest/api.html#_CPPv2N3fmt16make_format_argsEDpRK4Args>`_
- function for capturing formatting arguments:
- .. code:: c++
-
- // Prints formatted error message.
- void vreport_error(const char *format, fmt::format_args args) {
- fmt::print("Error: ");
- fmt::vprint(format, args);
- }
- template <typename... Args>
- void report_error(const char *format, const Args & ... args) {
- vreport_error(format, fmt::make_format_args(args...));
- }
- * Added the ``make_printf_args`` function for capturing ``printf`` arguments
- (`#687 <https://github.com/fmtlib/fmt/issues/687>`_,
- `#694 <https://github.com/fmtlib/fmt/pull/694>`_).
- Thanks `@Kronuz (Germán Méndez Bravo) <https://github.com/Kronuz>`_.
- * Added prefix ``v`` to non-variadic functions taking ``format_args`` to
- distinguish them from variadic ones:
- .. code:: c++
- std::string vformat(string_view format_str, format_args args);
-
- template <typename... Args>
- std::string format(string_view format_str, const Args & ... args);
- * Added experimental support for formatting ranges, containers and tuple-like
- types in ``fmt/ranges.h`` (`#735 <https://github.com/fmtlib/fmt/pull/735>`_):
- .. code:: c++
- #include <fmt/ranges.h>
- std::vector<int> v = {1, 2, 3};
- fmt::print("{}", v); // prints {1, 2, 3}
- Thanks `@Remotion (Remo) <https://github.com/Remotion>`_.
- * Implemented ``wchar_t`` date and time formatting
- (`#712 <https://github.com/fmtlib/fmt/pull/712>`_):
- .. code:: c++
- #include <fmt/time.h>
- std::time_t t = std::time(nullptr);
- auto s = fmt::format(L"The date is {:%Y-%m-%d}.", *std::localtime(&t));
- Thanks `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_.
- * Provided more wide string overloads
- (`#724 <https://github.com/fmtlib/fmt/pull/724>`_).
- Thanks `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_.
- * Switched from a custom null-terminated string view class to ``string_view``
- in the format API and provided ``fmt::string_view`` which implements a subset
- of ``std::string_view`` API for pre-C++17 systems.
- * Added support for ``std::experimental::string_view``
- (`#607 <https://github.com/fmtlib/fmt/pull/607>`_):
- .. code:: c++
- #include <fmt/core.h>
- #include <experimental/string_view>
- fmt::print("{}", std::experimental::string_view("foo"));
- Thanks `@virgiliofornazin (Virgilio Alexandre Fornazin)
- <https://github.com/virgiliofornazin>`__.
- * Allowed mixing named and automatic arguments:
- .. code:: c++
- fmt::format("{} {two}", 1, fmt::arg("two", 2));
- * Removed the write API in favor of the `format API
- <https://fmt.dev/latest/api.html#format-api>`_ with compile-time handling of
- format strings.
- * Disallowed formatting of multibyte strings into a wide character target
- (`#606 <https://github.com/fmtlib/fmt/pull/606>`_).
- * Improved documentation
- (`#515 <https://github.com/fmtlib/fmt/pull/515>`_,
- `#614 <https://github.com/fmtlib/fmt/issues/614>`_,
- `#617 <https://github.com/fmtlib/fmt/pull/617>`_,
- `#661 <https://github.com/fmtlib/fmt/pull/661>`_,
- `#680 <https://github.com/fmtlib/fmt/pull/680>`_).
- Thanks `@ibell (Ian Bell) <https://github.com/ibell>`_,
- `@mihaitodor (Mihai Todor) <https://github.com/mihaitodor>`_, and
- `@johnthagen <https://github.com/johnthagen>`_.
- * Implemented more efficient handling of large number of format arguments.
- * Introduced an inline namespace for symbol versioning.
- * Added debug postfix ``d`` to the ``fmt`` library name
- (`#636 <https://github.com/fmtlib/fmt/issues/636>`_).
- * Removed unnecessary ``fmt/`` prefix in includes
- (`#397 <https://github.com/fmtlib/fmt/pull/397>`_).
- Thanks `@chronoxor (Ivan Shynkarenka) <https://github.com/chronoxor>`_.
- * Moved ``fmt/*.h`` to ``include/fmt/*.h`` to prevent irrelevant files and
- directories appearing on the include search paths when fmt is used as a
- subproject and moved source files to the ``src`` directory.
- * Added qmake project file ``support/fmt.pro``
- (`#641 <https://github.com/fmtlib/fmt/pull/641>`_).
- Thanks `@cowo78 (Giuseppe Corbelli) <https://github.com/cowo78>`_.
- * Added Gradle build file ``support/build.gradle``
- (`#649 <https://github.com/fmtlib/fmt/pull/649>`_).
- Thanks `@luncliff (Park DongHa) <https://github.com/luncliff>`_.
- * Removed ``FMT_CPPFORMAT`` CMake option.
- * Fixed a name conflict with the macro ``CHAR_WIDTH`` in glibc
- (`#616 <https://github.com/fmtlib/fmt/pull/616>`_).
- Thanks `@aroig (Abdó Roig-Maranges) <https://github.com/aroig>`_.
- * Fixed handling of nested braces in ``fmt::join``
- (`#638 <https://github.com/fmtlib/fmt/issues/638>`_).
- * Added ``SOURCELINK_SUFFIX`` for compatibility with Sphinx 1.5
- (`#497 <https://github.com/fmtlib/fmt/pull/497>`_).
- Thanks `@ginggs (Graham Inggs) <https://github.com/ginggs>`_.
- * Added a missing ``inline`` in the header-only mode
- (`#626 <https://github.com/fmtlib/fmt/pull/626>`_).
- Thanks `@aroig (Abdó Roig-Maranges) <https://github.com/aroig>`_.
- * Fixed various compiler warnings
- (`#640 <https://github.com/fmtlib/fmt/pull/640>`_,
- `#656 <https://github.com/fmtlib/fmt/pull/656>`_,
- `#679 <https://github.com/fmtlib/fmt/pull/679>`_,
- `#681 <https://github.com/fmtlib/fmt/pull/681>`_,
- `#705 <https://github.com/fmtlib/fmt/pull/705>`__,
- `#715 <https://github.com/fmtlib/fmt/issues/715>`_,
- `#717 <https://github.com/fmtlib/fmt/pull/717>`_,
- `#720 <https://github.com/fmtlib/fmt/pull/720>`_,
- `#723 <https://github.com/fmtlib/fmt/pull/723>`_,
- `#726 <https://github.com/fmtlib/fmt/pull/726>`_,
- `#730 <https://github.com/fmtlib/fmt/pull/730>`_,
- `#739 <https://github.com/fmtlib/fmt/pull/739>`_).
- Thanks `@peterbell10 <https://github.com/peterbell10>`_,
- `@LarsGullik <https://github.com/LarsGullik>`_,
- `@foonathan (Jonathan Müller) <https://github.com/foonathan>`_,
- `@eliaskosunen (Elias Kosunen) <https://github.com/eliaskosunen>`_,
- `@christianparpart (Christian Parpart) <https://github.com/christianparpart>`_,
- `@DanielaE (Daniela Engert) <https://github.com/DanielaE>`_,
- and `@mwinterb <https://github.com/mwinterb>`_.
- * Worked around an MSVC bug and fixed several warnings
- (`#653 <https://github.com/fmtlib/fmt/pull/653>`_).
- Thanks `@alabuzhev (Alex Alabuzhev) <https://github.com/alabuzhev>`_.
- * Worked around GCC bug 67371
- (`#682 <https://github.com/fmtlib/fmt/issues/682>`_).
- * Fixed compilation with ``-fno-exceptions``
- (`#655 <https://github.com/fmtlib/fmt/pull/655>`_).
- Thanks `@chenxiaolong (Andrew Gunnerson) <https://github.com/chenxiaolong>`_.
- * Made ``constexpr remove_prefix`` gcc version check tighter
- (`#648 <https://github.com/fmtlib/fmt/issues/648>`_).
- * Renamed internal type enum constants to prevent collision with poorly written
- C libraries (`#644 <https://github.com/fmtlib/fmt/issues/644>`_).
- * Added detection of ``wostream operator<<``
- (`#650 <https://github.com/fmtlib/fmt/issues/650>`_).
- * Fixed compilation on OpenBSD
- (`#660 <https://github.com/fmtlib/fmt/pull/660>`_).
- Thanks `@hubslave <https://github.com/hubslave>`_.
- * Fixed compilation on FreeBSD 12
- (`#732 <https://github.com/fmtlib/fmt/pull/732>`_).
- Thanks `@dankm <https://github.com/dankm>`_.
- * Fixed compilation when there is a mismatch between ``-std`` options between
- the library and user code
- (`#664 <https://github.com/fmtlib/fmt/issues/664>`_).
- * Fixed compilation with GCC 7 and ``-std=c++11``
- (`#734 <https://github.com/fmtlib/fmt/issues/734>`_).
- * Improved generated binary code on GCC 7 and older
- (`#668 <https://github.com/fmtlib/fmt/issues/668>`_).
- * Fixed handling of numeric alignment with no width
- (`#675 <https://github.com/fmtlib/fmt/issues/675>`_).
- * Fixed handling of empty strings in UTF8/16 converters
- (`#676 <https://github.com/fmtlib/fmt/pull/676>`_).
- Thanks `@vgalka-sl (Vasili Galka) <https://github.com/vgalka-sl>`_.
- * Fixed formatting of an empty ``string_view``
- (`#689 <https://github.com/fmtlib/fmt/issues/689>`_).
- * Fixed detection of ``string_view`` on libc++
- (`#686 <https://github.com/fmtlib/fmt/issues/686>`_).
- * Fixed DLL issues (`#696 <https://github.com/fmtlib/fmt/pull/696>`_).
- Thanks `@sebkoenig <https://github.com/sebkoenig>`_.
- * Fixed compile checks for mixing narrow and wide strings
- (`#690 <https://github.com/fmtlib/fmt/issues/690>`_).
- * Disabled unsafe implicit conversion to ``std::string``
- (`#729 <https://github.com/fmtlib/fmt/issues/729>`_).
- * Fixed handling of reused format specs (as in ``fmt::join``) for pointers
- (`#725 <https://github.com/fmtlib/fmt/pull/725>`_).
- Thanks `@mwinterb <https://github.com/mwinterb>`_.
- * Fixed installation of ``fmt/ranges.h``
- (`#738 <https://github.com/fmtlib/fmt/pull/738>`_).
- Thanks `@sv1990 <https://github.com/sv1990>`_.
- 4.1.0 - 2017-12-20
- ------------------
- * Added ``fmt::to_wstring()`` in addition to ``fmt::to_string()``
- (`#559 <https://github.com/fmtlib/fmt/pull/559>`_).
- Thanks `@alabuzhev (Alex Alabuzhev) <https://github.com/alabuzhev>`_.
- * Added support for C++17 ``std::string_view``
- (`#571 <https://github.com/fmtlib/fmt/pull/571>`_ and
- `#578 <https://github.com/fmtlib/fmt/pull/578>`_).
- Thanks `@thelostt (Mário Feroldi) <https://github.com/thelostt>`_ and
- `@mwinterb <https://github.com/mwinterb>`_.
- * Enabled stream exceptions to catch errors
- (`#581 <https://github.com/fmtlib/fmt/issues/581>`_).
- Thanks `@crusader-mike <https://github.com/crusader-mike>`_.
- * Allowed formatting of class hierarchies with ``fmt::format_arg()``
- (`#547 <https://github.com/fmtlib/fmt/pull/547>`_).
- Thanks `@rollbear (Björn Fahller) <https://github.com/rollbear>`_.
- * Removed limitations on character types
- (`#563 <https://github.com/fmtlib/fmt/pull/563>`_).
- Thanks `@Yelnats321 (Elnar Dakeshov) <https://github.com/Yelnats321>`_.
- * Conditionally enabled use of ``std::allocator_traits``
- (`#583 <https://github.com/fmtlib/fmt/pull/583>`_).
- Thanks `@mwinterb <https://github.com/mwinterb>`_.
- * Added support for ``const`` variadic member function emulation with
- ``FMT_VARIADIC_CONST`` (`#591 <https://github.com/fmtlib/fmt/pull/591>`_).
- Thanks `@ludekvodicka (Ludek Vodicka) <https://github.com/ludekvodicka>`_.
- * Various bugfixes: bad overflow check, unsupported implicit type conversion
- when determining formatting function, test segfaults
- (`#551 <https://github.com/fmtlib/fmt/issues/551>`_), ill-formed macros
- (`#542 <https://github.com/fmtlib/fmt/pull/542>`_) and ambiguous overloads
- (`#580 <https://github.com/fmtlib/fmt/issues/580>`_).
- Thanks `@xylosper (Byoung-young Lee) <https://github.com/xylosper>`_.
- * Prevented warnings on MSVC (`#605 <https://github.com/fmtlib/fmt/pull/605>`_,
- `#602 <https://github.com/fmtlib/fmt/pull/602>`_, and
- `#545 <https://github.com/fmtlib/fmt/pull/545>`_),
- clang (`#582 <https://github.com/fmtlib/fmt/pull/582>`_),
- GCC (`#573 <https://github.com/fmtlib/fmt/issues/573>`_),
- various conversion warnings (`#609 <https://github.com/fmtlib/fmt/pull/609>`_,
- `#567 <https://github.com/fmtlib/fmt/pull/567>`_,
- `#553 <https://github.com/fmtlib/fmt/pull/553>`_ and
- `#553 <https://github.com/fmtlib/fmt/pull/553>`_), and added ``override`` and
- ``[[noreturn]]`` (`#549 <https://github.com/fmtlib/fmt/pull/549>`_ and
- `#555 <https://github.com/fmtlib/fmt/issues/555>`_).
- Thanks `@alabuzhev (Alex Alabuzhev) <https://github.com/alabuzhev>`_,
- `@virgiliofornazin (Virgilio Alexandre Fornazin)
- <https://gihtub.com/virgiliofornazin>`_,
- `@alexanderbock (Alexander Bock) <https://github.com/alexanderbock>`_,
- `@yumetodo <https://github.com/yumetodo>`_,
- `@VaderY (Császár Mátyás) <https://github.com/VaderY>`_,
- `@jpcima (JP Cimalando) <https://github.com/jpcima>`_,
- `@thelostt (Mário Feroldi) <https://github.com/thelostt>`_, and
- `@Manu343726 (Manu Sánchez) <https://github.com/Manu343726>`_.
- * Improved CMake: Used ``GNUInstallDirs`` to set installation location
- (`#610 <https://github.com/fmtlib/fmt/pull/610>`_) and fixed warnings
- (`#536 <https://github.com/fmtlib/fmt/pull/536>`_ and
- `#556 <https://github.com/fmtlib/fmt/pull/556>`_).
- Thanks `@mikecrowe (Mike Crowe) <https://github.com/mikecrowe>`_,
- `@evgen231 <https://github.com/evgen231>`_ and
- `@henryiii (Henry Schreiner) <https://github.com/henryiii>`_.
- 4.0.0 - 2017-06-27
- ------------------
- * Removed old compatibility headers ``cppformat/*.h`` and CMake options
- (`#527 <https://github.com/fmtlib/fmt/pull/527>`_).
- Thanks `@maddinat0r (Alex Martin) <https://github.com/maddinat0r>`_.
- * Added ``string.h`` containing ``fmt::to_string()`` as alternative to
- ``std::to_string()`` as well as other string writer functionality
- (`#326 <https://github.com/fmtlib/fmt/issues/326>`_ and
- `#441 <https://github.com/fmtlib/fmt/pull/441>`_):
- .. code:: c++
- #include "fmt/string.h"
-
- std::string answer = fmt::to_string(42);
- Thanks to `@glebov-andrey (Andrey Glebov)
- <https://github.com/glebov-andrey>`_.
- * Moved ``fmt::printf()`` to new ``printf.h`` header and allowed ``%s`` as
- generic specifier (`#453 <https://github.com/fmtlib/fmt/pull/453>`_),
- made ``%.f`` more conformant to regular ``printf()``
- (`#490 <https://github.com/fmtlib/fmt/pull/490>`_), added custom writer
- support (`#476 <https://github.com/fmtlib/fmt/issues/476>`_) and implemented
- missing custom argument formatting
- (`#339 <https://github.com/fmtlib/fmt/pull/339>`_ and
- `#340 <https://github.com/fmtlib/fmt/pull/340>`_):
- .. code:: c++
- #include "fmt/printf.h"
-
- // %s format specifier can be used with any argument type.
- fmt::printf("%s", 42);
- Thanks `@mojoBrendan <https://github.com/mojoBrendan>`_,
- `@manylegged (Arthur Danskin) <https://github.com/manylegged>`_ and
- `@spacemoose (Glen Stark) <https://github.com/spacemoose>`_.
- See also `#360 <https://github.com/fmtlib/fmt/issues/360>`_,
- `#335 <https://github.com/fmtlib/fmt/issues/335>`_ and
- `#331 <https://github.com/fmtlib/fmt/issues/331>`_.
- * Added ``container.h`` containing a ``BasicContainerWriter``
- to write to containers like ``std::vector``
- (`#450 <https://github.com/fmtlib/fmt/pull/450>`_).
- Thanks `@polyvertex (Jean-Charles Lefebvre) <https://github.com/polyvertex>`_.
- * Added ``fmt::join()`` function that takes a range and formats
- its elements separated by a given string
- (`#466 <https://github.com/fmtlib/fmt/pull/466>`_):
- .. code:: c++
- #include "fmt/format.h"
-
- std::vector<double> v = {1.2, 3.4, 5.6};
- // Prints "(+01.20, +03.40, +05.60)".
- fmt::print("({:+06.2f})", fmt::join(v.begin(), v.end(), ", "));
- Thanks `@olivier80 <https://github.com/olivier80>`_.
- * Added support for custom formatting specifications to simplify customization
- of built-in formatting (`#444 <https://github.com/fmtlib/fmt/pull/444>`_).
- Thanks `@polyvertex (Jean-Charles Lefebvre) <https://github.com/polyvertex>`_.
- See also `#439 <https://github.com/fmtlib/fmt/issues/439>`_.
- * Added ``fmt::format_system_error()`` for error code formatting
- (`#323 <https://github.com/fmtlib/fmt/issues/323>`_ and
- `#526 <https://github.com/fmtlib/fmt/pull/526>`_).
- Thanks `@maddinat0r (Alex Martin) <https://github.com/maddinat0r>`_.
- * Added thread-safe ``fmt::localtime()`` and ``fmt::gmtime()``
- as replacement for the standard version to ``time.h``
- (`#396 <https://github.com/fmtlib/fmt/pull/396>`_).
- Thanks `@codicodi <https://github.com/codicodi>`_.
- * Internal improvements to ``NamedArg`` and ``ArgLists``
- (`#389 <https://github.com/fmtlib/fmt/pull/389>`_ and
- `#390 <https://github.com/fmtlib/fmt/pull/390>`_).
- Thanks `@chronoxor <https://github.com/chronoxor>`_.
- * Fixed crash due to bug in ``FormatBuf``
- (`#493 <https://github.com/fmtlib/fmt/pull/493>`_).
- Thanks `@effzeh <https://github.com/effzeh>`_. See also
- `#480 <https://github.com/fmtlib/fmt/issues/480>`_ and
- `#491 <https://github.com/fmtlib/fmt/issues/491>`_.
- * Fixed handling of wide strings in ``fmt::StringWriter``.
- * Improved compiler error messages
- (`#357 <https://github.com/fmtlib/fmt/issues/357>`_).
- * Fixed various warnings and issues with various compilers
- (`#494 <https://github.com/fmtlib/fmt/pull/494>`_,
- `#499 <https://github.com/fmtlib/fmt/pull/499>`_,
- `#483 <https://github.com/fmtlib/fmt/pull/483>`_,
- `#485 <https://github.com/fmtlib/fmt/pull/485>`_,
- `#482 <https://github.com/fmtlib/fmt/pull/482>`_,
- `#475 <https://github.com/fmtlib/fmt/pull/475>`_,
- `#473 <https://github.com/fmtlib/fmt/pull/473>`_ and
- `#414 <https://github.com/fmtlib/fmt/pull/414>`_).
- Thanks `@chronoxor <https://github.com/chronoxor>`_,
- `@zhaohuaxishi <https://github.com/zhaohuaxishi>`_,
- `@pkestene (Pierre Kestener) <https://github.com/pkestene>`_,
- `@dschmidt (Dominik Schmidt) <https://github.com/dschmidt>`_ and
- `@0x414c (Alexey Gorishny) <https://github.com/0x414c>`_ .
- * Improved CMake: targets are now namespaced
- (`#511 <https://github.com/fmtlib/fmt/pull/511>`_ and
- `#513 <https://github.com/fmtlib/fmt/pull/513>`_), supported header-only
- ``printf.h`` (`#354 <https://github.com/fmtlib/fmt/pull/354>`_), fixed issue
- with minimal supported library subset
- (`#418 <https://github.com/fmtlib/fmt/issues/418>`_,
- `#419 <https://github.com/fmtlib/fmt/pull/419>`_ and
- `#420 <https://github.com/fmtlib/fmt/pull/420>`_).
- Thanks `@bjoernthiel (Bjoern Thiel) <https://github.com/bjoernthiel>`_,
- `@niosHD (Mario Werner) <https://github.com/niosHD>`_,
- `@LogicalKnight (Sean LK) <https://github.com/LogicalKnight>`_ and
- `@alabuzhev (Alex Alabuzhev) <https://github.com/alabuzhev>`_.
- * Improved documentation. Thanks to
- `@pwm1234 (Phil) <https://github.com/pwm1234>`_ for
- `#393 <https://github.com/fmtlib/fmt/pull/393>`_.
- 3.0.2 - 2017-06-14
- ------------------
- * Added ``FMT_VERSION`` macro
- (`#411 <https://github.com/fmtlib/fmt/issues/411>`_).
- * Used ``FMT_NULL`` instead of literal ``0``
- (`#409 <https://github.com/fmtlib/fmt/pull/409>`_).
- Thanks `@alabuzhev (Alex Alabuzhev) <https://github.com/alabuzhev>`_.
- * Added extern templates for ``format_float``
- (`#413 <https://github.com/fmtlib/fmt/issues/413>`_).
- * Fixed implicit conversion issue
- (`#507 <https://github.com/fmtlib/fmt/issues/507>`_).
- * Fixed signbit detection (`#423 <https://github.com/fmtlib/fmt/issues/423>`_).
- * Fixed naming collision (`#425 <https://github.com/fmtlib/fmt/issues/425>`_).
- * Fixed missing intrinsic for C++/CLI
- (`#457 <https://github.com/fmtlib/fmt/pull/457>`_).
- Thanks `@calumr (Calum Robinson) <https://github.com/calumr>`_
- * Fixed Android detection (`#458 <https://github.com/fmtlib/fmt/pull/458>`_).
- Thanks `@Gachapen (Magnus Bjerke Vik) <https://github.com/Gachapen>`_.
- * Use lean ``windows.h`` if not in header-only mode
- (`#503 <https://github.com/fmtlib/fmt/pull/503>`_).
- Thanks `@Quentin01 (Quentin Buathier) <https://github.com/Quentin01>`_.
- * Fixed issue with CMake exporting C++11 flag
- (`#445 <https://github.com/fmtlib/fmt/pull/455>`_).
- Thanks `@EricWF (Eric) <https://github.com/EricWF>`_.
- * Fixed issue with nvcc and MSVC compiler bug and MinGW
- (`#505 <https://github.com/fmtlib/fmt/issues/505>`_).
- * Fixed DLL issues (`#469 <https://github.com/fmtlib/fmt/pull/469>`_ and
- `#502 <https://github.com/fmtlib/fmt/pull/502>`_).
- Thanks `@richardeakin (Richard Eakin) <https://github.com/richardeakin>`_ and
- `@AndreasSchoenle (Andreas Schönle) <https://github.com/AndreasSchoenle>`_.
- * Fixed test compilation under FreeBSD
- (`#433 <https://github.com/fmtlib/fmt/issues/433>`_).
- * Fixed various warnings (`#403 <https://github.com/fmtlib/fmt/pull/403>`_,
- `#410 <https://github.com/fmtlib/fmt/pull/410>`_ and
- `#510 <https://github.com/fmtlib/fmt/pull/510>`_).
- Thanks `@Lecetem <https://github.com/Lectem>`_,
- `@chenhayat (Chen Hayat) <https://github.com/chenhayat>`_ and
- `@trozen <https://github.com/trozen>`_.
- * Worked around a broken ``__builtin_clz`` in clang with MS codegen
- (`#519 <https://github.com/fmtlib/fmt/issues/519>`_).
- * Removed redundant include
- (`#479 <https://github.com/fmtlib/fmt/issues/479>`_).
- * Fixed documentation issues.
- 3.0.1 - 2016-11-01
- ------------------
- * Fixed handling of thousands separator
- (`#353 <https://github.com/fmtlib/fmt/issues/353>`_).
- * Fixed handling of ``unsigned char`` strings
- (`#373 <https://github.com/fmtlib/fmt/issues/373>`_).
- * Corrected buffer growth when formatting time
- (`#367 <https://github.com/fmtlib/fmt/issues/367>`_).
- * Removed warnings under MSVC and clang
- (`#318 <https://github.com/fmtlib/fmt/issues/318>`_,
- `#250 <https://github.com/fmtlib/fmt/issues/250>`_, also merged
- `#385 <https://github.com/fmtlib/fmt/pull/385>`_ and
- `#361 <https://github.com/fmtlib/fmt/pull/361>`_).
- Thanks `@jcelerier (Jean-Michaël Celerier) <https://github.com/jcelerier>`_
- and `@nmoehrle (Nils Moehrle) <https://github.com/nmoehrle>`_.
- * Fixed compilation issues under Android
- (`#327 <https://github.com/fmtlib/fmt/pull/327>`_,
- `#345 <https://github.com/fmtlib/fmt/issues/345>`_ and
- `#381 <https://github.com/fmtlib/fmt/pull/381>`_),
- FreeBSD (`#358 <https://github.com/fmtlib/fmt/pull/358>`_),
- Cygwin (`#388 <https://github.com/fmtlib/fmt/issues/388>`_),
- MinGW (`#355 <https://github.com/fmtlib/fmt/issues/355>`_) as well as other
- issues (`#350 <https://github.com/fmtlib/fmt/issues/350>`_,
- `#366 <https://github.com/fmtlib/fmt/issues/355>`_,
- `#348 <https://github.com/fmtlib/fmt/pull/348>`_,
- `#402 <https://github.com/fmtlib/fmt/pull/402>`_,
- `#405 <https://github.com/fmtlib/fmt/pull/405>`_).
- Thanks to `@dpantele (Dmitry) <https://github.com/dpantele>`_,
- `@hghwng (Hugh Wang) <https://github.com/hghwng>`_,
- `@arvedarved (Tilman Keskinöz) <https://github.com/arvedarved>`_,
- `@LogicalKnight (Sean) <https://github.com/LogicalKnight>`_ and
- `@JanHellwig (Jan Hellwig) <https://github.com/janhellwig>`_.
- * Fixed some documentation issues and extended specification
- (`#320 <https://github.com/fmtlib/fmt/issues/320>`_,
- `#333 <https://github.com/fmtlib/fmt/pull/333>`_,
- `#347 <https://github.com/fmtlib/fmt/issues/347>`_,
- `#362 <https://github.com/fmtlib/fmt/pull/362>`_).
- Thanks to `@smellman (Taro Matsuzawa aka. btm)
- <https://github.com/smellman>`_.
- 3.0.0 - 2016-05-07
- ------------------
- * The project has been renamed from C++ Format (cppformat) to fmt for
- consistency with the used namespace and macro prefix
- (`#307 <https://github.com/fmtlib/fmt/issues/307>`_).
- Library headers are now located in the ``fmt`` directory:
- .. code:: c++
- #include "fmt/format.h"
- Including ``format.h`` from the ``cppformat`` directory is deprecated
- but works via a proxy header which will be removed in the next major version.
-
- The documentation is now available at https://fmt.dev.
- * Added support for `strftime <http://en.cppreference.com/w/cpp/chrono/c/strftime>`_-like
- `date and time formatting <https://fmt.dev/3.0.0/api.html#date-and-time-formatting>`_
- (`#283 <https://github.com/fmtlib/fmt/issues/283>`_):
- .. code:: c++
- #include "fmt/time.h"
- std::time_t t = std::time(nullptr);
- // Prints "The date is 2016-04-29." (with the current date)
- fmt::print("The date is {:%Y-%m-%d}.", *std::localtime(&t));
- * ``std::ostream`` support including formatting of user-defined types that provide
- overloaded ``operator<<`` has been moved to ``fmt/ostream.h``:
- .. code:: c++
- #include "fmt/ostream.h"
- class Date {
- int year_, month_, day_;
- public:
- Date(int year, int month, int day) : year_(year), month_(month), day_(day) {}
- friend std::ostream &operator<<(std::ostream &os, const Date &d) {
- return os << d.year_ << '-' << d.month_ << '-' << d.day_;
- }
- };
- std::string s = fmt::format("The date is {}", Date(2012, 12, 9));
- // s == "The date is 2012-12-9"
- * Added support for `custom argument formatters
- <https://fmt.dev/3.0.0/api.html#argument-formatters>`_
- (`#235 <https://github.com/fmtlib/fmt/issues/235>`_).
- * Added support for locale-specific integer formatting with the ``n`` specifier
- (`#305 <https://github.com/fmtlib/fmt/issues/305>`_):
- .. code:: c++
- std::setlocale(LC_ALL, "en_US.utf8");
- fmt::print("cppformat: {:n}\n", 1234567); // prints 1,234,567
- * Sign is now preserved when formatting an integer with an incorrect ``printf``
- format specifier (`#265 <https://github.com/fmtlib/fmt/issues/265>`_):
- .. code:: c++
- fmt::printf("%lld", -42); // prints -42
- Note that it would be an undefined behavior in ``std::printf``.
- * Length modifiers such as ``ll`` are now optional in printf formatting
- functions and the correct type is determined automatically
- (`#255 <https://github.com/fmtlib/fmt/issues/255>`_):
- .. code:: c++
- fmt::printf("%d", std::numeric_limits<long long>::max());
- Note that it would be an undefined behavior in ``std::printf``.
- * Added initial support for custom formatters
- (`#231 <https://github.com/fmtlib/fmt/issues/231>`_).
- * Fixed detection of user-defined literal support on Intel C++ compiler
- (`#311 <https://github.com/fmtlib/fmt/issues/311>`_,
- `#312 <https://github.com/fmtlib/fmt/pull/312>`_).
- Thanks to `@dean0x7d (Dean Moldovan) <https://github.com/dean0x7d>`_ and
- `@speth (Ray Speth) <https://github.com/speth>`_.
- * Reduced compile time
- (`#243 <https://github.com/fmtlib/fmt/pull/243>`_,
- `#249 <https://github.com/fmtlib/fmt/pull/249>`_,
- `#317 <https://github.com/fmtlib/fmt/issues/317>`_):
- .. image:: https://cloud.githubusercontent.com/assets/4831417/11614060/
- b9e826d2-9c36-11e5-8666-d4131bf503ef.png
- .. image:: https://cloud.githubusercontent.com/assets/4831417/11614080/
- 6ac903cc-9c37-11e5-8165-26df6efae364.png
- Thanks to `@dean0x7d (Dean Moldovan) <https://github.com/dean0x7d>`_.
- * Compile test fixes (`#313 <https://github.com/fmtlib/fmt/pull/313>`_).
- Thanks to `@dean0x7d (Dean Moldovan) <https://github.com/dean0x7d>`_.
- * Documentation fixes (`#239 <https://github.com/fmtlib/fmt/pull/239>`_,
- `#248 <https://github.com/fmtlib/fmt/issues/248>`_,
- `#252 <https://github.com/fmtlib/fmt/issues/252>`_,
- `#258 <https://github.com/fmtlib/fmt/pull/258>`_,
- `#260 <https://github.com/fmtlib/fmt/issues/260>`_,
- `#301 <https://github.com/fmtlib/fmt/issues/301>`_,
- `#309 <https://github.com/fmtlib/fmt/pull/309>`_).
- Thanks to `@ReadmeCritic <https://github.com/ReadmeCritic>`_
- `@Gachapen (Magnus Bjerke Vik) <https://github.com/Gachapen>`_ and
- `@jwilk (Jakub Wilk) <https://github.com/jwilk>`_.
- * Fixed compiler and sanitizer warnings
- (`#244 <https://github.com/fmtlib/fmt/issues/244>`_,
- `#256 <https://github.com/fmtlib/fmt/pull/256>`_,
- `#259 <https://github.com/fmtlib/fmt/pull/259>`_,
- `#263 <https://github.com/fmtlib/fmt/issues/263>`_,
- `#274 <https://github.com/fmtlib/fmt/issues/274>`_,
- `#277 <https://github.com/fmtlib/fmt/pull/277>`_,
- `#286 <https://github.com/fmtlib/fmt/pull/286>`_,
- `#291 <https://github.com/fmtlib/fmt/issues/291>`_,
- `#296 <https://github.com/fmtlib/fmt/issues/296>`_,
- `#308 <https://github.com/fmtlib/fmt/issues/308>`_)
- Thanks to `@mwinterb <https://github.com/mwinterb>`_,
- `@pweiskircher (Patrik Weiskircher) <https://github.com/pweiskircher>`_,
- `@Naios <https://github.com/Naios>`_.
- * Improved compatibility with Windows Store apps
- (`#280 <https://github.com/fmtlib/fmt/issues/280>`_,
- `#285 <https://github.com/fmtlib/fmt/pull/285>`_)
- Thanks to `@mwinterb <https://github.com/mwinterb>`_.
- * Added tests of compatibility with older C++ standards
- (`#273 <https://github.com/fmtlib/fmt/pull/273>`_).
- Thanks to `@niosHD <https://github.com/niosHD>`_.
- * Fixed Android build (`#271 <https://github.com/fmtlib/fmt/pull/271>`_).
- Thanks to `@newnon <https://github.com/newnon>`_.
- * Changed ``ArgMap`` to be backed by a vector instead of a map.
- (`#261 <https://github.com/fmtlib/fmt/issues/261>`_,
- `#262 <https://github.com/fmtlib/fmt/pull/262>`_).
- Thanks to `@mwinterb <https://github.com/mwinterb>`_.
- * Added ``fprintf`` overload that writes to a ``std::ostream``
- (`#251 <https://github.com/fmtlib/fmt/pull/251>`_).
- Thanks to `nickhutchinson (Nicholas Hutchinson) <https://github.com/nickhutchinson>`_.
- * Export symbols when building a Windows DLL
- (`#245 <https://github.com/fmtlib/fmt/pull/245>`_).
- Thanks to `macdems (Maciek Dems) <https://github.com/macdems>`_.
- * Fixed compilation on Cygwin (`#304 <https://github.com/fmtlib/fmt/issues/304>`_).
- * Implemented a workaround for a bug in Apple LLVM version 4.2 of clang
- (`#276 <https://github.com/fmtlib/fmt/issues/276>`_).
- * Implemented a workaround for Google Test bug
- `#705 <https://github.com/google/googletest/issues/705>`_ on gcc 6
- (`#268 <https://github.com/fmtlib/fmt/issues/268>`_).
- Thanks to `octoploid <https://github.com/octoploid>`_.
- * Removed Biicode support because the latter has been discontinued.
- 2.1.1 - 2016-04-11
- ------------------
- * The install location for generated CMake files is now configurable via
- the ``FMT_CMAKE_DIR`` CMake variable
- (`#299 <https://github.com/fmtlib/fmt/pull/299>`_).
- Thanks to `@niosHD <https://github.com/niosHD>`_.
- * Documentation fixes (`#252 <https://github.com/fmtlib/fmt/issues/252>`_).
- 2.1.0 - 2016-03-21
- ------------------
- * Project layout and build system improvements
- (`#267 <https://github.com/fmtlib/fmt/pull/267>`_):
- * The code have been moved to the ``cppformat`` directory.
- Including ``format.h`` from the top-level directory is deprecated
- but works via a proxy header which will be removed in the next
- major version.
- * C++ Format CMake targets now have proper interface definitions.
- * Installed version of the library now supports the header-only
- configuration.
- * Targets ``doc``, ``install``, and ``test`` are now disabled if C++ Format
- is included as a CMake subproject. They can be enabled by setting
- ``FMT_DOC``, ``FMT_INSTALL``, and ``FMT_TEST`` in the parent project.
- Thanks to `@niosHD <https://github.com/niosHD>`_.
- 2.0.1 - 2016-03-13
- ------------------
- * Improved CMake find and package support
- (`#264 <https://github.com/fmtlib/fmt/issues/264>`_).
- Thanks to `@niosHD <https://github.com/niosHD>`_.
- * Fix compile error with Android NDK and mingw32
- (`#241 <https://github.com/fmtlib/fmt/issues/241>`_).
- Thanks to `@Gachapen (Magnus Bjerke Vik) <https://github.com/Gachapen>`_.
- * Documentation fixes
- (`#248 <https://github.com/fmtlib/fmt/issues/248>`_,
- `#260 <https://github.com/fmtlib/fmt/issues/260>`_).
- 2.0.0 - 2015-12-01
- ------------------
- General
- ~~~~~~~
- * [Breaking] Named arguments
- (`#169 <https://github.com/fmtlib/fmt/pull/169>`_,
- `#173 <https://github.com/fmtlib/fmt/pull/173>`_,
- `#174 <https://github.com/fmtlib/fmt/pull/174>`_):
- .. code:: c++
- fmt::print("The answer is {answer}.", fmt::arg("answer", 42));
- Thanks to `@jamboree <https://github.com/jamboree>`_.
- * [Experimental] User-defined literals for format and named arguments
- (`#204 <https://github.com/fmtlib/fmt/pull/204>`_,
- `#206 <https://github.com/fmtlib/fmt/pull/206>`_,
- `#207 <https://github.com/fmtlib/fmt/pull/207>`_):
- .. code:: c++
- using namespace fmt::literals;
- fmt::print("The answer is {answer}.", "answer"_a=42);
- Thanks to `@dean0x7d (Dean Moldovan) <https://github.com/dean0x7d>`_.
- * [Breaking] Formatting of more than 16 arguments is now supported when using
- variadic templates
- (`#141 <https://github.com/fmtlib/fmt/issues/141>`_).
- Thanks to `@Shauren <https://github.com/Shauren>`_.
- * Runtime width specification
- (`#168 <https://github.com/fmtlib/fmt/pull/168>`_):
- .. code:: c++
- fmt::format("{0:{1}}", 42, 5); // gives " 42"
- Thanks to `@jamboree <https://github.com/jamboree>`_.
- * [Breaking] Enums are now formatted with an overloaded ``std::ostream`` insertion
- operator (``operator<<``) if available
- (`#232 <https://github.com/fmtlib/fmt/issues/232>`_).
- * [Breaking] Changed default ``bool`` format to textual, "true" or "false"
- (`#170 <https://github.com/fmtlib/fmt/issues/170>`_):
- .. code:: c++
-
- fmt::print("{}", true); // prints "true"
- To print ``bool`` as a number use numeric format specifier such as ``d``:
- .. code:: c++
- fmt::print("{:d}", true); // prints "1"
- * ``fmt::printf`` and ``fmt::sprintf`` now support formatting of ``bool`` with the
- ``%s`` specifier giving textual output, "true" or "false"
- (`#223 <https://github.com/fmtlib/fmt/pull/223>`_):
- .. code:: c++
- fmt::printf("%s", true); // prints "true"
- Thanks to `@LarsGullik <https://github.com/LarsGullik>`_.
- * [Breaking] ``signed char`` and ``unsigned char`` are now formatted as integers by default
- (`#217 <https://github.com/fmtlib/fmt/pull/217>`_).
- * [Breaking] Pointers to C strings can now be formatted with the ``p`` specifier
- (`#223 <https://github.com/fmtlib/fmt/pull/223>`_):
- .. code:: c++
- fmt::print("{:p}", "test"); // prints pointer value
- Thanks to `@LarsGullik <https://github.com/LarsGullik>`_.
- * [Breaking] ``fmt::printf`` and ``fmt::sprintf`` now print null pointers as ``(nil)``
- and null strings as ``(null)`` for consistency with glibc
- (`#226 <https://github.com/fmtlib/fmt/pull/226>`_).
- Thanks to `@LarsGullik <https://github.com/LarsGullik>`_.
- * [Breaking] ``fmt::(s)printf`` now supports formatting of objects of user-defined types
- that provide an overloaded ``std::ostream`` insertion operator (``operator<<``)
- (`#201 <https://github.com/fmtlib/fmt/issues/201>`_):
- .. code:: c++
- fmt::printf("The date is %s", Date(2012, 12, 9));
- * [Breaking] The ``Buffer`` template is now part of the public API and can be used
- to implement custom memory buffers
- (`#140 <https://github.com/fmtlib/fmt/issues/140>`_).
- Thanks to `@polyvertex (Jean-Charles Lefebvre) <https://github.com/polyvertex>`_.
- * [Breaking] Improved compatibility between ``BasicStringRef`` and
- `std::experimental::basic_string_view
- <http://en.cppreference.com/w/cpp/experimental/basic_string_view>`_
- (`#100 <https://github.com/fmtlib/fmt/issues/100>`_,
- `#159 <https://github.com/fmtlib/fmt/issues/159>`_,
- `#183 <https://github.com/fmtlib/fmt/issues/183>`_):
- - Comparison operators now compare string content, not pointers
- - ``BasicStringRef::c_str`` replaced by ``BasicStringRef::data``
- - ``BasicStringRef`` is no longer assumed to be null-terminated
- References to null-terminated strings are now represented by a new class,
- ``BasicCStringRef``.
- * Dependency on pthreads introduced by Google Test is now optional
- (`#185 <https://github.com/fmtlib/fmt/issues/185>`_).
- * New CMake options ``FMT_DOC``, ``FMT_INSTALL`` and ``FMT_TEST`` to control
- generation of ``doc``, ``install`` and ``test`` targets respectively, on by default
- (`#197 <https://github.com/fmtlib/fmt/issues/197>`_,
- `#198 <https://github.com/fmtlib/fmt/issues/198>`_,
- `#200 <https://github.com/fmtlib/fmt/issues/200>`_).
- Thanks to `@maddinat0r (Alex Martin) <https://github.com/maddinat0r>`_.
- * ``noexcept`` is now used when compiling with MSVC2015
- (`#215 <https://github.com/fmtlib/fmt/pull/215>`_).
- Thanks to `@dmkrepo (Dmitriy) <https://github.com/dmkrepo>`_.
- * Added an option to disable use of ``windows.h`` when ``FMT_USE_WINDOWS_H``
- is defined as 0 before including ``format.h``
- (`#171 <https://github.com/fmtlib/fmt/issues/171>`_).
- Thanks to `@alfps (Alf P. Steinbach) <https://github.com/alfps>`_.
- * [Breaking] ``windows.h`` is now included with ``NOMINMAX`` unless
- ``FMT_WIN_MINMAX`` is defined. This is done to prevent breaking code using
- ``std::min`` and ``std::max`` and only affects the header-only configuration
- (`#152 <https://github.com/fmtlib/fmt/issues/152>`_,
- `#153 <https://github.com/fmtlib/fmt/pull/153>`_,
- `#154 <https://github.com/fmtlib/fmt/pull/154>`_).
- Thanks to `@DevO2012 <https://github.com/DevO2012>`_.
- * Improved support for custom character types
- (`#171 <https://github.com/fmtlib/fmt/issues/171>`_).
- Thanks to `@alfps (Alf P. Steinbach) <https://github.com/alfps>`_.
- * Added an option to disable use of IOStreams when ``FMT_USE_IOSTREAMS``
- is defined as 0 before including ``format.h``
- (`#205 <https://github.com/fmtlib/fmt/issues/205>`_,
- `#208 <https://github.com/fmtlib/fmt/pull/208>`_).
- Thanks to `@JodiTheTigger <https://github.com/JodiTheTigger>`_.
- * Improved detection of ``isnan``, ``isinf`` and ``signbit``.
- Optimization
- ~~~~~~~~~~~~
- * Made formatting of user-defined types more efficient with a custom stream buffer
- (`#92 <https://github.com/fmtlib/fmt/issues/92>`_,
- `#230 <https://github.com/fmtlib/fmt/pull/230>`_).
- Thanks to `@NotImplemented <https://github.com/NotImplemented>`_.
- * Further improved performance of ``fmt::Writer`` on integer formatting
- and fixed a minor regression. Now it is ~7% faster than ``karma::generate``
- on Karma's benchmark
- (`#186 <https://github.com/fmtlib/fmt/issues/186>`_).
- * [Breaking] Reduced `compiled code size
- <https://github.com/fmtlib/fmt#compile-time-and-code-bloat>`_
- (`#143 <https://github.com/fmtlib/fmt/issues/143>`_,
- `#149 <https://github.com/fmtlib/fmt/pull/149>`_).
- Distribution
- ~~~~~~~~~~~~
- * [Breaking] Headers are now installed in
- ``${CMAKE_INSTALL_PREFIX}/include/cppformat``
- (`#178 <https://github.com/fmtlib/fmt/issues/178>`_).
- Thanks to `@jackyf (Eugene V. Lyubimkin) <https://github.com/jackyf>`_.
- * [Breaking] Changed the library name from ``format`` to ``cppformat``
- for consistency with the project name and to avoid potential conflicts
- (`#178 <https://github.com/fmtlib/fmt/issues/178>`_).
- Thanks to `@jackyf (Eugene V. Lyubimkin) <https://github.com/jackyf>`_.
- * C++ Format is now available in `Debian <https://www.debian.org/>`_ GNU/Linux
- (`stretch <https://packages.debian.org/source/stretch/cppformat>`_,
- `sid <https://packages.debian.org/source/sid/cppformat>`_) and
- derived distributions such as
- `Ubuntu <https://launchpad.net/ubuntu/+source/cppformat>`_ 15.10 and later
- (`#155 <https://github.com/fmtlib/fmt/issues/155>`_)::
- $ sudo apt-get install libcppformat1-dev
- Thanks to `@jackyf (Eugene V. Lyubimkin) <https://github.com/jackyf>`_.
- * `Packages for Fedora and RHEL <https://admin.fedoraproject.org/pkgdb/package/cppformat/>`_
- are now available. Thanks to Dave Johansen.
-
- * C++ Format can now be installed via `Homebrew <http://brew.sh/>`_ on OS X
- (`#157 <https://github.com/fmtlib/fmt/issues/157>`_)::
- $ brew install cppformat
- Thanks to `@ortho <https://github.com/ortho>`_, Anatoliy Bulukin.
- Documentation
- ~~~~~~~~~~~~~
- * Migrated from ReadTheDocs to GitHub Pages for better responsiveness
- and reliability
- (`#128 <https://github.com/fmtlib/fmt/issues/128>`_).
- New documentation address is http://cppformat.github.io/.
- * Added `Building the documentation
- <https://fmt.dev/2.0.0/usage.html#building-the-documentation>`_
- section to the documentation.
- * Documentation build script is now compatible with Python 3 and newer pip versions.
- (`#189 <https://github.com/fmtlib/fmt/pull/189>`_,
- `#209 <https://github.com/fmtlib/fmt/issues/209>`_).
- Thanks to `@JodiTheTigger <https://github.com/JodiTheTigger>`_ and
- `@xentec <https://github.com/xentec>`_.
-
- * Documentation fixes and improvements
- (`#36 <https://github.com/fmtlib/fmt/issues/36>`_,
- `#75 <https://github.com/fmtlib/fmt/issues/75>`_,
- `#125 <https://github.com/fmtlib/fmt/issues/125>`_,
- `#160 <https://github.com/fmtlib/fmt/pull/160>`_,
- `#161 <https://github.com/fmtlib/fmt/pull/161>`_,
- `#162 <https://github.com/fmtlib/fmt/issues/162>`_,
- `#165 <https://github.com/fmtlib/fmt/issues/165>`_,
- `#210 <https://github.com/fmtlib/fmt/issues/210>`_).
- Thanks to `@syohex (Syohei YOSHIDA) <https://github.com/syohex>`_ and
- bug reporters.
- * Fixed out-of-tree documentation build
- (`#177 <https://github.com/fmtlib/fmt/issues/177>`_).
- Thanks to `@jackyf (Eugene V. Lyubimkin) <https://github.com/jackyf>`_.
- Fixes
- ~~~~~
- * Fixed ``initializer_list`` detection
- (`#136 <https://github.com/fmtlib/fmt/issues/136>`_).
- Thanks to `@Gachapen (Magnus Bjerke Vik) <https://github.com/Gachapen>`_.
- * [Breaking] Fixed formatting of enums with numeric format specifiers in
- ``fmt::(s)printf``
- (`#131 <https://github.com/fmtlib/fmt/issues/131>`_,
- `#139 <https://github.com/fmtlib/fmt/issues/139>`_):
- .. code:: c++
- enum { ANSWER = 42 };
- fmt::printf("%d", ANSWER);
- Thanks to `@Naios <https://github.com/Naios>`_.
- * Improved compatibility with old versions of MinGW
- (`#129 <https://github.com/fmtlib/fmt/issues/129>`_,
- `#130 <https://github.com/fmtlib/fmt/pull/130>`_,
- `#132 <https://github.com/fmtlib/fmt/issues/132>`_).
- Thanks to `@cstamford (Christopher Stamford) <https://github.com/cstamford>`_.
- * Fixed a compile error on MSVC with disabled exceptions
- (`#144 <https://github.com/fmtlib/fmt/issues/144>`_).
- * Added a workaround for broken implementation of variadic templates in MSVC2012
- (`#148 <https://github.com/fmtlib/fmt/issues/148>`_).
- * Placed the anonymous namespace within ``fmt`` namespace for the header-only
- configuration
- (`#171 <https://github.com/fmtlib/fmt/issues/171>`_).
- Thanks to `@alfps (Alf P. Steinbach) <https://github.com/alfps>`_.
- * Fixed issues reported by Coverity Scan
- (`#187 <https://github.com/fmtlib/fmt/issues/187>`_,
- `#192 <https://github.com/fmtlib/fmt/issues/192>`_).
- * Implemented a workaround for a name lookup bug in MSVC2010
- (`#188 <https://github.com/fmtlib/fmt/issues/188>`_).
- * Fixed compiler warnings
- (`#95 <https://github.com/fmtlib/fmt/issues/95>`_,
- `#96 <https://github.com/fmtlib/fmt/issues/96>`_,
- `#114 <https://github.com/fmtlib/fmt/pull/114>`_,
- `#135 <https://github.com/fmtlib/fmt/issues/135>`_,
- `#142 <https://github.com/fmtlib/fmt/issues/142>`_,
- `#145 <https://github.com/fmtlib/fmt/issues/145>`_,
- `#146 <https://github.com/fmtlib/fmt/issues/146>`_,
- `#158 <https://github.com/fmtlib/fmt/issues/158>`_,
- `#163 <https://github.com/fmtlib/fmt/issues/163>`_,
- `#175 <https://github.com/fmtlib/fmt/issues/175>`_,
- `#190 <https://github.com/fmtlib/fmt/issues/190>`_,
- `#191 <https://github.com/fmtlib/fmt/pull/191>`_,
- `#194 <https://github.com/fmtlib/fmt/issues/194>`_,
- `#196 <https://github.com/fmtlib/fmt/pull/196>`_,
- `#216 <https://github.com/fmtlib/fmt/issues/216>`_,
- `#218 <https://github.com/fmtlib/fmt/pull/218>`_,
- `#220 <https://github.com/fmtlib/fmt/pull/220>`_,
- `#229 <https://github.com/fmtlib/fmt/pull/229>`_,
- `#233 <https://github.com/fmtlib/fmt/issues/233>`_,
- `#234 <https://github.com/fmtlib/fmt/issues/234>`_,
- `#236 <https://github.com/fmtlib/fmt/pull/236>`_,
- `#281 <https://github.com/fmtlib/fmt/issues/281>`_,
- `#289 <https://github.com/fmtlib/fmt/issues/289>`_).
- Thanks to `@seanmiddleditch (Sean Middleditch) <https://github.com/seanmiddleditch>`_,
- `@dixlorenz (Dix Lorenz) <https://github.com/dixlorenz>`_,
- `@CarterLi (李通洲) <https://github.com/CarterLi>`_,
- `@Naios <https://github.com/Naios>`_,
- `@fmatthew5876 (Matthew Fioravante) <https://github.com/fmatthew5876>`_,
- `@LevskiWeng (Levski Weng) <https://github.com/LevskiWeng>`_,
- `@rpopescu <https://github.com/rpopescu>`_,
- `@gabime (Gabi Melman) <https://github.com/gabime>`_,
- `@cubicool (Jeremy Moles) <https://github.com/cubicool>`_,
- `@jkflying (Julian Kent) <https://github.com/jkflying>`_,
- `@LogicalKnight (Sean L) <https://github.com/LogicalKnight>`_,
- `@inguin (Ingo van Lil) <https://github.com/inguin>`_ and
- `@Jopie64 (Johan) <https://github.com/Jopie64>`_.
- * Fixed portability issues (mostly causing test failures) on ARM, ppc64, ppc64le,
- s390x and SunOS 5.11 i386
- (`#138 <https://github.com/fmtlib/fmt/issues/138>`_,
- `#179 <https://github.com/fmtlib/fmt/issues/179>`_,
- `#180 <https://github.com/fmtlib/fmt/issues/180>`_,
- `#202 <https://github.com/fmtlib/fmt/issues/202>`_,
- `#225 <https://github.com/fmtlib/fmt/issues/225>`_,
- `Red Hat Bugzilla Bug 1260297 <https://bugzilla.redhat.com/show_bug.cgi?id=1260297>`_).
- Thanks to `@Naios <https://github.com/Naios>`_,
- `@jackyf (Eugene V. Lyubimkin) <https://github.com/jackyf>`_ and Dave Johansen.
- * Fixed a name conflict with macro ``free`` defined in
- ``crtdbg.h`` when ``_CRTDBG_MAP_ALLOC`` is set
- (`#211 <https://github.com/fmtlib/fmt/issues/211>`_).
- * Fixed shared library build on OS X
- (`#212 <https://github.com/fmtlib/fmt/pull/212>`_).
- Thanks to `@dean0x7d (Dean Moldovan) <https://github.com/dean0x7d>`_.
- * Fixed an overload conflict on MSVC when ``/Zc:wchar_t-`` option is specified
- (`#214 <https://github.com/fmtlib/fmt/pull/214>`_).
- Thanks to `@slavanap (Vyacheslav Napadovsky) <https://github.com/slavanap>`_.
- * Improved compatibility with MSVC 2008
- (`#236 <https://github.com/fmtlib/fmt/pull/236>`_).
- Thanks to `@Jopie64 (Johan) <https://github.com/Jopie64>`_.
- * Improved compatibility with bcc32
- (`#227 <https://github.com/fmtlib/fmt/issues/227>`_).
- * Fixed ``static_assert`` detection on Clang
- (`#228 <https://github.com/fmtlib/fmt/pull/228>`_).
- Thanks to `@dean0x7d (Dean Moldovan) <https://github.com/dean0x7d>`_.
- 1.1.0 - 2015-03-06
- ------------------
- * Added ``BasicArrayWriter``, a class template that provides operations for
- formatting and writing data into a fixed-size array
- (`#105 <https://github.com/fmtlib/fmt/issues/105>`_ and
- `#122 <https://github.com/fmtlib/fmt/issues/122>`_):
- .. code:: c++
-
- char buffer[100];
- fmt::ArrayWriter w(buffer);
- w.write("The answer is {}", 42);
- * Added `0 A.D. <http://play0ad.com/>`_ and `PenUltima Online (POL)
- <http://www.polserver.com/>`_ to the list of notable projects using C++ Format.
- * C++ Format now uses MSVC intrinsics for better formatting performance
- (`#115 <https://github.com/fmtlib/fmt/pull/115>`_,
- `#116 <https://github.com/fmtlib/fmt/pull/116>`_,
- `#118 <https://github.com/fmtlib/fmt/pull/118>`_ and
- `#121 <https://github.com/fmtlib/fmt/pull/121>`_).
- Previously these optimizations where only used on GCC and Clang.
- Thanks to `@CarterLi <https://github.com/CarterLi>`_ and
- `@objectx <https://github.com/objectx>`_.
- * CMake install target (`#119 <https://github.com/fmtlib/fmt/pull/119>`_).
- Thanks to `@TrentHouliston <https://github.com/TrentHouliston>`_.
- You can now install C++ Format with ``make install`` command.
- * Improved `Biicode <http://www.biicode.com/>`_ support
- (`#98 <https://github.com/fmtlib/fmt/pull/98>`_ and
- `#104 <https://github.com/fmtlib/fmt/pull/104>`_). Thanks to
- `@MariadeAnton <https://github.com/MariadeAnton>`_ and
- `@franramirez688 <https://github.com/franramirez688>`_.
- * Improved support for building with `Android NDK
- <https://developer.android.com/tools/sdk/ndk/index.html>`_
- (`#107 <https://github.com/fmtlib/fmt/pull/107>`_).
- Thanks to `@newnon <https://github.com/newnon>`_.
-
- The `android-ndk-example <https://github.com/fmtlib/android-ndk-example>`_
- repository provides and example of using C++ Format with Android NDK:
- .. image:: https://raw.githubusercontent.com/fmtlib/android-ndk-example/
- master/screenshot.png
- * Improved documentation of ``SystemError`` and ``WindowsError``
- (`#54 <https://github.com/fmtlib/fmt/issues/54>`_).
- * Various code improvements
- (`#110 <https://github.com/fmtlib/fmt/pull/110>`_,
- `#111 <https://github.com/fmtlib/fmt/pull/111>`_
- `#112 <https://github.com/fmtlib/fmt/pull/112>`_).
- Thanks to `@CarterLi <https://github.com/CarterLi>`_.
- * Improved compile-time errors when formatting wide into narrow strings
- (`#117 <https://github.com/fmtlib/fmt/issues/117>`_).
- * Fixed ``BasicWriter::write`` without formatting arguments when C++11 support
- is disabled (`#109 <https://github.com/fmtlib/fmt/issues/109>`_).
- * Fixed header-only build on OS X with GCC 4.9
- (`#124 <https://github.com/fmtlib/fmt/issues/124>`_).
- * Fixed packaging issues (`#94 <https://github.com/fmtlib/fmt/issues/94>`_).
- * Added `changelog <https://github.com/fmtlib/fmt/blob/master/ChangeLog.rst>`_
- (`#103 <https://github.com/fmtlib/fmt/issues/103>`_).
- 1.0.0 - 2015-02-05
- ------------------
- * Add support for a header-only configuration when ``FMT_HEADER_ONLY`` is
- defined before including ``format.h``:
- .. code:: c++
- #define FMT_HEADER_ONLY
- #include "format.h"
- * Compute string length in the constructor of ``BasicStringRef``
- instead of the ``size`` method
- (`#79 <https://github.com/fmtlib/fmt/issues/79>`_).
- This eliminates size computation for string literals on reasonable optimizing
- compilers.
- * Fix formatting of types with overloaded ``operator <<`` for ``std::wostream``
- (`#86 <https://github.com/fmtlib/fmt/issues/86>`_):
- .. code:: c++
- fmt::format(L"The date is {0}", Date(2012, 12, 9));
- * Fix linkage of tests on Arch Linux
- (`#89 <https://github.com/fmtlib/fmt/issues/89>`_).
- * Allow precision specifier for non-float arguments
- (`#90 <https://github.com/fmtlib/fmt/issues/90>`_):
- .. code:: c++
- fmt::print("{:.3}\n", "Carpet"); // prints "Car"
- * Fix build on Android NDK
- (`#93 <https://github.com/fmtlib/fmt/issues/93>`_)
- * Improvements to documentation build procedure.
- * Remove ``FMT_SHARED`` CMake variable in favor of standard `BUILD_SHARED_LIBS
- <http://www.cmake.org/cmake/help/v3.0/variable/BUILD_SHARED_LIBS.html>`_.
- * Fix error handling in ``fmt::fprintf``.
- * Fix a number of warnings.
- 0.12.0 - 2014-10-25
- -------------------
- * [Breaking] Improved separation between formatting and buffer management.
- ``Writer`` is now a base class that cannot be instantiated directly.
- The new ``MemoryWriter`` class implements the default buffer management
- with small allocations done on stack. So ``fmt::Writer`` should be replaced
- with ``fmt::MemoryWriter`` in variable declarations.
- Old code:
- .. code:: c++
- fmt::Writer w;
- New code:
- .. code:: c++
- fmt::MemoryWriter w;
- If you pass ``fmt::Writer`` by reference, you can continue to do so:
- .. code:: c++
- void f(fmt::Writer &w);
- This doesn't affect the formatting API.
- * Support for custom memory allocators
- (`#69 <https://github.com/fmtlib/fmt/issues/69>`_)
- * Formatting functions now accept `signed char` and `unsigned char` strings as
- arguments (`#73 <https://github.com/fmtlib/fmt/issues/73>`_):
- .. code:: c++
- auto s = format("GLSL version: {}", glGetString(GL_VERSION));
- * Reduced code bloat. According to the new `benchmark results
- <https://github.com/fmtlib/fmt#compile-time-and-code-bloat>`_,
- cppformat is close to ``printf`` and by the order of magnitude better than
- Boost Format in terms of compiled code size.
- * Improved appearance of the documentation on mobile by using the `Sphinx
- Bootstrap theme <http://ryan-roemer.github.io/sphinx-bootstrap-theme/>`_:
- .. |old| image:: https://cloud.githubusercontent.com/assets/576385/4792130/
- cd256436-5de3-11e4-9a62-c077d0c2b003.png
- .. |new| image:: https://cloud.githubusercontent.com/assets/576385/4792131/
- cd29896c-5de3-11e4-8f59-cac952942bf0.png
-
- +-------+-------+
- | Old | New |
- +-------+-------+
- | |old| | |new| |
- +-------+-------+
- 0.11.0 - 2014-08-21
- -------------------
- * Safe printf implementation with a POSIX extension for positional arguments:
- .. code:: c++
- fmt::printf("Elapsed time: %.2f seconds", 1.23);
- fmt::printf("%1$s, %3$d %2$s", weekday, month, day);
- * Arguments of ``char`` type can now be formatted as integers
- (Issue `#55 <https://github.com/fmtlib/fmt/issues/55>`_):
- .. code:: c++
- fmt::format("0x{0:02X}", 'a');
- * Deprecated parts of the API removed.
- * The library is now built and tested on MinGW with Appveyor in addition to
- existing test platforms Linux/GCC, OS X/Clang, Windows/MSVC.
- 0.10.0 - 2014-07-01
- -------------------
- **Improved API**
- * All formatting methods are now implemented as variadic functions instead
- of using ``operator<<`` for feeding arbitrary arguments into a temporary
- formatter object. This works both with C++11 where variadic templates are
- used and with older standards where variadic functions are emulated by
- providing lightweight wrapper functions defined with the ``FMT_VARIADIC``
- macro. You can use this macro for defining your own portable variadic
- functions:
- .. code:: c++
- void report_error(const char *format, const fmt::ArgList &args) {
- fmt::print("Error: {}");
- fmt::print(format, args);
- }
- FMT_VARIADIC(void, report_error, const char *)
- report_error("file not found: {}", path);
- Apart from a more natural syntax, this also improves performance as there
- is no need to construct temporary formatter objects and control arguments'
- lifetimes. Because the wrapper functions are very lightweight, this doesn't
- cause code bloat even in pre-C++11 mode.
- * Simplified common case of formatting an ``std::string``. Now it requires a
- single function call:
- .. code:: c++
- std::string s = format("The answer is {}.", 42);
- Previously it required 2 function calls:
- .. code:: c++
- std::string s = str(Format("The answer is {}.") << 42);
- Instead of unsafe ``c_str`` function, ``fmt::Writer`` should be used directly
- to bypass creation of ``std::string``:
- .. code:: c++
- fmt::Writer w;
- w.write("The answer is {}.", 42);
- w.c_str(); // returns a C string
- This doesn't do dynamic memory allocation for small strings and is less error
- prone as the lifetime of the string is the same as for ``std::string::c_str``
- which is well understood (hopefully).
- * Improved consistency in naming functions that are a part of the public API.
- Now all public functions are lowercase following the standard library
- conventions. Previously it was a combination of lowercase and
- CapitalizedWords.
- Issue `#50 <https://github.com/fmtlib/fmt/issues/50>`_.
- * Old functions are marked as deprecated and will be removed in the next
- release.
- **Other Changes**
- * Experimental support for printf format specifications (work in progress):
- .. code:: c++
- fmt::printf("The answer is %d.", 42);
- std::string s = fmt::sprintf("Look, a %s!", "string");
- * Support for hexadecimal floating point format specifiers ``a`` and ``A``:
- .. code:: c++
- print("{:a}", -42.0); // Prints -0x1.5p+5
- print("{:A}", -42.0); // Prints -0X1.5P+5
- * CMake option ``FMT_SHARED`` that specifies whether to build format as a
- shared library (off by default).
- 0.9.0 - 2014-05-13
- ------------------
- * More efficient implementation of variadic formatting functions.
- * ``Writer::Format`` now has a variadic overload:
- .. code:: c++
- Writer out;
- out.Format("Look, I'm {}!", "variadic");
- * For efficiency and consistency with other overloads, variadic overload of
- the ``Format`` function now returns ``Writer`` instead of ``std::string``.
- Use the ``str`` function to convert it to ``std::string``:
- .. code:: c++
- std::string s = str(Format("Look, I'm {}!", "variadic"));
- * Replaced formatter actions with output sinks: ``NoAction`` -> ``NullSink``,
- ``Write`` -> ``FileSink``, ``ColorWriter`` -> ``ANSITerminalSink``.
- This improves naming consistency and shouldn't affect client code unless
- these classes are used directly which should be rarely needed.
- * Added ``ThrowSystemError`` function that formats a message and throws
- ``SystemError`` containing the formatted message and system-specific error
- description. For example, the following code
- .. code:: c++
- FILE *f = fopen(filename, "r");
- if (!f)
- ThrowSystemError(errno, "Failed to open file '{}'") << filename;
- will throw ``SystemError`` exception with description
- "Failed to open file '<filename>': No such file or directory" if file
- doesn't exist.
- * Support for AppVeyor continuous integration platform.
- * ``Format`` now throws ``SystemError`` in case of I/O errors.
- * Improve test infrastructure. Print functions are now tested by redirecting
- the output to a pipe.
- 0.8.0 - 2014-04-14
- ------------------
- * Initial release
|