autodoc.xml 390 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091409240934094409540964097409840994100410141024103410441054106410741084109411041114112411341144115411641174118411941204121412241234124412541264127412841294130413141324133413441354136413741384139414041414142414341444145414641474148414941504151415241534154415541564157415841594160416141624163416441654166416741684169417041714172417341744175417641774178417941804181418241834184418541864187418841894190419141924193419441954196419741984199420042014202420342044205420642074208420942104211421242134214421542164217421842194220422142224223422442254226422742284229423042314232423342344235423642374238423942404241424242434244424542464247424842494250425142524253425442554256425742584259426042614262426342644265426642674268426942704271427242734274427542764277427842794280428142824283428442854286428742884289429042914292429342944295429642974298429943004301430243034304430543064307430843094310431143124313431443154316431743184319432043214322432343244325432643274328432943304331433243334334433543364337433843394340434143424343434443454346434743484349435043514352435343544355435643574358435943604361436243634364436543664367436843694370437143724373437443754376437743784379438043814382438343844385438643874388438943904391439243934394439543964397439843994400440144024403440444054406440744084409441044114412441344144415441644174418441944204421442244234424442544264427442844294430443144324433443444354436443744384439444044414442444344444445444644474448444944504451445244534454445544564457445844594460446144624463446444654466446744684469447044714472447344744475447644774478447944804481448244834484448544864487448844894490449144924493449444954496449744984499450045014502450345044505450645074508450945104511451245134514451545164517451845194520452145224523452445254526452745284529453045314532453345344535453645374538453945404541454245434544454545464547454845494550455145524553455445554556455745584559456045614562456345644565456645674568456945704571457245734574457545764577457845794580458145824583458445854586458745884589459045914592459345944595459645974598459946004601460246034604460546064607460846094610461146124613461446154616461746184619462046214622462346244625462646274628462946304631463246334634463546364637463846394640464146424643464446454646464746484649465046514652465346544655465646574658465946604661466246634664466546664667466846694670467146724673467446754676467746784679468046814682468346844685468646874688468946904691469246934694469546964697469846994700470147024703470447054706470747084709471047114712471347144715471647174718471947204721472247234724472547264727472847294730473147324733473447354736473747384739474047414742474347444745474647474748474947504751475247534754475547564757475847594760476147624763476447654766476747684769477047714772477347744775477647774778477947804781478247834784478547864787478847894790479147924793479447954796479747984799480048014802480348044805480648074808480948104811481248134814481548164817481848194820482148224823482448254826482748284829483048314832483348344835483648374838483948404841484248434844484548464847484848494850485148524853485448554856485748584859486048614862486348644865486648674868486948704871487248734874487548764877487848794880488148824883488448854886488748884889489048914892489348944895489648974898489949004901490249034904490549064907490849094910491149124913491449154916491749184919492049214922492349244925492649274928492949304931493249334934493549364937493849394940494149424943494449454946494749484949495049514952495349544955495649574958495949604961496249634964496549664967496849694970497149724973497449754976497749784979498049814982498349844985498649874988498949904991499249934994499549964997499849995000500150025003500450055006500750085009501050115012501350145015501650175018501950205021502250235024502550265027502850295030503150325033503450355036503750385039504050415042504350445045504650475048504950505051505250535054505550565057505850595060506150625063506450655066506750685069507050715072507350745075507650775078507950805081508250835084508550865087508850895090509150925093509450955096509750985099510051015102510351045105510651075108510951105111511251135114511551165117511851195120512151225123512451255126512751285129513051315132513351345135513651375138513951405141514251435144514551465147514851495150515151525153515451555156515751585159516051615162516351645165516651675168516951705171517251735174517551765177517851795180518151825183518451855186518751885189519051915192519351945195519651975198519952005201520252035204520552065207520852095210521152125213521452155216521752185219522052215222522352245225522652275228522952305231523252335234523552365237523852395240524152425243524452455246524752485249525052515252525352545255525652575258525952605261526252635264526552665267526852695270527152725273527452755276527752785279528052815282528352845285528652875288528952905291529252935294529552965297529852995300530153025303530453055306530753085309531053115312531353145315531653175318531953205321532253235324532553265327532853295330533153325333533453355336533753385339534053415342534353445345534653475348534953505351535253535354535553565357535853595360536153625363536453655366536753685369537053715372537353745375537653775378537953805381538253835384538553865387538853895390539153925393539453955396539753985399540054015402540354045405540654075408540954105411541254135414541554165417541854195420542154225423542454255426542754285429543054315432543354345435543654375438543954405441544254435444544554465447544854495450545154525453545454555456545754585459546054615462546354645465546654675468546954705471547254735474547554765477547854795480548154825483548454855486548754885489549054915492549354945495549654975498549955005501550255035504550555065507550855095510551155125513551455155516551755185519552055215522552355245525552655275528552955305531553255335534553555365537553855395540554155425543554455455546554755485549555055515552555355545555555655575558555955605561556255635564556555665567556855695570557155725573557455755576557755785579558055815582558355845585558655875588558955905591559255935594559555965597559855995600560156025603560456055606560756085609561056115612561356145615561656175618561956205621562256235624562556265627562856295630563156325633563456355636563756385639564056415642564356445645564656475648564956505651565256535654565556565657565856595660566156625663566456655666566756685669567056715672567356745675567656775678567956805681568256835684568556865687568856895690569156925693569456955696569756985699570057015702570357045705570657075708570957105711571257135714571557165717571857195720572157225723572457255726572757285729573057315732573357345735573657375738573957405741574257435744574557465747574857495750575157525753575457555756575757585759576057615762576357645765576657675768576957705771577257735774577557765777577857795780578157825783578457855786578757885789579057915792579357945795579657975798579958005801580258035804580558065807580858095810581158125813581458155816581758185819582058215822582358245825582658275828582958305831583258335834583558365837583858395840584158425843584458455846584758485849585058515852585358545855585658575858585958605861586258635864586558665867586858695870587158725873587458755876587758785879588058815882588358845885588658875888588958905891589258935894589558965897589858995900590159025903590459055906590759085909591059115912591359145915591659175918591959205921592259235924592559265927592859295930593159325933593459355936593759385939594059415942594359445945594659475948594959505951595259535954595559565957595859595960596159625963596459655966596759685969597059715972597359745975597659775978597959805981598259835984598559865987598859895990599159925993599459955996599759985999600060016002600360046005600660076008600960106011601260136014601560166017601860196020602160226023602460256026602760286029603060316032603360346035603660376038603960406041604260436044604560466047604860496050605160526053605460556056605760586059606060616062606360646065606660676068606960706071607260736074607560766077607860796080608160826083608460856086608760886089609060916092609360946095609660976098609961006101610261036104610561066107610861096110611161126113611461156116611761186119612061216122612361246125612661276128612961306131613261336134613561366137613861396140614161426143614461456146614761486149615061516152615361546155615661576158615961606161616261636164616561666167616861696170617161726173617461756176617761786179618061816182618361846185618661876188618961906191619261936194619561966197619861996200620162026203620462056206620762086209621062116212621362146215621662176218621962206221622262236224622562266227622862296230623162326233623462356236623762386239624062416242624362446245624662476248624962506251625262536254625562566257625862596260626162626263626462656266626762686269627062716272627362746275627662776278627962806281628262836284628562866287628862896290629162926293629462956296629762986299630063016302630363046305630663076308630963106311631263136314631563166317631863196320632163226323632463256326632763286329633063316332633363346335633663376338633963406341634263436344634563466347634863496350635163526353635463556356635763586359636063616362636363646365636663676368636963706371637263736374637563766377637863796380638163826383638463856386638763886389639063916392639363946395639663976398639964006401640264036404640564066407640864096410641164126413641464156416641764186419642064216422642364246425642664276428642964306431643264336434643564366437643864396440644164426443644464456446644764486449645064516452645364546455645664576458645964606461646264636464646564666467646864696470647164726473647464756476647764786479648064816482648364846485648664876488648964906491649264936494649564966497649864996500650165026503650465056506650765086509651065116512651365146515651665176518651965206521652265236524652565266527652865296530653165326533653465356536653765386539654065416542654365446545654665476548654965506551655265536554655565566557655865596560656165626563656465656566656765686569657065716572657365746575657665776578657965806581658265836584658565866587658865896590659165926593659465956596659765986599660066016602660366046605660666076608660966106611661266136614661566166617661866196620662166226623662466256626662766286629663066316632663366346635663666376638663966406641664266436644664566466647664866496650665166526653665466556656665766586659666066616662666366646665666666676668666966706671667266736674667566766677667866796680668166826683668466856686668766886689669066916692669366946695669666976698669967006701670267036704670567066707670867096710671167126713671467156716671767186719672067216722672367246725672667276728672967306731673267336734673567366737673867396740674167426743674467456746674767486749675067516752675367546755675667576758675967606761676267636764676567666767676867696770677167726773677467756776677767786779678067816782678367846785678667876788678967906791679267936794679567966797679867996800680168026803680468056806680768086809681068116812681368146815681668176818681968206821682268236824682568266827682868296830683168326833683468356836683768386839684068416842684368446845684668476848684968506851685268536854685568566857685868596860686168626863686468656866686768686869687068716872687368746875687668776878687968806881688268836884688568866887688868896890689168926893689468956896689768986899690069016902690369046905690669076908690969106911691269136914691569166917691869196920692169226923692469256926692769286929693069316932693369346935693669376938693969406941694269436944694569466947694869496950695169526953695469556956695769586959696069616962696369646965696669676968696969706971697269736974697569766977697869796980698169826983698469856986698769886989699069916992699369946995699669976998699970007001700270037004700570067007700870097010701170127013701470157016701770187019702070217022702370247025702670277028702970307031703270337034703570367037703870397040704170427043704470457046704770487049705070517052705370547055705670577058705970607061706270637064706570667067706870697070707170727073707470757076707770787079708070817082708370847085708670877088708970907091709270937094709570967097709870997100710171027103710471057106710771087109711071117112711371147115711671177118711971207121712271237124712571267127712871297130713171327133713471357136713771387139714071417142714371447145714671477148714971507151715271537154715571567157715871597160716171627163716471657166716771687169717071717172717371747175717671777178717971807181718271837184718571867187718871897190719171927193719471957196719771987199720072017202720372047205720672077208720972107211721272137214721572167217721872197220722172227223722472257226722772287229723072317232723372347235723672377238723972407241724272437244724572467247724872497250725172527253725472557256725772587259726072617262726372647265726672677268726972707271727272737274727572767277727872797280728172827283728472857286728772887289729072917292729372947295729672977298729973007301730273037304730573067307730873097310731173127313731473157316731773187319732073217322732373247325732673277328732973307331733273337334733573367337733873397340734173427343734473457346734773487349735073517352735373547355735673577358735973607361736273637364736573667367736873697370737173727373737473757376737773787379738073817382738373847385738673877388738973907391739273937394739573967397739873997400740174027403740474057406740774087409741074117412741374147415741674177418741974207421742274237424742574267427742874297430743174327433743474357436743774387439744074417442744374447445744674477448744974507451745274537454745574567457745874597460746174627463746474657466746774687469747074717472747374747475747674777478747974807481748274837484748574867487748874897490749174927493749474957496749774987499750075017502750375047505750675077508750975107511751275137514751575167517751875197520752175227523752475257526752775287529753075317532753375347535753675377538753975407541754275437544754575467547754875497550755175527553755475557556755775587559756075617562756375647565756675677568756975707571757275737574757575767577757875797580758175827583758475857586758775887589759075917592759375947595759675977598759976007601760276037604760576067607760876097610761176127613761476157616761776187619762076217622762376247625762676277628762976307631763276337634763576367637763876397640764176427643764476457646764776487649765076517652765376547655765676577658765976607661766276637664766576667667766876697670767176727673767476757676767776787679768076817682768376847685768676877688768976907691769276937694769576967697769876997700770177027703770477057706770777087709771077117712771377147715771677177718771977207721772277237724772577267727772877297730773177327733773477357736773777387739774077417742774377447745774677477748774977507751775277537754775577567757775877597760776177627763776477657766776777687769777077717772777377747775777677777778777977807781778277837784778577867787778877897790779177927793779477957796779777987799780078017802780378047805780678077808780978107811781278137814781578167817781878197820782178227823782478257826782778287829783078317832783378347835783678377838783978407841784278437844784578467847784878497850785178527853785478557856785778587859786078617862786378647865786678677868786978707871787278737874787578767877787878797880788178827883788478857886788778887889789078917892789378947895789678977898789979007901790279037904790579067907790879097910791179127913791479157916791779187919792079217922792379247925792679277928792979307931793279337934793579367937793879397940794179427943794479457946794779487949795079517952795379547955795679577958795979607961796279637964796579667967796879697970797179727973797479757976797779787979798079817982798379847985798679877988798979907991799279937994799579967997799879998000800180028003800480058006800780088009801080118012801380148015801680178018801980208021802280238024802580268027802880298030803180328033803480358036803780388039804080418042804380448045804680478048804980508051805280538054805580568057805880598060806180628063806480658066806780688069807080718072807380748075807680778078807980808081808280838084808580868087808880898090809180928093809480958096809780988099810081018102810381048105810681078108810981108111811281138114811581168117811881198120812181228123812481258126812781288129813081318132813381348135813681378138813981408141814281438144814581468147814881498150815181528153815481558156815781588159816081618162816381648165816681678168816981708171817281738174817581768177817881798180818181828183818481858186818781888189819081918192819381948195819681978198819982008201820282038204820582068207820882098210821182128213821482158216821782188219822082218222822382248225822682278228822982308231823282338234823582368237823882398240824182428243824482458246824782488249825082518252825382548255825682578258825982608261826282638264826582668267826882698270827182728273827482758276827782788279828082818282828382848285828682878288828982908291829282938294829582968297829882998300830183028303830483058306830783088309831083118312831383148315831683178318831983208321832283238324832583268327832883298330833183328333833483358336833783388339834083418342834383448345834683478348834983508351835283538354835583568357835883598360836183628363836483658366836783688369837083718372837383748375837683778378837983808381838283838384838583868387838883898390839183928393839483958396839783988399840084018402840384048405840684078408840984108411841284138414841584168417841884198420842184228423842484258426842784288429843084318432843384348435843684378438843984408441844284438444844584468447844884498450845184528453845484558456845784588459846084618462846384648465846684678468846984708471847284738474847584768477847884798480848184828483848484858486848784888489849084918492849384948495849684978498849985008501850285038504850585068507850885098510851185128513851485158516851785188519852085218522852385248525852685278528852985308531853285338534853585368537853885398540854185428543854485458546854785488549855085518552855385548555855685578558855985608561856285638564856585668567856885698570857185728573857485758576857785788579858085818582858385848585858685878588858985908591859285938594859585968597859885998600860186028603860486058606860786088609861086118612861386148615861686178618861986208621862286238624862586268627862886298630863186328633863486358636863786388639864086418642864386448645864686478648864986508651865286538654865586568657865886598660866186628663866486658666866786688669867086718672867386748675867686778678867986808681868286838684868586868687868886898690869186928693869486958696869786988699870087018702870387048705870687078708870987108711871287138714871587168717871887198720872187228723872487258726872787288729873087318732873387348735873687378738873987408741874287438744874587468747874887498750875187528753875487558756875787588759876087618762876387648765876687678768876987708771877287738774877587768777877887798780878187828783878487858786878787888789879087918792879387948795879687978798879988008801880288038804880588068807880888098810881188128813881488158816881788188819882088218822882388248825882688278828882988308831883288338834883588368837883888398840884188428843884488458846884788488849885088518852885388548855885688578858885988608861886288638864886588668867886888698870887188728873887488758876887788788879888088818882888388848885888688878888888988908891889288938894889588968897889888998900890189028903890489058906890789088909891089118912891389148915891689178918891989208921892289238924892589268927892889298930893189328933893489358936893789388939894089418942894389448945894689478948894989508951895289538954895589568957895889598960896189628963896489658966896789688969897089718972897389748975897689778978897989808981898289838984898589868987898889898990899189928993899489958996899789988999900090019002900390049005900690079008900990109011901290139014901590169017901890199020902190229023902490259026902790289029903090319032903390349035903690379038903990409041904290439044904590469047904890499050905190529053905490559056905790589059906090619062906390649065906690679068906990709071907290739074907590769077907890799080908190829083908490859086908790889089909090919092909390949095909690979098909991009101910291039104910591069107910891099110911191129113911491159116911791189119912091219122912391249125912691279128912991309131913291339134913591369137913891399140914191429143914491459146914791489149915091519152915391549155915691579158915991609161916291639164916591669167916891699170917191729173917491759176917791789179918091819182918391849185918691879188918991909191919291939194919591969197919891999200920192029203920492059206920792089209921092119212921392149215921692179218921992209221922292239224922592269227922892299230923192329233923492359236923792389239924092419242924392449245924692479248924992509251925292539254925592569257925892599260926192629263926492659266926792689269927092719272927392749275927692779278927992809281928292839284928592869287928892899290929192929293929492959296929792989299930093019302930393049305930693079308930993109311931293139314931593169317931893199320932193229323932493259326932793289329933093319332933393349335933693379338933993409341934293439344934593469347934893499350935193529353935493559356935793589359936093619362936393649365936693679368936993709371937293739374937593769377937893799380938193829383938493859386938793889389939093919392939393949395939693979398939994009401940294039404940594069407940894099410941194129413941494159416941794189419942094219422942394249425942694279428942994309431943294339434943594369437943894399440944194429443944494459446944794489449945094519452945394549455945694579458945994609461946294639464946594669467946894699470947194729473947494759476947794789479948094819482948394849485948694879488948994909491949294939494949594969497949894999500950195029503950495059506950795089509951095119512951395149515951695179518951995209521952295239524952595269527952895299530953195329533953495359536953795389539954095419542954395449545954695479548954995509551955295539554955595569557955895599560956195629563956495659566956795689569957095719572957395749575957695779578957995809581958295839584958595869587958895899590959195929593959495959596959795989599960096019602960396049605960696079608960996109611961296139614961596169617961896199620962196229623962496259626962796289629963096319632963396349635963696379638963996409641964296439644964596469647964896499650965196529653965496559656965796589659966096619662966396649665966696679668966996709671967296739674967596769677967896799680968196829683968496859686968796889689969096919692969396949695969696979698969997009701970297039704970597069707970897099710971197129713971497159716971797189719972097219722972397249725972697279728972997309731973297339734973597369737973897399740974197429743974497459746974797489749975097519752975397549755975697579758975997609761976297639764976597669767976897699770977197729773977497759776977797789779978097819782978397849785978697879788978997909791979297939794979597969797979897999800980198029803980498059806980798089809981098119812981398149815981698179818981998209821982298239824982598269827982898299830983198329833983498359836983798389839984098419842984398449845984698479848984998509851985298539854985598569857985898599860986198629863986498659866986798689869987098719872987398749875987698779878987998809881988298839884988598869887988898899890989198929893989498959896989798989899990099019902990399049905990699079908990999109911991299139914991599169917991899199920992199229923992499259926992799289929993099319932993399349935993699379938993999409941994299439944994599469947994899499950995199529953995499559956995799589959996099619962996399649965996699679968996999709971997299739974997599769977997899799980998199829983998499859986998799889989999099919992999399949995999699979998999910000100011000210003100041000510006100071000810009100101001110012100131001410015100161001710018100191002010021100221002310024100251002610027100281002910030100311003210033100341003510036100371003810039100401004110042100431004410045100461004710048100491005010051100521005310054100551005610057100581005910060100611006210063100641006510066100671006810069100701007110072100731007410075100761007710078100791008010081100821008310084100851008610087100881008910090100911009210093100941009510096100971009810099101001010110102101031010410105101061010710108101091011010111101121011310114101151011610117101181011910120101211012210123101241012510126101271012810129101301013110132101331013410135101361013710138101391014010141101421014310144101451014610147101481014910150101511015210153101541015510156101571015810159101601016110162101631016410165101661016710168101691017010171101721017310174101751017610177101781017910180101811018210183101841018510186101871018810189101901019110192101931019410195101961019710198101991020010201102021020310204102051020610207102081020910210102111021210213102141021510216102171021810219102201022110222102231022410225102261022710228102291023010231102321023310234102351023610237102381023910240102411024210243102441024510246102471024810249102501025110252102531025410255102561025710258102591026010261102621026310264102651026610267102681026910270102711027210273102741027510276102771027810279102801028110282102831028410285102861028710288102891029010291102921029310294102951029610297102981029910300103011030210303103041030510306103071030810309103101031110312103131031410315103161031710318103191032010321103221032310324103251032610327103281032910330103311033210333103341033510336103371033810339103401034110342103431034410345103461034710348103491035010351103521035310354103551035610357103581035910360103611036210363103641036510366103671036810369103701037110372103731037410375103761037710378103791038010381103821038310384103851038610387103881038910390103911039210393103941039510396103971039810399104001040110402104031040410405104061040710408104091041010411104121041310414104151041610417104181041910420104211042210423104241042510426104271042810429104301043110432104331043410435104361043710438104391044010441104421044310444104451044610447104481044910450104511045210453104541045510456104571045810459104601046110462104631046410465104661046710468104691047010471104721047310474104751047610477104781047910480104811048210483104841048510486104871048810489104901049110492104931049410495104961049710498104991050010501105021050310504105051050610507105081050910510105111051210513105141051510516105171051810519105201052110522105231052410525105261052710528105291053010531105321053310534105351053610537105381053910540105411054210543105441054510546105471054810549105501055110552105531055410555105561055710558105591056010561105621056310564105651056610567105681056910570105711057210573105741057510576105771057810579105801058110582105831058410585105861058710588105891059010591105921059310594105951059610597105981059910600106011060210603106041060510606106071060810609106101061110612106131061410615106161061710618106191062010621106221062310624106251062610627106281062910630106311063210633106341063510636106371063810639106401064110642106431064410645106461064710648106491065010651106521065310654106551065610657106581065910660106611066210663106641066510666106671066810669106701067110672106731067410675106761067710678106791068010681106821068310684106851068610687106881068910690106911069210693106941069510696106971069810699107001070110702107031070410705107061070710708107091071010711107121071310714107151071610717107181071910720107211072210723107241072510726107271072810729107301073110732107331073410735107361073710738107391074010741107421074310744107451074610747107481074910750107511075210753107541075510756107571075810759107601076110762107631076410765107661076710768107691077010771107721077310774107751077610777107781077910780107811078210783107841078510786107871078810789107901079110792107931079410795107961079710798107991080010801108021080310804108051080610807108081080910810108111081210813108141081510816108171081810819108201082110822108231082410825108261082710828108291083010831108321083310834108351083610837108381083910840108411084210843108441084510846108471084810849108501085110852108531085410855108561085710858108591086010861108621086310864108651086610867108681086910870108711087210873108741087510876108771087810879108801088110882108831088410885108861088710888108891089010891108921089310894108951089610897108981089910900109011090210903109041090510906109071090810909109101091110912109131091410915109161091710918109191092010921109221092310924109251092610927109281092910930109311093210933109341093510936109371093810939109401094110942109431094410945109461094710948109491095010951109521095310954109551095610957109581095910960109611096210963109641096510966109671096810969109701097110972109731097410975109761097710978109791098010981109821098310984109851098610987109881098910990109911099210993109941099510996109971099810999110001100111002110031100411005110061100711008110091101011011110121101311014110151101611017110181101911020110211102211023110241102511026110271102811029110301103111032110331103411035110361103711038110391104011041110421104311044110451104611047110481104911050110511105211053110541105511056110571105811059110601106111062110631106411065110661106711068110691107011071110721107311074110751107611077110781107911080110811108211083110841108511086110871108811089110901109111092110931109411095110961109711098110991110011101111021110311104111051110611107111081110911110111111111211113111141111511116111171111811119111201112111122111231112411125111261112711128111291113011131111321113311134111351113611137111381113911140111411114211143111441114511146111471114811149111501115111152111531115411155111561115711158111591116011161111621116311164111651116611167111681116911170111711117211173111741117511176111771117811179111801118111182111831118411185111861118711188111891119011191111921119311194111951119611197111981119911200112011120211203112041120511206112071120811209112101121111212112131121411215112161121711218112191122011221112221122311224112251122611227112281122911230112311123211233112341123511236112371123811239112401124111242112431124411245112461124711248112491125011251112521125311254112551125611257112581125911260112611126211263112641126511266112671126811269112701127111272112731127411275112761127711278112791128011281112821128311284112851128611287112881128911290112911129211293112941129511296112971129811299113001130111302113031130411305113061130711308113091131011311113121131311314113151131611317113181131911320113211132211323113241132511326113271132811329113301133111332113331133411335113361133711338113391134011341113421134311344113451134611347113481134911350113511135211353113541135511356113571135811359113601136111362113631136411365113661136711368113691137011371113721137311374113751137611377113781137911380113811138211383113841138511386113871138811389113901139111392113931139411395113961139711398113991140011401114021140311404114051140611407114081140911410114111141211413114141141511416114171141811419114201142111422114231142411425114261142711428114291143011431114321143311434114351143611437114381143911440114411144211443114441144511446114471144811449114501145111452114531145411455114561145711458114591146011461114621146311464114651146611467114681146911470114711147211473114741147511476114771147811479114801148111482114831148411485114861148711488114891149011491114921149311494114951149611497114981149911500115011150211503115041150511506115071150811509115101151111512115131151411515115161151711518115191152011521115221152311524115251152611527115281152911530115311153211533115341153511536115371153811539115401154111542115431154411545115461154711548115491155011551115521155311554115551155611557115581155911560115611156211563115641156511566115671156811569115701157111572115731157411575115761157711578115791158011581115821158311584115851158611587115881158911590115911159211593115941159511596115971159811599116001160111602116031160411605116061160711608116091161011611116121161311614116151161611617116181161911620116211162211623116241162511626116271162811629116301163111632116331163411635116361163711638116391164011641116421164311644116451164611647116481164911650116511165211653116541165511656116571165811659116601166111662116631166411665116661166711668116691167011671116721167311674116751167611677116781167911680116811168211683116841168511686116871168811689116901169111692116931169411695116961169711698116991170011701117021170311704117051170611707117081170911710117111171211713117141171511716117171171811719117201172111722117231172411725117261172711728117291173011731117321173311734117351173611737117381173911740117411174211743117441174511746117471174811749117501175111752117531175411755117561175711758117591176011761117621176311764117651176611767117681176911770117711177211773117741177511776117771177811779117801178111782117831178411785117861178711788117891179011791117921179311794117951179611797117981179911800118011180211803118041180511806118071180811809118101181111812118131181411815118161181711818118191182011821118221182311824118251182611827118281182911830118311183211833118341183511836118371183811839118401184111842118431184411845118461184711848118491185011851118521185311854118551185611857118581185911860118611186211863118641186511866118671186811869118701187111872118731187411875118761187711878118791188011881118821188311884118851188611887118881188911890118911189211893118941189511896118971189811899119001190111902119031190411905119061190711908119091191011911119121191311914119151191611917119181191911920119211192211923119241192511926119271192811929119301193111932119331193411935119361193711938119391194011941119421194311944119451194611947119481194911950119511195211953119541195511956119571195811959119601196111962119631196411965119661196711968119691197011971119721197311974119751197611977119781197911980119811198211983119841198511986119871198811989119901199111992119931199411995119961199711998119991200012001120021200312004120051200612007120081200912010120111201212013120141201512016120171201812019120201202112022120231202412025120261202712028120291203012031120321203312034120351203612037120381203912040120411204212043120441204512046120471204812049120501205112052120531205412055120561205712058120591206012061120621206312064120651206612067120681206912070120711207212073120741207512076120771207812079120801208112082120831208412085120861208712088120891209012091120921209312094120951209612097120981209912100121011210212103121041210512106121071210812109121101211112112121131211412115121161211712118121191212012121121221212312124121251212612127121281212912130121311213212133121341213512136121371213812139121401214112142121431214412145121461214712148121491215012151121521215312154121551215612157121581215912160121611216212163121641216512166121671216812169121701217112172121731217412175121761217712178121791218012181121821218312184121851218612187121881218912190121911219212193121941219512196121971219812199122001220112202122031220412205122061220712208122091221012211122121221312214122151221612217122181221912220122211222212223122241222512226122271222812229122301223112232122331223412235122361223712238122391224012241122421224312244122451224612247122481224912250122511225212253122541225512256122571225812259122601226112262122631226412265122661226712268122691227012271122721227312274122751227612277122781227912280122811228212283122841228512286122871228812289122901229112292122931229412295122961229712298122991230012301123021230312304123051230612307123081230912310123111231212313123141231512316123171231812319123201232112322123231232412325123261232712328123291233012331123321233312334123351233612337123381233912340123411234212343123441234512346123471234812349123501235112352123531235412355123561235712358123591236012361123621236312364123651236612367123681236912370123711237212373123741237512376123771237812379123801238112382123831238412385123861238712388123891239012391123921239312394123951239612397123981239912400124011240212403124041240512406124071240812409124101241112412124131241412415124161241712418124191242012421124221242312424124251242612427124281242912430124311243212433124341243512436124371243812439124401244112442124431244412445124461244712448124491245012451124521245312454124551245612457124581245912460124611246212463124641246512466124671246812469124701247112472124731247412475124761247712478124791248012481124821248312484124851248612487124881248912490124911249212493124941249512496124971249812499125001250112502125031250412505125061250712508125091251012511125121251312514125151251612517125181251912520125211252212523125241252512526125271252812529125301253112532125331253412535125361253712538125391254012541125421254312544125451254612547125481254912550125511255212553125541255512556125571255812559125601256112562125631256412565125661256712568125691257012571125721257312574125751257612577125781257912580125811258212583125841258512586125871258812589125901259112592125931259412595125961259712598125991260012601126021260312604126051260612607126081260912610126111261212613126141261512616126171261812619126201262112622126231262412625126261262712628126291263012631126321263312634126351263612637126381263912640126411264212643126441264512646126471264812649126501265112652126531265412655126561265712658126591266012661126621266312664126651266612667126681266912670126711267212673126741267512676126771267812679126801268112682126831268412685126861268712688126891269012691126921269312694126951269612697126981269912700127011270212703127041270512706127071270812709127101271112712127131271412715127161271712718127191272012721127221272312724127251272612727127281272912730127311273212733127341273512736127371273812739127401274112742127431274412745127461274712748127491275012751127521275312754127551275612757127581275912760127611276212763127641276512766127671276812769127701277112772127731277412775127761277712778127791278012781127821278312784127851278612787127881278912790127911279212793127941279512796127971279812799128001280112802128031280412805128061280712808128091281012811128121281312814128151281612817128181281912820128211282212823128241282512826128271282812829128301283112832128331283412835128361283712838128391284012841128421284312844128451284612847128481284912850128511285212853128541285512856128571285812859128601286112862128631286412865128661286712868128691287012871128721287312874128751287612877128781287912880128811288212883128841288512886128871288812889128901289112892128931289412895128961289712898128991290012901129021290312904129051290612907129081290912910129111291212913129141291512916129171291812919129201292112922129231292412925129261292712928129291293012931129321293312934129351293612937129381293912940129411294212943129441294512946129471294812949129501295112952129531295412955129561295712958129591296012961129621296312964129651296612967129681296912970129711297212973129741297512976129771297812979129801298112982129831298412985129861298712988129891299012991129921299312994129951299612997129981299913000130011300213003130041300513006130071300813009130101301113012130131301413015130161301713018130191302013021130221302313024130251302613027130281302913030130311303213033130341303513036130371303813039130401304113042130431304413045130461304713048130491305013051130521305313054130551305613057130581305913060130611306213063130641306513066130671306813069130701307113072130731307413075130761307713078130791308013081130821308313084130851308613087130881308913090130911309213093130941309513096130971309813099131001310113102131031310413105131061310713108131091311013111131121311313114131151311613117131181311913120131211312213123131241312513126131271312813129131301313113132131331313413135131361313713138131391314013141131421314313144131451314613147131481314913150131511315213153131541315513156131571315813159131601316113162131631316413165131661316713168131691317013171131721317313174131751317613177131781317913180131811318213183131841318513186131871318813189131901319113192131931319413195131961319713198131991320013201132021320313204132051320613207132081320913210132111321213213132141321513216132171321813219132201322113222132231322413225132261322713228132291323013231132321323313234132351323613237132381323913240132411324213243132441324513246132471324813249132501325113252132531325413255132561325713258132591326013261132621326313264132651326613267132681326913270132711327213273132741327513276132771327813279132801328113282132831328413285132861328713288132891329013291132921329313294132951329613297132981329913300133011330213303133041330513306133071330813309133101331113312133131331413315133161331713318133191332013321133221332313324133251332613327133281332913330133311333213333133341333513336133371333813339133401334113342133431334413345133461334713348133491335013351133521335313354133551335613357133581335913360133611336213363133641336513366133671336813369133701337113372133731337413375133761337713378133791338013381133821338313384133851338613387133881338913390133911339213393133941339513396133971339813399134001340113402134031340413405134061340713408134091341013411134121341313414134151341613417134181341913420134211342213423134241342513426134271342813429134301343113432134331343413435134361343713438134391344013441134421344313444134451344613447134481344913450134511345213453134541345513456134571345813459134601346113462134631346413465134661346713468134691347013471134721347313474134751347613477134781347913480134811348213483134841348513486134871348813489134901349113492134931349413495134961349713498134991350013501135021350313504135051350613507135081350913510135111351213513135141351513516135171351813519135201352113522135231352413525135261352713528135291353013531135321353313534135351353613537135381353913540135411354213543135441354513546135471354813549135501355113552135531355413555135561355713558135591356013561135621356313564135651356613567135681356913570135711357213573135741357513576135771357813579135801358113582135831358413585135861358713588135891359013591135921359313594135951359613597135981359913600136011360213603136041360513606136071360813609136101361113612136131361413615136161361713618136191362013621136221362313624136251362613627136281362913630136311363213633136341363513636136371363813639136401364113642136431364413645136461364713648136491365013651136521365313654136551365613657136581365913660136611366213663136641366513666136671366813669136701367113672136731367413675136761367713678136791368013681136821368313684136851368613687136881368913690136911369213693136941369513696136971369813699137001370113702137031370413705137061370713708137091371013711137121371313714137151371613717137181371913720137211372213723137241372513726137271372813729137301373113732137331373413735137361373713738137391374013741137421374313744137451374613747137481374913750137511375213753137541375513756137571375813759137601376113762137631376413765137661376713768137691377013771137721377313774137751377613777137781377913780137811378213783137841378513786137871378813789137901379113792137931379413795137961379713798137991380013801138021380313804138051380613807138081380913810138111381213813138141381513816138171381813819138201382113822138231382413825138261382713828138291383013831138321383313834138351383613837138381383913840138411384213843138441384513846138471384813849138501385113852138531385413855138561385713858138591386013861138621386313864138651386613867138681386913870138711387213873138741387513876138771387813879138801388113882138831388413885138861388713888138891389013891138921389313894138951389613897138981389913900139011390213903139041390513906139071390813909139101391113912139131391413915139161391713918139191392013921139221392313924139251392613927139281392913930139311393213933139341393513936139371393813939139401394113942139431394413945139461394713948139491395013951139521395313954139551395613957139581395913960139611396213963139641396513966139671396813969139701397113972139731397413975139761397713978139791398013981139821398313984139851398613987139881398913990139911399213993139941399513996139971399813999140001400114002140031400414005140061400714008140091401014011140121401314014140151401614017140181401914020140211402214023140241402514026140271402814029140301403114032140331403414035140361403714038140391404014041140421404314044140451404614047140481404914050140511405214053140541405514056140571405814059140601406114062140631406414065140661406714068140691407014071140721407314074140751407614077140781407914080140811408214083140841408514086140871408814089140901409114092140931409414095140961409714098140991410014101141021410314104141051410614107141081410914110141111411214113141141411514116141171411814119141201412114122141231412414125141261412714128141291413014131141321413314134141351413614137141381413914140141411414214143141441414514146141471414814149141501415114152141531415414155141561415714158141591416014161141621416314164141651416614167141681416914170141711417214173141741417514176141771417814179141801418114182141831418414185141861418714188141891419014191141921419314194141951419614197141981419914200142011420214203142041420514206142071420814209142101421114212142131421414215142161421714218142191422014221142221422314224142251422614227142281422914230142311423214233142341423514236142371423814239142401424114242142431424414245142461424714248142491425014251142521425314254142551425614257142581425914260142611426214263142641426514266142671426814269142701427114272142731427414275142761427714278142791428014281142821428314284142851428614287142881428914290142911429214293142941429514296142971429814299143001430114302143031430414305143061430714308143091431014311143121431314314143151431614317143181431914320143211432214323143241432514326143271432814329143301433114332143331433414335143361433714338143391434014341143421434314344143451434614347143481434914350143511435214353143541435514356143571435814359143601436114362143631436414365143661436714368143691437014371143721437314374143751437614377143781437914380143811438214383143841438514386143871438814389143901439114392143931439414395143961439714398143991440014401144021440314404144051440614407144081440914410144111441214413144141441514416144171441814419144201442114422144231442414425144261442714428144291443014431144321443314434144351443614437144381443914440144411444214443144441444514446144471444814449144501445114452144531445414455144561445714458144591446014461144621446314464144651446614467144681446914470144711447214473144741447514476144771447814479144801448114482144831448414485144861448714488144891449014491144921449314494144951449614497144981449914500145011450214503145041450514506145071450814509145101451114512145131451414515145161451714518145191452014521145221452314524145251452614527145281452914530145311453214533145341453514536145371453814539145401454114542145431454414545145461454714548145491455014551145521455314554145551455614557145581455914560145611456214563145641456514566145671456814569145701457114572145731457414575145761457714578145791458014581145821458314584145851458614587145881458914590145911459214593145941459514596145971459814599146001460114602146031460414605146061460714608146091461014611146121461314614146151461614617146181461914620146211462214623146241462514626146271462814629146301463114632146331463414635146361463714638146391464014641146421464314644146451464614647146481464914650146511465214653146541465514656146571465814659146601466114662146631466414665146661466714668146691467014671146721467314674146751467614677146781467914680146811468214683146841468514686146871468814689146901469114692146931469414695146961469714698146991470014701147021470314704147051470614707147081470914710147111471214713147141471514716147171471814719147201472114722147231472414725147261472714728147291473014731147321473314734147351473614737147381473914740147411474214743147441474514746147471474814749147501475114752147531475414755147561475714758147591476014761147621476314764147651476614767147681476914770147711477214773147741477514776147771477814779147801478114782147831478414785147861478714788147891479014791147921479314794147951479614797147981479914800148011480214803148041480514806148071480814809148101481114812148131481414815148161481714818148191482014821148221482314824148251482614827148281482914830148311483214833148341483514836148371483814839148401484114842148431484414845148461484714848148491485014851148521485314854148551485614857148581485914860148611486214863148641486514866148671486814869148701487114872148731487414875148761487714878148791488014881148821488314884148851488614887148881488914890148911489214893148941489514896148971489814899149001490114902149031490414905149061490714908149091491014911149121491314914149151491614917149181491914920149211492214923149241492514926149271492814929149301493114932149331493414935149361493714938149391494014941149421494314944149451494614947149481494914950149511495214953149541495514956149571495814959149601496114962149631496414965149661496714968149691497014971149721497314974149751497614977149781497914980149811498214983149841498514986149871498814989149901499114992149931499414995149961499714998149991500015001150021500315004150051500615007150081500915010150111501215013150141501515016150171501815019150201502115022150231502415025150261502715028150291503015031150321503315034150351503615037150381503915040150411504215043150441504515046150471504815049150501505115052150531505415055150561505715058150591506015061150621506315064150651506615067150681506915070150711507215073150741507515076150771507815079150801508115082150831508415085150861508715088150891509015091150921509315094150951509615097150981509915100151011510215103151041510515106151071510815109151101511115112151131511415115151161511715118151191512015121151221512315124151251512615127151281512915130151311513215133151341513515136151371513815139151401514115142151431514415145151461514715148151491515015151151521515315154151551515615157151581515915160151611516215163151641516515166151671516815169151701517115172151731517415175151761517715178151791518015181151821518315184151851518615187151881518915190151911519215193151941519515196151971519815199152001520115202152031520415205152061520715208152091521015211152121521315214152151521615217152181521915220152211522215223152241522515226152271522815229152301523115232152331523415235152361523715238152391524015241152421524315244152451524615247152481524915250152511525215253152541525515256152571525815259152601526115262152631526415265152661526715268152691527015271152721527315274152751527615277152781527915280152811528215283152841528515286152871528815289152901529115292152931529415295152961529715298152991530015301153021530315304153051530615307153081530915310153111531215313153141531515316153171531815319153201532115322153231532415325153261532715328153291533015331153321533315334153351533615337153381533915340153411534215343153441534515346153471534815349153501535115352153531535415355153561535715358153591536015361153621536315364153651536615367153681536915370153711537215373153741537515376153771537815379153801538115382153831538415385153861538715388153891539015391153921539315394153951539615397153981539915400154011540215403154041540515406154071540815409154101541115412154131541415415154161541715418154191542015421154221542315424154251542615427154281542915430154311543215433154341543515436154371543815439154401544115442154431544415445154461544715448154491545015451154521545315454154551545615457154581545915460154611546215463154641546515466154671546815469154701547115472154731547415475154761547715478154791548015481154821548315484154851548615487154881548915490154911549215493154941549515496154971549815499155001550115502155031550415505155061550715508155091551015511155121551315514155151551615517155181551915520155211552215523155241552515526155271552815529155301553115532155331553415535155361553715538155391554015541155421554315544155451554615547155481554915550155511555215553155541555515556155571555815559155601556115562155631556415565155661556715568155691557015571155721557315574155751557615577155781557915580155811558215583155841558515586155871558815589155901559115592155931559415595155961559715598155991560015601156021560315604156051560615607156081560915610156111561215613156141561515616156171561815619156201562115622156231562415625156261562715628156291563015631156321563315634156351563615637156381563915640156411564215643156441564515646156471564815649156501565115652156531565415655156561565715658156591566015661156621566315664156651566615667156681566915670156711567215673156741567515676156771567815679156801568115682156831568415685156861568715688156891569015691156921569315694156951569615697156981569915700157011570215703157041570515706157071570815709157101571115712157131571415715157161571715718157191572015721157221572315724157251572615727157281572915730157311573215733157341573515736157371573815739157401574115742157431574415745157461574715748157491575015751157521575315754157551575615757157581575915760157611576215763157641576515766157671576815769157701577115772157731577415775157761577715778157791578015781157821578315784157851578615787157881578915790157911579215793157941579515796157971579815799158001580115802158031580415805158061580715808158091581015811158121581315814158151581615817158181581915820158211582215823158241582515826158271582815829158301583115832158331583415835158361583715838158391584015841158421584315844158451584615847158481584915850158511585215853158541585515856158571585815859158601586115862158631586415865158661586715868158691587015871158721587315874158751587615877158781587915880158811588215883158841588515886158871588815889158901589115892158931589415895158961589715898158991590015901159021590315904159051590615907159081590915910159111591215913159141591515916159171591815919159201592115922159231592415925159261592715928159291593015931159321593315934159351593615937159381593915940159411594215943159441594515946159471594815949159501595115952159531595415955159561595715958159591596015961159621596315964159651596615967159681596915970159711597215973159741597515976159771597815979159801598115982159831598415985159861598715988159891599015991159921599315994159951599615997159981599916000160011600216003160041600516006160071600816009160101601116012160131601416015160161601716018160191602016021160221602316024160251602616027160281602916030160311603216033160341603516036160371603816039160401604116042160431604416045160461604716048160491605016051160521605316054160551605616057160581605916060160611606216063160641606516066160671606816069160701607116072160731607416075160761607716078160791608016081160821608316084160851608616087160881608916090160911609216093160941609516096160971609816099161001610116102161031610416105161061610716108161091611016111161121611316114161151611616117161181611916120161211612216123161241612516126161271612816129161301613116132161331613416135161361613716138161391614016141161421614316144161451614616147161481614916150161511615216153161541615516156161571615816159161601616116162161631616416165161661616716168161691617016171161721617316174161751617616177161781617916180161811618216183161841618516186161871618816189161901619116192161931619416195161961619716198161991620016201162021620316204162051620616207162081620916210162111621216213162141621516216162171621816219162201622116222162231622416225162261622716228162291623016231162321623316234162351623616237162381623916240162411624216243162441624516246162471624816249162501625116252162531625416255162561625716258162591626016261162621626316264162651626616267162681626916270162711627216273162741627516276162771627816279162801628116282162831628416285162861628716288162891629016291162921629316294162951629616297162981629916300163011630216303163041630516306163071630816309163101631116312163131631416315163161631716318163191632016321163221632316324163251632616327163281632916330163311633216333163341633516336163371633816339163401634116342163431634416345163461634716348163491635016351163521635316354163551635616357163581635916360163611636216363163641636516366163671636816369163701637116372163731637416375163761637716378163791638016381163821638316384163851638616387163881638916390163911639216393163941639516396163971639816399164001640116402164031640416405164061640716408164091641016411164121641316414164151641616417164181641916420164211642216423164241642516426164271642816429164301643116432164331643416435164361643716438164391644016441164421644316444164451644616447164481644916450164511645216453164541645516456164571645816459164601646116462164631646416465164661646716468164691647016471164721647316474164751647616477164781647916480164811648216483164841648516486164871648816489164901649116492164931649416495164961649716498164991650016501165021650316504165051650616507165081650916510165111651216513165141651516516165171651816519165201652116522165231652416525165261652716528165291653016531165321653316534165351653616537165381653916540165411654216543165441654516546165471654816549165501655116552165531655416555165561655716558165591656016561165621656316564165651656616567165681656916570165711657216573165741657516576165771657816579165801658116582165831658416585165861658716588165891659016591165921659316594165951659616597165981659916600166011660216603166041660516606166071660816609166101661116612166131661416615166161661716618166191662016621166221662316624166251662616627166281662916630166311663216633166341663516636166371663816639166401664116642166431664416645166461664716648166491665016651166521665316654166551665616657166581665916660166611666216663166641666516666166671666816669166701667116672166731667416675166761667716678166791668016681166821668316684166851668616687166881668916690166911669216693166941669516696166971669816699167001670116702167031670416705167061670716708167091671016711167121671316714167151671616717167181671916720167211672216723167241672516726167271672816729167301673116732167331673416735167361673716738167391674016741167421674316744167451674616747167481674916750167511675216753167541675516756167571675816759167601676116762167631676416765167661676716768167691677016771167721677316774167751677616777167781677916780167811678216783167841678516786167871678816789167901679116792167931679416795167961679716798167991680016801168021680316804168051680616807168081680916810168111681216813168141681516816168171681816819168201682116822168231682416825168261682716828168291683016831168321683316834168351683616837168381683916840168411684216843168441684516846168471684816849168501685116852168531685416855168561685716858168591686016861168621686316864168651686616867168681686916870168711687216873168741687516876168771687816879168801688116882168831688416885168861688716888168891689016891168921689316894168951689616897168981689916900169011690216903169041690516906169071690816909169101691116912169131691416915169161691716918169191692016921169221692316924169251692616927169281692916930169311693216933169341693516936169371693816939169401694116942169431694416945169461694716948169491695016951169521695316954169551695616957169581695916960169611696216963169641696516966169671696816969169701697116972169731697416975169761697716978169791698016981169821698316984169851698616987169881698916990169911699216993169941699516996169971699816999170001700117002170031700417005170061700717008170091701017011170121701317014170151701617017170181701917020170211702217023170241702517026170271702817029170301703117032170331703417035170361703717038170391704017041170421704317044170451704617047170481704917050170511705217053170541705517056170571705817059170601706117062170631706417065170661706717068170691707017071170721707317074170751707617077170781707917080170811708217083170841708517086170871708817089170901709117092170931709417095170961709717098170991710017101171021710317104171051710617107171081710917110171111711217113171141711517116171171711817119171201712117122171231712417125171261712717128171291713017131171321713317134171351713617137171381713917140171411714217143171441714517146171471714817149171501715117152171531715417155171561715717158171591716017161171621716317164171651716617167171681716917170171711717217173171741717517176171771717817179171801718117182171831718417185171861718717188171891719017191171921719317194171951719617197171981719917200172011720217203172041720517206172071720817209172101721117212172131721417215172161721717218172191722017221172221722317224172251722617227172281722917230172311723217233172341723517236172371723817239172401724117242172431724417245172461724717248172491725017251172521725317254172551725617257172581725917260172611726217263172641726517266172671726817269172701727117272172731727417275172761727717278172791728017281172821728317284172851728617287172881728917290172911729217293172941729517296172971729817299173001730117302173031730417305173061730717308173091731017311173121731317314173151731617317173181731917320173211732217323173241732517326173271732817329173301733117332173331733417335173361733717338173391734017341173421734317344173451734617347173481734917350173511735217353173541735517356173571735817359173601736117362173631736417365173661736717368173691737017371173721737317374173751737617377173781737917380173811738217383173841738517386173871738817389173901739117392173931739417395173961739717398173991740017401174021740317404174051740617407174081740917410174111741217413174141741517416174171741817419174201742117422174231742417425174261742717428174291743017431174321743317434174351743617437174381743917440174411744217443174441744517446174471744817449174501745117452174531745417455174561745717458174591746017461174621746317464174651746617467174681746917470174711747217473174741747517476174771747817479174801748117482174831748417485174861748717488174891749017491174921749317494174951749617497174981749917500175011750217503175041750517506175071750817509175101751117512175131751417515175161751717518175191752017521175221752317524175251752617527175281752917530175311753217533175341753517536175371753817539175401754117542175431754417545175461754717548175491755017551175521755317554175551755617557175581755917560175611756217563175641756517566175671756817569175701757117572175731757417575175761757717578175791758017581175821758317584175851758617587175881758917590175911759217593175941759517596175971759817599176001760117602176031760417605176061760717608176091761017611176121761317614176151761617617176181761917620176211762217623176241762517626176271762817629176301763117632176331763417635176361763717638176391764017641176421764317644176451764617647176481764917650176511765217653176541765517656176571765817659176601766117662176631766417665176661766717668176691767017671176721767317674176751767617677176781767917680176811768217683176841768517686176871768817689176901769117692176931769417695176961769717698176991770017701177021770317704177051770617707177081770917710177111771217713177141771517716177171771817719177201772117722177231772417725177261772717728177291773017731177321773317734177351773617737177381773917740177411774217743177441774517746177471774817749177501775117752177531775417755177561775717758177591776017761177621776317764177651776617767177681776917770177711777217773177741777517776177771777817779177801778117782177831778417785177861778717788177891779017791177921779317794177951779617797177981779917800178011780217803178041780517806178071780817809178101781117812178131781417815178161781717818178191782017821178221782317824178251782617827178281782917830178311783217833178341783517836178371783817839178401784117842178431784417845178461784717848178491785017851178521785317854178551785617857178581785917860178611786217863178641786517866178671786817869178701787117872178731787417875178761787717878178791788017881178821788317884178851788617887178881788917890178911789217893178941789517896178971789817899179001790117902179031790417905179061790717908179091791017911179121791317914179151791617917179181791917920179211792217923179241792517926179271792817929179301793117932179331793417935179361793717938179391794017941179421794317944179451794617947179481794917950179511795217953179541795517956179571795817959179601796117962179631796417965179661796717968179691797017971179721797317974179751797617977179781797917980179811798217983179841798517986179871798817989179901799117992179931799417995179961799717998179991800018001180021800318004180051800618007180081800918010180111801218013180141801518016180171801818019180201802118022180231802418025180261802718028180291803018031180321803318034180351803618037180381803918040180411804218043180441804518046180471804818049180501805118052180531805418055180561805718058180591806018061180621806318064180651806618067180681806918070180711807218073180741807518076180771807818079180801808118082180831808418085180861808718088180891809018091180921809318094180951809618097180981809918100181011810218103181041810518106181071810818109181101811118112181131811418115181161811718118181191812018121181221812318124181251812618127181281812918130181311813218133181341813518136181371813818139181401814118142181431814418145181461814718148181491815018151181521815318154181551815618157181581815918160181611816218163181641816518166181671816818169181701817118172181731817418175181761817718178181791818018181181821818318184181851818618187181881818918190181911819218193181941819518196181971819818199182001820118202182031820418205182061820718208182091821018211182121821318214182151821618217182181821918220182211822218223182241822518226182271822818229182301823118232182331823418235182361823718238182391824018241182421824318244182451824618247182481824918250182511825218253182541825518256182571825818259182601826118262182631826418265182661826718268182691827018271182721827318274182751827618277182781827918280182811828218283182841828518286182871828818289182901829118292182931829418295182961829718298182991830018301183021830318304183051830618307183081830918310183111831218313183141831518316183171831818319183201832118322183231832418325183261832718328183291833018331183321833318334183351833618337183381833918340183411834218343183441834518346183471834818349183501835118352183531835418355183561835718358183591836018361183621836318364183651836618367183681836918370183711837218373183741837518376183771837818379183801838118382183831838418385183861838718388183891839018391183921839318394183951839618397183981839918400184011840218403184041840518406184071840818409184101841118412184131841418415184161841718418184191842018421184221842318424184251842618427184281842918430184311843218433184341843518436184371843818439184401844118442184431844418445184461844718448184491845018451184521845318454184551845618457184581845918460184611846218463184641846518466184671846818469184701847118472184731847418475184761847718478184791848018481184821848318484184851848618487184881848918490184911849218493184941849518496184971849818499185001850118502185031850418505185061850718508185091851018511185121851318514185151851618517185181851918520185211852218523185241852518526185271852818529185301853118532185331853418535185361853718538185391854018541185421854318544185451854618547185481854918550185511855218553185541855518556185571855818559185601856118562185631856418565185661856718568185691857018571185721857318574185751857618577185781857918580185811858218583185841858518586185871858818589185901859118592185931859418595185961859718598185991860018601186021860318604186051860618607186081860918610186111861218613186141861518616186171861818619186201862118622186231862418625186261862718628186291863018631186321863318634186351863618637186381863918640186411864218643186441864518646186471864818649186501865118652186531865418655186561865718658186591866018661186621866318664186651866618667186681866918670186711867218673186741867518676186771867818679186801868118682186831868418685186861868718688186891869018691186921869318694186951869618697186981869918700187011870218703187041870518706187071870818709187101871118712187131871418715187161871718718187191872018721187221872318724187251872618727187281872918730187311873218733187341873518736187371873818739187401874118742187431874418745187461874718748187491875018751187521875318754187551875618757187581875918760187611876218763187641876518766187671876818769187701877118772187731877418775187761877718778187791878018781187821878318784187851878618787187881878918790187911879218793187941879518796187971879818799188001880118802188031880418805188061880718808188091881018811188121881318814188151881618817188181881918820188211882218823188241882518826188271882818829188301883118832188331883418835188361883718838188391884018841188421884318844188451884618847188481884918850188511885218853188541885518856188571885818859188601886118862188631886418865188661886718868188691887018871188721887318874188751887618877188781887918880188811888218883188841888518886188871888818889188901889118892188931889418895188961889718898188991890018901189021890318904189051890618907189081890918910189111891218913189141891518916189171891818919189201892118922189231892418925189261892718928189291893018931189321893318934189351893618937189381893918940189411894218943189441894518946189471894818949189501895118952189531895418955189561895718958189591896018961189621896318964189651896618967189681896918970189711897218973189741897518976189771897818979189801898118982189831898418985189861898718988189891899018991189921899318994189951899618997189981899919000190011900219003190041900519006190071900819009190101901119012190131901419015190161901719018190191902019021190221902319024190251902619027190281902919030190311903219033190341903519036190371903819039190401904119042190431904419045190461904719048190491905019051190521905319054190551905619057190581905919060190611906219063190641906519066190671906819069190701907119072190731907419075190761907719078190791908019081190821908319084190851908619087190881908919090190911909219093190941909519096190971909819099191001910119102191031910419105191061910719108191091911019111191121911319114191151911619117191181911919120191211912219123191241912519126191271912819129191301913119132191331913419135191361913719138191391914019141191421914319144191451914619147191481914919150191511915219153191541915519156191571915819159191601916119162191631916419165191661916719168191691917019171191721917319174191751917619177191781917919180191811918219183191841918519186191871918819189191901919119192191931919419195191961919719198191991920019201192021920319204192051920619207192081920919210192111921219213192141921519216192171921819219192201922119222192231922419225192261922719228192291923019231192321923319234192351923619237192381923919240192411924219243192441924519246192471924819249192501925119252192531925419255192561925719258192591926019261192621926319264192651926619267192681926919270192711927219273192741927519276192771927819279192801928119282192831928419285192861928719288192891929019291192921929319294192951929619297192981929919300193011930219303193041930519306193071930819309193101931119312193131931419315193161931719318193191932019321193221932319324193251932619327193281932919330193311933219333193341933519336193371933819339193401934119342193431934419345193461934719348193491935019351193521935319354193551935619357193581935919360193611936219363193641936519366193671936819369193701937119372193731937419375193761937719378193791938019381193821938319384193851938619387193881938919390193911939219393193941939519396193971939819399194001940119402194031940419405194061940719408194091941019411194121941319414194151941619417194181941919420194211942219423194241942519426194271942819429194301943119432194331943419435194361943719438194391944019441194421944319444194451944619447194481944919450194511945219453194541945519456194571945819459194601946119462194631946419465194661946719468194691947019471194721947319474194751947619477194781947919480194811948219483194841948519486194871948819489194901949119492194931949419495194961949719498194991950019501195021950319504195051950619507195081950919510195111951219513195141951519516195171951819519195201952119522195231952419525195261952719528195291953019531195321953319534195351953619537195381953919540195411954219543195441954519546195471954819549195501955119552195531955419555195561955719558195591956019561195621956319564195651956619567195681956919570195711957219573195741957519576195771957819579195801958119582195831958419585195861958719588195891959019591195921959319594195951959619597195981959919600196011960219603196041960519606196071960819609196101961119612196131961419615196161961719618196191962019621196221962319624196251962619627196281962919630196311963219633196341963519636196371963819639196401964119642196431964419645196461964719648196491965019651196521965319654196551965619657196581965919660196611966219663196641966519666196671966819669196701967119672196731967419675196761967719678196791968019681196821968319684196851968619687196881968919690196911969219693196941969519696196971969819699197001970119702197031970419705197061970719708197091971019711197121971319714197151971619717197181971919720197211972219723197241972519726197271972819729197301973119732197331973419735197361973719738197391974019741197421974319744197451974619747197481974919750197511975219753197541975519756197571975819759197601976119762197631976419765197661976719768197691977019771197721977319774197751977619777197781977919780197811978219783197841978519786197871978819789197901979119792197931979419795197961979719798197991980019801198021980319804198051980619807198081980919810198111981219813198141981519816198171981819819198201982119822198231982419825198261982719828198291983019831198321983319834198351983619837198381983919840198411984219843198441984519846198471984819849198501985119852198531985419855198561985719858198591986019861198621986319864198651986619867198681986919870198711987219873198741987519876198771987819879198801988119882198831988419885198861988719888198891989019891198921989319894198951989619897198981989919900199011990219903199041990519906199071990819909199101991119912199131991419915199161991719918199191992019921199221992319924199251992619927199281992919930199311993219933199341993519936199371993819939199401994119942199431994419945199461994719948199491995019951199521995319954199551995619957199581995919960199611996219963199641996519966199671996819969199701997119972199731997419975199761997719978199791998019981199821998319984199851998619987199881998919990199911999219993199941999519996199971999819999200002000120002200032000420005200062000720008200092001020011200122001320014200152001620017200182001920020200212002220023200242002520026200272002820029200302003120032200332003420035200362003720038200392004020041200422004320044200452004620047200482004920050200512005220053200542005520056200572005820059200602006120062200632006420065200662006720068200692007020071200722007320074200752007620077200782007920080200812008220083200842008520086200872008820089200902009120092200932009420095200962009720098200992010020101201022010320104201052010620107201082010920110201112011220113201142011520116201172011820119201202012120122201232012420125201262012720128201292013020131201322013320134201352013620137201382013920140201412014220143201442014520146201472014820149201502015120152201532015420155201562015720158201592016020161201622016320164201652016620167201682016920170201712017220173201742017520176201772017820179201802018120182201832018420185201862018720188201892019020191201922019320194201952019620197201982019920200202012020220203202042020520206202072020820209202102021120212202132021420215202162021720218202192022020221202222022320224202252022620227202282022920230202312023220233202342023520236202372023820239202402024120242202432024420245202462024720248202492025020251202522025320254202552025620257202582025920260202612026220263202642026520266202672026820269202702027120272202732027420275202762027720278202792028020281202822028320284202852028620287202882028920290202912029220293202942029520296202972029820299203002030120302203032030420305203062030720308203092031020311203122031320314203152031620317203182031920320203212032220323203242032520326203272032820329203302033120332203332033420335203362033720338203392034020341203422034320344203452034620347203482034920350203512035220353203542035520356203572035820359203602036120362203632036420365203662036720368203692037020371203722037320374203752037620377203782037920380203812038220383203842038520386203872038820389203902039120392203932039420395203962039720398203992040020401204022040320404204052040620407204082040920410204112041220413204142041520416204172041820419204202042120422204232042420425204262042720428204292043020431204322043320434204352043620437204382043920440204412044220443204442044520446204472044820449204502045120452204532045420455204562045720458204592046020461204622046320464204652046620467204682046920470204712047220473204742047520476204772047820479204802048120482204832048420485204862048720488204892049020491204922049320494204952049620497204982049920500205012050220503205042050520506205072050820509205102051120512205132051420515205162051720518205192052020521205222052320524205252052620527205282052920530205312053220533205342053520536205372053820539205402054120542205432054420545205462054720548205492055020551205522055320554205552055620557205582055920560205612056220563205642056520566205672056820569205702057120572205732057420575205762057720578205792058020581205822058320584205852058620587205882058920590205912059220593205942059520596205972059820599206002060120602206032060420605206062060720608206092061020611206122061320614206152061620617206182061920620206212062220623206242062520626206272062820629206302063120632206332063420635206362063720638206392064020641206422064320644206452064620647206482064920650206512065220653206542065520656206572065820659206602066120662206632066420665206662066720668206692067020671206722067320674206752067620677206782067920680206812068220683206842068520686206872068820689206902069120692206932069420695206962069720698206992070020701207022070320704207052070620707207082070920710207112071220713207142071520716207172071820719207202072120722207232072420725207262072720728207292073020731207322073320734207352073620737207382073920740207412074220743207442074520746207472074820749207502075120752207532075420755207562075720758207592076020761207622076320764207652076620767207682076920770207712077220773207742077520776207772077820779207802078120782207832078420785207862078720788207892079020791207922079320794207952079620797207982079920800208012080220803208042080520806208072080820809208102081120812208132081420815208162081720818208192082020821208222082320824208252082620827208282082920830208312083220833208342083520836208372083820839208402084120842208432084420845208462084720848208492085020851208522085320854208552085620857208582085920860208612086220863208642086520866208672086820869208702087120872208732087420875208762087720878208792088020881208822088320884208852088620887208882088920890208912089220893208942089520896208972089820899209002090120902209032090420905209062090720908209092091020911209122091320914209152091620917209182091920920209212092220923209242092520926209272092820929209302093120932209332093420935209362093720938209392094020941209422094320944209452094620947209482094920950209512095220953209542095520956209572095820959209602096120962209632096420965209662096720968209692097020971209722097320974209752097620977209782097920980209812098220983209842098520986209872098820989209902099120992209932099420995209962099720998209992100021001210022100321004210052100621007210082100921010210112101221013210142101521016210172101821019210202102121022210232102421025210262102721028210292103021031210322103321034210352103621037210382103921040210412104221043210442104521046210472104821049210502105121052210532105421055210562105721058210592106021061210622106321064210652106621067210682106921070210712107221073210742107521076210772107821079210802108121082210832108421085210862108721088210892109021091210922109321094210952109621097210982109921100211012110221103211042110521106211072110821109211102111121112211132111421115211162111721118211192112021121211222112321124211252112621127211282112921130211312113221133211342113521136211372113821139211402114121142211432114421145211462114721148211492115021151211522115321154211552115621157211582115921160211612116221163211642116521166211672116821169211702117121172211732117421175211762117721178211792118021181211822118321184211852118621187211882118921190211912119221193211942119521196211972119821199212002120121202212032120421205212062120721208212092121021211212122121321214212152121621217212182121921220212212122221223212242122521226212272122821229212302123121232212332123421235212362123721238212392124021241212422124321244212452124621247212482124921250212512125221253212542125521256212572125821259212602126121262212632126421265212662126721268212692127021271212722127321274212752127621277212782127921280212812128221283212842128521286212872128821289212902129121292212932129421295212962129721298212992130021301213022130321304213052130621307213082130921310213112131221313213142131521316213172131821319213202132121322213232132421325213262132721328213292133021331213322133321334213352133621337213382133921340213412134221343213442134521346213472134821349213502135121352213532135421355213562135721358213592136021361213622136321364213652136621367213682136921370213712137221373213742137521376213772137821379213802138121382213832138421385213862138721388213892139021391213922139321394213952139621397213982139921400214012140221403214042140521406214072140821409214102141121412214132141421415214162141721418214192142021421214222142321424214252142621427214282142921430214312143221433214342143521436214372143821439214402144121442214432144421445214462144721448214492145021451214522145321454214552145621457214582145921460214612146221463214642146521466214672146821469214702147121472214732147421475214762147721478214792148021481214822148321484214852148621487214882148921490214912149221493214942149521496214972149821499215002150121502215032150421505215062150721508215092151021511215122151321514215152151621517215182151921520215212152221523215242152521526215272152821529215302153121532215332153421535215362153721538215392154021541215422154321544215452154621547215482154921550215512155221553215542155521556215572155821559215602156121562215632156421565215662156721568215692157021571215722157321574215752157621577215782157921580215812158221583215842158521586215872158821589215902159121592215932159421595215962159721598215992160021601216022160321604216052160621607216082160921610216112161221613216142161521616216172161821619216202162121622216232162421625216262162721628216292163021631216322163321634216352163621637216382163921640216412164221643216442164521646216472164821649216502165121652216532165421655216562165721658216592166021661216622166321664216652166621667216682166921670216712167221673216742167521676216772167821679216802168121682216832168421685216862168721688216892169021691216922169321694216952169621697216982169921700217012170221703217042170521706217072170821709217102171121712217132171421715217162171721718217192172021721217222172321724217252172621727217282172921730217312173221733217342173521736217372173821739217402174121742217432174421745217462174721748217492175021751217522175321754217552175621757217582175921760217612176221763217642176521766217672176821769217702177121772217732177421775217762177721778217792178021781217822178321784217852178621787217882178921790217912179221793217942179521796217972179821799218002180121802218032180421805218062180721808218092181021811218122181321814218152181621817218182181921820218212182221823218242182521826218272182821829218302183121832218332183421835218362183721838218392184021841218422184321844218452184621847218482184921850218512185221853218542185521856218572185821859218602186121862218632186421865218662186721868218692187021871218722187321874218752187621877218782187921880218812188221883218842188521886218872188821889218902189121892218932189421895218962189721898218992190021901219022190321904219052190621907219082190921910219112191221913219142191521916219172191821919219202192121922219232192421925219262192721928219292193021931219322193321934219352193621937219382193921940219412194221943219442194521946219472194821949219502195121952219532195421955219562195721958219592196021961219622196321964219652196621967219682196921970219712197221973219742197521976219772197821979219802198121982219832198421985219862198721988219892199021991219922199321994219952199621997219982199922000220012200222003220042200522006220072200822009220102201122012220132201422015220162201722018220192202022021220222202322024220252202622027220282202922030220312203222033220342203522036220372203822039220402204122042220432204422045220462204722048220492205022051220522205322054220552205622057220582205922060220612206222063220642206522066220672206822069220702207122072220732207422075220762207722078220792208022081220822208322084220852208622087220882208922090220912209222093220942209522096220972209822099221002210122102221032210422105221062210722108221092211022111221122211322114221152211622117221182211922120221212212222123221242212522126221272212822129221302213122132221332213422135221362213722138221392214022141221422214322144221452214622147221482214922150221512215222153221542215522156221572215822159221602216122162221632216422165221662216722168221692217022171221722217322174221752217622177221782217922180221812218222183221842218522186221872218822189221902219122192221932219422195221962219722198221992220022201222022220322204222052220622207222082220922210222112221222213222142221522216222172221822219222202222122222222232222422225222262222722228222292223022231222322223322234222352223622237222382223922240222412224222243222442224522246222472224822249222502225122252222532225422255222562225722258222592226022261222622226322264222652226622267222682226922270222712227222273222742227522276222772227822279222802228122282222832228422285222862228722288222892229022291222922229322294222952229622297222982229922300223012230222303223042230522306223072230822309223102231122312223132231422315223162231722318223192232022321223222232322324223252232622327223282232922330223312233222333223342233522336223372233822339223402234122342223432234422345223462234722348223492235022351223522235322354223552235622357223582235922360223612236222363223642236522366223672236822369223702237122372223732237422375223762237722378223792238022381223822238322384223852238622387223882238922390223912239222393223942239522396223972239822399224002240122402224032240422405224062240722408224092241022411224122241322414224152241622417224182241922420224212242222423224242242522426224272242822429224302243122432224332243422435224362243722438224392244022441224422244322444224452244622447224482244922450224512245222453224542245522456224572245822459224602246122462224632246422465224662246722468224692247022471224722247322474224752247622477224782247922480224812248222483224842248522486224872248822489224902249122492224932249422495224962249722498224992250022501225022250322504225052250622507225082250922510225112251222513225142251522516225172251822519225202252122522225232252422525225262252722528225292253022531225322253322534225352253622537225382253922540225412254222543225442254522546225472254822549225502255122552225532255422555225562255722558225592256022561225622256322564225652256622567225682256922570225712257222573225742257522576225772257822579225802258122582225832258422585225862258722588225892259022591225922259322594225952259622597225982259922600226012260222603226042260522606226072260822609226102261122612226132261422615226162261722618226192262022621226222262322624226252262622627226282262922630226312263222633226342263522636226372263822639226402264122642226432264422645226462264722648226492265022651226522265322654226552265622657226582265922660226612266222663226642266522666226672266822669226702267122672226732267422675226762267722678226792268022681226822268322684226852268622687226882268922690226912269222693226942269522696226972269822699227002270122702227032270422705227062270722708227092271022711227122271322714227152271622717227182271922720227212272222723227242272522726227272272822729227302273122732227332273422735227362273722738227392274022741227422274322744227452274622747227482274922750227512275222753227542275522756227572275822759227602276122762227632276422765227662276722768227692277022771227722277322774227752277622777227782277922780227812278222783227842278522786227872278822789227902279122792227932279422795227962279722798227992280022801228022280322804228052280622807228082280922810228112281222813228142281522816228172281822819228202282122822228232282422825228262282722828228292283022831228322283322834228352283622837228382283922840228412284222843228442284522846228472284822849228502285122852228532285422855228562285722858228592286022861228622286322864228652286622867228682286922870228712287222873228742287522876228772287822879228802288122882228832288422885228862288722888228892289022891228922289322894228952289622897228982289922900229012290222903229042290522906229072290822909229102291122912229132291422915229162291722918229192292022921229222292322924229252292622927229282292922930229312293222933229342293522936229372293822939229402294122942229432294422945229462294722948229492295022951229522295322954229552295622957229582295922960229612296222963229642296522966229672296822969229702297122972229732297422975229762297722978229792298022981229822298322984229852298622987229882298922990229912299222993229942299522996229972299822999230002300123002230032300423005230062300723008230092301023011230122301323014230152301623017230182301923020230212302223023230242302523026230272302823029230302303123032230332303423035230362303723038230392304023041230422304323044230452304623047230482304923050230512305223053230542305523056230572305823059230602306123062230632306423065230662306723068230692307023071230722307323074230752307623077230782307923080230812308223083230842308523086230872308823089230902309123092230932309423095230962309723098230992310023101231022310323104231052310623107231082310923110231112311223113231142311523116231172311823119231202312123122231232312423125231262312723128231292313023131231322313323134231352313623137231382313923140231412314223143231442314523146231472314823149231502315123152231532315423155231562315723158231592316023161231622316323164231652316623167231682316923170231712317223173231742317523176231772317823179231802318123182231832318423185231862318723188231892319023191231922319323194231952319623197231982319923200232012320223203232042320523206232072320823209232102321123212232132321423215232162321723218232192322023221232222322323224232252322623227232282322923230232312323223233232342323523236232372323823239232402324123242232432324423245232462324723248232492325023251232522325323254232552325623257232582325923260232612326223263232642326523266232672326823269232702327123272232732327423275232762327723278232792328023281232822328323284232852328623287232882328923290232912329223293232942329523296232972329823299233002330123302233032330423305233062330723308233092331023311233122331323314233152331623317233182331923320233212332223323233242332523326233272332823329233302333123332233332333423335233362333723338233392334023341233422334323344233452334623347233482334923350233512335223353233542335523356233572335823359233602336123362233632336423365233662336723368233692337023371233722337323374233752337623377233782337923380233812338223383233842338523386233872338823389233902339123392233932339423395233962339723398233992340023401234022340323404234052340623407234082340923410234112341223413234142341523416234172341823419234202342123422234232342423425234262342723428234292343023431234322343323434234352343623437234382343923440234412344223443234442344523446234472344823449234502345123452234532345423455234562345723458234592346023461234622346323464234652346623467234682346923470234712347223473234742347523476234772347823479234802348123482234832348423485234862348723488234892349023491234922349323494234952349623497234982349923500235012350223503235042350523506235072350823509235102351123512235132351423515235162351723518235192352023521235222352323524235252352623527235282352923530235312353223533235342353523536235372353823539235402354123542235432354423545235462354723548235492355023551235522355323554235552355623557235582355923560235612356223563235642356523566235672356823569235702357123572235732357423575235762357723578235792358023581235822358323584235852358623587235882358923590235912359223593235942359523596235972359823599236002360123602236032360423605236062360723608236092361023611236122361323614236152361623617236182361923620236212362223623236242362523626236272362823629236302363123632236332363423635236362363723638236392364023641236422364323644236452364623647236482364923650236512365223653236542365523656236572365823659236602366123662236632366423665236662366723668236692367023671236722367323674236752367623677236782367923680236812368223683236842368523686236872368823689236902369123692236932369423695236962369723698236992370023701237022370323704237052370623707237082370923710237112371223713237142371523716237172371823719237202372123722237232372423725237262372723728237292373023731237322373323734237352373623737237382373923740237412374223743237442374523746237472374823749237502375123752237532375423755237562375723758237592376023761237622376323764237652376623767237682376923770237712377223773237742377523776237772377823779237802378123782237832378423785237862378723788237892379023791237922379323794237952379623797237982379923800238012380223803238042380523806238072380823809238102381123812238132381423815238162381723818238192382023821238222382323824238252382623827238282382923830238312383223833238342383523836238372383823839238402384123842238432384423845238462384723848238492385023851238522385323854238552385623857238582385923860238612386223863238642386523866238672386823869238702387123872238732387423875238762387723878238792388023881238822388323884238852388623887238882388923890238912389223893238942389523896238972389823899239002390123902239032390423905239062390723908239092391023911239122391323914239152391623917239182391923920239212392223923239242392523926239272392823929239302393123932239332393423935239362393723938239392394023941239422394323944239452394623947239482394923950239512395223953239542395523956239572395823959239602396123962239632396423965239662396723968239692397023971239722397323974239752397623977239782397923980239812398223983239842398523986239872398823989239902399123992239932399423995239962399723998239992400024001240022400324004240052400624007240082400924010240112401224013240142401524016240172401824019240202402124022240232402424025240262402724028240292403024031240322403324034240352403624037240382403924040240412404224043240442404524046240472404824049240502405124052240532405424055240562405724058240592406024061240622406324064240652406624067240682406924070240712407224073240742407524076240772407824079240802408124082240832408424085240862408724088240892409024091240922409324094240952409624097240982409924100241012410224103241042410524106241072410824109241102411124112241132411424115241162411724118241192412024121241222412324124241252412624127241282412924130241312413224133241342413524136241372413824139241402414124142241432414424145241462414724148241492415024151241522415324154241552415624157241582415924160241612416224163241642416524166241672416824169241702417124172241732417424175241762417724178241792418024181241822418324184241852418624187241882418924190241912419224193241942419524196241972419824199242002420124202242032420424205242062420724208242092421024211242122421324214242152421624217242182421924220242212422224223242242422524226242272422824229242302423124232242332423424235242362423724238242392424024241242422424324244242452424624247242482424924250242512425224253242542425524256242572425824259242602426124262242632426424265242662426724268242692427024271242722427324274242752427624277242782427924280242812428224283242842428524286242872428824289242902429124292242932429424295242962429724298242992430024301243022430324304243052430624307243082430924310243112431224313243142431524316243172431824319243202432124322243232432424325243262432724328243292433024331243322433324334243352433624337243382433924340243412434224343243442434524346243472434824349243502435124352243532435424355243562435724358243592436024361243622436324364243652436624367243682436924370243712437224373243742437524376243772437824379243802438124382243832438424385243862438724388243892439024391243922439324394243952439624397243982439924400244012440224403244042440524406244072440824409244102441124412244132441424415244162441724418244192442024421244222442324424244252442624427244282442924430244312443224433244342443524436244372443824439244402444124442244432444424445244462444724448244492445024451244522445324454244552445624457244582445924460244612446224463244642446524466244672446824469244702447124472244732447424475244762447724478244792448024481244822448324484244852448624487244882448924490244912449224493244942449524496244972449824499245002450124502245032450424505245062450724508245092451024511245122451324514245152451624517245182451924520245212452224523245242452524526245272452824529245302453124532245332453424535245362453724538245392454024541245422454324544245452454624547245482454924550245512455224553245542455524556245572455824559245602456124562245632456424565245662456724568245692457024571245722457324574245752457624577245782457924580245812458224583245842458524586245872458824589245902459124592245932459424595245962459724598245992460024601246022460324604246052460624607246082460924610246112461224613246142461524616246172461824619246202462124622246232462424625246262462724628246292463024631246322463324634246352463624637246382463924640246412464224643246442464524646246472464824649246502465124652246532465424655246562465724658246592466024661246622466324664
  1. <?xml version="1.0" standalone="yes"?>
  2. <library-reference id="header_reference"><title>Header Reference</title><header name="boost/compute/algorithm/accumulate.hpp">
  3. <namespace name="boost">
  4. <namespace name="compute">
  5. <overloaded-function name="accumulate"><signature><type>T</type><template>
  6. <template-type-parameter name="InputIterator"/>
  7. <template-type-parameter name="T"/>
  8. <template-type-parameter name="BinaryFunction"/>
  9. </template><parameter name="first"><paramtype>InputIterator</paramtype><description><para>first element in the input range </para></description></parameter><parameter name="last"><paramtype>InputIterator</paramtype><description><para>last element in the input range </para></description></parameter><parameter name="init"><paramtype>T</paramtype><description><para>initial value </para></description></parameter><parameter name="function"><paramtype>BinaryFunction</paramtype><description><para>binary reduction function </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>command queue to perform the operation</para></description></parameter></signature><signature><type>T</type><template>
  10. <template-type-parameter name="InputIterator"/>
  11. <template-type-parameter name="T"/>
  12. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="init"><paramtype>T</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Returns the result of applying <computeroutput>function</computeroutput> to the elements in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) and <computeroutput>init</computeroutput>.</para><para>If no function is specified, <computeroutput>plus</computeroutput> will be used.</para><para>
  13. In specific situations the call to <computeroutput>accumulate()</computeroutput> can be automatically optimized to a call to the more efficient <computeroutput>reduce()</computeroutput> algorithm. This occurs when the binary reduction function is recognized as associative (such as the <computeroutput>plus&lt;int&gt;</computeroutput> function).</para><para>Note that because floating-point addition is not associative, calling <computeroutput>accumulate()</computeroutput> with <computeroutput>plus&lt;float&gt;</computeroutput> results in a less efficient serial reduction algorithm being executed. If a slight loss in precision is acceptable, the more efficient parallel <computeroutput>reduce()</computeroutput> algorithm should be used instead.</para><para>For example: <programlisting language="c++">// with vec = boost::compute::vector&lt;int&gt;
  14. accumulate(vec.begin(), vec.end(), 0, plus&lt;int&gt;()); // fast
  15. reduce(vec.begin(), vec.end(), &amp;result, plus&lt;int&gt;()); // fast
  16. // with vec = boost::compute::vector&lt;float&gt;
  17. accumulate(vec.begin(), vec.end(), 0, plus&lt;float&gt;()); // slow
  18. reduce(vec.begin(), vec.end(), &amp;result, plus&lt;float&gt;()); // fast
  19. </programlisting></para><para>Space complexity: \Omega(1)<sbr/>
  20. Space complexity when optimized to <computeroutput>reduce()</computeroutput>: \Omega(n)</para><para><para><emphasis role="bold">See Also:</emphasis><para>reduce() </para>
  21. </para>
  22. </para></description><returns><para>the accumulated result value</para>
  23. </returns></overloaded-function>
  24. </namespace>
  25. </namespace>
  26. </header>
  27. <header name="boost/compute/algorithm/adjacent_difference.hpp">
  28. <namespace name="boost">
  29. <namespace name="compute">
  30. <overloaded-function name="adjacent_difference"><signature><type>OutputIterator</type><template>
  31. <template-type-parameter name="InputIterator"/>
  32. <template-type-parameter name="OutputIterator"/>
  33. <template-type-parameter name="BinaryFunction"/>
  34. </template><parameter name="first"><paramtype>InputIterator</paramtype><description><para>first element in the input range </para></description></parameter><parameter name="last"><paramtype>InputIterator</paramtype><description><para>last element in the input range </para></description></parameter><parameter name="result"><paramtype>OutputIterator</paramtype><description><para>first element in the output range </para></description></parameter><parameter name="op"><paramtype>BinaryFunction</paramtype><description><para>binary difference function </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>command queue to perform the operation</para></description></parameter></signature><signature><type>OutputIterator</type><template>
  35. <template-type-parameter name="InputIterator"/>
  36. <template-type-parameter name="OutputIterator"/>
  37. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Stores the difference of each pair of consecutive values in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) to the range beginning at <computeroutput>result</computeroutput>. If <computeroutput>op</computeroutput> is not provided, <computeroutput>minus&lt;T&gt;</computeroutput> is used.</para><para>
  38. Space complexity: \Omega(1)<sbr/>
  39. Space complexity when <computeroutput>result</computeroutput> == <computeroutput>first:</computeroutput> \Omega(n)</para><para><para><emphasis role="bold">See Also:</emphasis><para>adjacent_find() </para>
  40. </para>
  41. </para></description><returns><para><computeroutput>OutputIterator</computeroutput> to the end of the result range</para>
  42. </returns></overloaded-function>
  43. </namespace>
  44. </namespace>
  45. </header>
  46. <header name="boost/compute/algorithm/adjacent_find.hpp">
  47. <namespace name="boost">
  48. <namespace name="compute">
  49. <overloaded-function name="adjacent_find"><signature><type>InputIterator</type><template>
  50. <template-type-parameter name="InputIterator"/>
  51. <template-type-parameter name="Compare"/>
  52. </template><parameter name="first"><paramtype>InputIterator</paramtype><description><para>first element in the range to search </para></description></parameter><parameter name="last"><paramtype>InputIterator</paramtype><description><para>last element in the range to search </para></description></parameter><parameter name="compare"><paramtype>Compare</paramtype><description><para>binary comparison function </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>command queue to perform the operation</para></description></parameter></signature><signature><type>InputIterator</type><template>
  53. <template-type-parameter name="InputIterator"/>
  54. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Searches the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) for two identical adjacent elements and returns an iterator pointing to the first.</para><para>
  55. Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>find(), adjacent_difference() </para>
  56. </para>
  57. </para></description><returns><para><computeroutput>InputIteratorm</computeroutput> to the first element which compares equal to the following element. If none are equal, returns <computeroutput>last</computeroutput>.</para>
  58. </returns></overloaded-function>
  59. </namespace>
  60. </namespace>
  61. </header>
  62. <header name="boost/compute/algorithm/all_of.hpp">
  63. <namespace name="boost">
  64. <namespace name="compute">
  65. <function name="all_of"><type>bool</type><template>
  66. <template-type-parameter name="InputIterator"/>
  67. <template-type-parameter name="UnaryPredicate"/>
  68. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="predicate"><paramtype>UnaryPredicate</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Returns <computeroutput>true</computeroutput> if <computeroutput>predicate</computeroutput> returns <computeroutput>true</computeroutput> for all of the elements in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>).</para><para>Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>any_of(), none_of() </para>
  69. </para>
  70. </para></description></function>
  71. </namespace>
  72. </namespace>
  73. </header>
  74. <header name="boost/compute/algorithm/any_of.hpp">
  75. <namespace name="boost">
  76. <namespace name="compute">
  77. <function name="any_of"><type>bool</type><template>
  78. <template-type-parameter name="InputIterator"/>
  79. <template-type-parameter name="UnaryPredicate"/>
  80. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="predicate"><paramtype>UnaryPredicate</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Returns <computeroutput>true</computeroutput> if <computeroutput>predicate</computeroutput> returns <computeroutput>true</computeroutput> for any of the elements in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>).</para><para>For example, to test if a vector contains any negative values:</para><para><programlisting language="c++"/> Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>all_of(), none_of() </para>
  81. </para>
  82. </para></description></function>
  83. </namespace>
  84. </namespace>
  85. </header>
  86. <header name="boost/compute/algorithm/binary_search.hpp">
  87. <namespace name="boost">
  88. <namespace name="compute">
  89. <function name="binary_search"><type>bool</type><template>
  90. <template-type-parameter name="InputIterator"/>
  91. <template-type-parameter name="T"/>
  92. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="value"><paramtype>const T &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Returns <computeroutput>true</computeroutput> if <computeroutput>value</computeroutput> is in the sorted range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>).</para><para>Space complexity: \Omega(1) </para></description></function>
  93. </namespace>
  94. </namespace>
  95. </header>
  96. <header name="boost/compute/algorithm/copy.hpp">
  97. <namespace name="boost">
  98. <namespace name="compute">
  99. <function name="copy"><type>OutputIterator</type><template>
  100. <template-type-parameter name="InputIterator"/>
  101. <template-type-parameter name="OutputIterator"/>
  102. </template><parameter name="first"><paramtype>InputIterator</paramtype><description><para>first element in the range to copy </para></description></parameter><parameter name="last"><paramtype>InputIterator</paramtype><description><para>last element in the range to copy </para></description></parameter><parameter name="result"><paramtype>OutputIterator</paramtype><description><para>first element in the result range </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>command queue to perform the operation</para></description></parameter><parameter name="events"><paramtype>const <classname>wait_list</classname> &amp;</paramtype><default><classname alt="boost::compute::wait_list">wait_list</classname>()</default></parameter><description><para>Copies the values in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) to the range beginning at <computeroutput>result</computeroutput>.</para><para>The generic copy() function can be used for a variety of data transfer tasks and provides a standard interface to the following OpenCL functions:</para><para><itemizedlist>
  103. <listitem><para><computeroutput>clEnqueueReadBuffer()</computeroutput> </para>
  104. </listitem>
  105. <listitem><para><computeroutput>clEnqueueWriteBuffer()</computeroutput> </para>
  106. </listitem>
  107. <listitem><para><computeroutput>clEnqueueCopyBuffer()</computeroutput> </para>
  108. </listitem>
  109. </itemizedlist>
  110. Unlike the aforementioned OpenCL functions, copy() will also work with non-contiguous data-structures (e.g. <computeroutput>std::list&lt;T&gt;</computeroutput>) as well as with "fancy" iterators (e.g. <classname alt="boost::compute::transform_iterator">transform_iterator</classname>).</para><para>
  111. For example, to copy an array of <computeroutput>int</computeroutput> values on the host to a vector on the device: <programlisting language="c++">// array on the host
  112. int data[] = { 1, 2, 3, 4 };
  113. // vector on the device
  114. boost::compute::vector&lt;int&gt; vec(4, context);
  115. // copy values to the device vector
  116. boost::compute::copy(data, data + 4, vec.begin(), queue);
  117. </programlisting></para><para>The copy algorithm can also be used with standard containers such as <computeroutput>std::vector&lt;T&gt;</computeroutput>: <programlisting language="c++">std::vector&lt;int&gt; host_vector = ...
  118. boost::compute::vector&lt;int&gt; device_vector = ...
  119. // copy from the host to the device
  120. boost::compute::copy(
  121. host_vector.begin(), host_vector.end(), device_vector.begin(), queue
  122. );
  123. // copy from the device to the host
  124. boost::compute::copy(
  125. device_vector.begin(), device_vector.end(), host_vector.begin(), queue
  126. );
  127. </programlisting></para><para>Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>copy_n(), copy_if(), copy_async() </para>
  128. </para>
  129. </para></description><returns><para><computeroutput>OutputIterator</computeroutput> to the end of the result range</para>
  130. </returns></function>
  131. <function name="copy_async"><type><classname>future</classname>&lt; OutputIterator &gt;</type><template>
  132. <template-type-parameter name="InputIterator"/>
  133. <template-type-parameter name="OutputIterator"/>
  134. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><parameter name="events"><paramtype>const <classname>wait_list</classname> &amp;</paramtype><default><classname alt="boost::compute::wait_list">wait_list</classname>()</default></parameter><description><para>Copies the values in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) to the range beginning at <computeroutput>result</computeroutput>. The copy is performed asynchronously.</para><para><para><emphasis role="bold">See Also:</emphasis><para>copy() </para>
  135. </para>
  136. </para></description></function>
  137. </namespace>
  138. </namespace>
  139. </header>
  140. <header name="boost/compute/algorithm/copy_if.hpp">
  141. <namespace name="boost">
  142. <namespace name="compute">
  143. <function name="copy_if"><type>OutputIterator</type><template>
  144. <template-type-parameter name="InputIterator"/>
  145. <template-type-parameter name="OutputIterator"/>
  146. <template-type-parameter name="Predicate"/>
  147. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="predicate"><paramtype>Predicate</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Copies each element in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) for which <computeroutput>predicate</computeroutput> returns <computeroutput>true</computeroutput> to the range beginning at <computeroutput>result</computeroutput>.</para><para>Space complexity: \Omega(2n) </para></description></function>
  148. </namespace>
  149. </namespace>
  150. </header>
  151. <header name="boost/compute/algorithm/copy_n.hpp">
  152. <namespace name="boost">
  153. <namespace name="compute">
  154. <function name="copy_n"><type>OutputIterator</type><template>
  155. <template-type-parameter name="InputIterator"/>
  156. <template-type-parameter name="Size"/>
  157. <template-type-parameter name="OutputIterator"/>
  158. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="count"><paramtype>Size</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><parameter name="events"><paramtype>const <classname>wait_list</classname> &amp;</paramtype><default><classname alt="boost::compute::wait_list">wait_list</classname>()</default></parameter><description><para>Copies <computeroutput>count</computeroutput> elements from <computeroutput>first</computeroutput> to <computeroutput>result</computeroutput>.</para><para>For example, to copy four values from the host to the device: <programlisting language="c++">// values on the host and vector on the device
  159. float values[4] = { 1.f, 2.f, 3.f, 4.f };
  160. boost::compute::vector&lt;float&gt; vec(4, context);
  161. // copy from the host to the device
  162. boost::compute::copy_n(values, 4, vec.begin(), queue);
  163. </programlisting></para><para>Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>copy() </para>
  164. </para>
  165. </para></description></function>
  166. </namespace>
  167. </namespace>
  168. </header>
  169. <header name="boost/compute/algorithm/count.hpp">
  170. <namespace name="boost">
  171. <namespace name="compute">
  172. <function name="count"><type>size_t</type><template>
  173. <template-type-parameter name="InputIterator"/>
  174. <template-type-parameter name="T"/>
  175. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="value"><paramtype>const T &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Returns the number of occurrences of <computeroutput>value</computeroutput> in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>).</para><para>Space complexity on CPUs: \Omega(1)<sbr/>
  176. Space complexity on GPUs: \Omega(n)</para><para><para><emphasis role="bold">See Also:</emphasis><para>count_if() </para>
  177. </para>
  178. </para></description></function>
  179. </namespace>
  180. </namespace>
  181. </header>
  182. <header name="boost/compute/algorithm/count_if.hpp">
  183. <namespace name="boost">
  184. <namespace name="compute">
  185. <function name="count_if"><type>size_t</type><template>
  186. <template-type-parameter name="InputIterator"/>
  187. <template-type-parameter name="Predicate"/>
  188. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="predicate"><paramtype>Predicate</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Returns the number of elements in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) for which <computeroutput>predicate</computeroutput> returns <computeroutput>true</computeroutput>.</para><para>Space complexity on CPUs: \Omega(1)<sbr/>
  189. Space complexity on GPUs: \Omega(n) </para></description></function>
  190. </namespace>
  191. </namespace>
  192. </header>
  193. <header name="boost/compute/algorithm/equal.hpp">
  194. <namespace name="boost">
  195. <namespace name="compute">
  196. <overloaded-function name="equal"><signature><type>bool</type><template>
  197. <template-type-parameter name="InputIterator1"/>
  198. <template-type-parameter name="InputIterator2"/>
  199. </template><parameter name="first1"><paramtype>InputIterator1</paramtype></parameter><parameter name="last1"><paramtype>InputIterator1</paramtype></parameter><parameter name="first2"><paramtype>InputIterator2</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><signature><type>bool</type><template>
  200. <template-type-parameter name="InputIterator1"/>
  201. <template-type-parameter name="InputIterator2"/>
  202. </template><parameter name="first1"><paramtype>InputIterator1</paramtype></parameter><parameter name="last1"><paramtype>InputIterator1</paramtype></parameter><parameter name="first2"><paramtype>InputIterator2</paramtype></parameter><parameter name="last2"><paramtype>InputIterator2</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Returns <computeroutput>true</computeroutput> if the range [<computeroutput>first1</computeroutput>, <computeroutput>last1</computeroutput>) and the range beginning at <computeroutput>first2</computeroutput> are equal.</para><para>Space complexity: \Omega(1) </para></description></overloaded-function>
  203. </namespace>
  204. </namespace>
  205. </header>
  206. <header name="boost/compute/algorithm/equal_range.hpp">
  207. <namespace name="boost">
  208. <namespace name="compute">
  209. <function name="equal_range"><type>std::pair&lt; InputIterator, InputIterator &gt;</type><template>
  210. <template-type-parameter name="InputIterator"/>
  211. <template-type-parameter name="T"/>
  212. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="value"><paramtype>const T &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Returns a pair of iterators containing the range of values equal to <computeroutput>value</computeroutput> in the sorted range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>).</para><para>Space complexity: \Omega(1) </para></description></function>
  213. </namespace>
  214. </namespace>
  215. </header>
  216. <header name="boost/compute/algorithm/exclusive_scan.hpp">
  217. <namespace name="boost">
  218. <namespace name="compute">
  219. <overloaded-function name="exclusive_scan"><signature><type>OutputIterator</type><template>
  220. <template-type-parameter name="InputIterator"/>
  221. <template-type-parameter name="OutputIterator"/>
  222. <template-type-parameter name="T"/>
  223. <template-type-parameter name="BinaryOperator"/>
  224. </template><parameter name="first"><paramtype>InputIterator</paramtype><description><para>first element in the range to scan </para></description></parameter><parameter name="last"><paramtype>InputIterator</paramtype><description><para>last element in the range to scan </para></description></parameter><parameter name="result"><paramtype>OutputIterator</paramtype><description><para>first element in the result range </para></description></parameter><parameter name="init"><paramtype>T</paramtype><description><para>value used to initialize the scan sequence </para></description></parameter><parameter name="binary_op"><paramtype>BinaryOperator</paramtype><description><para>associative binary operator </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>command queue to perform the operation</para></description></parameter></signature><signature><type>OutputIterator</type><template>
  225. <template-type-parameter name="InputIterator"/>
  226. <template-type-parameter name="OutputIterator"/>
  227. <template-type-parameter name="T"/>
  228. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="init"><paramtype>T</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><signature><type>OutputIterator</type><template>
  229. <template-type-parameter name="InputIterator"/>
  230. <template-type-parameter name="OutputIterator"/>
  231. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Performs an exclusive scan of the elements in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) and stores the results in the range beginning at <computeroutput>result</computeroutput>.</para><para>Each element in the output is assigned to the sum of all the previous values in the input.</para><para>
  232. The default operation is to add the elements up.</para><para><programlisting language="c++"/> But different associative operation can be specified as <computeroutput>binary_op</computeroutput> instead (e.g., multiplication, maximum, minimum). Also value used to initialized the scan sequence can be specified.</para><para><programlisting language="c++"/> Space complexity on GPUs: \Omega(n)<sbr/>
  233. Space complexity on GPUs when <computeroutput>first</computeroutput> == <computeroutput>result:</computeroutput> \Omega(2n)<sbr/>
  234. Space complexity on CPUs: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>inclusive_scan() </para>
  235. </para>
  236. </para></description><returns><para><computeroutput>OutputIterator</computeroutput> to the end of the result range</para>
  237. </returns></overloaded-function>
  238. </namespace>
  239. </namespace>
  240. </header>
  241. <header name="boost/compute/algorithm/fill.hpp">
  242. <namespace name="boost">
  243. <namespace name="compute">
  244. <function name="fill"><type>void</type><template>
  245. <template-type-parameter name="BufferIterator"/>
  246. <template-type-parameter name="T"/>
  247. </template><parameter name="first"><paramtype>BufferIterator</paramtype><description><para>first element in the range to fill </para></description></parameter><parameter name="last"><paramtype>BufferIterator</paramtype><description><para>last element in the range to fill </para></description></parameter><parameter name="value"><paramtype>const T &amp;</paramtype><description><para>value to copy to each element </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>command queue to perform the operation</para></description></parameter><description><para>Fills the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) with <computeroutput>value</computeroutput>.</para><para>
  248. For example, to fill a vector on the device with sevens: <programlisting language="c++">// vector on the device
  249. boost::compute::vector&lt;int&gt; vec(10, context);
  250. // fill vector with sevens
  251. boost::compute::fill(vec.begin(), vec.end(), 7, queue);
  252. </programlisting></para><para>Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>boost::compute::fill_n() </para>
  253. </para>
  254. </para></description></function>
  255. <function name="fill_async"><type><classname>future</classname>&lt; void &gt;</type><template>
  256. <template-type-parameter name="BufferIterator"/>
  257. <template-type-parameter name="T"/>
  258. </template><parameter name="first"><paramtype>BufferIterator</paramtype></parameter><parameter name="last"><paramtype>BufferIterator</paramtype></parameter><parameter name="value"><paramtype>const T &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></function>
  259. </namespace>
  260. </namespace>
  261. </header>
  262. <header name="boost/compute/algorithm/fill_n.hpp">
  263. <namespace name="boost">
  264. <namespace name="compute">
  265. <function name="fill_n"><type>void</type><template>
  266. <template-type-parameter name="BufferIterator"/>
  267. <template-type-parameter name="Size"/>
  268. <template-type-parameter name="T"/>
  269. </template><parameter name="first"><paramtype>BufferIterator</paramtype></parameter><parameter name="count"><paramtype>Size</paramtype></parameter><parameter name="value"><paramtype>const T &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Fills the range [<computeroutput>first</computeroutput>, <computeroutput>first</computeroutput> + count) with <computeroutput>value</computeroutput>.</para><para>Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>fill() </para>
  270. </para>
  271. </para></description></function>
  272. </namespace>
  273. </namespace>
  274. </header>
  275. <header name="boost/compute/algorithm/find.hpp">
  276. <namespace name="boost">
  277. <namespace name="compute">
  278. <function name="find"><type>InputIterator</type><template>
  279. <template-type-parameter name="InputIterator"/>
  280. <template-type-parameter name="T"/>
  281. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="value"><paramtype>const T &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Returns an iterator pointing to the first element in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) that equals <computeroutput>value</computeroutput>.</para><para>Space complexity: \Omega(1) </para></description></function>
  282. </namespace>
  283. </namespace>
  284. </header>
  285. <header name="boost/compute/algorithm/find_end.hpp">
  286. <namespace name="boost">
  287. <namespace name="compute">
  288. <function name="find_end"><type>TextIterator</type><template>
  289. <template-type-parameter name="TextIterator"/>
  290. <template-type-parameter name="PatternIterator"/>
  291. </template><parameter name="t_first"><paramtype>TextIterator</paramtype><description><para>Iterator pointing to start of text </para></description></parameter><parameter name="t_last"><paramtype>TextIterator</paramtype><description><para>Iterator pointing to end of text </para></description></parameter><parameter name="p_first"><paramtype>PatternIterator</paramtype><description><para>Iterator pointing to start of pattern </para></description></parameter><parameter name="p_last"><paramtype>PatternIterator</paramtype><description><para>Iterator pointing to end of pattern </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>Queue on which to execute</para></description></parameter><purpose>Substring matching algorithm. </purpose><description><para>Searches for the last match of the pattern [p_first, p_last) in text [t_first, t_last).
  292. Space complexity: \Omega(n) </para></description><returns><para>Iterator pointing to beginning of last occurence</para>
  293. </returns></function>
  294. </namespace>
  295. </namespace>
  296. </header>
  297. <header name="boost/compute/algorithm/find_if.hpp">
  298. <namespace name="boost">
  299. <namespace name="compute">
  300. <function name="find_if"><type>InputIterator</type><template>
  301. <template-type-parameter name="InputIterator"/>
  302. <template-type-parameter name="UnaryPredicate"/>
  303. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="predicate"><paramtype>UnaryPredicate</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Returns an iterator pointing to the first element in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) for which <computeroutput>predicate</computeroutput> returns <computeroutput>true</computeroutput>.</para><para>Space complexity: \Omega(1) </para></description></function>
  304. </namespace>
  305. </namespace>
  306. </header>
  307. <header name="boost/compute/algorithm/find_if_not.hpp">
  308. <namespace name="boost">
  309. <namespace name="compute">
  310. <function name="find_if_not"><type>InputIterator</type><template>
  311. <template-type-parameter name="InputIterator"/>
  312. <template-type-parameter name="UnaryPredicate"/>
  313. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="predicate"><paramtype>UnaryPredicate</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Returns an iterator pointing to the first element in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) for which <computeroutput>predicate</computeroutput> returns <computeroutput>false</computeroutput>.</para><para>Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>find_if() </para>
  314. </para>
  315. </para></description></function>
  316. </namespace>
  317. </namespace>
  318. </header>
  319. <header name="boost/compute/algorithm/for_each.hpp">
  320. <namespace name="boost">
  321. <namespace name="compute">
  322. <function name="for_each"><type>UnaryFunction</type><template>
  323. <template-type-parameter name="InputIterator"/>
  324. <template-type-parameter name="UnaryFunction"/>
  325. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="function"><paramtype>UnaryFunction</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Calls <computeroutput>function</computeroutput> on each element in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>).</para><para>Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>transform() </para>
  326. </para>
  327. </para></description></function>
  328. </namespace>
  329. </namespace>
  330. </header>
  331. <header name="boost/compute/algorithm/for_each_n.hpp">
  332. <namespace name="boost">
  333. <namespace name="compute">
  334. <function name="for_each_n"><type>UnaryFunction</type><template>
  335. <template-type-parameter name="InputIterator"/>
  336. <template-type-parameter name="Size"/>
  337. <template-type-parameter name="UnaryFunction"/>
  338. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="count"><paramtype>Size</paramtype></parameter><parameter name="function"><paramtype>UnaryFunction</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Calls <computeroutput>function</computeroutput> on each element in the range [<computeroutput>first</computeroutput>, <computeroutput>first</computeroutput> <computeroutput>+</computeroutput> <computeroutput>count</computeroutput>).</para><para>Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>for_each() </para>
  339. </para>
  340. </para></description></function>
  341. </namespace>
  342. </namespace>
  343. </header>
  344. <header name="boost/compute/algorithm/gather.hpp">
  345. <namespace name="boost">
  346. <namespace name="compute">
  347. <function name="gather"><type>void</type><template>
  348. <template-type-parameter name="InputIterator"/>
  349. <template-type-parameter name="MapIterator"/>
  350. <template-type-parameter name="OutputIterator"/>
  351. </template><parameter name="first"><paramtype>MapIterator</paramtype></parameter><parameter name="last"><paramtype>MapIterator</paramtype></parameter><parameter name="input"><paramtype>InputIterator</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Copies the elements using the indices from the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) to the range beginning at <computeroutput>result</computeroutput> using the input values from the range beginning at <computeroutput>input</computeroutput>.</para><para>Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>scatter() </para>
  352. </para>
  353. </para></description></function>
  354. </namespace>
  355. </namespace>
  356. </header>
  357. <header name="boost/compute/algorithm/generate.hpp">
  358. <namespace name="boost">
  359. <namespace name="compute">
  360. <function name="generate"><type>void</type><template>
  361. <template-type-parameter name="OutputIterator"/>
  362. <template-type-parameter name="Generator"/>
  363. </template><parameter name="first"><paramtype>OutputIterator</paramtype></parameter><parameter name="last"><paramtype>OutputIterator</paramtype></parameter><parameter name="generator"><paramtype>Generator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Stores the result of <computeroutput>generator</computeroutput> for each element in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>).</para><para>Space complexity: \Omega(1) </para></description></function>
  364. </namespace>
  365. </namespace>
  366. </header>
  367. <header name="boost/compute/algorithm/generate_n.hpp">
  368. <namespace name="boost">
  369. <namespace name="compute">
  370. <function name="generate_n"><type>void</type><template>
  371. <template-type-parameter name="OutputIterator"/>
  372. <template-type-parameter name="Size"/>
  373. <template-type-parameter name="Generator"/>
  374. </template><parameter name="first"><paramtype>OutputIterator</paramtype></parameter><parameter name="count"><paramtype>Size</paramtype></parameter><parameter name="generator"><paramtype>Generator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Stores the result of <computeroutput>generator</computeroutput> for each element in the range [<computeroutput>first</computeroutput>, <computeroutput>first</computeroutput> + <computeroutput>count</computeroutput>).</para><para>Space complexity: \Omega(1) </para></description></function>
  375. </namespace>
  376. </namespace>
  377. </header>
  378. <header name="boost/compute/algorithm/includes.hpp">
  379. <namespace name="boost">
  380. <namespace name="compute">
  381. <function name="includes"><type>bool</type><template>
  382. <template-type-parameter name="InputIterator1"/>
  383. <template-type-parameter name="InputIterator2"/>
  384. </template><parameter name="first1"><paramtype>InputIterator1</paramtype><description><para>Iterator pointing to start of first set </para></description></parameter><parameter name="last1"><paramtype>InputIterator1</paramtype><description><para>Iterator pointing to end of first set </para></description></parameter><parameter name="first2"><paramtype>InputIterator2</paramtype><description><para>Iterator pointing to start of second set </para></description></parameter><parameter name="last2"><paramtype>InputIterator2</paramtype><description><para>Iterator pointing to end of second set </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>Queue on which to execute</para></description></parameter><purpose>Includes algorithm. </purpose><description><para>Finds if the sorted range [first1, last1) includes the sorted range [first2, last2). In other words, it checks if [first1, last1) is a superset of [first2, last2).</para><para>
  385. Space complexity: \Omega(distance(<computeroutput>first1</computeroutput>, <computeroutput>last1</computeroutput>) + distance(<computeroutput>first2</computeroutput>, <computeroutput>last2</computeroutput>)) </para></description><returns><para>True, if [first1, last1) includes [first2, last2). False otherwise.</para>
  386. </returns></function>
  387. </namespace>
  388. </namespace>
  389. </header>
  390. <header name="boost/compute/algorithm/inclusive_scan.hpp">
  391. <namespace name="boost">
  392. <namespace name="compute">
  393. <overloaded-function name="inclusive_scan"><signature><type>OutputIterator</type><template>
  394. <template-type-parameter name="InputIterator"/>
  395. <template-type-parameter name="OutputIterator"/>
  396. <template-type-parameter name="BinaryOperator"/>
  397. </template><parameter name="first"><paramtype>InputIterator</paramtype><description><para>first element in the range to scan </para></description></parameter><parameter name="last"><paramtype>InputIterator</paramtype><description><para>last element in the range to scan </para></description></parameter><parameter name="result"><paramtype>OutputIterator</paramtype><description><para>first element in the result range </para></description></parameter><parameter name="binary_op"><paramtype>BinaryOperator</paramtype><description><para>associative binary operator </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>command queue to perform the operation</para></description></parameter></signature><signature><type>OutputIterator</type><template>
  398. <template-type-parameter name="InputIterator"/>
  399. <template-type-parameter name="OutputIterator"/>
  400. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Performs an inclusive scan of the elements in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) and stores the results in the range beginning at <computeroutput>result</computeroutput>.</para><para>Each element in the output is assigned to the sum of the current value in the input with the sum of every previous value in the input.</para><para>
  401. The default operation is to add the elements up.</para><para><programlisting language="c++"/> But different associative operation can be specified as <computeroutput>binary_op</computeroutput> instead (e.g., multiplication, maximum, minimum).</para><para><programlisting language="c++"/> Space complexity on GPUs: \Omega(n)<sbr/>
  402. Space complexity on GPUs when <computeroutput>first</computeroutput> == <computeroutput>result:</computeroutput> \Omega(2n)<sbr/>
  403. Space complexity on CPUs: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>exclusive_scan() </para>
  404. </para>
  405. </para></description><returns><para><computeroutput>OutputIterator</computeroutput> to the end of the result range</para>
  406. </returns></overloaded-function>
  407. </namespace>
  408. </namespace>
  409. </header>
  410. <header name="boost/compute/algorithm/inner_product.hpp">
  411. <namespace name="boost">
  412. <namespace name="compute">
  413. <overloaded-function name="inner_product"><signature><type>T</type><template>
  414. <template-type-parameter name="InputIterator1"/>
  415. <template-type-parameter name="InputIterator2"/>
  416. <template-type-parameter name="T"/>
  417. </template><parameter name="first1"><paramtype>InputIterator1</paramtype></parameter><parameter name="last1"><paramtype>InputIterator1</paramtype></parameter><parameter name="first2"><paramtype>InputIterator2</paramtype></parameter><parameter name="init"><paramtype>T</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><signature><type>T</type><template>
  418. <template-type-parameter name="InputIterator1"/>
  419. <template-type-parameter name="InputIterator2"/>
  420. <template-type-parameter name="T"/>
  421. <template-type-parameter name="BinaryAccumulateFunction"/>
  422. <template-type-parameter name="BinaryTransformFunction"/>
  423. </template><parameter name="first1"><paramtype>InputIterator1</paramtype></parameter><parameter name="last1"><paramtype>InputIterator1</paramtype></parameter><parameter name="first2"><paramtype>InputIterator2</paramtype></parameter><parameter name="init"><paramtype>T</paramtype></parameter><parameter name="accumulate_function"><paramtype>BinaryAccumulateFunction</paramtype></parameter><parameter name="transform_function"><paramtype>BinaryTransformFunction</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Returns the inner product of the elements in the range [<computeroutput>first1</computeroutput>, <computeroutput>last1</computeroutput>) with the elements in the range beginning at <computeroutput>first2</computeroutput>.</para><para>Space complexity: \Omega(1)<sbr/>
  424. Space complexity when binary operator is recognized as associative: \Omega(n) </para></description></overloaded-function>
  425. </namespace>
  426. </namespace>
  427. </header>
  428. <header name="boost/compute/algorithm/inplace_merge.hpp">
  429. <namespace name="boost">
  430. <namespace name="compute">
  431. <function name="inplace_merge"><type>void</type><template>
  432. <template-type-parameter name="Iterator"/>
  433. </template><parameter name="first"><paramtype>Iterator</paramtype></parameter><parameter name="middle"><paramtype>Iterator</paramtype></parameter><parameter name="last"><paramtype>Iterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Merges the sorted values in the range [<computeroutput>first</computeroutput>, <computeroutput>middle</computeroutput>) with the sorted values in the range [<computeroutput>middle</computeroutput>, <computeroutput>last</computeroutput>) in-place.</para><para>Space complexity: \Omega(n) </para></description></function>
  434. </namespace>
  435. </namespace>
  436. </header>
  437. <header name="boost/compute/algorithm/iota.hpp">
  438. <namespace name="boost">
  439. <namespace name="compute">
  440. <function name="iota"><type>void</type><template>
  441. <template-type-parameter name="BufferIterator"/>
  442. <template-type-parameter name="T"/>
  443. </template><parameter name="first"><paramtype>BufferIterator</paramtype></parameter><parameter name="last"><paramtype>BufferIterator</paramtype></parameter><parameter name="value"><paramtype>const T &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Fills the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) with sequential values starting at <computeroutput>value</computeroutput>.</para><para>For example, the following code: <programlisting language="c++"/> Will fill <computeroutput>vec</computeroutput> with the values (<computeroutput>0</computeroutput>, <computeroutput>1</computeroutput>, <computeroutput>2</computeroutput>, <computeroutput/>...).</para><para>Space complexity: \Omega(1) </para></description></function>
  444. </namespace>
  445. </namespace>
  446. </header>
  447. <header name="boost/compute/algorithm/is_partitioned.hpp">
  448. <namespace name="boost">
  449. <namespace name="compute">
  450. <function name="is_partitioned"><type>bool</type><template>
  451. <template-type-parameter name="InputIterator"/>
  452. <template-type-parameter name="UnaryPredicate"/>
  453. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="predicate"><paramtype>UnaryPredicate</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Returns <computeroutput>true</computeroutput> if the values in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) are partitioned according to <computeroutput>predicate</computeroutput>.</para><para>Space complexity: \Omega(1) </para></description></function>
  454. </namespace>
  455. </namespace>
  456. </header>
  457. <header name="boost/compute/algorithm/is_permutation.hpp">
  458. <namespace name="boost">
  459. <namespace name="compute">
  460. <function name="is_permutation"><type>bool</type><template>
  461. <template-type-parameter name="InputIterator1"/>
  462. <template-type-parameter name="InputIterator2"/>
  463. </template><parameter name="first1"><paramtype>InputIterator1</paramtype><description><para>Iterator pointing to start of first range </para></description></parameter><parameter name="last1"><paramtype>InputIterator1</paramtype><description><para>Iterator pointing to end of first range </para></description></parameter><parameter name="first2"><paramtype>InputIterator2</paramtype><description><para>Iterator pointing to start of second range </para></description></parameter><parameter name="last2"><paramtype>InputIterator2</paramtype><description><para>Iterator pointing to end of second range </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>Queue on which to execute</para></description></parameter><purpose>Permutation checking algorithm. </purpose><description><para>Checks if the range [first1, last1) can be permuted into the range [first2, last2)
  464. Space complexity: \Omega(distance(<computeroutput>first1</computeroutput>, <computeroutput>last1</computeroutput>) + distance(<computeroutput>first2</computeroutput>, <computeroutput>last2</computeroutput>)) </para></description><returns><para>True, if it can be permuted. False, otherwise.</para>
  465. </returns></function>
  466. </namespace>
  467. </namespace>
  468. </header>
  469. <header name="boost/compute/algorithm/is_sorted.hpp">
  470. <namespace name="boost">
  471. <namespace name="compute">
  472. <overloaded-function name="is_sorted"><signature><type>bool</type><template>
  473. <template-type-parameter name="InputIterator"/>
  474. <template-type-parameter name="Compare"/>
  475. </template><parameter name="first"><paramtype>InputIterator</paramtype><description><para>first element in the range to check </para></description></parameter><parameter name="last"><paramtype>InputIterator</paramtype><description><para>last element in the range to check </para></description></parameter><parameter name="compare"><paramtype>Compare</paramtype><description><para>comparison function (by default <computeroutput>less</computeroutput>) </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>command queue to perform the operation</para></description></parameter></signature><signature><type>bool</type><template>
  476. <template-type-parameter name="InputIterator"/>
  477. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Returns <computeroutput>true</computeroutput> if the values in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) are in sorted order.</para><para>
  478. Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>sort() </para>
  479. </para>
  480. </para></description><returns><para><computeroutput>true</computeroutput> if the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) is sorted</para>
  481. </returns></overloaded-function>
  482. </namespace>
  483. </namespace>
  484. </header>
  485. <header name="boost/compute/algorithm/lexicographical_compare.hpp">
  486. <namespace name="boost">
  487. <namespace name="compute">
  488. <function name="lexicographical_compare"><type>bool</type><template>
  489. <template-type-parameter name="InputIterator1"/>
  490. <template-type-parameter name="InputIterator2"/>
  491. </template><parameter name="first1"><paramtype>InputIterator1</paramtype></parameter><parameter name="last1"><paramtype>InputIterator1</paramtype></parameter><parameter name="first2"><paramtype>InputIterator2</paramtype></parameter><parameter name="last2"><paramtype>InputIterator2</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Checks if the first range [first1, last1) is lexicographically less than the second range [first2, last2).</para><para>Space complexity: \Omega(max(distance(<computeroutput>first1</computeroutput>, <computeroutput>last1</computeroutput>), distance(<computeroutput>first2</computeroutput>, <computeroutput>last2</computeroutput>))) </para></description></function>
  492. </namespace>
  493. </namespace>
  494. </header>
  495. <header name="boost/compute/algorithm/lower_bound.hpp">
  496. <namespace name="boost">
  497. <namespace name="compute">
  498. <function name="lower_bound"><type>InputIterator</type><template>
  499. <template-type-parameter name="InputIterator"/>
  500. <template-type-parameter name="T"/>
  501. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="value"><paramtype>const T &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Returns an iterator pointing to the first element in the sorted range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) that is not less than <computeroutput>value</computeroutput>.</para><para>Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>upper_bound() </para>
  502. </para>
  503. </para></description></function>
  504. </namespace>
  505. </namespace>
  506. </header>
  507. <header name="boost/compute/algorithm/max_element.hpp">
  508. <namespace name="boost">
  509. <namespace name="compute">
  510. <overloaded-function name="max_element"><signature><type>InputIterator</type><template>
  511. <template-type-parameter name="InputIterator"/>
  512. <template-type-parameter name="Compare"/>
  513. </template><parameter name="first"><paramtype>InputIterator</paramtype><description><para>first element in the input range </para></description></parameter><parameter name="last"><paramtype>InputIterator</paramtype><description><para>last element in the input range </para></description></parameter><parameter name="compare"><paramtype>Compare</paramtype><description><para>comparison function object which returns true if the first argument is less than (i.e. is ordered before) the second. </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>command queue to perform the operation</para></description></parameter></signature><signature><type>InputIterator</type><template>
  514. <template-type-parameter name="InputIterator"/>
  515. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Returns an iterator pointing to the element in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) with the maximum value.</para><para>
  516. For example, to find <computeroutput>int2</computeroutput> value with maximum first component in given vector: <programlisting language="c++">// comparison function object
  517. BOOST_COMPUTE_FUNCTION(bool, compare_first, (const int2_ &amp;a, const int2_ &amp;b),
  518. {
  519. return a.x &lt; b.x;
  520. });
  521. // create vector
  522. boost::compute::vector&lt;uint2_&gt; data = ...
  523. boost::compute::vector&lt;uint2_&gt;::iterator max =
  524. boost::compute::max_element(data.begin(), data.end(), compare_first, queue);
  525. </programlisting></para><para>Space complexity on CPUs: \Omega(1)<sbr/>
  526. Space complexity on GPUs: \Omega(N)</para><para><para><emphasis role="bold">See Also:</emphasis><para>min_element() </para>
  527. </para>
  528. </para></description></overloaded-function>
  529. </namespace>
  530. </namespace>
  531. </header>
  532. <header name="boost/compute/algorithm/merge.hpp">
  533. <namespace name="boost">
  534. <namespace name="compute">
  535. <overloaded-function name="merge"><signature><type>OutputIterator</type><template>
  536. <template-type-parameter name="InputIterator1"/>
  537. <template-type-parameter name="InputIterator2"/>
  538. <template-type-parameter name="OutputIterator"/>
  539. <template-type-parameter name="Compare"/>
  540. </template><parameter name="first1"><paramtype>InputIterator1</paramtype><description><para>first element in the first range to merge </para></description></parameter><parameter name="last1"><paramtype>InputIterator1</paramtype><description><para>last element in the first range to merge </para></description></parameter><parameter name="first2"><paramtype>InputIterator2</paramtype><description><para>first element in the second range to merge </para></description></parameter><parameter name="last2"><paramtype>InputIterator2</paramtype><description><para>last element in the second range to merge </para></description></parameter><parameter name="result"><paramtype>OutputIterator</paramtype><description><para>first element in the result range </para></description></parameter><parameter name="comp"><paramtype>Compare</paramtype><description><para>comparison function (by default <computeroutput>less</computeroutput>) </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>command queue to perform the operation</para></description></parameter></signature><signature><type>OutputIterator</type><template>
  541. <template-type-parameter name="InputIterator1"/>
  542. <template-type-parameter name="InputIterator2"/>
  543. <template-type-parameter name="OutputIterator"/>
  544. </template><parameter name="first1"><paramtype>InputIterator1</paramtype></parameter><parameter name="last1"><paramtype>InputIterator1</paramtype></parameter><parameter name="first2"><paramtype>InputIterator2</paramtype></parameter><parameter name="last2"><paramtype>InputIterator2</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Merges the sorted values in the range [<computeroutput>first1</computeroutput>, <computeroutput>last1</computeroutput>) with the sorted values in the range [<computeroutput>first2</computeroutput>, last2) and stores the result in the range beginning at <computeroutput>result</computeroutput>. Values are compared using the <computeroutput>comp</computeroutput> function. If no comparision function is given, <computeroutput>less</computeroutput> is used.</para><para>
  545. Space complexity: \Omega(distance(<computeroutput>first1</computeroutput>, <computeroutput>last1</computeroutput>) + distance(<computeroutput>first2</computeroutput>, <computeroutput>last2</computeroutput>))</para><para><para><emphasis role="bold">See Also:</emphasis><para>inplace_merge() </para>
  546. </para>
  547. </para></description><returns><para><computeroutput>OutputIterator</computeroutput> to the end of the result range</para>
  548. </returns></overloaded-function>
  549. </namespace>
  550. </namespace>
  551. </header>
  552. <header name="boost/compute/algorithm/min_element.hpp">
  553. <namespace name="boost">
  554. <namespace name="compute">
  555. <overloaded-function name="min_element"><signature><type>InputIterator</type><template>
  556. <template-type-parameter name="InputIterator"/>
  557. <template-type-parameter name="Compare"/>
  558. </template><parameter name="first"><paramtype>InputIterator</paramtype><description><para>first element in the input range </para></description></parameter><parameter name="last"><paramtype>InputIterator</paramtype><description><para>last element in the input range </para></description></parameter><parameter name="compare"><paramtype>Compare</paramtype><description><para>comparison function object which returns true if the first argument is less than (i.e. is ordered before) the second. </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>command queue to perform the operation</para></description></parameter></signature><signature><type>InputIterator</type><template>
  559. <template-type-parameter name="InputIterator"/>
  560. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Returns an iterator pointing to the element in range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) with the minimum value.</para><para>
  561. For example, to find <computeroutput>int2</computeroutput> value with minimum first component in given vector: <programlisting language="c++">// comparison function object
  562. BOOST_COMPUTE_FUNCTION(bool, compare_first, (const int2_ &amp;a, const int2_ &amp;b),
  563. {
  564. return a.x &lt; b.x;
  565. });
  566. // create vector
  567. boost::compute::vector&lt;uint2_&gt; data = ...
  568. boost::compute::vector&lt;uint2_&gt;::iterator min =
  569. boost::compute::min_element(data.begin(), data.end(), compare_first, queue);
  570. </programlisting></para><para>Space complexity on CPUs: \Omega(1)<sbr/>
  571. Space complexity on GPUs: \Omega(N)</para><para><para><emphasis role="bold">See Also:</emphasis><para>max_element() </para>
  572. </para>
  573. </para></description></overloaded-function>
  574. </namespace>
  575. </namespace>
  576. </header>
  577. <header name="boost/compute/algorithm/minmax_element.hpp">
  578. <namespace name="boost">
  579. <namespace name="compute">
  580. <overloaded-function name="minmax_element"><signature><type>std::pair&lt; InputIterator, InputIterator &gt;</type><template>
  581. <template-type-parameter name="InputIterator"/>
  582. <template-type-parameter name="Compare"/>
  583. </template><parameter name="first"><paramtype>InputIterator</paramtype><description><para>first element in the input range </para></description></parameter><parameter name="last"><paramtype>InputIterator</paramtype><description><para>last element in the input range </para></description></parameter><parameter name="compare"><paramtype>Compare</paramtype><description><para>comparison function object which returns true if the first argument is less than (i.e. is ordered before) the second. </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>command queue to perform the operation</para></description></parameter></signature><signature><type>std::pair&lt; InputIterator, InputIterator &gt;</type><template>
  584. <template-type-parameter name="InputIterator"/>
  585. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Returns a pair of iterators with the first pointing to the minimum element and the second pointing to the maximum element in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>).</para><para>
  586. Space complexity on CPUs: \Omega(1)<sbr/>
  587. Space complexity on GPUs: \Omega(N)</para><para><para><emphasis role="bold">See Also:</emphasis><para>max_element(), min_element() </para>
  588. </para>
  589. </para></description></overloaded-function>
  590. </namespace>
  591. </namespace>
  592. </header>
  593. <header name="boost/compute/algorithm/mismatch.hpp">
  594. <namespace name="boost">
  595. <namespace name="compute">
  596. <overloaded-function name="mismatch"><signature><type>std::pair&lt; InputIterator1, InputIterator2 &gt;</type><template>
  597. <template-type-parameter name="InputIterator1"/>
  598. <template-type-parameter name="InputIterator2"/>
  599. </template><parameter name="first1"><paramtype>InputIterator1</paramtype></parameter><parameter name="last1"><paramtype>InputIterator1</paramtype></parameter><parameter name="first2"><paramtype>InputIterator2</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><signature><type>std::pair&lt; InputIterator1, InputIterator2 &gt;</type><template>
  600. <template-type-parameter name="InputIterator1"/>
  601. <template-type-parameter name="InputIterator2"/>
  602. </template><parameter name="first1"><paramtype>InputIterator1</paramtype></parameter><parameter name="last1"><paramtype>InputIterator1</paramtype></parameter><parameter name="first2"><paramtype>InputIterator2</paramtype></parameter><parameter name="last2"><paramtype>InputIterator2</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Returns a pair of iterators pointing to the first position where the range [<computeroutput>first1</computeroutput>, <computeroutput>last1</computeroutput>) and the range starting at <computeroutput>first2</computeroutput> differ.</para><para>Space complexity: \Omega(1) </para></description></overloaded-function>
  603. </namespace>
  604. </namespace>
  605. </header>
  606. <header name="boost/compute/algorithm/next_permutation.hpp">
  607. <namespace name="boost">
  608. <namespace name="compute">
  609. <function name="next_permutation"><type>bool</type><template>
  610. <template-type-parameter name="InputIterator"/>
  611. </template><parameter name="first"><paramtype>InputIterator</paramtype><description><para>Iterator pointing to start of range </para></description></parameter><parameter name="last"><paramtype>InputIterator</paramtype><description><para>Iterator pointing to end of range </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>Queue on which to execute</para></description></parameter><purpose>Permutation generating algorithm. </purpose><description><para>Transforms the range [first, last) into the next permutation from the set of all permutations arranged in lexicographic order
  612. Space complexity: \Omega(1) </para></description><returns><para>Boolean value signifying if the last permutation was crossed and the range was reset</para>
  613. </returns></function>
  614. </namespace>
  615. </namespace>
  616. </header>
  617. <header name="boost/compute/algorithm/none_of.hpp">
  618. <namespace name="boost">
  619. <namespace name="compute">
  620. <function name="none_of"><type>bool</type><template>
  621. <template-type-parameter name="InputIterator"/>
  622. <template-type-parameter name="UnaryPredicate"/>
  623. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="predicate"><paramtype>UnaryPredicate</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Returns <computeroutput>true</computeroutput> if <computeroutput>predicate</computeroutput> returns <computeroutput>true</computeroutput> for none of the elements in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>).</para><para>Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>all_of(), any_of() </para>
  624. </para>
  625. </para></description></function>
  626. </namespace>
  627. </namespace>
  628. </header>
  629. <header name="boost/compute/algorithm/nth_element.hpp">
  630. <namespace name="boost">
  631. <namespace name="compute">
  632. <overloaded-function name="nth_element"><signature><type>void</type><template>
  633. <template-type-parameter name="Iterator"/>
  634. <template-type-parameter name="Compare"/>
  635. </template><parameter name="first"><paramtype>Iterator</paramtype></parameter><parameter name="nth"><paramtype>Iterator</paramtype></parameter><parameter name="last"><paramtype>Iterator</paramtype></parameter><parameter name="compare"><paramtype>Compare</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><signature><type>void</type><template>
  636. <template-type-parameter name="Iterator"/>
  637. </template><parameter name="first"><paramtype>Iterator</paramtype></parameter><parameter name="nth"><paramtype>Iterator</paramtype></parameter><parameter name="last"><paramtype>Iterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Rearranges the elements in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) such that the <computeroutput>nth</computeroutput> element would be in that position in a sorted sequence.</para><para>Space complexity: \Omega(3n) </para></description></overloaded-function>
  638. </namespace>
  639. </namespace>
  640. </header>
  641. <header name="boost/compute/algorithm/partial_sum.hpp">
  642. <namespace name="boost">
  643. <namespace name="compute">
  644. <function name="partial_sum"><type>OutputIterator</type><template>
  645. <template-type-parameter name="InputIterator"/>
  646. <template-type-parameter name="OutputIterator"/>
  647. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Calculates the cumulative sum of the elements in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) and writes the resulting values to the range beginning at <computeroutput>result</computeroutput>.</para><para>Space complexity on GPUs: \Omega(n)<sbr/>
  648. Space complexity on GPUs when <computeroutput>first</computeroutput> == <computeroutput>result:</computeroutput> \Omega(2n)<sbr/>
  649. Space complexity on CPUs: \Omega(1) </para></description></function>
  650. </namespace>
  651. </namespace>
  652. </header>
  653. <header name="boost/compute/algorithm/partition.hpp">
  654. <namespace name="boost">
  655. <namespace name="compute">
  656. <function name="partition"><type>Iterator</type><template>
  657. <template-type-parameter name="Iterator"/>
  658. <template-type-parameter name="UnaryPredicate"/>
  659. </template><parameter name="first"><paramtype>Iterator</paramtype></parameter><parameter name="last"><paramtype>Iterator</paramtype></parameter><parameter name="predicate"><paramtype>UnaryPredicate</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Partitions the elements in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) according to <computeroutput>predicate</computeroutput>. Order of the elements need not be preserved.</para><para>Space complexity: \Omega(3n)</para><para><para><emphasis role="bold">See Also:</emphasis><para>is_partitioned() and stable_partition() </para>
  660. </para>
  661. </para></description></function>
  662. </namespace>
  663. </namespace>
  664. </header>
  665. <header name="boost/compute/algorithm/partition_copy.hpp">
  666. <namespace name="boost">
  667. <namespace name="compute">
  668. <function name="partition_copy"><type>std::pair&lt; OutputIterator1, OutputIterator2 &gt;</type><template>
  669. <template-type-parameter name="InputIterator"/>
  670. <template-type-parameter name="OutputIterator1"/>
  671. <template-type-parameter name="OutputIterator2"/>
  672. <template-type-parameter name="UnaryPredicate"/>
  673. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="first_true"><paramtype>OutputIterator1</paramtype></parameter><parameter name="first_false"><paramtype>OutputIterator2</paramtype></parameter><parameter name="predicate"><paramtype>UnaryPredicate</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Copies all of the elements in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) for which <computeroutput>predicate</computeroutput> returns <computeroutput>true</computeroutput> to the range beginning at <computeroutput>first_true</computeroutput> and all of the elements for which <computeroutput>predicate</computeroutput> returns <computeroutput>false</computeroutput> to the range beginning at <computeroutput>first_false</computeroutput>.</para><para>Space complexity: \Omega(2n)</para><para><para><emphasis role="bold">See Also:</emphasis><para>partition() </para>
  674. </para>
  675. </para></description></function>
  676. </namespace>
  677. </namespace>
  678. </header>
  679. <header name="boost/compute/algorithm/partition_point.hpp">
  680. <namespace name="boost">
  681. <namespace name="compute">
  682. <function name="partition_point"><type>InputIterator</type><template>
  683. <template-type-parameter name="InputIterator"/>
  684. <template-type-parameter name="UnaryPredicate"/>
  685. </template><parameter name="first"><paramtype>InputIterator</paramtype><description><para>Iterator pointing to start of range </para></description></parameter><parameter name="last"><paramtype>InputIterator</paramtype><description><para>Iterator pointing to end of range </para></description></parameter><parameter name="predicate"><paramtype>UnaryPredicate</paramtype><description><para>Unary predicate to be applied on each element </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>Queue on which to execute</para></description></parameter><purpose>Partition point algorithm. </purpose><description><para>Finds the end of true values in the partitioned range [first, last)
  686. Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>partition() and stable_partition() </para>
  687. </para>
  688. </para></description><returns><para>Iterator pointing to end of true values</para>
  689. </returns></function>
  690. </namespace>
  691. </namespace>
  692. </header>
  693. <header name="boost/compute/algorithm/prev_permutation.hpp">
  694. <namespace name="boost">
  695. <namespace name="compute">
  696. <function name="prev_permutation"><type>bool</type><template>
  697. <template-type-parameter name="InputIterator"/>
  698. </template><parameter name="first"><paramtype>InputIterator</paramtype><description><para>Iterator pointing to start of range </para></description></parameter><parameter name="last"><paramtype>InputIterator</paramtype><description><para>Iterator pointing to end of range </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>Queue on which to execute</para></description></parameter><purpose>Permutation generating algorithm. </purpose><description><para>Transforms the range [first, last) into the previous permutation from the set of all permutations arranged in lexicographic order
  699. Space complexity: \Omega(1) </para></description><returns><para>Boolean value signifying if the first permutation was crossed and the range was reset</para>
  700. </returns></function>
  701. </namespace>
  702. </namespace>
  703. </header>
  704. <header name="boost/compute/algorithm/random_shuffle.hpp">
  705. <namespace name="boost">
  706. <namespace name="compute">
  707. <function name="random_shuffle"><type>void</type><template>
  708. <template-type-parameter name="Iterator"/>
  709. </template><parameter name="first"><paramtype>Iterator</paramtype></parameter><parameter name="last"><paramtype>Iterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Randomly shuffles the elements in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>).</para><para>Space complexity: \Omega(2n)</para><para><para><emphasis role="bold">See Also:</emphasis><para>scatter() </para>
  710. </para>
  711. </para></description></function>
  712. </namespace>
  713. </namespace>
  714. </header>
  715. <header name="boost/compute/algorithm/reduce.hpp">
  716. <namespace name="boost">
  717. <namespace name="compute">
  718. <overloaded-function name="reduce"><signature><type>void</type><template>
  719. <template-type-parameter name="InputIterator"/>
  720. <template-type-parameter name="OutputIterator"/>
  721. <template-type-parameter name="BinaryFunction"/>
  722. </template><parameter name="first"><paramtype>InputIterator</paramtype><description><para>first element in the input range </para></description></parameter><parameter name="last"><paramtype>InputIterator</paramtype><description><para>last element in the input range </para></description></parameter><parameter name="result"><paramtype>OutputIterator</paramtype><description><para>iterator pointing to the output </para></description></parameter><parameter name="function"><paramtype>BinaryFunction</paramtype><description><para>binary reduction function </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>command queue to perform the operation</para></description></parameter></signature><signature><type>void</type><template>
  723. <template-type-parameter name="InputIterator"/>
  724. <template-type-parameter name="OutputIterator"/>
  725. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Returns the result of applying <computeroutput>function</computeroutput> to the elements in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>).</para><para>If no function is specified, <computeroutput>plus</computeroutput> will be used.</para><para>
  726. The <computeroutput>reduce()</computeroutput> algorithm assumes that the binary reduction function is associative. When used with non-associative functions the result may be non-deterministic and vary in precision. Notably this affects the <computeroutput>plus&lt;float&gt;()</computeroutput> function as floating-point addition is not associative and may produce slightly different results than a serial algorithm.</para><para>This algorithm supports both host and device iterators for the result argument. This allows for values to be reduced and copied to the host all with a single function call.</para><para>For example, to calculate the sum of the values in a device vector and copy the result to a value on the host:</para><para><programlisting language="c++"/> Note that while the the <computeroutput>reduce()</computeroutput> algorithm is conceptually identical to the <computeroutput>accumulate()</computeroutput> algorithm, its implementation is substantially more efficient on parallel hardware. For more information, see the documentation on the <computeroutput>accumulate()</computeroutput> algorithm.</para><para>Space complexity on GPUs: \Omega(n)<sbr/>
  727. Space complexity on CPUs: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>accumulate() </para>
  728. </para>
  729. </para></description></overloaded-function>
  730. </namespace>
  731. </namespace>
  732. </header>
  733. <header name="boost/compute/algorithm/reduce_by_key.hpp">
  734. <namespace name="boost">
  735. <namespace name="compute">
  736. <overloaded-function name="reduce_by_key"><signature><type>std::pair&lt; OutputKeyIterator, OutputValueIterator &gt;</type><template>
  737. <template-type-parameter name="InputKeyIterator"/>
  738. <template-type-parameter name="InputValueIterator"/>
  739. <template-type-parameter name="OutputKeyIterator"/>
  740. <template-type-parameter name="OutputValueIterator"/>
  741. <template-type-parameter name="BinaryFunction"/>
  742. <template-type-parameter name="BinaryPredicate"/>
  743. </template><parameter name="keys_first"><paramtype>InputKeyIterator</paramtype><description><para>the first key </para></description></parameter><parameter name="keys_last"><paramtype>InputKeyIterator</paramtype><description><para>the last key </para></description></parameter><parameter name="values_first"><paramtype>InputValueIterator</paramtype><description><para>the first input value </para></description></parameter><parameter name="keys_result"><paramtype>OutputKeyIterator</paramtype><description><para>iterator pointing to the key output </para></description></parameter><parameter name="values_result"><paramtype>OutputValueIterator</paramtype><description><para>iterator pointing to the reduced value output </para></description></parameter><parameter name="function"><paramtype>BinaryFunction</paramtype><description><para>binary reduction function </para></description></parameter><parameter name="predicate"><paramtype>BinaryPredicate</paramtype><description><para>binary predicate which returns true only if two keys are equal </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>command queue to perform the operation</para></description></parameter></signature><signature><type>std::pair&lt; OutputKeyIterator, OutputValueIterator &gt;</type><template>
  744. <template-type-parameter name="InputKeyIterator"/>
  745. <template-type-parameter name="InputValueIterator"/>
  746. <template-type-parameter name="OutputKeyIterator"/>
  747. <template-type-parameter name="OutputValueIterator"/>
  748. <template-type-parameter name="BinaryFunction"/>
  749. </template><parameter name="keys_first"><paramtype>InputKeyIterator</paramtype></parameter><parameter name="keys_last"><paramtype>InputKeyIterator</paramtype></parameter><parameter name="values_first"><paramtype>InputValueIterator</paramtype></parameter><parameter name="keys_result"><paramtype>OutputKeyIterator</paramtype></parameter><parameter name="values_result"><paramtype>OutputValueIterator</paramtype></parameter><parameter name="function"><paramtype>BinaryFunction</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><signature><type>std::pair&lt; OutputKeyIterator, OutputValueIterator &gt;</type><template>
  750. <template-type-parameter name="InputKeyIterator"/>
  751. <template-type-parameter name="InputValueIterator"/>
  752. <template-type-parameter name="OutputKeyIterator"/>
  753. <template-type-parameter name="OutputValueIterator"/>
  754. </template><parameter name="keys_first"><paramtype>InputKeyIterator</paramtype></parameter><parameter name="keys_last"><paramtype>InputKeyIterator</paramtype></parameter><parameter name="values_first"><paramtype>InputValueIterator</paramtype></parameter><parameter name="keys_result"><paramtype>OutputKeyIterator</paramtype></parameter><parameter name="values_result"><paramtype>OutputValueIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>The <computeroutput>reduce_by_key()</computeroutput> algorithm performs reduction for each contiguous subsequence of values determinate by equivalent keys.</para><para>Returns a pair of iterators at the end of the ranges [<computeroutput>keys_result</computeroutput>, keys_result_last) and [<computeroutput>values_result</computeroutput>, <computeroutput>values_result_last</computeroutput>).</para><para>If no function is specified, <computeroutput>plus</computeroutput> will be used. If no predicate is specified, <computeroutput>equal_to</computeroutput> will be used.</para><para>
  755. The <computeroutput>reduce_by_key()</computeroutput> algorithm assumes that the binary reduction function is associative. When used with non-associative functions the result may be non-deterministic and vary in precision. Notably this affects the <computeroutput>plus&lt;float&gt;()</computeroutput> function as floating-point addition is not associative and may produce slightly different results than a serial algorithm.</para><para>For example, to calculate the sum of the values for each key:</para><para><programlisting language="c++"/> Space complexity on GPUs: \Omega(2n)<sbr/>
  756. Space complexity on CPUs: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>reduce() </para>
  757. </para>
  758. </para></description></overloaded-function>
  759. </namespace>
  760. </namespace>
  761. </header>
  762. <header name="boost/compute/algorithm/remove.hpp">
  763. <namespace name="boost">
  764. <namespace name="compute">
  765. <function name="remove"><type>Iterator</type><template>
  766. <template-type-parameter name="Iterator"/>
  767. <template-type-parameter name="T"/>
  768. </template><parameter name="first"><paramtype>Iterator</paramtype></parameter><parameter name="last"><paramtype>Iterator</paramtype></parameter><parameter name="value"><paramtype>const T &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Removes each element equal to <computeroutput>value</computeroutput> in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>).</para><para>Space complexity: \Omega(3n)</para><para><para><emphasis role="bold">See Also:</emphasis><para>remove_if() </para>
  769. </para>
  770. </para></description></function>
  771. </namespace>
  772. </namespace>
  773. </header>
  774. <header name="boost/compute/algorithm/remove_if.hpp">
  775. <namespace name="boost">
  776. <namespace name="compute">
  777. <function name="remove_if"><type>Iterator</type><template>
  778. <template-type-parameter name="Iterator"/>
  779. <template-type-parameter name="Predicate"/>
  780. </template><parameter name="first"><paramtype>Iterator</paramtype></parameter><parameter name="last"><paramtype>Iterator</paramtype></parameter><parameter name="predicate"><paramtype>Predicate</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Removes each element for which <computeroutput>predicate</computeroutput> returns <computeroutput>true</computeroutput> in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>).</para><para>Space complexity: \Omega(3n)</para><para><para><emphasis role="bold">See Also:</emphasis><para>remove() </para>
  781. </para>
  782. </para></description></function>
  783. </namespace>
  784. </namespace>
  785. </header>
  786. <header name="boost/compute/algorithm/replace.hpp">
  787. <namespace name="boost">
  788. <namespace name="compute">
  789. <function name="replace"><type>void</type><template>
  790. <template-type-parameter name="Iterator"/>
  791. <template-type-parameter name="T"/>
  792. </template><parameter name="first"><paramtype>Iterator</paramtype></parameter><parameter name="last"><paramtype>Iterator</paramtype></parameter><parameter name="old_value"><paramtype>const T &amp;</paramtype></parameter><parameter name="new_value"><paramtype>const T &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Replaces each instance of <computeroutput>old_value</computeroutput> in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) with <computeroutput>new_value</computeroutput>.</para><para>Space complexity: \Omega(1) </para></description></function>
  793. </namespace>
  794. </namespace>
  795. </header>
  796. <header name="boost/compute/algorithm/replace_copy.hpp">
  797. <namespace name="boost">
  798. <namespace name="compute">
  799. <function name="replace_copy"><type>OutputIterator</type><template>
  800. <template-type-parameter name="InputIterator"/>
  801. <template-type-parameter name="OutputIterator"/>
  802. <template-type-parameter name="T"/>
  803. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="old_value"><paramtype>const T &amp;</paramtype></parameter><parameter name="new_value"><paramtype>const T &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Copies the value in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) to the range beginning at <computeroutput>result</computeroutput> while replacing each instance of <computeroutput>old_value</computeroutput> with <computeroutput>new_value</computeroutput>.</para><para>Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>replace() </para>
  804. </para>
  805. </para></description></function>
  806. </namespace>
  807. </namespace>
  808. </header>
  809. <header name="boost/compute/algorithm/reverse.hpp">
  810. <namespace name="boost">
  811. <namespace name="compute">
  812. <function name="reverse"><type>void</type><template>
  813. <template-type-parameter name="Iterator"/>
  814. </template><parameter name="first"><paramtype>Iterator</paramtype></parameter><parameter name="last"><paramtype>Iterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Reverses the elements in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>).</para><para>Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>reverse_copy() </para>
  815. </para>
  816. </para></description></function>
  817. </namespace>
  818. </namespace>
  819. </header>
  820. <header name="boost/compute/algorithm/reverse_copy.hpp">
  821. <namespace name="boost">
  822. <namespace name="compute">
  823. <function name="reverse_copy"><type>OutputIterator</type><template>
  824. <template-type-parameter name="InputIterator"/>
  825. <template-type-parameter name="OutputIterator"/>
  826. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Copies the elements in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) in reversed order to the range beginning at <computeroutput>result</computeroutput>.</para><para>Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>reverse() </para>
  827. </para>
  828. </para></description></function>
  829. </namespace>
  830. </namespace>
  831. </header>
  832. <header name="boost/compute/algorithm/rotate.hpp">
  833. <namespace name="boost">
  834. <namespace name="compute">
  835. <function name="rotate"><type>void</type><template>
  836. <template-type-parameter name="InputIterator"/>
  837. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="n_first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Performs left rotation such that element at <computeroutput>n_first</computeroutput> comes to the beginning.</para><para>Space complexity: \Omega(distance(<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>))</para><para><para><emphasis role="bold">See Also:</emphasis><para>rotate_copy() </para>
  838. </para>
  839. </para></description></function>
  840. </namespace>
  841. </namespace>
  842. </header>
  843. <header name="boost/compute/algorithm/rotate_copy.hpp">
  844. <namespace name="boost">
  845. <namespace name="compute">
  846. <function name="rotate_copy"><type>void</type><template>
  847. <template-type-parameter name="InputIterator"/>
  848. <template-type-parameter name="OutputIterator"/>
  849. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="n_first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Performs left rotation such that element at n_first comes to the beginning and the output is stored in range starting at result.</para><para>Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>rotate() </para>
  850. </para>
  851. </para></description></function>
  852. </namespace>
  853. </namespace>
  854. </header>
  855. <header name="boost/compute/algorithm/scatter.hpp">
  856. <namespace name="boost">
  857. <namespace name="compute">
  858. <function name="scatter"><type>void</type><template>
  859. <template-type-parameter name="InputIterator"/>
  860. <template-type-parameter name="MapIterator"/>
  861. <template-type-parameter name="OutputIterator"/>
  862. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="map"><paramtype>MapIterator</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Copies the elements from the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) to the range beginning at <computeroutput>result</computeroutput> using the output indices from the range beginning at <computeroutput>map</computeroutput>.</para><para>Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>gather() </para>
  863. </para>
  864. </para></description></function>
  865. </namespace>
  866. </namespace>
  867. </header>
  868. <header name="boost/compute/algorithm/scatter_if.hpp">
  869. <namespace name="boost">
  870. <namespace name="compute">
  871. <function name="scatter_if"><type>void</type><template>
  872. <template-type-parameter name="InputIterator"/>
  873. <template-type-parameter name="MapIterator"/>
  874. <template-type-parameter name="StencilIterator"/>
  875. <template-type-parameter name="OutputIterator"/>
  876. <template-type-parameter name="Predicate"/>
  877. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="map"><paramtype>MapIterator</paramtype></parameter><parameter name="stencil"><paramtype>StencilIterator</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="predicate"><paramtype>Predicate</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Copies the elements from the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) to the range beginning at <computeroutput>result</computeroutput> using the output indices from the range beginning at <computeroutput>map</computeroutput> if stencil is resolved to true. By default the predicate is an identity</para><para>Space complexity: \Omega(1) </para></description></function>
  878. <function name="scatter_if"><type>void</type><template>
  879. <template-type-parameter name="InputIterator"/>
  880. <template-type-parameter name="MapIterator"/>
  881. <template-type-parameter name="StencilIterator"/>
  882. <template-type-parameter name="OutputIterator"/>
  883. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="map"><paramtype>MapIterator</paramtype></parameter><parameter name="stencil"><paramtype>StencilIterator</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></function>
  884. </namespace>
  885. </namespace>
  886. </header>
  887. <header name="boost/compute/algorithm/search.hpp">
  888. <namespace name="boost">
  889. <namespace name="compute">
  890. <function name="search"><type>TextIterator</type><template>
  891. <template-type-parameter name="TextIterator"/>
  892. <template-type-parameter name="PatternIterator"/>
  893. </template><parameter name="t_first"><paramtype>TextIterator</paramtype><description><para>Iterator pointing to start of text </para></description></parameter><parameter name="t_last"><paramtype>TextIterator</paramtype><description><para>Iterator pointing to end of text </para></description></parameter><parameter name="p_first"><paramtype>PatternIterator</paramtype><description><para>Iterator pointing to start of pattern </para></description></parameter><parameter name="p_last"><paramtype>PatternIterator</paramtype><description><para>Iterator pointing to end of pattern </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>Queue on which to execute</para></description></parameter><purpose>Substring matching algorithm. </purpose><description><para>Searches for the first match of the pattern [p_first, p_last) in text [t_first, t_last).
  894. Space complexity: \Omega(distance(<computeroutput>t_first</computeroutput>, <computeroutput>t_last</computeroutput>)) </para></description><returns><para>Iterator pointing to beginning of first occurrence</para>
  895. </returns></function>
  896. </namespace>
  897. </namespace>
  898. </header>
  899. <header name="boost/compute/algorithm/search_n.hpp">
  900. <namespace name="boost">
  901. <namespace name="compute">
  902. <function name="search_n"><type>TextIterator</type><template>
  903. <template-type-parameter name="TextIterator"/>
  904. <template-type-parameter name="ValueType"/>
  905. </template><parameter name="t_first"><paramtype>TextIterator</paramtype><description><para>Iterator pointing to start of text </para></description></parameter><parameter name="t_last"><paramtype>TextIterator</paramtype><description><para>Iterator pointing to end of text </para></description></parameter><parameter name="n"><paramtype>size_t</paramtype><description><para>Number of times value repeats </para></description></parameter><parameter name="value"><paramtype>ValueType</paramtype><description><para>Value which repeats </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>Queue on which to execute</para></description></parameter><purpose>Substring matching algorithm. </purpose><description><para>Searches for the first occurrence of n consecutive occurrences of value in text [t_first, t_last).
  906. Space complexity: \Omega(distance(<computeroutput>t_first</computeroutput>, <computeroutput>t_last</computeroutput>)) </para></description><returns><para>Iterator pointing to beginning of first occurrence</para>
  907. </returns></function>
  908. </namespace>
  909. </namespace>
  910. </header>
  911. <header name="boost/compute/algorithm/set_difference.hpp">
  912. <namespace name="boost">
  913. <namespace name="compute">
  914. <function name="set_difference"><type>OutputIterator</type><template>
  915. <template-type-parameter name="InputIterator1"/>
  916. <template-type-parameter name="InputIterator2"/>
  917. <template-type-parameter name="OutputIterator"/>
  918. </template><parameter name="first1"><paramtype>InputIterator1</paramtype><description><para>Iterator pointing to start of first set </para></description></parameter><parameter name="last1"><paramtype>InputIterator1</paramtype><description><para>Iterator pointing to end of first set </para></description></parameter><parameter name="first2"><paramtype>InputIterator2</paramtype><description><para>Iterator pointing to start of second set </para></description></parameter><parameter name="last2"><paramtype>InputIterator2</paramtype><description><para>Iterator pointing to end of second set </para></description></parameter><parameter name="result"><paramtype>OutputIterator</paramtype><description><para>Iterator pointing to start of range in which the difference will be stored </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>Queue on which to execute</para></description></parameter><purpose>Set difference algorithm. </purpose><description><para>Finds the difference of the sorted range [first2, last2) from the sorted range [first1, last1) and stores it in range starting at result
  919. Space complexity: \Omega(2(distance(<computeroutput>first1</computeroutput>, <computeroutput>last1</computeroutput>) + distance(<computeroutput>first2</computeroutput>, <computeroutput>last2</computeroutput>))) </para></description><returns><para>Iterator pointing to end of difference</para>
  920. </returns></function>
  921. </namespace>
  922. </namespace>
  923. </header>
  924. <header name="boost/compute/algorithm/set_intersection.hpp">
  925. <namespace name="boost">
  926. <namespace name="compute">
  927. <function name="set_intersection"><type>OutputIterator</type><template>
  928. <template-type-parameter name="InputIterator1"/>
  929. <template-type-parameter name="InputIterator2"/>
  930. <template-type-parameter name="OutputIterator"/>
  931. </template><parameter name="first1"><paramtype>InputIterator1</paramtype><description><para>Iterator pointing to start of first set </para></description></parameter><parameter name="last1"><paramtype>InputIterator1</paramtype><description><para>Iterator pointing to end of first set </para></description></parameter><parameter name="first2"><paramtype>InputIterator2</paramtype><description><para>Iterator pointing to start of second set </para></description></parameter><parameter name="last2"><paramtype>InputIterator2</paramtype><description><para>Iterator pointing to end of second set </para></description></parameter><parameter name="result"><paramtype>OutputIterator</paramtype><description><para>Iterator pointing to start of range in which the intersection will be stored </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>Queue on which to execute</para></description></parameter><purpose>Set intersection algorithm. </purpose><description><para>Finds the intersection of the sorted range [first1, last1) with the sorted range [first2, last2) and stores it in range starting at result
  932. Space complexity: \Omega(2(distance(<computeroutput>first1</computeroutput>, <computeroutput>last1</computeroutput>) + distance(<computeroutput>first2</computeroutput>, <computeroutput>last2</computeroutput>))) </para></description><returns><para>Iterator pointing to end of intersection</para>
  933. </returns></function>
  934. </namespace>
  935. </namespace>
  936. </header>
  937. <header name="boost/compute/algorithm/set_symmetric_difference.hpp">
  938. <namespace name="boost">
  939. <namespace name="compute">
  940. <function name="set_symmetric_difference"><type>OutputIterator</type><template>
  941. <template-type-parameter name="InputIterator1"/>
  942. <template-type-parameter name="InputIterator2"/>
  943. <template-type-parameter name="OutputIterator"/>
  944. </template><parameter name="first1"><paramtype>InputIterator1</paramtype><description><para>Iterator pointing to start of first set </para></description></parameter><parameter name="last1"><paramtype>InputIterator1</paramtype><description><para>Iterator pointing to end of first set </para></description></parameter><parameter name="first2"><paramtype>InputIterator2</paramtype><description><para>Iterator pointing to start of second set </para></description></parameter><parameter name="last2"><paramtype>InputIterator2</paramtype><description><para>Iterator pointing to end of second set </para></description></parameter><parameter name="result"><paramtype>OutputIterator</paramtype><description><para>Iterator pointing to start of range in which the symmetric difference will be stored </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>Queue on which to execute</para></description></parameter><purpose>Set symmetric difference algorithm. </purpose><description><para>Finds the symmetric difference of the sorted range [first2, last2) from the sorted range [first1, last1) and stores it in range starting at result
  945. Space complexity: \Omega(2(distance(<computeroutput>first1</computeroutput>, <computeroutput>last1</computeroutput>) + distance(<computeroutput>first2</computeroutput>, <computeroutput>last2</computeroutput>))) </para></description><returns><para>Iterator pointing to end of symmetric difference</para>
  946. </returns></function>
  947. </namespace>
  948. </namespace>
  949. </header>
  950. <header name="boost/compute/algorithm/set_union.hpp">
  951. <namespace name="boost">
  952. <namespace name="compute">
  953. <function name="set_union"><type>OutputIterator</type><template>
  954. <template-type-parameter name="InputIterator1"/>
  955. <template-type-parameter name="InputIterator2"/>
  956. <template-type-parameter name="OutputIterator"/>
  957. </template><parameter name="first1"><paramtype>InputIterator1</paramtype><description><para>Iterator pointing to start of first set </para></description></parameter><parameter name="last1"><paramtype>InputIterator1</paramtype><description><para>Iterator pointing to end of first set </para></description></parameter><parameter name="first2"><paramtype>InputIterator2</paramtype><description><para>Iterator pointing to start of second set </para></description></parameter><parameter name="last2"><paramtype>InputIterator2</paramtype><description><para>Iterator pointing to end of second set </para></description></parameter><parameter name="result"><paramtype>OutputIterator</paramtype><description><para>Iterator pointing to start of range in which the union will be stored </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>Queue on which to execute</para></description></parameter><purpose>Set union algorithm. </purpose><description><para>Finds the union of the sorted range [first1, last1) with the sorted range [first2, last2) and stores it in range starting at result
  958. Space complexity: \Omega(2(distance(<computeroutput>first1</computeroutput>, <computeroutput>last1</computeroutput>) + distance(<computeroutput>first2</computeroutput>, <computeroutput>last2</computeroutput>))) </para></description><returns><para>Iterator pointing to end of union</para>
  959. </returns></function>
  960. </namespace>
  961. </namespace>
  962. </header>
  963. <header name="boost/compute/algorithm/sort.hpp">
  964. <namespace name="boost">
  965. <namespace name="compute">
  966. <overloaded-function name="sort"><signature><type>void</type><template>
  967. <template-type-parameter name="Iterator"/>
  968. <template-type-parameter name="Compare"/>
  969. </template><parameter name="first"><paramtype>Iterator</paramtype><description><para>first element in the range to sort </para></description></parameter><parameter name="last"><paramtype>Iterator</paramtype><description><para>last element in the range to sort </para></description></parameter><parameter name="compare"><paramtype>Compare</paramtype><description><para>comparison function (by default <computeroutput>less</computeroutput>) </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>command queue to perform the operation</para></description></parameter></signature><signature><type>void</type><template>
  970. <template-type-parameter name="Iterator"/>
  971. </template><parameter name="first"><paramtype>Iterator</paramtype></parameter><parameter name="last"><paramtype>Iterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Sorts the values in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) according to <computeroutput>compare</computeroutput>.</para><para>
  972. For example, to sort a vector on the device: <programlisting language="c++">// create vector on the device with data
  973. float data[] = { 2.f, 4.f, 1.f, 3.f };
  974. boost::compute::vector&lt;float&gt; vec(data, data + 4, queue);
  975. // sort the vector on the device
  976. boost::compute::sort(vec.begin(), vec.end(), queue);
  977. </programlisting></para><para>The sort() algorithm can also be directly used with host iterators. This example will automatically transfer the data to the device, sort it, and then transfer the data back to the host: <programlisting language="c++">std::vector&lt;int&gt; data = { 9, 3, 2, 5, 1, 4, 6, 7 };
  978. boost::compute::sort(data.begin(), data.end(), queue);
  979. </programlisting></para><para>Space complexity: \Omega(n)</para><para><para><emphasis role="bold">See Also:</emphasis><para>is_sorted() </para>
  980. </para>
  981. </para></description></overloaded-function>
  982. </namespace>
  983. </namespace>
  984. </header>
  985. <header name="boost/compute/algorithm/sort_by_key.hpp">
  986. <namespace name="boost">
  987. <namespace name="compute">
  988. <overloaded-function name="sort_by_key"><signature><type>void</type><template>
  989. <template-type-parameter name="KeyIterator"/>
  990. <template-type-parameter name="ValueIterator"/>
  991. <template-type-parameter name="Compare"/>
  992. </template><parameter name="keys_first"><paramtype>KeyIterator</paramtype></parameter><parameter name="keys_last"><paramtype>KeyIterator</paramtype></parameter><parameter name="values_first"><paramtype>ValueIterator</paramtype></parameter><parameter name="compare"><paramtype>Compare</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><signature><type>void</type><template>
  993. <template-type-parameter name="KeyIterator"/>
  994. <template-type-parameter name="ValueIterator"/>
  995. </template><parameter name="keys_first"><paramtype>KeyIterator</paramtype></parameter><parameter name="keys_last"><paramtype>KeyIterator</paramtype></parameter><parameter name="values_first"><paramtype>ValueIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Performs a key-value sort using the keys in the range [<computeroutput>keys_first</computeroutput>, <computeroutput>keys_last</computeroutput>) on the values in the range [<computeroutput>values_first</computeroutput>, <computeroutput>values_first</computeroutput> <computeroutput>+</computeroutput> (<computeroutput>keys_last</computeroutput> <computeroutput>-</computeroutput> <computeroutput>keys_first</computeroutput>)) using <computeroutput>compare</computeroutput>.</para><para>If no compare function is specified, <computeroutput>less</computeroutput> is used.</para><para>Space complexity: \Omega(2n)</para><para><para><emphasis role="bold">See Also:</emphasis><para>sort() </para>
  996. </para>
  997. </para></description></overloaded-function>
  998. </namespace>
  999. </namespace>
  1000. </header>
  1001. <header name="boost/compute/algorithm/stable_partition.hpp">
  1002. <namespace name="boost">
  1003. <namespace name="compute">
  1004. <function name="stable_partition"><type>Iterator</type><template>
  1005. <template-type-parameter name="Iterator"/>
  1006. <template-type-parameter name="UnaryPredicate"/>
  1007. </template><parameter name="first"><paramtype>Iterator</paramtype><description><para>Iterator pointing to start of range </para></description></parameter><parameter name="last"><paramtype>Iterator</paramtype><description><para>Iterator pointing to end of range </para></description></parameter><parameter name="predicate"><paramtype>UnaryPredicate</paramtype><description><para>Unary predicate to be applied on each element </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>Queue on which to execute</para></description></parameter><purpose>Partitioning algorithm. </purpose><description><para>Partitions the elements in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) according to <computeroutput>predicate</computeroutput>. The order of the elements is preserved.
  1008. Space complexity: \Omega(3n)</para><para><para><emphasis role="bold">See Also:</emphasis><para>is_partitioned() and partition() </para>
  1009. </para>
  1010. </para></description><returns><para>Iterator pointing to end of true values</para>
  1011. </returns></function>
  1012. </namespace>
  1013. </namespace>
  1014. </header>
  1015. <header name="boost/compute/algorithm/stable_sort.hpp">
  1016. <namespace name="boost">
  1017. <namespace name="compute">
  1018. <overloaded-function name="stable_sort"><signature><type>void</type><template>
  1019. <template-type-parameter name="Iterator"/>
  1020. <template-type-parameter name="Compare"/>
  1021. </template><parameter name="first"><paramtype>Iterator</paramtype></parameter><parameter name="last"><paramtype>Iterator</paramtype></parameter><parameter name="compare"><paramtype>Compare</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><signature><type>void</type><template>
  1022. <template-type-parameter name="Iterator"/>
  1023. </template><parameter name="first"><paramtype>Iterator</paramtype></parameter><parameter name="last"><paramtype>Iterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Sorts the values in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) according to <computeroutput>compare</computeroutput>. The relative order of identical values is preserved.</para><para>Space complexity: \Omega(n)</para><para><para><emphasis role="bold">See Also:</emphasis><para>sort(), is_sorted() </para>
  1024. </para>
  1025. </para></description></overloaded-function>
  1026. </namespace>
  1027. </namespace>
  1028. </header>
  1029. <header name="boost/compute/algorithm/stable_sort_by_key.hpp">
  1030. <namespace name="boost">
  1031. <namespace name="compute">
  1032. <overloaded-function name="stable_sort_by_key"><signature><type>void</type><template>
  1033. <template-type-parameter name="KeyIterator"/>
  1034. <template-type-parameter name="ValueIterator"/>
  1035. <template-type-parameter name="Compare"/>
  1036. </template><parameter name="keys_first"><paramtype>KeyIterator</paramtype></parameter><parameter name="keys_last"><paramtype>KeyIterator</paramtype></parameter><parameter name="values_first"><paramtype>ValueIterator</paramtype></parameter><parameter name="compare"><paramtype>Compare</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><signature><type>void</type><template>
  1037. <template-type-parameter name="KeyIterator"/>
  1038. <template-type-parameter name="ValueIterator"/>
  1039. </template><parameter name="keys_first"><paramtype>KeyIterator</paramtype></parameter><parameter name="keys_last"><paramtype>KeyIterator</paramtype></parameter><parameter name="values_first"><paramtype>ValueIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Performs a key-value stable sort using the keys in the range [<computeroutput>keys_first</computeroutput>, <computeroutput>keys_last</computeroutput>) on the values in the range [<computeroutput>values_first</computeroutput>, <computeroutput>values_first</computeroutput> <computeroutput>+</computeroutput> (<computeroutput>keys_last</computeroutput> <computeroutput>-</computeroutput> <computeroutput>keys_first</computeroutput>)) using <computeroutput>compare</computeroutput>.</para><para>If no compare function is specified, <computeroutput>less</computeroutput> is used.</para><para>Space complexity: \Omega(2n)</para><para><para><emphasis role="bold">See Also:</emphasis><para>sort() </para>
  1040. </para>
  1041. </para></description></overloaded-function>
  1042. </namespace>
  1043. </namespace>
  1044. </header>
  1045. <header name="boost/compute/algorithm/swap_ranges.hpp">
  1046. <namespace name="boost">
  1047. <namespace name="compute">
  1048. <function name="swap_ranges"><type>Iterator2</type><template>
  1049. <template-type-parameter name="Iterator1"/>
  1050. <template-type-parameter name="Iterator2"/>
  1051. </template><parameter name="first1"><paramtype>Iterator1</paramtype></parameter><parameter name="last1"><paramtype>Iterator1</paramtype></parameter><parameter name="first2"><paramtype>Iterator2</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Swaps the elements in the range [<computeroutput>first1</computeroutput>, <computeroutput>last1</computeroutput>) with the elements in the range beginning at <computeroutput>first2</computeroutput>.</para><para>Space complexity: \Omega(distance(<computeroutput>first1</computeroutput>, <computeroutput>last1</computeroutput>)) </para></description></function>
  1052. </namespace>
  1053. </namespace>
  1054. </header>
  1055. <header name="boost/compute/algorithm/transform.hpp">
  1056. <namespace name="boost">
  1057. <namespace name="compute">
  1058. <overloaded-function name="transform"><signature><type>OutputIterator</type><template>
  1059. <template-type-parameter name="InputIterator"/>
  1060. <template-type-parameter name="OutputIterator"/>
  1061. <template-type-parameter name="UnaryOperator"/>
  1062. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="op"><paramtype>UnaryOperator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><signature><type>OutputIterator</type><template>
  1063. <template-type-parameter name="InputIterator1"/>
  1064. <template-type-parameter name="InputIterator2"/>
  1065. <template-type-parameter name="OutputIterator"/>
  1066. <template-type-parameter name="BinaryOperator"/>
  1067. </template><parameter name="first1"><paramtype>InputIterator1</paramtype></parameter><parameter name="last1"><paramtype>InputIterator1</paramtype></parameter><parameter name="first2"><paramtype>InputIterator2</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="op"><paramtype>BinaryOperator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Transforms the elements in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) using operator <computeroutput>op</computeroutput> and stores the results in the range beginning at <computeroutput>result</computeroutput>.</para><para>For example, to calculate the absolute value for each element in a vector:</para><para><programlisting language="c++"/> Space complexity: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>copy() </para>
  1068. </para>
  1069. </para></description></overloaded-function>
  1070. </namespace>
  1071. </namespace>
  1072. </header>
  1073. <header name="boost/compute/algorithm/transform_if.hpp">
  1074. <namespace name="boost">
  1075. <namespace name="compute">
  1076. <function name="transform_if"><type>OutputIterator</type><template>
  1077. <template-type-parameter name="InputIterator"/>
  1078. <template-type-parameter name="OutputIterator"/>
  1079. <template-type-parameter name="UnaryFunction"/>
  1080. <template-type-parameter name="Predicate"/>
  1081. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="function"><paramtype>UnaryFunction</paramtype></parameter><parameter name="predicate"><paramtype>Predicate</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Copies each element in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) for which <computeroutput>predicate</computeroutput> returns <computeroutput>true</computeroutput> to the range beginning at <computeroutput>result</computeroutput>.</para><para>Space complexity: O(2n) </para></description></function>
  1082. </namespace>
  1083. </namespace>
  1084. </header>
  1085. <header name="boost/compute/algorithm/transform_reduce.hpp">
  1086. <namespace name="boost">
  1087. <namespace name="compute">
  1088. <overloaded-function name="transform_reduce"><signature><type>void</type><template>
  1089. <template-type-parameter name="InputIterator"/>
  1090. <template-type-parameter name="OutputIterator"/>
  1091. <template-type-parameter name="UnaryTransformFunction"/>
  1092. <template-type-parameter name="BinaryReduceFunction"/>
  1093. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="transform_function"><paramtype>UnaryTransformFunction</paramtype></parameter><parameter name="reduce_function"><paramtype>BinaryReduceFunction</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><signature><type>void</type><template>
  1094. <template-type-parameter name="InputIterator1"/>
  1095. <template-type-parameter name="InputIterator2"/>
  1096. <template-type-parameter name="OutputIterator"/>
  1097. <template-type-parameter name="BinaryTransformFunction"/>
  1098. <template-type-parameter name="BinaryReduceFunction"/>
  1099. </template><parameter name="first1"><paramtype>InputIterator1</paramtype></parameter><parameter name="last1"><paramtype>InputIterator1</paramtype></parameter><parameter name="first2"><paramtype>InputIterator2</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="transform_function"><paramtype>BinaryTransformFunction</paramtype></parameter><parameter name="reduce_function"><paramtype>BinaryReduceFunction</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Transforms each value in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) with the unary <computeroutput>transform_function</computeroutput> and then reduces each transformed value with <computeroutput>reduce_function</computeroutput>.</para><para>For example, to calculate the sum of the absolute values of a vector of integers:</para><para><programlisting language="c++"/> Space complexity on GPUs: \Omega(n)<sbr/>
  1100. Space complexity on CPUs: \Omega(1)</para><para><para><emphasis role="bold">See Also:</emphasis><para>reduce(), inner_product() </para>
  1101. </para>
  1102. </para></description></overloaded-function>
  1103. </namespace>
  1104. </namespace>
  1105. </header>
  1106. <header name="boost/compute/algorithm/unique.hpp">
  1107. <namespace name="boost">
  1108. <namespace name="compute">
  1109. <overloaded-function name="unique"><signature><type>InputIterator</type><template>
  1110. <template-type-parameter name="InputIterator"/>
  1111. <template-type-parameter name="BinaryPredicate"/>
  1112. </template><parameter name="first"><paramtype>InputIterator</paramtype><description><para>first element in the input range </para></description></parameter><parameter name="last"><paramtype>InputIterator</paramtype><description><para>last element in the input range </para></description></parameter><parameter name="op"><paramtype>BinaryPredicate</paramtype><description><para>binary operator used to check for uniqueness </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>command queue to perform the operation</para></description></parameter></signature><signature><type>InputIterator</type><template>
  1113. <template-type-parameter name="InputIterator"/>
  1114. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Removes all consecutive duplicate elements (determined by <computeroutput>op</computeroutput>) from the range [first, last). If <computeroutput>op</computeroutput> is not provided, the equality operator is used.</para><para>
  1115. Space complexity: \Omega(4n)</para><para><para><emphasis role="bold">See Also:</emphasis><para>unique_copy() </para>
  1116. </para>
  1117. </para></description><returns><para><computeroutput>InputIterator</computeroutput> to the new logical end of the range</para>
  1118. </returns></overloaded-function>
  1119. </namespace>
  1120. </namespace>
  1121. </header>
  1122. <header name="boost/compute/algorithm/unique_copy.hpp">
  1123. <namespace name="boost">
  1124. <namespace name="compute">
  1125. <overloaded-function name="unique_copy"><signature><type>OutputIterator</type><template>
  1126. <template-type-parameter name="InputIterator"/>
  1127. <template-type-parameter name="OutputIterator"/>
  1128. <template-type-parameter name="BinaryPredicate"/>
  1129. </template><parameter name="first"><paramtype>InputIterator</paramtype><description><para>first element in the input range </para></description></parameter><parameter name="last"><paramtype>InputIterator</paramtype><description><para>last element in the input range </para></description></parameter><parameter name="result"><paramtype>OutputIterator</paramtype><description><para>first element in the result range </para></description></parameter><parameter name="op"><paramtype>BinaryPredicate</paramtype><description><para>binary operator used to check for uniqueness </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default><description><para>command queue to perform the operation</para></description></parameter></signature><signature><type>OutputIterator</type><template>
  1130. <template-type-parameter name="InputIterator"/>
  1131. <template-type-parameter name="OutputIterator"/>
  1132. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="result"><paramtype>OutputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></signature><description><para>Makes a copy of the range [first, last) and removes all consecutive duplicate elements (determined by <computeroutput>op</computeroutput>) from the copy. If <computeroutput>op</computeroutput> is not provided, the equality operator is used.</para><para>
  1133. Space complexity: \Omega(4n)</para><para><para><emphasis role="bold">See Also:</emphasis><para>unique() </para>
  1134. </para>
  1135. </para></description><returns><para><computeroutput>OutputIterator</computeroutput> to the end of the result range</para>
  1136. </returns></overloaded-function>
  1137. </namespace>
  1138. </namespace>
  1139. </header>
  1140. <header name="boost/compute/algorithm/upper_bound.hpp">
  1141. <namespace name="boost">
  1142. <namespace name="compute">
  1143. <function name="upper_bound"><type>InputIterator</type><template>
  1144. <template-type-parameter name="InputIterator"/>
  1145. <template-type-parameter name="T"/>
  1146. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="value"><paramtype>const T &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Returns an iterator pointing to the first element in the sorted range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) that is not less than or equal to <computeroutput>value</computeroutput>.</para><para>Space complexity: \Omega(1) </para></description></function>
  1147. </namespace>
  1148. </namespace>
  1149. </header>
  1150. <header name="boost/compute/allocator/buffer_allocator.hpp">
  1151. <namespace name="boost">
  1152. <namespace name="compute">
  1153. <class name="buffer_allocator"><template>
  1154. <template-type-parameter name="T"/>
  1155. </template><purpose>The <classname alt="boost::compute::buffer_allocator">buffer_allocator</classname> class allocates memory with buffer objects. </purpose><description><para><para><emphasis role="bold">See Also:</emphasis><para>buffer </para>
  1156. </para>
  1157. </para></description><typedef name="value_type"><type>T</type></typedef>
  1158. <typedef name="pointer"><type><emphasis>unspecified</emphasis></type></typedef>
  1159. <typedef name="const_pointer"><type><emphasis>unspecified</emphasis></type></typedef>
  1160. <typedef name="size_type"><type>std::size_t</type></typedef>
  1161. <typedef name="difference_type"><type>std::ptrdiff_t</type></typedef>
  1162. <method-group name="public member functions">
  1163. <method name="allocate"><type>pointer</type><parameter name="n"><paramtype>size_type</paramtype></parameter></method>
  1164. <method name="deallocate"><type>void</type><parameter name="p"><paramtype>pointer</paramtype></parameter><parameter name="n"><paramtype>size_type</paramtype></parameter></method>
  1165. <method name="max_size" cv="const"><type>size_type</type></method>
  1166. <method name="get_context" cv="const"><type>context</type></method>
  1167. </method-group>
  1168. <constructor specifiers="explicit"><parameter name="context"><paramtype>const context &amp;</paramtype></parameter></constructor>
  1169. <constructor><parameter name="other"><paramtype>const <classname>buffer_allocator</classname>&lt; T &gt; &amp;</paramtype></parameter></constructor>
  1170. <copy-assignment><type><classname>buffer_allocator</classname>&lt; T &gt; &amp;</type><parameter name="other"><paramtype>const <classname>buffer_allocator</classname>&lt; T &gt; &amp;</paramtype></parameter></copy-assignment>
  1171. <constructor cv="noexcept"><parameter name="other"><paramtype><classname>buffer_allocator</classname>&lt; T &gt; &amp;&amp;</paramtype></parameter></constructor>
  1172. <copy-assignment cv="noexcept"><type><classname>buffer_allocator</classname>&lt; T &gt; &amp;</type><parameter name="other"><paramtype><classname>buffer_allocator</classname>&lt; T &gt; &amp;&amp;</paramtype></parameter></copy-assignment>
  1173. <destructor/>
  1174. <method-group name="protected member functions">
  1175. <method name="set_mem_flags"><type>void</type><parameter name="flags"><paramtype>cl_mem_flags</paramtype></parameter></method>
  1176. </method-group>
  1177. </class>
  1178. </namespace>
  1179. </namespace>
  1180. </header>
  1181. <header name="boost/compute/allocator/pinned_allocator.hpp">
  1182. <namespace name="boost">
  1183. <namespace name="compute">
  1184. <class name="pinned_allocator"><template>
  1185. <template-type-parameter name="T"/>
  1186. </template><inherit access="public">boost::compute::buffer_allocator&lt; T &gt;</inherit><method-group name="public member functions">
  1187. </method-group>
  1188. <constructor specifiers="explicit"><parameter name="context"><paramtype>const context &amp;</paramtype></parameter></constructor>
  1189. <constructor><parameter name="other"><paramtype>const pinned_allocator&lt; T &gt; &amp;</paramtype></parameter></constructor>
  1190. <copy-assignment><type>pinned_allocator&lt; T &gt; &amp;</type><parameter name="other"><paramtype>const pinned_allocator&lt; T &gt; &amp;</paramtype></parameter></copy-assignment>
  1191. <destructor/>
  1192. </class>
  1193. </namespace>
  1194. </namespace>
  1195. </header>
  1196. <header name="boost/compute/async/future.hpp">
  1197. <namespace name="boost">
  1198. <namespace name="compute">
  1199. <class name="future"><template>
  1200. <template-type-parameter name="T"/>
  1201. </template><purpose>Holds the result of an asynchronous computation. </purpose><description><para><para><emphasis role="bold">See Also:</emphasis><para>event, <classname alt="boost::compute::wait_list">wait_list</classname> </para>
  1202. </para>
  1203. </para></description><method-group name="public member functions">
  1204. <method name="get"><type>T</type><description><para>Returns the result of the computation. This will block until the result is ready. </para></description></method>
  1205. <method name="valid" cv="const"><type>bool</type><purpose>Returns <computeroutput>true</computeroutput> if the future is valid. </purpose></method>
  1206. <method name="wait" cv="const"><type>void</type><purpose>Blocks until the computation is complete. </purpose></method>
  1207. <method name="get_event" cv="const"><type>event</type><purpose>Returns the underlying event object. </purpose></method>
  1208. <method name="then"><type><classname>future</classname> &amp;</type><template>
  1209. <template-type-parameter name="Function"/>
  1210. </template><parameter name="callback"><paramtype>Function</paramtype></parameter><description><para>Invokes a generic callback function once the future is ready.</para><para>The function specified by callback must be invokable with zero arguments.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clSetEventCallback.html">clSetEventCallback()</ulink> for more information. <warning><para>This method is only available if the OpenCL version is 1.1 or later. </para>
  1211. </warning>
  1212. </para></description></method>
  1213. </method-group>
  1214. <constructor/>
  1215. <constructor><parameter name="result"><paramtype>const T &amp;</paramtype></parameter><parameter name="event"><paramtype>const event &amp;</paramtype></parameter></constructor>
  1216. <constructor><parameter name="other"><paramtype>const <classname>future</classname>&lt; T &gt; &amp;</paramtype></parameter></constructor>
  1217. <copy-assignment><type><classname>future</classname> &amp;</type><parameter name="other"><paramtype>const <classname>future</classname>&lt; T &gt; &amp;</paramtype></parameter></copy-assignment>
  1218. <destructor/>
  1219. </class>
  1220. </namespace>
  1221. </namespace>
  1222. </header>
  1223. <header name="boost/compute/async/wait.hpp">
  1224. <namespace name="boost">
  1225. <namespace name="compute">
  1226. <function name="wait_for_all"><type>void</type><template>
  1227. <template-nontype-parameter name="Events"><type>class...</type></template-nontype-parameter>
  1228. </template><parameter name="events"><paramtype>Events &amp;&amp;...</paramtype></parameter><description><para>Blocks until all events have completed. Events can either be event objects or <classname alt="boost::compute::future">future&lt;T&gt;</classname> objects.</para><para><para><emphasis role="bold">See Also:</emphasis><para>event, <classname alt="boost::compute::wait_list">wait_list</classname> </para>
  1229. </para>
  1230. </para></description></function>
  1231. </namespace>
  1232. </namespace>
  1233. </header>
  1234. <header name="boost/compute/async/wait_guard.hpp">
  1235. <namespace name="boost">
  1236. <namespace name="compute">
  1237. <class name="wait_guard"><template>
  1238. <template-type-parameter name="Waitable"/>
  1239. </template><inherit access="private">noncopyable</inherit><purpose>A guard object for synchronizing an operation on the device. </purpose><description><para>The <classname alt="boost::compute::wait_guard">wait_guard</classname> class stores a waitable object representing an operation on a compute device (e.g. event, <classname alt="boost::compute::future">future&lt;T&gt;</classname>) and calls its <computeroutput>wait()</computeroutput> method when the guard object goes out of scope.</para><para>This is useful for ensuring that an OpenCL operation completes before leaving the current scope and cleaning up any resources.</para><para>For example: <programlisting language="c++">// enqueue a compute kernel for execution
  1240. event e = queue.enqueue_nd_range_kernel(...);
  1241. // call e.wait() upon exiting the current scope
  1242. wait_guard&lt;event&gt; guard(e);
  1243. </programlisting></para><para><classname alt="boost::compute::wait_list">wait_list</classname>, wait_for_all() </para></description><method-group name="public member functions">
  1244. </method-group>
  1245. <constructor><parameter name="waitable"><paramtype>const Waitable &amp;</paramtype></parameter><purpose>Creates a new <classname alt="boost::compute::wait_guard">wait_guard</classname> object for <computeroutput>waitable</computeroutput>. </purpose></constructor>
  1246. <destructor><description><para>Destroys the <classname alt="boost::compute::wait_guard">wait_guard</classname> object. The default implementation will call <computeroutput>wait()</computeroutput> on the stored waitable object. </para></description></destructor>
  1247. </class>
  1248. </namespace>
  1249. </namespace>
  1250. </header>
  1251. <header name="boost/compute/container/array.hpp">
  1252. <namespace name="boost">
  1253. <namespace name="compute">
  1254. <class name="array"><template>
  1255. <template-type-parameter name="T"/>
  1256. <template-nontype-parameter name="N"><type>std::size_t</type></template-nontype-parameter>
  1257. </template><purpose>A fixed-size container. </purpose><description><para>The array container is very similar to the <classname alt="boost::compute::vector">vector</classname> container except its size is fixed at compile-time rather than being dynamically resizable at run-time.</para><para>For example, to create a fixed-size array with eight values on the device: <programlisting language="c++">boost::compute::array&lt;int, 8&gt; values(context);
  1258. </programlisting></para><para>The Boost.Compute <computeroutput>array</computeroutput> class provides a STL-like API and is modeled after the <computeroutput>std::array</computeroutput> class from the C++ standard library.</para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::vector">vector&lt;T&gt;</classname> </para>
  1259. </para>
  1260. </para></description><enum name="@0"><enumvalue name="static_size"><default>= N</default></enumvalue></enum>
  1261. <typedef name="value_type"><type>T</type></typedef>
  1262. <typedef name="size_type"><type>std::size_t</type></typedef>
  1263. <typedef name="difference_type"><type>ptrdiff_t</type></typedef>
  1264. <typedef name="reference"><type><emphasis>unspecified</emphasis></type></typedef>
  1265. <typedef name="const_reference"><type><emphasis>unspecified</emphasis></type></typedef>
  1266. <typedef name="pointer"><type>T *</type></typedef>
  1267. <typedef name="const_pointer"><type>const T *</type></typedef>
  1268. <typedef name="iterator"><type><classname>buffer_iterator</classname>&lt; T &gt;</type></typedef>
  1269. <typedef name="const_iterator"><type><classname>buffer_iterator</classname>&lt; T &gt;</type></typedef>
  1270. <typedef name="reverse_iterator"><type>std::reverse_iterator&lt; <classname>iterator</classname> &gt;</type></typedef>
  1271. <typedef name="const_reverse_iterator"><type>std::reverse_iterator&lt; <classname>const_iterator</classname> &gt;</type></typedef>
  1272. <method-group name="public member functions">
  1273. <method name="begin"><type><classname>iterator</classname></type></method>
  1274. <method name="begin" cv="const"><type><classname>const_iterator</classname></type></method>
  1275. <method name="cbegin" cv="const"><type><classname>const_iterator</classname></type></method>
  1276. <method name="end"><type><classname>iterator</classname></type></method>
  1277. <method name="end" cv="const"><type><classname>const_iterator</classname></type></method>
  1278. <method name="cend" cv="const"><type><classname>const_iterator</classname></type></method>
  1279. <method name="rbegin"><type>reverse_iterator</type></method>
  1280. <method name="rbegin" cv="const"><type>const_reverse_iterator</type></method>
  1281. <method name="crbegin" cv="const"><type>const_reverse_iterator</type></method>
  1282. <method name="rend"><type>reverse_iterator</type></method>
  1283. <method name="rend" cv="const"><type>const_reverse_iterator</type></method>
  1284. <method name="crend" cv="const"><type>const_reverse_iterator</type></method>
  1285. <method name="size" cv="const"><type>size_type</type></method>
  1286. <method name="empty" cv="const"><type>bool</type></method>
  1287. <method name="max_size" cv="const"><type>size_type</type></method>
  1288. <method name="operator[]"><type>reference</type><parameter name="index"><paramtype>size_type</paramtype></parameter></method>
  1289. <method name="operator[]" cv="const"><type>const_reference</type><parameter name="index"><paramtype>size_type</paramtype></parameter></method>
  1290. <method name="at"><type>reference</type><parameter name="index"><paramtype>size_type</paramtype></parameter></method>
  1291. <method name="at" cv="const"><type>const_reference</type><parameter name="index"><paramtype>size_type</paramtype></parameter></method>
  1292. <method name="front"><type>reference</type></method>
  1293. <method name="front" cv="const"><type>const_reference</type></method>
  1294. <method name="back"><type>reference</type></method>
  1295. <method name="back" cv="const"><type>const_reference</type></method>
  1296. <method name="fill"><type>void</type><parameter name="value"><paramtype>const value_type &amp;</paramtype></parameter><parameter name="queue"><paramtype>const command_queue &amp;</paramtype></parameter></method>
  1297. <method name="swap"><type>void</type><parameter name="other"><paramtype><classname>array</classname>&lt; T, N &gt; &amp;</paramtype></parameter><parameter name="queue"><paramtype>const command_queue &amp;</paramtype></parameter></method>
  1298. <method name="fill"><type>void</type><parameter name="value"><paramtype>const value_type &amp;</paramtype></parameter></method>
  1299. <method name="swap"><type>void</type><parameter name="other"><paramtype><classname>array</classname>&lt; T, N &gt; &amp;</paramtype></parameter></method>
  1300. <method name="get_buffer" cv="const"><type>const buffer &amp;</type></method>
  1301. </method-group>
  1302. <constructor specifiers="explicit"><parameter name="context"><paramtype>const context &amp;</paramtype><default>system::default_context()</default></parameter></constructor>
  1303. <constructor><parameter name="other"><paramtype>const <classname>array</classname>&lt; T, N &gt; &amp;</paramtype></parameter></constructor>
  1304. <constructor><parameter name="array"><paramtype>const boost::array&lt; T, N &gt; &amp;</paramtype></parameter><parameter name="context"><paramtype>const context &amp;</paramtype><default>system::default_context()</default></parameter></constructor>
  1305. <constructor><parameter name="other"><paramtype>const <classname>array</classname>&lt; T, N &gt; &amp;</paramtype></parameter><parameter name="queue"><paramtype>const command_queue &amp;</paramtype></parameter></constructor>
  1306. <copy-assignment><type><classname>array</classname>&lt; T, N &gt; &amp;</type><parameter name="other"><paramtype>const <classname>array</classname>&lt; T, N &gt; &amp;</paramtype></parameter></copy-assignment>
  1307. <copy-assignment><type><classname>array</classname>&lt; T, N &gt; &amp;</type><parameter name="array"><paramtype>const boost::array&lt; T, N &gt; &amp;</paramtype></parameter></copy-assignment>
  1308. <destructor/>
  1309. <method-group name="private member functions">
  1310. <method name="default_queue" cv="const"><type>command_queue</type></method>
  1311. </method-group>
  1312. </class>
  1313. </namespace>
  1314. </namespace>
  1315. </header>
  1316. <header name="boost/compute/container/basic_string.hpp">
  1317. <namespace name="boost">
  1318. <namespace name="compute">
  1319. <class name="basic_string"><template>
  1320. <template-type-parameter name="CharT"/>
  1321. <template-type-parameter name="Traits"><default>std::char_traits&lt;CharT&gt;</default></template-type-parameter>
  1322. </template><purpose>A template for a dynamically-sized character sequence. </purpose><description><para>The <computeroutput><classname alt="boost::compute::basic_string">basic_string</classname></computeroutput> class provides a generic template for a dynamically- sized character sequence. This is most commonly used through the <computeroutput>string</computeroutput> typedef (for <computeroutput>basic_string&lt;char&gt;</computeroutput>).</para><para>For example, to create a string on the device with its contents copied from a C-string on the host: <programlisting language="c++">boost::compute::string str("hello, world!");
  1323. </programlisting></para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::vector">vector&lt;T&gt;</classname> </para>
  1324. </para>
  1325. </para></description><typedef name="traits_type"><type>Traits</type></typedef>
  1326. <typedef name="value_type"><type>Traits::char_type</type></typedef>
  1327. <typedef name="size_type"><type>size_t</type></typedef>
  1328. <typedef name="reference"><type>::<classname>boost::compute::vector</classname>&lt; CharT &gt;::reference</type></typedef>
  1329. <typedef name="const_reference"><type>::<classname>boost::compute::vector</classname>&lt; CharT &gt;::const_reference</type></typedef>
  1330. <typedef name="iterator"><type>::<classname>boost::compute::vector</classname>&lt; CharT &gt;::<classname>iterator</classname></type></typedef>
  1331. <typedef name="const_iterator"><type>::<classname>boost::compute::vector</classname>&lt; CharT &gt;::<classname>const_iterator</classname></type></typedef>
  1332. <typedef name="reverse_iterator"><type>::<classname>boost::compute::vector</classname>&lt; CharT &gt;::reverse_iterator</type></typedef>
  1333. <typedef name="const_reverse_iterator"><type>::<classname>boost::compute::vector</classname>&lt; CharT &gt;::const_reverse_iterator</type></typedef>
  1334. <data-member name="npos" specifiers="static"><type>const size_type</type></data-member>
  1335. <method-group name="public member functions">
  1336. <method name="at"><type>reference</type><parameter name="pos"><paramtype>size_type</paramtype></parameter></method>
  1337. <method name="at" cv="const"><type>const_reference</type><parameter name="pos"><paramtype>size_type</paramtype></parameter></method>
  1338. <method name="operator[]"><type>reference</type><parameter name="pos"><paramtype>size_type</paramtype></parameter></method>
  1339. <method name="operator[]" cv="const"><type>const_reference</type><parameter name="pos"><paramtype>size_type</paramtype></parameter></method>
  1340. <method name="front"><type>reference</type></method>
  1341. <method name="front" cv="const"><type>const_reference</type></method>
  1342. <method name="back"><type>reference</type></method>
  1343. <method name="back" cv="const"><type>const_reference</type></method>
  1344. <method name="begin"><type><classname>iterator</classname></type></method>
  1345. <method name="begin" cv="const"><type><classname>const_iterator</classname></type></method>
  1346. <method name="cbegin" cv="const"><type><classname>const_iterator</classname></type></method>
  1347. <method name="end"><type><classname>iterator</classname></type></method>
  1348. <method name="end" cv="const"><type><classname>const_iterator</classname></type></method>
  1349. <method name="cend" cv="const"><type><classname>const_iterator</classname></type></method>
  1350. <method name="rbegin"><type>reverse_iterator</type></method>
  1351. <method name="rbegin" cv="const"><type>const_reverse_iterator</type></method>
  1352. <method name="crbegin" cv="const"><type>const_reverse_iterator</type></method>
  1353. <method name="rend"><type>reverse_iterator</type></method>
  1354. <method name="rend" cv="const"><type>const_reverse_iterator</type></method>
  1355. <method name="crend" cv="const"><type>const_reverse_iterator</type></method>
  1356. <method name="empty" cv="const"><type>bool</type></method>
  1357. <method name="size" cv="const"><type>size_type</type></method>
  1358. <method name="length" cv="const"><type>size_type</type></method>
  1359. <method name="max_size" cv="const"><type>size_type</type></method>
  1360. <method name="reserve"><type>void</type><parameter name="size"><paramtype>size_type</paramtype></parameter></method>
  1361. <method name="capacity" cv="const"><type>size_type</type></method>
  1362. <method name="shrink_to_fit"><type>void</type></method>
  1363. <method name="clear"><type>void</type></method>
  1364. <method name="swap"><type>void</type><parameter name="other"><paramtype><classname>basic_string</classname>&lt; CharT, Traits &gt; &amp;</paramtype></parameter></method>
  1365. <method name="substr" cv="const"><type><classname>basic_string</classname>&lt; CharT, Traits &gt;</type><parameter name="pos"><paramtype>size_type</paramtype><default>0</default></parameter><parameter name="count"><paramtype>size_type</paramtype><default>npos</default></parameter></method>
  1366. <method name="find" cv="const"><type>size_type</type><parameter name="ch"><paramtype>CharT</paramtype></parameter><parameter name="pos"><paramtype>size_type</paramtype><default>0</default></parameter><purpose>Finds the first character <computeroutput>ch</computeroutput>. </purpose></method>
  1367. <method name="find" cv="const"><type>size_type</type><parameter name="str"><paramtype><classname>basic_string</classname> &amp;</paramtype></parameter><parameter name="pos"><paramtype>size_type</paramtype><default>0</default></parameter><purpose>Finds the first substring equal to <computeroutput>str</computeroutput>. </purpose></method>
  1368. <method name="find" cv="const"><type>size_type</type><parameter name="s"><paramtype>const char *</paramtype></parameter><parameter name="pos"><paramtype>size_type</paramtype><default>0</default></parameter><description><para>Finds the first substring equal to the character string pointed to by <computeroutput>s</computeroutput>. The length of the string is determined by the first null character.</para><para>For example, the following code <programlisting language="c++"/> will return 5 as position. </para></description></method>
  1369. </method-group>
  1370. <constructor/>
  1371. <constructor><parameter name="count"><paramtype>size_type</paramtype></parameter><parameter name="ch"><paramtype>CharT</paramtype></parameter></constructor>
  1372. <constructor><parameter name="other"><paramtype>const <classname>basic_string</classname> &amp;</paramtype></parameter><parameter name="pos"><paramtype>size_type</paramtype></parameter><parameter name="count"><paramtype>size_type</paramtype><default>npos</default></parameter></constructor>
  1373. <constructor><parameter name="s"><paramtype>const char *</paramtype></parameter><parameter name="count"><paramtype>size_type</paramtype></parameter></constructor>
  1374. <constructor><parameter name="s"><paramtype>const char *</paramtype></parameter></constructor>
  1375. <constructor><template>
  1376. <template-type-parameter name="InputIterator"/>
  1377. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter></constructor>
  1378. <constructor><parameter name="other"><paramtype>const <classname>basic_string</classname>&lt; CharT, Traits &gt; &amp;</paramtype></parameter></constructor>
  1379. <copy-assignment><type><classname>basic_string</classname>&lt; CharT, Traits &gt; &amp;</type><parameter name="other"><paramtype>const <classname>basic_string</classname>&lt; CharT, Traits &gt; &amp;</paramtype></parameter></copy-assignment>
  1380. <destructor/>
  1381. </class>
  1382. <function name="operator&lt;&lt;"><type>std::ostream &amp;</type><template>
  1383. <template-type-parameter name="CharT"/>
  1384. <template-type-parameter name="Traits"/>
  1385. </template><parameter name="stream"><paramtype>std::ostream &amp;</paramtype></parameter><parameter name="outStr"><paramtype><classname>boost::compute::basic_string</classname>&lt; CharT, Traits &gt;const &amp;</paramtype></parameter></function>
  1386. </namespace>
  1387. </namespace>
  1388. </header>
  1389. <header name="boost/compute/container/dynamic_bitset.hpp">
  1390. <namespace name="boost">
  1391. <namespace name="compute">
  1392. <class name="dynamic_bitset"><template>
  1393. <template-type-parameter name="Block"><default>ulong_</default></template-type-parameter>
  1394. <template-type-parameter name="Alloc"><default><classname alt="boost::compute::buffer_allocator">buffer_allocator</classname>&lt;Block&gt;</default></template-type-parameter>
  1395. </template><purpose>The <classname alt="boost::compute::dynamic_bitset">dynamic_bitset</classname> class contains a resizable bit array. </purpose><description><para>For example, to create a dynamic-bitset with space for 1000 bits on the device: <programlisting language="c++">boost::compute::dynamic_bitset&lt;&gt; bits(1000, queue);
  1396. </programlisting></para><para>The Boost.Compute <computeroutput><classname alt="boost::compute::dynamic_bitset">dynamic_bitset</classname></computeroutput> class provides a STL-like API and is modeled after the <computeroutput>boost::dynamic_bitset</computeroutput> class from Boost.</para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::vector">vector&lt;T&gt;</classname> </para>
  1397. </para>
  1398. </para></description><typedef name="block_type"><type>Block</type></typedef>
  1399. <typedef name="allocator_type"><type>Alloc</type></typedef>
  1400. <typedef name="container_type"><type><classname>vector</classname>&lt; Block, Alloc &gt;</type></typedef>
  1401. <typedef name="size_type"><type>container_type::size_type</type></typedef>
  1402. <method-group name="public member functions">
  1403. <method name="BOOST_STATIC_CONSTANT"><type/><parameter name=""><paramtype>size_type</paramtype></parameter><parameter name=""><paramtype>bits_per_block</paramtype><default>sizeof(block_type) *CHAR_BIT</default></parameter></method>
  1404. <method name="BOOST_STATIC_CONSTANT"><type/><parameter name=""><paramtype>size_type</paramtype></parameter><parameter name=""><paramtype>npos</paramtype><default>static_cast&lt; size_type &gt;(-1)</default></parameter></method>
  1405. <method name="size" cv="const"><type>size_type</type><purpose>Returns the size of the dynamic bitset. </purpose></method>
  1406. <method name="num_blocks" cv="const"><type>size_type</type><purpose>Returns the number of blocks to store the bits in the dynamic bitset. </purpose></method>
  1407. <method name="max_size" cv="const"><type>size_type</type><purpose>Returns the maximum possible size for the dynamic bitset. </purpose></method>
  1408. <method name="empty" cv="const"><type>bool</type><purpose>Returns <computeroutput>true</computeroutput> if the dynamic bitset is empty (i.e. <computeroutput>size()</computeroutput> == <computeroutput>0</computeroutput>). </purpose></method>
  1409. <method name="count" cv="const"><type>size_type</type><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><purpose>Returns the number of set bits (i.e. '1') in the bitset. </purpose></method>
  1410. <method name="resize"><type>void</type><parameter name="num_bits"><paramtype>size_type</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>Resizes the bitset to contain <computeroutput>num_bits</computeroutput>. If the new size is greater than the current size the new bits are set to zero. </para></description></method>
  1411. <method name="set"><type>void</type><parameter name="n"><paramtype>size_type</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><purpose>Sets the bit at position <computeroutput>n</computeroutput> to <computeroutput>true</computeroutput>. </purpose></method>
  1412. <method name="set"><type>void</type><parameter name="n"><paramtype>size_type</paramtype></parameter><parameter name="value"><paramtype>bool</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><purpose>Sets the bit at position <computeroutput>n</computeroutput> to <computeroutput>value</computeroutput>. </purpose></method>
  1413. <method name="test"><type>bool</type><parameter name="n"><paramtype>size_type</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><purpose>Returns <computeroutput>true</computeroutput> if the bit at position <computeroutput>n</computeroutput> is set (i.e. '1'). </purpose></method>
  1414. <method name="flip"><type>void</type><parameter name="n"><paramtype>size_type</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><purpose>Flips the value of the bit at position <computeroutput>n</computeroutput>. </purpose></method>
  1415. <method name="any" cv="const"><type>bool</type><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><purpose>Returns <computeroutput>true</computeroutput> if any bit in the bitset is set (i.e. '1'). </purpose></method>
  1416. <method name="none" cv="const"><type>bool</type><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><purpose>Returns <computeroutput>true</computeroutput> if all of the bits in the bitset are set to zero. </purpose></method>
  1417. <method name="reset"><type>void</type><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><purpose>Sets all of the bits in the bitset to zero. </purpose></method>
  1418. <method name="reset"><type>void</type><parameter name="n"><paramtype>size_type</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><purpose>Sets the bit at position <computeroutput>n</computeroutput> to zero. </purpose></method>
  1419. <method name="clear"><type>void</type><purpose>Empties the bitset (e.g. <computeroutput>resize(0)</computeroutput>). </purpose></method>
  1420. <method name="get_allocator" cv="const"><type>allocator_type</type><purpose>Returns the allocator used to allocate storage for the bitset. </purpose></method>
  1421. </method-group>
  1422. <constructor><parameter name="size"><paramtype>size_type</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>Creates a new dynamic bitset with storage for <computeroutput>size</computeroutput> bits. Initializes all bits to zero. </para></description></constructor>
  1423. <constructor><parameter name="other"><paramtype>const <classname>dynamic_bitset</classname> &amp;</paramtype></parameter><purpose>Creates a new dynamic bitset as a copy of <computeroutput>other</computeroutput>. </purpose></constructor>
  1424. <copy-assignment><type><classname>dynamic_bitset</classname> &amp;</type><parameter name="other"><paramtype>const <classname>dynamic_bitset</classname> &amp;</paramtype></parameter><purpose>Copies the data from <computeroutput>other</computeroutput> to <computeroutput>*this</computeroutput>. </purpose></copy-assignment>
  1425. <destructor><purpose>Destroys the dynamic bitset. </purpose></destructor>
  1426. </class>
  1427. </namespace>
  1428. </namespace>
  1429. </header>
  1430. <header name="boost/compute/container/flat_map.hpp">
  1431. <namespace name="boost">
  1432. <namespace name="compute">
  1433. <class name="flat_map"><template>
  1434. <template-type-parameter name="Key"/>
  1435. <template-type-parameter name="T"/>
  1436. </template><typedef name="key_type"><type>Key</type></typedef>
  1437. <typedef name="mapped_type"><type>T</type></typedef>
  1438. <typedef name="vector_type"><type>::<classname>boost::compute::vector</classname>&lt; std::pair&lt; Key, T &gt; &gt;</type></typedef>
  1439. <typedef name="value_type"><type>vector_type::value_type</type></typedef>
  1440. <typedef name="size_type"><type>vector_type::size_type</type></typedef>
  1441. <typedef name="difference_type"><type>vector_type::difference_type</type></typedef>
  1442. <typedef name="reference"><type>vector_type::reference</type></typedef>
  1443. <typedef name="const_reference"><type>vector_type::const_reference</type></typedef>
  1444. <typedef name="pointer"><type>vector_type::pointer</type></typedef>
  1445. <typedef name="const_pointer"><type>vector_type::const_pointer</type></typedef>
  1446. <typedef name="iterator"><type><classname>vector_type::iterator</classname></type></typedef>
  1447. <typedef name="const_iterator"><type><classname>vector_type::const_iterator</classname></type></typedef>
  1448. <typedef name="reverse_iterator"><type>vector_type::reverse_iterator</type></typedef>
  1449. <typedef name="const_reverse_iterator"><type>vector_type::const_reverse_iterator</type></typedef>
  1450. <method-group name="public member functions">
  1451. <method name="begin"><type><classname>iterator</classname></type></method>
  1452. <method name="begin" cv="const"><type><classname>const_iterator</classname></type></method>
  1453. <method name="cbegin" cv="const"><type><classname>const_iterator</classname></type></method>
  1454. <method name="end"><type><classname>iterator</classname></type></method>
  1455. <method name="end" cv="const"><type><classname>const_iterator</classname></type></method>
  1456. <method name="cend" cv="const"><type><classname>const_iterator</classname></type></method>
  1457. <method name="rbegin"><type>reverse_iterator</type></method>
  1458. <method name="rbegin" cv="const"><type>const_reverse_iterator</type></method>
  1459. <method name="crbegin" cv="const"><type>const_reverse_iterator</type></method>
  1460. <method name="rend"><type>reverse_iterator</type></method>
  1461. <method name="rend" cv="const"><type>const_reverse_iterator</type></method>
  1462. <method name="crend" cv="const"><type>const_reverse_iterator</type></method>
  1463. <method name="size" cv="const"><type>size_type</type></method>
  1464. <method name="max_size" cv="const"><type>size_type</type></method>
  1465. <method name="empty" cv="const"><type>bool</type></method>
  1466. <method name="capacity" cv="const"><type>size_type</type></method>
  1467. <method name="reserve"><type>void</type><parameter name="size"><paramtype>size_type</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1468. <method name="reserve"><type>void</type><parameter name="size"><paramtype>size_type</paramtype></parameter></method>
  1469. <method name="shrink_to_fit"><type>void</type></method>
  1470. <method name="clear"><type>void</type></method>
  1471. <method name="insert"><type>std::pair&lt; <classname>iterator</classname>, bool &gt;</type><parameter name="value"><paramtype>const value_type &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1472. <method name="insert"><type>std::pair&lt; <classname>iterator</classname>, bool &gt;</type><parameter name="value"><paramtype>const value_type &amp;</paramtype></parameter></method>
  1473. <method name="erase"><type><classname>iterator</classname></type><parameter name="position"><paramtype>const <classname>const_iterator</classname> &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1474. <method name="erase"><type><classname>iterator</classname></type><parameter name="position"><paramtype>const <classname>const_iterator</classname> &amp;</paramtype></parameter></method>
  1475. <method name="erase"><type><classname>iterator</classname></type><parameter name="first"><paramtype>const <classname>const_iterator</classname> &amp;</paramtype></parameter><parameter name="last"><paramtype>const <classname>const_iterator</classname> &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1476. <method name="erase"><type><classname>iterator</classname></type><parameter name="first"><paramtype>const <classname>const_iterator</classname> &amp;</paramtype></parameter><parameter name="last"><paramtype>const <classname>const_iterator</classname> &amp;</paramtype></parameter></method>
  1477. <method name="erase"><type>size_type</type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1478. <method name="find"><type><classname>iterator</classname></type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1479. <method name="find"><type><classname>iterator</classname></type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter></method>
  1480. <method name="find" cv="const"><type><classname>const_iterator</classname></type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1481. <method name="find" cv="const"><type><classname>const_iterator</classname></type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter></method>
  1482. <method name="count" cv="const"><type>size_type</type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1483. <method name="count" cv="const"><type>size_type</type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter></method>
  1484. <method name="lower_bound"><type><classname>iterator</classname></type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1485. <method name="lower_bound"><type><classname>iterator</classname></type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter></method>
  1486. <method name="lower_bound" cv="const"><type><classname>const_iterator</classname></type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1487. <method name="lower_bound" cv="const"><type><classname>const_iterator</classname></type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter></method>
  1488. <method name="upper_bound"><type><classname>iterator</classname></type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1489. <method name="upper_bound"><type><classname>iterator</classname></type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter></method>
  1490. <method name="upper_bound" cv="const"><type><classname>const_iterator</classname></type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1491. <method name="upper_bound" cv="const"><type><classname>const_iterator</classname></type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter></method>
  1492. <method name="at" cv="const"><type>const mapped_type</type><parameter name="key"><paramtype>const key_type &amp;</paramtype></parameter></method>
  1493. <method name="operator[]"><type><emphasis>unspecified</emphasis></type><parameter name="key"><paramtype>const key_type &amp;</paramtype></parameter></method>
  1494. </method-group>
  1495. <constructor specifiers="explicit"><parameter name="context"><paramtype>const context &amp;</paramtype><default>system::default_context()</default></parameter></constructor>
  1496. <constructor><parameter name="other"><paramtype>const flat_map&lt; Key, T &gt; &amp;</paramtype></parameter></constructor>
  1497. <copy-assignment><type>flat_map&lt; Key, T &gt; &amp;</type><parameter name="other"><paramtype>const flat_map&lt; Key, T &gt; &amp;</paramtype></parameter></copy-assignment>
  1498. <destructor/>
  1499. </class>
  1500. </namespace>
  1501. </namespace>
  1502. </header>
  1503. <header name="boost/compute/container/flat_set.hpp">
  1504. <namespace name="boost">
  1505. <namespace name="compute">
  1506. <class name="flat_set"><template>
  1507. <template-type-parameter name="T"/>
  1508. </template><typedef name="key_type"><type>T</type></typedef>
  1509. <typedef name="value_type"><type><classname>vector</classname>&lt; T &gt;::value_type</type></typedef>
  1510. <typedef name="size_type"><type><classname>vector</classname>&lt; T &gt;::size_type</type></typedef>
  1511. <typedef name="difference_type"><type><classname>vector</classname>&lt; T &gt;::difference_type</type></typedef>
  1512. <typedef name="reference"><type><classname>vector</classname>&lt; T &gt;::reference</type></typedef>
  1513. <typedef name="const_reference"><type><classname>vector</classname>&lt; T &gt;::const_reference</type></typedef>
  1514. <typedef name="pointer"><type><classname>vector</classname>&lt; T &gt;::pointer</type></typedef>
  1515. <typedef name="const_pointer"><type><classname>vector</classname>&lt; T &gt;::const_pointer</type></typedef>
  1516. <typedef name="iterator"><type><classname>vector</classname>&lt; T &gt;::iterator</type></typedef>
  1517. <typedef name="const_iterator"><type><classname>vector</classname>&lt; T &gt;::const_iterator</type></typedef>
  1518. <typedef name="reverse_iterator"><type><classname>vector</classname>&lt; T &gt;::reverse_iterator</type></typedef>
  1519. <typedef name="const_reverse_iterator"><type><classname>vector</classname>&lt; T &gt;::const_reverse_iterator</type></typedef>
  1520. <method-group name="public member functions">
  1521. <method name="begin"><type>iterator</type></method>
  1522. <method name="begin" cv="const"><type>const_iterator</type></method>
  1523. <method name="cbegin" cv="const"><type>const_iterator</type></method>
  1524. <method name="end"><type>iterator</type></method>
  1525. <method name="end" cv="const"><type>const_iterator</type></method>
  1526. <method name="cend" cv="const"><type>const_iterator</type></method>
  1527. <method name="rbegin"><type>reverse_iterator</type></method>
  1528. <method name="rbegin" cv="const"><type>const_reverse_iterator</type></method>
  1529. <method name="crbegin" cv="const"><type>const_reverse_iterator</type></method>
  1530. <method name="rend"><type>reverse_iterator</type></method>
  1531. <method name="rend" cv="const"><type>const_reverse_iterator</type></method>
  1532. <method name="crend" cv="const"><type>const_reverse_iterator</type></method>
  1533. <method name="size" cv="const"><type>size_type</type></method>
  1534. <method name="max_size" cv="const"><type>size_type</type></method>
  1535. <method name="empty" cv="const"><type>bool</type></method>
  1536. <method name="capacity" cv="const"><type>size_type</type></method>
  1537. <method name="reserve"><type>void</type><parameter name="size"><paramtype>size_type</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1538. <method name="reserve"><type>void</type><parameter name="size"><paramtype>size_type</paramtype></parameter></method>
  1539. <method name="shrink_to_fit"><type>void</type></method>
  1540. <method name="clear"><type>void</type></method>
  1541. <method name="insert"><type>std::pair&lt; iterator, bool &gt;</type><parameter name="value"><paramtype>const value_type &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1542. <method name="insert"><type>std::pair&lt; iterator, bool &gt;</type><parameter name="value"><paramtype>const value_type &amp;</paramtype></parameter></method>
  1543. <method name="erase"><type>iterator</type><parameter name="position"><paramtype>const const_iterator &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1544. <method name="erase"><type>iterator</type><parameter name="position"><paramtype>const const_iterator &amp;</paramtype></parameter></method>
  1545. <method name="erase"><type>iterator</type><parameter name="first"><paramtype>const const_iterator &amp;</paramtype></parameter><parameter name="last"><paramtype>const const_iterator &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1546. <method name="erase"><type>iterator</type><parameter name="first"><paramtype>const const_iterator &amp;</paramtype></parameter><parameter name="last"><paramtype>const const_iterator &amp;</paramtype></parameter></method>
  1547. <method name="erase"><type>size_type</type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1548. <method name="erase"><type>size_type</type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter></method>
  1549. <method name="find"><type>iterator</type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1550. <method name="find"><type>iterator</type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter></method>
  1551. <method name="find" cv="const"><type>const_iterator</type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1552. <method name="find" cv="const"><type>const_iterator</type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter></method>
  1553. <method name="count" cv="const"><type>size_type</type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1554. <method name="count" cv="const"><type>size_type</type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter></method>
  1555. <method name="lower_bound"><type>iterator</type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1556. <method name="lower_bound"><type>iterator</type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter></method>
  1557. <method name="lower_bound" cv="const"><type>const_iterator</type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1558. <method name="lower_bound" cv="const"><type>const_iterator</type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter></method>
  1559. <method name="upper_bound"><type>iterator</type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1560. <method name="upper_bound"><type>iterator</type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter></method>
  1561. <method name="upper_bound" cv="const"><type>const_iterator</type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1562. <method name="upper_bound" cv="const"><type>const_iterator</type><parameter name="value"><paramtype>const key_type &amp;</paramtype></parameter></method>
  1563. </method-group>
  1564. <constructor specifiers="explicit"><parameter name="context"><paramtype>const context &amp;</paramtype><default>system::default_context()</default></parameter></constructor>
  1565. <constructor><parameter name="other"><paramtype>const flat_set&lt; T &gt; &amp;</paramtype></parameter></constructor>
  1566. <copy-assignment><type>flat_set&lt; T &gt; &amp;</type><parameter name="other"><paramtype>const flat_set&lt; T &gt; &amp;</paramtype></parameter></copy-assignment>
  1567. <destructor/>
  1568. </class>
  1569. </namespace>
  1570. </namespace>
  1571. </header>
  1572. <header name="boost/compute/container/mapped_view.hpp">
  1573. <namespace name="boost">
  1574. <namespace name="compute">
  1575. <class name="mapped_view"><template>
  1576. <template-type-parameter name="T"/>
  1577. </template><purpose>A mapped view of host memory. </purpose><description><para>The <classname alt="boost::compute::mapped_view">mapped_view</classname> class simplifies mapping host-memory to a compute device. This allows for host-allocated memory to be used with the Boost.Compute algorithms.</para><para>The following example shows how to map a simple C-array containing data on the host to the device and run the reduce() algorithm to calculate the sum:</para><para><programlisting language="c++"/> <para><emphasis role="bold">See Also:</emphasis><para>buffer </para>
  1578. </para>
  1579. </para></description><typedef name="value_type"><type>T</type></typedef>
  1580. <typedef name="size_type"><type>size_t</type></typedef>
  1581. <typedef name="difference_type"><type>ptrdiff_t</type></typedef>
  1582. <typedef name="iterator"><type><classname>buffer_iterator</classname>&lt; T &gt;</type></typedef>
  1583. <typedef name="const_iterator"><type><classname>buffer_iterator</classname>&lt; T &gt;</type></typedef>
  1584. <method-group name="public member functions">
  1585. <method name="begin"><type><classname>iterator</classname></type><purpose>Returns an iterator to the first element in the <classname alt="boost::compute::mapped_view">mapped_view</classname>. </purpose></method>
  1586. <method name="begin" cv="const"><type><classname>const_iterator</classname></type><purpose>Returns a const_iterator to the first element in the <classname alt="boost::compute::mapped_view">mapped_view</classname>. </purpose></method>
  1587. <method name="cbegin" cv="const"><type><classname>const_iterator</classname></type><purpose>Returns a const_iterator to the first element in the <classname alt="boost::compute::mapped_view">mapped_view</classname>. </purpose></method>
  1588. <method name="end"><type><classname>iterator</classname></type><purpose>Returns an iterator to one past the last element in the <classname alt="boost::compute::mapped_view">mapped_view</classname>. </purpose></method>
  1589. <method name="end" cv="const"><type><classname>const_iterator</classname></type><purpose>Returns a const_iterator to one past the last element in the <classname alt="boost::compute::mapped_view">mapped_view</classname>. </purpose></method>
  1590. <method name="cend" cv="const"><type><classname>const_iterator</classname></type><purpose>Returns a const_iterator to one past the last element in the <classname alt="boost::compute::mapped_view">mapped_view</classname>. </purpose></method>
  1591. <method name="size" cv="const"><type>size_type</type><purpose>Returns the number of elements in the <classname alt="boost::compute::mapped_view">mapped_view</classname>. </purpose></method>
  1592. <method name="get_host_ptr"><type>T *</type><purpose>Returns the host data pointer. </purpose></method>
  1593. <method name="get_host_ptr" cv="const"><type>const T *</type><purpose>Returns the host data pointer. </purpose></method>
  1594. <method name="resize"><type>void</type><parameter name="size"><paramtype>size_type</paramtype></parameter><purpose>Resizes the <classname alt="boost::compute::mapped_view">mapped_view</classname> to <computeroutput>size</computeroutput> elements. </purpose></method>
  1595. <method name="empty" cv="const"><type>bool</type><purpose>Returns <computeroutput>true</computeroutput> if the <classname alt="boost::compute::mapped_view">mapped_view</classname> is empty. </purpose></method>
  1596. <method name="get_buffer" cv="const"><type>const buffer &amp;</type><purpose>Returns the mapped buffer. </purpose></method>
  1597. <method name="map"><type>void</type><parameter name="flags"><paramtype>cl_map_flags</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>Maps the buffer into the host address space.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clEnqueueMapBuffer.html">clEnqueueMapBuffer()</ulink> for more information. </para></description></method>
  1598. <method name="map"><type>void</type><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>Maps the buffer into the host address space for reading and writing.</para><para>Equivalent to: <programlisting language="c++">map(CL_MAP_READ | CL_MAP_WRITE, queue);
  1599. </programlisting> </para></description></method>
  1600. <method name="unmap"><type>void</type><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>Unmaps the buffer from the host address space.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clEnqueueUnmapMemObject.html">clEnqueueUnmapMemObject()</ulink> for more information. </para></description></method>
  1601. </method-group>
  1602. <constructor><purpose>Creates a null <classname alt="boost::compute::mapped_view">mapped_view</classname> object. </purpose></constructor>
  1603. <constructor><parameter name="host_ptr"><paramtype>T *</paramtype></parameter><parameter name="n"><paramtype>size_type</paramtype></parameter><parameter name="context"><paramtype>const context &amp;</paramtype><default>system::default_context()</default></parameter><description><para>Creates a <classname alt="boost::compute::mapped_view">mapped_view</classname> for <computeroutput>host_ptr</computeroutput> with <computeroutput>n</computeroutput> elements. After constructing a <classname alt="boost::compute::mapped_view">mapped_view</classname> the data is available for use by a compute device. Use the <computeroutput>unmap()</computeroutput> method to make the updated data available to the host. </para></description></constructor>
  1604. <constructor><parameter name="host_ptr"><paramtype>const T *</paramtype></parameter><parameter name="n"><paramtype>size_type</paramtype></parameter><parameter name="context"><paramtype>const context &amp;</paramtype><default>system::default_context()</default></parameter><description><para>Creates a read-only <classname alt="boost::compute::mapped_view">mapped_view</classname> for <computeroutput>host_ptr</computeroutput> with <computeroutput>n</computeroutput> elements. After constructing a <classname alt="boost::compute::mapped_view">mapped_view</classname> the data is available for use by a compute device. Use the <computeroutput>unmap()</computeroutput> method to make the updated data available to the host. </para></description></constructor>
  1605. <constructor><parameter name="other"><paramtype>const <classname>mapped_view</classname>&lt; T &gt; &amp;</paramtype></parameter><purpose>Creates a copy of <computeroutput>other</computeroutput>. </purpose></constructor>
  1606. <copy-assignment><type><classname>mapped_view</classname>&lt; T &gt; &amp;</type><parameter name="other"><paramtype>const <classname>mapped_view</classname>&lt; T &gt; &amp;</paramtype></parameter><purpose>Copies the mapped buffer from <computeroutput>other</computeroutput>. </purpose></copy-assignment>
  1607. <destructor><purpose>Destroys the <classname alt="boost::compute::mapped_view">mapped_view</classname> object. </purpose></destructor>
  1608. <method-group name="private static functions">
  1609. </method-group>
  1610. </class>
  1611. </namespace>
  1612. </namespace>
  1613. </header>
  1614. <header name="boost/compute/container/stack.hpp">
  1615. <namespace name="boost">
  1616. <namespace name="compute">
  1617. <class name="stack"><template>
  1618. <template-type-parameter name="T"/>
  1619. </template><typedef name="container_type"><type><classname>vector</classname>&lt; T &gt;</type></typedef>
  1620. <typedef name="size_type"><type>container_type::size_type</type></typedef>
  1621. <typedef name="value_type"><type>container_type::value_type</type></typedef>
  1622. <method-group name="public member functions">
  1623. <method name="empty" cv="const"><type>bool</type></method>
  1624. <method name="size" cv="const"><type>size_type</type></method>
  1625. <method name="top" cv="const"><type>value_type</type></method>
  1626. <method name="push"><type>void</type><parameter name="value"><paramtype>const T &amp;</paramtype></parameter></method>
  1627. <method name="pop"><type>void</type></method>
  1628. </method-group>
  1629. <constructor/>
  1630. <constructor><parameter name="other"><paramtype>const stack&lt; T &gt; &amp;</paramtype></parameter></constructor>
  1631. <copy-assignment><type>stack&lt; T &gt; &amp;</type><parameter name="other"><paramtype>const stack&lt; T &gt; &amp;</paramtype></parameter></copy-assignment>
  1632. <destructor/>
  1633. </class>
  1634. </namespace>
  1635. </namespace>
  1636. </header>
  1637. <header name="boost/compute/container/string.hpp">
  1638. <namespace name="boost">
  1639. <namespace name="compute">
  1640. <typedef name="string"><type><classname>basic_string</classname>&lt; char_ &gt;</type></typedef>
  1641. </namespace>
  1642. </namespace>
  1643. </header>
  1644. <header name="boost/compute/container/valarray.hpp">
  1645. <namespace name="boost">
  1646. <namespace name="compute">
  1647. <class name="valarray"><template>
  1648. <template-type-parameter name="T"/>
  1649. </template><method-group name="public member functions">
  1650. <method name="operator *="><type>valarray&lt; T &gt; &amp;</type><parameter name=""><paramtype>const T &amp;</paramtype></parameter></method>
  1651. <method name="operator/="><type>valarray&lt; T &gt; &amp;</type><parameter name=""><paramtype>const T &amp;</paramtype></parameter></method>
  1652. <method name="operator%="><type>valarray&lt; T &gt; &amp;</type><parameter name="val"><paramtype>const T &amp;</paramtype></parameter></method>
  1653. <method name="operator+" cv="const"><type>valarray&lt; T &gt;</type></method>
  1654. <method name="operator-" cv="const"><type>valarray&lt; T &gt;</type></method>
  1655. <method name="operator~" cv="const"><type>valarray&lt; T &gt;</type></method>
  1656. <method name="operator!" cv="const"><type>valarray&lt; char &gt;</type><description><para>In OpenCL there cannot be memory buffer with bool type, for this reason return type is valarray&lt;char&gt; instead of valarray&lt;bool&gt;. 1 means true, 0 means false. </para></description></method>
  1657. <method name="operator+="><type>valarray&lt; T &gt; &amp;</type><parameter name=""><paramtype>const T &amp;</paramtype></parameter></method>
  1658. <method name="operator-="><type>valarray&lt; T &gt; &amp;</type><parameter name=""><paramtype>const T &amp;</paramtype></parameter></method>
  1659. <method name="operator^="><type>valarray&lt; T &gt; &amp;</type><parameter name=""><paramtype>const T &amp;</paramtype></parameter></method>
  1660. <method name="operator&amp;="><type>valarray&lt; T &gt; &amp;</type><parameter name=""><paramtype>const T &amp;</paramtype></parameter></method>
  1661. <method name="operator|="><type>valarray&lt; T &gt; &amp;</type><parameter name=""><paramtype>const T &amp;</paramtype></parameter></method>
  1662. <method name="operator&lt;&lt;="><type>valarray&lt; T &gt; &amp;</type><parameter name=""><paramtype>const T &amp;</paramtype></parameter></method>
  1663. <method name="operator&gt;&gt;="><type>valarray&lt; T &gt; &amp;</type><parameter name=""><paramtype>const T &amp;</paramtype></parameter></method>
  1664. <method name="operator *="><type>valarray&lt; T &gt; &amp;</type><parameter name=""><paramtype>const valarray&lt; T &gt; &amp;</paramtype></parameter></method>
  1665. <method name="operator/="><type>valarray&lt; T &gt; &amp;</type><parameter name=""><paramtype>const valarray&lt; T &gt; &amp;</paramtype></parameter></method>
  1666. <method name="operator%="><type>valarray&lt; T &gt; &amp;</type><parameter name=""><paramtype>const valarray&lt; T &gt; &amp;</paramtype></parameter></method>
  1667. <method name="operator+="><type>valarray&lt; T &gt; &amp;</type><parameter name=""><paramtype>const valarray&lt; T &gt; &amp;</paramtype></parameter></method>
  1668. <method name="operator-="><type>valarray&lt; T &gt; &amp;</type><parameter name=""><paramtype>const valarray&lt; T &gt; &amp;</paramtype></parameter></method>
  1669. <method name="operator^="><type>valarray&lt; T &gt; &amp;</type><parameter name=""><paramtype>const valarray&lt; T &gt; &amp;</paramtype></parameter></method>
  1670. <method name="operator&amp;="><type>valarray&lt; T &gt; &amp;</type><parameter name=""><paramtype>const valarray&lt; T &gt; &amp;</paramtype></parameter></method>
  1671. <method name="operator|="><type>valarray&lt; T &gt; &amp;</type><parameter name=""><paramtype>const valarray&lt; T &gt; &amp;</paramtype></parameter></method>
  1672. <method name="operator&lt;&lt;="><type>valarray&lt; T &gt; &amp;</type><parameter name=""><paramtype>const valarray&lt; T &gt; &amp;</paramtype></parameter></method>
  1673. <method name="operator&gt;&gt;="><type>valarray&lt; T &gt; &amp;</type><parameter name=""><paramtype>const valarray&lt; T &gt; &amp;</paramtype></parameter></method>
  1674. <method name="size" cv="const"><type>size_t</type></method>
  1675. <method name="resize"><type>void</type><parameter name="size"><paramtype>size_t</paramtype></parameter><parameter name="value"><paramtype>T</paramtype><default>T()</default></parameter></method>
  1676. <method name="operator[]"><type><emphasis>unspecified</emphasis></type><parameter name="index"><paramtype>size_t</paramtype></parameter></method>
  1677. <method name="operator[]" cv="const"><type><emphasis>unspecified</emphasis></type><parameter name="index"><paramtype>size_t</paramtype></parameter></method>
  1678. <method name="min" cv="const"><type>T()</type></method>
  1679. <method name="max" cv="const"><type>T()</type></method>
  1680. <method name="sum" cv="const"><type>T</type></method>
  1681. <method name="apply" cv="const"><type>valarray&lt; T &gt;</type><template>
  1682. <template-type-parameter name="UnaryFunction"/>
  1683. </template><parameter name="function"><paramtype>UnaryFunction</paramtype></parameter></method>
  1684. <method name="get_buffer" cv="const"><type>const buffer &amp;</type></method>
  1685. </method-group>
  1686. <constructor specifiers="explicit"><parameter name="context"><paramtype>const context &amp;</paramtype><default>system::default_context()</default></parameter></constructor>
  1687. <constructor specifiers="explicit"><parameter name="size"><paramtype>size_t</paramtype></parameter><parameter name="context"><paramtype>const context &amp;</paramtype><default>system::default_context()</default></parameter></constructor>
  1688. <constructor><parameter name="value"><paramtype>const T &amp;</paramtype></parameter><parameter name="size"><paramtype>size_t</paramtype></parameter><parameter name="context"><paramtype>const context &amp;</paramtype><default>system::default_context()</default></parameter></constructor>
  1689. <constructor><parameter name="values"><paramtype>const T *</paramtype></parameter><parameter name="size"><paramtype>size_t</paramtype></parameter><parameter name="context"><paramtype>const context &amp;</paramtype><default>system::default_context()</default></parameter></constructor>
  1690. <constructor><parameter name="other"><paramtype>const valarray&lt; T &gt; &amp;</paramtype></parameter></constructor>
  1691. <constructor><parameter name="valarray"><paramtype>const std::valarray&lt; T &gt; &amp;</paramtype></parameter><parameter name="context"><paramtype>const context &amp;</paramtype><default>system::default_context()</default></parameter></constructor>
  1692. <copy-assignment><type>valarray&lt; T &gt; &amp;</type><parameter name="other"><paramtype>const valarray&lt; T &gt; &amp;</paramtype></parameter></copy-assignment>
  1693. <copy-assignment><type>valarray&lt; T &gt; &amp;</type><parameter name="valarray"><paramtype>const std::valarray&lt; T &gt; &amp;</paramtype></parameter></copy-assignment>
  1694. <destructor/>
  1695. <method-group name="private member functions">
  1696. <method name="begin" cv="const"><type><classname>buffer_iterator</classname>&lt; T &gt;</type></method>
  1697. <method name="end" cv="const"><type><classname>buffer_iterator</classname>&lt; T &gt;</type></method>
  1698. </method-group>
  1699. </class>
  1700. </namespace>
  1701. </namespace>
  1702. <macro name="BOOST_COMPUTE_DEFINE_VALARRAY_BINARY_OPERATOR" kind="functionlike"><macro-parameter name="op"/><macro-parameter name="op_name"/><macro-parameter name="assert"/></macro>
  1703. <macro name="BOOST_COMPUTE_DEFINE_VALARRAY_BINARY_OPERATOR_ANY" kind="functionlike"><macro-parameter name="op"/><macro-parameter name="op_name"/></macro>
  1704. <macro name="BOOST_COMPUTE_DEFINE_VALARRAY_BINARY_OPERATOR_NO_FP" kind="functionlike"><macro-parameter name="op"/><macro-parameter name="op_name"/></macro>
  1705. <macro name="BOOST_COMPUTE_DEFINE_VALARRAY_COMPARISON_OPERATOR" kind="functionlike"><macro-parameter name="op"/><macro-parameter name="op_name"/></macro>
  1706. <macro name="BOOST_COMPUTE_DEFINE_VALARRAY_LOGICAL_OPERATOR" kind="functionlike"><macro-parameter name="op"/><macro-parameter name="op_name"/></macro>
  1707. </header>
  1708. <header name="boost/compute/container/vector.hpp">
  1709. <namespace name="boost">
  1710. <namespace name="compute">
  1711. <class name="vector"><template>
  1712. <template-type-parameter name="T"/>
  1713. <template-type-parameter name="Alloc"><default><classname alt="boost::compute::buffer_allocator">buffer_allocator</classname>&lt;T&gt;</default></template-type-parameter>
  1714. </template><purpose>A resizable array of values. </purpose><description><para>The <classname alt="boost::compute::vector">vector&lt;T&gt;</classname> class stores a dynamic array of values. Internally, the data is stored in an OpenCL buffer object.</para><para>The vector class is the prefered container for storing and accessing data on a compute device. In most cases it should be used instead of directly dealing with buffer objects. If the undelying buffer is needed, it can be accessed with the get_buffer() method.</para><para>The internal storage is allocated in a specific OpenCL context which is passed as an argument to the constructor when the vector is created.</para><para>For example, to create a vector on the device containing space for ten <computeroutput>int</computeroutput> values: <programlisting language="c++">boost::compute::vector&lt;int&gt; vec(10, context);
  1715. </programlisting></para><para>Allocation and data transfer can also be performed in a single step: <programlisting language="c++">// values on the host
  1716. int data[] = { 1, 2, 3, 4 };
  1717. // create a vector of size four and copy the values from data
  1718. boost::compute::vector&lt;int&gt; vec(data, data + 4, queue);
  1719. </programlisting></para><para>The Boost.Compute <computeroutput>vector</computeroutput> class provides a STL-like API and is modeled after the <computeroutput>std::vector</computeroutput> class from the C++ standard library. It can be used with any of the STL-like algorithms provided by Boost.Compute including <computeroutput>copy()</computeroutput>, <computeroutput>transform()</computeroutput>, and <computeroutput>sort()</computeroutput> (among many others).</para><para>For example: <programlisting language="c++">// a vector on a compute device
  1720. boost::compute::vector&lt;float&gt; vec = ...
  1721. // copy data to the vector from a host std:vector
  1722. boost::compute::copy(host_vec.begin(), host_vec.end(), vec.begin(), queue);
  1723. // copy data from the vector to a host std::vector
  1724. boost::compute::copy(vec.begin(), vec.end(), host_vec.begin(), queue);
  1725. // sort the values in the vector
  1726. boost::compute::sort(vec.begin(), vec.end(), queue);
  1727. // calculate the sum of the values in the vector (also see reduce())
  1728. float sum = boost::compute::accumulate(vec.begin(), vec.end(), 0, queue);
  1729. // reverse the values in the vector
  1730. boost::compute::reverse(vec.begin(), vec.end(), queue);
  1731. // fill the vector with ones
  1732. boost::compute::fill(vec.begin(), vec.end(), 1, queue);
  1733. </programlisting></para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::array">array&lt;T, N&gt;</classname>, buffer </para>
  1734. </para>
  1735. </para></description><typedef name="value_type"><type>T</type></typedef>
  1736. <typedef name="allocator_type"><type>Alloc</type></typedef>
  1737. <typedef name="size_type"><type>allocator_type::size_type</type></typedef>
  1738. <typedef name="difference_type"><type>allocator_type::difference_type</type></typedef>
  1739. <typedef name="reference"><type><emphasis>unspecified</emphasis></type></typedef>
  1740. <typedef name="const_reference"><type><emphasis>unspecified</emphasis></type></typedef>
  1741. <typedef name="pointer"><type>allocator_type::pointer</type></typedef>
  1742. <typedef name="const_pointer"><type>allocator_type::const_pointer</type></typedef>
  1743. <typedef name="iterator"><type><classname>buffer_iterator</classname>&lt; T &gt;</type></typedef>
  1744. <typedef name="const_iterator"><type><classname>buffer_iterator</classname>&lt; T &gt;</type></typedef>
  1745. <typedef name="reverse_iterator"><type>std::reverse_iterator&lt; <classname>iterator</classname> &gt;</type></typedef>
  1746. <typedef name="const_reverse_iterator"><type>std::reverse_iterator&lt; <classname>const_iterator</classname> &gt;</type></typedef>
  1747. <method-group name="public member functions">
  1748. <method name="begin"><type><classname>iterator</classname></type></method>
  1749. <method name="begin" cv="const"><type><classname>const_iterator</classname></type></method>
  1750. <method name="cbegin" cv="const"><type><classname>const_iterator</classname></type></method>
  1751. <method name="end"><type><classname>iterator</classname></type></method>
  1752. <method name="end" cv="const"><type><classname>const_iterator</classname></type></method>
  1753. <method name="cend" cv="const"><type><classname>const_iterator</classname></type></method>
  1754. <method name="rbegin"><type>reverse_iterator</type></method>
  1755. <method name="rbegin" cv="const"><type>const_reverse_iterator</type></method>
  1756. <method name="crbegin" cv="const"><type>const_reverse_iterator</type></method>
  1757. <method name="rend"><type>reverse_iterator</type></method>
  1758. <method name="rend" cv="const"><type>const_reverse_iterator</type></method>
  1759. <method name="crend" cv="const"><type>const_reverse_iterator</type></method>
  1760. <method name="size" cv="const"><type>size_type</type><purpose>Returns the number of elements in the vector. </purpose></method>
  1761. <method name="max_size" cv="const"><type>size_type</type></method>
  1762. <method name="resize"><type>void</type><parameter name="size"><paramtype>size_type</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><purpose>Resizes the vector to <computeroutput>size</computeroutput>. </purpose></method>
  1763. <method name="resize"><type>void</type><parameter name="size"><paramtype>size_type</paramtype></parameter><description><para>This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. </para></description></method>
  1764. <method name="empty" cv="const"><type>bool</type><purpose>Returns <computeroutput>true</computeroutput> if the vector is empty. </purpose></method>
  1765. <method name="capacity" cv="const"><type>size_type</type><purpose>Returns the capacity of the vector. </purpose></method>
  1766. <method name="reserve"><type>void</type><parameter name="size"><paramtype>size_type</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1767. <method name="reserve"><type>void</type><parameter name="size"><paramtype>size_type</paramtype></parameter></method>
  1768. <method name="shrink_to_fit"><type>void</type><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1769. <method name="shrink_to_fit"><type>void</type></method>
  1770. <method name="operator[]"><type>reference</type><parameter name="index"><paramtype>size_type</paramtype></parameter></method>
  1771. <method name="operator[]" cv="const"><type>const_reference</type><parameter name="index"><paramtype>size_type</paramtype></parameter></method>
  1772. <method name="at"><type>reference</type><parameter name="index"><paramtype>size_type</paramtype></parameter></method>
  1773. <method name="at" cv="const"><type>const_reference</type><parameter name="index"><paramtype>size_type</paramtype></parameter></method>
  1774. <method name="front"><type>reference</type></method>
  1775. <method name="front" cv="const"><type>const_reference</type></method>
  1776. <method name="back"><type>reference</type></method>
  1777. <method name="back" cv="const"><type>const_reference</type></method>
  1778. <method name="assign"><type>void</type><template>
  1779. <template-type-parameter name="InputIterator"/>
  1780. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1781. <method name="assign"><type>void</type><template>
  1782. <template-type-parameter name="InputIterator"/>
  1783. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter></method>
  1784. <method name="assign"><type>void</type><parameter name="n"><paramtype>size_type</paramtype></parameter><parameter name="value"><paramtype>const T &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1785. <method name="assign"><type>void</type><parameter name="n"><paramtype>size_type</paramtype></parameter><parameter name="value"><paramtype>const T &amp;</paramtype></parameter></method>
  1786. <method name="push_back"><type>void</type><parameter name="value"><paramtype>const T &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>Inserts <computeroutput>value</computeroutput> at the end of the vector (resizing if neccessary).</para><para>Note that calling <computeroutput>push_back()</computeroutput> to insert data values one at a time is inefficient as there is a non-trivial overhead in performing a data transfer to the device. It is usually better to store a set of values on the host (for example, in a <computeroutput>std::vector</computeroutput>) and then transfer them in bulk using the <computeroutput>insert()</computeroutput> method or the copy() algorithm. </para></description></method>
  1787. <method name="push_back"><type>void</type><parameter name="value"><paramtype>const T &amp;</paramtype></parameter><description><para>This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. </para></description></method>
  1788. <method name="pop_back"><type>void</type><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1789. <method name="pop_back"><type>void</type></method>
  1790. <method name="insert"><type><classname>iterator</classname></type><parameter name="position"><paramtype><classname>iterator</classname></paramtype></parameter><parameter name="value"><paramtype>const T &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1791. <method name="insert"><type><classname>iterator</classname></type><parameter name="position"><paramtype><classname>iterator</classname></paramtype></parameter><parameter name="value"><paramtype>const T &amp;</paramtype></parameter></method>
  1792. <method name="insert"><type>void</type><parameter name="position"><paramtype><classname>iterator</classname></paramtype></parameter><parameter name="count"><paramtype>size_type</paramtype></parameter><parameter name="value"><paramtype>const T &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1793. <method name="insert"><type>void</type><parameter name="position"><paramtype><classname>iterator</classname></paramtype></parameter><parameter name="count"><paramtype>size_type</paramtype></parameter><parameter name="value"><paramtype>const T &amp;</paramtype></parameter></method>
  1794. <method name="insert"><type>void</type><template>
  1795. <template-type-parameter name="InputIterator"/>
  1796. </template><parameter name="position"><paramtype><classname>iterator</classname></paramtype></parameter><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>Inserts the values in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) into the vector at <computeroutput>position</computeroutput> using <computeroutput>queue</computeroutput>. </para></description></method>
  1797. <method name="insert"><type>void</type><template>
  1798. <template-type-parameter name="InputIterator"/>
  1799. </template><parameter name="position"><paramtype><classname>iterator</classname></paramtype></parameter><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><description><para>This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. </para></description></method>
  1800. <method name="erase"><type><classname>iterator</classname></type><parameter name="position"><paramtype><classname>iterator</classname></paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1801. <method name="erase"><type><classname>iterator</classname></type><parameter name="position"><paramtype><classname>iterator</classname></paramtype></parameter></method>
  1802. <method name="erase"><type><classname>iterator</classname></type><parameter name="first"><paramtype><classname>iterator</classname></paramtype></parameter><parameter name="last"><paramtype><classname>iterator</classname></paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  1803. <method name="erase"><type><classname>iterator</classname></type><parameter name="first"><paramtype><classname>iterator</classname></paramtype></parameter><parameter name="last"><paramtype><classname>iterator</classname></paramtype></parameter></method>
  1804. <method name="swap"><type>void</type><parameter name="other"><paramtype><classname>vector</classname> &amp;</paramtype></parameter><purpose>Swaps the contents of <computeroutput>*this</computeroutput> with <computeroutput>other</computeroutput>. </purpose></method>
  1805. <method name="clear"><type>void</type><purpose>Removes all elements from the vector. </purpose></method>
  1806. <method name="get_allocator" cv="const"><type>allocator_type</type></method>
  1807. <method name="get_buffer" cv="const"><type>const buffer &amp;</type><purpose>Returns the underlying buffer. </purpose></method>
  1808. </method-group>
  1809. <constructor specifiers="explicit"><parameter name="context"><paramtype>const context &amp;</paramtype><default>system::default_context()</default></parameter><purpose>Creates an empty vector in <computeroutput>context</computeroutput>. </purpose></constructor>
  1810. <constructor specifiers="explicit"><parameter name="count"><paramtype>size_type</paramtype></parameter><parameter name="context"><paramtype>const context &amp;</paramtype><default>system::default_context()</default></parameter><description><para>Creates a vector with space for <computeroutput>count</computeroutput> elements in <computeroutput>context</computeroutput>.</para><para>Note that unlike <computeroutput>std::vector's</computeroutput> constructor, this will not initialize the values in the container. Either call the vector constructor which takes a value to initialize with or use the fill() algorithm to set the initial values.</para><para>For example: <programlisting language="c++">// create a vector on the device with space for ten ints
  1811. boost::compute::vector&lt;int&gt; vec(10, context);
  1812. </programlisting> </para></description></constructor>
  1813. <constructor><parameter name="count"><paramtype>size_type</paramtype></parameter><parameter name="value"><paramtype>const T &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Creates a vector with space for <computeroutput>count</computeroutput> elements and sets each equal to <computeroutput>value</computeroutput>.</para><para>For example: <programlisting language="c++">// creates a vector with four values set to nine (e.g. [9, 9, 9, 9]).
  1814. boost::compute::vector&lt;int&gt; vec(4, 9, queue);
  1815. </programlisting> </para></description></constructor>
  1816. <constructor><template>
  1817. <template-type-parameter name="InputIterator"/>
  1818. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><description><para>Creates a vector with space for the values in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>) and copies them into the vector with <computeroutput>queue</computeroutput>.</para><para>For example: <programlisting language="c++">// values on the host
  1819. int data[] = { 1, 2, 3, 4 };
  1820. // create a vector of size four and copy the values from data
  1821. boost::compute::vector&lt;int&gt; vec(data, data + 4, queue);
  1822. </programlisting> </para></description></constructor>
  1823. <constructor><parameter name="other"><paramtype>const <classname>vector</classname> &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><purpose>Creates a new vector and copies the values from <computeroutput>other</computeroutput>. </purpose></constructor>
  1824. <constructor><template>
  1825. <template-type-parameter name="OtherAlloc"/>
  1826. </template><parameter name="other"><paramtype>const <classname>vector</classname>&lt; T, OtherAlloc &gt; &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><purpose>Creates a new vector and copies the values from <computeroutput>other</computeroutput>. </purpose></constructor>
  1827. <constructor><template>
  1828. <template-type-parameter name="OtherAlloc"/>
  1829. </template><parameter name="vector"><paramtype>const std::vector&lt; T, OtherAlloc &gt; &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter><purpose>Creates a new vector and copies the values from <computeroutput>vector</computeroutput>. </purpose></constructor>
  1830. <constructor><parameter name="list"><paramtype>std::initializer_list&lt; T &gt;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><default>system::default_queue()</default></parameter></constructor>
  1831. <copy-assignment><type><classname>vector</classname> &amp;</type><parameter name="other"><paramtype>const <classname>vector</classname> &amp;</paramtype></parameter></copy-assignment>
  1832. <copy-assignment><type><classname>vector</classname> &amp;</type><template>
  1833. <template-type-parameter name="OtherAlloc"/>
  1834. </template><parameter name="other"><paramtype>const <classname>vector</classname>&lt; T, OtherAlloc &gt; &amp;</paramtype></parameter></copy-assignment>
  1835. <copy-assignment><type><classname>vector</classname> &amp;</type><template>
  1836. <template-type-parameter name="OtherAlloc"/>
  1837. </template><parameter name="vector"><paramtype>const std::vector&lt; T, OtherAlloc &gt; &amp;</paramtype></parameter></copy-assignment>
  1838. <constructor><parameter name="other"><paramtype><classname>vector</classname> &amp;&amp;</paramtype></parameter><purpose>Move-constructs a new vector from <computeroutput>other</computeroutput>. </purpose></constructor>
  1839. <copy-assignment><type><classname>vector</classname> &amp;</type><parameter name="other"><paramtype><classname>vector</classname> &amp;&amp;</paramtype></parameter><purpose>Move-assigns the data from <computeroutput>other</computeroutput> to <computeroutput>*this</computeroutput>. </purpose></copy-assignment>
  1840. <destructor><purpose>Destroys the vector object. </purpose></destructor>
  1841. <method-group name="private member functions">
  1842. </method-group>
  1843. </class>
  1844. </namespace>
  1845. </namespace>
  1846. </header>
  1847. <header name="boost/compute/exception/context_error.hpp">
  1848. <namespace name="boost">
  1849. <namespace name="compute">
  1850. <class name="context_error"><inherit access="public">exception</inherit><purpose>A run-time OpenCL context error. </purpose><description><para>The <classname alt="boost::compute::context_error">context_error</classname> exception is thrown when the OpenCL context encounters an error condition. Boost.Compute is notified of these error conditions by registering an error handler when creating context objects (via the <computeroutput>pfn_notify</computeroutput> argument to the <computeroutput>clCreateContext()</computeroutput> function).</para><para>This exception is different than the <classname alt="boost::compute::opencl_error">opencl_error</classname> exception which is thrown as a result of error caused when calling a single OpenCL API function.</para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::opencl_error">opencl_error</classname> </para>
  1851. </para>
  1852. </para></description><method-group name="public member functions">
  1853. <method name="what" cv="const"><type>const char *</type><purpose>Returns a string with a description of the error. </purpose></method>
  1854. <method name="get_context_ptr" cv="const"><type>const context *</type><description><para>Returns a pointer to the context object which generated the error notification. </para></description></method>
  1855. <method name="get_private_info_ptr" cv="const"><type>const void *</type><purpose>Returns a pointer to the private info memory block. </purpose></method>
  1856. <method name="get_private_info_size" cv="const"><type>size_t</type><purpose>Returns the size of the private info memory block. </purpose></method>
  1857. </method-group>
  1858. <constructor><parameter name="context"><paramtype>const context *</paramtype></parameter><parameter name="errinfo"><paramtype>const char *</paramtype></parameter><parameter name="private_info"><paramtype>const void *</paramtype></parameter><parameter name="private_info_size"><paramtype>size_t</paramtype></parameter><purpose>Creates a new context error exception object. </purpose></constructor>
  1859. <destructor><purpose>Destroys the context error object. </purpose></destructor>
  1860. </class>
  1861. </namespace>
  1862. </namespace>
  1863. </header>
  1864. <header name="boost/compute/exception/no_device_found.hpp">
  1865. <namespace name="boost">
  1866. <namespace name="compute">
  1867. <class name="no_device_found"><inherit access="public">exception</inherit><purpose>Exception thrown when no OpenCL device is found. </purpose><description><para>This exception is thrown when no valid OpenCL device can be found.</para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::opencl_error">opencl_error</classname> </para>
  1868. </para>
  1869. </para></description><method-group name="public member functions">
  1870. <method name="what" cv="const"><type>const char *</type><purpose>Returns a string containing a human-readable error message. </purpose></method>
  1871. </method-group>
  1872. <constructor><purpose>Creates a new <classname alt="boost::compute::no_device_found">no_device_found</classname> exception object. </purpose></constructor>
  1873. <destructor><purpose>Destroys the <classname alt="boost::compute::no_device_found">no_device_found</classname> exception object. </purpose></destructor>
  1874. </class>
  1875. </namespace>
  1876. </namespace>
  1877. </header>
  1878. <header name="boost/compute/exception/opencl_error.hpp">
  1879. <namespace name="boost">
  1880. <namespace name="compute">
  1881. <class name="opencl_error"><inherit access="public">exception</inherit><purpose>A run-time OpenCL error. </purpose><description><para>The <classname alt="boost::compute::opencl_error">opencl_error</classname> class represents an error returned from an OpenCL function.</para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::context_error">context_error</classname> </para>
  1882. </para>
  1883. </para></description><method-group name="public member functions">
  1884. <method name="error_code" cv="const"><type>cl_int</type><purpose>Returns the numeric error code. </purpose></method>
  1885. <method name="error_string" cv="const"><type>std::string</type><purpose>Returns a string description of the error. </purpose></method>
  1886. <method name="what" cv="const"><type>const char *</type><purpose>Returns a C-string description of the error. </purpose></method>
  1887. </method-group>
  1888. <constructor specifiers="explicit"><parameter name="error"><paramtype>cl_int</paramtype></parameter><purpose>Creates a new <classname alt="boost::compute::opencl_error">opencl_error</classname> exception object for <computeroutput>error</computeroutput>. </purpose></constructor>
  1889. <destructor><purpose>Destroys the <classname alt="boost::compute::opencl_error">opencl_error</classname> object. </purpose></destructor>
  1890. <method-group name="public static functions">
  1891. <method name="to_string" specifiers="static"><type>std::string</type><parameter name="error"><paramtype>cl_int</paramtype></parameter><description><para>Static function which converts the numeric OpenCL error code <computeroutput>error</computeroutput> to a human-readable string.</para><para>For example: <programlisting language="c++">std::cout &lt;&lt; opencl_error::to_string(CL_INVALID_KERNEL_ARGS) &lt;&lt; std::endl;
  1892. </programlisting></para><para>Will print "Invalid Kernel Arguments".</para><para>If the error code is unknown (e.g. not a valid OpenCL error), a string containing "Unknown OpenCL Error" along with the error number will be returned. </para></description></method>
  1893. </method-group>
  1894. </class>
  1895. </namespace>
  1896. </namespace>
  1897. </header>
  1898. <header name="boost/compute/exception/program_build_failure.hpp">
  1899. <namespace name="boost">
  1900. <namespace name="compute">
  1901. <class name="program_build_failure"><inherit access="public">boost::compute::opencl_error</inherit><purpose>A failure when building OpenCL program. </purpose><description><para>Instances of this class are thrown when OpenCL program build fails. Extends <classname alt="boost::compute::opencl_error">opencl_error</classname> by saving a program build log so it can be used for testing, debugging, or logging purposes.</para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::opencl_error">opencl_error</classname> </para>
  1902. </para>
  1903. </para></description><method-group name="public member functions">
  1904. <method name="build_log" cv="const"><type>std::string</type><purpose>Retrieve the log of a failed program build. </purpose></method>
  1905. </method-group>
  1906. <constructor specifiers="explicit"><parameter name="error"><paramtype>cl_int</paramtype></parameter><parameter name="build_log"><paramtype>const std::string &amp;</paramtype></parameter><description><para>Creates a new <classname alt="boost::compute::program_build_failure">program_build_failure</classname> exception object for <computeroutput>error</computeroutput> and <computeroutput>build_log</computeroutput>. </para></description></constructor>
  1907. <destructor><purpose>Destroys the <classname alt="boost::compute::program_build_failure">program_build_failure</classname> object. </purpose></destructor>
  1908. </class>
  1909. </namespace>
  1910. </namespace>
  1911. </header>
  1912. <header name="boost/compute/exception/unsupported_extension_error.hpp">
  1913. <namespace name="boost">
  1914. <namespace name="compute">
  1915. <class name="unsupported_extension_error"><inherit access="public">exception</inherit><purpose>Exception thrown when attempting to use an unsupported OpenCL extension. </purpose><description><para>This exception is thrown when the user attempts to use an OpenCL extension which is not supported on the platform and/or device.</para><para>An example of this is attempting to use CL-GL sharing on a non-GPU device.</para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::opencl_error">opencl_error</classname> </para>
  1916. </para>
  1917. </para></description><method-group name="public member functions">
  1918. <method name="extension_name" cv="const"><type>std::string</type><purpose>Returns the name of the unsupported extension. </purpose></method>
  1919. <method name="what" cv="const"><type>const char *</type><description><para>Returns a string containing a human-readable error message containing the name of the unsupported exception. </para></description></method>
  1920. </method-group>
  1921. <constructor specifiers="explicit"><parameter name="extension"><paramtype>const char *</paramtype></parameter><description><para>Creates a new unsupported extension error exception object indicating that <computeroutput>extension</computeroutput> is not supported by the OpenCL platform or device. </para></description></constructor>
  1922. <destructor><purpose>Destroys the unsupported extension error object. </purpose></destructor>
  1923. </class>
  1924. </namespace>
  1925. </namespace>
  1926. </header>
  1927. <header name="boost/compute/functional/as.hpp">
  1928. <namespace name="boost">
  1929. <namespace name="compute">
  1930. <struct name="as"><template>
  1931. <template-type-parameter name="T"/>
  1932. </template><description><para>The <classname alt="boost::compute::as">as</classname> function converts its argument to type <computeroutput>T</computeroutput> (similar to reinterpret_cast&lt;T&gt;).</para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::convert">convert&lt;T&gt;</classname> </para>
  1933. </para>
  1934. </para></description><typedef name="result_type"><type>T</type></typedef>
  1935. <method-group name="public member functions">
  1936. </method-group>
  1937. </struct>
  1938. </namespace>
  1939. </namespace>
  1940. </header>
  1941. <header name="boost/compute/functional/atomic.hpp">
  1942. <namespace name="boost">
  1943. <namespace name="compute">
  1944. <class name="atomic_add"><template>
  1945. <template-type-parameter name="T"/>
  1946. </template><inherit access="public">function&lt; T(T *, T)&gt;</inherit><method-group name="public member functions">
  1947. </method-group>
  1948. <constructor/>
  1949. </class><class name="atomic_and"><template>
  1950. <template-type-parameter name="T"/>
  1951. </template><inherit access="public">function&lt; T(T *, T)&gt;</inherit><method-group name="public member functions">
  1952. </method-group>
  1953. <constructor/>
  1954. </class><class name="atomic_cmpxchg"><template>
  1955. <template-type-parameter name="T"/>
  1956. </template><inherit access="public">function&lt; T(T *, T, T)&gt;</inherit><method-group name="public member functions">
  1957. </method-group>
  1958. <constructor/>
  1959. </class><class name="atomic_dec"><template>
  1960. <template-type-parameter name="T"/>
  1961. </template><inherit access="public">function&lt; T(T *)&gt;</inherit><method-group name="public member functions">
  1962. </method-group>
  1963. <constructor/>
  1964. </class><class name="atomic_inc"><template>
  1965. <template-type-parameter name="T"/>
  1966. </template><inherit access="public">function&lt; T(T *)&gt;</inherit><method-group name="public member functions">
  1967. </method-group>
  1968. <constructor/>
  1969. </class><class name="atomic_max"><template>
  1970. <template-type-parameter name="T"/>
  1971. </template><inherit access="public">function&lt; T(T *, T)&gt;</inherit><method-group name="public member functions">
  1972. </method-group>
  1973. <constructor/>
  1974. </class><class name="atomic_min"><template>
  1975. <template-type-parameter name="T"/>
  1976. </template><inherit access="public">function&lt; T(T *, T)&gt;</inherit><method-group name="public member functions">
  1977. </method-group>
  1978. <constructor/>
  1979. </class><class name="atomic_or"><template>
  1980. <template-type-parameter name="T"/>
  1981. </template><inherit access="public">function&lt; T(T *, T)&gt;</inherit><method-group name="public member functions">
  1982. </method-group>
  1983. <constructor/>
  1984. </class><class name="atomic_sub"><template>
  1985. <template-type-parameter name="T"/>
  1986. </template><inherit access="public">function&lt; T(T *, T)&gt;</inherit><method-group name="public member functions">
  1987. </method-group>
  1988. <constructor/>
  1989. </class><class name="atomic_xchg"><template>
  1990. <template-type-parameter name="T"/>
  1991. </template><inherit access="public">function&lt; T(T *, T)&gt;</inherit><method-group name="public member functions">
  1992. </method-group>
  1993. <constructor/>
  1994. </class><class name="atomic_xor"><template>
  1995. <template-type-parameter name="T"/>
  1996. </template><inherit access="public">function&lt; T(T *, T)&gt;</inherit><method-group name="public member functions">
  1997. </method-group>
  1998. <constructor/>
  1999. </class>
  2000. </namespace>
  2001. </namespace>
  2002. </header>
  2003. <header name="boost/compute/functional/bind.hpp">
  2004. <namespace name="boost">
  2005. <namespace name="compute">
  2006. <struct name="is_placeholder"><template>
  2007. <template-type-parameter name="T"/>
  2008. </template><inherit access="public">false_type</inherit><purpose>Meta-function returning <computeroutput>true</computeroutput> if <computeroutput>T</computeroutput> is a placeholder type. </purpose></struct><namespace name="placeholders">
  2009. <data-member name="_1"><type><classname>placeholder</classname>&lt; 0 &gt; const</type></data-member>
  2010. <data-member name="_2"><type><classname>placeholder</classname>&lt; 1 &gt; const</type></data-member>
  2011. </namespace>
  2012. <function name="bind"><type><emphasis>unspecified</emphasis></type><template>
  2013. <template-type-parameter name="F"/>
  2014. <template-nontype-parameter name="Args"><type>class...</type></template-nontype-parameter>
  2015. </template><parameter name="f"><paramtype>F</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter><description><para>Returns a function wrapper which invokes <computeroutput>f</computeroutput> with <computeroutput>args</computeroutput> when called.</para><para>For example, to generate a unary function object which returns <computeroutput>true</computeroutput> when its argument is less than <computeroutput>7</computeroutput>: <programlisting language="c++">using boost::compute::less;
  2016. using boost::compute::placeholders::_1;
  2017. auto less_than_seven = boost::compute::bind(less&lt;int&gt;(), _1, 7);
  2018. </programlisting> </para></description></function>
  2019. </namespace>
  2020. </namespace>
  2021. </header>
  2022. <header name="boost/compute/functional/common.hpp">
  2023. <namespace name="boost">
  2024. <namespace name="compute">
  2025. </namespace>
  2026. </namespace>
  2027. </header>
  2028. <header name="boost/compute/functional/convert.hpp">
  2029. <namespace name="boost">
  2030. <namespace name="compute">
  2031. <struct name="convert"><template>
  2032. <template-type-parameter name="T"/>
  2033. </template><description><para>The <classname alt="boost::compute::convert">convert</classname> function converts its argument to type <computeroutput>T</computeroutput> (similar to static_cast&lt;T&gt;).</para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::as">as&lt;T&gt;</classname> </para>
  2034. </para>
  2035. </para></description><typedef name="result_type"><type>T</type></typedef>
  2036. <method-group name="public member functions">
  2037. </method-group>
  2038. </struct>
  2039. </namespace>
  2040. </namespace>
  2041. </header>
  2042. <header name="boost/compute/functional/field.hpp">
  2043. <namespace name="boost">
  2044. <namespace name="compute">
  2045. <class name="field"><template>
  2046. <template-type-parameter name="T"/>
  2047. </template><description><para>Returns the named field from a value.</para><para>The template-type <computeroutput>T</computeroutput> specifies the field's value type. Note that the value type must match the actual type of the field otherwise runtime compilation or logic errors may occur.</para><para>For example, to access the <computeroutput>second</computeroutput> field in a <computeroutput>std::pair&lt;int, float&gt;</computeroutput> object: <programlisting language="c++">field&lt;float&gt;("second");
  2048. </programlisting></para><para>This can also be used with vector types to access individual components as well as perform swizzle operations.</para><para>For example, to access the first and third components of an <computeroutput>int</computeroutput> vector type (e.g. <computeroutput>int4</computeroutput>): <programlisting language="c++">field&lt;int2_&gt;("xz");
  2049. </programlisting></para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::get">get&lt;N&gt;</classname> </para>
  2050. </para>
  2051. </para></description><typedef name="result_type"><purpose>Result type. </purpose><type>T</type></typedef>
  2052. <method-group name="public member functions">
  2053. </method-group>
  2054. <constructor><parameter name="field"><paramtype>const std::string &amp;</paramtype></parameter><purpose>Creates a new field functor with <computeroutput>field</computeroutput>. </purpose></constructor>
  2055. </class>
  2056. </namespace>
  2057. </namespace>
  2058. </header>
  2059. <header name="boost/compute/functional/geometry.hpp">
  2060. <namespace name="boost">
  2061. <namespace name="compute">
  2062. </namespace>
  2063. </namespace>
  2064. </header>
  2065. <header name="boost/compute/functional/get.hpp">
  2066. <namespace name="boost">
  2067. <namespace name="compute">
  2068. <struct name="get"><template>
  2069. <template-nontype-parameter name="N"><type>size_t</type></template-nontype-parameter>
  2070. </template><description><para>Returns the <computeroutput>N'th</computeroutput> element of an aggregate type (e.g. scalarN, pair, tuple, etc.).</para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::field">field&lt;T&gt;</classname> </para>
  2071. </para>
  2072. </para></description><method-group name="public member functions">
  2073. <method name="operator()" cv="const"><type><emphasis>unspecified</emphasis></type><template>
  2074. <template-type-parameter name="Arg"/>
  2075. </template><parameter name="arg"><paramtype>const Arg &amp;</paramtype></parameter></method>
  2076. </method-group>
  2077. </struct>
  2078. </namespace>
  2079. </namespace>
  2080. </header>
  2081. <header name="boost/compute/functional/hash.hpp">
  2082. <namespace name="boost">
  2083. <namespace name="compute">
  2084. <struct name="hash"><template>
  2085. <template-type-parameter name="Key"/>
  2086. </template><description><para>The hash function returns a hash value for the input value.</para><para>The return type is <computeroutput>ulong_</computeroutput> (the OpenCL unsigned long type). </para></description></struct>
  2087. </namespace>
  2088. </namespace>
  2089. </header>
  2090. <header name="boost/compute/functional/identity.hpp">
  2091. <namespace name="boost">
  2092. <namespace name="compute">
  2093. <class name="identity"><template>
  2094. <template-type-parameter name="T"/>
  2095. </template><description><para>Identity function which simply returns its input.</para><para>For example, to directly copy values using the transform() algorithm: <programlisting language="c++">transform(input.begin(), input.end(), output.begin(), identity&lt;int&gt;(), queue);
  2096. </programlisting></para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::as">as&lt;T&gt;</classname>, <classname alt="boost::compute::convert">convert&lt;T&gt;</classname> </para>
  2097. </para>
  2098. </para></description><typedef name="result_type"><purpose>Identity function result type. </purpose><type>T</type></typedef>
  2099. <method-group name="public member functions">
  2100. </method-group>
  2101. <constructor><purpose>Creates a new identity function. </purpose></constructor>
  2102. </class>
  2103. </namespace>
  2104. </namespace>
  2105. </header>
  2106. <header name="boost/compute/functional/integer.hpp">
  2107. <namespace name="boost">
  2108. <namespace name="compute">
  2109. </namespace>
  2110. </namespace>
  2111. </header>
  2112. <header name="boost/compute/functional/logical.hpp">
  2113. <namespace name="boost">
  2114. <namespace name="compute">
  2115. <class name="binary_negate"><template>
  2116. <template-type-parameter name="Predicate"/>
  2117. </template><inherit access="public">boost::compute::binary_function&lt; void, void, int &gt;</inherit><description><para>The binnary_negate function adaptor negates a binary function.</para><para><para><emphasis role="bold">See Also:</emphasis><para>not2() </para>
  2118. </para>
  2119. </para></description><method-group name="public member functions">
  2120. </method-group>
  2121. <constructor specifiers="explicit"><parameter name="pred"><paramtype>Predicate</paramtype></parameter></constructor>
  2122. </class><struct name="logical_not"><template>
  2123. <template-type-parameter name="T"/>
  2124. </template><inherit access="public">boost::compute::unary_function&lt; T, int &gt;</inherit><description><para>The <classname alt="boost::compute::logical_not">logical_not</classname> function negates its argument and returns it.</para><para><para><emphasis role="bold">See Also:</emphasis><para>not1(), not2() </para>
  2125. </para>
  2126. </para></description><method-group name="public member functions">
  2127. </method-group>
  2128. </struct><class name="unary_negate"><template>
  2129. <template-type-parameter name="Predicate"/>
  2130. </template><inherit access="public">boost::compute::unary_function&lt; void, int &gt;</inherit><description><para>The <classname alt="boost::compute::unary_negate">unary_negate</classname> function adaptor negates a unary function.</para><para><para><emphasis role="bold">See Also:</emphasis><para>not1() </para>
  2131. </para>
  2132. </para></description><method-group name="public member functions">
  2133. </method-group>
  2134. <constructor specifiers="explicit"><parameter name="pred"><paramtype>Predicate</paramtype></parameter></constructor>
  2135. </class>
  2136. <function name="not1"><type><classname>unary_negate</classname>&lt; Predicate &gt;</type><template>
  2137. <template-type-parameter name="Predicate"/>
  2138. </template><parameter name="predicate"><paramtype>const Predicate &amp;</paramtype><description><para>the unary function to wrap</para></description></parameter><description><para>Returns a <classname alt="boost::compute::unary_negate">unary_negate</classname> adaptor around <computeroutput>predicate</computeroutput>.</para><para>
  2139. </para></description><returns><para>a <classname alt="boost::compute::unary_negate">unary_negate</classname> wrapper around <computeroutput>predicate</computeroutput> </para>
  2140. </returns></function>
  2141. <function name="not2"><type><classname>binary_negate</classname>&lt; Predicate &gt;</type><template>
  2142. <template-type-parameter name="Predicate"/>
  2143. </template><parameter name="predicate"><paramtype>const Predicate &amp;</paramtype><description><para>the binary function to wrap</para></description></parameter><description><para>Returns a <classname alt="boost::compute::binary_negate">binary_negate</classname> adaptor around <computeroutput>predicate</computeroutput>.</para><para>
  2144. </para></description><returns><para>a <classname alt="boost::compute::binary_negate">binary_negate</classname> wrapper around <computeroutput>predicate</computeroutput> </para>
  2145. </returns></function>
  2146. </namespace>
  2147. </namespace>
  2148. </header>
  2149. <header name="boost/compute/functional/math.hpp">
  2150. <namespace name="boost">
  2151. <namespace name="compute">
  2152. </namespace>
  2153. </namespace>
  2154. </header>
  2155. <header name="boost/compute/functional/operator.hpp">
  2156. <namespace name="boost">
  2157. <namespace name="compute">
  2158. </namespace>
  2159. </namespace>
  2160. </header>
  2161. <header name="boost/compute/functional/popcount.hpp">
  2162. <namespace name="boost">
  2163. <namespace name="compute">
  2164. <class name="popcount"><template>
  2165. <template-type-parameter name="T"/>
  2166. </template><inherit access="public">function&lt; T(T)&gt;</inherit><description><para>Returns the number of non-zero bits in <computeroutput>x</computeroutput>.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/popcount.html">popcount()</ulink> for more information. </para></description><method-group name="public member functions">
  2167. </method-group>
  2168. <constructor/>
  2169. </class>
  2170. </namespace>
  2171. </namespace>
  2172. </header>
  2173. <header name="boost/compute/functional/relational.hpp">
  2174. <namespace name="boost">
  2175. <namespace name="compute">
  2176. </namespace>
  2177. </namespace>
  2178. </header>
  2179. <header name="boost/compute/image/image1d.hpp">
  2180. <namespace name="boost">
  2181. <namespace name="compute">
  2182. <class name="image1d"><inherit access="public">boost::compute::image_object</inherit><purpose>An OpenCL 1D image object. </purpose><description><para><warning><para>This method is only available if the OpenCL version is 1.2 or later.</para>
  2183. </warning>
  2184. <para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::image_format">image_format</classname>, <classname alt="boost::compute::image2d">image2d</classname> </para>
  2185. </para>
  2186. </para></description><method-group name="public member functions">
  2187. <method name="size" cv="const"><type><classname>extents</classname>&lt; 1 &gt;</type><purpose>Returns the size (width) of the image. </purpose></method>
  2188. <method name="origin" cv="const"><type><classname>extents</classname>&lt; 1 &gt;</type><purpose>Returns the origin of the image (<computeroutput>0</computeroutput>). </purpose></method>
  2189. <method name="get_info" cv="const"><type>T</type><template>
  2190. <template-type-parameter name="T"/>
  2191. </template><parameter name="info"><paramtype>cl_image_info</paramtype></parameter><description><para>Returns information about the image.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clGetImageInfo.html">clGetImageInfo()</ulink> for more information. </para></description></method>
  2192. <method name="get_info" cv="const"><type><emphasis>unspecified</emphasis></type><template>
  2193. <template-nontype-parameter name="Enum"><type>int</type></template-nontype-parameter>
  2194. </template><description><para>This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. </para></description></method>
  2195. <method name="clone" cv="const"><type><classname>image1d</classname></type><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>Creates a new image with a copy of the data in <computeroutput>*this</computeroutput>. Uses <computeroutput>queue</computeroutput> to perform the copy operation. </para></description></method>
  2196. </method-group>
  2197. <constructor><purpose>Creates a null <classname alt="boost::compute::image1d">image1d</classname> object. </purpose></constructor>
  2198. <constructor><parameter name="context"><paramtype>const context &amp;</paramtype></parameter><parameter name="image_width"><paramtype>size_t</paramtype></parameter><parameter name="format"><paramtype>const <classname>image_format</classname> &amp;</paramtype></parameter><parameter name="flags"><paramtype>cl_mem_flags</paramtype><default>read_write</default></parameter><parameter name="host_ptr"><paramtype>void *</paramtype><default>0</default></parameter><description><para>Creates a new <classname alt="boost::compute::image1d">image1d</classname> object.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clCreateImage.html">clCreateImage()</ulink> for more information. </para></description></constructor>
  2199. <constructor><parameter name="other"><paramtype>const <classname>image1d</classname> &amp;</paramtype></parameter><purpose>Creates a new <classname alt="boost::compute::image1d">image1d</classname> as a copy of <computeroutput>other</computeroutput>. </purpose></constructor>
  2200. <copy-assignment><type><classname>image1d</classname> &amp;</type><parameter name="other"><paramtype>const <classname>image1d</classname> &amp;</paramtype></parameter><purpose>Copies the <classname alt="boost::compute::image1d">image1d</classname> from <computeroutput>other</computeroutput>. </purpose></copy-assignment>
  2201. <constructor cv="noexcept"><parameter name="other"><paramtype><classname>image1d</classname> &amp;&amp;</paramtype></parameter><purpose>Move-constructs a new image object from <computeroutput>other</computeroutput>. </purpose></constructor>
  2202. <copy-assignment cv="noexcept"><type><classname>image1d</classname> &amp;</type><parameter name="other"><paramtype><classname>image1d</classname> &amp;&amp;</paramtype></parameter><purpose>Move-assigns the image from <computeroutput>other</computeroutput> to <computeroutput>*this</computeroutput>. </purpose></copy-assignment>
  2203. <destructor><purpose>Destroys the <classname alt="boost::compute::image1d">image1d</classname> object. </purpose></destructor>
  2204. <method-group name="public static functions">
  2205. <method name="get_supported_formats" specifiers="static"><type>std::vector&lt; <classname>image_format</classname> &gt;</type><parameter name="context"><paramtype>const context &amp;</paramtype></parameter><parameter name="flags"><paramtype>cl_mem_flags</paramtype><default>read_write</default></parameter><description><para>Returns the supported image formats for the context.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clGetSupportedImageFormats.html">clGetSupportedImageFormats()</ulink> for more information. </para></description></method>
  2206. <method name="is_supported_format" specifiers="static"><type>bool</type><parameter name="format"><paramtype>const <classname>image_format</classname> &amp;</paramtype></parameter><parameter name="context"><paramtype>const context &amp;</paramtype></parameter><parameter name="flags"><paramtype>cl_mem_flags</paramtype><default>read_write</default></parameter><description><para>Returns <computeroutput>true</computeroutput> if <computeroutput>format</computeroutput> is a supported 1D image format for <computeroutput>context</computeroutput>. </para></description></method>
  2207. </method-group>
  2208. </class>
  2209. </namespace>
  2210. </namespace>
  2211. </header>
  2212. <header name="boost/compute/image/image2d.hpp">
  2213. <namespace name="boost">
  2214. <namespace name="compute">
  2215. <class name="image2d"><inherit access="public">boost::compute::image_object</inherit><purpose>An OpenCL 2D image object. </purpose><description><para>For example, to create a 640x480 8-bit RGBA image:</para><para><programlisting language="c++"/> <para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::image_format">image_format</classname>, <classname alt="boost::compute::image3d">image3d</classname> </para>
  2216. </para>
  2217. </para></description><method-group name="public member functions">
  2218. <method name="size" cv="const"><type><classname>extents</classname>&lt; 2 &gt;</type><purpose>Returns the size (width, height) of the image. </purpose></method>
  2219. <method name="origin" cv="const"><type><classname>extents</classname>&lt; 2 &gt;</type><purpose>Returns the origin of the image (<computeroutput>0</computeroutput>, <computeroutput>0</computeroutput>). </purpose></method>
  2220. <method name="get_info" cv="const"><type>T</type><template>
  2221. <template-type-parameter name="T"/>
  2222. </template><parameter name="info"><paramtype>cl_image_info</paramtype></parameter><description><para>Returns information about the image.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clGetImageInfo.html">clGetImageInfo()</ulink> for more information. </para></description></method>
  2223. <method name="get_info" cv="const"><type><emphasis>unspecified</emphasis></type><template>
  2224. <template-nontype-parameter name="Enum"><type>int</type></template-nontype-parameter>
  2225. </template><description><para>This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. </para></description></method>
  2226. <method name="clone" cv="const"><type><classname>image2d</classname></type><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>Creates a new image with a copy of the data in <computeroutput>*this</computeroutput>. Uses <computeroutput>queue</computeroutput> to perform the copy operation. </para></description></method>
  2227. </method-group>
  2228. <constructor><purpose>Creates a null <classname alt="boost::compute::image2d">image2d</classname> object. </purpose></constructor>
  2229. <constructor><parameter name="context"><paramtype>const context &amp;</paramtype></parameter><parameter name="image_width"><paramtype>size_t</paramtype></parameter><parameter name="image_height"><paramtype>size_t</paramtype></parameter><parameter name="format"><paramtype>const <classname>image_format</classname> &amp;</paramtype></parameter><parameter name="flags"><paramtype>cl_mem_flags</paramtype><default>read_write</default></parameter><parameter name="host_ptr"><paramtype>void *</paramtype><default>0</default></parameter><parameter name="image_row_pitch"><paramtype>size_t</paramtype><default>0</default></parameter><description><para>Creates a new <classname alt="boost::compute::image2d">image2d</classname> object.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clCreateImage.html">clCreateImage()</ulink> for more information. </para></description></constructor>
  2230. <constructor><parameter name="other"><paramtype>const <classname>image2d</classname> &amp;</paramtype></parameter><purpose>Creates a new <classname alt="boost::compute::image2d">image2d</classname> as a copy of <computeroutput>other</computeroutput>. </purpose></constructor>
  2231. <copy-assignment><type><classname>image2d</classname> &amp;</type><parameter name="other"><paramtype>const <classname>image2d</classname> &amp;</paramtype></parameter><purpose>Copies the <classname alt="boost::compute::image2d">image2d</classname> from <computeroutput>other</computeroutput>. </purpose></copy-assignment>
  2232. <constructor cv="noexcept"><parameter name="other"><paramtype><classname>image2d</classname> &amp;&amp;</paramtype></parameter><purpose>Move-constructs a new image object from <computeroutput>other</computeroutput>. </purpose></constructor>
  2233. <copy-assignment cv="noexcept"><type><classname>image2d</classname> &amp;</type><parameter name="other"><paramtype><classname>image2d</classname> &amp;&amp;</paramtype></parameter><purpose>Move-assigns the image from <computeroutput>other</computeroutput> to <computeroutput>*this</computeroutput>. </purpose></copy-assignment>
  2234. <destructor><purpose>Destroys the <classname alt="boost::compute::image2d">image2d</classname> object. </purpose></destructor>
  2235. <method-group name="public static functions">
  2236. <method name="get_supported_formats" specifiers="static"><type>std::vector&lt; <classname>image_format</classname> &gt;</type><parameter name="context"><paramtype>const context &amp;</paramtype></parameter><parameter name="flags"><paramtype>cl_mem_flags</paramtype><default>read_write</default></parameter><description><para>Returns the supported image formats for the context.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clGetSupportedImageFormats.html">clGetSupportedImageFormats()</ulink> for more information. </para></description></method>
  2237. <method name="is_supported_format" specifiers="static"><type>bool</type><parameter name="format"><paramtype>const <classname>image_format</classname> &amp;</paramtype></parameter><parameter name="context"><paramtype>const context &amp;</paramtype></parameter><parameter name="flags"><paramtype>cl_mem_flags</paramtype><default>read_write</default></parameter><description><para>Returns <computeroutput>true</computeroutput> if <computeroutput>format</computeroutput> is a supported 2D image format for <computeroutput>context</computeroutput>. </para></description></method>
  2238. </method-group>
  2239. </class>
  2240. </namespace>
  2241. </namespace>
  2242. </header>
  2243. <header name="boost/compute/image/image3d.hpp">
  2244. <namespace name="boost">
  2245. <namespace name="compute">
  2246. <class name="image3d"><inherit access="public">boost::compute::image_object</inherit><purpose>An OpenCL 3D image object. </purpose><description><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::image_format">image_format</classname>, <classname alt="boost::compute::image2d">image2d</classname> </para>
  2247. </para>
  2248. </para></description><method-group name="public member functions">
  2249. <method name="size" cv="const"><type><classname>extents</classname>&lt; 3 &gt;</type><purpose>Returns the size (width, height, depth) of the image. </purpose></method>
  2250. <method name="origin" cv="const"><type><classname>extents</classname>&lt; 3 &gt;</type><purpose>Returns the origin of the image (<computeroutput>0</computeroutput>, <computeroutput>0</computeroutput>, <computeroutput>0</computeroutput>). </purpose></method>
  2251. <method name="get_info" cv="const"><type>T</type><template>
  2252. <template-type-parameter name="T"/>
  2253. </template><parameter name="info"><paramtype>cl_image_info</paramtype></parameter><description><para>Returns information about the image.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clGetImageInfo.html">clGetImageInfo()</ulink> for more information. </para></description></method>
  2254. <method name="get_info" cv="const"><type><emphasis>unspecified</emphasis></type><template>
  2255. <template-nontype-parameter name="Enum"><type>int</type></template-nontype-parameter>
  2256. </template><description><para>This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. </para></description></method>
  2257. <method name="clone" cv="const"><type><classname>image3d</classname></type><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>Creates a new image with a copy of the data in <computeroutput>*this</computeroutput>. Uses <computeroutput>queue</computeroutput> to perform the copy operation. </para></description></method>
  2258. </method-group>
  2259. <constructor><purpose>Creates a null <classname alt="boost::compute::image3d">image3d</classname> object. </purpose></constructor>
  2260. <constructor><parameter name="context"><paramtype>const context &amp;</paramtype></parameter><parameter name="image_width"><paramtype>size_t</paramtype></parameter><parameter name="image_height"><paramtype>size_t</paramtype></parameter><parameter name="image_depth"><paramtype>size_t</paramtype></parameter><parameter name="format"><paramtype>const <classname>image_format</classname> &amp;</paramtype></parameter><parameter name="flags"><paramtype>cl_mem_flags</paramtype><default>read_write</default></parameter><parameter name="host_ptr"><paramtype>void *</paramtype><default>0</default></parameter><parameter name="image_row_pitch"><paramtype>size_t</paramtype><default>0</default></parameter><parameter name="image_slice_pitch"><paramtype>size_t</paramtype><default>0</default></parameter><description><para>Creates a new <classname alt="boost::compute::image3d">image3d</classname> object.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clCreateImage.html">clCreateImage()</ulink> for more information. </para></description></constructor>
  2261. <constructor><parameter name="other"><paramtype>const <classname>image3d</classname> &amp;</paramtype></parameter><purpose>Creates a new <classname alt="boost::compute::image3d">image3d</classname> as a copy of <computeroutput>other</computeroutput>. </purpose></constructor>
  2262. <copy-assignment><type><classname>image3d</classname> &amp;</type><parameter name="other"><paramtype>const <classname>image3d</classname> &amp;</paramtype></parameter><purpose>Copies the <classname alt="boost::compute::image3d">image3d</classname> from <computeroutput>other</computeroutput>. </purpose></copy-assignment>
  2263. <constructor cv="noexcept"><parameter name="other"><paramtype><classname>image3d</classname> &amp;&amp;</paramtype></parameter><purpose>Move-constructs a new image object from <computeroutput>other</computeroutput>. </purpose></constructor>
  2264. <copy-assignment cv="noexcept"><type><classname>image3d</classname> &amp;</type><parameter name="other"><paramtype><classname>image3d</classname> &amp;&amp;</paramtype></parameter><purpose>Move-assigns the image from <computeroutput>other</computeroutput> to <computeroutput>*this</computeroutput>. </purpose></copy-assignment>
  2265. <destructor><purpose>Destroys the <classname alt="boost::compute::image3d">image3d</classname> object. </purpose></destructor>
  2266. <method-group name="public static functions">
  2267. <method name="get_supported_formats" specifiers="static"><type>std::vector&lt; <classname>image_format</classname> &gt;</type><parameter name="context"><paramtype>const context &amp;</paramtype></parameter><parameter name="flags"><paramtype>cl_mem_flags</paramtype><default>read_write</default></parameter><description><para>Returns the supported 3D image formats for the context.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clGetSupportedImageFormats.html">clGetSupportedImageFormats()</ulink> for more information. </para></description></method>
  2268. <method name="is_supported_format" specifiers="static"><type>bool</type><parameter name="format"><paramtype>const <classname>image_format</classname> &amp;</paramtype></parameter><parameter name="context"><paramtype>const context &amp;</paramtype></parameter><parameter name="flags"><paramtype>cl_mem_flags</paramtype><default>read_write</default></parameter><description><para>Returns <computeroutput>true</computeroutput> if <computeroutput>format</computeroutput> is a supported 3D image format for <computeroutput>context</computeroutput>. </para></description></method>
  2269. </method-group>
  2270. </class>
  2271. </namespace>
  2272. </namespace>
  2273. </header>
  2274. <header name="boost/compute/image/image_format.hpp">
  2275. <namespace name="boost">
  2276. <namespace name="compute">
  2277. <class name="image_format"><purpose>A OpenCL image format. </purpose><description><para>For example, to create a format for a 8-bit RGBA image: <programlisting language="c++">boost::compute::image_format rgba8(CL_RGBA, CL_UNSIGNED_INT8);
  2278. </programlisting></para><para>After being constructed, <classname alt="boost::compute::image_format">image_format</classname> objects are usually passed to the constructor of the various image classes (e.g. <classname alt="boost::compute::image2d">image2d</classname>, <classname alt="boost::compute::image3d">image3d</classname>) to create an image object on a compute device.</para><para>Image formats supported by a context can be queried with the static get_supported_formats() in each image class. For example: <programlisting language="c++">std::vector&lt;image_format&gt; formats = image2d::get_supported_formats(ctx);
  2279. </programlisting></para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::image2d">image2d</classname> </para>
  2280. </para>
  2281. </para></description><enum name="channel_order"><enumvalue name="r"><default>= CL_R</default></enumvalue><enumvalue name="a"><default>= CL_A</default></enumvalue><enumvalue name="intensity"><default>= CL_INTENSITY</default></enumvalue><enumvalue name="luminance"><default>= CL_LUMINANCE</default></enumvalue><enumvalue name="rg"><default>= CL_RG</default></enumvalue><enumvalue name="ra"><default>= CL_RA</default></enumvalue><enumvalue name="rgb"><default>= CL_RGB</default></enumvalue><enumvalue name="rgba"><default>= CL_RGBA</default></enumvalue><enumvalue name="argb"><default>= CL_ARGB</default></enumvalue><enumvalue name="bgra"><default>= CL_BGRA</default></enumvalue></enum>
  2282. <enum name="channel_data_type"><enumvalue name="snorm_int8"><default>= CL_SNORM_INT8</default></enumvalue><enumvalue name="snorm_int16"><default>= CL_SNORM_INT16</default></enumvalue><enumvalue name="unorm_int8"><default>= CL_UNORM_INT8</default></enumvalue><enumvalue name="unorm_int16"><default>= CL_UNORM_INT16</default></enumvalue><enumvalue name="unorm_short_565"><default>= CL_UNORM_SHORT_565</default></enumvalue><enumvalue name="unorm_short_555"><default>= CL_UNORM_SHORT_555</default></enumvalue><enumvalue name="unorm_int_101010"><default>= CL_UNORM_INT_101010</default></enumvalue><enumvalue name="signed_int8"><default>= CL_SIGNED_INT8</default></enumvalue><enumvalue name="signed_int16"><default>= CL_SIGNED_INT16</default></enumvalue><enumvalue name="signed_int32"><default>= CL_SIGNED_INT32</default></enumvalue><enumvalue name="unsigned_int8"><default>= CL_UNSIGNED_INT8</default></enumvalue><enumvalue name="unsigned_int16"><default>= CL_UNSIGNED_INT16</default></enumvalue><enumvalue name="unsigned_int32"><default>= CL_UNSIGNED_INT32</default></enumvalue><enumvalue name="float16"><default>= CL_HALF_FLOAT</default></enumvalue><enumvalue name="float32"><default>= CL_FLOAT</default></enumvalue></enum>
  2283. <method-group name="public member functions">
  2284. <method name="get_format_ptr" cv="const"><type>const cl_image_format *</type><purpose>Returns a pointer to the <computeroutput>cl_image_format</computeroutput> object. </purpose></method>
  2285. <method name="operator==" cv="const"><type>bool</type><parameter name="other"><paramtype>const <classname>image_format</classname> &amp;</paramtype></parameter><purpose>Returns <computeroutput>true</computeroutput> if <computeroutput>*this</computeroutput> is the same as <computeroutput>other</computeroutput>. </purpose></method>
  2286. <method name="operator!=" cv="const"><type>bool</type><parameter name="other"><paramtype>const <classname>image_format</classname> &amp;</paramtype></parameter><purpose>Returns <computeroutput>true</computeroutput> if <computeroutput>*this</computeroutput> is not the same as <computeroutput>other</computeroutput>. </purpose></method>
  2287. </method-group>
  2288. <constructor specifiers="explicit"><parameter name="order"><paramtype>cl_channel_order</paramtype></parameter><parameter name="type"><paramtype>cl_channel_type</paramtype></parameter><purpose>Creates a new image format object with <computeroutput>order</computeroutput> and <computeroutput>type</computeroutput>. </purpose></constructor>
  2289. <constructor specifiers="explicit"><parameter name="format"><paramtype>const cl_image_format &amp;</paramtype></parameter><purpose>Creates a new image format object from <computeroutput>format</computeroutput>. </purpose></constructor>
  2290. <constructor><parameter name="other"><paramtype>const <classname>image_format</classname> &amp;</paramtype></parameter><purpose>Creates a new image format object as a copy of <computeroutput>other</computeroutput>. </purpose></constructor>
  2291. <copy-assignment><type><classname>image_format</classname> &amp;</type><parameter name="other"><paramtype>const <classname>image_format</classname> &amp;</paramtype></parameter><purpose>Copies the format from <computeroutput>other</computeroutput> to <computeroutput>*this</computeroutput>. </purpose></copy-assignment>
  2292. <destructor><purpose>Destroys the image format object. </purpose></destructor>
  2293. </class>
  2294. </namespace>
  2295. </namespace>
  2296. </header>
  2297. <header name="boost/compute/image/image_object.hpp">
  2298. <namespace name="boost">
  2299. <namespace name="compute">
  2300. <class name="image_object"><inherit access="public">memory_object</inherit><purpose>Base-class for image objects. </purpose><description><para>The <classname alt="boost::compute::image_object">image_object</classname> class is the base-class for image objects on compute devices.</para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::image1d">image1d</classname>, <classname alt="boost::compute::image2d">image2d</classname>, <classname alt="boost::compute::image3d">image3d</classname> </para>
  2301. </para>
  2302. </para></description><method-group name="public member functions">
  2303. <method name="get_image_info" cv="const"><type>T</type><template>
  2304. <template-type-parameter name="T"/>
  2305. </template><parameter name="info"><paramtype>cl_mem_info</paramtype></parameter><description><para>Returns information about the image object.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clGetImageInfo.html">clGetImageInfo()</ulink> for more information. </para></description></method>
  2306. <method name="format" cv="const"><type><classname>image_format</classname></type><purpose>Returns the format for the image. </purpose></method>
  2307. <method name="width" cv="const"><type>size_t</type><purpose>Returns the width of the image. </purpose></method>
  2308. <method name="height" cv="const"><type>size_t</type><description><para>Returns the height of the image.</para><para>For 1D images, this function will return <computeroutput>1</computeroutput>. </para></description></method>
  2309. <method name="depth" cv="const"><type>size_t</type><description><para>Returns the depth of the image.</para><para>For 1D and 2D images, this function will return <computeroutput>1</computeroutput>. </para></description></method>
  2310. </method-group>
  2311. <constructor/>
  2312. <constructor specifiers="explicit"><parameter name="mem"><paramtype>cl_mem</paramtype></parameter><parameter name="retain"><paramtype>bool</paramtype><default>true</default></parameter></constructor>
  2313. <constructor><parameter name="other"><paramtype>const <classname>image_object</classname> &amp;</paramtype></parameter></constructor>
  2314. <copy-assignment><type><classname>image_object</classname> &amp;</type><parameter name="other"><paramtype>const <classname>image_object</classname> &amp;</paramtype></parameter></copy-assignment>
  2315. <constructor cv="noexcept"><parameter name="other"><paramtype><classname>image_object</classname> &amp;&amp;</paramtype></parameter></constructor>
  2316. <destructor><purpose>Destroys the image object. </purpose></destructor>
  2317. <method-group name="public static functions">
  2318. <method name="get_supported_formats" specifiers="static"><type>std::vector&lt; <classname>image_format</classname> &gt;</type><parameter name="context"><paramtype>const context &amp;</paramtype></parameter><parameter name="type"><paramtype>cl_mem_object_type</paramtype></parameter><parameter name="flags"><paramtype>cl_mem_flags</paramtype><default>read_write</default></parameter><description><para>Returns the supported image formats for the <computeroutput>type</computeroutput> in <computeroutput>context</computeroutput>.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clGetSupportedImageFormats.html">clGetSupportedImageFormats()</ulink> for more information. </para></description></method>
  2319. <method name="is_supported_format" specifiers="static"><type>bool</type><parameter name="format"><paramtype>const <classname>image_format</classname> &amp;</paramtype></parameter><parameter name="context"><paramtype>const context &amp;</paramtype></parameter><parameter name="type"><paramtype>cl_mem_object_type</paramtype></parameter><parameter name="flags"><paramtype>cl_mem_flags</paramtype><default>read_write</default></parameter><description><para>Returns <computeroutput>true</computeroutput> if <computeroutput>format</computeroutput> is a supported image format for <computeroutput>type</computeroutput> in <computeroutput>context</computeroutput> with <computeroutput>flags</computeroutput>. </para></description></method>
  2320. </method-group>
  2321. </class>
  2322. </namespace>
  2323. </namespace>
  2324. </header>
  2325. <header name="boost/compute/image/image_sampler.hpp">
  2326. <namespace name="boost">
  2327. <namespace name="compute">
  2328. <class name="image_sampler"><purpose>An OpenCL image sampler object. </purpose><description><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::image2d">image2d</classname>, <classname alt="boost::compute::image_format">image_format</classname> </para>
  2329. </para>
  2330. </para></description><enum name="addressing_mode"><enumvalue name="none"><default>= CL_ADDRESS_NONE</default></enumvalue><enumvalue name="clamp_to_edge"><default>= CL_ADDRESS_CLAMP_TO_EDGE</default></enumvalue><enumvalue name="clamp"><default>= CL_ADDRESS_CLAMP</default></enumvalue><enumvalue name="repeat"><default>= CL_ADDRESS_REPEAT</default></enumvalue></enum>
  2331. <enum name="filter_mode"><enumvalue name="nearest"><default>= CL_FILTER_NEAREST</default></enumvalue><enumvalue name="linear"><default>= CL_FILTER_LINEAR</default></enumvalue></enum>
  2332. <method-group name="public member functions">
  2333. <method name="get" cv="const"><type>cl_sampler &amp;</type><purpose>Returns the underlying <computeroutput>cl_sampler</computeroutput> object. </purpose></method>
  2334. <method name="get_context" cv="const"><type>context</type><purpose>Returns the context for the image sampler object. </purpose></method>
  2335. <method name="get_info" cv="const"><type>T</type><template>
  2336. <template-type-parameter name="T"/>
  2337. </template><parameter name="info"><paramtype>cl_sampler_info</paramtype></parameter><description><para>Returns information about the sampler.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clGetSamplerInfo.html">clGetSamplerInfo()</ulink> for more information. </para></description></method>
  2338. <method name="get_info" cv="const"><type><emphasis>unspecified</emphasis></type><template>
  2339. <template-nontype-parameter name="Enum"><type>int</type></template-nontype-parameter>
  2340. </template><description><para>This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. </para></description></method>
  2341. <method name="operator==" cv="const"><type>bool</type><parameter name="other"><paramtype>const <classname>image_sampler</classname> &amp;</paramtype></parameter><purpose>Returns <computeroutput>true</computeroutput> if the sampler is the same at <computeroutput>other</computeroutput>. </purpose></method>
  2342. <method name="operator!=" cv="const"><type>bool</type><parameter name="other"><paramtype>const <classname>image_sampler</classname> &amp;</paramtype></parameter><purpose>Returns <computeroutput>true</computeroutput> if the sampler is different from <computeroutput>other</computeroutput>. </purpose></method>
  2343. <method name="conversion-operator" cv="const"><type>cl_sampler</type></method>
  2344. </method-group>
  2345. <constructor/>
  2346. <constructor><parameter name="context"><paramtype>const context &amp;</paramtype></parameter><parameter name="normalized_coords"><paramtype>bool</paramtype></parameter><parameter name="addressing_mode"><paramtype>cl_addressing_mode</paramtype></parameter><parameter name="filter_mode"><paramtype>cl_filter_mode</paramtype></parameter></constructor>
  2347. <constructor specifiers="explicit"><parameter name="sampler"><paramtype>cl_sampler</paramtype></parameter><parameter name="retain"><paramtype>bool</paramtype><default>true</default></parameter></constructor>
  2348. <constructor><parameter name="other"><paramtype>const <classname>image_sampler</classname> &amp;</paramtype></parameter><purpose>Creates a new image sampler object as a copy of <computeroutput>other</computeroutput>. </purpose></constructor>
  2349. <copy-assignment><type><classname>image_sampler</classname> &amp;</type><parameter name="other"><paramtype>const <classname>image_sampler</classname> &amp;</paramtype></parameter><purpose>Copies the image sampler object from <computeroutput>other</computeroutput> to <computeroutput>*this</computeroutput>. </purpose></copy-assignment>
  2350. <constructor cv="noexcept"><parameter name="other"><paramtype><classname>image_sampler</classname> &amp;&amp;</paramtype></parameter></constructor>
  2351. <copy-assignment cv="noexcept"><type><classname>image_sampler</classname> &amp;</type><parameter name="other"><paramtype><classname>image_sampler</classname> &amp;&amp;</paramtype></parameter></copy-assignment>
  2352. <destructor><purpose>Destroys the image sampler object. </purpose></destructor>
  2353. </class>
  2354. </namespace>
  2355. </namespace>
  2356. </header>
  2357. <header name="boost/compute/interop/opengl/acquire.hpp">
  2358. <namespace name="boost">
  2359. <namespace name="compute">
  2360. <function name="opengl_enqueue_acquire_gl_objects"><type>event</type><parameter name="num_objects"><paramtype>const uint_</paramtype></parameter><parameter name="mem_objects"><paramtype>const cl_mem *</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><parameter name="events"><paramtype>const <classname>wait_list</classname> &amp;</paramtype><default><classname alt="boost::compute::wait_list">wait_list</classname>()</default></parameter><description><para>Enqueues a command to acquire the specified OpenGL memory objects.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clEnqueueAcquireGLObjects.html">clEnqueueAcquireGLObjects()</ulink> for more information. </para></description></function>
  2361. <function name="opengl_enqueue_release_gl_objects"><type>event</type><parameter name="num_objects"><paramtype>const uint_</paramtype></parameter><parameter name="mem_objects"><paramtype>const cl_mem *</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><parameter name="events"><paramtype>const <classname>wait_list</classname> &amp;</paramtype><default><classname alt="boost::compute::wait_list">wait_list</classname>()</default></parameter><description><para>Enqueues a command to release the specified OpenGL memory objects.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clEnqueueReleaseGLObjects.html">clEnqueueReleaseGLObjects()</ulink> for more information. </para></description></function>
  2362. <function name="opengl_enqueue_acquire_buffer"><type>event</type><parameter name="buffer"><paramtype>const <classname>opengl_buffer</classname> &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><parameter name="events"><paramtype>const <classname>wait_list</classname> &amp;</paramtype><default><classname alt="boost::compute::wait_list">wait_list</classname>()</default></parameter><description><para>Enqueues a command to acquire the specified OpenGL buffer.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clEnqueueAcquireGLObjects.html">clEnqueueAcquireGLObjects()</ulink> for more information. </para></description></function>
  2363. <function name="opengl_enqueue_release_buffer"><type>event</type><parameter name="buffer"><paramtype>const <classname>opengl_buffer</classname> &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><parameter name="events"><paramtype>const <classname>wait_list</classname> &amp;</paramtype><default><classname alt="boost::compute::wait_list">wait_list</classname>()</default></parameter><description><para>Enqueues a command to release the specified OpenGL buffer.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clEnqueueReleaseGLObjects.html">clEnqueueReleaseGLObjects()</ulink> for more information. </para></description></function>
  2364. </namespace>
  2365. </namespace>
  2366. </header>
  2367. <header name="boost/compute/interop/opengl/cl_gl.hpp">
  2368. </header>
  2369. <header name="boost/compute/interop/opengl/cl_gl_ext.hpp">
  2370. </header>
  2371. <header name="boost/compute/interop/opengl/context.hpp">
  2372. <namespace name="boost">
  2373. <namespace name="compute">
  2374. <function name="opengl_create_shared_context"><type>context</type><description><para>Creates a shared OpenCL/OpenGL context for the currently active OpenGL context.</para><para>Once created, the shared context can be used to create OpenCL memory objects which can interact with OpenGL memory objects (e.g. VBOs).</para><para>
  2375. </para></description><throws><simpara><classname>unsupported_extension_error</classname> if no CL-GL sharing capable devices are found. </simpara></throws></function>
  2376. </namespace>
  2377. </namespace>
  2378. </header>
  2379. <header name="boost/compute/interop/opengl/gl.hpp">
  2380. </header>
  2381. <header name="boost/compute/interop/opengl/opengl_buffer.hpp">
  2382. <namespace name="boost">
  2383. <namespace name="compute">
  2384. <class name="opengl_buffer"><inherit access="public">buffer</inherit><description><para>A OpenCL buffer for accessing an OpenGL memory object. </para></description><method-group name="public member functions">
  2385. <method name="get_opengl_object" cv="const"><type>GLuint</type><description><para>Returns the OpenGL memory object ID.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clGetGLObjectInfo.html">clGetGLObjectInfo()</ulink> for more information. </para></description></method>
  2386. <method name="get_opengl_type" cv="const"><type>cl_gl_object_type</type><description><para>Returns the OpenGL memory object type.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clGetGLObjectInfo.html">clGetGLObjectInfo()</ulink> for more information. </para></description></method>
  2387. </method-group>
  2388. <constructor><purpose>Creates a null OpenGL buffer object. </purpose></constructor>
  2389. <constructor specifiers="explicit"><parameter name="mem"><paramtype>cl_mem</paramtype></parameter><parameter name="retain"><paramtype>bool</paramtype><default>true</default></parameter><purpose>Creates a new OpenGL buffer object for <computeroutput>mem</computeroutput>. </purpose></constructor>
  2390. <constructor><parameter name="context"><paramtype>const context &amp;</paramtype></parameter><parameter name="bufobj"><paramtype>GLuint</paramtype></parameter><parameter name="flags"><paramtype>cl_mem_flags</paramtype><default>read_write</default></parameter><description><para>Creates a new OpenGL buffer object in <computeroutput>context</computeroutput> for <computeroutput>bufobj</computeroutput> with <computeroutput>flags</computeroutput>.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clCreateFromGLBuffer.html">clCreateFromGLBuffer()</ulink> for more information. </para></description></constructor>
  2391. <constructor><parameter name="other"><paramtype>const <classname>opengl_buffer</classname> &amp;</paramtype></parameter><purpose>Creates a new OpenGL buffer object as a copy of <computeroutput>other</computeroutput>. </purpose></constructor>
  2392. <copy-assignment><type><classname>opengl_buffer</classname> &amp;</type><parameter name="other"><paramtype>const <classname>opengl_buffer</classname> &amp;</paramtype></parameter><purpose>Copies the OpenGL buffer object from <computeroutput>other</computeroutput>. </purpose></copy-assignment>
  2393. <destructor><purpose>Destroys the OpenGL buffer object. </purpose></destructor>
  2394. </class>
  2395. </namespace>
  2396. </namespace>
  2397. </header>
  2398. <header name="boost/compute/interop/opengl/opengl_renderbuffer.hpp">
  2399. <namespace name="boost">
  2400. <namespace name="compute">
  2401. <class name="opengl_renderbuffer"><inherit access="public">boost::compute::image_object</inherit><description><para>A OpenCL buffer for accessing an OpenGL renderbuffer object. </para></description><method-group name="public member functions">
  2402. <method name="size" cv="const"><type><classname>extents</classname>&lt; 2 &gt;</type><purpose>Returns the size (width, height) of the renderbuffer. </purpose></method>
  2403. <method name="origin" cv="const"><type><classname>extents</classname>&lt; 2 &gt;</type><purpose>Returns the origin of the renderbuffer (<computeroutput>0</computeroutput>, <computeroutput>0</computeroutput>). </purpose></method>
  2404. <method name="get_opengl_object" cv="const"><type>GLuint</type><description><para>Returns the OpenGL memory object ID.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clGetGLObjectInfo.html">clGetGLObjectInfo()</ulink> for more information. </para></description></method>
  2405. <method name="get_opengl_type" cv="const"><type>cl_gl_object_type</type><description><para>Returns the OpenGL memory object type.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clGetGLObjectInfo.html">clGetGLObjectInfo()</ulink> for more information. </para></description></method>
  2406. </method-group>
  2407. <constructor><purpose>Creates a null OpenGL renderbuffer object. </purpose></constructor>
  2408. <constructor specifiers="explicit"><parameter name="mem"><paramtype>cl_mem</paramtype></parameter><parameter name="retain"><paramtype>bool</paramtype><default>true</default></parameter><purpose>Creates a new OpenGL renderbuffer object for <computeroutput>mem</computeroutput>. </purpose></constructor>
  2409. <constructor><parameter name="context"><paramtype>const context &amp;</paramtype></parameter><parameter name="renderbuffer"><paramtype>GLuint</paramtype></parameter><parameter name="flags"><paramtype>cl_mem_flags</paramtype><default>read_write</default></parameter><description><para>Creates a new OpenGL renderbuffer object in <computeroutput>context</computeroutput> for <computeroutput>renderbuffer</computeroutput> with <computeroutput>flags</computeroutput>.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clCreateFromGLRenderbuffer.html">clCreateFromGLRenderbuffer()</ulink> for more information. </para></description></constructor>
  2410. <constructor><parameter name="other"><paramtype>const <classname>opengl_renderbuffer</classname> &amp;</paramtype></parameter><purpose>Creates a new OpenGL renderbuffer object as a copy of <computeroutput>other</computeroutput>. </purpose></constructor>
  2411. <copy-assignment><type><classname>opengl_renderbuffer</classname> &amp;</type><parameter name="other"><paramtype>const <classname>opengl_renderbuffer</classname> &amp;</paramtype></parameter><purpose>Copies the OpenGL renderbuffer object from <computeroutput>other</computeroutput>. </purpose></copy-assignment>
  2412. <destructor><purpose>Destroys the OpenGL buffer object. </purpose></destructor>
  2413. </class>
  2414. </namespace>
  2415. </namespace>
  2416. </header>
  2417. <header name="boost/compute/interop/opengl/opengl_texture.hpp">
  2418. <namespace name="boost">
  2419. <namespace name="compute">
  2420. <class name="opengl_texture"><inherit access="public">boost::compute::image_object</inherit><description><para>A OpenCL <classname alt="boost::compute::image2d">image2d</classname> for accessing an OpenGL texture object. </para></description><method-group name="public member functions">
  2421. <method name="size" cv="const"><type><classname>extents</classname>&lt; 2 &gt;</type><purpose>Returns the size (width, height) of the texture. </purpose></method>
  2422. <method name="origin" cv="const"><type><classname>extents</classname>&lt; 2 &gt;</type><purpose>Returns the origin of the texture (<computeroutput>0</computeroutput>, <computeroutput>0</computeroutput>). </purpose></method>
  2423. <method name="get_texture_info" cv="const"><type>T</type><template>
  2424. <template-type-parameter name="T"/>
  2425. </template><parameter name="info"><paramtype>cl_gl_texture_info</paramtype></parameter><description><para>Returns information about the texture.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clGetGLTextureInfo.html">clGetGLTextureInfo()</ulink> for more information. </para></description></method>
  2426. </method-group>
  2427. <constructor><purpose>Creates a null OpenGL texture object. </purpose></constructor>
  2428. <constructor specifiers="explicit"><parameter name="mem"><paramtype>cl_mem</paramtype></parameter><parameter name="retain"><paramtype>bool</paramtype><default>true</default></parameter><purpose>Creates a new OpenGL texture object for <computeroutput>mem</computeroutput>. </purpose></constructor>
  2429. <constructor><parameter name="context"><paramtype>const context &amp;</paramtype></parameter><parameter name="texture_target"><paramtype>GLenum</paramtype></parameter><parameter name="miplevel"><paramtype>GLint</paramtype></parameter><parameter name="texture"><paramtype>GLuint</paramtype></parameter><parameter name="flags"><paramtype>cl_mem_flags</paramtype><default>read_write</default></parameter><description><para>Creates a new OpenGL texture object in <computeroutput>context</computeroutput> for <computeroutput>texture</computeroutput> with <computeroutput>flags</computeroutput>.</para><para>See the documentation for <ulink url="http://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/clCreateFromGLTexture.html">clCreateFromGLTexture()</ulink> for more information. </para></description></constructor>
  2430. <constructor><parameter name="other"><paramtype>const <classname>opengl_texture</classname> &amp;</paramtype></parameter><purpose>Creates a new OpenGL texture object as a copy of <computeroutput>other</computeroutput>. </purpose></constructor>
  2431. <copy-assignment><type><classname>opengl_texture</classname> &amp;</type><parameter name="other"><paramtype>const <classname>opengl_texture</classname> &amp;</paramtype></parameter><purpose>Copies the OpenGL texture object from <computeroutput>other</computeroutput>. </purpose></copy-assignment>
  2432. <destructor><purpose>Destroys the texture object. </purpose></destructor>
  2433. </class>
  2434. </namespace>
  2435. </namespace>
  2436. </header>
  2437. <header name="boost/compute/iterator/buffer_iterator.hpp">
  2438. <namespace name="boost">
  2439. <namespace name="compute">
  2440. <class name="buffer_iterator"><template>
  2441. <template-type-parameter name="T"/>
  2442. </template><purpose>An iterator for values in a buffer. </purpose><description><para>The <classname alt="boost::compute::buffer_iterator">buffer_iterator</classname> class iterates over values in a memory buffer on a compute device. It is the most commonly used iterator in Boost.Compute and is used by the <classname alt="boost::compute::vector">vector&lt;T&gt;</classname> and <classname alt="boost::compute::array">array&lt;T, N&gt;</classname> container classes.</para><para>Buffer iterators store a reference to a memory buffer along with an index into that memory buffer.</para><para>The <classname alt="boost::compute::buffer_iterator">buffer_iterator</classname> class allows for arbitrary OpenCL memory objects (including those created outside of Boost.Compute) to be used with the Boost.Compute algorithms (such as transform() and sort()). For example, to reverse the contents of an OpenCL memory buffer containing a set of integers:</para><para><programlisting language="c++"/> <para><emphasis role="bold">See Also:</emphasis><para>buffer, make_buffer_iterator() </para>
  2443. </para>
  2444. </para></description><typedef name="super_type"><type><emphasis>unspecified</emphasis></type></typedef>
  2445. <typedef name="reference"><type>super_type::reference</type></typedef>
  2446. <typedef name="difference_type"><type>super_type::difference_type</type></typedef>
  2447. <method-group name="public member functions">
  2448. <method name="get_buffer" cv="const"><type>const buffer &amp;</type></method>
  2449. <method name="get_index" cv="const"><type>size_t</type></method>
  2450. <method name="read" cv="const"><type>T</type><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  2451. <method name="write"><type>void</type><parameter name="value"><paramtype>const T &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  2452. </method-group>
  2453. <constructor/>
  2454. <constructor><parameter name="buffer"><paramtype>const buffer &amp;</paramtype></parameter><parameter name="index"><paramtype>size_t</paramtype></parameter></constructor>
  2455. <constructor><parameter name="other"><paramtype>const <classname>buffer_iterator</classname>&lt; T &gt; &amp;</paramtype></parameter></constructor>
  2456. <copy-assignment><type><classname>buffer_iterator</classname>&lt; T &gt; &amp;</type><parameter name="other"><paramtype>const <classname>buffer_iterator</classname>&lt; T &gt; &amp;</paramtype></parameter></copy-assignment>
  2457. <destructor/>
  2458. <method-group name="private member functions">
  2459. </method-group>
  2460. </class>
  2461. <function name="make_buffer_iterator"><type><classname>buffer_iterator</classname>&lt; T &gt;</type><template>
  2462. <template-type-parameter name="T"/>
  2463. </template><parameter name="buffer"><paramtype>const buffer &amp;</paramtype><description><para>the buffer object </para></description></parameter><parameter name="index"><paramtype>size_t</paramtype><default>0</default><description><para>the index in the buffer</para></description></parameter><description><para>Creates a new <classname alt="boost::compute::buffer_iterator">buffer_iterator</classname> for <computeroutput>buffer</computeroutput> at <computeroutput>index</computeroutput>.</para><para>
  2464. </para></description><returns><para>a <computeroutput><classname alt="boost::compute::buffer_iterator">buffer_iterator</classname></computeroutput> for <computeroutput>buffer</computeroutput> at <computeroutput>index</computeroutput> </para>
  2465. </returns></function>
  2466. </namespace>
  2467. </namespace>
  2468. </header>
  2469. <header name="boost/compute/iterator/constant_buffer_iterator.hpp">
  2470. <namespace name="boost">
  2471. <namespace name="compute">
  2472. <class name="constant_buffer_iterator"><template>
  2473. <template-type-parameter name="T"/>
  2474. </template><purpose>An iterator for a buffer in the <computeroutput>constant</computeroutput> memory space. </purpose><description><para>The <classname alt="boost::compute::constant_buffer_iterator">constant_buffer_iterator</classname> class provides an iterator for values in a buffer in the <computeroutput>constant</computeroutput> memory space.</para><para>For iterating over values in the <computeroutput>global</computeroutput> memory space (the most common case), use the <classname alt="boost::compute::buffer_iterator">buffer_iterator</classname> class.</para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::buffer_iterator">buffer_iterator</classname> </para>
  2475. </para>
  2476. </para></description><typedef name="super_type"><type><emphasis>unspecified</emphasis></type></typedef>
  2477. <typedef name="reference"><type>super_type::reference</type></typedef>
  2478. <typedef name="difference_type"><type>super_type::difference_type</type></typedef>
  2479. <method-group name="public member functions">
  2480. <method name="get_buffer" cv="const"><type>const buffer &amp;</type></method>
  2481. <method name="get_index" cv="const"><type>size_t</type></method>
  2482. <method name="read" cv="const"><type>T</type><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  2483. <method name="write"><type>void</type><parameter name="value"><paramtype>const T &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter></method>
  2484. <method name="operator[]" cv="const"><type><emphasis>unspecified</emphasis></type><template>
  2485. <template-type-parameter name="Expr"/>
  2486. </template><parameter name="expr"><paramtype>const Expr &amp;</paramtype></parameter></method>
  2487. </method-group>
  2488. <constructor/>
  2489. <constructor><parameter name="buffer"><paramtype>const buffer &amp;</paramtype></parameter><parameter name="index"><paramtype>size_t</paramtype></parameter></constructor>
  2490. <constructor><parameter name="other"><paramtype>const <classname>constant_buffer_iterator</classname>&lt; T &gt; &amp;</paramtype></parameter></constructor>
  2491. <copy-assignment><type><classname>constant_buffer_iterator</classname>&lt; T &gt; &amp;</type><parameter name="other"><paramtype>const <classname>constant_buffer_iterator</classname>&lt; T &gt; &amp;</paramtype></parameter></copy-assignment>
  2492. <destructor/>
  2493. <method-group name="private member functions">
  2494. <method name="dereference" cv="const"><type>reference</type></method>
  2495. <method name="equal" cv="const"><type>bool</type><parameter name="other"><paramtype>const <classname>constant_buffer_iterator</classname>&lt; T &gt; &amp;</paramtype></parameter></method>
  2496. <method name="increment"><type>void</type></method>
  2497. <method name="decrement"><type>void</type></method>
  2498. <method name="advance"><type>void</type><parameter name="n"><paramtype>difference_type</paramtype></parameter></method>
  2499. <method name="distance_to" cv="const"><type>difference_type</type><parameter name="other"><paramtype>const <classname>constant_buffer_iterator</classname>&lt; T &gt; &amp;</paramtype></parameter></method>
  2500. </method-group>
  2501. </class>
  2502. <function name="make_constant_buffer_iterator"><type><classname>constant_buffer_iterator</classname>&lt; T &gt;</type><template>
  2503. <template-type-parameter name="T"/>
  2504. </template><parameter name="buffer"><paramtype>const buffer &amp;</paramtype><description><para>the buffer object </para></description></parameter><parameter name="index"><paramtype>size_t</paramtype><default>0</default><description><para>the index in the buffer</para></description></parameter><description><para>Creates a new <classname alt="boost::compute::constant_buffer_iterator">constant_buffer_iterator</classname> for <computeroutput>buffer</computeroutput> at <computeroutput>index</computeroutput>.</para><para>
  2505. </para></description><returns><para>a <computeroutput><classname alt="boost::compute::constant_buffer_iterator">constant_buffer_iterator</classname></computeroutput> for <computeroutput>buffer</computeroutput> at <computeroutput>index</computeroutput> </para>
  2506. </returns></function>
  2507. </namespace>
  2508. </namespace>
  2509. </header>
  2510. <header name="boost/compute/iterator/constant_iterator.hpp">
  2511. <namespace name="boost">
  2512. <namespace name="compute">
  2513. <class name="constant_iterator"><template>
  2514. <template-type-parameter name="T"/>
  2515. </template><purpose>An iterator with a constant value. </purpose><description><para>The <classname alt="boost::compute::constant_iterator">constant_iterator</classname> class provides an iterator which returns a constant value when dereferenced.</para><para>For example, this could be used to implement the fill() algorithm in terms of the copy() algorithm by copying from a range of constant iterators:</para><para><programlisting language="c++"/> <para><emphasis role="bold">See Also:</emphasis><para>make_constant_iterator() </para>
  2516. </para>
  2517. </para></description><typedef name="super_type"><type><emphasis>unspecified</emphasis></type></typedef>
  2518. <typedef name="reference"><type>super_type::reference</type></typedef>
  2519. <typedef name="difference_type"><type>super_type::difference_type</type></typedef>
  2520. <method-group name="public member functions">
  2521. <method name="get_index" cv="const"><type>size_t</type></method>
  2522. </method-group>
  2523. <constructor><parameter name="value"><paramtype>const T &amp;</paramtype></parameter><parameter name="index"><paramtype>size_t</paramtype><default>0</default></parameter></constructor>
  2524. <constructor><parameter name="other"><paramtype>const <classname>constant_iterator</classname>&lt; T &gt; &amp;</paramtype></parameter></constructor>
  2525. <copy-assignment><type><classname>constant_iterator</classname>&lt; T &gt; &amp;</type><parameter name="other"><paramtype>const <classname>constant_iterator</classname>&lt; T &gt; &amp;</paramtype></parameter></copy-assignment>
  2526. <destructor/>
  2527. <method-group name="private member functions">
  2528. </method-group>
  2529. </class>
  2530. <function name="make_constant_iterator"><type><classname>constant_iterator</classname>&lt; T &gt;</type><template>
  2531. <template-type-parameter name="T"/>
  2532. </template><parameter name="value"><paramtype>const T &amp;</paramtype><description><para>the constant value </para></description></parameter><parameter name="index"><paramtype>size_t</paramtype><default>0</default><description><para>the iterators index</para></description></parameter><description><para>Returns a new <classname alt="boost::compute::constant_iterator">constant_iterator</classname> with <computeroutput>value</computeroutput> at <computeroutput>index</computeroutput>.</para><para>
  2533. </para></description><returns><para>a <computeroutput><classname alt="boost::compute::constant_iterator">constant_iterator</classname></computeroutput> with <computeroutput>value</computeroutput> </para>
  2534. </returns></function>
  2535. </namespace>
  2536. </namespace>
  2537. </header>
  2538. <header name="boost/compute/iterator/counting_iterator.hpp">
  2539. <namespace name="boost">
  2540. <namespace name="compute">
  2541. <class name="counting_iterator"><template>
  2542. <template-type-parameter name="T"/>
  2543. </template><purpose>The <classname alt="boost::compute::counting_iterator">counting_iterator</classname> class implements a counting iterator. </purpose><description><para>A counting iterator returns an internal value (initialized with <computeroutput>init</computeroutput>) which is incremented each time the iterator is incremented.</para><para>For example, this could be used to implement the iota() algorithm in terms of the copy() algorithm by copying from a range of counting iterators:</para><para><programlisting language="c++"/> <para><emphasis role="bold">See Also:</emphasis><para>make_counting_iterator() </para>
  2544. </para>
  2545. </para></description><typedef name="super_type"><type><emphasis>unspecified</emphasis></type></typedef>
  2546. <typedef name="reference"><type>super_type::reference</type></typedef>
  2547. <typedef name="difference_type"><type>super_type::difference_type</type></typedef>
  2548. <method-group name="public member functions">
  2549. <method name="get_index" cv="const"><type>size_t</type></method>
  2550. <method name="operator[]" cv="const"><type><emphasis>unspecified</emphasis></type><template>
  2551. <template-type-parameter name="Expr"/>
  2552. </template><parameter name="expr"><paramtype>const Expr &amp;</paramtype></parameter></method>
  2553. </method-group>
  2554. <constructor><parameter name="init"><paramtype>const T &amp;</paramtype></parameter></constructor>
  2555. <constructor><parameter name="other"><paramtype>const <classname>counting_iterator</classname>&lt; T &gt; &amp;</paramtype></parameter></constructor>
  2556. <copy-assignment><type><classname>counting_iterator</classname>&lt; T &gt; &amp;</type><parameter name="other"><paramtype>const <classname>counting_iterator</classname>&lt; T &gt; &amp;</paramtype></parameter></copy-assignment>
  2557. <destructor/>
  2558. <method-group name="private member functions">
  2559. <method name="dereference" cv="const"><type>reference</type></method>
  2560. <method name="equal" cv="const"><type>bool</type><parameter name="other"><paramtype>const <classname>counting_iterator</classname>&lt; T &gt; &amp;</paramtype></parameter></method>
  2561. <method name="increment"><type>void</type></method>
  2562. <method name="decrement"><type>void</type></method>
  2563. <method name="advance"><type>void</type><parameter name="n"><paramtype>difference_type</paramtype></parameter></method>
  2564. <method name="distance_to" cv="const"><type>difference_type</type><parameter name="other"><paramtype>const <classname>counting_iterator</classname>&lt; T &gt; &amp;</paramtype></parameter></method>
  2565. </method-group>
  2566. </class>
  2567. <function name="make_counting_iterator"><type><classname>counting_iterator</classname>&lt; T &gt;</type><template>
  2568. <template-type-parameter name="T"/>
  2569. </template><parameter name="init"><paramtype>const T &amp;</paramtype><description><para>the initial value</para></description></parameter><description><para>Returns a new <classname alt="boost::compute::counting_iterator">counting_iterator</classname> starting at <computeroutput>init</computeroutput>.</para><para>
  2570. For example, to create a counting iterator which returns unsigned integers and increments from one: <programlisting language="c++">auto iter = make_counting_iterator&lt;uint_&gt;(1);
  2571. </programlisting> </para></description><returns><para>a <classname alt="boost::compute::counting_iterator">counting_iterator</classname> with <computeroutput>init</computeroutput>.</para>
  2572. </returns></function>
  2573. </namespace>
  2574. </namespace>
  2575. </header>
  2576. <header name="boost/compute/iterator/discard_iterator.hpp">
  2577. <namespace name="boost">
  2578. <namespace name="compute">
  2579. <class name="discard_iterator"><inherit access="public">type</inherit><purpose>An iterator which discards all values written to it. </purpose><description><para><para><emphasis role="bold">See Also:</emphasis><para>make_discard_iterator(), <classname alt="boost::compute::constant_iterator">constant_iterator</classname> </para>
  2580. </para>
  2581. </para></description><typedef name="super_type"><type><emphasis>unspecified</emphasis></type></typedef>
  2582. <typedef name="reference"><type>super_type::reference</type></typedef>
  2583. <typedef name="difference_type"><type>super_type::difference_type</type></typedef>
  2584. <method-group name="public member functions">
  2585. </method-group>
  2586. <constructor><parameter name="index"><paramtype>size_t</paramtype><default>0</default></parameter></constructor>
  2587. <constructor><parameter name="other"><paramtype>const <classname>discard_iterator</classname> &amp;</paramtype></parameter></constructor>
  2588. <copy-assignment><type><classname>discard_iterator</classname> &amp;</type><parameter name="other"><paramtype>const <classname>discard_iterator</classname> &amp;</paramtype></parameter></copy-assignment>
  2589. <destructor/>
  2590. <method-group name="private member functions">
  2591. </method-group>
  2592. </class><struct-specialization name="is_device_iterator"><template>
  2593. </template><specialization><template-arg>discard_iterator</template-arg></specialization><inherit access="public">true_type</inherit><purpose>internal_ (<classname alt="boost::compute::is_device_iterator">is_device_iterator</classname> specialization for <classname alt="boost::compute::discard_iterator">discard_iterator</classname>) </purpose></struct-specialization>
  2594. <function name="make_discard_iterator"><type><classname>discard_iterator</classname></type><parameter name="index"><paramtype>size_t</paramtype><default>0</default><description><para>the index of the iterator</para></description></parameter><description><para>Returns a new <classname alt="boost::compute::discard_iterator">discard_iterator</classname> with <computeroutput>index</computeroutput>.</para><para>
  2595. </para></description><returns><para>a <computeroutput><classname alt="boost::compute::discard_iterator">discard_iterator</classname></computeroutput> at <computeroutput>index</computeroutput> </para>
  2596. </returns></function>
  2597. </namespace>
  2598. </namespace>
  2599. </header>
  2600. <header name="boost/compute/iterator/function_input_iterator.hpp">
  2601. <namespace name="boost">
  2602. <namespace name="compute">
  2603. <class name="function_input_iterator"><template>
  2604. <template-type-parameter name="Function"/>
  2605. </template><purpose>Iterator which returns the result of a function when dereferenced. </purpose><description><para>For example:</para><para><programlisting language="c++"/> <para><emphasis role="bold">See Also:</emphasis><para>make_function_input_iterator() </para>
  2606. </para>
  2607. </para></description><typedef name="super_type"><type><emphasis>unspecified</emphasis></type></typedef>
  2608. <typedef name="reference"><type>super_type::reference</type></typedef>
  2609. <typedef name="difference_type"><type>super_type::difference_type</type></typedef>
  2610. <typedef name="function"><type>Function</type></typedef>
  2611. <method-group name="public member functions">
  2612. <method name="get_index" cv="const"><type>size_t</type></method>
  2613. <method name="operator[]" cv="const"><type><emphasis>unspecified</emphasis></type><template>
  2614. <template-type-parameter name="Expr"/>
  2615. </template><parameter name="expr"><paramtype>const Expr &amp;</paramtype></parameter></method>
  2616. </method-group>
  2617. <constructor><parameter name="function"><paramtype>const Function &amp;</paramtype></parameter><parameter name="index"><paramtype>size_t</paramtype><default>0</default></parameter></constructor>
  2618. <constructor><parameter name="other"><paramtype>const <classname>function_input_iterator</classname>&lt; Function &gt; &amp;</paramtype></parameter></constructor>
  2619. <copy-assignment><type><classname>function_input_iterator</classname>&lt; Function &gt; &amp;</type><parameter name="other"><paramtype>const <classname>function_input_iterator</classname>&lt; Function &gt; &amp;</paramtype></parameter></copy-assignment>
  2620. <destructor/>
  2621. <method-group name="private member functions">
  2622. <method name="dereference" cv="const"><type>reference</type></method>
  2623. <method name="equal" cv="const"><type>bool</type><parameter name="other"><paramtype>const <classname>function_input_iterator</classname>&lt; Function &gt; &amp;</paramtype></parameter></method>
  2624. <method name="increment"><type>void</type></method>
  2625. <method name="decrement"><type>void</type></method>
  2626. <method name="advance"><type>void</type><parameter name="n"><paramtype>difference_type</paramtype></parameter></method>
  2627. <method name="distance_to" cv="const"><type>difference_type</type><parameter name="other"><paramtype>const <classname>function_input_iterator</classname>&lt; Function &gt; &amp;</paramtype></parameter></method>
  2628. </method-group>
  2629. </class>
  2630. <function name="make_function_input_iterator"><type><classname>function_input_iterator</classname>&lt; Function &gt;</type><template>
  2631. <template-type-parameter name="Function"/>
  2632. </template><parameter name="function"><paramtype>const Function &amp;</paramtype><description><para>function to execute when dereferenced </para></description></parameter><parameter name="index"><paramtype>size_t</paramtype><default>0</default><description><para>index of the iterator</para></description></parameter><description><para>Returns a <classname alt="boost::compute::function_input_iterator">function_input_iterator</classname> with <computeroutput>function</computeroutput>.</para><para>
  2633. </para></description><returns><para>a <computeroutput><classname alt="boost::compute::function_input_iterator">function_input_iterator</classname></computeroutput> with <computeroutput>function</computeroutput> </para>
  2634. </returns></function>
  2635. </namespace>
  2636. </namespace>
  2637. </header>
  2638. <header name="boost/compute/iterator/permutation_iterator.hpp">
  2639. <namespace name="boost">
  2640. <namespace name="compute">
  2641. <class name="permutation_iterator"><template>
  2642. <template-type-parameter name="ElementIterator"/>
  2643. <template-type-parameter name="IndexIterator"/>
  2644. </template><purpose>The <classname alt="boost::compute::permutation_iterator">permutation_iterator</classname> class provides a permuation iterator. </purpose><description><para>A permutation iterator iterates over a value range and an index range. When dereferenced, it returns the value from the value range using the current index from the index range.</para><para>For example, to reverse a range using the copy() algorithm and a permutation sequence:</para><para><programlisting language="c++"/> <para><emphasis role="bold">See Also:</emphasis><para>make_permutation_iterator() </para>
  2645. </para>
  2646. </para></description><typedef name="super_type"><type><emphasis>unspecified</emphasis></type></typedef>
  2647. <typedef name="value_type"><type>super_type::value_type</type></typedef>
  2648. <typedef name="reference"><type>super_type::reference</type></typedef>
  2649. <typedef name="base_type"><type>super_type::base_type</type></typedef>
  2650. <typedef name="difference_type"><type>super_type::difference_type</type></typedef>
  2651. <typedef name="index_iterator"><type>IndexIterator</type></typedef>
  2652. <method-group name="public member functions">
  2653. <method name="get_index" cv="const"><type>size_t</type></method>
  2654. <method name="get_buffer" cv="const"><type>const buffer &amp;</type></method>
  2655. <method name="operator[]" cv="const"><type><emphasis>unspecified</emphasis></type><template>
  2656. <template-type-parameter name="IndexExpr"/>
  2657. </template><parameter name="expr"><paramtype>const IndexExpr &amp;</paramtype></parameter></method>
  2658. </method-group>
  2659. <constructor><parameter name="e"><paramtype>ElementIterator</paramtype></parameter><parameter name="i"><paramtype>IndexIterator</paramtype></parameter></constructor>
  2660. <constructor><parameter name="other"><paramtype>const <classname>permutation_iterator</classname>&lt; ElementIterator, IndexIterator &gt; &amp;</paramtype></parameter></constructor>
  2661. <copy-assignment><type><classname>permutation_iterator</classname>&lt; ElementIterator, IndexIterator &gt; &amp;</type><parameter name="other"><paramtype>const <classname>permutation_iterator</classname>&lt; ElementIterator, IndexIterator &gt; &amp;</paramtype></parameter></copy-assignment>
  2662. <destructor/>
  2663. <method-group name="private member functions">
  2664. <method name="dereference" cv="const"><type>reference</type></method>
  2665. </method-group>
  2666. </class>
  2667. <function name="make_permutation_iterator"><type><classname>permutation_iterator</classname>&lt; ElementIterator, IndexIterator &gt;</type><template>
  2668. <template-type-parameter name="ElementIterator"/>
  2669. <template-type-parameter name="IndexIterator"/>
  2670. </template><parameter name="e"><paramtype>ElementIterator</paramtype><description><para>the element range iterator </para></description></parameter><parameter name="i"><paramtype>IndexIterator</paramtype><description><para>the index range iterator</para></description></parameter><description><para>Returns a <classname alt="boost::compute::permutation_iterator">permutation_iterator</classname> for <computeroutput>e</computeroutput> using indices from <computeroutput>i</computeroutput>.</para><para>
  2671. </para></description><returns><para>a <computeroutput><classname alt="boost::compute::permutation_iterator">permutation_iterator</classname></computeroutput> for <computeroutput>e</computeroutput> using <computeroutput>i</computeroutput> </para>
  2672. </returns></function>
  2673. </namespace>
  2674. </namespace>
  2675. </header>
  2676. <header name="boost/compute/iterator/strided_iterator.hpp">
  2677. <namespace name="boost">
  2678. <namespace name="compute">
  2679. <class name="strided_iterator"><template>
  2680. <template-type-parameter name="Iterator"/>
  2681. </template><purpose>An iterator adaptor with adjustable iteration step. </purpose><description><para>The strided iterator adaptor skips over multiple elements each time it is incremented or decremented.</para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::buffer_iterator">buffer_iterator</classname>, make_strided_iterator(), make_strided_iterator_end() </para>
  2682. </para>
  2683. </para></description><typedef name="super_type"><type><emphasis>unspecified</emphasis></type></typedef>
  2684. <typedef name="value_type"><type>super_type::value_type</type></typedef>
  2685. <typedef name="reference"><type>super_type::reference</type></typedef>
  2686. <typedef name="base_type"><type>super_type::base_type</type></typedef>
  2687. <typedef name="difference_type"><type>super_type::difference_type</type></typedef>
  2688. <method-group name="public member functions">
  2689. <method name="get_index" cv="const"><type>size_t</type></method>
  2690. <method name="get_buffer" cv="const"><type>const buffer &amp;</type></method>
  2691. <method name="operator[]" cv="const"><type><emphasis>unspecified</emphasis></type><template>
  2692. <template-type-parameter name="IndexExpression"/>
  2693. </template><parameter name="expr"><paramtype>const IndexExpression &amp;</paramtype></parameter></method>
  2694. </method-group>
  2695. <constructor><parameter name="iterator"><paramtype>Iterator</paramtype></parameter><parameter name="stride"><paramtype>difference_type</paramtype></parameter></constructor>
  2696. <constructor><parameter name="other"><paramtype>const <classname>strided_iterator</classname>&lt; Iterator &gt; &amp;</paramtype></parameter></constructor>
  2697. <copy-assignment><type><classname>strided_iterator</classname>&lt; Iterator &gt; &amp;</type><parameter name="other"><paramtype>const <classname>strided_iterator</classname>&lt; Iterator &gt; &amp;</paramtype></parameter></copy-assignment>
  2698. <destructor/>
  2699. <method-group name="private member functions">
  2700. <method name="dereference" cv="const"><type>reference</type></method>
  2701. <method name="equal" cv="const"><type>bool</type><parameter name="other"><paramtype>const <classname>strided_iterator</classname>&lt; Iterator &gt; &amp;</paramtype></parameter></method>
  2702. <method name="increment"><type>void</type></method>
  2703. <method name="decrement"><type>void</type></method>
  2704. <method name="advance"><type>void</type><parameter name="n"><paramtype>typename super_type::difference_type</paramtype></parameter></method>
  2705. <method name="distance_to" cv="const"><type>difference_type</type><parameter name="other"><paramtype>const <classname>strided_iterator</classname>&lt; Iterator &gt; &amp;</paramtype></parameter></method>
  2706. </method-group>
  2707. </class>
  2708. <function name="make_strided_iterator"><type><classname>strided_iterator</classname>&lt; Iterator &gt;</type><template>
  2709. <template-type-parameter name="Iterator"/>
  2710. </template><parameter name="iterator"><paramtype>Iterator</paramtype><description><para>the underlying iterator </para></description></parameter><parameter name="stride"><paramtype>typename std::iterator_traits&lt; Iterator &gt;::difference_type</paramtype><description><para>the iteration step for <classname alt="boost::compute::strided_iterator">strided_iterator</classname></para></description></parameter><description><para>Returns a <classname alt="boost::compute::strided_iterator">strided_iterator</classname> for <computeroutput>iterator</computeroutput> with <computeroutput>stride</computeroutput>.</para><para>
  2711. For example, to create an iterator which iterates over every other element in a <computeroutput>vector&lt;int&gt;</computeroutput>: <programlisting language="c++">auto strided_iterator = make_strided_iterator(vec.begin(), 2);
  2712. </programlisting> </para></description><returns><para>a <computeroutput><classname alt="boost::compute::strided_iterator">strided_iterator</classname></computeroutput> for <computeroutput>iterator</computeroutput> with <computeroutput>stride</computeroutput>.</para>
  2713. </returns></function>
  2714. <function name="make_strided_iterator_end"><type><classname>strided_iterator</classname>&lt; Iterator &gt;</type><template>
  2715. <template-type-parameter name="Iterator"/>
  2716. </template><parameter name="first"><paramtype>Iterator</paramtype><description><para>the iterator referring to the first element accessible through <classname alt="boost::compute::strided_iterator">strided_iterator</classname> for <computeroutput>first</computeroutput> with <computeroutput>stride</computeroutput> </para></description></parameter><parameter name="last"><paramtype>Iterator</paramtype><description><para>the iterator referring to the last element that may be accessible through <classname alt="boost::compute::strided_iterator">strided_iterator</classname> for <computeroutput>first</computeroutput> with <computeroutput>stride</computeroutput> </para></description></parameter><parameter name="stride"><paramtype>typename std::iterator_traits&lt; Iterator &gt;::difference_type</paramtype><description><para>the iteration step</para></description></parameter><description><para>Returns a <classname alt="boost::compute::strided_iterator">strided_iterator</classname> which refers to element that would follow the last element accessible through <classname alt="boost::compute::strided_iterator">strided_iterator</classname> for <computeroutput>first</computeroutput> iterator with <computeroutput>stride</computeroutput>.</para><para>Parameter <computeroutput>stride</computeroutput> must be greater than zero.</para><para>
  2717. It can be helpful when iterating over <classname alt="boost::compute::strided_iterator">strided_iterator</classname>: <programlisting language="c++">// vec.size() may not be divisible by 3
  2718. auto strided_iterator_begin = make_strided_iterator(vec.begin(), 3);
  2719. auto strided_iterator_end = make_strided_iterator_end(vec.begin(), vec.end(), 3);
  2720. // copy every 3rd element to result
  2721. boost::compute::copy(
  2722. strided_iterator_begin,
  2723. strided_iterator_end,
  2724. result.begin(),
  2725. queue
  2726. );
  2727. </programlisting> </para></description><returns><para>a <computeroutput><classname alt="boost::compute::strided_iterator">strided_iterator</classname></computeroutput> referring to element that would follow the last element accessible through <classname alt="boost::compute::strided_iterator">strided_iterator</classname> for <computeroutput>first</computeroutput> iterator with <computeroutput>stride</computeroutput>.</para>
  2728. </returns></function>
  2729. </namespace>
  2730. </namespace>
  2731. </header>
  2732. <header name="boost/compute/iterator/transform_iterator.hpp">
  2733. <namespace name="boost">
  2734. <namespace name="compute">
  2735. <class name="transform_iterator"><template>
  2736. <template-type-parameter name="InputIterator"/>
  2737. <template-type-parameter name="UnaryFunction"/>
  2738. </template><purpose>A transform iterator adaptor. </purpose><description><para>The <classname alt="boost::compute::transform_iterator">transform_iterator</classname> adaptor applies a unary function to each element produced from the underlying iterator when dereferenced.</para><para>For example, to copy from an input range to an output range while taking the absolute value of each element:</para><para><programlisting language="c++"/> <para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::buffer_iterator">buffer_iterator</classname>, make_transform_iterator() </para>
  2739. </para>
  2740. </para></description><typedef name="super_type"><type><emphasis>unspecified</emphasis></type></typedef>
  2741. <typedef name="value_type"><type>super_type::value_type</type></typedef>
  2742. <typedef name="reference"><type>super_type::reference</type></typedef>
  2743. <typedef name="base_type"><type>super_type::base_type</type></typedef>
  2744. <typedef name="difference_type"><type>super_type::difference_type</type></typedef>
  2745. <typedef name="unary_function"><type>UnaryFunction</type></typedef>
  2746. <method-group name="public member functions">
  2747. <method name="get_index" cv="const"><type>size_t</type></method>
  2748. <method name="get_buffer" cv="const"><type>const buffer &amp;</type></method>
  2749. <method name="operator[]" cv="const"><type><emphasis>unspecified</emphasis></type><template>
  2750. <template-type-parameter name="IndexExpression"/>
  2751. </template><parameter name="expr"><paramtype>const IndexExpression &amp;</paramtype></parameter></method>
  2752. </method-group>
  2753. <constructor><parameter name="iterator"><paramtype>InputIterator</paramtype></parameter><parameter name="transform"><paramtype>UnaryFunction</paramtype></parameter></constructor>
  2754. <constructor><parameter name="other"><paramtype>const <classname>transform_iterator</classname>&lt; InputIterator, UnaryFunction &gt; &amp;</paramtype></parameter></constructor>
  2755. <copy-assignment><type><classname>transform_iterator</classname>&lt; InputIterator, UnaryFunction &gt; &amp;</type><parameter name="other"><paramtype>const <classname>transform_iterator</classname>&lt; InputIterator, UnaryFunction &gt; &amp;</paramtype></parameter></copy-assignment>
  2756. <destructor/>
  2757. <method-group name="private member functions">
  2758. <method name="dereference" cv="const"><type>reference</type></method>
  2759. </method-group>
  2760. </class>
  2761. <function name="make_transform_iterator"><type><classname>transform_iterator</classname>&lt; InputIterator, UnaryFunction &gt;</type><template>
  2762. <template-type-parameter name="InputIterator"/>
  2763. <template-type-parameter name="UnaryFunction"/>
  2764. </template><parameter name="iterator"><paramtype>InputIterator</paramtype><description><para>the underlying iterator </para></description></parameter><parameter name="transform"><paramtype>UnaryFunction</paramtype><description><para>the unary transform function</para></description></parameter><description><para>Returns a <classname alt="boost::compute::transform_iterator">transform_iterator</classname> for <computeroutput>iterator</computeroutput> with <computeroutput>transform</computeroutput>.</para><para>
  2765. For example, to create an iterator which returns the square-root of each value in a <computeroutput>vector&lt;int&gt;</computeroutput>: <programlisting language="c++">auto sqrt_iterator = make_transform_iterator(vec.begin(), sqrt&lt;int&gt;());
  2766. </programlisting> </para></description><returns><para>a <computeroutput><classname alt="boost::compute::transform_iterator">transform_iterator</classname></computeroutput> for <computeroutput>iterator</computeroutput> with <computeroutput>transform</computeroutput> </para>
  2767. </returns></function>
  2768. </namespace>
  2769. </namespace>
  2770. </header>
  2771. <header name="boost/compute/iterator/zip_iterator.hpp">
  2772. <namespace name="boost">
  2773. <namespace name="compute">
  2774. <class name="zip_iterator"><template>
  2775. <template-type-parameter name="IteratorTuple"/>
  2776. </template><purpose>A zip iterator adaptor. </purpose><description><para>The <classname alt="boost::compute::zip_iterator">zip_iterator</classname> class combines values from multiple input iterators. When dereferenced it returns a tuple containing each value at the current position in each input range.</para><para><para><emphasis role="bold">See Also:</emphasis><para>make_zip_iterator() </para>
  2777. </para>
  2778. </para></description><typedef name="super_type"><type><emphasis>unspecified</emphasis></type></typedef>
  2779. <typedef name="value_type"><type>super_type::value_type</type></typedef>
  2780. <typedef name="reference"><type>super_type::reference</type></typedef>
  2781. <typedef name="difference_type"><type>super_type::difference_type</type></typedef>
  2782. <typedef name="iterator_tuple"><type>IteratorTuple</type></typedef>
  2783. <method-group name="public member functions">
  2784. <method name="get_iterator_tuple" cv="const"><type>const IteratorTuple &amp;</type></method>
  2785. <method name="operator[]" cv="const"><type><emphasis>unspecified</emphasis></type><template>
  2786. <template-type-parameter name="IndexExpression"/>
  2787. </template><parameter name="expr"><paramtype>const IndexExpression &amp;</paramtype></parameter></method>
  2788. </method-group>
  2789. <constructor><parameter name="iterators"><paramtype>IteratorTuple</paramtype></parameter></constructor>
  2790. <constructor><parameter name="other"><paramtype>const <classname>zip_iterator</classname>&lt; IteratorTuple &gt; &amp;</paramtype></parameter></constructor>
  2791. <copy-assignment><type><classname>zip_iterator</classname>&lt; IteratorTuple &gt; &amp;</type><parameter name="other"><paramtype>const <classname>zip_iterator</classname>&lt; IteratorTuple &gt; &amp;</paramtype></parameter></copy-assignment>
  2792. <destructor/>
  2793. <method-group name="private member functions">
  2794. <method name="dereference" cv="const"><type>reference</type></method>
  2795. <method name="equal" cv="const"><type>bool</type><parameter name="other"><paramtype>const <classname>zip_iterator</classname>&lt; IteratorTuple &gt; &amp;</paramtype></parameter></method>
  2796. <method name="increment"><type>void</type></method>
  2797. <method name="decrement"><type>void</type></method>
  2798. <method name="advance"><type>void</type><parameter name="n"><paramtype>difference_type</paramtype></parameter></method>
  2799. <method name="distance_to" cv="const"><type>difference_type</type><parameter name="other"><paramtype>const <classname>zip_iterator</classname>&lt; IteratorTuple &gt; &amp;</paramtype></parameter></method>
  2800. </method-group>
  2801. </class>
  2802. <function name="make_zip_iterator"><type><classname>zip_iterator</classname>&lt; IteratorTuple &gt;</type><template>
  2803. <template-type-parameter name="IteratorTuple"/>
  2804. </template><parameter name="iterators"><paramtype>IteratorTuple</paramtype><description><para>a tuple of input iterators to zip together</para></description></parameter><description><para>Creates a <classname alt="boost::compute::zip_iterator">zip_iterator</classname> for <computeroutput>iterators</computeroutput>.</para><para>
  2805. For example, to zip together iterators from three vectors (<computeroutput>a</computeroutput>, <computeroutput>b</computeroutput>, and <computeroutput>c</computeroutput>): <programlisting language="c++">auto zipped = boost::compute::make_zip_iterator(
  2806. boost::make_tuple(a.begin(), b.begin(), c.begin())
  2807. );
  2808. </programlisting> </para></description><returns><para>a <computeroutput><classname alt="boost::compute::zip_iterator">zip_iterator</classname></computeroutput> for <computeroutput>iterators</computeroutput> </para>
  2809. </returns></function>
  2810. </namespace>
  2811. </namespace>
  2812. </header>
  2813. <header name="boost/compute/memory/local_buffer.hpp">
  2814. <namespace name="boost">
  2815. <namespace name="compute">
  2816. <class name="local_buffer"><template>
  2817. <template-type-parameter name="T"/>
  2818. </template><purpose>Represents a local memory buffer on the device. </purpose><description><para>The <classname alt="boost::compute::local_buffer">local_buffer</classname> class represents a block of local memory on a compute device.</para><para>This class is most commonly used to set local memory arguments for compute kernels: <programlisting language="c++">// set argument to a local buffer with storage for 32 float's
  2819. kernel.set_arg(0, local_buffer&lt;float&gt;(32));
  2820. </programlisting></para><para><para><emphasis role="bold">See Also:</emphasis><para>buffer, kernel </para>
  2821. </para>
  2822. </para></description><method-group name="public member functions">
  2823. <method name="size" cv="const"><type>size_t</type><purpose>Returns the number of elements in the local buffer. </purpose></method>
  2824. </method-group>
  2825. <constructor><parameter name="size"><paramtype>const size_t</paramtype></parameter><purpose>Creates a local buffer object for <computeroutput>size</computeroutput> elements. </purpose></constructor>
  2826. <constructor><parameter name="other"><paramtype>const <classname>local_buffer</classname> &amp;</paramtype></parameter><purpose>Creates a local buffer object as a copy of <computeroutput>other</computeroutput>. </purpose></constructor>
  2827. <copy-assignment><type><classname>local_buffer</classname> &amp;</type><parameter name="other"><paramtype>const <classname>local_buffer</classname> &amp;</paramtype></parameter><purpose>Copies <computeroutput>other</computeroutput> to <computeroutput>*this</computeroutput>. </purpose></copy-assignment>
  2828. <destructor><purpose>Destroys the local memory object. </purpose></destructor>
  2829. </class>
  2830. </namespace>
  2831. </namespace>
  2832. </header>
  2833. <header name="boost/compute/memory/svm_ptr.hpp">
  2834. <namespace name="boost">
  2835. <namespace name="compute">
  2836. <class name="svm_ptr"><template>
  2837. <template-type-parameter name="T"/>
  2838. </template><typedef name="value_type"><type>T</type></typedef>
  2839. <typedef name="difference_type"><type>std::ptrdiff_t</type></typedef>
  2840. <typedef name="pointer"><type>T *</type></typedef>
  2841. <typedef name="reference"><type>T &amp;</type></typedef>
  2842. <typedef name="iterator_category"><type>std::random_access_iterator_tag</type></typedef>
  2843. <method-group name="public member functions">
  2844. <method name="get" cv="const"><type>void *</type></method>
  2845. <method name="operator+"><type>svm_ptr&lt; T &gt;</type><parameter name="n"><paramtype>difference_type</paramtype></parameter></method>
  2846. <method name="operator-"><type>difference_type</type><parameter name="other"><paramtype>svm_ptr&lt; T &gt;</paramtype></parameter></method>
  2847. <method name="get_context" cv="const"><type>const context &amp;</type></method>
  2848. <method name="operator==" cv="const"><type>bool</type><parameter name="other"><paramtype>const svm_ptr&lt; T &gt; &amp;</paramtype></parameter></method>
  2849. <method name="operator!=" cv="const"><type>bool</type><parameter name="other"><paramtype>const svm_ptr&lt; T &gt; &amp;</paramtype></parameter></method>
  2850. </method-group>
  2851. <constructor/>
  2852. <constructor><parameter name="ptr"><paramtype>void *</paramtype></parameter><parameter name="context"><paramtype>const context &amp;</paramtype></parameter></constructor>
  2853. <constructor><parameter name="other"><paramtype>const svm_ptr&lt; T &gt; &amp;</paramtype></parameter></constructor>
  2854. <copy-assignment><type>svm_ptr&lt; T &gt; &amp;</type><parameter name="other"><paramtype>const svm_ptr&lt; T &gt; &amp;</paramtype></parameter></copy-assignment>
  2855. <destructor/>
  2856. </class>
  2857. </namespace>
  2858. </namespace>
  2859. </header>
  2860. <header name="boost/compute/random/bernoulli_distribution.hpp">
  2861. <namespace name="boost">
  2862. <namespace name="compute">
  2863. <class name="bernoulli_distribution"><template>
  2864. <template-type-parameter name="RealType"><default>float</default></template-type-parameter>
  2865. </template><purpose>Produces random boolean values according to the following discrete probability function with parameter p : P(true/p) = p and P(false/p) = (1 - p) </purpose><description><para>The following example shows how to setup a bernoulli distribution to produce random boolean values with parameter p = 0.25</para><para><programlisting language="c++"/></para></description><method-group name="public member functions">
  2866. <method name="p" cv="const"><type>RealType</type><purpose>Returns the value of the parameter p. </purpose></method>
  2867. <method name="generate"><type>void</type><template>
  2868. <template-type-parameter name="OutputIterator"/>
  2869. <template-type-parameter name="Generator"/>
  2870. </template><parameter name="first"><paramtype>OutputIterator</paramtype></parameter><parameter name="last"><paramtype>OutputIterator</paramtype></parameter><parameter name="generator"><paramtype>Generator &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>Generates bernoulli distributed booleans and stores them in the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>). </para></description></method>
  2871. </method-group>
  2872. <constructor><parameter name="p"><paramtype>RealType</paramtype><default>0.5f</default></parameter><purpose>Creates a new bernoulli distribution. </purpose></constructor>
  2873. <destructor><purpose>Destroys the <classname alt="boost::compute::bernoulli_distribution">bernoulli_distribution</classname> object. </purpose></destructor>
  2874. <method-group name="private member functions">
  2875. <method name="BOOST_STATIC_ASSERT_MSG"><type/><parameter name=""><paramtype>boost::is_floating_point&lt; RealType &gt;::value</paramtype></parameter><parameter name=""><paramtype>"Template argument must be a floating point type"</paramtype></parameter></method>
  2876. </method-group>
  2877. </class>
  2878. </namespace>
  2879. </namespace>
  2880. </header>
  2881. <header name="boost/compute/random/default_random_engine.hpp">
  2882. <namespace name="boost">
  2883. <namespace name="compute">
  2884. <typedef name="default_random_engine"><type><classname>mt19937</classname></type></typedef>
  2885. </namespace>
  2886. </namespace>
  2887. </header>
  2888. <header name="boost/compute/random/discrete_distribution.hpp">
  2889. <namespace name="boost">
  2890. <namespace name="compute">
  2891. <class name="discrete_distribution"><template>
  2892. <template-type-parameter name="IntType"><default>uint_</default></template-type-parameter>
  2893. </template><purpose>Produces random integers on the interval [0, n), where probability of each integer is given by the weight of the ith integer divided by the sum of all weights. </purpose><description><para>The following example shows how to setup a discrete distribution to produce 0 and 1 with equal probability</para><para><programlisting language="c++"/></para></description><typedef name="result_type"><type>IntType</type></typedef>
  2894. <method-group name="public member functions">
  2895. <method name="probabilities" cv="const"><type>::std::vector&lt; double &gt;</type><purpose>Returns the probabilities. </purpose></method>
  2896. <method name="BOOST_PREVENT_MACRO_SUBSTITUTION" cv="const"><type>result_type min</type><purpose>Returns the minimum potentially generated value. </purpose></method>
  2897. <method name="BOOST_PREVENT_MACRO_SUBSTITUTION" cv="const"><type>result_type max</type><purpose>Returns the maximum potentially generated value. </purpose></method>
  2898. <method name="generate"><type>void</type><template>
  2899. <template-type-parameter name="OutputIterator"/>
  2900. <template-type-parameter name="Generator"/>
  2901. </template><parameter name="first"><paramtype>OutputIterator</paramtype></parameter><parameter name="last"><paramtype>OutputIterator</paramtype></parameter><parameter name="generator"><paramtype>Generator &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>Generates uniformly distributed integers and stores them to the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>). </para></description></method>
  2902. </method-group>
  2903. <constructor><description><para>Creates a new discrete distribution with a single weight p = { 1 }. This distribution produces only zeroes. </para></description></constructor>
  2904. <constructor><template>
  2905. <template-type-parameter name="InputIterator"/>
  2906. </template><parameter name="first"><paramtype>InputIterator</paramtype></parameter><parameter name="last"><paramtype>InputIterator</paramtype></parameter><description><para>Creates a new discrete distribution with weights given by the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>). </para></description></constructor>
  2907. <destructor><purpose>Destroys the <classname alt="boost::compute::discrete_distribution">discrete_distribution</classname> object. </purpose></destructor>
  2908. <method-group name="private member functions">
  2909. <method name="BOOST_STATIC_ASSERT_MSG"><type/><parameter name=""><paramtype>boost::is_integral&lt; IntType &gt;::value</paramtype></parameter><parameter name=""><paramtype>"Template argument must be integral"</paramtype></parameter></method>
  2910. </method-group>
  2911. </class>
  2912. </namespace>
  2913. </namespace>
  2914. </header>
  2915. <header name="boost/compute/random/linear_congruential_engine.hpp">
  2916. <namespace name="boost">
  2917. <namespace name="compute">
  2918. <class name="linear_congruential_engine"><template>
  2919. <template-type-parameter name="T"><default>uint_</default></template-type-parameter>
  2920. </template><purpose>'Quick and Dirty' linear congruential engine </purpose><description><para>Quick and dirty linear congruential engine to generate low quality random numbers very quickly. For uses in which good quality of random numbers is required(Monte-Carlo Simulations), use other engines like Mersenne Twister instead. </para></description><typedef name="result_type"><type>T</type></typedef>
  2921. <data-member name="default_seed" specifiers="static"><type>const T</type></data-member>
  2922. <data-member name="a" specifiers="static"><type>const T</type></data-member>
  2923. <data-member name="threads" specifiers="static"><type>const size_t</type></data-member>
  2924. <method-group name="public member functions">
  2925. <method name="seed"><type>void</type><parameter name="value"><paramtype>result_type</paramtype><description><para>seed value for the random-number generator </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><description><para>command queue to perform the operation</para></description></parameter><description><para>Seeds the random number generator with <computeroutput>value</computeroutput>.</para><para>
  2926. If no seed value is provided, <computeroutput>default_seed</computeroutput> is used. </para></description></method>
  2927. <method name="seed"><type>void</type><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. </para></description></method>
  2928. <method name="generate"><type>void</type><template>
  2929. <template-type-parameter name="OutputIterator"/>
  2930. </template><parameter name="first"><paramtype>OutputIterator</paramtype></parameter><parameter name="last"><paramtype>OutputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><purpose>Generates random numbers and stores them to the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>). </purpose></method>
  2931. <method name="generate"><type>void</type><template>
  2932. <template-type-parameter name="OutputIterator"/>
  2933. <template-type-parameter name="Function"/>
  2934. </template><parameter name="first"><paramtype>OutputIterator</paramtype></parameter><parameter name="last"><paramtype>OutputIterator</paramtype></parameter><parameter name="op"><paramtype>Function</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>Generates random numbers, transforms them with <computeroutput>op</computeroutput>, and then stores them to the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>). </para></description></method>
  2935. <method name="discard"><type>void</type><parameter name="z"><paramtype>size_t</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><purpose>Generates <computeroutput>z</computeroutput> random numbers and discards them. </purpose></method>
  2936. </method-group>
  2937. <constructor specifiers="explicit"><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><parameter name="value"><paramtype>result_type</paramtype><default>default_seed</default></parameter><purpose>Creates a new <classname alt="boost::compute::linear_congruential_engine">linear_congruential_engine</classname> and seeds it with <computeroutput>value</computeroutput>. </purpose></constructor>
  2938. <constructor><parameter name="other"><paramtype>const <classname>linear_congruential_engine</classname>&lt; T &gt; &amp;</paramtype></parameter><purpose>Creates a new <classname alt="boost::compute::linear_congruential_engine">linear_congruential_engine</classname> object as a copy of <computeroutput>other</computeroutput>. </purpose></constructor>
  2939. <copy-assignment><type><classname>linear_congruential_engine</classname>&lt; T &gt; &amp;</type><parameter name="other"><paramtype>const <classname>linear_congruential_engine</classname>&lt; T &gt; &amp;</paramtype></parameter><purpose>Copies <computeroutput>other</computeroutput> to <computeroutput>*this</computeroutput>. </purpose></copy-assignment>
  2940. <destructor><purpose>Destroys the <classname alt="boost::compute::linear_congruential_engine">linear_congruential_engine</classname> object. </purpose></destructor>
  2941. <method-group name="private member functions">
  2942. </method-group>
  2943. </class>
  2944. </namespace>
  2945. </namespace>
  2946. </header>
  2947. <header name="boost/compute/random/mersenne_twister_engine.hpp">
  2948. <namespace name="boost">
  2949. <namespace name="compute">
  2950. <class name="mersenne_twister_engine"><template>
  2951. <template-type-parameter name="T"/>
  2952. </template><purpose>Mersenne twister pseudorandom number generator. </purpose><typedef name="result_type"><type>T</type></typedef>
  2953. <data-member name="default_seed" specifiers="static"><type>const T</type></data-member>
  2954. <data-member name="n" specifiers="static"><type>const T</type></data-member>
  2955. <data-member name="m" specifiers="static"><type>const T</type></data-member>
  2956. <method-group name="public member functions">
  2957. <method name="seed"><type>void</type><parameter name="value"><paramtype>result_type</paramtype><description><para>seed value for the random-number generator </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><description><para>command queue to perform the operation</para></description></parameter><description><para>Seeds the random number generator with <computeroutput>value</computeroutput>.</para><para>
  2958. If no seed value is provided, <computeroutput>default_seed</computeroutput> is used. </para></description></method>
  2959. <method name="seed"><type>void</type><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. </para></description></method>
  2960. <method name="generate"><type>void</type><template>
  2961. <template-type-parameter name="OutputIterator"/>
  2962. </template><parameter name="first"><paramtype>OutputIterator</paramtype></parameter><parameter name="last"><paramtype>OutputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><purpose>Generates random numbers and stores them to the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>). </purpose></method>
  2963. <method name="generate"><type>void</type><template>
  2964. <template-type-parameter name="OutputIterator"/>
  2965. <template-type-parameter name="Function"/>
  2966. </template><parameter name="first"><paramtype>OutputIterator</paramtype></parameter><parameter name="last"><paramtype>OutputIterator</paramtype></parameter><parameter name="op"><paramtype>Function</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>Generates random numbers, transforms them with <computeroutput>op</computeroutput>, and then stores them to the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>). </para></description></method>
  2967. <method name="discard"><type>void</type><parameter name="z"><paramtype>size_t</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><purpose>Generates <computeroutput>z</computeroutput> random numbers and discards them. </purpose></method>
  2968. </method-group>
  2969. <constructor specifiers="explicit"><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><parameter name="value"><paramtype>result_type</paramtype><default>default_seed</default></parameter><purpose>Creates a new <classname alt="boost::compute::mersenne_twister_engine">mersenne_twister_engine</classname> and seeds it with <computeroutput>value</computeroutput>. </purpose></constructor>
  2970. <constructor><parameter name="other"><paramtype>const <classname>mersenne_twister_engine</classname>&lt; T &gt; &amp;</paramtype></parameter><purpose>Creates a new <classname alt="boost::compute::mersenne_twister_engine">mersenne_twister_engine</classname> object as a copy of <computeroutput>other</computeroutput>. </purpose></constructor>
  2971. <copy-assignment><type><classname>mersenne_twister_engine</classname>&lt; T &gt; &amp;</type><parameter name="other"><paramtype>const <classname>mersenne_twister_engine</classname>&lt; T &gt; &amp;</paramtype></parameter><purpose>Copies <computeroutput>other</computeroutput> to <computeroutput>*this</computeroutput>. </purpose></copy-assignment>
  2972. <destructor><purpose>Destroys the <classname alt="boost::compute::mersenne_twister_engine">mersenne_twister_engine</classname> object. </purpose></destructor>
  2973. <method-group name="private member functions">
  2974. </method-group>
  2975. </class><typedef name="mt19937"><type><classname>mersenne_twister_engine</classname>&lt; uint_ &gt;</type></typedef>
  2976. </namespace>
  2977. </namespace>
  2978. </header>
  2979. <header name="boost/compute/random/normal_distribution.hpp">
  2980. <namespace name="boost">
  2981. <namespace name="compute">
  2982. <class name="normal_distribution"><template>
  2983. <template-type-parameter name="RealType"><default>float</default></template-type-parameter>
  2984. </template><purpose>Produces random, normally-distributed floating-point numbers. </purpose><description><para>The following example shows how to setup a normal distribution to produce random <computeroutput>float</computeroutput> values centered at <computeroutput>5</computeroutput>:</para><para><programlisting language="c++"/> <para><emphasis role="bold">See Also:</emphasis><para>default_random_engine, <classname alt="boost::compute::uniform_real_distribution">uniform_real_distribution</classname> </para>
  2985. </para>
  2986. </para></description><typedef name="result_type"><type>RealType</type></typedef>
  2987. <method-group name="public member functions">
  2988. <method name="mean" cv="const"><type>result_type</type><purpose>Returns the mean value of the distribution. </purpose></method>
  2989. <method name="stddev" cv="const"><type>result_type</type><purpose>Returns the standard-deviation of the distribution. </purpose></method>
  2990. <method name="BOOST_PREVENT_MACRO_SUBSTITUTION" cv="const"><type>result_type min</type><purpose>Returns the minimum value of the distribution. </purpose></method>
  2991. <method name="BOOST_PREVENT_MACRO_SUBSTITUTION" cv="const"><type>result_type max</type><purpose>Returns the maximum value of the distribution. </purpose></method>
  2992. <method name="generate"><type>void</type><template>
  2993. <template-type-parameter name="OutputIterator"/>
  2994. <template-type-parameter name="Generator"/>
  2995. </template><parameter name="first"><paramtype>OutputIterator</paramtype></parameter><parameter name="last"><paramtype>OutputIterator</paramtype></parameter><parameter name="generator"><paramtype>Generator &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>Generates normally-distributed floating-point numbers and stores them to the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>). </para></description></method>
  2996. </method-group>
  2997. <constructor><parameter name="mean"><paramtype>RealType</paramtype><default>0.f</default></parameter><parameter name="stddev"><paramtype>RealType</paramtype><default>1.f</default></parameter><description><para>Creates a new normal distribution producing numbers with the given <computeroutput>mean</computeroutput> and <computeroutput>stddev</computeroutput>. </para></description></constructor>
  2998. <destructor><purpose>Destroys the normal distribution object. </purpose></destructor>
  2999. <method-group name="private member functions">
  3000. <method name="BOOST_STATIC_ASSERT_MSG"><type/><parameter name=""><paramtype>boost::is_floating_point&lt; RealType &gt;::value</paramtype></parameter><parameter name=""><paramtype>"Template argument must be a floating point type"</paramtype></parameter></method>
  3001. </method-group>
  3002. </class>
  3003. </namespace>
  3004. </namespace>
  3005. </header>
  3006. <header name="boost/compute/random/threefry_engine.hpp">
  3007. <namespace name="boost">
  3008. <namespace name="compute">
  3009. <class name="threefry_engine"><template>
  3010. <template-type-parameter name="T"><default>uint_</default></template-type-parameter>
  3011. </template><purpose>Threefry pseudorandom number generator. </purpose><typedef name="result_type"><type>T</type></typedef>
  3012. <data-member name="default_seed" specifiers="static"><type>const ulong_</type></data-member>
  3013. <method-group name="public member functions">
  3014. <method name="seed"><type>void</type><parameter name="value"><paramtype>ulong_</paramtype><description><para>seed value for the random-number generator </para></description></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype><description><para>command queue to perform the operation</para></description></parameter><description><para>Seeds the random number generator with <computeroutput>value</computeroutput>.</para><para>
  3015. If no seed value is provided, <computeroutput>default_seed</computeroutput> is used. </para></description></method>
  3016. <method name="seed"><type>void</type><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. </para></description></method>
  3017. <method name="generate"><type>void</type><template>
  3018. <template-type-parameter name="OutputIterator"/>
  3019. </template><parameter name="first"><paramtype>OutputIterator</paramtype></parameter><parameter name="last"><paramtype>OutputIterator</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><purpose>Generates random numbers and stores them to the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>). </purpose></method>
  3020. <method name="generate"><type>void</type><template>
  3021. <template-type-parameter name="OutputIterator"/>
  3022. <template-type-parameter name="Function"/>
  3023. </template><parameter name="first"><paramtype>OutputIterator</paramtype></parameter><parameter name="last"><paramtype>OutputIterator</paramtype></parameter><parameter name="op"><paramtype>Function</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>Generates random numbers, transforms them with <computeroutput>op</computeroutput>, and then stores them to the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>). </para></description></method>
  3024. <method name="discard"><type>void</type><parameter name="z"><paramtype>size_t</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><purpose>Generates <computeroutput>z</computeroutput> random numbers and discards them. </purpose></method>
  3025. </method-group>
  3026. <constructor specifiers="explicit"><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><parameter name="value"><paramtype>ulong_</paramtype><default>default_seed</default></parameter><purpose>Creates a new <classname alt="boost::compute::threefry_engine">threefry_engine</classname> and seeds it with <computeroutput>value</computeroutput>. </purpose></constructor>
  3027. <constructor><parameter name="other"><paramtype>const <classname>threefry_engine</classname>&lt; T &gt; &amp;</paramtype></parameter><purpose>Creates a new <classname alt="boost::compute::threefry_engine">threefry_engine</classname> object as a copy of <computeroutput>other</computeroutput>. </purpose></constructor>
  3028. <copy-assignment><type><classname>threefry_engine</classname>&lt; T &gt; &amp;</type><parameter name="other"><paramtype>const <classname>threefry_engine</classname>&lt; T &gt; &amp;</paramtype></parameter><purpose>Copies <computeroutput>other</computeroutput> to <computeroutput>*this</computeroutput>. </purpose></copy-assignment>
  3029. <destructor><purpose>Destroys the <classname alt="boost::compute::threefry_engine">threefry_engine</classname> object. </purpose></destructor>
  3030. <method-group name="private member functions">
  3031. <method name="load_program"><type>void</type></method>
  3032. </method-group>
  3033. </class>
  3034. </namespace>
  3035. </namespace>
  3036. </header>
  3037. <header name="boost/compute/random/uniform_int_distribution.hpp">
  3038. <namespace name="boost">
  3039. <namespace name="compute">
  3040. <class name="uniform_int_distribution"><template>
  3041. <template-type-parameter name="IntType"><default>uint_</default></template-type-parameter>
  3042. </template><purpose>Produces uniformily distributed random integers. </purpose><description><para>The following example shows how to setup a uniform int distribution to produce random integers 0 and 1.</para><para><programlisting language="c++"/></para></description><typedef name="result_type"><type>IntType</type></typedef>
  3043. <method-group name="public member functions">
  3044. <method name="a" cv="const"><type>result_type</type><purpose>Returns the minimum value of the distribution. </purpose></method>
  3045. <method name="b" cv="const"><type>result_type</type><purpose>Returns the maximum value of the distribution. </purpose></method>
  3046. <method name="generate"><type>void</type><template>
  3047. <template-type-parameter name="OutputIterator"/>
  3048. <template-type-parameter name="Generator"/>
  3049. </template><parameter name="first"><paramtype>OutputIterator</paramtype></parameter><parameter name="last"><paramtype>OutputIterator</paramtype></parameter><parameter name="generator"><paramtype>Generator &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>Generates uniformily distributed integers and stores them to the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>). </para></description></method>
  3050. </method-group>
  3051. <constructor specifiers="explicit"><parameter name="a"><paramtype>IntType</paramtype><default>0</default></parameter><parameter name="b"><paramtype>IntType</paramtype><default>(std::numeric_limits&lt; IntType &gt;::max)()</default></parameter><description><para>Creates a new uniform distribution producing numbers in the range [<computeroutput>a</computeroutput>, <computeroutput>b</computeroutput>]. </para></description></constructor>
  3052. <destructor><purpose>Destroys the <classname alt="boost::compute::uniform_int_distribution">uniform_int_distribution</classname> object. </purpose></destructor>
  3053. <method-group name="private member functions">
  3054. <method name="BOOST_STATIC_ASSERT_MSG"><type/><parameter name=""><paramtype>boost::is_integral&lt; IntType &gt;::value</paramtype></parameter><parameter name=""><paramtype>"Template argument must be integral"</paramtype></parameter></method>
  3055. </method-group>
  3056. </class>
  3057. </namespace>
  3058. </namespace>
  3059. </header>
  3060. <header name="boost/compute/random/uniform_real_distribution.hpp">
  3061. <namespace name="boost">
  3062. <namespace name="compute">
  3063. <class name="uniform_real_distribution"><template>
  3064. <template-type-parameter name="RealType"><default>float</default></template-type-parameter>
  3065. </template><purpose>Produces uniformly distributed random floating-point numbers. </purpose><description><para>The following example shows how to setup a uniform real distribution to produce random <computeroutput>float</computeroutput> values between <computeroutput>1</computeroutput> and <computeroutput>100</computeroutput>.</para><para><programlisting language="c++"/> <para><emphasis role="bold">See Also:</emphasis><para>default_random_engine, <classname alt="boost::compute::normal_distribution">normal_distribution</classname> </para>
  3066. </para>
  3067. </para></description><typedef name="result_type"><type>RealType</type></typedef>
  3068. <method-group name="public member functions">
  3069. <method name="a" cv="const"><type>result_type</type><purpose>Returns the minimum value of the distribution. </purpose></method>
  3070. <method name="b" cv="const"><type>result_type</type><purpose>Returns the maximum value of the distribution. </purpose></method>
  3071. <method name="generate"><type>void</type><template>
  3072. <template-type-parameter name="OutputIterator"/>
  3073. <template-type-parameter name="Generator"/>
  3074. </template><parameter name="first"><paramtype>OutputIterator</paramtype></parameter><parameter name="last"><paramtype>OutputIterator</paramtype></parameter><parameter name="generator"><paramtype>Generator &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><description><para>Generates uniformly distributed floating-point numbers and stores them to the range [<computeroutput>first</computeroutput>, <computeroutput>last</computeroutput>). </para></description></method>
  3075. </method-group>
  3076. <constructor><parameter name="a"><paramtype>RealType</paramtype><default>0.f</default></parameter><parameter name="b"><paramtype>RealType</paramtype><default>1.f</default></parameter><description><para>Creates a new uniform distribution producing numbers in the range [<computeroutput>a</computeroutput>, <computeroutput>b</computeroutput>). Requires a &lt; b </para></description></constructor>
  3077. <destructor><purpose>Destroys the <classname alt="boost::compute::uniform_real_distribution">uniform_real_distribution</classname> object. </purpose></destructor>
  3078. <method-group name="private member functions">
  3079. <method name="BOOST_STATIC_ASSERT_MSG"><type/><parameter name=""><paramtype>boost::is_floating_point&lt; RealType &gt;::value</paramtype></parameter><parameter name=""><paramtype>"Template argument must be a floating point type"</paramtype></parameter></method>
  3080. </method-group>
  3081. </class>
  3082. </namespace>
  3083. </namespace>
  3084. </header>
  3085. <header name="boost/compute/type_traits/common_type.hpp">
  3086. <namespace name="boost">
  3087. </namespace>
  3088. </header>
  3089. <header name="boost/compute/type_traits/is_device_iterator.hpp">
  3090. <namespace name="boost">
  3091. <namespace name="compute">
  3092. <struct name="is_device_iterator"><template>
  3093. <template-type-parameter name="Iterator"/>
  3094. </template><inherit access="public">false_type</inherit><description><para>Meta-function returning <computeroutput>true</computeroutput> if <computeroutput>Iterator</computeroutput> is a device-iterator.</para><para>By default, this function returns false. Device iterator types (such as <classname alt="boost::compute::buffer_iterator">buffer_iterator</classname>) should specialize this trait and return <computeroutput>true</computeroutput>.</para><para>For example: <programlisting language="c++">is_device_iterator&lt;buffer_iterator&lt;int&gt;&gt;::value == true
  3095. is_device_iterator&lt;std::vector&lt;int&gt;::iterator&gt;::value == false
  3096. </programlisting> </para></description></struct>
  3097. </namespace>
  3098. </namespace>
  3099. </header>
  3100. <header name="boost/compute/type_traits/is_fundamental.hpp">
  3101. <namespace name="boost">
  3102. <namespace name="compute">
  3103. <struct name="is_fundamental"><template>
  3104. <template-type-parameter name="T"/>
  3105. </template><inherit access="public">false_type</inherit><description><para>Meta-function returning <computeroutput>true</computeroutput> if <computeroutput>T</computeroutput> is a fundamental (i.e. built-in) type.</para><para>For example, <programlisting language="c++">is_fundamental&lt;float&gt;::value == true
  3106. is_fundamental&lt;std::pair&lt;int, float&gt;&gt;::value == false
  3107. </programlisting> </para></description></struct>
  3108. </namespace>
  3109. </namespace>
  3110. </header>
  3111. <header name="boost/compute/type_traits/is_vector_type.hpp">
  3112. <namespace name="boost">
  3113. <namespace name="compute">
  3114. <struct name="is_vector_type"><template>
  3115. <template-type-parameter name="T"/>
  3116. </template><inherit access="public">boost::mpl::bool_&lt; vector_size&lt; T &gt;::value !=1 &gt;</inherit><description><para>Meta-function returning <computeroutput>true</computeroutput> if <computeroutput>T</computeroutput> is a vector type.</para><para>For example, <programlisting language="c++">is_vector_type&lt;int&gt;::value == false
  3117. is_vector_type&lt;float4_&gt;::value == true
  3118. </programlisting></para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::make_vector_type">make_vector_type</classname>, <classname alt="boost::compute::vector_size">vector_size</classname> </para>
  3119. </para>
  3120. </para></description></struct>
  3121. </namespace>
  3122. </namespace>
  3123. </header>
  3124. <header name="boost/compute/type_traits/make_vector_type.hpp">
  3125. <namespace name="boost">
  3126. <namespace name="compute">
  3127. <struct name="make_vector_type"><template>
  3128. <template-type-parameter name="Scalar"/>
  3129. <template-nontype-parameter name="Size"><type>size_t</type></template-nontype-parameter>
  3130. </template><description><para>Meta-function which returns a vector type for <computeroutput>Scalar</computeroutput> with <computeroutput>Size</computeroutput>.</para><para>For example, <programlisting language="c++">make_vector_type&lt;int, 2&gt;::type == int2_
  3131. make_vector_type&lt;float, 4&gt;::type == float4_
  3132. </programlisting></para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::is_vector_type">is_vector_type</classname> </para>
  3133. </para>
  3134. </para></description></struct>
  3135. </namespace>
  3136. </namespace>
  3137. </header>
  3138. <header name="boost/compute/type_traits/result_of.hpp">
  3139. <namespace name="boost">
  3140. <namespace name="compute">
  3141. <struct name="result_of"><template>
  3142. <template-type-parameter name="Signature"/>
  3143. </template><description><para>Returns the result of <computeroutput>Function</computeroutput> when called with <computeroutput>Args</computeroutput>.</para><para>For example, <programlisting language="c++">// int + int = int
  3144. result_of&lt;plus(int, int)&gt;::type == int
  3145. </programlisting> </para></description><typedef name="type"><type>::boost::tr1_result_of&lt; Signature &gt;::type</type></typedef>
  3146. </struct>
  3147. </namespace>
  3148. </namespace>
  3149. </header>
  3150. <header name="boost/compute/type_traits/scalar_type.hpp">
  3151. <namespace name="boost">
  3152. <namespace name="compute">
  3153. <struct name="scalar_type"><template>
  3154. <template-type-parameter name="Vector"/>
  3155. </template><description><para>Meta-function returning the scalar type for a vector type.</para><para>For example, <programlisting language="c++">scalar_type&lt;float4_&gt;::type == float
  3156. </programlisting> </para></description></struct>
  3157. </namespace>
  3158. </namespace>
  3159. </header>
  3160. <header name="boost/compute/type_traits/type_definition.hpp">
  3161. <namespace name="boost">
  3162. <namespace name="compute">
  3163. <function name="type_definition"><type>std::string</type><template>
  3164. <template-type-parameter name="T"/>
  3165. </template><description><para>Returns the OpenCL type definition for <computeroutput>T</computeroutput>.</para><para>
  3166. <para><emphasis role="bold">See Also:</emphasis><para>type_name&lt;T&gt;() </para>
  3167. </para>
  3168. </para></description><returns><para>a string containing the type definition for <computeroutput>T</computeroutput> </para>
  3169. </returns></function>
  3170. </namespace>
  3171. </namespace>
  3172. </header>
  3173. <header name="boost/compute/type_traits/type_name.hpp">
  3174. <namespace name="boost">
  3175. <namespace name="compute">
  3176. <function name="type_name"><type>const char *</type><template>
  3177. <template-type-parameter name="T"/>
  3178. </template><description><para>Returns the OpenCL type name for the type <computeroutput>T</computeroutput> as a string.</para><para>
  3179. For example: <programlisting language="c++">type_name&lt;float&gt;() == "float"
  3180. type_name&lt;float4_&gt;() == "float4"
  3181. </programlisting></para><para><para><emphasis role="bold">See Also:</emphasis><para>type_definition&lt;T&gt;() </para>
  3182. </para>
  3183. </para></description><returns><para>a string containing the type name for <computeroutput>T</computeroutput> </para>
  3184. </returns></function>
  3185. </namespace>
  3186. </namespace>
  3187. <macro name="BOOST_COMPUTE_TYPE_NAME" kind="functionlike"><macro-parameter name="type"/><macro-parameter name="name"/><description><para>Registers the OpenCL type for the C++ <computeroutput>type</computeroutput> to <computeroutput>name</computeroutput>.</para><para>For example, the following will allow Eigen's <computeroutput>Vector2f</computeroutput> type to be used with Boost.Compute algorithms and containers as the built-in <computeroutput>float2</computeroutput> type. <programlisting language="c++">BOOST_COMPUTE_TYPE_NAME(Eigen::Vector2f, float2)
  3188. </programlisting></para><para>This macro should be invoked in the global namespace.</para><para><para><emphasis role="bold">See Also:</emphasis><para>type_name() </para>
  3189. </para>
  3190. </para></description></macro>
  3191. </header>
  3192. <header name="boost/compute/type_traits/vector_size.hpp">
  3193. <namespace name="boost">
  3194. <namespace name="compute">
  3195. <struct name="vector_size"><template>
  3196. <template-type-parameter name="T"/>
  3197. </template><description><para>Meta-function returning the size (number of components) of a vector type <computeroutput>T</computeroutput>. For scalar types this function returns <computeroutput>1</computeroutput>.</para><para>For example, <programlisting language="c++">vector_size&lt;float&gt;::value == 1
  3198. vector_size&lt;float4_&gt;::value == 4
  3199. </programlisting> </para></description><method-group name="public member functions">
  3200. </method-group>
  3201. </struct>
  3202. </namespace>
  3203. </namespace>
  3204. </header>
  3205. <header name="boost/compute/utility/dim.hpp">
  3206. <namespace name="boost">
  3207. <namespace name="compute">
  3208. <function name="dim"><type><classname>extents</classname>&lt; sizeof...(Args)&gt;</type><template>
  3209. <template-nontype-parameter name="Args"><type>class...</type></template-nontype-parameter>
  3210. </template><parameter name="args"><paramtype>Args...</paramtype></parameter><description><para>The variadic <computeroutput>dim()</computeroutput> function provides a concise syntax for creating <classname alt="boost::compute::extents">extents</classname> objects.</para><para>For example, <programlisting language="c++">extents&lt;2&gt; region = dim(640, 480); // region == (640, 480)
  3211. </programlisting></para><para><para><emphasis role="bold">See Also:</emphasis><para><classname alt="boost::compute::extents">extents&lt;N&gt;</classname> </para>
  3212. </para>
  3213. </para></description></function>
  3214. </namespace>
  3215. </namespace>
  3216. </header>
  3217. <header name="boost/compute/utility/extents.hpp">
  3218. <namespace name="boost">
  3219. <namespace name="compute">
  3220. <class name="extents"><template>
  3221. <template-nontype-parameter name="N"><type>size_t</type></template-nontype-parameter>
  3222. </template><description><para>The extents class contains an array of n-dimensional extents.</para><para><para><emphasis role="bold">See Also:</emphasis><para>dim() </para>
  3223. </para>
  3224. </para></description><typedef name="size_type"><type>size_t</type></typedef>
  3225. <typedef name="array_type"><type>boost::array&lt; size_t, N &gt;</type></typedef>
  3226. <typedef name="iterator"><type>array_type::iterator</type></typedef>
  3227. <typedef name="const_iterator"><type>array_type::const_iterator</type></typedef>
  3228. <data-member name="static_size" specifiers="static"><type>const size_type</type></data-member>
  3229. <method-group name="public member functions">
  3230. <method name="size" cv="const"><type>size_type</type><purpose>Returns the size (i.e. dimensionality) of the extents array. </purpose></method>
  3231. <method name="linear" cv="const"><type>size_type</type><description><para>Returns the linear size of the extents. This is equivalent to the product of each extent in each dimension. </para></description></method>
  3232. <method name="data"><type>size_t *</type><description><para>Returns a pointer to the extents data array.</para><para>This is useful for passing the extents data to OpenCL APIs which expect an array of <computeroutput>size_t</computeroutput>. </para></description></method>
  3233. <method name="data" cv="const"><type>const size_t *</type><description><para>This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. </para></description></method>
  3234. <method name="begin"><type>iterator</type></method>
  3235. <method name="begin" cv="const"><type>const_iterator</type></method>
  3236. <method name="cbegin" cv="const"><type>const_iterator</type></method>
  3237. <method name="end"><type>iterator</type></method>
  3238. <method name="end" cv="const"><type>const_iterator</type></method>
  3239. <method name="cend" cv="const"><type>const_iterator</type></method>
  3240. <method name="operator[]"><type>size_t &amp;</type><parameter name="index"><paramtype>size_t</paramtype></parameter><purpose>Returns a reference to the extent at <computeroutput>index</computeroutput>. </purpose></method>
  3241. <method name="operator[]" cv="const"><type>const size_t &amp;</type><parameter name="index"><paramtype>size_t</paramtype></parameter><description><para>This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. </para></description></method>
  3242. <method name="operator==" cv="const"><type>bool</type><parameter name="other"><paramtype>const <classname>extents</classname> &amp;</paramtype></parameter><purpose>Returns <computeroutput>true</computeroutput> if the extents in <computeroutput>*this</computeroutput> are the same as <computeroutput>other</computeroutput>. </purpose></method>
  3243. <method name="operator!=" cv="const"><type>bool</type><parameter name="other"><paramtype>const <classname>extents</classname> &amp;</paramtype></parameter><purpose>Returns <computeroutput>true</computeroutput> if the extents in <computeroutput>*this</computeroutput> are not the same as <computeroutput>other</computeroutput>. </purpose></method>
  3244. </method-group>
  3245. <constructor><description><para>Creates an extents object with each component set to zero.</para><para>For example: <programlisting language="c++">extents&lt;3&gt; exts(); // (0, 0, 0)
  3246. </programlisting> </para></description></constructor>
  3247. <constructor specifiers="explicit"><parameter name="value"><paramtype>size_t</paramtype></parameter><description><para>Creates an extents object with each component set to <computeroutput>value</computeroutput>.</para><para>For example: <programlisting language="c++">extents&lt;3&gt; exts(1); // (1, 1, 1)
  3248. </programlisting> </para></description></constructor>
  3249. <constructor><parameter name="values"><paramtype>std::initializer_list&lt; size_t &gt;</paramtype></parameter><purpose>Creates an extents object with <computeroutput>values</computeroutput>. </purpose></constructor>
  3250. </class>
  3251. </namespace>
  3252. </namespace>
  3253. </header>
  3254. <header name="boost/compute/utility/invoke.hpp">
  3255. <namespace name="boost">
  3256. <namespace name="compute">
  3257. <function name="invoke"><type><classname>result_of</classname>&lt; Function(Args...)&gt;::type</type><template>
  3258. <template-type-parameter name="Function"/>
  3259. <template-nontype-parameter name="Args"><type>class...</type></template-nontype-parameter>
  3260. </template><parameter name="function"><paramtype>const Function &amp;</paramtype></parameter><parameter name="queue"><paramtype>command_queue &amp;</paramtype></parameter><parameter name="args"><paramtype>const Args &amp;...</paramtype></parameter><description><para>Invokes <computeroutput>function</computeroutput> with <computeroutput>args</computeroutput> on <computeroutput>queue</computeroutput>.</para><para>For example, to invoke the builtin abs() function: <programlisting language="c++">int result = invoke(abs&lt;int&gt;(), queue, -10); // returns 10
  3261. </programlisting> </para></description></function>
  3262. </namespace>
  3263. </namespace>
  3264. <macro name="BOOST_COMPUTE_DETAIL_INVOKE_ARG" kind="functionlike"><macro-parameter name="z"/><macro-parameter name="n"/><macro-parameter name="unused"/></macro>
  3265. <macro name="BOOST_COMPUTE_DETAIL_INVOKE_ADD_ARG" kind="functionlike"><macro-parameter name="z"/><macro-parameter name="n"/><macro-parameter name="unused"/></macro>
  3266. <macro name="BOOST_COMPUTE_DETAIL_DEFINE_INVOKE" kind="functionlike"><macro-parameter name="z"/><macro-parameter name="n"/><macro-parameter name="unused"/></macro>
  3267. </header>
  3268. <header name="boost/compute/utility/program_cache.hpp">
  3269. <namespace name="boost">
  3270. <namespace name="compute">
  3271. <class name="program_cache"><inherit access="private">noncopyable</inherit><description><para>The <classname alt="boost::compute::program_cache">program_cache</classname> class stores program objects in a LRU cache.</para><para>This class can be used to help mitigate the overhead of OpenCL's run-time kernel compilation model. Commonly used programs can be stored persistently in the cache and only compiled once on their first use.</para><para>Program objects are stored and retreived based on a user-defined cache key along with the options used to build the program (if any).</para><para>For example, to insert a program into the cache: <programlisting language="c++">cache.insert("foo", foo_program);
  3272. </programlisting></para><para>And to retreive the program later: <programlisting language="c++">boost::optional&lt;program&gt; p = cache.get("foo");
  3273. if(p){
  3274. // program found in cache
  3275. }
  3276. </programlisting></para><para><para><emphasis role="bold">See Also:</emphasis><para>program </para>
  3277. </para>
  3278. </para></description><method-group name="public member functions">
  3279. <method name="size" cv="const"><type>size_t</type><purpose>Returns the number of program objects currently stored in the cache. </purpose></method>
  3280. <method name="capacity" cv="const"><type>size_t</type><purpose>Returns the total capacity of the cache. </purpose></method>
  3281. <method name="clear"><type>void</type><purpose>Clears the program cache. </purpose></method>
  3282. <method name="get"><type>boost::optional&lt; program &gt;</type><parameter name="key"><paramtype>const std::string &amp;</paramtype></parameter><description><para>Returns the program object with <computeroutput>key</computeroutput>. Returns a null optional if no program with <computeroutput>key</computeroutput> exists in the cache. </para></description></method>
  3283. <method name="get"><type>boost::optional&lt; program &gt;</type><parameter name="key"><paramtype>const std::string &amp;</paramtype></parameter><parameter name="options"><paramtype>const std::string &amp;</paramtype></parameter><description><para>Returns the program object with <computeroutput>key</computeroutput> and <computeroutput>options</computeroutput>. Returns a null optional if no program with <computeroutput>key</computeroutput> and <computeroutput>options</computeroutput> exists in the cache. </para></description></method>
  3284. <method name="insert"><type>void</type><parameter name="key"><paramtype>const std::string &amp;</paramtype></parameter><parameter name="program"><paramtype>const program &amp;</paramtype></parameter><purpose>Inserts <computeroutput>program</computeroutput> into the cache with <computeroutput>key</computeroutput>. </purpose></method>
  3285. <method name="insert"><type>void</type><parameter name="key"><paramtype>const std::string &amp;</paramtype></parameter><parameter name="options"><paramtype>const std::string &amp;</paramtype></parameter><parameter name="program"><paramtype>const program &amp;</paramtype></parameter><purpose>Inserts <computeroutput>program</computeroutput> into the cache with <computeroutput>key</computeroutput> and <computeroutput>options</computeroutput>. </purpose></method>
  3286. <method name="get_or_build"><type>program</type><parameter name="key"><paramtype>const std::string &amp;</paramtype></parameter><parameter name="options"><paramtype>const std::string &amp;</paramtype></parameter><parameter name="source"><paramtype>const std::string &amp;</paramtype></parameter><parameter name="context"><paramtype>const context &amp;</paramtype></parameter><description><para>Loads the program with <computeroutput>key</computeroutput> from the cache if it exists. Otherwise builds a new program with <computeroutput>source</computeroutput> and <computeroutput>options</computeroutput>, stores it in the cache, and returns it.</para><para>This is a convenience function to simplify the common pattern of attempting to load a program from the cache and, if not present, building the program from source and storing it in the cache.</para><para>Equivalent to: <programlisting language="c++">boost::optional&lt;program&gt; p = get(key, options);
  3287. if(!p){
  3288. p = program::create_with_source(source, context);
  3289. p-&gt;build(options);
  3290. insert(key, options, *p);
  3291. }
  3292. return *p;
  3293. </programlisting> </para></description></method>
  3294. </method-group>
  3295. <constructor><parameter name="capacity"><paramtype>size_t</paramtype></parameter><description><para>Creates a new program cache with space for <computeroutput>capacity</computeroutput> number of program objects. </para></description></constructor>
  3296. <destructor><purpose>Destroys the program cache. </purpose></destructor>
  3297. <method-group name="public static functions">
  3298. <method name="get_global_cache" specifiers="static"><type>boost::shared_ptr&lt; <classname>program_cache</classname> &gt;</type><parameter name="context"><paramtype>const context &amp;</paramtype></parameter><description><para>Returns the global program cache for <computeroutput>context</computeroutput>.</para><para>This global cache is used internally by Boost.Compute to store compiled program objects used by its algorithms. All Boost.Compute programs are stored with a cache key beginning with <computeroutput>"__boost"</computeroutput>. User programs should avoid using the same prefix in order to prevent collisions. </para></description></method>
  3299. </method-group>
  3300. </class>
  3301. </namespace>
  3302. </namespace>
  3303. </header>
  3304. <header name="boost/compute/utility/source.hpp">
  3305. <macro name="BOOST_COMPUTE_STRINGIZE_SOURCE" kind="functionlike"><macro-parameter name="source"/><description><para>Stringizes OpenCL source code.</para><para>For example, to create a simple kernel which squares each input value: <programlisting language="c++">const char source[] = BOOST_COMPUTE_STRINGIZE_SOURCE(
  3306. __kernel void square(const float *input, float *output)
  3307. {
  3308. const uint i = get_global_id(0);
  3309. const float x = input[i];
  3310. output[i] = x * x;
  3311. }
  3312. );
  3313. // create and build square program
  3314. program square_program = program::build_with_source(source, context);
  3315. // create square kernel
  3316. kernel square_kernel(square_program, "square");
  3317. </programlisting> </para></description></macro>
  3318. </header>
  3319. <header name="boost/compute/utility/wait_list.hpp">
  3320. <namespace name="boost">
  3321. <namespace name="compute">
  3322. <class name="wait_list"><purpose>Stores a list of events. </purpose><description><para>The <classname alt="boost::compute::wait_list">wait_list</classname> class stores a set of event objects and can be used to specify dependencies for OpenCL operations or to wait on the host until all of the events have completed.</para><para>This class also provides convenience functions for interacting with OpenCL APIs which typically accept event dependencies as a <computeroutput>cl_event*</computeroutput> pointer and a <computeroutput>cl_uint</computeroutput> size. For example: <programlisting language="c++">wait_list events = ...;
  3323. clEnqueueNDRangeKernel(..., events.get_event_ptr(), events.size(), ...);
  3324. </programlisting></para><para><para><emphasis role="bold">See Also:</emphasis><para>event, <classname alt="boost::compute::future">future&lt;T&gt;</classname> </para>
  3325. </para>
  3326. </para></description><typedef name="iterator"><type>std::vector&lt; event &gt;::iterator</type></typedef>
  3327. <typedef name="const_iterator"><type>std::vector&lt; event &gt;::const_iterator</type></typedef>
  3328. <method-group name="public member functions">
  3329. <method name="empty" cv="const"><type>bool</type><purpose>Returns <computeroutput>true</computeroutput> if the wait-list is empty. </purpose></method>
  3330. <method name="size" cv="const"><type>uint_</type><purpose>Returns the number of events in the wait-list. </purpose></method>
  3331. <method name="clear"><type>void</type><purpose>Removes all of the events from the wait-list. </purpose></method>
  3332. <method name="get_event_ptr" cv="const"><type>const cl_event *</type><description><para>Returns a cl_event pointer to the first event in the wait-list. Returns <computeroutput>0</computeroutput> if the wait-list is empty.</para><para>This can be used to pass the wait-list to OpenCL functions which expect a <computeroutput>cl_event</computeroutput> pointer to refer to a list of events. </para></description></method>
  3333. <method name="reserve"><type>void</type><parameter name="new_capacity"><paramtype>size_t</paramtype></parameter><purpose>Reserves a minimum length of storage for the wait list object. </purpose></method>
  3334. <method name="insert"><type>void</type><parameter name="event"><paramtype>const event &amp;</paramtype></parameter><purpose>Inserts <computeroutput>event</computeroutput> into the wait-list. </purpose></method>
  3335. <method name="insert"><type>void</type><template>
  3336. <template-type-parameter name="T"/>
  3337. </template><parameter name="future"><paramtype>const <classname>future</classname>&lt; T &gt; &amp;</paramtype></parameter><purpose>Inserts the event from <computeroutput>future</computeroutput> into the wait-list. </purpose></method>
  3338. <method name="wait" cv="const"><type>void</type><description><para>Blocks until all of the events in the wait-list have completed.</para><para>Does nothing if the wait-list is empty. </para></description></method>
  3339. <method name="operator[]" cv="const"><type>const event &amp;</type><parameter name="pos"><paramtype>size_t</paramtype></parameter><purpose>Returns a reference to the event at specified location <computeroutput>pos</computeroutput>. </purpose></method>
  3340. <method name="operator[]"><type>event &amp;</type><parameter name="pos"><paramtype>size_t</paramtype></parameter><purpose>Returns a reference to the event at specified location <computeroutput>pos</computeroutput>. </purpose></method>
  3341. <method name="begin"><type>iterator</type><purpose>Returns an iterator to the first element of the wait-list. </purpose></method>
  3342. <method name="begin" cv="const"><type>const_iterator</type><purpose>Returns an iterator to the first element of the wait-list. </purpose></method>
  3343. <method name="cbegin" cv="const"><type>const_iterator</type><purpose>Returns an iterator to the first element of the wait-list. </purpose></method>
  3344. <method name="end"><type>iterator</type><purpose>Returns an iterator to the element following the last element of the wait-list. </purpose></method>
  3345. <method name="end" cv="const"><type>const_iterator</type><purpose>Returns an iterator to the element following the last element of the wait-list. </purpose></method>
  3346. <method name="cend" cv="const"><type>const_iterator</type><purpose>Returns an iterator to the element following the last element of the wait-list. </purpose></method>
  3347. </method-group>
  3348. <constructor><purpose>Creates an empty wait-list. </purpose></constructor>
  3349. <constructor><parameter name="event"><paramtype>const event &amp;</paramtype></parameter><purpose>Creates a wait-list containing <computeroutput>event</computeroutput>. </purpose></constructor>
  3350. <constructor><parameter name="other"><paramtype>const <classname>wait_list</classname> &amp;</paramtype></parameter><purpose>Creates a new wait-list as a copy of <computeroutput>other</computeroutput>. </purpose></constructor>
  3351. <constructor><parameter name="events"><paramtype>std::initializer_list&lt; event &gt;</paramtype></parameter><purpose>Creates a wait-list from <computeroutput>events</computeroutput>. </purpose></constructor>
  3352. <copy-assignment><type><classname>wait_list</classname> &amp;</type><parameter name="other"><paramtype>const <classname>wait_list</classname> &amp;</paramtype></parameter><purpose>Copies the events in the wait-list from <computeroutput>other</computeroutput>. </purpose></copy-assignment>
  3353. <constructor><parameter name="other"><paramtype><classname>wait_list</classname> &amp;&amp;</paramtype></parameter><purpose>Move-constructs a new wait list object from <computeroutput>other</computeroutput>. </purpose></constructor>
  3354. <copy-assignment><type><classname>wait_list</classname> &amp;</type><parameter name="other"><paramtype><classname>wait_list</classname> &amp;&amp;</paramtype></parameter><purpose>Move-assigns the wait list from <computeroutput>other</computeroutput> to <computeroutput>*this</computeroutput>. </purpose></copy-assignment>
  3355. <destructor><purpose>Destroys the wait-list. </purpose></destructor>
  3356. </class>
  3357. </namespace>
  3358. </namespace>
  3359. </header>
  3360. </library-reference>