boost_macro_reference.html 264 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091409240934094409540964097409840994100410141024103410441054106410741084109411041114112411341144115411641174118411941204121412241234124412541264127412841294130413141324133413441354136413741384139414041414142414341444145414641474148414941504151415241534154415541564157415841594160416141624163416441654166416741684169417041714172417341744175417641774178417941804181418241834184418541864187418841894190419141924193419441954196419741984199420042014202420342044205420642074208420942104211421242134214421542164217421842194220422142224223422442254226422742284229423042314232423342344235423642374238423942404241424242434244424542464247424842494250425142524253425442554256425742584259426042614262426342644265426642674268426942704271427242734274427542764277427842794280428142824283428442854286428742884289429042914292429342944295429642974298429943004301430243034304430543064307430843094310431143124313431443154316431743184319432043214322432343244325432643274328432943304331433243334334433543364337433843394340434143424343434443454346434743484349435043514352435343544355435643574358435943604361436243634364436543664367436843694370437143724373437443754376437743784379438043814382438343844385438643874388438943904391439243934394439543964397439843994400440144024403440444054406440744084409441044114412441344144415441644174418441944204421442244234424442544264427442844294430443144324433443444354436443744384439444044414442444344444445444644474448444944504451445244534454445544564457445844594460446144624463446444654466446744684469447044714472447344744475447644774478447944804481448244834484448544864487448844894490449144924493449444954496449744984499450045014502450345044505450645074508450945104511451245134514451545164517451845194520452145224523452445254526452745284529453045314532453345344535453645374538453945404541454245434544454545464547454845494550455145524553455445554556455745584559456045614562456345644565456645674568456945704571457245734574457545764577457845794580458145824583458445854586458745884589459045914592459345944595459645974598459946004601460246034604460546064607460846094610461146124613461446154616461746184619462046214622462346244625462646274628462946304631463246334634463546364637463846394640464146424643464446454646464746484649465046514652465346544655465646574658465946604661466246634664466546664667466846694670467146724673467446754676467746784679468046814682468346844685468646874688468946904691469246934694469546964697469846994700470147024703470447054706470747084709471047114712471347144715471647174718471947204721472247234724472547264727472847294730473147324733473447354736473747384739474047414742474347444745474647474748474947504751475247534754475547564757475847594760476147624763476447654766476747684769477047714772477347744775477647774778477947804781478247834784478547864787478847894790479147924793479447954796479747984799480048014802480348044805480648074808480948104811481248134814481548164817481848194820482148224823482448254826482748284829483048314832483348344835483648374838483948404841484248434844484548464847484848494850485148524853485448554856485748584859486048614862486348644865486648674868486948704871487248734874487548764877487848794880488148824883488448854886488748884889489048914892489348944895489648974898489949004901490249034904490549064907490849094910491149124913491449154916491749184919492049214922492349244925492649274928492949304931493249334934493549364937493849394940494149424943494449454946494749484949495049514952495349544955495649574958495949604961496249634964496549664967496849694970497149724973497449754976497749784979498049814982498349844985498649874988498949904991499249934994499549964997499849995000500150025003500450055006500750085009501050115012501350145015501650175018501950205021502250235024502550265027502850295030503150325033503450355036503750385039504050415042504350445045504650475048504950505051505250535054505550565057505850595060506150625063506450655066506750685069507050715072507350745075507650775078507950805081508250835084508550865087508850895090509150925093509450955096509750985099510051015102510351045105510651075108510951105111511251135114511551165117511851195120512151225123512451255126512751285129513051315132513351345135513651375138513951405141514251435144514551465147514851495150515151525153515451555156515751585159516051615162516351645165516651675168516951705171517251735174517551765177517851795180518151825183518451855186518751885189519051915192519351945195519651975198519952005201520252035204520552065207520852095210521152125213521452155216521752185219522052215222522352245225522652275228522952305231523252335234523552365237523852395240524152425243524452455246524752485249525052515252525352545255525652575258525952605261526252635264526552665267526852695270527152725273527452755276527752785279528052815282528352845285528652875288528952905291529252935294529552965297529852995300530153025303530453055306530753085309531053115312531353145315531653175318531953205321532253235324532553265327532853295330533153325333533453355336533753385339534053415342534353445345534653475348534953505351535253535354535553565357535853595360536153625363536453655366536753685369537053715372537353745375537653775378537953805381538253835384538553865387538853895390539153925393539453955396539753985399540054015402540354045405540654075408540954105411541254135414541554165417541854195420542154225423542454255426542754285429543054315432543354345435543654375438543954405441544254435444544554465447544854495450545154525453545454555456545754585459546054615462546354645465546654675468546954705471547254735474547554765477547854795480548154825483548454855486548754885489549054915492549354945495549654975498549955005501550255035504550555065507550855095510551155125513551455155516551755185519552055215522552355245525552655275528552955305531553255335534553555365537553855395540554155425543554455455546554755485549555055515552555355545555555655575558555955605561556255635564556555665567556855695570557155725573557455755576557755785579558055815582558355845585558655875588558955905591559255935594559555965597559855995600560156025603560456055606560756085609561056115612561356145615561656175618561956205621562256235624562556265627562856295630563156325633563456355636563756385639564056415642564356445645564656475648564956505651565256535654565556565657565856595660566156625663566456655666566756685669567056715672567356745675567656775678567956805681568256835684568556865687568856895690569156925693569456955696569756985699570057015702570357045705570657075708570957105711571257135714571557165717571857195720572157225723572457255726572757285729573057315732573357345735573657375738573957405741574257435744574557465747574857495750575157525753575457555756575757585759576057615762576357645765576657675768576957705771577257735774577557765777577857795780578157825783578457855786578757885789579057915792579357945795579657975798579958005801580258035804580558065807580858095810581158125813581458155816581758185819582058215822582358245825582658275828582958305831583258335834583558365837583858395840584158425843584458455846584758485849585058515852585358545855585658575858585958605861586258635864586558665867586858695870587158725873587458755876587758785879588058815882588358845885588658875888588958905891589258935894589558965897589858995900590159025903590459055906590759085909591059115912591359145915591659175918591959205921592259235924592559265927592859295930593159325933593459355936593759385939594059415942594359445945594659475948594959505951595259535954595559565957595859595960596159625963596459655966596759685969597059715972597359745975597659775978597959805981598259835984598559865987598859895990599159925993599459955996599759985999600060016002600360046005600660076008600960106011601260136014601560166017601860196020602160226023602460256026602760286029603060316032603360346035603660376038603960406041604260436044604560466047604860496050605160526053605460556056605760586059606060616062606360646065606660676068606960706071607260736074607560766077607860796080608160826083608460856086608760886089609060916092609360946095609660976098609961006101610261036104610561066107610861096110611161126113611461156116611761186119612061216122612361246125612661276128612961306131613261336134613561366137613861396140614161426143614461456146614761486149615061516152615361546155615661576158615961606161616261636164616561666167616861696170617161726173617461756176617761786179618061816182618361846185618661876188618961906191619261936194619561966197619861996200620162026203620462056206620762086209621062116212621362146215621662176218621962206221622262236224622562266227622862296230623162326233623462356236623762386239624062416242624362446245624662476248624962506251625262536254625562566257625862596260626162626263626462656266626762686269627062716272627362746275627662776278627962806281628262836284628562866287628862896290629162926293629462956296629762986299630063016302630363046305630663076308630963106311631263136314631563166317631863196320632163226323632463256326632763286329633063316332633363346335633663376338633963406341634263436344634563466347634863496350635163526353635463556356635763586359636063616362636363646365636663676368636963706371637263736374637563766377637863796380638163826383638463856386638763886389639063916392639363946395639663976398639964006401640264036404640564066407640864096410641164126413641464156416641764186419642064216422642364246425642664276428642964306431643264336434643564366437643864396440644164426443644464456446644764486449645064516452645364546455645664576458645964606461646264636464646564666467646864696470647164726473647464756476647764786479648064816482648364846485648664876488648964906491
  1. <html>
  2. <head>
  3. <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
  4. <title>Boost Macro Reference</title>
  5. <link rel="stylesheet" href="../../../../../doc/src/boostbook.css" type="text/css">
  6. <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
  7. <link rel="home" href="../index.html" title="Boost.Config">
  8. <link rel="up" href="../index.html" title="Boost.Config">
  9. <link rel="prev" href="../index.html" title="Boost.Config">
  10. <link rel="next" href="build_config.html" title="Build Time Configuration">
  11. </head>
  12. <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  13. <table cellpadding="2" width="100%"><tr>
  14. <td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
  15. <td align="center"><a href="../../../../../index.html">Home</a></td>
  16. <td align="center"><a href="../../../../../libs/libraries.htm">Libraries</a></td>
  17. <td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
  18. <td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
  19. <td align="center"><a href="../../../../../more/index.htm">More</a></td>
  20. </tr></table>
  21. <hr>
  22. <div class="spirit-nav">
  23. <a accesskey="p" href="../index.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="build_config.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
  24. </div>
  25. <div class="section">
  26. <div class="titlepage"><div><div><h2 class="title" style="clear: both">
  27. <a name="boost_config.boost_macro_reference"></a><a class="link" href="boost_macro_reference.html" title="Boost Macro Reference">Boost Macro Reference</a>
  28. </h2></div></div></div>
  29. <div class="toc"><dl class="toc">
  30. <dt><span class="section"><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_describe_c__03_defects">Macros
  31. that describe C++03 defects</a></span></dt>
  32. <dt><span class="section"><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_describe_optional_features">Macros
  33. that describe optional features</a></span></dt>
  34. <dt><span class="section"><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_describe_possible_c___future_features">Macros
  35. that describe possible C++ future features</a></span></dt>
  36. <dt><span class="section"><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_describe_c__11_features_not_supported">Macros
  37. that describe C++11 features not supported</a></span></dt>
  38. <dt><span class="section"><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_allow_use_of_c__11_features_with_c__03_compilers">Macros
  39. that allow use of C++11 features with C++03 compilers</a></span></dt>
  40. <dt><span class="section"><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_describe_c__14_features_not_supported">Macros
  41. that describe C++14 features not supported</a></span></dt>
  42. <dt><span class="section"><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_allow_use_of_c__14_features_with_c__11_or_earlier_compilers">Macros
  43. that allow use of C++14 features with C++11 or earlier compilers</a></span></dt>
  44. <dt><span class="section"><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_describe_c__17_features_not_supported">Macros
  45. that describe C++17 features not supported</a></span></dt>
  46. <dt><span class="section"><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_allow_use_of_c__17_features_with_c__14_or_earlier_compilers">Macros
  47. that allow use of C++17 features with C++14 or earlier compilers</a></span></dt>
  48. <dt><span class="section"><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_describe_features_that_have_been_removed_from_the_standard_">Macros
  49. that describe features that have been removed from the standard.</a></span></dt>
  50. <dt><span class="section"><a href="boost_macro_reference.html#boost_config.boost_macro_reference.boost_helper_macros">Boost
  51. Helper Macros</a></span></dt>
  52. <dt><span class="section"><a href="boost_macro_reference.html#boost_config.boost_macro_reference.boost_informational_macros">Boost
  53. Informational Macros</a></span></dt>
  54. <dt><span class="section"><a href="boost_macro_reference.html#boost_config.boost_macro_reference.boost_deprecated_macros">Boost
  55. Deprecated Macros</a></span></dt>
  56. <dt><span class="section"><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code">Macros
  57. for libraries with separate source code</a></span></dt>
  58. </dl></div>
  59. <div class="section">
  60. <div class="titlepage"><div><div><h3 class="title">
  61. <a name="boost_config.boost_macro_reference.macros_that_describe_c__03_defects"></a><a name="config_defects"></a><a class="link" href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_describe_c__03_defects" title="Macros that describe C++03 defects">Macros
  62. that describe C++03 defects</a>
  63. </h3></div></div></div>
  64. <p>
  65. The following macros all describe features that are required by the C++03
  66. standard, if one of the following macros is defined, then it represents a
  67. defect in the compiler's conformance with the 2003 standard.
  68. </p>
  69. <div class="informaltable"><table class="table">
  70. <colgroup>
  71. <col>
  72. <col>
  73. <col>
  74. </colgroup>
  75. <thead><tr>
  76. <th>
  77. <p>
  78. Macro
  79. </p>
  80. </th>
  81. <th>
  82. <p>
  83. Section
  84. </p>
  85. </th>
  86. <th>
  87. <p>
  88. Description
  89. </p>
  90. </th>
  91. </tr></thead>
  92. <tbody>
  93. <tr>
  94. <td>
  95. <p>
  96. <code class="computeroutput"><span class="identifier">BOOST_BCB_PARTIAL_SPECIALIZATION_BUG</span></code>
  97. </p>
  98. </td>
  99. <td>
  100. <p>
  101. Compiler
  102. </p>
  103. </td>
  104. <td>
  105. <p>
  106. The compiler exhibits certain partial specialisation bug - probably
  107. Borland C++ Builder specific.
  108. </p>
  109. </td>
  110. </tr>
  111. <tr>
  112. <td>
  113. <p>
  114. <code class="computeroutput"><span class="identifier">BOOST_FUNCTION_SCOPE_USING_DECLARATION_BREAKS_ADL</span></code>
  115. </p>
  116. </td>
  117. <td>
  118. <p>
  119. Compiler
  120. </p>
  121. </td>
  122. <td>
  123. <p>
  124. Argument dependent lookup fails if there is a using declaration
  125. for the symbol being looked up in the current scope. For example,
  126. using <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">get_pointer</span></code>; prevents ADL from
  127. finding overloads of <code class="computeroutput"><span class="identifier">get_pointer</span></code>
  128. in namespaces nested inside boost (but not elsewhere). Probably
  129. Borland specific.
  130. </p>
  131. </td>
  132. </tr>
  133. <tr>
  134. <td>
  135. <p>
  136. <code class="computeroutput"><span class="identifier">BOOST_NO_ADL_BARRIER</span></code>
  137. </p>
  138. </td>
  139. <td>
  140. <p>
  141. Compiler
  142. </p>
  143. </td>
  144. <td>
  145. <p>
  146. The compiler locates and searches namespaces that it should <span class="emphasis"><em>*not*</em></span>
  147. in fact search when performing argument dependent lookup.
  148. </p>
  149. </td>
  150. </tr>
  151. <tr>
  152. <td>
  153. <p>
  154. <code class="computeroutput"><span class="identifier">BOOST_NO_ARGUMENT_DEPENDENT_LOOKUP</span></code>
  155. </p>
  156. </td>
  157. <td>
  158. <p>
  159. Compiler
  160. </p>
  161. </td>
  162. <td>
  163. <p>
  164. Compiler does not implement argument-dependent lookup (also named
  165. Koenig lookup); see std::3.4.2 [basic.koenig.lookup]
  166. </p>
  167. </td>
  168. </tr>
  169. <tr>
  170. <td>
  171. <p>
  172. <code class="computeroutput"><span class="identifier">BOOST_NO_AUTO_PTR</span></code>
  173. </p>
  174. </td>
  175. <td>
  176. <p>
  177. Standard library
  178. </p>
  179. </td>
  180. <td>
  181. <p>
  182. If the compiler / library supplies non-standard or broken <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">auto_ptr</span></code>.
  183. </p>
  184. </td>
  185. </tr>
  186. <tr>
  187. <td>
  188. <p>
  189. <code class="computeroutput"><span class="identifier">BOOST_NO_COMPLETE_VALUE_INITIALIZATION</span></code>
  190. </p>
  191. </td>
  192. <td>
  193. <p>
  194. Compiler
  195. </p>
  196. </td>
  197. <td>
  198. <p>
  199. Compiler has not completely implemented value-initialization. See
  200. also <a href="../../../../utility/value_init.htm#compiler_issues" target="_top">The
  201. Utility/Value Init docs</a>
  202. </p>
  203. </td>
  204. </tr>
  205. <tr>
  206. <td>
  207. <p>
  208. <code class="computeroutput"><span class="identifier">BOOST_NO_CTYPE_FUNCTIONS</span></code>
  209. </p>
  210. </td>
  211. <td>
  212. <p>
  213. Platform
  214. </p>
  215. </td>
  216. <td>
  217. <p>
  218. The Platform does not provide functions for the character-classifying
  219. operations <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">ctype</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span></code> and <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">cctype</span><span class="special">&gt;</span></code>,
  220. only macros.
  221. </p>
  222. </td>
  223. </tr>
  224. <tr>
  225. <td>
  226. <p>
  227. <code class="computeroutput"><span class="identifier">BOOST_NO_CV_SPECIALIZATIONS</span></code>
  228. </p>
  229. </td>
  230. <td>
  231. <p>
  232. Compiler
  233. </p>
  234. </td>
  235. <td>
  236. <p>
  237. If template specialisations for cv-qualified types conflict with
  238. a specialisation for a cv-unqualififed type.
  239. </p>
  240. </td>
  241. </tr>
  242. <tr>
  243. <td>
  244. <p>
  245. <code class="computeroutput"><span class="identifier">BOOST_NO_CV_VOID_SPECIALIZATIONS</span></code>
  246. </p>
  247. </td>
  248. <td>
  249. <p>
  250. Compiler
  251. </p>
  252. </td>
  253. <td>
  254. <p>
  255. If template specialisations for cv-void types conflict with a specialisation
  256. for void.
  257. </p>
  258. </td>
  259. </tr>
  260. <tr>
  261. <td>
  262. <p>
  263. <code class="computeroutput"><span class="identifier">BOOST_NO_CWCHAR</span></code>
  264. </p>
  265. </td>
  266. <td>
  267. <p>
  268. Platform
  269. </p>
  270. </td>
  271. <td>
  272. <p>
  273. The Platform does not provide <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">wchar</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span></code>
  274. and <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">cwchar</span><span class="special">&gt;</span></code>.
  275. </p>
  276. </td>
  277. </tr>
  278. <tr>
  279. <td>
  280. <p>
  281. <code class="computeroutput"><span class="identifier">BOOST_NO_CWCTYPE</span></code>
  282. </p>
  283. </td>
  284. <td>
  285. <p>
  286. Platform
  287. </p>
  288. </td>
  289. <td>
  290. <p>
  291. The Platform does not provide <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">wctype</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span></code>
  292. and <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">cwctype</span><span class="special">&gt;</span></code>.
  293. </p>
  294. </td>
  295. </tr>
  296. <tr>
  297. <td>
  298. <p>
  299. <code class="computeroutput"><span class="identifier">BOOST_NO_FENV_H</span></code>
  300. </p>
  301. </td>
  302. <td>
  303. <p>
  304. Platform, Standard library
  305. </p>
  306. </td>
  307. <td>
  308. <p>
  309. The C standard library doesn't provide <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">fenv</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span></code>.
  310. <a href="../../../../../boost/detail/fenv.hpp" target="_top"><code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">detail</span><span class="special">/</span><span class="identifier">fenv</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code></a>
  311. should be included instead of <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">fenv</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span></code>
  312. for maximum portability on platforms which do provide <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">fenv</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span></code>.
  313. </p>
  314. </td>
  315. </tr>
  316. <tr>
  317. <td>
  318. <p>
  319. <code class="computeroutput"><span class="identifier">BOOST_NO_DEPENDENT_NESTED_DERIVATIONS</span></code>
  320. </p>
  321. </td>
  322. <td>
  323. <p>
  324. Compiler
  325. </p>
  326. </td>
  327. <td>
  328. <p>
  329. The compiler fails to compile a nested class that has a dependent
  330. base class:
  331. </p>
  332. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
  333. <span class="keyword">struct</span> <span class="identifier">foo</span> <span class="special">:</span> <span class="special">{</span>
  334. <span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">U</span><span class="special">&gt;</span>
  335. <span class="keyword">struct</span> <span class="identifier">bar</span> <span class="special">:</span> <span class="keyword">public</span> <span class="identifier">U</span> <span class="special">{};</span>
  336. </pre>
  337. <p>
  338. };
  339. </p>
  340. </td>
  341. </tr>
  342. <tr>
  343. <td>
  344. <p>
  345. <code class="computeroutput"><span class="identifier">BOOST_NO_DEPENDENT_TYPES_IN_TEMPLATE_VALUE_PARAMETERS</span></code>
  346. </p>
  347. </td>
  348. <td>
  349. <p>
  350. Compiler
  351. </p>
  352. </td>
  353. <td>
  354. <p>
  355. Template value parameters cannot have a dependent type, for example:
  356. </p>
  357. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">class</span> <span class="identifier">T</span><span class="special">,</span> <span class="keyword">typename</span> <span class="identifier">T</span><span class="special">::</span><span class="identifier">type</span> <span class="identifier">value</span><span class="special">&gt;</span>
  358. <span class="keyword">class</span> <span class="identifier">X</span> <span class="special">{</span> <span class="special">...</span> <span class="special">};</span>
  359. </pre>
  360. <p>
  361. </p>
  362. </td>
  363. </tr>
  364. <tr>
  365. <td>
  366. <p>
  367. <code class="computeroutput"><span class="identifier">BOOST_NO_EXCEPTION_STD_NAMESPACE</span></code>
  368. </p>
  369. </td>
  370. <td>
  371. <p>
  372. Standard Library
  373. </p>
  374. </td>
  375. <td>
  376. <p>
  377. The standard library does not put some or all of the contents of
  378. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">exception</span><span class="special">&gt;</span></code> in namespace std.
  379. </p>
  380. </td>
  381. </tr>
  382. <tr>
  383. <td>
  384. <p>
  385. <code class="computeroutput"><span class="identifier">BOOST_NO_EXCEPTIONS</span></code>
  386. </p>
  387. </td>
  388. <td>
  389. <p>
  390. Compiler
  391. </p>
  392. </td>
  393. <td>
  394. <p>
  395. The compiler does not support exception handling (this setting
  396. is typically required by many C++ compilers for embedded platforms).
  397. Note that there is no requirement for boost libraries to honor
  398. this configuration setting - indeed doing so may be impossible
  399. in some cases. Those libraries that do honor this will typically
  400. abort if a critical error occurs - you have been warned!
  401. </p>
  402. </td>
  403. </tr>
  404. <tr>
  405. <td>
  406. <p>
  407. <code class="computeroutput"><span class="identifier">BOOST_NO_FUNCTION_TEMPLATE_ORDERING</span></code>
  408. </p>
  409. </td>
  410. <td>
  411. <p>
  412. Compiler
  413. </p>
  414. </td>
  415. <td>
  416. <p>
  417. The compiler does not perform function template ordering or its
  418. function template ordering is incorrect.
  419. </p>
  420. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="comment">// #1</span>
  421. <span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">class</span> <span class="identifier">T</span><span class="special">&gt;</span> <span class="keyword">void</span> <span class="identifier">f</span><span class="special">(</span><span class="identifier">T</span><span class="special">);</span>
  422. <span class="comment">// #2</span>
  423. <span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">class</span> <span class="identifier">T</span><span class="special">,</span><span class="keyword">class</span> <span class="identifier">U</span><span class="special">&gt;</span> <span class="keyword">void</span> <span class="identifier">f</span><span class="special">(</span><span class="identifier">T</span><span class="special">(*)(</span><span class="identifier">U</span><span class="special">));</span>
  424. <span class="keyword">void</span> <span class="identifier">bar</span><span class="special">(</span><span class="keyword">int</span><span class="special">);</span>
  425. <span class="identifier">f</span><span class="special">(&amp;</span><span class="identifier">bar</span><span class="special">);</span> <span class="comment">// should choose #2.</span>
  426. </pre>
  427. <p>
  428. </p>
  429. </td>
  430. </tr>
  431. <tr>
  432. <td>
  433. <p>
  434. <code class="computeroutput"><span class="identifier">BOOST_NO_INCLASS_MEMBER_INITIALIZATION</span></code>
  435. </p>
  436. </td>
  437. <td>
  438. <p>
  439. Compiler
  440. </p>
  441. </td>
  442. <td>
  443. <p>
  444. Compiler violates std::9.4.2/4.
  445. </p>
  446. </td>
  447. </tr>
  448. <tr>
  449. <td>
  450. <p>
  451. <code class="computeroutput"><span class="identifier">BOOST_NO_INTRINSIC_WCHAR_T</span></code>
  452. </p>
  453. </td>
  454. <td>
  455. <p>
  456. Compiler
  457. </p>
  458. </td>
  459. <td>
  460. <p>
  461. The C++ implementation does not provide <code class="computeroutput"><span class="keyword">wchar_t</span></code>,
  462. or it is really a synonym for another integral type. Use this symbol
  463. to decide whether it is appropriate to explicitly specialize a
  464. template on <code class="computeroutput"><span class="keyword">wchar_t</span></code>
  465. if there is already a specialization for other integer types.
  466. </p>
  467. </td>
  468. </tr>
  469. <tr>
  470. <td>
  471. <p>
  472. <code class="computeroutput"><span class="identifier">BOOST_NO_IOSFWD</span></code>
  473. </p>
  474. </td>
  475. <td>
  476. <p>
  477. std lib
  478. </p>
  479. </td>
  480. <td>
  481. <p>
  482. The standard library lacks <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">iosfwd</span><span class="special">&gt;</span></code>.
  483. </p>
  484. </td>
  485. </tr>
  486. <tr>
  487. <td>
  488. <p>
  489. <code class="computeroutput"><span class="identifier">BOOST_NO_IOSTREAM</span></code>
  490. </p>
  491. </td>
  492. <td>
  493. <p>
  494. std lib
  495. </p>
  496. </td>
  497. <td>
  498. <p>
  499. The standard library lacks <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">iostream</span><span class="special">&gt;</span></code>,
  500. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">istream</span><span class="special">&gt;</span></code> or <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">ostream</span><span class="special">&gt;</span></code>.
  501. </p>
  502. </td>
  503. </tr>
  504. <tr>
  505. <td>
  506. <p>
  507. <code class="computeroutput"><span class="identifier">BOOST_NO_IS_ABSTRACT</span></code>
  508. </p>
  509. </td>
  510. <td>
  511. <p>
  512. Compiler
  513. </p>
  514. </td>
  515. <td>
  516. <p>
  517. The C++ compiler does not support SFINAE with abstract types, this
  518. is covered by <a href="http://www.open-std.org/jtc1/sc22/wg21/docs/cwg_defects.html#337" target="_top">Core
  519. Language DR337</a>, but is not part of the current standard.
  520. Fortunately most compilers that support SFINAE also support this
  521. DR. See also BOOST_NO_SFINAE and BOOST_NO_SFINAE_EXPR
  522. </p>
  523. </td>
  524. </tr>
  525. <tr>
  526. <td>
  527. <p>
  528. <code class="computeroutput"><span class="identifier">BOOST_NO_LIMITS</span></code>
  529. </p>
  530. </td>
  531. <td>
  532. <p>
  533. Standard library
  534. </p>
  535. </td>
  536. <td>
  537. <p>
  538. The C++ implementation does not provide the <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">limits</span><span class="special">&gt;</span></code>
  539. header. Never check for this symbol in library code; always include
  540. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">limits</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>, which guarantees to provide
  541. <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">numeric_limits</span></code>.
  542. </p>
  543. </td>
  544. </tr>
  545. <tr>
  546. <td>
  547. <p>
  548. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_NUMERIC_LIMITS</span></code>
  549. </p>
  550. </td>
  551. <td>
  552. <p>
  553. Standard library
  554. </p>
  555. </td>
  556. <td>
  557. <p>
  558. C++11 additions to <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">numeric_limits</span></code>
  559. are not available for use. <code class="computeroutput"><span class="keyword">static</span>
  560. <span class="identifier">function</span> <span class="identifier">numeric_limits</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;::</span><span class="identifier">lowest</span><span class="special">()</span></code> the lowest finite value representable
  561. by the numeric type. <code class="computeroutput"><span class="keyword">static</span>
  562. <span class="keyword">int</span> <span class="keyword">const</span>
  563. <span class="identifier">max_digits10</span></code> the number
  564. of decimal digits that are required to make sure that two distinct
  565. values of the type have distinct decimal representations. <code class="computeroutput"><span class="keyword">template</span><span class="special">&lt;&gt;</span>
  566. <span class="keyword">class</span> <span class="identifier">numeric_limits</span><span class="special">&lt;</span><span class="keyword">char16_t</span><span class="special">&gt;;</span></code>, see also <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_CHAR16_T</span></code>,
  567. <code class="computeroutput"><span class="keyword">template</span><span class="special">&lt;&gt;</span>
  568. <span class="keyword">class</span> <span class="identifier">numeric_limits</span><span class="special">&lt;</span><span class="keyword">char32_t</span><span class="special">&gt;;</span></code> see also <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_CHAR32_T</span></code>.
  569. Replaces BOOST_NO_NUMERIC_LIMITS_LOWEST.
  570. </p>
  571. </td>
  572. </tr>
  573. <tr>
  574. <td>
  575. <p>
  576. <code class="computeroutput"><span class="identifier">BOOST_NO_LIMITS_COMPILE_TIME_CONSTANTS</span></code>
  577. </p>
  578. </td>
  579. <td>
  580. <p>
  581. Standard library
  582. </p>
  583. </td>
  584. <td>
  585. <p>
  586. Constants such as <code class="computeroutput"><span class="identifier">numeric_limits</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;::</span><span class="identifier">is_signed</span></code>
  587. are not available for use at compile-time.
  588. </p>
  589. </td>
  590. </tr>
  591. <tr>
  592. <td>
  593. <p>
  594. <code class="computeroutput"><span class="identifier">BOOST_NO_LONG_LONG_NUMERIC_LIMITS</span></code>
  595. </p>
  596. </td>
  597. <td>
  598. <p>
  599. Standard library
  600. </p>
  601. </td>
  602. <td>
  603. <p>
  604. There is no specialization for <code class="computeroutput"><span class="identifier">numeric_limits</span><span class="special">&lt;</span><span class="keyword">long</span>
  605. <span class="keyword">long</span><span class="special">&gt;</span></code>
  606. and <code class="computeroutput"><span class="identifier">numeric_limits</span><span class="special">&lt;</span><span class="keyword">unsigned</span>
  607. <span class="keyword">long</span> <span class="keyword">long</span><span class="special">&gt;</span></code>. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">limits</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>
  608. will then add these specializations as a standard library "fix"
  609. only if the compiler supports the <code class="computeroutput"><span class="keyword">long</span>
  610. <span class="keyword">long</span></code> datatype.
  611. </p>
  612. </td>
  613. </tr>
  614. <tr>
  615. <td>
  616. <p>
  617. <code class="computeroutput"><span class="identifier">BOOST_NO_MEMBER_FUNCTION_SPECIALIZATIONS</span></code>
  618. </p>
  619. </td>
  620. <td>
  621. <p>
  622. Compiler
  623. </p>
  624. </td>
  625. <td>
  626. <p>
  627. The compiler does not support the specialization of individual
  628. member functions of template classes.
  629. </p>
  630. </td>
  631. </tr>
  632. <tr>
  633. <td>
  634. <p>
  635. <code class="computeroutput"><span class="identifier">BOOST_NO_MEMBER_TEMPLATE_KEYWORD</span></code>
  636. </p>
  637. </td>
  638. <td>
  639. <p>
  640. Compiler
  641. </p>
  642. </td>
  643. <td>
  644. <p>
  645. If the compiler supports member templates, but not the template
  646. keyword when accessing member template classes.
  647. </p>
  648. </td>
  649. </tr>
  650. <tr>
  651. <td>
  652. <p>
  653. <code class="computeroutput"><span class="identifier">BOOST_NO_MEMBER_TEMPLATE_FRIENDS</span></code>
  654. </p>
  655. </td>
  656. <td>
  657. <p>
  658. Compiler
  659. </p>
  660. </td>
  661. <td>
  662. <p>
  663. Member template friend syntax (<code class="computeroutput"><span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">class</span>
  664. <span class="identifier">P</span><span class="special">&gt;</span>
  665. <span class="keyword">friend</span> <span class="keyword">class</span>
  666. <span class="identifier">frd</span><span class="special">;</span></code>)
  667. described in the C++ Standard, 14.5.3, not supported.
  668. </p>
  669. </td>
  670. </tr>
  671. <tr>
  672. <td>
  673. <p>
  674. <code class="computeroutput"><span class="identifier">BOOST_NO_MEMBER_TEMPLATES</span></code>
  675. </p>
  676. </td>
  677. <td>
  678. <p>
  679. Compiler
  680. </p>
  681. </td>
  682. <td>
  683. <p>
  684. Member template functions not fully supported.
  685. </p>
  686. </td>
  687. </tr>
  688. <tr>
  689. <td>
  690. <p>
  691. <code class="computeroutput"><span class="identifier">BOOST_NO_MS_INT64_NUMERIC_LIMITS</span></code>
  692. </p>
  693. </td>
  694. <td>
  695. <p>
  696. Standard library
  697. </p>
  698. </td>
  699. <td>
  700. <p>
  701. There is no specialization for <code class="computeroutput"><span class="identifier">numeric_limits</span><span class="special">&lt;</span><span class="identifier">__int64</span><span class="special">&gt;</span></code> and <code class="computeroutput"><span class="identifier">numeric_limits</span><span class="special">&lt;</span><span class="keyword">unsigned</span>
  702. <span class="identifier">__int64</span><span class="special">&gt;</span></code>.
  703. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">limits</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code> will then add these specializations
  704. as a standard library "fix", only if the compiler supports
  705. the <code class="computeroutput"><span class="identifier">__int64</span></code> datatype.
  706. </p>
  707. </td>
  708. </tr>
  709. <tr>
  710. <td>
  711. <p>
  712. <code class="computeroutput"><span class="identifier">BOOST_NO_NESTED_FRIENDSHIP</span></code>
  713. </p>
  714. </td>
  715. <td>
  716. <p>
  717. Compiler
  718. </p>
  719. </td>
  720. <td>
  721. <p>
  722. Compiler doesn't allow a nested class to access private members
  723. of its containing class. Probably Borland/CodeGear specific.
  724. </p>
  725. </td>
  726. </tr>
  727. <tr>
  728. <td>
  729. <p>
  730. <code class="computeroutput"><span class="identifier">BOOST_NO_OPERATORS_IN_NAMESPACE</span></code>
  731. </p>
  732. </td>
  733. <td>
  734. <p>
  735. Compiler
  736. </p>
  737. </td>
  738. <td>
  739. <p>
  740. Compiler requires inherited operator friend functions to be defined
  741. at namespace scope, then using'ed to boost. Probably GCC specific.
  742. See <a href="../../../../../boost/operators.hpp" target="_top"><code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">operators</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code></a> for example.
  743. </p>
  744. </td>
  745. </tr>
  746. <tr>
  747. <td>
  748. <p>
  749. <code class="computeroutput"><span class="identifier">BOOST_NO_PARTIAL_SPECIALIZATION_IMPLICIT_DEFAULT_ARGS</span></code>
  750. </p>
  751. </td>
  752. <td>
  753. <p>
  754. Compiler
  755. </p>
  756. </td>
  757. <td>
  758. <p>
  759. The compiler does not correctly handle partial specializations
  760. which depend upon default arguments in the primary template.
  761. </p>
  762. </td>
  763. </tr>
  764. <tr>
  765. <td>
  766. <p>
  767. <code class="computeroutput"><span class="identifier">BOOST_NO_POINTER_TO_MEMBER_CONST</span></code>
  768. </p>
  769. </td>
  770. <td>
  771. <p>
  772. Compiler
  773. </p>
  774. </td>
  775. <td>
  776. <p>
  777. The compiler does not correctly handle pointers to const member
  778. functions, preventing use of these in overloaded function templates.
  779. See <a href="../../../../../boost/functional.hpp" target="_top"><code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">functional</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code></a> for example.
  780. </p>
  781. </td>
  782. </tr>
  783. <tr>
  784. <td>
  785. <p>
  786. <code class="computeroutput"><span class="identifier">BOOST_NO_POINTER_TO_MEMBER_TEMPLATE_PARAMETERS</span></code>
  787. </p>
  788. </td>
  789. <td>
  790. <p>
  791. Compiler
  792. </p>
  793. </td>
  794. <td>
  795. <p>
  796. Pointers to members don't work when used as template parameters.
  797. </p>
  798. </td>
  799. </tr>
  800. <tr>
  801. <td>
  802. <p>
  803. <code class="computeroutput"><span class="identifier">BOOST_NO_PRIVATE_IN_AGGREGATE</span></code>
  804. </p>
  805. </td>
  806. <td>
  807. <p>
  808. Compiler
  809. </p>
  810. </td>
  811. <td>
  812. <p>
  813. The compiler misreads 8.5.1, treating classes as non-aggregate
  814. if they contain private or protected member functions.
  815. </p>
  816. </td>
  817. </tr>
  818. <tr>
  819. <td>
  820. <p>
  821. <code class="computeroutput"><span class="identifier">BOOST_NO_RESTRICT_REFERENCES</span></code>
  822. </p>
  823. </td>
  824. <td>
  825. <p>
  826. Compiler
  827. </p>
  828. </td>
  829. <td>
  830. <p>
  831. Compiler-specific <code class="computeroutput"><span class="identifier">restrict</span></code>
  832. keyword can not be applied to references.
  833. </p>
  834. </td>
  835. </tr>
  836. <tr>
  837. <td>
  838. <p>
  839. <code class="computeroutput"><span class="identifier">BOOST_NO_RTTI</span></code>
  840. </p>
  841. </td>
  842. <td>
  843. <p>
  844. Compiler
  845. </p>
  846. </td>
  847. <td>
  848. <p>
  849. The compiler may (or may not) have the typeid operator, but RTTI
  850. on the dynamic type of an object is not supported.
  851. </p>
  852. </td>
  853. </tr>
  854. <tr>
  855. <td>
  856. <p>
  857. <code class="computeroutput"><span class="identifier">BOOST_NO_SFINAE</span></code>
  858. </p>
  859. </td>
  860. <td>
  861. <p>
  862. Compiler
  863. </p>
  864. </td>
  865. <td>
  866. <p>
  867. The compiler does not support the "Substitution Failure Is
  868. Not An Error" meta-programming idiom. This is the lightweight
  869. pre-C++11 version of SFINAE.
  870. </p>
  871. </td>
  872. </tr>
  873. <tr>
  874. <td>
  875. <p>
  876. <code class="computeroutput"><span class="identifier">BOOST_NO_SFINAE_EXPR</span></code>
  877. </p>
  878. </td>
  879. <td>
  880. <p>
  881. Compiler
  882. </p>
  883. </td>
  884. <td>
  885. <p>
  886. The compiler does not support usage of SFINAE with arbitrary expressions.
  887. This is the post-C++11 SFINAE, but excludes a few specific corner
  888. cases, see also BOOST_NO_CXX11_SFINAE_EXPR.
  889. </p>
  890. </td>
  891. </tr>
  892. <tr>
  893. <td>
  894. <p>
  895. <code class="computeroutput"><span class="identifier">BOOST_NO_STD_ALLOCATOR</span></code>
  896. </p>
  897. </td>
  898. <td>
  899. <p>
  900. Standard library
  901. </p>
  902. </td>
  903. <td>
  904. <p>
  905. The C++ standard library does not provide a standards conforming
  906. <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">allocator</span></code>.
  907. </p>
  908. </td>
  909. </tr>
  910. <tr>
  911. <td>
  912. <p>
  913. <code class="computeroutput"><span class="identifier">BOOST_NO_STD_DISTANCE</span></code>
  914. </p>
  915. </td>
  916. <td>
  917. <p>
  918. Standard library
  919. </p>
  920. </td>
  921. <td>
  922. <p>
  923. The platform does not have a conforming version of <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">distance</span></code>.
  924. </p>
  925. </td>
  926. </tr>
  927. <tr>
  928. <td>
  929. <p>
  930. <code class="computeroutput"><span class="identifier">BOOST_NO_STD_ITERATOR</span></code>
  931. </p>
  932. </td>
  933. <td>
  934. <p>
  935. Standard library
  936. </p>
  937. </td>
  938. <td>
  939. <p>
  940. The C++ implementation fails to provide the <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">iterator</span></code>
  941. class. Note that post C++17, this macro is re-purposed to indicate
  942. that std::iterator has been removed or deprecated.
  943. </p>
  944. </td>
  945. </tr>
  946. <tr>
  947. <td>
  948. <p>
  949. <code class="computeroutput"><span class="identifier">BOOST_NO_STD_ITERATOR_TRAITS</span></code>
  950. </p>
  951. </td>
  952. <td>
  953. <p>
  954. Standard library
  955. </p>
  956. </td>
  957. <td>
  958. <p>
  959. The compiler does not provide a standard compliant implementation
  960. of <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">iterator_traits</span></code>. Note that the
  961. compiler may still have a non-standard implementation.
  962. </p>
  963. </td>
  964. </tr>
  965. <tr>
  966. <td>
  967. <p>
  968. <code class="computeroutput"><span class="identifier">BOOST_NO_STD_LOCALE</span></code>
  969. </p>
  970. </td>
  971. <td>
  972. <p>
  973. Standard library
  974. </p>
  975. </td>
  976. <td>
  977. <p>
  978. The standard library lacks <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">locale</span></code>.
  979. </p>
  980. </td>
  981. </tr>
  982. <tr>
  983. <td>
  984. <p>
  985. <code class="computeroutput"><span class="identifier">BOOST_NO_STD_MESSAGES</span></code>
  986. </p>
  987. </td>
  988. <td>
  989. <p>
  990. Standard library
  991. </p>
  992. </td>
  993. <td>
  994. <p>
  995. The standard library lacks a conforming <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">messages</span></code>
  996. facet.
  997. </p>
  998. </td>
  999. </tr>
  1000. <tr>
  1001. <td>
  1002. <p>
  1003. <code class="computeroutput"><span class="identifier">BOOST_NO_STD_MIN_MAX</span></code>
  1004. </p>
  1005. </td>
  1006. <td>
  1007. <p>
  1008. Standard library
  1009. </p>
  1010. </td>
  1011. <td>
  1012. <p>
  1013. The C++ standard library does not provide the <code class="computeroutput"><span class="identifier">min</span><span class="special">()</span></code> and <code class="computeroutput"><span class="identifier">max</span><span class="special">()</span></code> template functions that should
  1014. be in <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">algorithm</span><span class="special">&gt;</span></code>.
  1015. </p>
  1016. </td>
  1017. </tr>
  1018. <tr>
  1019. <td>
  1020. <p>
  1021. <code class="computeroutput"><span class="identifier">BOOST_NO_STD_OUTPUT_ITERATOR_ASSIGN</span></code>
  1022. </p>
  1023. </td>
  1024. <td>
  1025. <p>
  1026. Standard library
  1027. </p>
  1028. </td>
  1029. <td>
  1030. <p>
  1031. Defined if the standard library's output iterators are not assignable.
  1032. </p>
  1033. </td>
  1034. </tr>
  1035. <tr>
  1036. <td>
  1037. <p>
  1038. <code class="computeroutput"><span class="identifier">BOOST_NO_STD_TYPEINFO</span></code>
  1039. </p>
  1040. </td>
  1041. <td>
  1042. <p>
  1043. Standard library
  1044. </p>
  1045. </td>
  1046. <td>
  1047. <p>
  1048. The &lt;typeinfo&gt; header declares <code class="computeroutput"><span class="identifier">type_info</span></code>
  1049. in the global namespace instead of namespace std.
  1050. </p>
  1051. </td>
  1052. </tr>
  1053. <tr>
  1054. <td>
  1055. <p>
  1056. <code class="computeroutput"><span class="identifier">BOOST_NO_STD_USE_FACET</span></code>
  1057. </p>
  1058. </td>
  1059. <td>
  1060. <p>
  1061. Standard library
  1062. </p>
  1063. </td>
  1064. <td>
  1065. <p>
  1066. The standard library lacks a conforming <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">use_facet</span></code>.
  1067. </p>
  1068. </td>
  1069. </tr>
  1070. <tr>
  1071. <td>
  1072. <p>
  1073. <code class="computeroutput"><span class="identifier">BOOST_NO_STD_WSTREAMBUF</span></code>
  1074. </p>
  1075. </td>
  1076. <td>
  1077. <p>
  1078. Standard library
  1079. </p>
  1080. </td>
  1081. <td>
  1082. <p>
  1083. The standard library's implementation of <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">basic_streambuf</span><span class="special">&lt;</span><span class="keyword">wchar_t</span><span class="special">&gt;</span></code> is either missing, incomplete,
  1084. or buggy.
  1085. </p>
  1086. </td>
  1087. </tr>
  1088. <tr>
  1089. <td>
  1090. <p>
  1091. <code class="computeroutput"><span class="identifier">BOOST_NO_STD_WSTRING</span></code>
  1092. </p>
  1093. </td>
  1094. <td>
  1095. <p>
  1096. Standard library
  1097. </p>
  1098. </td>
  1099. <td>
  1100. <p>
  1101. The standard library lacks <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">wstring</span></code>.
  1102. </p>
  1103. </td>
  1104. </tr>
  1105. <tr>
  1106. <td>
  1107. <p>
  1108. <code class="computeroutput"><span class="identifier">BOOST_NO_STDC_NAMESPACE</span></code>
  1109. </p>
  1110. </td>
  1111. <td>
  1112. <p>
  1113. Compiler, Platform
  1114. </p>
  1115. </td>
  1116. <td>
  1117. <p>
  1118. The contents of C++ standard headers for C library functions (the
  1119. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">c</span><span class="special">...&gt;</span></code> headers) have not been placed
  1120. in namespace std. This test is difficult - some libraries "fake"
  1121. the std C functions by adding using declarations to import them
  1122. into namespace std, unfortunately they don't necessarily catch
  1123. all of them...
  1124. </p>
  1125. </td>
  1126. </tr>
  1127. <tr>
  1128. <td>
  1129. <p>
  1130. <code class="computeroutput"><span class="identifier">BOOST_NO_STRINGSTREAM</span></code>
  1131. </p>
  1132. </td>
  1133. <td>
  1134. <p>
  1135. Standard library
  1136. </p>
  1137. </td>
  1138. <td>
  1139. <p>
  1140. The C++ implementation does not provide the <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">sstream</span><span class="special">&gt;</span></code>
  1141. header.
  1142. </p>
  1143. </td>
  1144. </tr>
  1145. <tr>
  1146. <td>
  1147. <p>
  1148. <code class="computeroutput"><span class="identifier">BOOST_NO_SWPRINTF</span></code>
  1149. </p>
  1150. </td>
  1151. <td>
  1152. <p>
  1153. Platform
  1154. </p>
  1155. </td>
  1156. <td>
  1157. <p>
  1158. The platform does not have a conforming version of <code class="computeroutput"><span class="identifier">swprintf</span></code>.
  1159. </p>
  1160. </td>
  1161. </tr>
  1162. <tr>
  1163. <td>
  1164. <p>
  1165. <code class="computeroutput"><span class="identifier">BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION</span></code>
  1166. </p>
  1167. </td>
  1168. <td>
  1169. <p>
  1170. Compiler
  1171. </p>
  1172. </td>
  1173. <td>
  1174. <p>
  1175. Class template partial specialization (14.5.4 [temp.class.spec])
  1176. not supported.
  1177. </p>
  1178. </td>
  1179. </tr>
  1180. <tr>
  1181. <td>
  1182. <p>
  1183. <code class="computeroutput"><span class="identifier">BOOST_NO_TEMPLATED_IOSTREAMS</span></code>
  1184. </p>
  1185. </td>
  1186. <td>
  1187. <p>
  1188. Standard library
  1189. </p>
  1190. </td>
  1191. <td>
  1192. <p>
  1193. The standard library does not provide templated iostream classes.
  1194. </p>
  1195. </td>
  1196. </tr>
  1197. <tr>
  1198. <td>
  1199. <p>
  1200. <code class="computeroutput"><span class="identifier">BOOST_NO_TEMPLATED_ITERATOR_CONSTRUCTORS</span></code>
  1201. </p>
  1202. </td>
  1203. <td>
  1204. <p>
  1205. Standard library
  1206. </p>
  1207. </td>
  1208. <td>
  1209. <p>
  1210. The standard library does not provide templated iterator constructors
  1211. for its containers.
  1212. </p>
  1213. </td>
  1214. </tr>
  1215. <tr>
  1216. <td>
  1217. <p>
  1218. <code class="computeroutput"><span class="identifier">BOOST_NO_TEMPLATE_TEMPLATES</span></code>
  1219. </p>
  1220. </td>
  1221. <td>
  1222. <p>
  1223. Compiler
  1224. </p>
  1225. </td>
  1226. <td>
  1227. <p>
  1228. The compiler does not support template template parameters.
  1229. </p>
  1230. </td>
  1231. </tr>
  1232. <tr>
  1233. <td>
  1234. <p>
  1235. <code class="computeroutput"><span class="identifier">BOOST_NO_TYPEID</span></code>
  1236. </p>
  1237. </td>
  1238. <td>
  1239. <p>
  1240. Compiler
  1241. </p>
  1242. </td>
  1243. <td>
  1244. <p>
  1245. The compiler does not support the typeid operator at all.
  1246. </p>
  1247. </td>
  1248. </tr>
  1249. <tr>
  1250. <td>
  1251. <p>
  1252. <code class="computeroutput"><span class="identifier">BOOST_NO_TYPENAME_WITH_CTOR</span></code>
  1253. </p>
  1254. </td>
  1255. <td>
  1256. <p>
  1257. Compiler
  1258. </p>
  1259. </td>
  1260. <td>
  1261. <p>
  1262. The typename keyword cannot be used when creating a temporary of
  1263. a Dependent type.
  1264. </p>
  1265. </td>
  1266. </tr>
  1267. <tr>
  1268. <td>
  1269. <p>
  1270. <code class="computeroutput"><span class="identifier">BOOST_NO_UNREACHABLE_RETURN_DETECTION</span></code>
  1271. </p>
  1272. </td>
  1273. <td>
  1274. <p>
  1275. Compiler
  1276. </p>
  1277. </td>
  1278. <td>
  1279. <p>
  1280. If a return is unreachable, then no return statement should be
  1281. required, however some compilers insist on it, while other issue
  1282. a bunch of warnings if it is in fact present.
  1283. </p>
  1284. </td>
  1285. </tr>
  1286. <tr>
  1287. <td>
  1288. <p>
  1289. <code class="computeroutput"><span class="identifier">BOOST_NO_USING_DECLARATION_OVERLOADS_FROM_TYPENAME_BASE</span></code>
  1290. </p>
  1291. </td>
  1292. <td>
  1293. <p>
  1294. Compiler
  1295. </p>
  1296. </td>
  1297. <td>
  1298. <p>
  1299. The compiler will not accept a using declaration that brings a
  1300. function from a typename used as a base class into a derived class
  1301. if functions of the same name are present in the derived class.
  1302. </p>
  1303. </td>
  1304. </tr>
  1305. <tr>
  1306. <td>
  1307. <p>
  1308. <code class="computeroutput"><span class="identifier">BOOST_NO_USING_TEMPLATE</span></code>
  1309. </p>
  1310. </td>
  1311. <td>
  1312. <p>
  1313. Compiler
  1314. </p>
  1315. </td>
  1316. <td>
  1317. <p>
  1318. The compiler will not accept a using declaration that imports a
  1319. template class or function from another namespace. Originally a
  1320. Borland specific problem with imports to/from the global namespace,
  1321. extended to MSVC6 which has a specific issue with importing template
  1322. classes (but not functions).
  1323. </p>
  1324. </td>
  1325. </tr>
  1326. <tr>
  1327. <td>
  1328. <p>
  1329. <code class="computeroutput"><span class="identifier">BOOST_NO_VOID_RETURNS</span></code>
  1330. </p>
  1331. </td>
  1332. <td>
  1333. <p>
  1334. Compiler
  1335. </p>
  1336. </td>
  1337. <td>
  1338. <p>
  1339. The compiler does not allow a void function to return the result
  1340. of calling another void function.
  1341. </p>
  1342. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">void</span> <span class="identifier">f</span><span class="special">()</span> <span class="special">{}</span>
  1343. <span class="keyword">void</span> <span class="identifier">g</span><span class="special">()</span> <span class="special">{</span> <span class="keyword">return</span> <span class="identifier">f</span><span class="special">();</span> <span class="special">}</span>
  1344. </pre>
  1345. <p>
  1346. </p>
  1347. </td>
  1348. </tr>
  1349. </tbody>
  1350. </table></div>
  1351. </div>
  1352. <div class="section">
  1353. <div class="titlepage"><div><div><h3 class="title">
  1354. <a name="boost_config.boost_macro_reference.macros_that_describe_optional_features"></a><a name="config_features"></a><a class="link" href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_describe_optional_features" title="Macros that describe optional features">Macros
  1355. that describe optional features</a>
  1356. </h3></div></div></div>
  1357. <p>
  1358. The following macros describe features that are not required by the C++ standard.
  1359. The macro is only defined if the feature is present.
  1360. </p>
  1361. <div class="informaltable"><table class="table">
  1362. <colgroup>
  1363. <col>
  1364. <col>
  1365. <col>
  1366. </colgroup>
  1367. <thead><tr>
  1368. <th>
  1369. <p>
  1370. Macro
  1371. </p>
  1372. </th>
  1373. <th>
  1374. <p>
  1375. Section
  1376. </p>
  1377. </th>
  1378. <th>
  1379. <p>
  1380. Description
  1381. </p>
  1382. </th>
  1383. </tr></thead>
  1384. <tbody>
  1385. <tr>
  1386. <td>
  1387. <p>
  1388. <code class="computeroutput"><span class="identifier">BOOST_HAS_BETHREADS</span></code>
  1389. </p>
  1390. </td>
  1391. <td>
  1392. <p>
  1393. Platform
  1394. </p>
  1395. </td>
  1396. <td>
  1397. <p>
  1398. The platform supports BeOS style threads.
  1399. </p>
  1400. </td>
  1401. </tr>
  1402. <tr>
  1403. <td>
  1404. <p>
  1405. <code class="computeroutput"><span class="identifier">BOOST_HAS_CLOCK_GETTIME</span></code>
  1406. </p>
  1407. </td>
  1408. <td>
  1409. <p>
  1410. Platform
  1411. </p>
  1412. </td>
  1413. <td>
  1414. <p>
  1415. The platform has the POSIX API <code class="computeroutput"><span class="identifier">clock_gettime</span></code>.
  1416. </p>
  1417. </td>
  1418. </tr>
  1419. <tr>
  1420. <td>
  1421. <p>
  1422. <code class="computeroutput"><span class="identifier">BOOST_HAS_DIRENT_H</span></code>
  1423. </p>
  1424. </td>
  1425. <td>
  1426. <p>
  1427. Platform
  1428. </p>
  1429. </td>
  1430. <td>
  1431. <p>
  1432. The platform has the POSIX header <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">dirent</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span></code>.
  1433. </p>
  1434. </td>
  1435. </tr>
  1436. <tr>
  1437. <td>
  1438. <p>
  1439. <code class="computeroutput"><span class="identifier">BOOST_HAS_EXPM1</span></code>
  1440. </p>
  1441. </td>
  1442. <td>
  1443. <p>
  1444. Platform
  1445. </p>
  1446. </td>
  1447. <td>
  1448. <p>
  1449. The platform has the functions <code class="computeroutput"><span class="identifier">expm1</span></code>,
  1450. <code class="computeroutput"><span class="identifier">expm1f</span></code> and <code class="computeroutput"><span class="identifier">expm1l</span></code> in <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">math</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span></code>
  1451. </p>
  1452. </td>
  1453. </tr>
  1454. <tr>
  1455. <td>
  1456. <p>
  1457. <code class="computeroutput"><span class="identifier">BOOST_HAS_FLOAT128</span></code>
  1458. </p>
  1459. </td>
  1460. <td>
  1461. <p>
  1462. Compiler
  1463. </p>
  1464. </td>
  1465. <td>
  1466. <p>
  1467. The compiler has <code class="computeroutput"><span class="identifier">__float128</span></code>
  1468. as a native type which is distinct from all the regular C++ floating
  1469. point types.
  1470. </p>
  1471. </td>
  1472. </tr>
  1473. <tr>
  1474. <td>
  1475. <p>
  1476. <code class="computeroutput"><span class="identifier">BOOST_HAS_FTIME</span></code>
  1477. </p>
  1478. </td>
  1479. <td>
  1480. <p>
  1481. Platform
  1482. </p>
  1483. </td>
  1484. <td>
  1485. <p>
  1486. The platform has the Win32 API type FTIME.
  1487. </p>
  1488. </td>
  1489. </tr>
  1490. <tr>
  1491. <td>
  1492. <p>
  1493. <code class="computeroutput"><span class="identifier">BOOST_HAS_GETSYSTEMTIMEASFILETIME</span></code>
  1494. </p>
  1495. </td>
  1496. <td>
  1497. <p>
  1498. Platform
  1499. </p>
  1500. </td>
  1501. <td>
  1502. <p>
  1503. The platform has the Win32 API GetSystemTimeAsFileTime.
  1504. </p>
  1505. </td>
  1506. </tr>
  1507. <tr>
  1508. <td>
  1509. <p>
  1510. <code class="computeroutput"><span class="identifier">BOOST_HAS_GETTIMEOFDAY</span></code>
  1511. </p>
  1512. </td>
  1513. <td>
  1514. <p>
  1515. Platform
  1516. </p>
  1517. </td>
  1518. <td>
  1519. <p>
  1520. The platform has the POSIX API <code class="computeroutput"><span class="identifier">gettimeofday</span></code>.
  1521. </p>
  1522. </td>
  1523. </tr>
  1524. <tr>
  1525. <td>
  1526. <p>
  1527. <code class="computeroutput"><span class="identifier">BOOST_HAS_HASH</span></code>
  1528. </p>
  1529. </td>
  1530. <td>
  1531. <p>
  1532. Standard library
  1533. </p>
  1534. </td>
  1535. <td>
  1536. <p>
  1537. The C++ implementation provides the (SGI) hash_set and hash_map
  1538. classes. When defined, <code class="computeroutput"><span class="identifier">BOOST_HASH_SET_HEADER</span></code>
  1539. and <code class="computeroutput"><span class="identifier">BOOST_HASH_LIST_HEADER</span></code>
  1540. will contain the names of the header needed to access hash_set
  1541. and hash_map; <code class="computeroutput"><span class="identifier">BOOST_STD_EXTENSION_NAMESPACE</span></code>
  1542. will provide the namespace in which the two class templates reside.
  1543. </p>
  1544. </td>
  1545. </tr>
  1546. <tr>
  1547. <td>
  1548. <p>
  1549. <code class="computeroutput"><span class="identifier">BOOST_HAS_INT128</span></code>
  1550. </p>
  1551. </td>
  1552. <td>
  1553. <p>
  1554. Compiler
  1555. </p>
  1556. </td>
  1557. <td>
  1558. <p>
  1559. The compiler has <code class="computeroutput"><span class="identifier">__int128</span></code>
  1560. and <code class="computeroutput"><span class="keyword">unsigned</span> <span class="identifier">__int128</span></code>
  1561. as native types which are distinct from all the regular C++ integer
  1562. types.
  1563. </p>
  1564. </td>
  1565. </tr>
  1566. <tr>
  1567. <td>
  1568. <p>
  1569. <code class="computeroutput"><span class="identifier">BOOST_HAS_LOG1P</span></code>
  1570. </p>
  1571. </td>
  1572. <td>
  1573. <p>
  1574. Platform
  1575. </p>
  1576. </td>
  1577. <td>
  1578. <p>
  1579. The platform has the functions <code class="computeroutput"><span class="identifier">log1p</span></code>,
  1580. <code class="computeroutput"><span class="identifier">log1pf</span></code> and <code class="computeroutput"><span class="identifier">log1pl</span></code> in <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">math</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span></code>.
  1581. </p>
  1582. </td>
  1583. </tr>
  1584. <tr>
  1585. <td>
  1586. <p>
  1587. <code class="computeroutput"><span class="identifier">BOOST_HAS_MACRO_USE_FACET</span></code>
  1588. </p>
  1589. </td>
  1590. <td>
  1591. <p>
  1592. Standard library
  1593. </p>
  1594. </td>
  1595. <td>
  1596. <p>
  1597. The standard library lacks a conforming <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">use_facet</span></code>,
  1598. but has a macro <code class="computeroutput"><span class="identifier">_USE</span><span class="special">(</span><span class="identifier">loc</span><span class="special">,</span> <span class="identifier">Type</span><span class="special">)</span></code> that does the job. This is primarily
  1599. for the Dinkumware std lib.
  1600. </p>
  1601. </td>
  1602. </tr>
  1603. <tr>
  1604. <td>
  1605. <p>
  1606. <code class="computeroutput"><span class="identifier">BOOST_HAS_MS_INT64</span></code>
  1607. </p>
  1608. </td>
  1609. <td>
  1610. <p>
  1611. Compiler
  1612. </p>
  1613. </td>
  1614. <td>
  1615. <p>
  1616. The compiler supports the <code class="computeroutput"><span class="identifier">__int64</span></code>
  1617. data type.
  1618. </p>
  1619. </td>
  1620. </tr>
  1621. <tr>
  1622. <td>
  1623. <p>
  1624. <code class="computeroutput"><span class="identifier">BOOST_HAS_NANOSLEEP</span></code>
  1625. </p>
  1626. </td>
  1627. <td>
  1628. <p>
  1629. Platform
  1630. </p>
  1631. </td>
  1632. <td>
  1633. <p>
  1634. The platform has the POSIX API nanosleep.
  1635. </p>
  1636. </td>
  1637. </tr>
  1638. <tr>
  1639. <td>
  1640. <p>
  1641. <code class="computeroutput"><span class="identifier">BOOST_HAS_NL_TYPES_H</span></code>
  1642. </p>
  1643. </td>
  1644. <td>
  1645. <p>
  1646. Platform
  1647. </p>
  1648. </td>
  1649. <td>
  1650. <p>
  1651. The platform has an <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">nl_types</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span></code>.
  1652. </p>
  1653. </td>
  1654. </tr>
  1655. <tr>
  1656. <td>
  1657. <p>
  1658. <code class="computeroutput"><span class="identifier">BOOST_HAS_NRVO</span></code>
  1659. </p>
  1660. </td>
  1661. <td>
  1662. <p>
  1663. Compiler
  1664. </p>
  1665. </td>
  1666. <td>
  1667. <p>
  1668. Indicated that the compiler supports the named return value optimization
  1669. (NRVO). Used to select the most efficient implementation for some
  1670. function. See <a href="../../../../../boost/operators.hpp" target="_top"><code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">operators</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code></a> for example.
  1671. </p>
  1672. </td>
  1673. </tr>
  1674. <tr>
  1675. <td>
  1676. <p>
  1677. <code class="computeroutput"><span class="identifier">BOOST_HAS_PARTIAL_STD_ALLOCATOR</span></code>
  1678. </p>
  1679. </td>
  1680. <td>
  1681. <p>
  1682. Standard Library
  1683. </p>
  1684. </td>
  1685. <td>
  1686. <p>
  1687. The standard library has a partially conforming <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">allocator</span></code>
  1688. class, but without any of the member templates.
  1689. </p>
  1690. </td>
  1691. </tr>
  1692. <tr>
  1693. <td>
  1694. <p>
  1695. <code class="computeroutput"><span class="identifier">BOOST_HAS_PRAGMA_ONCE</span></code>
  1696. </p>
  1697. </td>
  1698. <td>
  1699. <p>
  1700. Compiler
  1701. </p>
  1702. </td>
  1703. <td>
  1704. <p>
  1705. The compiler recognizes the <code class="computeroutput"><span class="preprocessor">#pragma</span>
  1706. <span class="identifier">once</span></code> directive which
  1707. tells that the containing header should be included only once while
  1708. preprocessing the current translation unit. The pragma may improve
  1709. compile times of large projects with some compilers.
  1710. </p>
  1711. </td>
  1712. </tr>
  1713. <tr>
  1714. <td>
  1715. <p>
  1716. <code class="computeroutput"><span class="identifier">BOOST_HAS_PRAGMA_DETECT_MISMATCH</span></code>
  1717. </p>
  1718. </td>
  1719. <td>
  1720. <p>
  1721. Compiler
  1722. </p>
  1723. </td>
  1724. <td>
  1725. <p>
  1726. The compiler recognizes the <code class="computeroutput"><span class="preprocessor">#pragma</span>
  1727. <span class="identifier">detect_mismatch</span><span class="special">(</span><span class="string">"name"</span><span class="special">,</span>
  1728. <span class="string">"value"</span><span class="special">)</span></code>
  1729. directive which tells that the link stage should be terminated
  1730. with error if values for provided <code class="computeroutput"><span class="string">"name"</span></code>
  1731. missmatch. This pragma may be a help in preventing ODR violations
  1732. and ensuring that different modules are compiled with same flags.
  1733. </p>
  1734. </td>
  1735. </tr>
  1736. <tr>
  1737. <td>
  1738. <p>
  1739. <code class="computeroutput"><span class="identifier">BOOST_HAS_PTHREAD_DELAY_NP</span></code>
  1740. </p>
  1741. </td>
  1742. <td>
  1743. <p>
  1744. Platform
  1745. </p>
  1746. </td>
  1747. <td>
  1748. <p>
  1749. The platform has the POSIX API <code class="computeroutput"><span class="identifier">pthread_delay_np</span></code>.
  1750. </p>
  1751. </td>
  1752. </tr>
  1753. <tr>
  1754. <td>
  1755. <p>
  1756. <code class="computeroutput"><span class="identifier">BOOST_HAS_PTHREAD_MUTEXATTR_SETTYPE</span></code>
  1757. </p>
  1758. </td>
  1759. <td>
  1760. <p>
  1761. Platform
  1762. </p>
  1763. </td>
  1764. <td>
  1765. <p>
  1766. The platform has the POSIX API <code class="computeroutput"><span class="identifier">pthread_mutexattr_settype</span></code>.
  1767. </p>
  1768. </td>
  1769. </tr>
  1770. <tr>
  1771. <td>
  1772. <p>
  1773. <code class="computeroutput"><span class="identifier">BOOST_HAS_PTHREAD_YIELD</span></code>
  1774. </p>
  1775. </td>
  1776. <td>
  1777. <p>
  1778. Platform
  1779. </p>
  1780. </td>
  1781. <td>
  1782. <p>
  1783. The platform has the POSIX API <code class="computeroutput"><span class="identifier">pthread_yield</span></code>.
  1784. </p>
  1785. </td>
  1786. </tr>
  1787. <tr>
  1788. <td>
  1789. <p>
  1790. <code class="computeroutput"><span class="identifier">BOOST_HAS_PTHREADS</span></code>
  1791. </p>
  1792. </td>
  1793. <td>
  1794. <p>
  1795. Platform
  1796. </p>
  1797. </td>
  1798. <td>
  1799. <p>
  1800. The platform support POSIX style threads.
  1801. </p>
  1802. </td>
  1803. </tr>
  1804. <tr>
  1805. <td>
  1806. <p>
  1807. <code class="computeroutput"><span class="identifier">BOOST_HAS_SCHED_YIELD</span></code>
  1808. </p>
  1809. </td>
  1810. <td>
  1811. <p>
  1812. Platform
  1813. </p>
  1814. </td>
  1815. <td>
  1816. <p>
  1817. The platform has the POSIX API <code class="computeroutput"><span class="identifier">sched_yield</span></code>.
  1818. </p>
  1819. </td>
  1820. </tr>
  1821. <tr>
  1822. <td>
  1823. <p>
  1824. <code class="computeroutput"><span class="identifier">BOOST_HAS_SGI_TYPE_TRAITS</span></code>
  1825. </p>
  1826. </td>
  1827. <td>
  1828. <p>
  1829. Compiler, Standard library
  1830. </p>
  1831. </td>
  1832. <td>
  1833. <p>
  1834. The compiler has native support for SGI style type traits.
  1835. </p>
  1836. </td>
  1837. </tr>
  1838. <tr>
  1839. <td>
  1840. <p>
  1841. <code class="computeroutput"><span class="identifier">BOOST_HAS_STDINT_H</span></code>
  1842. </p>
  1843. </td>
  1844. <td>
  1845. <p>
  1846. Platform
  1847. </p>
  1848. </td>
  1849. <td>
  1850. <p>
  1851. The platform has a <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">stdint</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span></code>
  1852. </p>
  1853. </td>
  1854. </tr>
  1855. <tr>
  1856. <td>
  1857. <p>
  1858. <code class="computeroutput"><span class="identifier">BOOST_HAS_SLIST</span></code>
  1859. </p>
  1860. </td>
  1861. <td>
  1862. <p>
  1863. Standard library
  1864. </p>
  1865. </td>
  1866. <td>
  1867. <p>
  1868. The C++ implementation provides the (SGI) slist class. When defined,
  1869. <code class="computeroutput"><span class="identifier">BOOST_SLIST_HEADER</span></code>
  1870. will contain the name of the header needed to access <code class="computeroutput"><span class="identifier">slist</span></code> and <code class="computeroutput"><span class="identifier">BOOST_STD_EXTENSION_NAMESPACE</span></code>
  1871. will provide the namespace in which <code class="computeroutput"><span class="identifier">slist</span></code>
  1872. resides.
  1873. </p>
  1874. </td>
  1875. </tr>
  1876. <tr>
  1877. <td>
  1878. <p>
  1879. <code class="computeroutput"><span class="identifier">BOOST_HAS_STLP_USE_FACET</span></code>
  1880. </p>
  1881. </td>
  1882. <td>
  1883. <p>
  1884. Standard library
  1885. </p>
  1886. </td>
  1887. <td>
  1888. <p>
  1889. The standard library lacks a conforming <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">use_facet</span></code>,
  1890. but has a workaround class-version that does the job. This is primarily
  1891. for the STLport std lib.
  1892. </p>
  1893. </td>
  1894. </tr>
  1895. <tr>
  1896. <td>
  1897. <p>
  1898. <code class="computeroutput"><span class="identifier">BOOST_HAS_TR1_ARRAY</span></code>
  1899. </p>
  1900. </td>
  1901. <td>
  1902. <p>
  1903. Standard library
  1904. </p>
  1905. </td>
  1906. <td>
  1907. <p>
  1908. The library has a TR1 conforming version of <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">array</span><span class="special">&gt;</span></code>.
  1909. This macro is only guaranteed to be defined after including one
  1910. of the headers from Boost.TR1. Further this macro is now deprecated
  1911. in favour of BOOST_NO_CXX11_HDR_ARRAY.
  1912. </p>
  1913. </td>
  1914. </tr>
  1915. <tr>
  1916. <td>
  1917. <p>
  1918. <code class="computeroutput"><span class="identifier">BOOST_HAS_TR1_COMPLEX_OVERLOADS</span></code>
  1919. </p>
  1920. </td>
  1921. <td>
  1922. <p>
  1923. Standard library
  1924. </p>
  1925. </td>
  1926. <td>
  1927. <p>
  1928. The library has a version of <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">complex</span><span class="special">&gt;</span></code>
  1929. that supports passing scalars to the complex number algorithms.
  1930. </p>
  1931. </td>
  1932. </tr>
  1933. <tr>
  1934. <td>
  1935. <p>
  1936. <code class="computeroutput"><span class="identifier">BOOST_HAS_TR1_COMPLEX_INVERSE_TRIG</span></code>
  1937. </p>
  1938. </td>
  1939. <td>
  1940. <p>
  1941. Standard library
  1942. </p>
  1943. </td>
  1944. <td>
  1945. <p>
  1946. The library has a version of <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">complex</span><span class="special">&gt;</span></code>
  1947. that includes the new inverse trig functions from TR1.
  1948. </p>
  1949. </td>
  1950. </tr>
  1951. <tr>
  1952. <td>
  1953. <p>
  1954. <code class="computeroutput"><span class="identifier">BOOST_HAS_TR1_REFERENCE_WRAPPER</span></code>
  1955. </p>
  1956. </td>
  1957. <td>
  1958. <p>
  1959. Standard library
  1960. </p>
  1961. </td>
  1962. <td>
  1963. <p>
  1964. The library has TR1 conforming reference wrappers in <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">functional</span><span class="special">&gt;</span></code>. This macro is only guaranteed
  1965. to be defined after including one of the headers from Boost.TR1.
  1966. Further this macro is now deprecated in favour of BOOST_NO_CXX11_HDR_FUNCTIONAL.
  1967. </p>
  1968. </td>
  1969. </tr>
  1970. <tr>
  1971. <td>
  1972. <p>
  1973. <code class="computeroutput"><span class="identifier">BOOST_HAS_TR1_RESULT_OF</span></code>
  1974. </p>
  1975. </td>
  1976. <td>
  1977. <p>
  1978. Standard library
  1979. </p>
  1980. </td>
  1981. <td>
  1982. <p>
  1983. The library has a TR1 conforming result_of template in <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">functional</span><span class="special">&gt;</span></code>. This macro is only guaranteed
  1984. to be defined after including one of the headers from Boost.TR1.
  1985. Further this macro is now deprecated in favour of BOOST_NO_CXX11_HDR_FUNCTIONAL.
  1986. </p>
  1987. </td>
  1988. </tr>
  1989. <tr>
  1990. <td>
  1991. <p>
  1992. <code class="computeroutput"><span class="identifier">BOOST_HAS_TR1_MEM_FN</span></code>
  1993. </p>
  1994. </td>
  1995. <td>
  1996. <p>
  1997. Standard library
  1998. </p>
  1999. </td>
  2000. <td>
  2001. <p>
  2002. The library has a TR1 conforming mem_fn function template in <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">functional</span><span class="special">&gt;</span></code>. This macro is only guaranteed
  2003. to be defined after including one of the headers from Boost.TR1.
  2004. Further this macro is now deprecated in favour of BOOST_NO_CXX11_HDR_FUNCTIONAL.
  2005. </p>
  2006. </td>
  2007. </tr>
  2008. <tr>
  2009. <td>
  2010. <p>
  2011. <code class="computeroutput"><span class="identifier">BOOST_HAS_TR1_BIND</span></code>
  2012. </p>
  2013. </td>
  2014. <td>
  2015. <p>
  2016. Standard library
  2017. </p>
  2018. </td>
  2019. <td>
  2020. <p>
  2021. The library has a TR1 conforming bind function template in <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">functional</span><span class="special">&gt;</span></code>. This macro is only guaranteed
  2022. to be defined after including one of the headers from Boost.TR1.
  2023. Further this macro is now deprecated in favour of BOOST_NO_CXX11_HDR_FUNCTIONAL.
  2024. </p>
  2025. </td>
  2026. </tr>
  2027. <tr>
  2028. <td>
  2029. <p>
  2030. <code class="computeroutput"><span class="identifier">BOOST_HAS_TR1_FUNCTION</span></code>
  2031. </p>
  2032. </td>
  2033. <td>
  2034. <p>
  2035. Standard library
  2036. </p>
  2037. </td>
  2038. <td>
  2039. <p>
  2040. The library has a TR1 conforming function class template in <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">functional</span><span class="special">&gt;</span></code>. This macro is only guaranteed
  2041. to be defined after including one of the headers from Boost.TR1.
  2042. Further this macro is now deprecated in favour of BOOST_NO_CXX11_HDR_FUNCTIONAL.
  2043. </p>
  2044. </td>
  2045. </tr>
  2046. <tr>
  2047. <td>
  2048. <p>
  2049. <code class="computeroutput"><span class="identifier">BOOST_HAS_TR1_HASH</span></code>
  2050. </p>
  2051. </td>
  2052. <td>
  2053. <p>
  2054. Standard library
  2055. </p>
  2056. </td>
  2057. <td>
  2058. <p>
  2059. The library has a TR1 conforming hash function template in <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">functional</span><span class="special">&gt;</span></code>. This macro is only guaranteed
  2060. to be defined after including one of the headers from Boost.TR1.
  2061. Further this macro is now deprecated in favour of BOOST_NO_CXX11_HDR_FUNCTIONAL.
  2062. </p>
  2063. </td>
  2064. </tr>
  2065. <tr>
  2066. <td>
  2067. <p>
  2068. <code class="computeroutput"><span class="identifier">BOOST_HAS_TR1_SHARED_PTR</span></code>
  2069. </p>
  2070. </td>
  2071. <td>
  2072. <p>
  2073. Standard library
  2074. </p>
  2075. </td>
  2076. <td>
  2077. <p>
  2078. The library has a TR1 conforming <code class="computeroutput"><span class="identifier">shared_ptr</span></code>
  2079. class template in <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">memory</span><span class="special">&gt;</span></code>.
  2080. This macro is only guaranteed to be defined after including one
  2081. of the headers from Boost.TR1. Further this macro is now deprecated
  2082. in favour of BOOST_NO_CXX11_SMART_PTR.
  2083. </p>
  2084. </td>
  2085. </tr>
  2086. <tr>
  2087. <td>
  2088. <p>
  2089. <code class="computeroutput"><span class="identifier">BOOST_HAS_TR1_RANDOM</span></code>
  2090. </p>
  2091. </td>
  2092. <td>
  2093. <p>
  2094. Standard library
  2095. </p>
  2096. </td>
  2097. <td>
  2098. <p>
  2099. The library has a TR1 conforming version of <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">random</span><span class="special">&gt;</span></code>.
  2100. This macro is only guaranteed to be defined after including one
  2101. of the headers from Boost.TR1. Further this macro is now deprecated
  2102. in favour of BOOST_NO_CXX11_HDR_RANDOM.
  2103. </p>
  2104. </td>
  2105. </tr>
  2106. <tr>
  2107. <td>
  2108. <p>
  2109. <code class="computeroutput"><span class="identifier">BOOST_HAS_TR1_REGEX</span></code>
  2110. </p>
  2111. </td>
  2112. <td>
  2113. <p>
  2114. Standard library
  2115. </p>
  2116. </td>
  2117. <td>
  2118. <p>
  2119. The library has a TR1 conforming version of <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">regex</span><span class="special">&gt;</span></code>.
  2120. This macro is only guaranteed to be defined after including one
  2121. of the headers from Boost.TR1. Further this macro is now deprecated
  2122. in favour of BOOST_NO_CXX11_HDR_REGEX.
  2123. </p>
  2124. </td>
  2125. </tr>
  2126. <tr>
  2127. <td>
  2128. <p>
  2129. <code class="computeroutput"><span class="identifier">BOOST_HAS_TR1_TUPLE</span></code>
  2130. </p>
  2131. </td>
  2132. <td>
  2133. <p>
  2134. Standard library
  2135. </p>
  2136. </td>
  2137. <td>
  2138. <p>
  2139. The library has a TR1 conforming version of <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">tuple</span><span class="special">&gt;</span></code>.
  2140. This macro is only guaranteed to be defined after including one
  2141. of the headers from Boost.TR1. Further this macro is now deprecated
  2142. in favour of BOOST_NO_CXX11_HDR_TUPLE.
  2143. </p>
  2144. </td>
  2145. </tr>
  2146. <tr>
  2147. <td>
  2148. <p>
  2149. <code class="computeroutput"><span class="identifier">BOOST_HAS_TR1_TYPE_TRAITS</span></code>
  2150. </p>
  2151. </td>
  2152. <td>
  2153. <p>
  2154. Standard library
  2155. </p>
  2156. </td>
  2157. <td>
  2158. <p>
  2159. The library has a TR1 conforming version of <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">type_traits</span><span class="special">&gt;</span></code>.
  2160. This macro is only guaranteed to be defined after including one
  2161. of the headers from Boost.TR1. Further this macro is now deprecated
  2162. in favour of BOOST_NO_CXX11_HDR_TYPE_TRAITS.
  2163. </p>
  2164. </td>
  2165. </tr>
  2166. <tr>
  2167. <td>
  2168. <p>
  2169. <code class="computeroutput"><span class="identifier">BOOST_HAS_TR1_UTILITY</span></code>
  2170. </p>
  2171. </td>
  2172. <td>
  2173. <p>
  2174. Standard library
  2175. </p>
  2176. </td>
  2177. <td>
  2178. <p>
  2179. The library has the TR1 additions to <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">utility</span><span class="special">&gt;</span></code>
  2180. (tuple interface to <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">pair</span></code>).
  2181. This macro is only guaranteed to be defined after including one
  2182. of the headers from Boost.TR1. Further this macro is now deprecated
  2183. in favour of BOOST_NO_CXX11_HDR_TUPLE.
  2184. </p>
  2185. </td>
  2186. </tr>
  2187. <tr>
  2188. <td>
  2189. <p>
  2190. <code class="computeroutput"><span class="identifier">BOOST_HAS_TR1_UNORDERED_MAP</span></code>
  2191. </p>
  2192. </td>
  2193. <td>
  2194. <p>
  2195. Standard library
  2196. </p>
  2197. </td>
  2198. <td>
  2199. <p>
  2200. The library has a TR1 conforming version of <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">unordered_map</span><span class="special">&gt;</span></code>.
  2201. This macro is only guaranteed to be defined after including one
  2202. of the headers from Boost.TR1. Further this macro is now deprecated
  2203. in favour of BOOST_NO_CXX11_HDR_UNORDERED_MAP.
  2204. </p>
  2205. </td>
  2206. </tr>
  2207. <tr>
  2208. <td>
  2209. <p>
  2210. <code class="computeroutput"><span class="identifier">BOOST_HAS_TR1_UNORDERED_SET</span></code>
  2211. </p>
  2212. </td>
  2213. <td>
  2214. <p>
  2215. Standard library
  2216. </p>
  2217. </td>
  2218. <td>
  2219. <p>
  2220. The library has a TR1 conforming version of <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">unordered_set</span><span class="special">&gt;</span></code>.
  2221. This macro is only guaranteed to be defined after including one
  2222. of the headers from Boost.TR1. Further this macro is now deprecated
  2223. in favour of BOOST_NO_CXX11_HDR_UNORDERED_SET.
  2224. </p>
  2225. </td>
  2226. </tr>
  2227. <tr>
  2228. <td>
  2229. <p>
  2230. <code class="computeroutput"><span class="identifier">BOOST_HAS_TR1</span></code>
  2231. </p>
  2232. </td>
  2233. <td>
  2234. <p>
  2235. Standard library
  2236. </p>
  2237. </td>
  2238. <td>
  2239. <p>
  2240. Implies all the other <code class="computeroutput"><span class="identifier">BOOST_HAS_TR1_</span><span class="special">*</span></code> macros should be set.
  2241. </p>
  2242. </td>
  2243. </tr>
  2244. <tr>
  2245. <td>
  2246. <p>
  2247. <code class="computeroutput"><span class="identifier">BOOST_HAS_THREADS</span></code>
  2248. </p>
  2249. </td>
  2250. <td>
  2251. <p>
  2252. Platform, Compiler
  2253. </p>
  2254. </td>
  2255. <td>
  2256. <p>
  2257. Defined if the compiler, in its current translation mode, supports
  2258. multiple threads of execution.
  2259. </p>
  2260. </td>
  2261. </tr>
  2262. <tr>
  2263. <td>
  2264. <p>
  2265. <code class="computeroutput"><span class="identifier">BOOST_HAS_TWO_ARG_USE_FACET</span></code>
  2266. </p>
  2267. </td>
  2268. <td>
  2269. <p>
  2270. Standard library
  2271. </p>
  2272. </td>
  2273. <td>
  2274. <p>
  2275. The standard library lacks a conforming std::use_facet, but has
  2276. a two argument version that does the job. This is primarily for
  2277. the Rogue Wave std lib.
  2278. </p>
  2279. </td>
  2280. </tr>
  2281. <tr>
  2282. <td>
  2283. <p>
  2284. <code class="computeroutput"><span class="identifier">BOOST_HAS_UNISTD_H</span></code>
  2285. </p>
  2286. </td>
  2287. <td>
  2288. <p>
  2289. Platform
  2290. </p>
  2291. </td>
  2292. <td>
  2293. <p>
  2294. The Platform provides <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">unistd</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span></code>.
  2295. </p>
  2296. </td>
  2297. </tr>
  2298. <tr>
  2299. <td>
  2300. <p>
  2301. <code class="computeroutput"><span class="identifier">BOOST_HAS_WINTHREADS</span></code>
  2302. </p>
  2303. </td>
  2304. <td>
  2305. <p>
  2306. Platform
  2307. </p>
  2308. </td>
  2309. <td>
  2310. <p>
  2311. The platform supports MS Windows style threads.
  2312. </p>
  2313. </td>
  2314. </tr>
  2315. <tr>
  2316. <td>
  2317. <p>
  2318. <code class="computeroutput"><span class="identifier">BOOST_MSVC_STD_ITERATOR</span></code>
  2319. </p>
  2320. </td>
  2321. <td>
  2322. <p>
  2323. Standard library
  2324. </p>
  2325. </td>
  2326. <td>
  2327. <p>
  2328. Microsoft's broken version of <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">iterator</span></code>
  2329. is being used. This implies that <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">iterator</span></code>
  2330. takes no more than two template parameters.
  2331. </p>
  2332. </td>
  2333. </tr>
  2334. <tr>
  2335. <td>
  2336. <p>
  2337. <code class="computeroutput"><span class="identifier">BOOST_MSVC6_MEMBER_TEMPLATES</span></code>
  2338. </p>
  2339. </td>
  2340. <td>
  2341. <p>
  2342. Compiler
  2343. </p>
  2344. </td>
  2345. <td>
  2346. <p>
  2347. Microsoft Visual C++ 6.0 has enough member template idiosyncrasies
  2348. (being polite) that <code class="computeroutput"><span class="identifier">BOOST_NO_MEMBER_TEMPLATES</span></code>
  2349. is defined for this compiler. <code class="computeroutput"><span class="identifier">BOOST_MSVC6_MEMBER_TEMPLATES</span></code>
  2350. is defined to allow compiler specific workarounds. This macro gets
  2351. defined automatically if <code class="computeroutput"><span class="identifier">BOOST_NO_MEMBER_TEMPLATES</span></code>
  2352. is not defined - in other words this is treated as a strict subset
  2353. of the features required by the standard.
  2354. </p>
  2355. </td>
  2356. </tr>
  2357. <tr>
  2358. <td>
  2359. <p>
  2360. <code class="computeroutput"><span class="identifier">BOOST_HAS_STDINT_H</span></code>
  2361. </p>
  2362. </td>
  2363. <td>
  2364. <p>
  2365. Platform
  2366. </p>
  2367. </td>
  2368. <td>
  2369. <p>
  2370. There are no 1998 C++ Standard headers <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">stdint</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span></code>
  2371. or <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">cstdint</span><span class="special">&gt;</span></code>, although the 1999 C Standard
  2372. does include <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">stdint</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span></code>.
  2373. If <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">stdint</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span></code> is present, <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">stdint</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span></code>
  2374. can make good use of it, so a flag is supplied (signalling presence;
  2375. thus the default is not present, conforming to the current C++
  2376. standard).
  2377. </p>
  2378. </td>
  2379. </tr>
  2380. </tbody>
  2381. </table></div>
  2382. </div>
  2383. <div class="section">
  2384. <div class="titlepage"><div><div><h3 class="title">
  2385. <a name="boost_config.boost_macro_reference.macros_that_describe_possible_c___future_features"></a><a class="link" href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_describe_possible_c___future_features" title="Macros that describe possible C++ future features">Macros
  2386. that describe possible C++ future features</a>
  2387. </h3></div></div></div>
  2388. <p>
  2389. The following macros describe features that may be included in some future
  2390. ISO C++ standard, but have not yet been approved for inclusion in the language.
  2391. </p>
  2392. <div class="informaltable"><table class="table">
  2393. <colgroup>
  2394. <col>
  2395. <col>
  2396. </colgroup>
  2397. <thead><tr>
  2398. <th>
  2399. <p>
  2400. Macro
  2401. </p>
  2402. </th>
  2403. <th>
  2404. <p>
  2405. Description
  2406. </p>
  2407. </th>
  2408. </tr></thead>
  2409. <tbody><tr>
  2410. <td>
  2411. <p>
  2412. <code class="computeroutput"><span class="identifier">BOOST_HAS_CONCEPTS</span></code>
  2413. </p>
  2414. </td>
  2415. <td>
  2416. <p>
  2417. The compiler supports concepts.
  2418. </p>
  2419. </td>
  2420. </tr></tbody>
  2421. </table></div>
  2422. </div>
  2423. <div class="section">
  2424. <div class="titlepage"><div><div><h3 class="title">
  2425. <a name="boost_config.boost_macro_reference.macros_that_describe_c__11_features_not_supported"></a><a class="link" href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_describe_c__11_features_not_supported" title="Macros that describe C++11 features not supported">Macros
  2426. that describe C++11 features not supported</a>
  2427. </h3></div></div></div>
  2428. <p>
  2429. The following macros describe features in the 2011 ISO C++ standard, formerly
  2430. known as C++0x, that are not yet supported by a particular compiler or library.
  2431. </p>
  2432. <div class="informaltable"><table class="table">
  2433. <colgroup>
  2434. <col>
  2435. <col>
  2436. </colgroup>
  2437. <thead><tr>
  2438. <th>
  2439. <p>
  2440. Macro
  2441. </p>
  2442. </th>
  2443. <th>
  2444. <p>
  2445. Description
  2446. </p>
  2447. </th>
  2448. </tr></thead>
  2449. <tbody>
  2450. <tr>
  2451. <td>
  2452. <p>
  2453. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_ADDRESSOF</span></code>
  2454. </p>
  2455. </td>
  2456. <td>
  2457. <p>
  2458. The standard library header &lt;memory&gt; has no working std::addressof.
  2459. </p>
  2460. </td>
  2461. </tr>
  2462. <tr>
  2463. <td>
  2464. <p>
  2465. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_ALIGNAS</span></code>
  2466. </p>
  2467. </td>
  2468. <td>
  2469. <p>
  2470. The compiler does not support the <code class="computeroutput"><span class="keyword">alignas</span></code>
  2471. keyword.
  2472. </p>
  2473. </td>
  2474. </tr>
  2475. <tr>
  2476. <td>
  2477. <p>
  2478. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_ALLOCATOR</span></code>
  2479. </p>
  2480. </td>
  2481. <td>
  2482. <p>
  2483. The standard library does not provide a C++11 version of <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">allocator</span></code> in &lt;memory&gt;.
  2484. </p>
  2485. </td>
  2486. </tr>
  2487. <tr>
  2488. <td>
  2489. <p>
  2490. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_ATOMIC_SMART_PTR</span></code>
  2491. </p>
  2492. </td>
  2493. <td>
  2494. <p>
  2495. The standard library &lt;memory&gt; does not support atomic smart
  2496. pointer operations.
  2497. </p>
  2498. </td>
  2499. </tr>
  2500. <tr>
  2501. <td>
  2502. <p>
  2503. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_AUTO_DECLARATIONS</span></code>
  2504. </p>
  2505. </td>
  2506. <td>
  2507. <p>
  2508. The compiler does not support type deduction for variables declared
  2509. with the <code class="computeroutput"><span class="keyword">auto</span></code> keyword
  2510. (<code class="computeroutput"><span class="keyword">auto</span> <span class="identifier">var</span>
  2511. <span class="special">=</span> <span class="special">...;</span></code>).
  2512. </p>
  2513. </td>
  2514. </tr>
  2515. <tr>
  2516. <td>
  2517. <p>
  2518. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_AUTO_MULTIDECLARATIONS</span></code>
  2519. </p>
  2520. </td>
  2521. <td>
  2522. <p>
  2523. The compiler does not support type deduction for multiple variables
  2524. declared with the <code class="computeroutput"><span class="keyword">auto</span></code>
  2525. keyword (<code class="computeroutput"><span class="keyword">auto</span> <span class="identifier">var</span>
  2526. <span class="special">=</span> <span class="special">...,</span>
  2527. <span class="special">*</span><span class="identifier">ptr</span>
  2528. <span class="special">=</span> <span class="special">...;</span></code>).
  2529. </p>
  2530. </td>
  2531. </tr>
  2532. <tr>
  2533. <td>
  2534. <p>
  2535. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_CHAR16_T</span></code>
  2536. </p>
  2537. </td>
  2538. <td>
  2539. <p>
  2540. The compiler does not support type <code class="computeroutput"><span class="keyword">char16_t</span></code>.
  2541. </p>
  2542. </td>
  2543. </tr>
  2544. <tr>
  2545. <td>
  2546. <p>
  2547. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_CHAR32_T</span></code>
  2548. </p>
  2549. </td>
  2550. <td>
  2551. <p>
  2552. The compiler does not support type <code class="computeroutput"><span class="keyword">char32_t</span></code>.
  2553. </p>
  2554. </td>
  2555. </tr>
  2556. <tr>
  2557. <td>
  2558. <p>
  2559. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_CONSTEXPR</span></code>
  2560. </p>
  2561. </td>
  2562. <td>
  2563. <p>
  2564. The compiler does not support <code class="computeroutput"><span class="keyword">constexpr</span></code>.
  2565. </p>
  2566. </td>
  2567. </tr>
  2568. <tr>
  2569. <td>
  2570. <p>
  2571. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_DECLTYPE</span></code>
  2572. </p>
  2573. </td>
  2574. <td>
  2575. <p>
  2576. The compiler does not support <code class="computeroutput"><span class="keyword">decltype</span></code>.
  2577. </p>
  2578. </td>
  2579. </tr>
  2580. <tr>
  2581. <td>
  2582. <p>
  2583. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_DECLTYPE_N3276</span></code>
  2584. </p>
  2585. </td>
  2586. <td>
  2587. <p>
  2588. The compiler does not support the extension to <code class="computeroutput"><span class="keyword">decltype</span></code>
  2589. described in <a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2011/n3276.pdf" target="_top">N3276</a>,
  2590. accepted in Madrid, March 2011.
  2591. </p>
  2592. </td>
  2593. </tr>
  2594. <tr>
  2595. <td>
  2596. <p>
  2597. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_DELETED_FUNCTIONS</span></code>
  2598. </p>
  2599. </td>
  2600. <td>
  2601. <p>
  2602. The compiler does not support deleted (<code class="computeroutput"><span class="special">=</span>
  2603. <span class="keyword">delete</span></code>) functions.
  2604. </p>
  2605. </td>
  2606. </tr>
  2607. <tr>
  2608. <td>
  2609. <p>
  2610. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_DEFAULTED_FUNCTIONS</span></code>
  2611. </p>
  2612. </td>
  2613. <td>
  2614. <p>
  2615. The compiler does not support defaulted (<code class="computeroutput"><span class="special">=</span>
  2616. <span class="keyword">default</span></code>) functions.
  2617. </p>
  2618. </td>
  2619. </tr>
  2620. <tr>
  2621. <td>
  2622. <p>
  2623. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_DEFAULTED_MOVES</span></code>
  2624. </p>
  2625. </td>
  2626. <td>
  2627. <p>
  2628. The compiler does not support defaulted move constructor or assignment.
  2629. Other defaulted functions may still be supported.
  2630. </p>
  2631. </td>
  2632. </tr>
  2633. <tr>
  2634. <td>
  2635. <p>
  2636. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_EXPLICIT_CONVERSION_OPERATORS</span></code>
  2637. </p>
  2638. </td>
  2639. <td>
  2640. <p>
  2641. The compiler does not support explicit conversion operators (<code class="computeroutput"><span class="keyword">explicit</span> <span class="keyword">operator</span>
  2642. <span class="identifier">T</span><span class="special">()</span></code>).
  2643. </p>
  2644. </td>
  2645. </tr>
  2646. <tr>
  2647. <td>
  2648. <p>
  2649. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_EXTERN_TEMPLATE</span></code>
  2650. </p>
  2651. </td>
  2652. <td>
  2653. <p>
  2654. The compiler does not support explicit instantiation forward declarations
  2655. for templates (<code class="computeroutput"><span class="keyword">extern</span> <span class="keyword">template</span> <span class="special">...</span></code>).
  2656. </p>
  2657. </td>
  2658. </tr>
  2659. <tr>
  2660. <td>
  2661. <p>
  2662. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_FINAL</span></code>
  2663. </p>
  2664. </td>
  2665. <td>
  2666. <p>
  2667. The compiler does not support the C++ class-virt-specifier final.
  2668. </p>
  2669. </td>
  2670. </tr>
  2671. <tr>
  2672. <td>
  2673. <p>
  2674. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_FIXED_LENGTH_VARIADIC_TEMPLATE_EXPANSION_PACKS</span></code>
  2675. </p>
  2676. </td>
  2677. <td>
  2678. <p>
  2679. The compiler does not support expanding a variadic template parameter
  2680. pack into a template containing one or more fixed arguments
  2681. </p>
  2682. </td>
  2683. </tr>
  2684. <tr>
  2685. <td>
  2686. <p>
  2687. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_FUNCTION_TEMPLATE_DEFAULT_ARGS</span></code>
  2688. </p>
  2689. </td>
  2690. <td>
  2691. <p>
  2692. The compiler does not support default template arguments for function
  2693. templates.
  2694. </p>
  2695. </td>
  2696. </tr>
  2697. <tr>
  2698. <td>
  2699. <p>
  2700. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_ATOMIC</span></code>
  2701. </p>
  2702. </td>
  2703. <td>
  2704. <p>
  2705. The standard library does not provide header &lt;atomic&gt;.
  2706. </p>
  2707. </td>
  2708. </tr>
  2709. <tr>
  2710. <td>
  2711. <p>
  2712. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_ARRAY</span></code>
  2713. </p>
  2714. </td>
  2715. <td>
  2716. <p>
  2717. The standard library does not provide header &lt;array&gt;.
  2718. </p>
  2719. </td>
  2720. </tr>
  2721. <tr>
  2722. <td>
  2723. <p>
  2724. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_CHRONO</span></code>
  2725. </p>
  2726. </td>
  2727. <td>
  2728. <p>
  2729. The standard library does not provide header &lt;chrono&gt;.
  2730. </p>
  2731. </td>
  2732. </tr>
  2733. <tr>
  2734. <td>
  2735. <p>
  2736. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_CODECVT</span></code>
  2737. </p>
  2738. </td>
  2739. <td>
  2740. <p>
  2741. The standard library does not provide header &lt;codecvt&gt;.
  2742. </p>
  2743. </td>
  2744. </tr>
  2745. <tr>
  2746. <td>
  2747. <p>
  2748. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_CONDITION_VARIABLE</span></code>
  2749. </p>
  2750. </td>
  2751. <td>
  2752. <p>
  2753. The standard library does not provide header &lt;condition_variable&gt;.
  2754. </p>
  2755. </td>
  2756. </tr>
  2757. <tr>
  2758. <td>
  2759. <p>
  2760. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_EXCEPTION</span></code>
  2761. </p>
  2762. </td>
  2763. <td>
  2764. <p>
  2765. The standard library does not provide a C++11 compatible version
  2766. of &lt;exception&gt;.
  2767. </p>
  2768. </td>
  2769. </tr>
  2770. <tr>
  2771. <td>
  2772. <p>
  2773. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_FORWARD_LIST</span></code>
  2774. </p>
  2775. </td>
  2776. <td>
  2777. <p>
  2778. The standard library does not provide header &lt;forward_list&gt;.
  2779. </p>
  2780. </td>
  2781. </tr>
  2782. <tr>
  2783. <td>
  2784. <p>
  2785. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_FUNCTIONAL</span></code>
  2786. </p>
  2787. </td>
  2788. <td>
  2789. <p>
  2790. The standard library does not provide a C++11 compatible version
  2791. of &lt;functional&gt;.
  2792. </p>
  2793. </td>
  2794. </tr>
  2795. <tr>
  2796. <td>
  2797. <p>
  2798. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_FUTURE</span></code>
  2799. </p>
  2800. </td>
  2801. <td>
  2802. <p>
  2803. The standard library does not provide header &lt;future&gt;.
  2804. </p>
  2805. </td>
  2806. </tr>
  2807. <tr>
  2808. <td>
  2809. <p>
  2810. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_INITIALIZER_LIST</span></code>
  2811. </p>
  2812. </td>
  2813. <td>
  2814. <p>
  2815. The standard library does not provide header &lt;initializer_list&gt;.
  2816. </p>
  2817. </td>
  2818. </tr>
  2819. <tr>
  2820. <td>
  2821. <p>
  2822. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_MUTEX</span></code>
  2823. </p>
  2824. </td>
  2825. <td>
  2826. <p>
  2827. The standard library does not provide header &lt;mutex&gt;.
  2828. </p>
  2829. </td>
  2830. </tr>
  2831. <tr>
  2832. <td>
  2833. <p>
  2834. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_RANDOM</span></code>
  2835. </p>
  2836. </td>
  2837. <td>
  2838. <p>
  2839. The standard library does not provide header &lt;random&gt;.
  2840. </p>
  2841. </td>
  2842. </tr>
  2843. <tr>
  2844. <td>
  2845. <p>
  2846. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_RATIO</span></code>
  2847. </p>
  2848. </td>
  2849. <td>
  2850. <p>
  2851. The standard library does not provide header &lt;ratio&gt;.
  2852. </p>
  2853. </td>
  2854. </tr>
  2855. <tr>
  2856. <td>
  2857. <p>
  2858. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_REGEX</span></code>
  2859. </p>
  2860. </td>
  2861. <td>
  2862. <p>
  2863. The standard library does not provide header &lt;regex&gt;.
  2864. </p>
  2865. </td>
  2866. </tr>
  2867. <tr>
  2868. <td>
  2869. <p>
  2870. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_SYSTEM_ERROR</span></code>
  2871. </p>
  2872. </td>
  2873. <td>
  2874. <p>
  2875. The standard library does not provide header &lt;system_error&gt;.
  2876. </p>
  2877. </td>
  2878. </tr>
  2879. <tr>
  2880. <td>
  2881. <p>
  2882. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_THREAD</span></code>
  2883. </p>
  2884. </td>
  2885. <td>
  2886. <p>
  2887. The standard library does not provide header &lt;thread&gt;.
  2888. </p>
  2889. </td>
  2890. </tr>
  2891. <tr>
  2892. <td>
  2893. <p>
  2894. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_TUPLE</span></code>
  2895. </p>
  2896. </td>
  2897. <td>
  2898. <p>
  2899. The standard library does not provide header &lt;tuple&gt;.
  2900. </p>
  2901. </td>
  2902. </tr>
  2903. <tr>
  2904. <td>
  2905. <p>
  2906. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_TYPEINDEX</span></code>
  2907. </p>
  2908. </td>
  2909. <td>
  2910. <p>
  2911. The standard library does not provide header &lt;typeindex&gt;.
  2912. </p>
  2913. </td>
  2914. </tr>
  2915. <tr>
  2916. <td>
  2917. <p>
  2918. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_TYPE_TRAITS</span></code>
  2919. </p>
  2920. </td>
  2921. <td>
  2922. <p>
  2923. The standard library does not provide header &lt;type_traits&gt;.
  2924. </p>
  2925. </td>
  2926. </tr>
  2927. <tr>
  2928. <td>
  2929. <p>
  2930. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_UNORDERED_MAP</span></code>
  2931. </p>
  2932. </td>
  2933. <td>
  2934. <p>
  2935. The standard library does not provide header &lt;unordered_map&gt;.
  2936. </p>
  2937. </td>
  2938. </tr>
  2939. <tr>
  2940. <td>
  2941. <p>
  2942. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_UNORDERED_SET</span></code>
  2943. </p>
  2944. </td>
  2945. <td>
  2946. <p>
  2947. The standard library does not provide header &lt;unordered_set&gt;.
  2948. </p>
  2949. </td>
  2950. </tr>
  2951. <tr>
  2952. <td>
  2953. <p>
  2954. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_INLINE_NAMESPACES</span></code>
  2955. </p>
  2956. </td>
  2957. <td>
  2958. <p>
  2959. The compiler does not support inline namespaces.
  2960. </p>
  2961. </td>
  2962. </tr>
  2963. <tr>
  2964. <td>
  2965. <p>
  2966. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_LAMBDAS</span></code>
  2967. </p>
  2968. </td>
  2969. <td>
  2970. <p>
  2971. The compiler does not support Lambdas.
  2972. </p>
  2973. </td>
  2974. </tr>
  2975. <tr>
  2976. <td>
  2977. <p>
  2978. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_LOCAL_CLASS_TEMPLATE_PARAMETERS</span></code>
  2979. </p>
  2980. </td>
  2981. <td>
  2982. <p>
  2983. The compiler does not allow to pass local classes as template parameters
  2984. (this macro intentionally does not control passing of unnamed types
  2985. as template parameters, see also <a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2657.htm" target="_top">N2657</a>).
  2986. </p>
  2987. </td>
  2988. </tr>
  2989. <tr>
  2990. <td>
  2991. <p>
  2992. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_NON_PUBLIC_DEFAULTED_FUNCTIONS</span></code>
  2993. </p>
  2994. </td>
  2995. <td>
  2996. <p>
  2997. The compiler does not support defaulted (<code class="computeroutput"><span class="special">=</span>
  2998. <span class="keyword">default</span></code>) functions in access
  2999. control sections other than <code class="computeroutput"><span class="keyword">public</span></code>.
  3000. Public defaulted functions may still be supported, as indicated
  3001. by <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_DEFAULTED_FUNCTIONS</span></code>.
  3002. Some compilers implementing an early draft of the C++11 standard
  3003. (in particular, incorporating <a href="http://www.open-std.org/jtc1/sc22/wg21/docs/cwg_defects.html#906" target="_top">DR906</a>)
  3004. are susceptible to this problem.
  3005. </p>
  3006. </td>
  3007. </tr>
  3008. <tr>
  3009. <td>
  3010. <p>
  3011. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_NOEXCEPT</span></code>
  3012. </p>
  3013. </td>
  3014. <td>
  3015. <p>
  3016. The compiler does not support <code class="computeroutput"><span class="keyword">noexcept</span></code>.
  3017. </p>
  3018. </td>
  3019. </tr>
  3020. <tr>
  3021. <td>
  3022. <p>
  3023. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_NULLPTR</span></code>
  3024. </p>
  3025. </td>
  3026. <td>
  3027. <p>
  3028. The compiler does not support <code class="computeroutput"><span class="keyword">nullptr</span></code>.
  3029. </p>
  3030. </td>
  3031. </tr>
  3032. <tr>
  3033. <td>
  3034. <p>
  3035. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_NUMERIC_LIMITS</span></code>
  3036. </p>
  3037. </td>
  3038. <td>
  3039. <p>
  3040. The standard library <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">limits</span><span class="special">&gt;</span></code>
  3041. header does not support the C++11 version of <code class="computeroutput"><span class="identifier">numeric_limits</span></code>.
  3042. </p>
  3043. </td>
  3044. </tr>
  3045. <tr>
  3046. <td>
  3047. <p>
  3048. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_POINTER_TRAITS</span></code>
  3049. </p>
  3050. </td>
  3051. <td>
  3052. <p>
  3053. The standard library does not provide a C++11 version of <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">pointer_traits</span></code> in &lt;memory&gt;.
  3054. </p>
  3055. </td>
  3056. </tr>
  3057. <tr>
  3058. <td>
  3059. <p>
  3060. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_RANGE_BASED_FOR</span></code>
  3061. </p>
  3062. </td>
  3063. <td>
  3064. <p>
  3065. The compiler does not support range-based for statements.
  3066. </p>
  3067. </td>
  3068. </tr>
  3069. <tr>
  3070. <td>
  3071. <p>
  3072. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_RAW_LITERALS</span></code>
  3073. </p>
  3074. </td>
  3075. <td>
  3076. <p>
  3077. The compiler does not support raw string literals.
  3078. </p>
  3079. </td>
  3080. </tr>
  3081. <tr>
  3082. <td>
  3083. <p>
  3084. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_REF_QUALIFIERS</span></code>
  3085. </p>
  3086. </td>
  3087. <td>
  3088. <p>
  3089. The compiler does not support ref-qualifiers on member functions
  3090. as described in <a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2439.htm" target="_top">N2439</a>.
  3091. </p>
  3092. </td>
  3093. </tr>
  3094. <tr>
  3095. <td>
  3096. <p>
  3097. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_RVALUE_REFERENCES</span></code>
  3098. </p>
  3099. </td>
  3100. <td>
  3101. <p>
  3102. The compiler does not support r-value references.
  3103. </p>
  3104. </td>
  3105. </tr>
  3106. <tr>
  3107. <td>
  3108. <p>
  3109. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_SCOPED_ENUMS</span></code>
  3110. </p>
  3111. </td>
  3112. <td>
  3113. <p>
  3114. The compiler does not support scoped enumerations (<code class="computeroutput"><span class="keyword">enum</span> <span class="keyword">class</span></code>).
  3115. </p>
  3116. </td>
  3117. </tr>
  3118. <tr>
  3119. <td>
  3120. <p>
  3121. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_SFINAE_EXPR</span></code>
  3122. </p>
  3123. </td>
  3124. <td>
  3125. <p>
  3126. The compiler does not support usage of C++11 SFINAE with arbitrary
  3127. expressions. Use this macro only if you are using all of the features
  3128. of SFINAE including substitution-failure-on-private-member-access.
  3129. Otherwise use BOOST_NO_SFINAE_EXPR or BOOST_NO_SFINAE which get
  3130. defined for fewer compilers.
  3131. </p>
  3132. </td>
  3133. </tr>
  3134. <tr>
  3135. <td>
  3136. <p>
  3137. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_SMART_PTR</span></code>
  3138. </p>
  3139. </td>
  3140. <td>
  3141. <p>
  3142. The standard library header &lt;memory&gt; has no shared_ptr and
  3143. unique_ptr.
  3144. </p>
  3145. </td>
  3146. </tr>
  3147. <tr>
  3148. <td>
  3149. <p>
  3150. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_STATIC_ASSERT</span></code>
  3151. </p>
  3152. </td>
  3153. <td>
  3154. <p>
  3155. The compiler does not support <code class="computeroutput"><span class="keyword">static_assert</span></code>.
  3156. </p>
  3157. </td>
  3158. </tr>
  3159. <tr>
  3160. <td>
  3161. <p>
  3162. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_STD_ALIGN</span></code>
  3163. </p>
  3164. </td>
  3165. <td>
  3166. <p>
  3167. The standard library header &lt;memory&gt; has no working std::align.
  3168. </p>
  3169. </td>
  3170. </tr>
  3171. <tr>
  3172. <td>
  3173. <p>
  3174. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_STD_UNORDERED</span></code>
  3175. </p>
  3176. </td>
  3177. <td>
  3178. <p>
  3179. The standard library does not support &lt;unordered_map&gt; and
  3180. &lt;unordered_set&gt;.
  3181. </p>
  3182. </td>
  3183. </tr>
  3184. <tr>
  3185. <td>
  3186. <p>
  3187. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_TEMPLATE_ALIASES</span></code>
  3188. </p>
  3189. </td>
  3190. <td>
  3191. <p>
  3192. The compiler does not support template aliases.
  3193. </p>
  3194. </td>
  3195. </tr>
  3196. <tr>
  3197. <td>
  3198. <p>
  3199. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_THREAD_LOCAL</span></code>
  3200. </p>
  3201. </td>
  3202. <td>
  3203. <p>
  3204. The compiler does not support the <code class="computeroutput"><span class="keyword">thread_local</span></code>
  3205. storage specifier.
  3206. </p>
  3207. </td>
  3208. </tr>
  3209. <tr>
  3210. <td>
  3211. <p>
  3212. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_TRAILING_RESULT_TYPES</span></code>
  3213. </p>
  3214. </td>
  3215. <td>
  3216. <p>
  3217. The compiler does not support the new function result type specification
  3218. syntax (e.g. <code class="computeroutput"><span class="keyword">auto</span> <span class="identifier">foo</span><span class="special">(</span><span class="identifier">T</span><span class="special">)</span>
  3219. <span class="special">-&gt;</span> <span class="identifier">T</span><span class="special">;</span></code>).
  3220. </p>
  3221. </td>
  3222. </tr>
  3223. <tr>
  3224. <td>
  3225. <p>
  3226. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_UNICODE_LITERALS</span></code>
  3227. </p>
  3228. </td>
  3229. <td>
  3230. <p>
  3231. The compiler does not support Unicode (<code class="computeroutput"><span class="identifier">u8</span></code>,
  3232. <code class="computeroutput"><span class="identifier">u</span></code>, <code class="computeroutput"><span class="identifier">U</span></code>) literals.
  3233. </p>
  3234. </td>
  3235. </tr>
  3236. <tr>
  3237. <td>
  3238. <p>
  3239. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_UNIFIED_INITIALIZATION_SYNTAX</span></code>
  3240. </p>
  3241. </td>
  3242. <td>
  3243. <p>
  3244. The compiler does not support the <a href="http://en.wikipedia.org/wiki/C%2B%2B0x#Uniform_initialization" target="_top">C++11
  3245. Unified Initialization Syntax</a>.
  3246. </p>
  3247. </td>
  3248. </tr>
  3249. <tr>
  3250. <td>
  3251. <p>
  3252. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_USER_DEFINED_LITERALS</span></code>
  3253. </p>
  3254. </td>
  3255. <td>
  3256. <p>
  3257. The compiler does not support user defined literals.
  3258. </p>
  3259. </td>
  3260. </tr>
  3261. <tr>
  3262. <td>
  3263. <p>
  3264. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_VARIADIC_TEMPLATES</span></code>
  3265. </p>
  3266. </td>
  3267. <td>
  3268. <p>
  3269. The compiler does not support variadic templates.
  3270. </p>
  3271. </td>
  3272. </tr>
  3273. <tr>
  3274. <td>
  3275. <p>
  3276. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_VARIADIC_MACROS</span></code>
  3277. </p>
  3278. </td>
  3279. <td>
  3280. <p>
  3281. The compiler does not support variadic macros.
  3282. </p>
  3283. </td>
  3284. </tr>
  3285. <tr>
  3286. <td>
  3287. <p>
  3288. <code class="computeroutput"><span class="identifier">BOOST_NO_LONG_LONG</span></code>
  3289. </p>
  3290. </td>
  3291. <td>
  3292. <p>
  3293. The compiler does not support <code class="computeroutput"><span class="keyword">long</span>
  3294. <span class="keyword">long</span></code>.
  3295. </p>
  3296. </td>
  3297. </tr>
  3298. </tbody>
  3299. </table></div>
  3300. </div>
  3301. <div class="section">
  3302. <div class="titlepage"><div><div><h3 class="title">
  3303. <a name="boost_config.boost_macro_reference.macros_that_allow_use_of_c__11_features_with_c__03_compilers"></a><a name="config_11_for_03"></a><a class="link" href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_allow_use_of_c__11_features_with_c__03_compilers" title="Macros that allow use of C++11 features with C++03 compilers">Macros
  3304. that allow use of C++11 features with C++03 compilers</a>
  3305. </h3></div></div></div>
  3306. <p>
  3307. The following macros allow use of C++11 features even with compilers that
  3308. do not yet provide compliant C++11 support.
  3309. </p>
  3310. <div class="informaltable"><table class="table">
  3311. <colgroup>
  3312. <col>
  3313. <col>
  3314. </colgroup>
  3315. <thead><tr>
  3316. <th>
  3317. <p>
  3318. Macro
  3319. </p>
  3320. </th>
  3321. <th>
  3322. <p>
  3323. Description
  3324. </p>
  3325. </th>
  3326. </tr></thead>
  3327. <tbody>
  3328. <tr>
  3329. <td>
  3330. <p>
  3331. <code class="computeroutput"><span class="identifier">BOOST_ALIGNMENT</span><span class="special">(</span><span class="identifier">X</span><span class="special">)</span></code>, <code class="computeroutput"><span class="identifier">BOOST_NO_ALIGNMENT</span></code>
  3332. </p>
  3333. </td>
  3334. <td>
  3335. <p>
  3336. Some compilers don't support the <code class="computeroutput"><span class="keyword">alignas</span></code>
  3337. keyword but provide other means to specify alignment (usually,
  3338. through compiler-specific attributes). The macro <code class="computeroutput"><span class="identifier">BOOST_ALIGNMENT</span><span class="special">(</span><span class="identifier">X</span><span class="special">)</span></code>
  3339. will expand to the <code class="computeroutput"><span class="keyword">alignas</span><span class="special">(</span><span class="identifier">X</span><span class="special">)</span></code> keyword if the compiler supports
  3340. it or to some compiler-specific attribute to achieve the specified
  3341. alignment. If no such compiler-specific attribute is known then
  3342. <code class="computeroutput"><span class="identifier">BOOST_ALIGNMENT</span><span class="special">(</span><span class="identifier">X</span><span class="special">)</span></code> will expand to nothing and <code class="computeroutput"><span class="identifier">BOOST_NO_ALIGNMENT</span></code> will be defined.
  3343. Unlike native <code class="computeroutput"><span class="keyword">alignas</span></code>,
  3344. <code class="computeroutput"><span class="identifier">X</span></code> must always be
  3345. a compile-time integer constant. The macro can be used to specify
  3346. alignment of types and data:
  3347. </p>
  3348. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">struct</span> <span class="identifier">BOOST_ALIGNMENT</span><span class="special">(</span><span class="number">16</span><span class="special">)</span> <span class="identifier">my_data</span>
  3349. <span class="special">{</span>
  3350. <span class="keyword">char</span> <span class="identifier">c</span><span class="special">[</span><span class="number">16</span><span class="special">];</span>
  3351. <span class="special">};</span>
  3352. <span class="identifier">BOOST_ALIGNMENT</span><span class="special">(</span><span class="number">8</span><span class="special">)</span> <span class="keyword">int</span> <span class="identifier">arr</span><span class="special">[</span><span class="number">32</span><span class="special">];</span>
  3353. </pre>
  3354. <p>
  3355. </p>
  3356. </td>
  3357. </tr>
  3358. <tr>
  3359. <td>
  3360. <p>
  3361. <code class="computeroutput"><span class="identifier">BOOST_CONSTEXPR</span></code>
  3362. </p>
  3363. </td>
  3364. <td>
  3365. <p>
  3366. Some compilers don't support the use of <code class="computeroutput"><span class="keyword">constexpr</span></code>.
  3367. This macro expands to nothing on those compilers, and <code class="computeroutput"><span class="keyword">constexpr</span></code> elsewhere. For example,
  3368. when defining a constexpr function or constructor replace:
  3369. </p>
  3370. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">constexpr</span> <span class="identifier">tuple</span><span class="special">();</span>
  3371. </pre>
  3372. <p>
  3373. with:
  3374. </p>
  3375. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="identifier">BOOST_CONSTEXPR</span> <span class="identifier">tuple</span><span class="special">();</span>
  3376. </pre>
  3377. <p>
  3378. </p>
  3379. </td>
  3380. </tr>
  3381. <tr>
  3382. <td>
  3383. <p>
  3384. <code class="computeroutput"><span class="identifier">BOOST_CONSTEXPR_OR_CONST</span></code>
  3385. </p>
  3386. </td>
  3387. <td>
  3388. <p>
  3389. Some compilers don't support the use of <code class="computeroutput"><span class="keyword">constexpr</span></code>.
  3390. This macro expands to <code class="computeroutput"><span class="keyword">const</span></code>
  3391. on those compilers, and <code class="computeroutput"><span class="keyword">constexpr</span></code>
  3392. elsewhere. For example, when defining const expr variables replace:
  3393. </p>
  3394. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">static</span> <span class="keyword">constexpr</span> <span class="identifier">UIntType</span> <span class="identifier">xor_mask</span> <span class="special">=</span> <span class="identifier">a</span><span class="special">;</span>
  3395. </pre>
  3396. <p>
  3397. with:
  3398. </p>
  3399. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">static</span> <span class="identifier">BOOST_CONSTEXPR_OR_CONST</span> <span class="identifier">UIntType</span> <span class="identifier">xor_mask</span> <span class="special">=</span> <span class="identifier">a</span><span class="special">;</span>
  3400. </pre>
  3401. <p>
  3402. </p>
  3403. </td>
  3404. </tr>
  3405. <tr>
  3406. <td>
  3407. <p>
  3408. <code class="computeroutput"><span class="identifier">BOOST_STATIC_CONSTEXPR</span></code>
  3409. </p>
  3410. </td>
  3411. <td>
  3412. <p>
  3413. This is a shortcut for <code class="computeroutput"><span class="keyword">static</span>
  3414. <span class="identifier">BOOST_CONSTEXPR_OR_CONST</span></code>.
  3415. For example, when defining const expr variables replace:
  3416. </p>
  3417. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">static</span> <span class="keyword">constexpr</span> <span class="identifier">UIntType</span> <span class="identifier">xor_mask</span> <span class="special">=</span> <span class="identifier">a</span><span class="special">;</span>
  3418. </pre>
  3419. <p>
  3420. with:
  3421. </p>
  3422. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="identifier">BOOST_STATIC_CONSTEXPR</span> <span class="identifier">UIntType</span> <span class="identifier">xor_mask</span> <span class="special">=</span> <span class="identifier">a</span><span class="special">;</span>
  3423. </pre>
  3424. <p>
  3425. </p>
  3426. </td>
  3427. </tr>
  3428. <tr>
  3429. <td>
  3430. <p>
  3431. <code class="computeroutput"><span class="identifier">BOOST_DEFAULTED_FUNCTION</span><span class="special">(</span><span class="identifier">fun</span><span class="special">,</span> <span class="identifier">body</span><span class="special">)</span></code>
  3432. </p>
  3433. </td>
  3434. <td>
  3435. <p>
  3436. This macro is intended to be used within a class definition in
  3437. order to declare a default implementation of function <code class="computeroutput"><span class="identifier">fun</span></code>. For the compilers that do
  3438. not support C++11 defaulted functions the macro will expand into
  3439. an inline function definition with the <code class="computeroutput"><span class="identifier">body</span></code>
  3440. implementation. For example:
  3441. </p>
  3442. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">struct</span> <span class="identifier">my_struct</span>
  3443. <span class="special">{</span>
  3444. <span class="identifier">BOOST_DEFAULTED_FUNCTION</span><span class="special">(</span><span class="identifier">my_struct</span><span class="special">(),</span> <span class="special">{})</span>
  3445. <span class="special">};</span>
  3446. </pre>
  3447. <p>
  3448. is equivalent to:
  3449. </p>
  3450. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">struct</span> <span class="identifier">my_struct</span>
  3451. <span class="special">{</span>
  3452. <span class="identifier">my_struct</span><span class="special">()</span> <span class="special">=</span> <span class="keyword">default</span><span class="special">;</span>
  3453. <span class="special">};</span>
  3454. </pre>
  3455. <p>
  3456. or:
  3457. </p>
  3458. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">struct</span> <span class="identifier">my_struct</span>
  3459. <span class="special">{</span>
  3460. <span class="identifier">my_struct</span><span class="special">()</span> <span class="special">{}</span>
  3461. <span class="special">};</span>
  3462. </pre>
  3463. <p>
  3464. </p>
  3465. </td>
  3466. </tr>
  3467. <tr>
  3468. <td>
  3469. <p>
  3470. <code class="computeroutput"><span class="identifier">BOOST_DELETED_FUNCTION</span><span class="special">(</span><span class="identifier">fun</span><span class="special">)</span></code>
  3471. </p>
  3472. </td>
  3473. <td>
  3474. <p>
  3475. This macro is intended to be used within a class definition in
  3476. order to declare a deleted function <code class="computeroutput"><span class="identifier">fun</span></code>.
  3477. For the compilers that do not support C++11 deleted functions the
  3478. macro will expand into a private function declaration with no definition.
  3479. Since the macro may change the access mode, it is recommended to
  3480. use this macro at the end of the class definition. For example:
  3481. </p>
  3482. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">struct</span> <span class="identifier">noncopyable</span>
  3483. <span class="special">{</span>
  3484. <span class="identifier">BOOST_DELETED_FUNCTION</span><span class="special">(</span><span class="identifier">noncopyable</span><span class="special">(</span><span class="identifier">noncopyable</span> <span class="keyword">const</span><span class="special">&amp;))</span>
  3485. <span class="identifier">BOOST_DELETED_FUNCTION</span><span class="special">(</span><span class="identifier">noncopyable</span><span class="special">&amp;</span> <span class="keyword">operator</span><span class="special">=</span> <span class="special">(</span><span class="identifier">noncopyable</span> <span class="keyword">const</span><span class="special">&amp;))</span>
  3486. <span class="special">};</span>
  3487. </pre>
  3488. <p>
  3489. is equivalent to:
  3490. </p>
  3491. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">struct</span> <span class="identifier">noncopyable</span>
  3492. <span class="special">{</span>
  3493. <span class="identifier">noncopyable</span><span class="special">(</span><span class="identifier">noncopyable</span> <span class="keyword">const</span><span class="special">&amp;)</span> <span class="special">=</span> <span class="keyword">delete</span><span class="special">;</span>
  3494. <span class="identifier">noncopyable</span><span class="special">&amp;</span> <span class="keyword">operator</span><span class="special">=</span> <span class="special">(</span><span class="identifier">noncopyable</span> <span class="keyword">const</span><span class="special">&amp;)</span> <span class="special">=</span> <span class="keyword">delete</span><span class="special">;</span>
  3495. <span class="special">};</span>
  3496. </pre>
  3497. <p>
  3498. or:
  3499. </p>
  3500. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">struct</span> <span class="identifier">noncopyable</span>
  3501. <span class="special">{</span>
  3502. <span class="keyword">private</span><span class="special">:</span>
  3503. <span class="identifier">noncopyable</span><span class="special">(</span><span class="identifier">noncopyable</span> <span class="keyword">const</span><span class="special">&amp;);</span>
  3504. <span class="identifier">noncopyable</span><span class="special">&amp;</span> <span class="keyword">operator</span><span class="special">=</span> <span class="special">(</span><span class="identifier">noncopyable</span> <span class="keyword">const</span><span class="special">&amp;);</span>
  3505. <span class="special">};</span>
  3506. </pre>
  3507. <p>
  3508. </p>
  3509. </td>
  3510. </tr>
  3511. <tr>
  3512. <td>
  3513. <p>
  3514. </p>
  3515. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="identifier">BOOST_NOEXCEPT</span>
  3516. <span class="identifier">BOOST_NOEXCEPT_OR_NOTHROW</span>
  3517. <span class="identifier">BOOST_NOEXCEPT_IF</span><span class="special">(</span><span class="identifier">Predicate</span><span class="special">)</span>
  3518. <span class="identifier">BOOST_NOEXCEPT_EXPR</span><span class="special">(</span><span class="identifier">Expression</span><span class="special">)</span>
  3519. </pre>
  3520. <p>
  3521. </p>
  3522. </td>
  3523. <td>
  3524. <p>
  3525. If <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_NOEXCEPT</span></code>
  3526. is defined (i.e. C++03 compliant compilers) these macros are defined
  3527. as:
  3528. </p>
  3529. <div class="blockquote"><blockquote class="blockquote">
  3530. <p>
  3531. </p>
  3532. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="preprocessor">#define</span> <span class="identifier">BOOST_NOEXCEPT</span>
  3533. <span class="preprocessor">#define</span> <span class="identifier">BOOST_NOEXCEPT_OR_NOTHROW</span> <span class="keyword">throw</span><span class="special">()</span>
  3534. <span class="preprocessor">#define</span> <span class="identifier">BOOST_NOEXCEPT_IF</span><span class="special">(</span><span class="identifier">Predicate</span><span class="special">)</span>
  3535. <span class="preprocessor">#define</span> <span class="identifier">BOOST_NOEXCEPT_EXPR</span><span class="special">(</span><span class="identifier">Expression</span><span class="special">)</span> <span class="keyword">false</span>
  3536. </pre>
  3537. <p>
  3538. </p>
  3539. </blockquote></div>
  3540. <p>
  3541. If <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_NOEXCEPT</span></code>
  3542. is not defined (i.e. C++11 compliant compilers) they are defined
  3543. as:
  3544. </p>
  3545. <div class="blockquote"><blockquote class="blockquote">
  3546. <p>
  3547. </p>
  3548. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="preprocessor">#define</span> <span class="identifier">BOOST_NOEXCEPT</span> <span class="keyword">noexcept</span>
  3549. <span class="preprocessor">#define</span> <span class="identifier">BOOST_NOEXCEPT_OR_NOTHROW</span> <span class="keyword">noexcept</span>
  3550. <span class="preprocessor">#define</span> <span class="identifier">BOOST_NOEXCEPT_IF</span><span class="special">(</span><span class="identifier">Predicate</span><span class="special">)</span> <span class="keyword">noexcept</span><span class="special">((</span><span class="identifier">Predicate</span><span class="special">))</span>
  3551. <span class="preprocessor">#define</span> <span class="identifier">BOOST_NOEXCEPT_EXPR</span><span class="special">(</span><span class="identifier">Expression</span><span class="special">)</span> <span class="keyword">noexcept</span><span class="special">((</span><span class="identifier">Expression</span><span class="special">))</span>
  3552. </pre>
  3553. <p>
  3554. </p>
  3555. </blockquote></div>
  3556. </td>
  3557. </tr>
  3558. <tr>
  3559. <td>
  3560. <p>
  3561. <code class="computeroutput"><span class="identifier">BOOST_FINAL</span></code>
  3562. </p>
  3563. </td>
  3564. <td>
  3565. <p>
  3566. If <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_FINAL</span></code>
  3567. is not defined (i.e. C++11 compliant compilers), expands to <code class="computeroutput"><span class="identifier">final</span></code> keyword, otherwise expands
  3568. to nothing.
  3569. </p>
  3570. </td>
  3571. </tr>
  3572. <tr>
  3573. <td>
  3574. <p>
  3575. <code class="computeroutput"><span class="identifier">BOOST_MSVC_ENABLE_2012_NOV_CTP</span></code>
  3576. </p>
  3577. </td>
  3578. <td>
  3579. <p>
  3580. For Microsoft Visual C++ 2012, enable the C++11 features supplied
  3581. by the November 2012 Community Technology Preview. These features
  3582. are not automatically enabled because the CTP is non-supported
  3583. alpha code that is not recommended for production use. This macro
  3584. must be defined before including any Boost headers, and must be
  3585. defined for all translation units in the program, including Boost
  3586. library builds. This macro will no longer have any effect once
  3587. an official Microsoft release supports the CTP features.
  3588. </p>
  3589. </td>
  3590. </tr>
  3591. </tbody>
  3592. </table></div>
  3593. </div>
  3594. <div class="section">
  3595. <div class="titlepage"><div><div><h3 class="title">
  3596. <a name="boost_config.boost_macro_reference.macros_that_describe_c__14_features_not_supported"></a><a class="link" href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_describe_c__14_features_not_supported" title="Macros that describe C++14 features not supported">Macros
  3597. that describe C++14 features not supported</a>
  3598. </h3></div></div></div>
  3599. <p>
  3600. The following macros describe features in the 2014 ISO C++ standard, formerly
  3601. known as C++0y, that are not yet supported by a particular compiler or library.
  3602. </p>
  3603. <div class="informaltable"><table class="table">
  3604. <colgroup>
  3605. <col>
  3606. <col>
  3607. </colgroup>
  3608. <thead><tr>
  3609. <th>
  3610. <p>
  3611. Macro
  3612. </p>
  3613. </th>
  3614. <th>
  3615. <p>
  3616. Description
  3617. </p>
  3618. </th>
  3619. </tr></thead>
  3620. <tbody>
  3621. <tr>
  3622. <td>
  3623. <p>
  3624. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX14_AGGREGATE_NSDMI</span></code>
  3625. </p>
  3626. </td>
  3627. <td>
  3628. <p>
  3629. The compiler does not support member initializer for aggregates
  3630. as in the following example:
  3631. </p>
  3632. <div class="blockquote"><blockquote class="blockquote">
  3633. <p>
  3634. </p>
  3635. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">struct</span> <span class="identifier">Foo</span>
  3636. <span class="special">{</span>
  3637. <span class="keyword">int</span> <span class="identifier">x</span><span class="special">,</span> <span class="identifier">y</span> <span class="special">=</span> <span class="number">42</span><span class="special">;</span>
  3638. <span class="special">};</span>
  3639. <span class="identifier">Foo</span> <span class="identifier">foo</span> <span class="special">=</span> <span class="special">{</span> <span class="number">0</span> <span class="special">};</span>
  3640. </pre>
  3641. <p>
  3642. </p>
  3643. </blockquote></div>
  3644. </td>
  3645. </tr>
  3646. <tr>
  3647. <td>
  3648. <p>
  3649. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX14_BINARY_LITERALS</span></code>
  3650. </p>
  3651. </td>
  3652. <td>
  3653. <p>
  3654. The compiler does not binary literals (e.g. <code class="computeroutput"><span class="number">0</span><span class="identifier">b1010</span></code>).
  3655. </p>
  3656. </td>
  3657. </tr>
  3658. <tr>
  3659. <td>
  3660. <p>
  3661. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX14_CONSTEXPR</span></code>
  3662. </p>
  3663. </td>
  3664. <td>
  3665. <p>
  3666. The compiler does not support relaxed <code class="computeroutput"><span class="keyword">constexpr</span></code>.
  3667. </p>
  3668. </td>
  3669. </tr>
  3670. <tr>
  3671. <td>
  3672. <p>
  3673. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX14_DECLTYPE_AUTO</span></code>
  3674. </p>
  3675. </td>
  3676. <td>
  3677. <p>
  3678. The compiler does not support <code class="computeroutput"><span class="keyword">decltype</span><span class="special">(</span><span class="keyword">auto</span><span class="special">)</span></code>.
  3679. </p>
  3680. </td>
  3681. </tr>
  3682. <tr>
  3683. <td>
  3684. <p>
  3685. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX14_DIGIT_SEPARATORS</span></code>
  3686. </p>
  3687. </td>
  3688. <td>
  3689. <p>
  3690. The compiler does not support digit separators (e.g. <code class="computeroutput"><span class="number">1</span><span class="char">'000'</span><span class="number">000</span></code>).
  3691. </p>
  3692. </td>
  3693. </tr>
  3694. <tr>
  3695. <td>
  3696. <p>
  3697. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX14_STD_EXCHANGE</span></code>
  3698. </p>
  3699. </td>
  3700. <td>
  3701. <p>
  3702. The compiler does not support <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">exchange</span><span class="special">()</span></code>.
  3703. </p>
  3704. </td>
  3705. </tr>
  3706. <tr>
  3707. <td>
  3708. <p>
  3709. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX14_GENERIC_LAMBDAS</span></code>
  3710. </p>
  3711. </td>
  3712. <td>
  3713. <p>
  3714. The compiler does not support generic lambda (e.g. <code class="computeroutput"><span class="special">[](</span><span class="keyword">auto</span>
  3715. <span class="identifier">v</span><span class="special">){</span>
  3716. <span class="special">}</span></code>).
  3717. </p>
  3718. </td>
  3719. </tr>
  3720. <tr>
  3721. <td>
  3722. <p>
  3723. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX14_HDR_SHARED_MUTEX</span></code>
  3724. </p>
  3725. </td>
  3726. <td>
  3727. <p>
  3728. The standard library does not provide header &lt;shared_mutex&gt;.
  3729. </p>
  3730. </td>
  3731. </tr>
  3732. <tr>
  3733. <td>
  3734. <p>
  3735. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX14_INITIALIZED_LAMBDA_CAPTURES</span></code>
  3736. </p>
  3737. </td>
  3738. <td>
  3739. <p>
  3740. The compiler does not support initialized lambda capture (e.g.
  3741. <code class="computeroutput"><span class="special">[</span><span class="identifier">foo</span>
  3742. <span class="special">=</span> <span class="number">42</span><span class="special">]{</span> <span class="special">}</span></code>).
  3743. </p>
  3744. </td>
  3745. </tr>
  3746. <tr>
  3747. <td>
  3748. <p>
  3749. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX14_RETURN_TYPE_DEDUCTION</span></code>
  3750. </p>
  3751. </td>
  3752. <td>
  3753. <p>
  3754. The compiler does not support return type deduction for normal
  3755. functions (e.g. <code class="computeroutput"><span class="keyword">auto</span> <span class="identifier">f</span><span class="special">()</span>
  3756. <span class="special">{</span> <span class="keyword">return</span>
  3757. <span class="identifier">val</span><span class="special">;</span>
  3758. <span class="special">}</span></code>).
  3759. </p>
  3760. </td>
  3761. </tr>
  3762. <tr>
  3763. <td>
  3764. <p>
  3765. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX14_VARIABLE_TEMPLATES</span></code>
  3766. </p>
  3767. </td>
  3768. <td>
  3769. <p>
  3770. The compiler does not support variable template (e.g. <code class="computeroutput"><span class="keyword">template</span> <span class="special">&lt;</span><span class="keyword">class</span> <span class="identifier">T</span><span class="special">&gt;</span> <span class="identifier">T</span>
  3771. <span class="identifier">kibi</span> <span class="special">=</span>
  3772. <span class="identifier">T</span><span class="special">(</span><span class="number">1024</span><span class="special">);</span></code>).
  3773. </p>
  3774. </td>
  3775. </tr>
  3776. </tbody>
  3777. </table></div>
  3778. </div>
  3779. <div class="section">
  3780. <div class="titlepage"><div><div><h3 class="title">
  3781. <a name="boost_config.boost_macro_reference.macros_that_allow_use_of_c__14_features_with_c__11_or_earlier_compilers"></a><a name="config_14_for_11"></a><a class="link" href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_allow_use_of_c__14_features_with_c__11_or_earlier_compilers" title="Macros that allow use of C++14 features with C++11 or earlier compilers">Macros
  3782. that allow use of C++14 features with C++11 or earlier compilers</a>
  3783. </h3></div></div></div>
  3784. <p>
  3785. The following macros allow use of C++14 features even with compilers that
  3786. do not yet provide compliant C++14 support.
  3787. </p>
  3788. <div class="informaltable"><table class="table">
  3789. <colgroup>
  3790. <col>
  3791. <col>
  3792. </colgroup>
  3793. <thead><tr>
  3794. <th>
  3795. <p>
  3796. Macro
  3797. </p>
  3798. </th>
  3799. <th>
  3800. <p>
  3801. Description
  3802. </p>
  3803. </th>
  3804. </tr></thead>
  3805. <tbody><tr>
  3806. <td>
  3807. <p>
  3808. <code class="computeroutput"><span class="identifier">BOOST_CXX14_CONSTEXPR</span></code>
  3809. </p>
  3810. </td>
  3811. <td>
  3812. <p>
  3813. This macro works similar to <code class="computeroutput"><span class="identifier">BOOST_CONSTEXPR</span></code>,
  3814. but expands to <code class="computeroutput"><span class="keyword">constexpr</span></code>
  3815. only if the C++14 "relaxed" <code class="computeroutput"><span class="keyword">constexpr</span></code>
  3816. is available.
  3817. </p>
  3818. </td>
  3819. </tr></tbody>
  3820. </table></div>
  3821. </div>
  3822. <div class="section">
  3823. <div class="titlepage"><div><div><h3 class="title">
  3824. <a name="boost_config.boost_macro_reference.macros_that_describe_c__17_features_not_supported"></a><a class="link" href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_describe_c__17_features_not_supported" title="Macros that describe C++17 features not supported">Macros
  3825. that describe C++17 features not supported</a>
  3826. </h3></div></div></div>
  3827. <p>
  3828. The following macros describe features in the 2017 ISO C++ standard, formerly
  3829. known as C++1z, that are not yet supported by a particular compiler or library.
  3830. </p>
  3831. <div class="informaltable"><table class="table">
  3832. <colgroup>
  3833. <col>
  3834. <col>
  3835. </colgroup>
  3836. <thead><tr>
  3837. <th>
  3838. <p>
  3839. Macro
  3840. </p>
  3841. </th>
  3842. <th>
  3843. <p>
  3844. Description
  3845. </p>
  3846. </th>
  3847. </tr></thead>
  3848. <tbody>
  3849. <tr>
  3850. <td>
  3851. <p>
  3852. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX17_HDR_OPTIONAL</span></code>
  3853. </p>
  3854. </td>
  3855. <td>
  3856. <p>
  3857. The compiler does not support the header <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">optional</span><span class="special">&gt;</span></code>.
  3858. </p>
  3859. </td>
  3860. </tr>
  3861. <tr>
  3862. <td>
  3863. <p>
  3864. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX17_HDR_VARIANT</span></code>
  3865. </p>
  3866. </td>
  3867. <td>
  3868. <p>
  3869. The compiler does not support the header <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">variant</span><span class="special">&gt;</span></code>.
  3870. </p>
  3871. </td>
  3872. </tr>
  3873. <tr>
  3874. <td>
  3875. <p>
  3876. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX17_HDR_STRING_VIEW</span></code>
  3877. </p>
  3878. </td>
  3879. <td>
  3880. <p>
  3881. The compiler does not support the header <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">string_view</span><span class="special">&gt;</span></code>.
  3882. </p>
  3883. </td>
  3884. </tr>
  3885. <tr>
  3886. <td>
  3887. <p>
  3888. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX17_STD_APPLY</span></code>
  3889. </p>
  3890. </td>
  3891. <td>
  3892. <p>
  3893. The compiler does not support <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">apply</span><span class="special">()</span></code>.
  3894. </p>
  3895. </td>
  3896. </tr>
  3897. <tr>
  3898. <td>
  3899. <p>
  3900. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX17_STD_INVOKE</span></code>
  3901. </p>
  3902. </td>
  3903. <td>
  3904. <p>
  3905. The compiler does not support <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">invoke</span><span class="special">()</span></code>.
  3906. </p>
  3907. </td>
  3908. </tr>
  3909. <tr>
  3910. <td>
  3911. <p>
  3912. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX17_ITERATOR_TRAITS</span></code>
  3913. </p>
  3914. </td>
  3915. <td>
  3916. <p>
  3917. The compiler does not support SFINAE-friendly <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">iterator_traits</span></code>.
  3918. </p>
  3919. </td>
  3920. </tr>
  3921. <tr>
  3922. <td>
  3923. <p>
  3924. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX17_IF_CONSTEXPR</span></code>
  3925. </p>
  3926. </td>
  3927. <td>
  3928. <p>
  3929. The compiler does not support <code class="computeroutput"><span class="keyword">if</span>
  3930. <span class="keyword">constexpr</span></code>.
  3931. </p>
  3932. </td>
  3933. </tr>
  3934. <tr>
  3935. <td>
  3936. <p>
  3937. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX17_INLINE_VARIABLES</span></code>
  3938. </p>
  3939. </td>
  3940. <td>
  3941. <p>
  3942. The compiler does not support <code class="computeroutput"><span class="keyword">inline</span></code>
  3943. variables.
  3944. </p>
  3945. </td>
  3946. </tr>
  3947. </tbody>
  3948. </table></div>
  3949. </div>
  3950. <div class="section">
  3951. <div class="titlepage"><div><div><h3 class="title">
  3952. <a name="boost_config.boost_macro_reference.macros_that_allow_use_of_c__17_features_with_c__14_or_earlier_compilers"></a><a name="config_17_for_14"></a><a class="link" href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_allow_use_of_c__17_features_with_c__14_or_earlier_compilers" title="Macros that allow use of C++17 features with C++14 or earlier compilers">Macros
  3953. that allow use of C++17 features with C++14 or earlier compilers</a>
  3954. </h3></div></div></div>
  3955. <p>
  3956. The following macros allow use of C++17 features even with compilers that
  3957. do not yet provide compliant C++17 support.
  3958. </p>
  3959. <div class="informaltable"><table class="table">
  3960. <colgroup>
  3961. <col>
  3962. <col>
  3963. </colgroup>
  3964. <thead><tr>
  3965. <th>
  3966. <p>
  3967. Macro
  3968. </p>
  3969. </th>
  3970. <th>
  3971. <p>
  3972. Description
  3973. </p>
  3974. </th>
  3975. </tr></thead>
  3976. <tbody><tr>
  3977. <td>
  3978. <p>
  3979. <code class="computeroutput"><span class="identifier">BOOST_INLINE_VARIABLE</span></code>
  3980. </p>
  3981. </td>
  3982. <td>
  3983. <p>
  3984. This macro expands to <code class="computeroutput"><span class="keyword">inline</span></code>
  3985. on compilers that support C++17 inline variables and to nothing
  3986. otherwise. Users may need to check for <code class="computeroutput"><span class="identifier">BOOST_NO_CXX17_INLINE_VARIABLES</span></code>
  3987. for further adjustments to the code.
  3988. </p>
  3989. </td>
  3990. </tr></tbody>
  3991. </table></div>
  3992. </div>
  3993. <div class="section">
  3994. <div class="titlepage"><div><div><h3 class="title">
  3995. <a name="boost_config.boost_macro_reference.macros_that_describe_features_that_have_been_removed_from_the_standard_"></a><a class="link" href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_describe_features_that_have_been_removed_from_the_standard_" title="Macros that describe features that have been removed from the standard.">Macros
  3996. that describe features that have been removed from the standard.</a>
  3997. </h3></div></div></div>
  3998. <p>
  3999. The following macros describe features which were required by one version
  4000. of the standard, but have been removed by later versions.
  4001. </p>
  4002. <div class="informaltable"><table class="table">
  4003. <colgroup>
  4004. <col>
  4005. <col>
  4006. </colgroup>
  4007. <thead><tr>
  4008. <th>
  4009. <p>
  4010. Macro
  4011. </p>
  4012. </th>
  4013. <th>
  4014. <p>
  4015. Description
  4016. </p>
  4017. </th>
  4018. </tr></thead>
  4019. <tbody>
  4020. <tr>
  4021. <td>
  4022. <p>
  4023. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX98_RANDOM_SHUFFLE</span></code>
  4024. </p>
  4025. </td>
  4026. <td>
  4027. <p>
  4028. The standard library no longer supports <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">random_shuffle</span><span class="special">()</span></code>. It was deprecated in C++11 and
  4029. is removed from C++14.
  4030. </p>
  4031. </td>
  4032. </tr>
  4033. <tr>
  4034. <td>
  4035. <p>
  4036. <code class="computeroutput"><span class="identifier">BOOST_NO_AUTO_PTR</span></code>
  4037. </p>
  4038. </td>
  4039. <td>
  4040. <p>
  4041. The standard library no longer supports <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">auto_ptr</span></code>.
  4042. It was deprecated in C++11 and is removed from C++14.
  4043. </p>
  4044. </td>
  4045. </tr>
  4046. <tr>
  4047. <td>
  4048. <p>
  4049. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX98_FUNCTION_BASE</span></code>
  4050. </p>
  4051. </td>
  4052. <td>
  4053. <p>
  4054. The standard library no longer supports <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">unary_function</span></code>
  4055. and <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">binary_function</span></code>. They were deprecated
  4056. in C++11 and is removed from C++14.
  4057. </p>
  4058. </td>
  4059. </tr>
  4060. <tr>
  4061. <td>
  4062. <p>
  4063. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX98_BINDERS</span></code>
  4064. </p>
  4065. </td>
  4066. <td>
  4067. <p>
  4068. The standard library no longer supports <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">bind1st</span></code>,
  4069. <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">bind2nd</span></code>, <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">ptr_fun</span></code>
  4070. and <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">mem_fun</span></code>. They were deprecated
  4071. in C++11 and is removed from C++14.
  4072. </p>
  4073. </td>
  4074. </tr>
  4075. </tbody>
  4076. </table></div>
  4077. </div>
  4078. <div class="section">
  4079. <div class="titlepage"><div><div><h3 class="title">
  4080. <a name="boost_config.boost_macro_reference.boost_helper_macros"></a><a name="config_helpers"></a><a class="link" href="boost_macro_reference.html#boost_config.boost_macro_reference.boost_helper_macros" title="Boost Helper Macros">Boost
  4081. Helper Macros</a>
  4082. </h3></div></div></div>
  4083. <p>
  4084. The following macros are either simple helpers, or macros that provide workarounds
  4085. for compiler/standard library defects.
  4086. </p>
  4087. <div class="informaltable"><table class="table">
  4088. <colgroup>
  4089. <col>
  4090. <col>
  4091. </colgroup>
  4092. <thead><tr>
  4093. <th>
  4094. <p>
  4095. Macro
  4096. </p>
  4097. </th>
  4098. <th>
  4099. <p>
  4100. Description
  4101. </p>
  4102. </th>
  4103. </tr></thead>
  4104. <tbody>
  4105. <tr>
  4106. <td>
  4107. <p>
  4108. <code class="computeroutput"><span class="identifier">BOOST_WORKAROUND</span></code>
  4109. </p>
  4110. </td>
  4111. <td>
  4112. <p>
  4113. This macro is used where a compiler specific workaround is required
  4114. that is not otherwise described by one of the other Boost.Config
  4115. macros. To use the macro you must first
  4116. </p>
  4117. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">config</span><span class="special">/</span><span class="identifier">workaround</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
  4118. </pre>
  4119. <p>
  4120. usage is then:
  4121. </p>
  4122. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="preprocessor">#if</span> <span class="identifier">BOOST_WORKAROUND</span><span class="special">(</span><span class="identifier">MACRONAME</span><span class="special">,</span> <span class="identifier">CONDITION</span><span class="special">)</span>
  4123. <span class="comment">// workaround code goes here...</span>
  4124. <span class="preprocessor">#else</span>
  4125. <span class="comment">// Standard conforming code goes here...</span>
  4126. <span class="preprocessor">#endif</span>
  4127. </pre>
  4128. <p>
  4129. where <code class="computeroutput"><span class="identifier">MACRONAME</span></code>
  4130. is a macro that usually describes the version number to be tested
  4131. against, and <code class="computeroutput"><span class="identifier">CONDITION</span></code>
  4132. is a comparison operator followed by a value. For example <code class="computeroutput"><span class="identifier">BOOST_WORKAROUND</span><span class="special">(</span><span class="identifier">BOOST_INTEL</span><span class="special">,</span>
  4133. <span class="special">&lt;=</span> <span class="number">1010</span><span class="special">)</span></code> would evaluate to <code class="computeroutput"><span class="number">1</span></code> for Intel C++ 10.1 and earlier.
  4134. </p>
  4135. <p>
  4136. The macro can also be used with <code class="computeroutput"><span class="identifier">BOOST_TESTED_AT</span></code>
  4137. if all current compiler versions exhibit the issue, but the issue
  4138. is expected to be fixed at some later point.
  4139. </p>
  4140. <p>
  4141. For example <code class="computeroutput"><span class="identifier">BOOST_WORKAROUND</span><span class="special">(</span><span class="identifier">__BORLANDC__</span><span class="special">,</span> <span class="identifier">BOOST_TESTED_AT</span><span class="special">(</span><span class="number">0x590</span><span class="special">))</span></code> would normally evaluate to <code class="computeroutput"><span class="number">1</span></code> for all values of <code class="computeroutput"><span class="identifier">__BORLANDC__</span></code> <span class="emphasis"><em>unless</em></span>
  4142. the macro <code class="computeroutput"><span class="identifier">BOOST_DETECT_OUTDATED_WORKAROUNDS</span></code>
  4143. is defined, in which case evaluates to <code class="computeroutput"><span class="special">(</span><span class="identifier">__BORLANDC__</span> <span class="special">&lt;=</span>
  4144. <span class="number">0x590</span><span class="special">)</span></code>.
  4145. </p>
  4146. <p>
  4147. <span class="bold"><strong>Note</strong></span>: the ultimate source of documentation
  4148. for this macro is in <a href="../../../../../boost/config/workaround.hpp" target="_top">boost/config/workaround.hpp</a>.
  4149. </p>
  4150. </td>
  4151. </tr>
  4152. <tr>
  4153. <td>
  4154. <p>
  4155. <code class="computeroutput"><span class="identifier">BOOST_PREVENT_MACRO_SUBSTITUTION</span></code>
  4156. </p>
  4157. </td>
  4158. <td>
  4159. <p>
  4160. Sometimes you have a function name with the same name as a C macro,
  4161. for example "min" and "max" member functions,
  4162. in which case one can prevent the function being expanded as a
  4163. macro using:
  4164. </p>
  4165. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="identifier">someclass</span><span class="special">.</span><span class="identifier">min</span> <span class="identifier">BOOST_PREVENT_MACRO_SUBSTITUTION</span><span class="special">(</span><span class="identifier">arg1</span><span class="special">,</span> <span class="identifier">arg2</span><span class="special">);</span>
  4166. </pre>
  4167. <p>
  4168. The following also works in most, but not all, contexts:
  4169. </p>
  4170. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="special">(</span><span class="identifier">someclass</span><span class="special">.</span><span class="identifier">max</span><span class="special">)(</span><span class="identifier">arg1</span><span class="special">,</span> <span class="identifier">arg2</span><span class="special">);</span>
  4171. </pre>
  4172. <p>
  4173. </p>
  4174. </td>
  4175. </tr>
  4176. <tr>
  4177. <td>
  4178. <p>
  4179. <code class="computeroutput"><span class="identifier">BOOST_DEDUCED_TYPENAME</span></code>
  4180. </p>
  4181. </td>
  4182. <td>
  4183. <p>
  4184. Some compilers don't support the use of typename for dependent
  4185. types in deduced contexts. This macro expands to nothing on those
  4186. compilers, and typename elsewhere. For example, replace: <code class="computeroutput"><span class="keyword">template</span> <span class="special">&lt;</span><span class="keyword">class</span> <span class="identifier">T</span><span class="special">&gt;</span> <span class="keyword">void</span>
  4187. <span class="identifier">f</span><span class="special">(</span><span class="identifier">T</span><span class="special">,</span>
  4188. <span class="keyword">typename</span> <span class="identifier">T</span><span class="special">::</span><span class="identifier">type</span><span class="special">);</span></code> with: <code class="computeroutput"><span class="keyword">template</span>
  4189. <span class="special">&lt;</span><span class="keyword">class</span>
  4190. <span class="identifier">T</span><span class="special">&gt;</span>
  4191. <span class="keyword">void</span> <span class="identifier">f</span><span class="special">(</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">BOOST_DEDUCED_TYPENAME</span>
  4192. <span class="identifier">T</span><span class="special">::</span><span class="identifier">type</span><span class="special">);</span></code>
  4193. </p>
  4194. </td>
  4195. </tr>
  4196. <tr>
  4197. <td>
  4198. <p>
  4199. <code class="computeroutput"><span class="identifier">BOOST_HASH_MAP_HEADER</span></code>
  4200. </p>
  4201. </td>
  4202. <td>
  4203. <p>
  4204. The header to include to get the SGI <code class="computeroutput"><span class="identifier">hash_map</span></code>
  4205. class. This macro is only available if <code class="computeroutput"><span class="identifier">BOOST_HAS_HASH</span></code>
  4206. is defined.
  4207. </p>
  4208. </td>
  4209. </tr>
  4210. <tr>
  4211. <td>
  4212. <p>
  4213. <code class="computeroutput"><span class="identifier">BOOST_HASH_SET_HEADER</span></code>
  4214. </p>
  4215. </td>
  4216. <td>
  4217. <p>
  4218. The header to include to get the SGI <code class="computeroutput"><span class="identifier">hash_set</span></code>
  4219. class. This macro is only available if <code class="computeroutput"><span class="identifier">BOOST_HAS_HASH</span></code>
  4220. is defined.
  4221. </p>
  4222. </td>
  4223. </tr>
  4224. <tr>
  4225. <td>
  4226. <p>
  4227. <code class="computeroutput"><span class="identifier">BOOST_SLIST_HEADER</span></code>
  4228. </p>
  4229. </td>
  4230. <td>
  4231. <p>
  4232. The header to include to get the SGI <code class="computeroutput"><span class="identifier">slist</span></code>
  4233. class. This macro is only available if <code class="computeroutput"><span class="identifier">BOOST_HAS_SLIST</span></code>
  4234. is defined.
  4235. </p>
  4236. </td>
  4237. </tr>
  4238. <tr>
  4239. <td>
  4240. <p>
  4241. <code class="computeroutput"><span class="identifier">BOOST_STD_EXTENSION_NAMESPACE</span></code>
  4242. </p>
  4243. </td>
  4244. <td>
  4245. <p>
  4246. The namespace used for std library extensions (hashtable classes
  4247. etc).
  4248. </p>
  4249. </td>
  4250. </tr>
  4251. <tr>
  4252. <td>
  4253. <p>
  4254. <code class="computeroutput"><span class="identifier">BOOST_STATIC_CONSTANT</span><span class="special">(</span><span class="identifier">Type</span><span class="special">,</span> <span class="identifier">assignment</span><span class="special">)</span></code>
  4255. </p>
  4256. </td>
  4257. <td>
  4258. <p>
  4259. On compilers which don't allow in-class initialization of static
  4260. integral constant members, we must use enums as a workaround if
  4261. we want the constants to be available at compile-time. This macro
  4262. gives us a convenient way to declare such constants. For example
  4263. instead of:
  4264. </p>
  4265. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">struct</span> <span class="identifier">foo</span><span class="special">{</span>
  4266. <span class="keyword">static</span> <span class="keyword">const</span> <span class="keyword">int</span> <span class="identifier">value</span> <span class="special">=</span> <span class="number">2</span><span class="special">;</span>
  4267. <span class="special">};</span>
  4268. </pre>
  4269. <p>
  4270. use:
  4271. </p>
  4272. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">struct</span> <span class="identifier">foo</span><span class="special">{</span>
  4273. <span class="identifier">BOOST_STATIC_CONSTANT</span><span class="special">(</span><span class="keyword">int</span><span class="special">,</span> <span class="identifier">value</span> <span class="special">=</span> <span class="number">2</span><span class="special">);</span>
  4274. <span class="special">};</span>
  4275. </pre>
  4276. <p>
  4277. </p>
  4278. </td>
  4279. </tr>
  4280. <tr>
  4281. <td>
  4282. <p>
  4283. <code class="computeroutput"><span class="identifier">BOOST_UNREACHABLE_RETURN</span><span class="special">(</span><span class="identifier">result</span><span class="special">)</span></code>
  4284. </p>
  4285. </td>
  4286. <td>
  4287. <p>
  4288. Normally evaluates to nothing, but evaluates to return x; if the
  4289. compiler requires a return, even when it can never be reached.
  4290. </p>
  4291. </td>
  4292. </tr>
  4293. <tr>
  4294. <td>
  4295. <p>
  4296. <code class="computeroutput"><span class="identifier">BOOST_FALLTHROUGH</span></code>
  4297. </p>
  4298. </td>
  4299. <td>
  4300. <p>
  4301. The BOOST_FALLTHROUGH macro can be used to annotate implicit fall-through
  4302. between switch labels:
  4303. </p>
  4304. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">switch</span> <span class="special">(</span><span class="identifier">x</span><span class="special">)</span> <span class="special">{</span>
  4305. <span class="keyword">case</span> <span class="number">40</span><span class="special">:</span>
  4306. <span class="keyword">case</span> <span class="number">41</span><span class="special">:</span>
  4307. <span class="keyword">if</span> <span class="special">(</span><span class="identifier">truth_is_out_there</span><span class="special">)</span> <span class="special">{</span>
  4308. <span class="special">++</span><span class="identifier">x</span><span class="special">;</span>
  4309. <span class="identifier">BOOST_FALLTHROUGH</span><span class="special">;</span> <span class="comment">// Use instead of/along with annotations in </span>
  4310. <span class="comment">// comments. </span>
  4311. <span class="special">}</span> <span class="keyword">else</span> <span class="special">{</span>
  4312. <span class="keyword">return</span> <span class="identifier">x</span><span class="special">;</span>
  4313. <span class="special">}</span>
  4314. <span class="keyword">case</span> <span class="number">42</span><span class="special">:</span>
  4315. <span class="special">...</span>
  4316. </pre>
  4317. <p>
  4318. As shown in the example above, the BOOST_FALLTHROUGH macro should
  4319. be followed by a semicolon. It is designed to mimic control-flow
  4320. statements like 'break;', so it can be placed in most places where
  4321. 'break;' can, but only if there are no statements on the execution
  4322. path between it and the next switch label.
  4323. </p>
  4324. <p>
  4325. When compiled with Clang &gt;3.2 in C++11 mode, the BOOST_FALLTHROUGH
  4326. macro is expanded to <code class="computeroutput"><span class="special">[[</span><span class="identifier">clang</span><span class="special">::</span><span class="identifier">fallthrough</span><span class="special">]]</span></code>
  4327. attribute, which is analysed when performing switch labels fall-through
  4328. diagnostic ('-Wimplicit-fallthrough'). See clang <a href="http://clang.llvm.org/docs/LanguageExtensions.html#clang__fallthrough" target="_top">documentation
  4329. on language extensions for details.</a>
  4330. </p>
  4331. <p>
  4332. When used with unsupported compilers, the BOOST_FALLTHROUGH macro
  4333. has no effect on diagnostics.
  4334. </p>
  4335. <p>
  4336. In either case this macro has no effect on runtime behavior and
  4337. performance of code.
  4338. </p>
  4339. </td>
  4340. </tr>
  4341. <tr>
  4342. <td>
  4343. <p>
  4344. <code class="computeroutput"><span class="identifier">BOOST_EXPLICIT_TEMPLATE_TYPE</span><span class="special">(</span><span class="identifier">t</span><span class="special">)</span></code>
  4345. </p>
  4346. <p>
  4347. <code class="computeroutput"><span class="identifier">BOOST_EXPLICIT_TEMPLATE_NON_TYPE</span><span class="special">(</span><span class="identifier">t</span><span class="special">,</span><span class="identifier">v</span><span class="special">)</span></code>
  4348. </p>
  4349. <p>
  4350. <code class="computeroutput"><span class="identifier">BOOST_APPEND_EXPLICIT_TEMPLATE_TYPE</span><span class="special">(</span><span class="identifier">t</span><span class="special">)</span></code>
  4351. </p>
  4352. <p>
  4353. <code class="computeroutput"><span class="identifier">BOOST_APPEND_EXPLICIT_TEMPLATE_NON_TYPE</span><span class="special">(</span><span class="identifier">t</span><span class="special">,</span><span class="identifier">v</span><span class="special">)</span></code>
  4354. </p>
  4355. </td>
  4356. <td>
  4357. <p>
  4358. Some compilers silently "fold" different function template
  4359. instantiations if some of the template parameters don't appear
  4360. in the function parameter list. For instance:
  4361. </p>
  4362. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">iostream</span><span class="special">&gt;</span>
  4363. <span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">ostream</span><span class="special">&gt;</span>
  4364. <span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">typeinfo</span><span class="special">&gt;</span>
  4365. <span class="keyword">template</span> <span class="special">&lt;</span><span class="keyword">int</span> <span class="identifier">n</span><span class="special">&gt;</span>
  4366. <span class="keyword">void</span> <span class="identifier">f</span><span class="special">()</span> <span class="special">{</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">cout</span> <span class="special">&lt;&lt;</span> <span class="identifier">n</span> <span class="special">&lt;&lt;</span> <span class="char">' '</span><span class="special">;</span> <span class="special">}</span>
  4367. <span class="keyword">template</span> <span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
  4368. <span class="keyword">void</span> <span class="identifier">g</span><span class="special">()</span> <span class="special">{</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">cout</span> <span class="special">&lt;&lt;</span> <span class="keyword">typeid</span><span class="special">(</span><span class="identifier">T</span><span class="special">).</span><span class="identifier">name</span><span class="special">()</span> <span class="special">&lt;&lt;</span> <span class="char">' '</span><span class="special">;</span> <span class="special">}</span>
  4369. <span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
  4370. <span class="identifier">f</span><span class="special">&lt;</span><span class="number">1</span><span class="special">&gt;();</span>
  4371. <span class="identifier">f</span><span class="special">&lt;</span><span class="number">2</span><span class="special">&gt;();</span>
  4372. <span class="identifier">g</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;();</span>
  4373. <span class="identifier">g</span><span class="special">&lt;</span><span class="keyword">double</span><span class="special">&gt;();</span>
  4374. <span class="special">}</span>
  4375. </pre>
  4376. <p>
  4377. incorrectly outputs <code class="literal">2 2 double double</code> on VC++
  4378. 6. These macros, to be used in the function parameter list, fix
  4379. the problem without effects on the calling syntax. For instance,
  4380. in the case above write:
  4381. </p>
  4382. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">template</span> <span class="special">&lt;</span><span class="keyword">int</span> <span class="identifier">n</span><span class="special">&gt;</span>
  4383. <span class="keyword">void</span> <span class="identifier">f</span><span class="special">(</span><span class="identifier">BOOST_EXPLICIT_TEMPLATE_NON_TYPE</span><span class="special">(</span><span class="keyword">int</span><span class="special">,</span> <span class="identifier">n</span><span class="special">))</span> <span class="special">{</span> <span class="special">...</span> <span class="special">}</span>
  4384. <span class="keyword">template</span> <span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
  4385. <span class="keyword">void</span> <span class="identifier">g</span><span class="special">(</span><span class="identifier">BOOST_EXPLICIT_TEMPLATE_TYPE</span><span class="special">(</span><span class="identifier">T</span><span class="special">))</span> <span class="special">{</span> <span class="special">...</span> <span class="special">}</span>
  4386. </pre>
  4387. <p>
  4388. Beware that they can declare (for affected compilers) a dummy defaulted
  4389. parameter, so they
  4390. </p>
  4391. <p>
  4392. <span class="bold"><strong>a)</strong></span> should be always invoked <span class="bold"><strong>at the end</strong></span> of the parameter list
  4393. </p>
  4394. <p>
  4395. <span class="bold"><strong>b)</strong></span> can't be used if your function
  4396. template is multiply declared.
  4397. </p>
  4398. <p>
  4399. Furthermore, in order to add any needed comma separator, an <code class="computeroutput"><span class="identifier">APPEND_</span><span class="special">*</span></code>
  4400. version must be used when the macro invocation appears after a
  4401. normal parameter declaration or after the invocation of another
  4402. macro of this same group.
  4403. </p>
  4404. </td>
  4405. </tr>
  4406. <tr>
  4407. <td>
  4408. <p>
  4409. <code class="computeroutput"><span class="identifier">BOOST_USE_FACET</span><span class="special">(</span><span class="identifier">Type</span><span class="special">,</span> <span class="identifier">loc</span><span class="special">)</span></code>
  4410. </p>
  4411. </td>
  4412. <td>
  4413. <p>
  4414. When the standard library does not have a conforming <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">use_facet</span></code> there are various workarounds
  4415. available, but they differ from library to library. This macro
  4416. provides a consistent way to access a locale's facets. For example,
  4417. replace: <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">use_facet</span><span class="special">&lt;</span><span class="identifier">Type</span><span class="special">&gt;(</span><span class="identifier">loc</span><span class="special">);</span></code>
  4418. with: <code class="computeroutput"><span class="identifier">BOOST_USE_FACET</span><span class="special">(</span><span class="identifier">Type</span><span class="special">,</span> <span class="identifier">loc</span><span class="special">);</span></code> Note do not add a <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span></code>
  4419. prefix to the front of <code class="computeroutput"><span class="identifier">BOOST_USE_FACET</span></code>.
  4420. </p>
  4421. </td>
  4422. </tr>
  4423. <tr>
  4424. <td>
  4425. <p>
  4426. <code class="computeroutput"><span class="identifier">BOOST_HAS_FACET</span><span class="special">(</span><span class="identifier">Type</span><span class="special">,</span> <span class="identifier">loc</span><span class="special">)</span></code>
  4427. </p>
  4428. </td>
  4429. <td>
  4430. <p>
  4431. When the standard library does not have a comforming <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">has_facet</span></code> there are various workarounds
  4432. available, but they differ from library to library. This macro
  4433. provides a consistent way to check a locale's facets. For example,
  4434. replace: <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">has_facet</span><span class="special">&lt;</span><span class="identifier">Type</span><span class="special">&gt;(</span><span class="identifier">loc</span><span class="special">);</span></code>
  4435. with: <code class="computeroutput"><span class="identifier">BOOST_HAS_FACET</span><span class="special">(</span><span class="identifier">Type</span><span class="special">,</span> <span class="identifier">loc</span><span class="special">);</span></code> Note do not add a <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span></code>
  4436. prefix to the front of <code class="computeroutput"><span class="identifier">BOOST_HAS_FACET</span></code>.
  4437. </p>
  4438. </td>
  4439. </tr>
  4440. <tr>
  4441. <td>
  4442. <p>
  4443. <code class="computeroutput"><span class="identifier">BOOST_NESTED_TEMPLATE</span></code>
  4444. </p>
  4445. </td>
  4446. <td>
  4447. <p>
  4448. Member templates are supported by some compilers even though they
  4449. can't use the <code class="computeroutput"><span class="identifier">A</span><span class="special">::</span><span class="keyword">template</span>
  4450. <span class="identifier">member</span><span class="special">&lt;</span><span class="identifier">U</span><span class="special">&gt;</span></code>
  4451. syntax, as a workaround replace: <code class="computeroutput"><span class="keyword">typedef</span>
  4452. <span class="keyword">typename</span> <span class="identifier">A</span><span class="special">::</span><span class="keyword">template</span>
  4453. <span class="identifier">rebind</span><span class="special">&lt;</span><span class="identifier">U</span><span class="special">&gt;</span>
  4454. <span class="identifier">binder</span><span class="special">;</span></code>
  4455. with: <code class="computeroutput"><span class="keyword">typedef</span> <span class="keyword">typename</span>
  4456. <span class="identifier">A</span><span class="special">::</span><span class="identifier">BOOST_NESTED_TEMPLATE</span> <span class="identifier">rebind</span><span class="special">&lt;</span><span class="identifier">U</span><span class="special">&gt;</span> <span class="identifier">binder</span><span class="special">;</span></code>
  4457. </p>
  4458. </td>
  4459. </tr>
  4460. <tr>
  4461. <td>
  4462. <p>
  4463. <code class="computeroutput"><span class="identifier">BOOST_STRINGIZE</span><span class="special">(</span><span class="identifier">X</span><span class="special">)</span></code>
  4464. </p>
  4465. </td>
  4466. <td>
  4467. <p>
  4468. Converts the parameter <code class="computeroutput"><span class="identifier">X</span></code>
  4469. to a string after macro replacement on <code class="computeroutput"><span class="identifier">X</span></code>
  4470. has been performed.
  4471. </p>
  4472. </td>
  4473. </tr>
  4474. <tr>
  4475. <td>
  4476. <p>
  4477. <code class="computeroutput"><span class="identifier">BOOST_JOIN</span><span class="special">(</span><span class="identifier">X</span><span class="special">,</span><span class="identifier">Y</span><span class="special">)</span></code>
  4478. </p>
  4479. </td>
  4480. <td>
  4481. <p>
  4482. This piece of macro magic joins the two arguments together, even
  4483. when one of the arguments is itself a macro (see 16.3.1 in C++
  4484. standard). This is normally used to create a mangled name in combination
  4485. with a predefined macro such a __LINE__.
  4486. </p>
  4487. </td>
  4488. </tr>
  4489. <tr>
  4490. <td>
  4491. <p>
  4492. <code class="computeroutput"><span class="identifier">BOOST_RESTRICT</span></code>
  4493. </p>
  4494. </td>
  4495. <td>
  4496. <p>
  4497. This macro can be used in place of the compiler specific variant
  4498. of the C99 <code class="computeroutput"><span class="identifier">restrict</span></code>
  4499. keyword to notify the compiler that, for the lifetime of the qualified
  4500. pointer variable, only it and its derivative value will be used
  4501. to gain access to the object it references. This limits the effect
  4502. of pointer aliasing and helps the optimizers in generating better
  4503. code. However, i this condition is violated, undefined behavior
  4504. may occurs.
  4505. </p>
  4506. <p>
  4507. Usage example:
  4508. </p>
  4509. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">void</span> <span class="identifier">perform_computation</span><span class="special">(</span> <span class="keyword">float</span><span class="special">*</span> <span class="identifier">BOOST_RESTRICT</span> <span class="identifier">in</span><span class="special">,</span> <span class="keyword">float</span><span class="special">*</span> <span class="identifier">BOOST_RESTRICT</span> <span class="identifier">out</span> <span class="special">)</span>
  4510. <span class="special">{</span>
  4511. <span class="special">*</span><span class="identifier">out</span> <span class="special">=</span> <span class="special">*</span><span class="identifier">in</span> <span class="special">*</span> <span class="number">0.5f</span><span class="special">;</span>
  4512. <span class="special">}</span>
  4513. </pre>
  4514. <p>
  4515. </p>
  4516. </td>
  4517. </tr>
  4518. <tr>
  4519. <td>
  4520. <p>
  4521. <code class="computeroutput"><span class="identifier">BOOST_FORCEINLINE</span></code>
  4522. </p>
  4523. </td>
  4524. <td>
  4525. <p>
  4526. This macro can be used in place of the <code class="computeroutput"><span class="keyword">inline</span></code>
  4527. keyword to instruct the compiler that the function should always
  4528. be inlined. Overuse of this macro can lead to significant bloat,
  4529. while good use can increase performance in certain cases, such
  4530. as computation-intensive code built through generative programming
  4531. techniques.
  4532. </p>
  4533. <p>
  4534. Usage example:
  4535. </p>
  4536. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">class</span> <span class="identifier">T</span><span class="special">&gt;</span>
  4537. <span class="identifier">BOOST_FORCEINLINE</span> <span class="identifier">T</span><span class="special">&amp;</span> <span class="identifier">f</span><span class="special">(</span><span class="identifier">T</span><span class="special">&amp;</span> <span class="identifier">t</span><span class="special">)</span>
  4538. <span class="special">{</span>
  4539. <span class="keyword">return</span> <span class="identifier">t</span><span class="special">;</span>
  4540. <span class="special">}</span>
  4541. </pre>
  4542. <p>
  4543. </p>
  4544. <p>
  4545. Note that use of this macro can lead to cryptic error messages
  4546. with some compilers. Consider defining it to <code class="computeroutput"><span class="keyword">inline</span></code>
  4547. before including the Boost.Config header in order to be able to
  4548. debug errors more easily.
  4549. </p>
  4550. </td>
  4551. </tr>
  4552. <tr>
  4553. <td>
  4554. <p>
  4555. <code class="computeroutput"><span class="identifier">BOOST_NOINLINE</span></code>
  4556. </p>
  4557. </td>
  4558. <td>
  4559. <p>
  4560. This macro can be used in place of the <code class="computeroutput"><span class="keyword">inline</span></code>
  4561. keyword to instruct the compiler that the function should never
  4562. be inlined. One should typically use this macro to mark functions
  4563. that are unlikely to be called, such as error handling routines.
  4564. </p>
  4565. <p>
  4566. Usage example:
  4567. </p>
  4568. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="identifier">BOOST_NOINLINE</span> <span class="keyword">void</span> <span class="identifier">handle_error</span><span class="special">(</span><span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">descr</span><span class="special">)</span>
  4569. <span class="special">{</span>
  4570. <span class="comment">// ...</span>
  4571. <span class="special">}</span>
  4572. </pre>
  4573. <p>
  4574. </p>
  4575. </td>
  4576. </tr>
  4577. <tr>
  4578. <td>
  4579. <p>
  4580. <code class="computeroutput"><span class="identifier">BOOST_NORETURN</span></code>
  4581. </p>
  4582. </td>
  4583. <td>
  4584. <p>
  4585. This macro can be used before the function declaration or definition
  4586. to instruct the compiler that the function does not return normally
  4587. (i.e. with a <code class="computeroutput"><span class="keyword">return</span></code>
  4588. statement or by leaving the function scope, if the function return
  4589. type is <code class="computeroutput"><span class="keyword">void</span></code>). The
  4590. macro can be used to mark functions that always throw exceptions
  4591. or terminate the application. Compilers that support this markup
  4592. may use this information to specifically organize the code surrounding
  4593. calls to this function and suppress warnings about missing <code class="computeroutput"><span class="keyword">return</span></code> statements in the functions
  4594. enclosing such calls.
  4595. </p>
  4596. <p>
  4597. Usage example:
  4598. </p>
  4599. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="identifier">BOOST_NORETURN</span> <span class="keyword">void</span> <span class="identifier">on_error_occurred</span><span class="special">(</span><span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span> <span class="identifier">descr</span><span class="special">)</span>
  4600. <span class="special">{</span>
  4601. <span class="keyword">throw</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">runtime_error</span><span class="special">(</span><span class="identifier">descr</span><span class="special">);</span>
  4602. <span class="special">}</span>
  4603. </pre>
  4604. <p>
  4605. </p>
  4606. <p>
  4607. If the compiler does not support this markup, <code class="computeroutput"><span class="identifier">BOOST_NORETURN</span></code>
  4608. is defined empty and an additional macro <code class="computeroutput"><span class="identifier">BOOST_NO_NORETURN</span></code>
  4609. is defined.
  4610. </p>
  4611. </td>
  4612. </tr>
  4613. <tr>
  4614. <td>
  4615. <p>
  4616. <code class="computeroutput"><span class="identifier">BOOST_LIKELY</span><span class="special">(</span><span class="identifier">X</span><span class="special">)</span></code>
  4617. </p>
  4618. <p>
  4619. <code class="computeroutput"><span class="identifier">BOOST_UNLIKELY</span><span class="special">(</span><span class="identifier">X</span><span class="special">)</span></code>
  4620. </p>
  4621. </td>
  4622. <td>
  4623. <p>
  4624. These macros communicate to the compiler that the conditional expression
  4625. <code class="computeroutput"><span class="identifier">X</span></code> is likely or
  4626. unlikely to yield a positive result. The expression should result
  4627. in a boolean value. The result of the macro is an integer or boolean
  4628. value equivalent to the result of <code class="computeroutput"><span class="identifier">X</span></code>.
  4629. </p>
  4630. <p>
  4631. The macros are intended to be used in branching statements. The
  4632. additional hint they provide can be used by the compiler to arrange
  4633. the compiled code of the branches more effectively.
  4634. </p>
  4635. <p>
  4636. Usage example:
  4637. </p>
  4638. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">if</span> <span class="special">(</span><span class="identifier">BOOST_UNLIKELY</span><span class="special">(</span><span class="identifier">ptr</span> <span class="special">==</span> <span class="identifier">NULL</span><span class="special">))</span>
  4639. <span class="identifier">handle_error</span><span class="special">(</span><span class="string">"ptr is NULL"</span><span class="special">);</span>
  4640. </pre>
  4641. <p>
  4642. </p>
  4643. </td>
  4644. </tr>
  4645. <tr>
  4646. <td>
  4647. <p>
  4648. <code class="computeroutput"><span class="identifier">BOOST_ATTRIBUTE_UNUSED</span></code>
  4649. </p>
  4650. </td>
  4651. <td>
  4652. <p>
  4653. Expands to <code class="computeroutput"><span class="identifier">__attribute__</span><span class="special">((</span><span class="identifier">unused</span><span class="special">))</span></code> when this is available - can
  4654. be used to disable compiler warnings relating to unused types or
  4655. variables.
  4656. </p>
  4657. </td>
  4658. </tr>
  4659. <tr>
  4660. <td>
  4661. <p>
  4662. <code class="computeroutput"><span class="identifier">BOOST_ATTRIBUTE_NODISCARD</span></code>
  4663. </p>
  4664. </td>
  4665. <td>
  4666. <p>
  4667. Expands to <code class="computeroutput"><span class="special">[[</span><span class="identifier">nodiscard</span><span class="special">]]</span></code> when this is available - can
  4668. be used to create a warning when a type or variable is unused.
  4669. </p>
  4670. </td>
  4671. </tr>
  4672. <tr>
  4673. <td>
  4674. <p>
  4675. <code class="computeroutput"><span class="identifier">BOOST_ATTRIBUTE_NO_UNIQUE_ADDRESS</span></code>
  4676. </p>
  4677. </td>
  4678. <td>
  4679. <p>
  4680. Expands to <code class="computeroutput"><span class="special">[[</span><span class="identifier">no_unique_address</span><span class="special">]]</span></code> when this is available - can
  4681. be used to indicate that a non-static data member need not have
  4682. a unique address (for example empty classes).
  4683. </p>
  4684. </td>
  4685. </tr>
  4686. <tr>
  4687. <td>
  4688. <p>
  4689. <code class="computeroutput"><span class="identifier">BOOST_MAY_ALIAS</span></code>,
  4690. <code class="computeroutput"><span class="identifier">BOOST_NO_MAY_ALIAS</span></code>
  4691. </p>
  4692. </td>
  4693. <td>
  4694. <p>
  4695. <code class="computeroutput"><span class="identifier">BOOST_MAY_ALIAS</span></code>
  4696. expands to a type attribute that can be used to mark types that
  4697. may alias other types. Pointers or references to such marked types
  4698. can be used to access objects of other types. If the compiler supports
  4699. this feature <code class="computeroutput"><span class="identifier">BOOST_NO_MAY_ALIAS</span></code>
  4700. is not defined. Otherwise <code class="computeroutput"><span class="identifier">BOOST_MAY_ALIAS</span></code>
  4701. expands to nothing and <code class="computeroutput"><span class="identifier">BOOST_NO_MAY_ALIAS</span></code>
  4702. is defined.
  4703. </p>
  4704. <p>
  4705. Usage example:
  4706. </p>
  4707. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">struct</span> <span class="identifier">BOOST_MAY_ALIAS</span> <span class="identifier">aliasing_struct</span><span class="special">;</span>
  4708. <span class="keyword">typedef</span> <span class="keyword">unsigned</span> <span class="keyword">int</span> <span class="identifier">BOOST_MAY_ALIAS</span> <span class="identifier">aliasing_uint</span><span class="special">;</span>
  4709. </pre>
  4710. <p>
  4711. </p>
  4712. </td>
  4713. </tr>
  4714. <tr>
  4715. <td>
  4716. <p>
  4717. <code class="computeroutput"><span class="identifier">BOOST_PRAGMA_MESSAGE</span><span class="special">(</span><span class="identifier">M</span><span class="special">)</span></code>
  4718. </p>
  4719. </td>
  4720. <td>
  4721. <p>
  4722. Defined in header <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">config</span><span class="special">/</span><span class="identifier">pragma_message</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>,
  4723. this macro expands to the equivalent of <code class="computeroutput"><span class="preprocessor">#pragma</span>
  4724. <span class="identifier">message</span><span class="special">(</span><span class="identifier">M</span><span class="special">)</span></code>.
  4725. <code class="computeroutput"><span class="identifier">M</span></code> must be a string
  4726. literal.
  4727. </p>
  4728. <p>
  4729. Example: <code class="computeroutput"><span class="identifier">BOOST_PRAGMA_MESSAGE</span><span class="special">(</span><span class="string">"This header
  4730. is deprecated."</span><span class="special">)</span></code>
  4731. </p>
  4732. <p>
  4733. The messages issued by <code class="computeroutput"><span class="identifier">BOOST_PRAGMA_MESSAGE</span></code>
  4734. can be suppressed by defining the macro <code class="computeroutput"><span class="identifier">BOOST_DISABLE_PRAGMA_MESSAGE</span></code>.
  4735. </p>
  4736. </td>
  4737. </tr>
  4738. <tr>
  4739. <td>
  4740. <p>
  4741. <code class="computeroutput"><span class="identifier">BOOST_HEADER_DEPRECATED</span><span class="special">(</span><span class="identifier">A</span><span class="special">)</span></code>
  4742. </p>
  4743. </td>
  4744. <td>
  4745. <p>
  4746. Defined in header <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">config</span><span class="special">/</span><span class="identifier">header_deprecated</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>,
  4747. this macro issues the message "This header is deprecated.
  4748. Use <code class="computeroutput"><span class="identifier">A</span></code> instead."
  4749. via <code class="computeroutput"><span class="identifier">BOOST_PRAGMA_MESSAGE</span></code>.
  4750. <code class="computeroutput"><span class="identifier">A</span></code> must be a string
  4751. literal.
  4752. </p>
  4753. <p>
  4754. Example: <code class="computeroutput"><span class="identifier">BOOST_HEADER_DEPRECATED</span><span class="special">(</span><span class="string">"&lt;boost/config/workaround.hpp&gt;"</span><span class="special">)</span></code>
  4755. </p>
  4756. <p>
  4757. The messages issued by <code class="computeroutput"><span class="identifier">BOOST_HEADER_DEPRECATED</span></code>
  4758. can be suppressed by defining the macro <code class="computeroutput"><span class="identifier">BOOST_ALLOW_DEPRECATED_HEADERS</span></code>.
  4759. </p>
  4760. </td>
  4761. </tr>
  4762. </tbody>
  4763. </table></div>
  4764. </div>
  4765. <div class="section">
  4766. <div class="titlepage"><div><div><h3 class="title">
  4767. <a name="boost_config.boost_macro_reference.boost_informational_macros"></a><a name="config_info_macros"></a><a class="link" href="boost_macro_reference.html#boost_config.boost_macro_reference.boost_informational_macros" title="Boost Informational Macros">Boost
  4768. Informational Macros</a>
  4769. </h3></div></div></div>
  4770. <p>
  4771. The following macros describe boost features; these are, generally speaking
  4772. the only boost macros that should be tested in user code.
  4773. </p>
  4774. <div class="informaltable"><table class="table">
  4775. <colgroup>
  4776. <col>
  4777. <col>
  4778. <col>
  4779. </colgroup>
  4780. <thead><tr>
  4781. <th>
  4782. <p>
  4783. Macro
  4784. </p>
  4785. </th>
  4786. <th>
  4787. <p>
  4788. Header
  4789. </p>
  4790. </th>
  4791. <th>
  4792. <p>
  4793. Description
  4794. </p>
  4795. </th>
  4796. </tr></thead>
  4797. <tbody>
  4798. <tr>
  4799. <td>
  4800. <p>
  4801. <code class="computeroutput"><span class="identifier">BOOST_VERSION</span></code>
  4802. </p>
  4803. </td>
  4804. <td>
  4805. <p>
  4806. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">version</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>
  4807. </p>
  4808. </td>
  4809. <td>
  4810. <p>
  4811. Describes the boost version number in XYYYZZ format such that:
  4812. <code class="computeroutput"><span class="special">(</span><span class="identifier">BOOST_VERSION</span>
  4813. <span class="special">%</span> <span class="number">100</span><span class="special">)</span></code> is the sub-minor version, <code class="computeroutput"><span class="special">((</span><span class="identifier">BOOST_VERSION</span>
  4814. <span class="special">/</span> <span class="number">100</span><span class="special">)</span> <span class="special">%</span> <span class="number">1000</span><span class="special">)</span></code>
  4815. is the minor version, and <code class="computeroutput"><span class="special">(</span><span class="identifier">BOOST_VERSION</span> <span class="special">/</span>
  4816. <span class="number">100000</span><span class="special">)</span></code>
  4817. is the major version.
  4818. </p>
  4819. </td>
  4820. </tr>
  4821. <tr>
  4822. <td>
  4823. <p>
  4824. <code class="computeroutput"><span class="identifier">BOOST_NO_INT64_T</span></code>
  4825. </p>
  4826. </td>
  4827. <td>
  4828. <p>
  4829. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">cstdint</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code> <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">stdint</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span></code>
  4830. </p>
  4831. </td>
  4832. <td>
  4833. <p>
  4834. Defined if there are no 64-bit integral types: <code class="computeroutput"><span class="identifier">int64_t</span></code>,
  4835. <code class="computeroutput"><span class="identifier">uint64_t</span></code> etc.
  4836. </p>
  4837. </td>
  4838. </tr>
  4839. <tr>
  4840. <td>
  4841. <p>
  4842. <code class="computeroutput"><span class="identifier">BOOST_NO_INTEGRAL_INT64_T</span></code>
  4843. </p>
  4844. </td>
  4845. <td>
  4846. <p>
  4847. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">cstdint</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code> <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">stdint</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span></code>
  4848. </p>
  4849. </td>
  4850. <td>
  4851. <p>
  4852. Defined if <code class="computeroutput"><span class="identifier">int64_t</span></code>
  4853. as defined by <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">cstdint</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>
  4854. is not usable in integral constant expressions.
  4855. </p>
  4856. </td>
  4857. </tr>
  4858. <tr>
  4859. <td>
  4860. <p>
  4861. <code class="computeroutput"><span class="identifier">BOOST_MSVC</span></code>
  4862. </p>
  4863. </td>
  4864. <td>
  4865. <p>
  4866. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">config</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>
  4867. </p>
  4868. </td>
  4869. <td>
  4870. <p>
  4871. Defined if the compiler is really Microsoft Visual C++, as opposed
  4872. to one of the many other compilers that also define <code class="computeroutput"><span class="identifier">_MSC_VER</span></code>. Has the same value
  4873. as _MSC_VER.
  4874. </p>
  4875. </td>
  4876. </tr>
  4877. <tr>
  4878. <td>
  4879. <p>
  4880. <code class="computeroutput"><span class="identifier">BOOST_MSVC_FULL_VER</span></code>
  4881. </p>
  4882. </td>
  4883. <td>
  4884. <p>
  4885. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">config</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>
  4886. </p>
  4887. </td>
  4888. <td>
  4889. <p>
  4890. Defined to a normalised 9 digit version of _MSC_FULL_VER (which
  4891. sometimes only has 8 digits), the macro has the form VVMMPPPPP
  4892. where VV is the major version number, MM is the minor version number,
  4893. and PPPPP is the compiler build number.
  4894. </p>
  4895. </td>
  4896. </tr>
  4897. <tr>
  4898. <td>
  4899. <p>
  4900. <code class="computeroutput"><span class="identifier">BOOST_GCC</span></code>
  4901. </p>
  4902. </td>
  4903. <td>
  4904. <p>
  4905. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">config</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>
  4906. </p>
  4907. </td>
  4908. <td>
  4909. <p>
  4910. Defined if the compiler is really GCC, as opposed to one of the
  4911. many other compilers that also define <code class="computeroutput"><span class="identifier">__GNUC__</span></code>.
  4912. Has the value: <code class="computeroutput"><span class="identifier">__GNUC__</span>
  4913. <span class="special">*</span> <span class="number">10000</span>
  4914. <span class="special">+</span> <span class="identifier">__GNUC_MINOR__</span>
  4915. <span class="special">*</span> <span class="number">100</span>
  4916. <span class="special">+</span> <span class="identifier">__GNUC_PATCHLEVEL__</span></code>.
  4917. </p>
  4918. </td>
  4919. </tr>
  4920. <tr>
  4921. <td>
  4922. <p>
  4923. <code class="computeroutput"><span class="identifier">BOOST_INTEL</span></code>
  4924. </p>
  4925. </td>
  4926. <td>
  4927. <p>
  4928. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">config</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>
  4929. </p>
  4930. </td>
  4931. <td>
  4932. <p>
  4933. Defined if the compiler is an Intel compiler, takes the same value
  4934. as the compiler version macro.
  4935. </p>
  4936. </td>
  4937. </tr>
  4938. <tr>
  4939. <td>
  4940. <p>
  4941. <code class="computeroutput"><span class="identifier">BOOST_CLANG</span></code>
  4942. </p>
  4943. </td>
  4944. <td>
  4945. <p>
  4946. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">config</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>
  4947. </p>
  4948. </td>
  4949. <td>
  4950. <p>
  4951. Defined to 1 if the compiler is the Clang compiler.
  4952. </p>
  4953. </td>
  4954. </tr>
  4955. <tr>
  4956. <td>
  4957. <p>
  4958. <code class="computeroutput"><span class="identifier">BOOST_WINDOWS</span></code>
  4959. </p>
  4960. </td>
  4961. <td>
  4962. <p>
  4963. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">config</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>
  4964. </p>
  4965. </td>
  4966. <td>
  4967. <p>
  4968. Defined if the Windows platform API is available.
  4969. </p>
  4970. </td>
  4971. </tr>
  4972. <tr>
  4973. <td>
  4974. <p>
  4975. <code class="computeroutput"><span class="identifier">BOOST_DINKUMWARE_STDLIB</span></code>
  4976. </p>
  4977. </td>
  4978. <td>
  4979. <p>
  4980. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">config</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>
  4981. </p>
  4982. </td>
  4983. <td>
  4984. <p>
  4985. Defined if the dinkumware standard library is in use, takes the
  4986. same value as the Dinkumware library version macro <code class="computeroutput"><span class="identifier">_CPPLIB_VER</span></code> if defined, otherwise
  4987. 1.
  4988. </p>
  4989. </td>
  4990. </tr>
  4991. <tr>
  4992. <td>
  4993. <p>
  4994. <code class="computeroutput"><span class="identifier">BOOST_NO_WREGEX</span></code>
  4995. </p>
  4996. </td>
  4997. <td>
  4998. <p>
  4999. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">regex</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>
  5000. </p>
  5001. </td>
  5002. <td>
  5003. <p>
  5004. Defined if the regex library does not support wide character regular
  5005. expressions.
  5006. </p>
  5007. </td>
  5008. </tr>
  5009. <tr>
  5010. <td>
  5011. <p>
  5012. <code class="computeroutput"><span class="identifier">BOOST_COMPILER</span></code>
  5013. </p>
  5014. </td>
  5015. <td>
  5016. <p>
  5017. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">config</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>
  5018. </p>
  5019. </td>
  5020. <td>
  5021. <p>
  5022. Defined as a string describing the name and version number of the
  5023. compiler in use. Mainly for debugging the configuration.
  5024. </p>
  5025. </td>
  5026. </tr>
  5027. <tr>
  5028. <td>
  5029. <p>
  5030. <code class="computeroutput"><span class="identifier">BOOST_STDLIB</span></code>
  5031. </p>
  5032. </td>
  5033. <td>
  5034. <p>
  5035. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">config</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>
  5036. </p>
  5037. </td>
  5038. <td>
  5039. <p>
  5040. Defined as a string describing the name and version number of the
  5041. standard library in use. Mainly for debugging the configuration.
  5042. </p>
  5043. </td>
  5044. </tr>
  5045. <tr>
  5046. <td>
  5047. <p>
  5048. <code class="computeroutput"><span class="identifier">BOOST_PLATFORM</span></code>
  5049. </p>
  5050. </td>
  5051. <td>
  5052. <p>
  5053. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">config</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>
  5054. </p>
  5055. </td>
  5056. <td>
  5057. <p>
  5058. Defined as a string describing the name of the platform. Mainly
  5059. for debugging the configuration.
  5060. </p>
  5061. </td>
  5062. </tr>
  5063. </tbody>
  5064. </table></div>
  5065. </div>
  5066. <div class="section">
  5067. <div class="titlepage"><div><div><h3 class="title">
  5068. <a name="boost_config.boost_macro_reference.boost_deprecated_macros"></a><a name="deprecated_macros"></a><a class="link" href="boost_macro_reference.html#boost_config.boost_macro_reference.boost_deprecated_macros" title="Boost Deprecated Macros">Boost
  5069. Deprecated Macros</a>
  5070. </h3></div></div></div>
  5071. <p>
  5072. The following have been deprecated; please use the replacements instead.
  5073. They will be removed in a future version of boost.
  5074. </p>
  5075. <div class="informaltable"><table class="table">
  5076. <colgroup>
  5077. <col>
  5078. <col>
  5079. <col>
  5080. <col>
  5081. </colgroup>
  5082. <thead><tr>
  5083. <th>
  5084. <p>
  5085. Deprecated Macro
  5086. </p>
  5087. </th>
  5088. <th>
  5089. <p>
  5090. Replacement
  5091. </p>
  5092. </th>
  5093. <th>
  5094. <p>
  5095. When deprecated
  5096. </p>
  5097. </th>
  5098. <th>
  5099. <p>
  5100. When removed
  5101. </p>
  5102. </th>
  5103. </tr></thead>
  5104. <tbody>
  5105. <tr>
  5106. <td>
  5107. <p>
  5108. <code class="computeroutput"><span class="identifier">BOOST_NO_0X_HDR_ARRAY</span></code>
  5109. </p>
  5110. </td>
  5111. <td>
  5112. <p>
  5113. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_ARRAY</span></code>
  5114. </p>
  5115. </td>
  5116. <td>
  5117. <p>
  5118. Boost 1.50
  5119. </p>
  5120. </td>
  5121. <td>
  5122. </td>
  5123. </tr>
  5124. <tr>
  5125. <td>
  5126. <p>
  5127. <code class="computeroutput"><span class="identifier">BOOST_NO_0X_HDR_CHRONO</span></code>
  5128. </p>
  5129. </td>
  5130. <td>
  5131. <p>
  5132. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_CHRONO</span></code>
  5133. </p>
  5134. </td>
  5135. <td>
  5136. <p>
  5137. Boost 1.50
  5138. </p>
  5139. </td>
  5140. <td>
  5141. </td>
  5142. </tr>
  5143. <tr>
  5144. <td>
  5145. <p>
  5146. <code class="computeroutput"><span class="identifier">BOOST_NO_0X_HDR_CODECVT</span></code>
  5147. </p>
  5148. </td>
  5149. <td>
  5150. <p>
  5151. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_CODECVT</span></code>
  5152. </p>
  5153. </td>
  5154. <td>
  5155. <p>
  5156. Boost 1.50
  5157. </p>
  5158. </td>
  5159. <td>
  5160. </td>
  5161. </tr>
  5162. <tr>
  5163. <td>
  5164. <p>
  5165. <code class="computeroutput"><span class="identifier">BOOST_NO_0X_HDR_CONDITION_VARIABLE</span></code>
  5166. </p>
  5167. </td>
  5168. <td>
  5169. <p>
  5170. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_CONDITION_VARIABLE</span></code>
  5171. </p>
  5172. </td>
  5173. <td>
  5174. <p>
  5175. Boost 1.50
  5176. </p>
  5177. </td>
  5178. <td>
  5179. </td>
  5180. </tr>
  5181. <tr>
  5182. <td>
  5183. <p>
  5184. <code class="computeroutput"><span class="identifier">BOOST_NO_0X_HDR_FORWARD_LIST</span></code>
  5185. </p>
  5186. </td>
  5187. <td>
  5188. <p>
  5189. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_FORWARD_LIST</span></code>
  5190. </p>
  5191. </td>
  5192. <td>
  5193. <p>
  5194. Boost 1.50
  5195. </p>
  5196. </td>
  5197. <td>
  5198. </td>
  5199. </tr>
  5200. <tr>
  5201. <td>
  5202. <p>
  5203. <code class="computeroutput"><span class="identifier">BOOST_NO_0X_HDR_FUTURE</span></code>
  5204. </p>
  5205. </td>
  5206. <td>
  5207. <p>
  5208. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_FUTURE</span></code>
  5209. </p>
  5210. </td>
  5211. <td>
  5212. <p>
  5213. Boost 1.50
  5214. </p>
  5215. </td>
  5216. <td>
  5217. </td>
  5218. </tr>
  5219. <tr>
  5220. <td>
  5221. <p>
  5222. <code class="computeroutput"><span class="identifier">BOOST_NO_0X_HDR_INITIALIZER_LIST</span></code>
  5223. </p>
  5224. </td>
  5225. <td>
  5226. <p>
  5227. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_INITIALIZER_LIST</span></code>
  5228. </p>
  5229. </td>
  5230. <td>
  5231. <p>
  5232. Boost 1.50
  5233. </p>
  5234. </td>
  5235. <td>
  5236. </td>
  5237. </tr>
  5238. <tr>
  5239. <td>
  5240. <p>
  5241. <code class="computeroutput"><span class="identifier">BOOST_NO_INITIALIZER_LISTS</span></code>
  5242. </p>
  5243. </td>
  5244. <td>
  5245. <p>
  5246. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_INITIALIZER_LIST</span></code>
  5247. </p>
  5248. </td>
  5249. <td>
  5250. <p>
  5251. Boost 1.50
  5252. </p>
  5253. </td>
  5254. <td>
  5255. </td>
  5256. </tr>
  5257. <tr>
  5258. <td>
  5259. <p>
  5260. <code class="computeroutput"><span class="identifier">BOOST_NO_0X_HDR_MUTEX</span></code>
  5261. </p>
  5262. </td>
  5263. <td>
  5264. <p>
  5265. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_MUTEX</span></code>
  5266. </p>
  5267. </td>
  5268. <td>
  5269. <p>
  5270. Boost 1.50
  5271. </p>
  5272. </td>
  5273. <td>
  5274. </td>
  5275. </tr>
  5276. <tr>
  5277. <td>
  5278. <p>
  5279. <code class="computeroutput"><span class="identifier">BOOST_NO_0X_HDR_RANDOM</span></code>
  5280. </p>
  5281. </td>
  5282. <td>
  5283. <p>
  5284. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_RANDOM</span></code>
  5285. </p>
  5286. </td>
  5287. <td>
  5288. <p>
  5289. Boost 1.50
  5290. </p>
  5291. </td>
  5292. <td>
  5293. </td>
  5294. </tr>
  5295. <tr>
  5296. <td>
  5297. <p>
  5298. <code class="computeroutput"><span class="identifier">BOOST_NO_0X_HDR_RATIO</span></code>
  5299. </p>
  5300. </td>
  5301. <td>
  5302. <p>
  5303. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_RATIO</span></code>
  5304. </p>
  5305. </td>
  5306. <td>
  5307. <p>
  5308. Boost 1.50
  5309. </p>
  5310. </td>
  5311. <td>
  5312. </td>
  5313. </tr>
  5314. <tr>
  5315. <td>
  5316. <p>
  5317. <code class="computeroutput"><span class="identifier">BOOST_NO_0X_HDR_REGEX</span></code>
  5318. </p>
  5319. </td>
  5320. <td>
  5321. <p>
  5322. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_REGEX</span></code>
  5323. </p>
  5324. </td>
  5325. <td>
  5326. <p>
  5327. Boost 1.50
  5328. </p>
  5329. </td>
  5330. <td>
  5331. </td>
  5332. </tr>
  5333. <tr>
  5334. <td>
  5335. <p>
  5336. <code class="computeroutput"><span class="identifier">BOOST_NO_0X_HDR_SYSTEM_ERROR</span></code>
  5337. </p>
  5338. </td>
  5339. <td>
  5340. <p>
  5341. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_SYSTEM_ERROR</span></code>
  5342. </p>
  5343. </td>
  5344. <td>
  5345. <p>
  5346. Boost 1.50
  5347. </p>
  5348. </td>
  5349. <td>
  5350. </td>
  5351. </tr>
  5352. <tr>
  5353. <td>
  5354. <p>
  5355. <code class="computeroutput"><span class="identifier">BOOST_NO_0X_HDR_THREAD</span></code>
  5356. </p>
  5357. </td>
  5358. <td>
  5359. <p>
  5360. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_THREAD</span></code>
  5361. </p>
  5362. </td>
  5363. <td>
  5364. <p>
  5365. Boost 1.50
  5366. </p>
  5367. </td>
  5368. <td>
  5369. </td>
  5370. </tr>
  5371. <tr>
  5372. <td>
  5373. <p>
  5374. <code class="computeroutput"><span class="identifier">BOOST_NO_0X_HDR_TUPLE</span></code>
  5375. </p>
  5376. </td>
  5377. <td>
  5378. <p>
  5379. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_TUPLE</span></code>
  5380. </p>
  5381. </td>
  5382. <td>
  5383. <p>
  5384. Boost 1.50
  5385. </p>
  5386. </td>
  5387. <td>
  5388. </td>
  5389. </tr>
  5390. <tr>
  5391. <td>
  5392. <p>
  5393. <code class="computeroutput"><span class="identifier">BOOST_NO_0X_HDR_TYPE_TRAITS</span></code>
  5394. </p>
  5395. </td>
  5396. <td>
  5397. <p>
  5398. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_TYPE_TRAITS</span></code>
  5399. </p>
  5400. </td>
  5401. <td>
  5402. <p>
  5403. Boost 1.50
  5404. </p>
  5405. </td>
  5406. <td>
  5407. </td>
  5408. </tr>
  5409. <tr>
  5410. <td>
  5411. <p>
  5412. <code class="computeroutput"><span class="identifier">BOOST_NO_0X_HDR_TYPEINDEX</span></code>
  5413. </p>
  5414. </td>
  5415. <td>
  5416. <p>
  5417. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_TYPEINDEX</span></code>
  5418. </p>
  5419. </td>
  5420. <td>
  5421. <p>
  5422. Boost 1.50
  5423. </p>
  5424. </td>
  5425. <td>
  5426. </td>
  5427. </tr>
  5428. <tr>
  5429. <td>
  5430. <p>
  5431. <code class="computeroutput"><span class="identifier">BOOST_NO_0X_HDR_UNORDERED_SET</span></code>
  5432. </p>
  5433. </td>
  5434. <td>
  5435. <p>
  5436. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_UNORDERED_SET</span></code>
  5437. </p>
  5438. </td>
  5439. <td>
  5440. <p>
  5441. Boost 1.50
  5442. </p>
  5443. </td>
  5444. <td>
  5445. </td>
  5446. </tr>
  5447. <tr>
  5448. <td>
  5449. <p>
  5450. <code class="computeroutput"><span class="identifier">BOOST_NO_0X_HDR_UNORDERED_MAP</span></code>
  5451. </p>
  5452. </td>
  5453. <td>
  5454. <p>
  5455. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_UNORDERED_MAP</span></code>
  5456. </p>
  5457. </td>
  5458. <td>
  5459. <p>
  5460. Boost 1.50
  5461. </p>
  5462. </td>
  5463. <td>
  5464. </td>
  5465. </tr>
  5466. <tr>
  5467. <td>
  5468. <p>
  5469. <code class="computeroutput"><span class="identifier">BOOST_NO_STD_UNORDERED</span></code>
  5470. </p>
  5471. </td>
  5472. <td>
  5473. <p>
  5474. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_HDR_UNORDERED_SET</span></code>
  5475. </p>
  5476. </td>
  5477. <td>
  5478. <p>
  5479. Boost 1.50
  5480. </p>
  5481. </td>
  5482. <td>
  5483. </td>
  5484. </tr>
  5485. <tr>
  5486. <td>
  5487. </td>
  5488. <td>
  5489. </td>
  5490. <td>
  5491. </td>
  5492. <td>
  5493. </td>
  5494. </tr>
  5495. <tr>
  5496. <td>
  5497. <p>
  5498. <code class="computeroutput"><span class="identifier">BOOST_NO_AUTO_DECLARATIONS</span></code>
  5499. </p>
  5500. </td>
  5501. <td>
  5502. <p>
  5503. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_AUTO_DECLARATIONS</span></code>
  5504. </p>
  5505. </td>
  5506. <td>
  5507. <p>
  5508. Boost 1.51
  5509. </p>
  5510. </td>
  5511. <td>
  5512. </td>
  5513. </tr>
  5514. <tr>
  5515. <td>
  5516. <p>
  5517. <code class="computeroutput"><span class="identifier">BOOST_NO_AUTO_MULTIDECLARATIONS</span></code>
  5518. </p>
  5519. </td>
  5520. <td>
  5521. <p>
  5522. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_AUTO_MULTIDECLARATIONS</span></code>
  5523. </p>
  5524. </td>
  5525. <td>
  5526. <p>
  5527. Boost 1.51
  5528. </p>
  5529. </td>
  5530. <td>
  5531. </td>
  5532. </tr>
  5533. <tr>
  5534. <td>
  5535. <p>
  5536. <code class="computeroutput"><span class="identifier">BOOST_NO_CHAR16_T</span></code>
  5537. </p>
  5538. </td>
  5539. <td>
  5540. <p>
  5541. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_CHAR16_T</span></code>
  5542. </p>
  5543. </td>
  5544. <td>
  5545. <p>
  5546. Boost 1.51
  5547. </p>
  5548. </td>
  5549. <td>
  5550. </td>
  5551. </tr>
  5552. <tr>
  5553. <td>
  5554. <p>
  5555. <code class="computeroutput"><span class="identifier">BOOST_NO_CHAR32_T</span></code>
  5556. </p>
  5557. </td>
  5558. <td>
  5559. <p>
  5560. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_CHAR32_T</span></code>
  5561. </p>
  5562. </td>
  5563. <td>
  5564. <p>
  5565. Boost 1.51
  5566. </p>
  5567. </td>
  5568. <td>
  5569. </td>
  5570. </tr>
  5571. <tr>
  5572. <td>
  5573. <p>
  5574. <code class="computeroutput"><span class="identifier">BOOST_NO_TEMPLATE_ALIASES</span></code>
  5575. </p>
  5576. </td>
  5577. <td>
  5578. <p>
  5579. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_TEMPLATE_ALIASES</span></code>
  5580. </p>
  5581. </td>
  5582. <td>
  5583. <p>
  5584. Boost 1.51
  5585. </p>
  5586. </td>
  5587. <td>
  5588. </td>
  5589. </tr>
  5590. <tr>
  5591. <td>
  5592. <p>
  5593. <code class="computeroutput"><span class="identifier">BOOST_NO_CONSTEXPR</span></code>
  5594. </p>
  5595. </td>
  5596. <td>
  5597. <p>
  5598. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_CONSTEXPR</span></code>
  5599. </p>
  5600. </td>
  5601. <td>
  5602. <p>
  5603. Boost 1.51
  5604. </p>
  5605. </td>
  5606. <td>
  5607. </td>
  5608. </tr>
  5609. <tr>
  5610. <td>
  5611. <p>
  5612. <code class="computeroutput"><span class="identifier">BOOST_NO_DECLTYPE</span></code>
  5613. </p>
  5614. </td>
  5615. <td>
  5616. <p>
  5617. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_DECLTYPE</span></code>
  5618. </p>
  5619. </td>
  5620. <td>
  5621. <p>
  5622. Boost 1.51
  5623. </p>
  5624. </td>
  5625. <td>
  5626. </td>
  5627. </tr>
  5628. <tr>
  5629. <td>
  5630. <p>
  5631. <code class="computeroutput"><span class="identifier">BOOST_NO_DECLTYPE_N3276</span></code>
  5632. </p>
  5633. </td>
  5634. <td>
  5635. <p>
  5636. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_DECLTYPE_N3276</span></code>
  5637. </p>
  5638. </td>
  5639. <td>
  5640. <p>
  5641. Boost 1.51
  5642. </p>
  5643. </td>
  5644. <td>
  5645. </td>
  5646. </tr>
  5647. <tr>
  5648. <td>
  5649. <p>
  5650. <code class="computeroutput"><span class="identifier">BOOST_NO_DEFAULTED_FUNCTIONS</span></code>
  5651. </p>
  5652. </td>
  5653. <td>
  5654. <p>
  5655. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_DEFAULTED_FUNCTIONS</span></code>
  5656. </p>
  5657. </td>
  5658. <td>
  5659. <p>
  5660. Boost 1.51
  5661. </p>
  5662. </td>
  5663. <td>
  5664. </td>
  5665. </tr>
  5666. <tr>
  5667. <td>
  5668. <p>
  5669. <code class="computeroutput"><span class="identifier">BOOST_NO_DELETED_FUNCTIONS</span></code>
  5670. </p>
  5671. </td>
  5672. <td>
  5673. <p>
  5674. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_DELETED_FUNCTIONS</span></code>
  5675. </p>
  5676. </td>
  5677. <td>
  5678. <p>
  5679. Boost 1.51
  5680. </p>
  5681. </td>
  5682. <td>
  5683. </td>
  5684. </tr>
  5685. <tr>
  5686. <td>
  5687. <p>
  5688. <code class="computeroutput"><span class="identifier">BOOST_NO_EXPLICIT_CONVERSION_OPERATORS</span></code>
  5689. </p>
  5690. </td>
  5691. <td>
  5692. <p>
  5693. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_EXPLICIT_CONVERSION_OPERATORS</span></code>
  5694. </p>
  5695. </td>
  5696. <td>
  5697. <p>
  5698. Boost 1.51
  5699. </p>
  5700. </td>
  5701. <td>
  5702. </td>
  5703. </tr>
  5704. <tr>
  5705. <td>
  5706. <p>
  5707. <code class="computeroutput"><span class="identifier">BOOST_NO_EXTERN_TEMPLATE</span></code>
  5708. </p>
  5709. </td>
  5710. <td>
  5711. <p>
  5712. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_EXTERN_TEMPLATE</span></code>
  5713. </p>
  5714. </td>
  5715. <td>
  5716. <p>
  5717. Boost 1.51
  5718. </p>
  5719. </td>
  5720. <td>
  5721. </td>
  5722. </tr>
  5723. <tr>
  5724. <td>
  5725. <p>
  5726. <code class="computeroutput"><span class="identifier">BOOST_NO_FUNCTION_TEMPLATE_DEFAULT_ARGS</span></code>
  5727. </p>
  5728. </td>
  5729. <td>
  5730. <p>
  5731. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_FUNCTION_TEMPLATE_DEFAULT_ARGS</span></code>
  5732. </p>
  5733. </td>
  5734. <td>
  5735. <p>
  5736. Boost 1.51
  5737. </p>
  5738. </td>
  5739. <td>
  5740. </td>
  5741. </tr>
  5742. <tr>
  5743. <td>
  5744. <p>
  5745. <code class="computeroutput"><span class="identifier">BOOST_NO_LAMBDAS</span></code>
  5746. </p>
  5747. </td>
  5748. <td>
  5749. <p>
  5750. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_LAMBDAS</span></code>
  5751. </p>
  5752. </td>
  5753. <td>
  5754. <p>
  5755. Boost 1.51
  5756. </p>
  5757. </td>
  5758. <td>
  5759. </td>
  5760. </tr>
  5761. <tr>
  5762. <td>
  5763. <p>
  5764. <code class="computeroutput"><span class="identifier">BOOST_NO_LOCAL_CLASS_TEMPLATE_PARAMETERS</span></code>
  5765. </p>
  5766. </td>
  5767. <td>
  5768. <p>
  5769. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_LOCAL_CLASS_TEMPLATE_PARAMETERS</span></code>
  5770. </p>
  5771. </td>
  5772. <td>
  5773. <p>
  5774. Boost 1.51
  5775. </p>
  5776. </td>
  5777. <td>
  5778. </td>
  5779. </tr>
  5780. <tr>
  5781. <td>
  5782. <p>
  5783. <code class="computeroutput"><span class="identifier">BOOST_NO_NOEXCEPT</span></code>
  5784. </p>
  5785. </td>
  5786. <td>
  5787. <p>
  5788. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_NOEXCEPT</span></code>
  5789. </p>
  5790. </td>
  5791. <td>
  5792. <p>
  5793. Boost 1.51
  5794. </p>
  5795. </td>
  5796. <td>
  5797. </td>
  5798. </tr>
  5799. <tr>
  5800. <td>
  5801. <p>
  5802. <code class="computeroutput"><span class="identifier">BOOST_NO_NULLPTR</span></code>
  5803. </p>
  5804. </td>
  5805. <td>
  5806. <p>
  5807. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_NULLPTR</span></code>
  5808. </p>
  5809. </td>
  5810. <td>
  5811. <p>
  5812. Boost 1.51
  5813. </p>
  5814. </td>
  5815. <td>
  5816. </td>
  5817. </tr>
  5818. <tr>
  5819. <td>
  5820. <p>
  5821. <code class="computeroutput"><span class="identifier">BOOST_NO_RAW_LITERALS</span></code>
  5822. </p>
  5823. </td>
  5824. <td>
  5825. <p>
  5826. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_RAW_LITERALS</span></code>
  5827. </p>
  5828. </td>
  5829. <td>
  5830. <p>
  5831. Boost 1.51
  5832. </p>
  5833. </td>
  5834. <td>
  5835. </td>
  5836. </tr>
  5837. <tr>
  5838. <td>
  5839. <p>
  5840. <code class="computeroutput"><span class="identifier">BOOST_NO_RVALUE_REFERENCES</span></code>
  5841. </p>
  5842. </td>
  5843. <td>
  5844. <p>
  5845. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_RVALUE_REFERENCES</span></code>
  5846. </p>
  5847. </td>
  5848. <td>
  5849. <p>
  5850. Boost 1.51
  5851. </p>
  5852. </td>
  5853. <td>
  5854. </td>
  5855. </tr>
  5856. <tr>
  5857. <td>
  5858. <p>
  5859. <code class="computeroutput"><span class="identifier">BOOST_NO_SCOPED_ENUMS</span></code>
  5860. </p>
  5861. </td>
  5862. <td>
  5863. <p>
  5864. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_SCOPED_ENUMS</span></code>
  5865. </p>
  5866. </td>
  5867. <td>
  5868. <p>
  5869. Boost 1.51
  5870. </p>
  5871. </td>
  5872. <td>
  5873. </td>
  5874. </tr>
  5875. <tr>
  5876. <td>
  5877. <p>
  5878. <code class="computeroutput"><span class="identifier">BOOST_NO_STATIC_ASSERT</span></code>
  5879. </p>
  5880. </td>
  5881. <td>
  5882. <p>
  5883. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_STATIC_ASSERT</span></code>
  5884. </p>
  5885. </td>
  5886. <td>
  5887. <p>
  5888. Boost 1.51
  5889. </p>
  5890. </td>
  5891. <td>
  5892. </td>
  5893. </tr>
  5894. <tr>
  5895. <td>
  5896. <p>
  5897. <code class="computeroutput"><span class="identifier">BOOST_NO_STD_UNORDERED</span></code>
  5898. </p>
  5899. </td>
  5900. <td>
  5901. <p>
  5902. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_STD_UNORDERED</span></code>
  5903. </p>
  5904. </td>
  5905. <td>
  5906. <p>
  5907. Boost 1.51
  5908. </p>
  5909. </td>
  5910. <td>
  5911. </td>
  5912. </tr>
  5913. <tr>
  5914. <td>
  5915. <p>
  5916. <code class="computeroutput"><span class="identifier">BOOST_NO_UNICODE_LITERALS</span></code>
  5917. </p>
  5918. </td>
  5919. <td>
  5920. <p>
  5921. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_UNICODE_LITERALS</span></code>
  5922. </p>
  5923. </td>
  5924. <td>
  5925. <p>
  5926. Boost 1.51
  5927. </p>
  5928. </td>
  5929. <td>
  5930. </td>
  5931. </tr>
  5932. <tr>
  5933. <td>
  5934. <p>
  5935. <code class="computeroutput"><span class="identifier">BOOST_NO_UNIFIED_INITIALIZATION_SYNTAX</span></code>
  5936. </p>
  5937. </td>
  5938. <td>
  5939. <p>
  5940. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_UNIFIED_INITIALIZATION_SYNTAX</span></code>
  5941. </p>
  5942. </td>
  5943. <td>
  5944. <p>
  5945. Boost 1.51
  5946. </p>
  5947. </td>
  5948. <td>
  5949. </td>
  5950. </tr>
  5951. <tr>
  5952. <td>
  5953. <p>
  5954. <code class="computeroutput"><span class="identifier">BOOST_NO_VARIADIC_TEMPLATES</span></code>
  5955. </p>
  5956. </td>
  5957. <td>
  5958. <p>
  5959. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_VARIADIC_TEMPLATES</span></code>
  5960. </p>
  5961. </td>
  5962. <td>
  5963. <p>
  5964. Boost 1.51
  5965. </p>
  5966. </td>
  5967. <td>
  5968. </td>
  5969. </tr>
  5970. <tr>
  5971. <td>
  5972. <p>
  5973. <code class="computeroutput"><span class="identifier">BOOST_NO_VARIADIC_MACROS</span></code>
  5974. </p>
  5975. </td>
  5976. <td>
  5977. <p>
  5978. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_VARIADIC_MACROS</span></code>
  5979. </p>
  5980. </td>
  5981. <td>
  5982. <p>
  5983. Boost 1.51
  5984. </p>
  5985. </td>
  5986. <td>
  5987. </td>
  5988. </tr>
  5989. <tr>
  5990. <td>
  5991. <p>
  5992. <code class="computeroutput"><span class="identifier">BOOST_NO_NUMERIC_LIMITS_LOWEST</span></code>
  5993. </p>
  5994. </td>
  5995. <td>
  5996. <p>
  5997. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_NUMERIC_LIMITS</span></code>
  5998. </p>
  5999. </td>
  6000. <td>
  6001. <p>
  6002. Boost 1.51
  6003. </p>
  6004. </td>
  6005. <td>
  6006. </td>
  6007. </tr>
  6008. <tr>
  6009. <td>
  6010. </td>
  6011. <td>
  6012. </td>
  6013. <td>
  6014. </td>
  6015. <td>
  6016. </td>
  6017. </tr>
  6018. <tr>
  6019. <td>
  6020. <p>
  6021. <code class="computeroutput"><span class="identifier">BOOST_HAS_STATIC_ASSERT</span></code>
  6022. </p>
  6023. </td>
  6024. <td>
  6025. <p>
  6026. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_STATIC_ASSERT</span></code>
  6027. (negated)
  6028. </p>
  6029. </td>
  6030. <td>
  6031. <p>
  6032. Boost 1.53
  6033. </p>
  6034. </td>
  6035. <td>
  6036. </td>
  6037. </tr>
  6038. <tr>
  6039. <td>
  6040. <p>
  6041. <code class="computeroutput"><span class="identifier">BOOST_HAS_VARIADIC_TMPL</span></code>
  6042. </p>
  6043. </td>
  6044. <td>
  6045. <p>
  6046. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_VARIADIC_TEMPLATES</span></code>
  6047. (negated)
  6048. </p>
  6049. </td>
  6050. <td>
  6051. <p>
  6052. Boost 1.53
  6053. </p>
  6054. </td>
  6055. <td>
  6056. </td>
  6057. </tr>
  6058. <tr>
  6059. <td>
  6060. <p>
  6061. <code class="computeroutput"><span class="identifier">BOOST_HAS_RVALUE_REFS</span></code>
  6062. </p>
  6063. </td>
  6064. <td>
  6065. <p>
  6066. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_RVALUE_REFERENCES</span></code>
  6067. (negated)
  6068. </p>
  6069. </td>
  6070. <td>
  6071. <p>
  6072. Boost 1.53
  6073. </p>
  6074. </td>
  6075. <td>
  6076. </td>
  6077. </tr>
  6078. <tr>
  6079. <td>
  6080. <p>
  6081. <code class="computeroutput"><span class="identifier">BOOST_HAS_CHAR16_T</span></code>
  6082. </p>
  6083. </td>
  6084. <td>
  6085. <p>
  6086. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_CHAR16_T</span></code>
  6087. (negated)
  6088. </p>
  6089. </td>
  6090. <td>
  6091. <p>
  6092. Boost 1.53
  6093. </p>
  6094. </td>
  6095. <td>
  6096. </td>
  6097. </tr>
  6098. <tr>
  6099. <td>
  6100. <p>
  6101. <code class="computeroutput"><span class="identifier">BOOST_HAS_CHAR32_T</span></code>
  6102. </p>
  6103. </td>
  6104. <td>
  6105. <p>
  6106. <code class="computeroutput"><span class="identifier">BOOST_NO_CXX11_CHAR32_T</span></code>
  6107. (negated)
  6108. </p>
  6109. </td>
  6110. <td>
  6111. <p>
  6112. Boost 1.53
  6113. </p>
  6114. </td>
  6115. <td>
  6116. </td>
  6117. </tr>
  6118. </tbody>
  6119. </table></div>
  6120. </div>
  6121. <div class="section">
  6122. <div class="titlepage"><div><div><h3 class="title">
  6123. <a name="boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code"></a><a class="link" href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code" title="Macros for libraries with separate source code">Macros
  6124. for libraries with separate source code</a>
  6125. </h3></div></div></div>
  6126. <div class="toc"><dl class="toc">
  6127. <dt><span class="section"><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code.macros_controlling_shared_library_symbol_visibility">Macros
  6128. controlling shared library symbol visibility</a></span></dt>
  6129. <dt><span class="section"><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code.abi_fixing">ABI
  6130. Fixing</a></span></dt>
  6131. <dt><span class="section"><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code.automatic_library_selection">Automatic
  6132. library selection</a></span></dt>
  6133. </dl></div>
  6134. <p>
  6135. The following macros and helper headers are of use to authors whose libraries
  6136. include separate source code, and are intended to address several issues:
  6137. </p>
  6138. <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
  6139. <li class="listitem">
  6140. Controlling shared library symbol visibility
  6141. </li>
  6142. <li class="listitem">
  6143. Fixing the ABI of the compiled library
  6144. </li>
  6145. <li class="listitem">
  6146. Selecting which compiled library to link against based upon the compilers
  6147. settings
  6148. </li>
  6149. </ul></div>
  6150. <p>
  6151. See <a href="http://www.boost.org/development/separate_compilation.html" target="_top">Guidelines
  6152. for Authors of Boost Libraries Containing Separate Source</a>
  6153. </p>
  6154. <div class="section">
  6155. <div class="titlepage"><div><div><h4 class="title">
  6156. <a name="boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code.macros_controlling_shared_library_symbol_visibility"></a><a class="link" href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code.macros_controlling_shared_library_symbol_visibility" title="Macros controlling shared library symbol visibility">Macros
  6157. controlling shared library symbol visibility</a>
  6158. </h4></div></div></div>
  6159. <p>
  6160. Some compilers support C++ extensions that control which symbols will be
  6161. exported from shared libraries such as dynamic shared objects (DSO's) on
  6162. Unix-like systems or dynamic-link libraries (DLL's) on Windows.
  6163. </p>
  6164. <p>
  6165. The Microsoft VC++ compiler has long supplied <code class="computeroutput"><span class="identifier">__declspec</span><span class="special">(</span><span class="identifier">dllexport</span><span class="special">)</span></code> and <code class="computeroutput"><span class="identifier">__declspec</span><span class="special">(</span><span class="identifier">dllimport</span><span class="special">)</span></code> extensions for this purpose, as do virtually
  6166. all other compilers targeting the Windows platform.
  6167. </p>
  6168. <p>
  6169. Modern versions of the GNU GCC compiler provide the <code class="computeroutput"><span class="identifier">__attribute__</span><span class="special">((</span><span class="identifier">visibility</span><span class="special">(</span><span class="string">"default"</span><span class="special">)))</span></code> extension to indicate that a symbol
  6170. should be exported. All other symbols may be hidden by using the <code class="computeroutput"><span class="special">-</span><span class="identifier">fvisibility</span><span class="special">-</span><span class="identifier">hidden</span></code>
  6171. or <code class="computeroutput"><span class="special">-</span><span class="identifier">fvisibility</span><span class="special">-</span><span class="identifier">ms</span><span class="special">-</span><span class="identifier">compat</span></code> compiler switches.
  6172. </p>
  6173. <p>
  6174. Boost supplies several macros to make it easier to manage symbol visibility
  6175. in a way that is portable between compilers and operating systems.
  6176. </p>
  6177. <div class="informaltable"><table class="table">
  6178. <colgroup>
  6179. <col>
  6180. <col>
  6181. </colgroup>
  6182. <thead><tr>
  6183. <th>
  6184. <p>
  6185. Macro
  6186. </p>
  6187. </th>
  6188. <th>
  6189. <p>
  6190. Description
  6191. </p>
  6192. </th>
  6193. </tr></thead>
  6194. <tbody>
  6195. <tr>
  6196. <td>
  6197. <p>
  6198. <code class="computeroutput"><span class="identifier">BOOST_SYMBOL_EXPORT</span></code>
  6199. </p>
  6200. </td>
  6201. <td>
  6202. <p>
  6203. Defines the syntax of a C++ language extension that indicates
  6204. a symbol is to be exported from a shared library. If the compiler
  6205. has no such extension, the macro is defined with no replacement
  6206. text.
  6207. </p>
  6208. </td>
  6209. </tr>
  6210. <tr>
  6211. <td>
  6212. <p>
  6213. <code class="computeroutput"><span class="identifier">BOOST_SYMBOL_IMPORT</span></code>
  6214. </p>
  6215. </td>
  6216. <td>
  6217. <p>
  6218. Defines the syntax of a C++ language extension that indicates
  6219. a symbol is to be imported from a shared library. If the compiler
  6220. has no such extension, the macro is defined with no replacement
  6221. text.
  6222. </p>
  6223. </td>
  6224. </tr>
  6225. <tr>
  6226. <td>
  6227. <p>
  6228. <code class="computeroutput"><span class="identifier">BOOST_SYMBOL_VISIBLE</span></code>
  6229. </p>
  6230. </td>
  6231. <td>
  6232. <p>
  6233. Defines the syntax of a C++ language extension that indicates
  6234. a symbol is to be globally visible. If the compiler has no such
  6235. extension, the macro is defined with no replacement text. Needed
  6236. for classes that are not otherwise exported, but are used by
  6237. RTTI. Examples include class for objects that will be thrown
  6238. as exceptions or used in dynamic_casts, across shared library
  6239. boundaries. For example, a header-only exception class might
  6240. look like this:
  6241. </p>
  6242. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="keyword">class</span> <span class="identifier">BOOST_SYMBOL_VISIBLE</span> <span class="identifier">my_exception</span> <span class="special">:</span> <span class="keyword">public</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">runtime_error</span> <span class="special">{</span> <span class="special">...</span> <span class="special">};</span>
  6243. </pre>
  6244. <p>
  6245. Without BOOST_SYMBOL_VISIBLE, it would be impossible to catch
  6246. my_exception thrown from a shared library compiled by GCC with
  6247. the -fvisibility=hidden option.
  6248. </p>
  6249. </td>
  6250. </tr>
  6251. <tr>
  6252. <td>
  6253. <p>
  6254. <code class="computeroutput"><span class="identifier">BOOST_HAS_DECLSPEC</span></code>
  6255. </p>
  6256. </td>
  6257. <td>
  6258. <p>
  6259. The compiler has C++ extensions <code class="computeroutput"><span class="identifier">__declspec</span><span class="special">(</span><span class="identifier">dllexport</span><span class="special">)</span></code> and <code class="computeroutput"><span class="identifier">__declspec</span><span class="special">(</span><span class="identifier">dllimport</span><span class="special">)</span></code> to control export/import of
  6260. symbols from shared libraries. <span class="emphasis"><em>Deprecated. This macro
  6261. is no longer necessary since BOOST_SYMBOL_EXPORT and BOOST_SYMBOL_IMPORT
  6262. are now supplied. It is provided to support legacy code.</em></span>
  6263. </p>
  6264. </td>
  6265. </tr>
  6266. </tbody>
  6267. </table></div>
  6268. <p>
  6269. Typical usage:
  6270. </p>
  6271. <p>
  6272. <span class="bold"><strong>boost/foo/config.hpp</strong></span>
  6273. </p>
  6274. <pre class="programlisting"><span class="special">...</span>
  6275. <span class="preprocessor">#if</span> <span class="identifier">defined</span><span class="special">(</span><span class="identifier">BOOST_ALL_DYN_LINK</span><span class="special">)</span> <span class="special">||</span> <span class="identifier">defined</span><span class="special">(</span><span class="identifier">BOOST_FOO_DYN_LINK</span><span class="special">)</span>
  6276. <span class="preprocessor"># if</span> <span class="identifier">defined</span><span class="special">(</span><span class="identifier">BOOST_FOO_SOURCE</span><span class="special">)</span>
  6277. <span class="preprocessor"># define</span> <span class="identifier">BOOST_FOO_DECL</span> <span class="identifier">BOOST_SYMBOL_EXPORT</span>
  6278. <span class="preprocessor"># else</span>
  6279. <span class="preprocessor"># define</span> <span class="identifier">BOOST_FOO_DECL</span> <span class="identifier">BOOST_SYMBOL_IMPORT</span>
  6280. <span class="preprocessor"># endif</span>
  6281. <span class="preprocessor">#else</span>
  6282. <span class="preprocessor"># define</span> <span class="identifier">BOOST_FOO_DECL</span>
  6283. <span class="preprocessor">#endif</span>
  6284. <span class="special">...</span>
  6285. </pre>
  6286. <p>
  6287. <span class="bold"><strong>boost/foo/foo.hpp</strong></span>
  6288. </p>
  6289. <pre class="programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">foo</span><span class="special">/</span><span class="identifier">config</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
  6290. <span class="special">...</span>
  6291. <span class="keyword">class</span> <span class="identifier">BOOST_FOO_DECL</span> <span class="identifier">bar</span> <span class="special">{</span> <span class="special">...</span> <span class="special">};</span>
  6292. <span class="special">...</span>
  6293. <span class="keyword">void</span> <span class="identifier">BOOST_FOO_DECL</span> <span class="identifier">f</span><span class="special">();</span>
  6294. <span class="special">...</span>
  6295. </pre>
  6296. <p>
  6297. <span class="bold"><strong>boost/libs/foo/src/foo.cpp</strong></span>
  6298. </p>
  6299. <pre class="programlisting"><span class="preprocessor">#define</span> <span class="identifier">BOOST_FOO_SOURCE</span>
  6300. <span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">foo</span><span class="special">/</span><span class="identifier">foo</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
  6301. <span class="special">...</span>
  6302. <span class="keyword">void</span> <span class="identifier">BOOST_FOO_DECL</span> <span class="identifier">f</span><span class="special">()</span>
  6303. <span class="special">{</span>
  6304. <span class="special">...</span>
  6305. <span class="special">}</span>
  6306. <span class="special">...</span>
  6307. </pre>
  6308. </div>
  6309. <div class="section">
  6310. <div class="titlepage"><div><div><h4 class="title">
  6311. <a name="boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code.abi_fixing"></a><a class="link" href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code.abi_fixing" title="ABI Fixing">ABI
  6312. Fixing</a>
  6313. </h4></div></div></div>
  6314. <p>
  6315. When linking against a pre-compiled library it vital that the ABI used
  6316. by the compiler when building the library <span class="emphasis"><em>matches exactly</em></span>
  6317. the ABI used by the code using the library. In this case ABI means things
  6318. like the struct packing arrangement used, the name mangling scheme used,
  6319. or the size of some types (enum types for example). This is separate from
  6320. things like threading support, or runtime library variations, which have
  6321. to be dealt with by build variants. To put this in perspective there is
  6322. one compiler (Borland's) that has so many compiler options that make subtle
  6323. changes to the ABI, that at least in theory there 3200 combinations, and
  6324. that's without considering runtime library variations. Fortunately these
  6325. variations can be managed by <code class="computeroutput"><span class="preprocessor">#pragma</span></code>'s
  6326. that tell the compiler what ABI to use for the types declared in your library.
  6327. In order to avoid sprinkling <code class="computeroutput"><span class="preprocessor">#pragma</span></code>'s
  6328. all over the boost headers, there are some prefix and suffix headers that
  6329. do the job. Typical usage is:
  6330. </p>
  6331. <p>
  6332. <span class="bold"><strong>my_library.hpp</strong></span>
  6333. </p>
  6334. <pre class="programlisting"><span class="preprocessor">#ifndef</span> <span class="identifier">MY_INCLUDE_GUARD</span>
  6335. <span class="preprocessor">#define</span> <span class="identifier">MY_INCLUDE_GUARD</span>
  6336. <span class="comment">// all includes go here:</span>
  6337. <code class="literal"><span class="bold"><strong>#include &lt;boost/config.hpp&gt;</strong></span></code>
  6338. <span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">whatever</span><span class="special">&gt;</span>
  6339. <code class="literal"><span class="bold"><strong>#include &lt;boost/config/abi_prefix.hpp&gt;</strong></span></code> <span class="comment">// must be the last #include</span>
  6340. <span class="keyword">namespace</span> <span class="identifier">boost</span> <span class="special">{</span>
  6341. <span class="comment">// your code goes here</span>
  6342. <span class="special">}</span>
  6343. <code class="literal"><span class="bold"><strong>#include &lt;boost/config/abi_suffix.hpp&gt;</strong></span></code> <span class="comment">// pops abi_prefix.hpp pragmas</span>
  6344. <span class="preprocessor">#endif</span> <span class="comment">// include guard</span>
  6345. </pre>
  6346. <p>
  6347. <span class="bold"><strong>my_library.cpp</strong></span>
  6348. </p>
  6349. <pre class="programlisting"><span class="special">...</span>
  6350. <span class="comment">// nothing special need be done in the implementation file</span>
  6351. <span class="special">...</span>
  6352. </pre>
  6353. <p>
  6354. The user can disable this mechanism by defining <code class="computeroutput"><span class="identifier">BOOST_DISABLE_ABI_HEADERS</span></code>,
  6355. or they can define <code class="computeroutput"><span class="identifier">BOOST_ABI_PREFIX</span></code>
  6356. and/or <code class="computeroutput"><span class="identifier">BOOST_ABI_SUFFIX</span></code>
  6357. to point to their own prefix/suffix headers if they so wish.
  6358. </p>
  6359. </div>
  6360. <div class="section">
  6361. <div class="titlepage"><div><div><h4 class="title">
  6362. <a name="boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code.automatic_library_selection"></a><a class="link" href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code.automatic_library_selection" title="Automatic library selection">Automatic
  6363. library selection</a>
  6364. </h4></div></div></div>
  6365. <p>
  6366. It is essential that users link to a build of a library which was built
  6367. against the same runtime library that their application will be built against
  6368. -if this does not happen then the library will not be binary compatible
  6369. with their own code- and there is a high likelihood that their application
  6370. will experience runtime crashes. These kinds of problems can be extremely
  6371. time consuming and difficult to debug, and often lead to frustrated users
  6372. and authors alike (simply selecting the right library to link against is
  6373. not as easy as it seems when their are 6-8 of them to chose from, and some
  6374. users seem to be blissfully unaware that there even are different runtimes
  6375. available to them).
  6376. </p>
  6377. <p>
  6378. To solve this issue, some compilers allow source code to contain <code class="computeroutput"><span class="preprocessor">#pragma</span></code>'s that instruct the linker
  6379. which library to link against, all the user need do is include the headers
  6380. they need, place the compiled libraries in their library search path, and
  6381. the compiler and linker do the rest. Boost.config supports this via the
  6382. header <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">config</span><span class="special">/</span><span class="identifier">auto_link</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>, before including this header one or
  6383. more of the following macros need to be defined:
  6384. </p>
  6385. <div class="variablelist">
  6386. <p class="title"><b></b></p>
  6387. <dl class="variablelist">
  6388. <dt><span class="term"><code class="computeroutput"><span class="identifier">BOOST_LIB_NAME</span></code></span></dt>
  6389. <dd><p>
  6390. Required: An identifier containing the basename of the library, for
  6391. example 'boost_regex'.
  6392. </p></dd>
  6393. <dt><span class="term"><code class="computeroutput"><span class="identifier">BOOST_DYN_LINK</span></code></span></dt>
  6394. <dd><p>
  6395. Optional: when set link to dll rather than static library.
  6396. </p></dd>
  6397. <dt><span class="term"><code class="computeroutput"><span class="identifier">BOOST_LIB_DIAGNOSTIC</span></code></span></dt>
  6398. <dd><p>
  6399. Optional: when set the header will print out the name of the library
  6400. selected (useful for debugging).
  6401. </p></dd>
  6402. <dt><span class="term"><code class="computeroutput"><span class="identifier">BOOST_AUTO_LINK_NOMANGLE</span></code></span></dt>
  6403. <dd><p>
  6404. Optional: whan set specifies that we should link to BOOST_LIB_NAME.lib,
  6405. rather than a mangled-name version.
  6406. </p></dd>
  6407. <dt><span class="term"><code class="computeroutput"><span class="identifier">BOOST_AUTO_LINK_TAGGED</span></code></span></dt>
  6408. <dd><p>
  6409. Optional: Specifies that we link to libraries built with the --layout=tagged
  6410. option. This is essentially the same as the default name-mangled
  6411. version, but without the compiler name and version, or the Boost
  6412. version. Just the build options.
  6413. </p></dd>
  6414. <dt><span class="term"><code class="computeroutput"><span class="identifier">BOOST_AUTO_LINK_SYSTEM</span></code></span></dt>
  6415. <dd><p>
  6416. Optional: Specifies that we link to libraries built with the --layout=system
  6417. option. This is essentially the same as the non-name-mangled version,
  6418. but with the prefix to differentiate static and dll builds
  6419. </p></dd>
  6420. </dl>
  6421. </div>
  6422. <p>
  6423. If the compiler supports this mechanism, then it will be told to link against
  6424. the appropriately named library, the actual algorithm used to mangle the
  6425. name of the library is documented inside <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">config</span><span class="special">/</span><span class="identifier">auto_link</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>
  6426. and has to match that used to create the libraries via bjam 's install
  6427. rules.
  6428. </p>
  6429. <p>
  6430. <span class="bold"><strong>my_library.hpp</strong></span>
  6431. </p>
  6432. <pre class="programlisting"><span class="special">...</span>
  6433. <span class="comment">//</span>
  6434. <span class="comment">// Don't include auto-linking code if the user has disabled it by</span>
  6435. <span class="comment">// defining BOOST_ALL_NO_LIB, or BOOST_MY_LIBRARY_NO_LIB, or if this </span>
  6436. <span class="comment">// is one of our own source files (signified by BOOST_MY_LIBRARY_SOURCE):</span>
  6437. <span class="comment">//</span>
  6438. <span class="preprocessor">#if</span> <span class="special">!</span><span class="identifier">defined</span><span class="special">(</span><span class="identifier">BOOST_ALL_NO_LIB</span><span class="special">)</span> <span class="special">&amp;&amp;</span> <span class="special">!</span><span class="identifier">defined</span><span class="special">(</span><span class="identifier">BOOST_MY_LIBRARY_NO_LIB</span><span class="special">)</span> <span class="special">&amp;&amp;</span> <span class="special">!</span><span class="identifier">defined</span><span class="special">(</span><span class="identifier">BOOST_MY_LIBRARY_SOURCE</span><span class="special">)</span>
  6439. <span class="preprocessor"># define</span> <span class="identifier">BOOST_LIB_NAME</span> <span class="identifier">boost_my_library</span>
  6440. <span class="preprocessor"># ifdef</span> <span class="identifier">BOOST_MY_LIBRARY_DYN_LINK</span>
  6441. <span class="preprocessor"># define</span> <span class="identifier">BOOST_DYN_LINK</span>
  6442. <span class="preprocessor"># endif</span>
  6443. <span class="preprocessor"># include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">config</span><span class="special">/</span><span class="identifier">auto_link</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
  6444. <span class="preprocessor">#endif</span>
  6445. <span class="special">...</span>
  6446. </pre>
  6447. <p>
  6448. <span class="bold"><strong>my_library.cpp</strong></span>
  6449. </p>
  6450. <pre class="programlisting"><span class="comment">// define BOOST_MY_LIBRARY_SOURCE so that the header knows that the</span>
  6451. <span class="comment">// library is being built (possibly exporting rather than importing code)</span>
  6452. <span class="comment">//</span>
  6453. <span class="preprocessor">#define</span> <span class="identifier">BOOST_MY_LIBRARY_SOURCE</span>
  6454. <span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">my_library</span><span class="special">/</span><span class="identifier">my_library</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
  6455. <span class="special">...</span>
  6456. </pre>
  6457. </div>
  6458. </div>
  6459. </div>
  6460. <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
  6461. <td align="left"></td>
  6462. <td align="right"><div class="copyright-footer">Copyright &#169; 2001-2007 Beman Dawes, Vesa Karvonen, John
  6463. Maddock<p>
  6464. Distributed under the Boost Software License, Version 1.0. (See accompanying
  6465. file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
  6466. </p>
  6467. </div></td>
  6468. </tr></table>
  6469. <hr>
  6470. <div class="spirit-nav">
  6471. <a accesskey="p" href="../index.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="build_config.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
  6472. </div>
  6473. </body>
  6474. </html>