12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091409240934094409540964097409840994100410141024103410441054106410741084109411041114112411341144115411641174118411941204121412241234124412541264127412841294130413141324133413441354136413741384139414041414142414341444145414641474148414941504151415241534154415541564157415841594160416141624163416441654166416741684169417041714172417341744175417641774178417941804181418241834184418541864187418841894190419141924193419441954196419741984199420042014202420342044205420642074208420942104211421242134214421542164217421842194220422142224223422442254226422742284229423042314232423342344235423642374238423942404241424242434244424542464247424842494250425142524253425442554256425742584259426042614262426342644265426642674268426942704271427242734274427542764277427842794280428142824283428442854286428742884289429042914292429342944295429642974298429943004301430243034304430543064307430843094310431143124313431443154316431743184319432043214322432343244325432643274328432943304331433243334334433543364337433843394340434143424343434443454346434743484349435043514352435343544355435643574358435943604361436243634364436543664367436843694370437143724373437443754376437743784379438043814382438343844385438643874388438943904391439243934394439543964397439843994400440144024403440444054406440744084409441044114412441344144415441644174418441944204421442244234424442544264427442844294430443144324433443444354436443744384439444044414442444344444445444644474448444944504451445244534454445544564457445844594460446144624463446444654466446744684469447044714472447344744475447644774478447944804481448244834484448544864487448844894490449144924493449444954496449744984499450045014502450345044505450645074508450945104511451245134514451545164517451845194520452145224523452445254526452745284529453045314532453345344535453645374538453945404541454245434544454545464547454845494550455145524553455445554556455745584559456045614562456345644565456645674568456945704571457245734574457545764577457845794580458145824583458445854586458745884589459045914592459345944595459645974598459946004601460246034604460546064607460846094610461146124613461446154616461746184619462046214622462346244625462646274628462946304631463246334634463546364637463846394640464146424643464446454646464746484649465046514652465346544655465646574658465946604661466246634664466546664667466846694670467146724673467446754676467746784679468046814682468346844685468646874688468946904691469246934694469546964697469846994700470147024703470447054706470747084709471047114712471347144715471647174718471947204721472247234724472547264727472847294730473147324733473447354736473747384739474047414742474347444745474647474748474947504751475247534754475547564757475847594760476147624763476447654766476747684769477047714772477347744775477647774778477947804781478247834784478547864787478847894790479147924793479447954796479747984799480048014802480348044805480648074808480948104811481248134814481548164817481848194820482148224823482448254826482748284829483048314832483348344835483648374838483948404841484248434844484548464847484848494850485148524853485448554856485748584859486048614862486348644865486648674868486948704871487248734874487548764877487848794880488148824883488448854886488748884889489048914892489348944895489648974898489949004901490249034904490549064907490849094910491149124913491449154916491749184919492049214922492349244925492649274928492949304931493249334934493549364937493849394940494149424943494449454946494749484949495049514952495349544955495649574958495949604961496249634964496549664967496849694970497149724973497449754976497749784979498049814982498349844985498649874988498949904991499249934994499549964997499849995000500150025003500450055006500750085009501050115012501350145015501650175018501950205021502250235024502550265027502850295030503150325033503450355036503750385039504050415042504350445045504650475048504950505051505250535054505550565057505850595060506150625063506450655066506750685069507050715072507350745075507650775078507950805081508250835084508550865087508850895090509150925093509450955096509750985099510051015102510351045105510651075108510951105111511251135114511551165117511851195120512151225123512451255126512751285129513051315132513351345135513651375138513951405141514251435144514551465147514851495150515151525153515451555156515751585159516051615162516351645165516651675168516951705171517251735174517551765177517851795180518151825183518451855186518751885189519051915192519351945195519651975198519952005201520252035204520552065207520852095210521152125213521452155216521752185219522052215222522352245225522652275228522952305231523252335234523552365237523852395240524152425243524452455246524752485249525052515252525352545255 |
- 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>`_,
- `#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 interferring 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
|