levovix
/
Nim
miroir de https://github.com/nim-lang/Nim


			
				
					
						
						
							1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450
							<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--  This file is generated by Nim. -->
<html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en" lang="en" data-theme="auto">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>std/macros</title>

<!-- Google fonts -->
<link href='https://fonts.googleapis.com/css?family=Lato:400,600,900' rel='stylesheet' type='text/css'/>
<link href='https://fonts.googleapis.com/css?family=Source+Code+Pro:400,500,600' rel='stylesheet' type='text/css'/>

<!-- Favicon -->
<link rel="shortcut icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAUAAAAF////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAIAAABbAAAAlQAAAKIAAACbAAAAmwAAAKIAAACVAAAAWwAAAAL///8A////AP///wD///8A////AAAAABQAAADAAAAAYwAAAA3///8A////AP///wD///8AAAAADQAAAGMAAADAAAAAFP///wD///8A////AP///wAAAACdAAAAOv///wD///8A////AP///wD///8A////AP///wD///8AAAAAOgAAAJ3///8A////AP///wAAAAAnAAAAcP///wAAAAAoAAAASv///wD///8A////AP///wAAAABKAAAAKP///wAAAABwAAAAJ////wD///8AAAAAgQAAABwAAACIAAAAkAAAAJMAAACtAAAAFQAAABUAAACtAAAAkwAAAJAAAACIAAAAHAAAAIH///8A////AAAAAKQAAACrAAAAaP///wD///8AAAAARQAAANIAAADSAAAARf///wD///8AAAAAaAAAAKsAAACk////AAAAADMAAACcAAAAnQAAABj///8A////AP///wAAAAAYAAAAGP///wD///8A////AAAAABgAAACdAAAAnAAAADMAAAB1AAAAwwAAAP8AAADpAAAAsQAAAE4AAAAb////AP///wAAAAAbAAAATgAAALEAAADpAAAA/wAAAMMAAAB1AAAAtwAAAOkAAAD/AAAA/wAAAP8AAADvAAAA3gAAAN4AAADeAAAA3gAAAO8AAAD/AAAA/wAAAP8AAADpAAAAtwAAAGUAAAA/AAAA3wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAADfAAAAPwAAAGX///8A////AAAAAEgAAADtAAAAvwAAAL0AAADGAAAA7wAAAO8AAADGAAAAvQAAAL8AAADtAAAASP///wD///8A////AP///wD///8AAAAAO////wD///8A////AAAAAIcAAACH////AP///wD///8AAAAAO////wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A//8AAP//AAD4HwAA7/cAAN/7AAD//wAAoYUAAJ55AACf+QAAh+EAAAAAAADAAwAA4AcAAP5/AAD//wAA//8AAA=="/>
<link rel="icon" type="image/png" sizes="32x32" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAA3XAAAN1wFCKJt4AAAAB3RJTUUH4QQQEwksSS9ZWwAAAk1JREFUWMPtll2ITVEUx39nn/O7Y5qR8f05wtCUUr6ZIS++8pEnkZInPImneaCQ5METNdOkeFBKUhMPRIkHKfEuUZSUlGlKPN2TrgfncpvmnntnmlEyq1Z7t89/rf9a6+y99oZxGZf/XeIq61EdtgKXgdXA0xrYAvBjOIF1AI9zvjcC74BSpndrJPkBWDScTF8Aa4E3wDlgHbASaANmVqlcCnwHvgDvgVfAJ+AikAAvgfVZwLnSVZHZaOuKoQi3ZOMi4NkYkpe1p4J7A8BpYAD49hfIy/oqG0+hLomiKP2L5L+1ubn5115S+3OAn4EnwBlgMzCjyt6ZAnQCJ4A7wOs88iRJHvw50HoujuPBoCKwHWiosy8MdfZnAdcHk8dxXFJ3VQbQlCTJvRBCGdRbD4M6uc5glpY3eAihpN5S5w12diSEcCCEcKUO4ljdr15T76ur1FDDLIQQ3qv71EdDOe3Kxj3leRXyk+pxdWnFWod6Wt2bY3de3aSuUHcPBVimHs7mK9WrmeOF6lR1o9qnzskh2ar2qm1qizpfXaPeVGdlmGN5pb09qMxz1Xb1kLqgzn1RyH7JUXW52lr5e/Kqi9qpto7V1atuUzfnARrV7jEib1T76gG2qxdGmXyiekkt1GswPTtek0aBfJp6YySGBfWg2tPQ0FAYgf1stUfdmdcjarbYJEniKIq6gY/Aw+zWHAC+p2labGpqiorFYgGYCEzN7oQdQClN07O1/EfDyGgC0ALMBdYAi4FyK+4H3gLPsxfR1zRNi+NP7nH5J+QntnXe5B5mpfQAAAAASUVORK5CYII=">

<!-- CSS -->
<link rel="stylesheet" type="text/css" href="nimdoc.out.css?v=2.3.1">

<!-- JS -->
<script type="text/javascript" src="dochack.js?v=2.3.1"></script>
</head>
<body>
  <div class="document" id="documentId">
    <div class="container">
      <h1 class="title">std/macros</h1>
      <div class="row">
  <div class="three columns">
    <div class="theme-select-wrapper">
      <label for="theme-select">Theme:&nbsp;</label>
      <select id="theme-select" onchange="setTheme(this.value)">
        <option value="auto">🌗 Match OS</option>
        <option value="dark">🌑 Dark</option>
        <option value="light">🌕 Light</option>
      </select>
    </div>
    <div id="global-links">
      <ul class="simple-boot">
        <li><a href="manual.html">Manual</a></li>
        <li><a href="lib.html">Standard library</a></li>
        <li> <a id="indexLink" href="theindex.html">Index</a></li>
        <li><a href="compiler/theindex.html">Compiler docs</a></li>
        <li><a href="https://nim-lang.github.io/fusion/theindex.html">Fusion docs</a></li>
        <li><a href="https://nim-lang.github.io/Nim/">devel</a>, <a href="https://nim-lang.org/documentation.html">stable</a></li>
      </ul>
    </div>
    <div id="searchInputDiv">
      Search: <input type="search" id="searchInput"
        oninput="search()" />
    </div>
    
    <ul class="simple simple-toc" id="toc-list">
  <li><a class="reference" id="the-ast-in-nim_toc" href="#the-ast-in-nim">The AST in Nim</a></li>
<li><a class="reference" id="leaf-nodesslashatoms_toc" href="#leaf-nodesslashatoms">Leaf nodes/Atoms</a></li>
<li><a class="reference" id="callsslashexpressions_toc" href="#callsslashexpressions">Calls/expressions</a></li>
<ul class="simple"><li><a class="reference" id="callsslashexpressions-command-call_toc" href="#callsslashexpressions-command-call">Command call</a></li>
<li><a class="reference" id="callsslashexpressions-call-with_toc" href="#callsslashexpressions-call-with">Call with <tt class="docutils literal"><span class="pre">()</span></tt></a></li>
<li><a class="reference" id="callsslashexpressions-infix-operator-call_toc" href="#callsslashexpressions-infix-operator-call">Infix operator call</a></li>
<li><a class="reference" id="callsslashexpressions-prefix-operator-call_toc" href="#callsslashexpressions-prefix-operator-call">Prefix operator call</a></li>
<li><a class="reference" id="callsslashexpressions-postfix-operator-call_toc" href="#callsslashexpressions-postfix-operator-call">Postfix operator call</a></li>
<li><a class="reference" id="callsslashexpressions-call-with-named-arguments_toc" href="#callsslashexpressions-call-with-named-arguments">Call with named arguments</a></li>
<li><a class="reference" id="callsslashexpressions-call-with-raw-string-literal_toc" href="#callsslashexpressions-call-with-raw-string-literal">Call with raw string literal</a></li>
<li><a class="reference" id="callsslashexpressions-dereference-operator_toc" href="#callsslashexpressions-dereference-operator">Dereference operator <tt class="docutils literal"><span class="pre">[]</span></tt></a></li>
<li><a class="reference" id="callsslashexpressions-addr-operator_toc" href="#callsslashexpressions-addr-operator">Addr operator</a></li>
<li><a class="reference" id="callsslashexpressions-cast-operator_toc" href="#callsslashexpressions-cast-operator">Cast operator</a></li>
<li><a class="reference" id="callsslashexpressions-object-access-operator-dot_toc" href="#callsslashexpressions-object-access-operator-dot">Object access operator <tt class="docutils literal"><span class="pre">.</span></tt></a></li>
<li><a class="reference" id="callsslashexpressions-array-access-operator_toc" href="#callsslashexpressions-array-access-operator">Array access operator <tt class="docutils literal"><span class="pre">[]</span></tt></a></li>
<li><a class="reference" id="callsslashexpressions-parentheses_toc" href="#callsslashexpressions-parentheses">Parentheses</a></li>
<li><a class="reference" id="callsslashexpressions-tuple-constructors_toc" href="#callsslashexpressions-tuple-constructors">Tuple Constructors</a></li>
<li><a class="reference" id="callsslashexpressions-curly-braces_toc" href="#callsslashexpressions-curly-braces">Curly braces</a></li>
<li><a class="reference" id="callsslashexpressions-brackets_toc" href="#callsslashexpressions-brackets">Brackets</a></li>
<li><a class="reference" id="callsslashexpressions-ranges_toc" href="#callsslashexpressions-ranges">Ranges</a></li>
<li><a class="reference" id="callsslashexpressions-if-expression_toc" href="#callsslashexpressions-if-expression">If expression</a></li>
<li><a class="reference" id="callsslashexpressions-documentation-comments_toc" href="#callsslashexpressions-documentation-comments">Documentation Comments</a></li>
<li><a class="reference" id="callsslashexpressions-pragmas_toc" href="#callsslashexpressions-pragmas">Pragmas</a></li>
</ul><li><a class="reference" id="statements_toc" href="#statements">Statements</a></li>
<ul class="simple"><li><a class="reference" id="statements-if-statement_toc" href="#statements-if-statement">If statement</a></li>
<li><a class="reference" id="statements-when-statement_toc" href="#statements-when-statement">When statement</a></li>
<li><a class="reference" id="statements-assignment_toc" href="#statements-assignment">Assignment</a></li>
<li><a class="reference" id="statements-statement-list_toc" href="#statements-statement-list">Statement list</a></li>
<li><a class="reference" id="statements-case-statement_toc" href="#statements-case-statement">Case statement</a></li>
<li><a class="reference" id="statements-while-statement_toc" href="#statements-while-statement">While statement</a></li>
<li><a class="reference" id="statements-for-statement_toc" href="#statements-for-statement">For statement</a></li>
<li><a class="reference" id="statements-try-statement_toc" href="#statements-try-statement">Try statement</a></li>
<li><a class="reference" id="statements-return-statement_toc" href="#statements-return-statement">Return statement</a></li>
<li><a class="reference" id="statements-yield-statement_toc" href="#statements-yield-statement">Yield statement</a></li>
<li><a class="reference" id="statements-discard-statement_toc" href="#statements-discard-statement">Discard statement</a></li>
<li><a class="reference" id="statements-continue-statement_toc" href="#statements-continue-statement">Continue statement</a></li>
<li><a class="reference" id="statements-break-statement_toc" href="#statements-break-statement">Break statement</a></li>
<li><a class="reference" id="statements-block-statement_toc" href="#statements-block-statement">Block statement</a></li>
<li><a class="reference" id="statements-asm-statement_toc" href="#statements-asm-statement">Asm statement</a></li>
<li><a class="reference" id="statements-import-section_toc" href="#statements-import-section">Import section</a></li>
<li><a class="reference" id="statements-from-statement_toc" href="#statements-from-statement">From statement</a></li>
<li><a class="reference" id="statements-export-statement_toc" href="#statements-export-statement">Export statement</a></li>
<li><a class="reference" id="statements-include-statement_toc" href="#statements-include-statement">Include statement</a></li>
<li><a class="reference" id="statements-var-section_toc" href="#statements-var-section">Var section</a></li>
<li><a class="reference" id="statements-let-section_toc" href="#statements-let-section">Let section</a></li>
<li><a class="reference" id="statements-const-section_toc" href="#statements-const-section">Const section</a></li>
<li><a class="reference" id="statements-type-section_toc" href="#statements-type-section">Type section</a></li>
<li><a class="reference" id="statements-mixin-statement_toc" href="#statements-mixin-statement">Mixin statement</a></li>
<li><a class="reference" id="statements-bind-statement_toc" href="#statements-bind-statement">Bind statement</a></li>
<li><a class="reference" id="statements-procedure-declaration_toc" href="#statements-procedure-declaration">Procedure declaration</a></li>
<li><a class="reference" id="statements-iterator-declaration_toc" href="#statements-iterator-declaration">Iterator declaration</a></li>
<li><a class="reference" id="statements-converter-declaration_toc" href="#statements-converter-declaration">Converter declaration</a></li>
<li><a class="reference" id="statements-template-declaration_toc" href="#statements-template-declaration">Template declaration</a></li>
<li><a class="reference" id="statements-macro-declaration_toc" href="#statements-macro-declaration">Macro declaration</a></li>
<li><a class="reference" id="statements-hidden-standard-conversion_toc" href="#statements-hidden-standard-conversion">Hidden Standard Conversion</a></li>
</ul><li><a class="reference" id="special-node-kinds_toc" href="#special-node-kinds">Special node kinds</a></li>
<li>
  <a class="reference reference-toplevel" href="#6" id="56">Imports</a>
</li>
<li>
  <details open>
    <summary><a class="reference reference-toplevel" href="#7" id="57">Types</a></summary>
    <ul class="simple simple-toc-section">
      <li><a class="reference" href="#BindSymRule" title="BindSymRule = enum
  brClosed,                 ## only the symbols in current scope are bound
  brOpen,                   ## open for overloaded symbols, but may be a single
                             ## symbol if not ambiguous (the rules match that of
                             ## binding in generics)
  brForceOpen                ## same as brOpen, but it will always be open even
                             ## if not ambiguous (this cannot be achieved with
                             ## any other means in the language currently)">BindSymRule</a></li>
<li><a class="reference" href="#LineInfo" title="LineInfo = object
  filename*: string
  line*, column*: int">LineInfo</a></li>
<li><a class="reference" href="#NimIdent" title="NimIdent {.deprecated.} = object of RootObj">NimIdent</a></li>
<li><a class="reference" href="#NimNodeKind" title="NimNodeKind = enum
  nnkNone, nnkEmpty, nnkIdent, nnkSym, nnkType, nnkCharLit, nnkIntLit,
  nnkInt8Lit, nnkInt16Lit, nnkInt32Lit, nnkInt64Lit, nnkUIntLit, nnkUInt8Lit,
  nnkUInt16Lit, nnkUInt32Lit, nnkUInt64Lit, nnkFloatLit, nnkFloat32Lit,
  nnkFloat64Lit, nnkFloat128Lit, nnkStrLit, nnkRStrLit, nnkTripleStrLit,
  nnkNilLit, nnkComesFrom, nnkDotCall, nnkCommand, nnkCall, nnkCallStrLit,
  nnkInfix, nnkPrefix, nnkPostfix, nnkHiddenCallConv, nnkExprEqExpr,
  nnkExprColonExpr, nnkIdentDefs, nnkVarTuple, nnkPar, nnkObjConstr, nnkCurly,
  nnkCurlyExpr, nnkBracket, nnkBracketExpr, nnkPragmaExpr, nnkRange, nnkDotExpr,
  nnkCheckedFieldExpr, nnkDerefExpr, nnkIfExpr, nnkElifExpr, nnkElseExpr,
  nnkLambda, nnkDo, nnkAccQuoted, nnkTableConstr, nnkBind, nnkClosedSymChoice,
  nnkOpenSymChoice, nnkHiddenStdConv, nnkHiddenSubConv, nnkConv, nnkCast,
  nnkStaticExpr, nnkAddr, nnkHiddenAddr, nnkHiddenDeref, nnkObjDownConv,
  nnkObjUpConv, nnkChckRangeF, nnkChckRange64, nnkChckRange, nnkStringToCString,
  nnkCStringToString, nnkAsgn, nnkFastAsgn, nnkGenericParams, nnkFormalParams,
  nnkOfInherit, nnkImportAs, nnkProcDef, nnkMethodDef, nnkConverterDef,
  nnkMacroDef, nnkTemplateDef, nnkIteratorDef, nnkOfBranch, nnkElifBranch,
  nnkExceptBranch, nnkElse, nnkAsmStmt, nnkPragma, nnkPragmaBlock, nnkIfStmt,
  nnkWhenStmt, nnkForStmt, nnkParForStmt, nnkWhileStmt, nnkCaseStmt,
  nnkTypeSection, nnkVarSection, nnkLetSection, nnkConstSection, nnkConstDef,
  nnkTypeDef, nnkYieldStmt, nnkDefer, nnkTryStmt, nnkFinally, nnkRaiseStmt,
  nnkReturnStmt, nnkBreakStmt, nnkContinueStmt, nnkBlockStmt, nnkStaticStmt,
  nnkDiscardStmt, nnkStmtList, nnkImportStmt, nnkImportExceptStmt,
  nnkExportStmt, nnkExportExceptStmt, nnkFromStmt, nnkIncludeStmt, nnkBindStmt,
  nnkMixinStmt, nnkUsingStmt, nnkCommentStmt, nnkStmtListExpr, nnkBlockExpr,
  nnkStmtListType, nnkBlockType, nnkWith, nnkWithout, nnkTypeOfExpr,
  nnkObjectTy, nnkTupleTy, nnkTupleClassTy, nnkTypeClassTy, nnkStaticTy,
  nnkRecList, nnkRecCase, nnkRecWhen, nnkRefTy, nnkPtrTy, nnkVarTy, nnkConstTy,
  nnkOutTy, nnkDistinctTy, nnkProcTy, nnkIteratorTy, nnkSinkAsgn, nnkEnumTy,
  nnkEnumFieldDef, nnkArgList, nnkPattern, nnkHiddenTryStmt, nnkClosure,
  nnkGotoState, nnkState, nnkBreakState, nnkFuncDef, nnkTupleConstr, nnkError, ## erroneous AST node
  nnkModuleRef, nnkReplayAction, nnkNilRodNode, ## internal IC nodes
  nnkOpenSym">NimNodeKind</a></li>
<li><a class="reference" href="#NimNodeKinds" title="NimNodeKinds = set[NimNodeKind]">NimNodeKinds</a></li>
<li><a class="reference" href="#NimSym" title="NimSym {.deprecated.} = ref NimSymObj">NimSym</a></li>
<li><a class="reference" href="#NimSymKind" title="NimSymKind = enum
  nskUnknown, nskConditional, nskDynLib, nskParam, nskGenericParam, nskTemp,
  nskModule, nskType, nskVar, nskLet, nskConst, nskResult, nskProc, nskFunc,
  nskMethod, nskIterator, nskConverter, nskMacro, nskTemplate, nskField,
  nskEnumField, nskForVar, nskLabel, nskStub">NimSymKind</a></li>
<li><a class="reference" href="#NimTypeKind" title="NimTypeKind = enum
  ntyNone, ntyBool, ntyChar, ntyEmpty, ntyAlias, ntyNil, ntyExpr, ntyStmt,
  ntyTypeDesc, ntyGenericInvocation, ntyGenericBody, ntyGenericInst,
  ntyGenericParam, ntyDistinct, ntyEnum, ntyOrdinal, ntyArray, ntyObject,
  ntyTuple, ntySet, ntyRange, ntyPtr, ntyRef, ntyVar, ntySequence, ntyProc,
  ntyPointer, ntyOpenArray, ntyString, ntyCString, ntyForward, ntyInt, ntyInt8,
  ntyInt16, ntyInt32, ntyInt64, ntyFloat, ntyFloat32, ntyFloat64, ntyFloat128,
  ntyUInt, ntyUInt8, ntyUInt16, ntyUInt32, ntyUInt64, ntyUnused0, ntyUnused1,
  ntyUnused2, ntyVarargs, ntyUncheckedArray, ntyError, ntyBuiltinTypeClass,
  ntyUserTypeClass, ntyUserTypeClassInst, ntyCompositeTypeClass, ntyInferred,
  ntyAnd, ntyOr, ntyNot, ntyAnything, ntyStatic, ntyFromExpr, ntyOptDeprecated,
  ntyVoid">NimTypeKind</a></li>
<li><a class="reference" href="#TNimSymKinds" title="TNimSymKinds {.deprecated.} = set[NimSymKind]">TNimSymKinds</a></li>
<li><a class="reference" href="#TNimTypeKinds" title="TNimTypeKinds {.deprecated.} = set[NimTypeKind]">TNimTypeKinds</a></li>

    </ul>
  </details>
</li>
<li>
  <details open>
    <summary><a class="reference reference-toplevel" href="#10" id="60">Consts</a></summary>
    <ul class="simple simple-toc-section">
      <li><a class="reference" href="#AtomicNodes" title="AtomicNodes = {nnkNone..nnkNilLit}">AtomicNodes</a></li>
<li><a class="reference" href="#CallNodes" title="CallNodes = {nnkCall, nnkInfix, nnkPrefix, nnkPostfix, nnkCommand,
             nnkCallStrLit, nnkHiddenCallConv}">CallNodes</a></li>
<li><a class="reference" href="#nnkCallKinds" title="nnkCallKinds = {nnkCall, nnkInfix, nnkPrefix, nnkPostfix, nnkCommand,
                nnkCallStrLit, nnkHiddenCallConv}">nnkCallKinds</a></li>
<li><a class="reference" href="#nnkLiterals" title="nnkLiterals = {nnkCharLit..nnkNilLit}">nnkLiterals</a></li>
<li><a class="reference" href="#nnkMutableTy" title="nnkMutableTy {.deprecated.} = nnkOutTy">nnkMutableTy</a></li>
<li><a class="reference" href="#nnkSharedTy" title="nnkSharedTy {.deprecated.} = nnkSinkAsgn">nnkSharedTy</a></li>
<li><a class="reference" href="#RoutineNodes" title="RoutineNodes = {nnkProcDef, nnkFuncDef, nnkMethodDef, nnkDo, nnkLambda,
                nnkIteratorDef, nnkTemplateDef, nnkConverterDef, nnkMacroDef}">RoutineNodes</a></li>

    </ul>
  </details>
</li>
<li>
  <details open>
    <summary><a class="reference reference-toplevel" href="#12" id="62">Procs</a></summary>
    <ul class="simple simple-toc-section">
      <ul class="simple nested-toc-section">$
  <li><a class="reference" href="#%24%2CLineInfo" title="`$`(arg: LineInfo): string">`$`(arg: LineInfo): string</a></li>
<li><a class="reference" href="#%24%2CNimIdent" title="`$`(i: NimIdent): string">`$`(i: NimIdent): string</a></li>
<li><a class="reference" href="#%24%2CNimNode" title="`$`(node: NimNode): string">`$`(node: NimNode): string</a></li>
<li><a class="reference" href="#%24%2CNimSym" title="`$`(s: NimSym): string">`$`(s: NimSym): string</a></li>

</ul>
<ul class="simple nested-toc-section">==
  <li><a class="reference" href="#%3D%3D%2CNimIdent%2CNimIdent" title="`==`(a, b: NimIdent): bool">`==`(a, b: NimIdent): bool</a></li>
<li><a class="reference" href="#%3D%3D%2CNimNode%2CNimNode" title="`==`(a, b: NimNode): bool">`==`(a, b: NimNode): bool</a></li>
<li><a class="reference" href="#%3D%3D%2CNimSym%2CNimSym" title="`==`(a, b: NimSym): bool">`==`(a, b: NimSym): bool</a></li>

</ul>
<ul class="simple nested-toc-section">[]
  <li><a class="reference" href="#%5B%5D%2CNimNode%2CBackwardsIndex" title="`[]`(n: NimNode; i: BackwardsIndex): NimNode">`[]`(n: NimNode; i: BackwardsIndex): NimNode</a></li>
<li><a class="reference" href="#%5B%5D%2CNimNode%2Cint" title="`[]`(n: NimNode; i: int): NimNode">`[]`(n: NimNode; i: int): NimNode</a></li>
<li><a class="reference" href="#%5B%5D%2CNimNode%2CHSlice%5BT%3A%20Ordinal%2CU%3A%20Ordinal%5D" title="`[]`[T, U: Ordinal](n: NimNode; x: HSlice[T, U]): seq[NimNode]">`[]`[T, U: Ordinal](n: NimNode; x: HSlice[T, U]): seq[NimNode]</a></li>

</ul>
<ul class="simple nested-toc-section">[]=
  <li><a class="reference" href="#%5B%5D%3D%2CNimNode%2CBackwardsIndex%2CNimNode" title="`[]=`(n: NimNode; i: BackwardsIndex; child: NimNode)">`[]=`(n: NimNode; i: BackwardsIndex; child: NimNode)</a></li>
<li><a class="reference" href="#%5B%5D%3D%2CNimNode%2Cint%2CNimNode" title="`[]=`(n: NimNode; i: int; child: NimNode)">`[]=`(n: NimNode; i: int; child: NimNode)</a></li>

</ul>
<ul class="simple nested-toc-section">add
  <li><a class="reference" href="#add%2CNimNode%2CNimNode" title="add(father, child: NimNode): NimNode">add(father, child: NimNode): NimNode</a></li>
<li><a class="reference" href="#add%2CNimNode%2Cvarargs%5BNimNode%5D" title="add(father: NimNode; children: varargs[NimNode]): NimNode">add(father: NimNode; children: varargs[NimNode]): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">addIdentIfAbsent
  <li><a class="reference" href="#addIdentIfAbsent%2CNimNode%2Cstring" title="addIdentIfAbsent(dest: NimNode; ident: string)">addIdentIfAbsent(dest: NimNode; ident: string)</a></li>

</ul>
<ul class="simple nested-toc-section">addPragma
  <li><a class="reference" href="#addPragma%2CNimNode%2CNimNode" title="addPragma(someProc, pragma: NimNode)">addPragma(someProc, pragma: NimNode)</a></li>

</ul>
<ul class="simple nested-toc-section">astGenRepr
  <li><a class="reference" href="#astGenRepr%2CNimNode" title="astGenRepr(n: NimNode): string">astGenRepr(n: NimNode): string</a></li>

</ul>
<ul class="simple nested-toc-section">basename
  <li><a class="reference" href="#basename%2CNimNode" title="basename(a: NimNode): NimNode">basename(a: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">basename=
  <li><a class="reference" href="#basename%3D%2CNimNode%2Cstring" title="basename=(a: NimNode; val: string)">basename=(a: NimNode; val: string)</a></li>

</ul>
<ul class="simple nested-toc-section">bindSym
  <li><a class="reference" href="#bindSym%2C%2CBindSymRule" title="bindSym(ident: string | NimNode; rule: BindSymRule = brClosed): NimNode">bindSym(ident: string | NimNode; rule: BindSymRule = brClosed): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">body
  <li><a class="reference" href="#body%2CNimNode" title="body(someProc: NimNode): NimNode">body(someProc: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">body=
  <li><a class="reference" href="#body%3D%2CNimNode%2CNimNode" title="body=(someProc: NimNode; val: NimNode)">body=(someProc: NimNode; val: NimNode)</a></li>

</ul>
<ul class="simple nested-toc-section">boolVal
  <li><a class="reference" href="#boolVal%2CNimNode" title="boolVal(n: NimNode): bool">boolVal(n: NimNode): bool</a></li>

</ul>
<ul class="simple nested-toc-section">callsite
  <li><a class="reference" href="#callsite" title="callsite(): NimNode">callsite(): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">copy
  <li><a class="reference" href="#copy%2CNimNode" title="copy(node: NimNode): NimNode">copy(node: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">copyChildrenTo
  <li><a class="reference" href="#copyChildrenTo%2CNimNode%2CNimNode" title="copyChildrenTo(src, dest: NimNode)">copyChildrenTo(src, dest: NimNode)</a></li>

</ul>
<ul class="simple nested-toc-section">copyLineInfo
  <li><a class="reference" href="#copyLineInfo%2CNimNode%2CNimNode" title="copyLineInfo(arg: NimNode; info: NimNode)">copyLineInfo(arg: NimNode; info: NimNode)</a></li>

</ul>
<ul class="simple nested-toc-section">copyNimNode
  <li><a class="reference" href="#copyNimNode%2CNimNode" title="copyNimNode(n: NimNode): NimNode">copyNimNode(n: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">copyNimTree
  <li><a class="reference" href="#copyNimTree%2CNimNode" title="copyNimTree(n: NimNode): NimNode">copyNimTree(n: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">del
  <li><a class="reference" href="#del%2CNimNode%2Cint%2Cint" title="del(father: NimNode; idx = 0; n = 1)">del(father: NimNode; idx = 0; n = 1)</a></li>

</ul>
<ul class="simple nested-toc-section">eqIdent
  <li><a class="reference" href="#eqIdent%2CNimNode%2CNimNode" title="eqIdent(a: NimNode; b: NimNode): bool">eqIdent(a: NimNode; b: NimNode): bool</a></li>
<li><a class="reference" href="#eqIdent%2CNimNode%2Cstring" title="eqIdent(a: NimNode; b: string): bool">eqIdent(a: NimNode; b: string): bool</a></li>
<li><a class="reference" href="#eqIdent%2Cstring%2CNimNode" title="eqIdent(a: string; b: NimNode): bool">eqIdent(a: string; b: NimNode): bool</a></li>
<li><a class="reference" href="#eqIdent%2Cstring%2Cstring" title="eqIdent(a: string; b: string): bool">eqIdent(a: string; b: string): bool</a></li>

</ul>
<ul class="simple nested-toc-section">error
  <li><a class="reference" href="#error%2Cstring%2CNimNode" title="error(msg: string; n: NimNode = nil)">error(msg: string; n: NimNode = nil)</a></li>

</ul>
<ul class="simple nested-toc-section">expectIdent
  <li><a class="reference" href="#expectIdent%2CNimNode%2Cstring" title="expectIdent(n: NimNode; name: string)">expectIdent(n: NimNode; name: string)</a></li>

</ul>
<ul class="simple nested-toc-section">expectKind
  <li><a class="reference" href="#expectKind%2CNimNode%2CNimNodeKind" title="expectKind(n: NimNode; k: NimNodeKind)">expectKind(n: NimNode; k: NimNodeKind)</a></li>
<li><a class="reference" href="#expectKind%2CNimNode%2Cset%5BNimNodeKind%5D" title="expectKind(n: NimNode; k: set[NimNodeKind])">expectKind(n: NimNode; k: set[NimNodeKind])</a></li>

</ul>
<ul class="simple nested-toc-section">expectLen
  <li><a class="reference" href="#expectLen%2CNimNode%2Cint" title="expectLen(n: NimNode; len: int)">expectLen(n: NimNode; len: int)</a></li>
<li><a class="reference" href="#expectLen%2CNimNode%2Cint%2Cint" title="expectLen(n: NimNode; min, max: int)">expectLen(n: NimNode; min, max: int)</a></li>

</ul>
<ul class="simple nested-toc-section">expectMinLen
  <li><a class="reference" href="#expectMinLen%2CNimNode%2Cint" title="expectMinLen(n: NimNode; min: int)">expectMinLen(n: NimNode; min: int)</a></li>

</ul>
<ul class="simple nested-toc-section">extractDocCommentsAndRunnables
  <li><a class="reference" href="#extractDocCommentsAndRunnables%2CNimNode" title="extractDocCommentsAndRunnables(n: NimNode): NimNode">extractDocCommentsAndRunnables(n: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">floatVal
  <li><a class="reference" href="#floatVal%2CNimNode" title="floatVal(n: NimNode): BiggestFloat">floatVal(n: NimNode): BiggestFloat</a></li>

</ul>
<ul class="simple nested-toc-section">floatVal=
  <li><a class="reference" href="#floatVal%3D%2CNimNode%2CBiggestFloat" title="floatVal=(n: NimNode; val: BiggestFloat)">floatVal=(n: NimNode; val: BiggestFloat)</a></li>

</ul>
<ul class="simple nested-toc-section">genSym
  <li><a class="reference" href="#genSym%2CNimSymKind%2Cstring" title="genSym(kind: NimSymKind = nskLet; ident = &quot;&quot;): NimNode">genSym(kind: NimSymKind = nskLet; ident = &quot;&quot;): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">getAlign
  <li><a class="reference" href="#getAlign%2CNimNode" title="getAlign(arg: NimNode): int">getAlign(arg: NimNode): int</a></li>

</ul>
<ul class="simple nested-toc-section">getAst
  <li><a class="reference" href="#getAst%2Cuntyped" title="getAst(macroOrTemplate: untyped): NimNode">getAst(macroOrTemplate: untyped): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">getImpl
  <li><a class="reference" href="#getImpl%2CNimSym" title="getImpl(s: NimSym): NimNode">getImpl(s: NimSym): NimNode</a></li>
<li><a class="reference" href="#getImpl%2CNimNode" title="getImpl(symbol: NimNode): NimNode">getImpl(symbol: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">getImplTransformed
  <li><a class="reference" href="#getImplTransformed%2CNimNode" title="getImplTransformed(symbol: NimNode): NimNode">getImplTransformed(symbol: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">getOffset
  <li><a class="reference" href="#getOffset%2CNimNode" title="getOffset(arg: NimNode): int">getOffset(arg: NimNode): int</a></li>

</ul>
<ul class="simple nested-toc-section">getProjectPath
  <li><a class="reference" href="#getProjectPath" title="getProjectPath(): string">getProjectPath(): string</a></li>

</ul>
<ul class="simple nested-toc-section">getSize
  <li><a class="reference" href="#getSize%2CNimNode" title="getSize(arg: NimNode): int">getSize(arg: NimNode): int</a></li>

</ul>
<ul class="simple nested-toc-section">getType
  <li><a class="reference" href="#getType%2CNimNode" title="getType(n: NimNode): NimNode">getType(n: NimNode): NimNode</a></li>
<li><a class="reference" href="#getType%2Ctypedesc" title="getType(n: typedesc): NimNode">getType(n: typedesc): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">getTypeImpl
  <li><a class="reference" href="#getTypeImpl%2CNimNode" title="getTypeImpl(n: NimNode): NimNode">getTypeImpl(n: NimNode): NimNode</a></li>
<li><a class="reference" href="#getTypeImpl%2Ctypedesc" title="getTypeImpl(n: typedesc): NimNode">getTypeImpl(n: typedesc): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">getTypeInst
  <li><a class="reference" href="#getTypeInst%2CNimNode" title="getTypeInst(n: NimNode): NimNode">getTypeInst(n: NimNode): NimNode</a></li>
<li><a class="reference" href="#getTypeInst%2Ctypedesc" title="getTypeInst(n: typedesc): NimNode">getTypeInst(n: typedesc): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">hasArgOfName
  <li><a class="reference" href="#hasArgOfName%2CNimNode%2Cstring" title="hasArgOfName(params: NimNode; name: string): bool">hasArgOfName(params: NimNode; name: string): bool</a></li>

</ul>
<ul class="simple nested-toc-section">hint
  <li><a class="reference" href="#hint%2Cstring%2CNimNode" title="hint(msg: string; n: NimNode = nil)">hint(msg: string; n: NimNode = nil)</a></li>

</ul>
<ul class="simple nested-toc-section">ident
  <li><a class="reference" href="#ident%2CNimNode" title="ident(n: NimNode): NimIdent">ident(n: NimNode): NimIdent</a></li>
<li><a class="reference" href="#ident%2Cstring" title="ident(name: string): NimNode">ident(name: string): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">ident=
  <li><a class="reference" href="#ident%3D%2CNimNode%2CNimIdent" title="ident=(n: NimNode; val: NimIdent)">ident=(n: NimNode; val: NimIdent)</a></li>

</ul>
<ul class="simple nested-toc-section">infix
  <li><a class="reference" href="#infix%2CNimNode%2Cstring%2CNimNode" title="infix(a: NimNode; op: string; b: NimNode): NimNode">infix(a: NimNode; op: string; b: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">insert
  <li><a class="reference" href="#insert%2CNimNode%2Cint%2CNimNode" title="insert(a: NimNode; pos: int; b: NimNode)">insert(a: NimNode; pos: int; b: NimNode)</a></li>

</ul>
<ul class="simple nested-toc-section">internalErrorFlag
  <li><a class="reference" href="#internalErrorFlag" title="internalErrorFlag(): string">internalErrorFlag(): string</a></li>

</ul>
<ul class="simple nested-toc-section">intVal
  <li><a class="reference" href="#intVal%2CNimNode" title="intVal(n: NimNode): BiggestInt">intVal(n: NimNode): BiggestInt</a></li>

</ul>
<ul class="simple nested-toc-section">intVal=
  <li><a class="reference" href="#intVal%3D%2CNimNode%2CBiggestInt" title="intVal=(n: NimNode; val: BiggestInt)">intVal=(n: NimNode; val: BiggestInt)</a></li>

</ul>
<ul class="simple nested-toc-section">isExported
  <li><a class="reference" href="#isExported%2CNimNode" title="isExported(n: NimNode): bool">isExported(n: NimNode): bool</a></li>

</ul>
<ul class="simple nested-toc-section">isInstantiationOf
  <li><a class="reference" href="#isInstantiationOf%2CNimNode%2CNimNode" title="isInstantiationOf(instanceProcSym, genProcSym: NimNode): bool">isInstantiationOf(instanceProcSym, genProcSym: NimNode): bool</a></li>

</ul>
<ul class="simple nested-toc-section">kind
  <li><a class="reference" href="#kind%2CNimNode" title="kind(n: NimNode): NimNodeKind">kind(n: NimNode): NimNodeKind</a></li>

</ul>
<ul class="simple nested-toc-section">last
  <li><a class="reference" href="#last%2CNimNode" title="last(node: NimNode): NimNode">last(node: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">len
  <li><a class="reference" href="#len%2CNimNode" title="len(n: NimNode): int">len(n: NimNode): int</a></li>

</ul>
<ul class="simple nested-toc-section">lineInfo
  <li><a class="reference" href="#lineInfo%2CNimNode" title="lineInfo(arg: NimNode): string">lineInfo(arg: NimNode): string</a></li>

</ul>
<ul class="simple nested-toc-section">lineInfoObj
  <li><a class="reference" href="#lineInfoObj%2CNimNode" title="lineInfoObj(n: NimNode): LineInfo">lineInfoObj(n: NimNode): LineInfo</a></li>

</ul>
<ul class="simple nested-toc-section">lispRepr
  <li><a class="reference" href="#lispRepr%2CNimNode" title="lispRepr(n: NimNode; indented = false): string">lispRepr(n: NimNode; indented = false): string</a></li>

</ul>
<ul class="simple nested-toc-section">name
  <li><a class="reference" href="#name%2CNimNode" title="name(someProc: NimNode): NimNode">name(someProc: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">name=
  <li><a class="reference" href="#name%3D%2CNimNode%2CNimNode" title="name=(someProc: NimNode; val: NimNode)">name=(someProc: NimNode; val: NimNode)</a></li>

</ul>
<ul class="simple nested-toc-section">nestList
  <li><a class="reference" href="#nestList%2CNimNode%2CNimNode" title="nestList(op: NimNode; pack: NimNode): NimNode">nestList(op: NimNode; pack: NimNode): NimNode</a></li>
<li><a class="reference" href="#nestList%2CNimNode%2CNimNode%2CNimNode" title="nestList(op: NimNode; pack: NimNode; init: NimNode): NimNode">nestList(op: NimNode; pack: NimNode; init: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newAssignment
  <li><a class="reference" href="#newAssignment%2CNimNode%2CNimNode" title="newAssignment(lhs, rhs: NimNode): NimNode">newAssignment(lhs, rhs: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newBlockStmt
  <li><a class="reference" href="#newBlockStmt%2CNimNode" title="newBlockStmt(body: NimNode): NimNode">newBlockStmt(body: NimNode): NimNode</a></li>
<li><a class="reference" href="#newBlockStmt%2CNimNode%2CNimNode" title="newBlockStmt(label, body: NimNode): NimNode">newBlockStmt(label, body: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newCall
  <li><a class="reference" href="#newCall%2CNimIdent%2Cvarargs%5BNimNode%5D" title="newCall(theProc: NimIdent; args: varargs[NimNode]): NimNode">newCall(theProc: NimIdent; args: varargs[NimNode]): NimNode</a></li>
<li><a class="reference" href="#newCall%2CNimNode%2Cvarargs%5BNimNode%5D" title="newCall(theProc: NimNode; args: varargs[NimNode]): NimNode">newCall(theProc: NimNode; args: varargs[NimNode]): NimNode</a></li>
<li><a class="reference" href="#newCall%2Cstring%2Cvarargs%5BNimNode%5D" title="newCall(theProc: string; args: varargs[NimNode]): NimNode">newCall(theProc: string; args: varargs[NimNode]): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newColonExpr
  <li><a class="reference" href="#newColonExpr%2CNimNode%2CNimNode" title="newColonExpr(a, b: NimNode): NimNode">newColonExpr(a, b: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newCommentStmtNode
  <li><a class="reference" href="#newCommentStmtNode%2Cstring" title="newCommentStmtNode(s: string): NimNode">newCommentStmtNode(s: string): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newConstStmt
  <li><a class="reference" href="#newConstStmt%2CNimNode%2CNimNode" title="newConstStmt(name, value: NimNode): NimNode">newConstStmt(name, value: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newDotExpr
  <li><a class="reference" href="#newDotExpr%2CNimNode%2CNimNode" title="newDotExpr(a, b: NimNode): NimNode">newDotExpr(a, b: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newEmptyNode
  <li><a class="reference" href="#newEmptyNode" title="newEmptyNode(): NimNode">newEmptyNode(): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newEnum
  <li><a class="reference" href="#newEnum%2CNimNode%2CopenArray%5BNimNode%5D%2Cbool%2Cbool" title="newEnum(name: NimNode; fields: openArray[NimNode]; public, pure: bool): NimNode">newEnum(name: NimNode; fields: openArray[NimNode]; public, pure: bool): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newFloatLitNode
  <li><a class="reference" href="#newFloatLitNode%2CBiggestFloat" title="newFloatLitNode(f: BiggestFloat): NimNode">newFloatLitNode(f: BiggestFloat): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newIdentDefs
  <li><a class="reference" href="#newIdentDefs%2CNimNode%2CNimNode" title="newIdentDefs(name, kind: NimNode; default = newEmptyNode()): NimNode">newIdentDefs(name, kind: NimNode; default = newEmptyNode()): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newIdentNode
  <li><a class="reference" href="#newIdentNode%2CNimIdent" title="newIdentNode(i: NimIdent): NimNode">newIdentNode(i: NimIdent): NimNode</a></li>
<li><a class="reference" href="#newIdentNode%2Cstring" title="newIdentNode(i: string): NimNode">newIdentNode(i: string): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newIfStmt
  <li><a class="reference" href="#newIfStmt%2Cvarargs%5Btuple%5BNimNode%2CNimNode%5D%5D" title="newIfStmt(branches: varargs[tuple[cond, body: NimNode]]): NimNode">newIfStmt(branches: varargs[tuple[cond, body: NimNode]]): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newIntLitNode
  <li><a class="reference" href="#newIntLitNode%2CBiggestInt" title="newIntLitNode(i: BiggestInt): NimNode">newIntLitNode(i: BiggestInt): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newLetStmt
  <li><a class="reference" href="#newLetStmt%2CNimNode%2CNimNode" title="newLetStmt(name, value: NimNode): NimNode">newLetStmt(name, value: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newLit
  <li><a class="reference" href="#newLit" title="newLit(arg: enum): NimNode">newLit(arg: enum): NimNode</a></li>
<li><a class="reference" href="#newLit_2" title="newLit(arg: object): NimNode">newLit(arg: object): NimNode</a></li>
<li><a class="reference" href="#newLit%2Cref." title="newLit(arg: ref object): NimNode">newLit(arg: ref object): NimNode</a></li>
<li><a class="reference" href="#newLit%2Cbool" title="newLit(b: bool): NimNode">newLit(b: bool): NimNode</a></li>
<li><a class="reference" href="#newLit%2Cchar" title="newLit(c: char): NimNode">newLit(c: char): NimNode</a></li>
<li><a class="reference" href="#newLit%2Cfloat32" title="newLit(f: float32): NimNode">newLit(f: float32): NimNode</a></li>
<li><a class="reference" href="#newLit%2Cfloat64" title="newLit(f: float64): NimNode">newLit(f: float64): NimNode</a></li>
<li><a class="reference" href="#newLit%2Cint" title="newLit(i: int): NimNode">newLit(i: int): NimNode</a></li>
<li><a class="reference" href="#newLit%2Cint8" title="newLit(i: int8): NimNode">newLit(i: int8): NimNode</a></li>
<li><a class="reference" href="#newLit%2Cint16" title="newLit(i: int16): NimNode">newLit(i: int16): NimNode</a></li>
<li><a class="reference" href="#newLit%2Cint32" title="newLit(i: int32): NimNode">newLit(i: int32): NimNode</a></li>
<li><a class="reference" href="#newLit%2Cint64" title="newLit(i: int64): NimNode">newLit(i: int64): NimNode</a></li>
<li><a class="reference" href="#newLit%2Cuint" title="newLit(i: uint): NimNode">newLit(i: uint): NimNode</a></li>
<li><a class="reference" href="#newLit%2Cuint8" title="newLit(i: uint8): NimNode">newLit(i: uint8): NimNode</a></li>
<li><a class="reference" href="#newLit%2Cuint16" title="newLit(i: uint16): NimNode">newLit(i: uint16): NimNode</a></li>
<li><a class="reference" href="#newLit%2Cuint32" title="newLit(i: uint32): NimNode">newLit(i: uint32): NimNode</a></li>
<li><a class="reference" href="#newLit%2Cuint64" title="newLit(i: uint64): NimNode">newLit(i: uint64): NimNode</a></li>
<li><a class="reference" href="#newLit%2Cstring" title="newLit(s: string): NimNode">newLit(s: string): NimNode</a></li>
<li><a class="reference" href="#newLit%2Carray%5BN%2CT%5D" title="newLit[N, T](arg: array[N, T]): NimNode">newLit[N, T](arg: array[N, T]): NimNode</a></li>
<li><a class="reference" href="#newLit%2CT" title="newLit[T: tuple](arg: T): NimNode">newLit[T: tuple](arg: T): NimNode</a></li>
<li><a class="reference" href="#newLit%2Cseq%5BT%5D" title="newLit[T](arg: seq[T]): NimNode">newLit[T](arg: seq[T]): NimNode</a></li>
<li><a class="reference" href="#newLit%2Cset%5BT%5D" title="newLit[T](s: set[T]): NimNode">newLit[T](s: set[T]): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newNilLit
  <li><a class="reference" href="#newNilLit" title="newNilLit(): NimNode">newNilLit(): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newNimNode
  <li><a class="reference" href="#newNimNode%2CNimNodeKind%2CNimNode" title="newNimNode(kind: NimNodeKind; lineInfoFrom: NimNode = nil): NimNode">newNimNode(kind: NimNodeKind; lineInfoFrom: NimNode = nil): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newPar
  <li><a class="reference" href="#newPar%2CNimNode" title="newPar(exprs: NimNode): NimNode">newPar(exprs: NimNode): NimNode</a></li>
<li><a class="reference" href="#newPar%2Cvarargs%5BNimNode%5D" title="newPar(exprs: varargs[NimNode]): NimNode">newPar(exprs: varargs[NimNode]): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newProc
  <li><a class="reference" href="#newProc%2CopenArray%5BNimNode%5D%2CNimNode%2CNimNode" title="newProc(name = newEmptyNode(); params: openArray[NimNode] = [newEmptyNode()];
        body: NimNode = newStmtList(); procType = nnkProcDef;
        pragmas: NimNode = newEmptyNode()): NimNode">newProc(name = newEmptyNode(); params: openArray[NimNode] = [newEmptyNode()];
        body: NimNode = newStmtList(); procType = nnkProcDef;
        pragmas: NimNode = newEmptyNode()): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newStmtList
  <li><a class="reference" href="#newStmtList%2Cvarargs%5BNimNode%5D" title="newStmtList(stmts: varargs[NimNode]): NimNode">newStmtList(stmts: varargs[NimNode]): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newStrLitNode
  <li><a class="reference" href="#newStrLitNode%2Cstring" title="newStrLitNode(s: string): NimNode">newStrLitNode(s: string): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newTree
  <li><a class="reference" href="#newTree%2CNimNodeKind%2Cvarargs%5BNimNode%5D" title="newTree(kind: NimNodeKind; children: varargs[NimNode]): NimNode">newTree(kind: NimNodeKind; children: varargs[NimNode]): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">newVarStmt
  <li><a class="reference" href="#newVarStmt%2CNimNode%2CNimNode" title="newVarStmt(name, value: NimNode): NimNode">newVarStmt(name, value: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">nodeID
  <li><a class="reference" href="#nodeID%2CNimNode" title="nodeID(n: NimNode): int">nodeID(n: NimNode): int</a></li>

</ul>
<ul class="simple nested-toc-section">owner
  <li><a class="reference" href="#owner%2CNimNode" title="owner(sym: NimNode): NimNode">owner(sym: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">params
  <li><a class="reference" href="#params%2CNimNode" title="params(someProc: NimNode): NimNode">params(someProc: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">params=
  <li><a class="reference" href="#params%3D%2CNimNode%2CNimNode" title="params=(someProc: NimNode; params: NimNode)">params=(someProc: NimNode; params: NimNode)</a></li>

</ul>
<ul class="simple nested-toc-section">parseExpr
  <li><a class="reference" href="#parseExpr%2Cstring%2Cstring" title="parseExpr(s: string; filename: string = &quot;&quot;): NimNode">parseExpr(s: string; filename: string = &quot;&quot;): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">parseStmt
  <li><a class="reference" href="#parseStmt%2Cstring%2Cstring" title="parseStmt(s: string; filename: string = &quot;&quot;): NimNode">parseStmt(s: string; filename: string = &quot;&quot;): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">postfix
  <li><a class="reference" href="#postfix%2CNimNode%2Cstring" title="postfix(node: NimNode; op: string): NimNode">postfix(node: NimNode; op: string): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">pragma
  <li><a class="reference" href="#pragma%2CNimNode" title="pragma(someProc: NimNode): NimNode">pragma(someProc: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">pragma=
  <li><a class="reference" href="#pragma%3D%2CNimNode%2CNimNode" title="pragma=(someProc: NimNode; val: NimNode)">pragma=(someProc: NimNode; val: NimNode)</a></li>

</ul>
<ul class="simple nested-toc-section">prefix
  <li><a class="reference" href="#prefix%2CNimNode%2Cstring" title="prefix(node: NimNode; op: string): NimNode">prefix(node: NimNode; op: string): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">quote
  <li><a class="reference" href="#quote%2Ctyped%2Cstring" title="quote(bl: typed; op = &quot;``&quot;): NimNode">quote(bl: typed; op = &quot;``&quot;): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">sameType
  <li><a class="reference" href="#sameType%2CNimNode%2CNimNode" title="sameType(a, b: NimNode): bool">sameType(a, b: NimNode): bool</a></li>

</ul>
<ul class="simple nested-toc-section">setLineInfo
  <li><a class="reference" href="#setLineInfo%2CNimNode%2Cstring%2Cint%2Cint" title="setLineInfo(arg: NimNode; file: string; line: int; column: int)">setLineInfo(arg: NimNode; file: string; line: int; column: int)</a></li>
<li><a class="reference" href="#setLineInfo%2CNimNode%2CLineInfo" title="setLineInfo(arg: NimNode; lineInfo: LineInfo)">setLineInfo(arg: NimNode; lineInfo: LineInfo)</a></li>

</ul>
<ul class="simple nested-toc-section">signatureHash
  <li><a class="reference" href="#signatureHash%2CNimNode" title="signatureHash(n: NimNode): string">signatureHash(n: NimNode): string</a></li>

</ul>
<ul class="simple nested-toc-section">strVal
  <li><a class="reference" href="#strVal%2CNimNode" title="strVal(n: NimNode): string">strVal(n: NimNode): string</a></li>

</ul>
<ul class="simple nested-toc-section">strVal=
  <li><a class="reference" href="#strVal%3D%2CNimNode%2Cstring" title="strVal=(n: NimNode; val: string)">strVal=(n: NimNode; val: string)</a></li>

</ul>
<ul class="simple nested-toc-section">symBodyHash
  <li><a class="reference" href="#symBodyHash%2CNimNode" title="symBodyHash(s: NimNode): string">symBodyHash(s: NimNode): string</a></li>

</ul>
<ul class="simple nested-toc-section">symbol
  <li><a class="reference" href="#symbol%2CNimNode" title="symbol(n: NimNode): NimSym">symbol(n: NimNode): NimSym</a></li>

</ul>
<ul class="simple nested-toc-section">symbol=
  <li><a class="reference" href="#symbol%3D%2CNimNode%2CNimSym" title="symbol=(n: NimNode; val: NimSym)">symbol=(n: NimNode; val: NimSym)</a></li>

</ul>
<ul class="simple nested-toc-section">symKind
  <li><a class="reference" href="#symKind%2CNimNode" title="symKind(symbol: NimNode): NimSymKind">symKind(symbol: NimNode): NimSymKind</a></li>

</ul>
<ul class="simple nested-toc-section">toNimIdent
  <li><a class="reference" href="#toNimIdent%2Cstring" title="toNimIdent(s: string): NimIdent">toNimIdent(s: string): NimIdent</a></li>

</ul>
<ul class="simple nested-toc-section">toStrLit
  <li><a class="reference" href="#toStrLit%2CNimNode" title="toStrLit(n: NimNode): NimNode">toStrLit(n: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">treeRepr
  <li><a class="reference" href="#treeRepr%2CNimNode" title="treeRepr(n: NimNode): string">treeRepr(n: NimNode): string</a></li>

</ul>
<ul class="simple nested-toc-section">typeKind
  <li><a class="reference" href="#typeKind%2CNimNode" title="typeKind(n: NimNode): NimTypeKind">typeKind(n: NimNode): NimTypeKind</a></li>

</ul>
<ul class="simple nested-toc-section">unpackInfix
  <li><a class="reference" href="#unpackInfix%2CNimNode" title="unpackInfix(node: NimNode): tuple[left: NimNode, op: string, right: NimNode]">unpackInfix(node: NimNode): tuple[left: NimNode, op: string, right: NimNode]</a></li>

</ul>
<ul class="simple nested-toc-section">unpackPostfix
  <li><a class="reference" href="#unpackPostfix%2CNimNode" title="unpackPostfix(node: NimNode): tuple[node: NimNode, op: string]">unpackPostfix(node: NimNode): tuple[node: NimNode, op: string]</a></li>

</ul>
<ul class="simple nested-toc-section">unpackPrefix
  <li><a class="reference" href="#unpackPrefix%2CNimNode" title="unpackPrefix(node: NimNode): tuple[node: NimNode, op: string]">unpackPrefix(node: NimNode): tuple[node: NimNode, op: string]</a></li>

</ul>
<ul class="simple nested-toc-section">warning
  <li><a class="reference" href="#warning%2Cstring%2CNimNode" title="warning(msg: string; n: NimNode = nil)">warning(msg: string; n: NimNode = nil)</a></li>

</ul>

    </ul>
  </details>
</li>
<li>
  <details open>
    <summary><a class="reference reference-toplevel" href="#15" id="65">Iterators</a></summary>
    <ul class="simple simple-toc-section">
      <ul class="simple nested-toc-section">children
  <li><a class="reference" href="#children.i%2CNimNode" title="children(n: NimNode): NimNode">children(n: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">items
  <li><a class="reference" href="#items.i%2CNimNode" title="items(n: NimNode): NimNode">items(n: NimNode): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">pairs
  <li><a class="reference" href="#pairs.i%2CNimNode" title="pairs(n: NimNode): (int, NimNode)">pairs(n: NimNode): (int, NimNode)</a></li>

</ul>

    </ul>
  </details>
</li>
<li>
  <details open>
    <summary><a class="reference reference-toplevel" href="#17" id="67">Macros</a></summary>
    <ul class="simple simple-toc-section">
      <ul class="simple nested-toc-section">dumpAstGen
  <li><a class="reference" href="#dumpAstGen.m%2Cuntyped" title="dumpAstGen(s: untyped): untyped">dumpAstGen(s: untyped): untyped</a></li>

</ul>
<ul class="simple nested-toc-section">dumpLisp
  <li><a class="reference" href="#dumpLisp.m%2Cuntyped" title="dumpLisp(s: untyped): untyped">dumpLisp(s: untyped): untyped</a></li>

</ul>
<ul class="simple nested-toc-section">dumpTree
  <li><a class="reference" href="#dumpTree.m%2Cuntyped" title="dumpTree(s: untyped): untyped">dumpTree(s: untyped): untyped</a></li>

</ul>
<ul class="simple nested-toc-section">expandMacros
  <li><a class="reference" href="#expandMacros.m%2Ctyped" title="expandMacros(body: typed): untyped">expandMacros(body: typed): untyped</a></li>

</ul>
<ul class="simple nested-toc-section">getCustomPragmaVal
  <li><a class="reference" href="#getCustomPragmaVal.m%2Ctyped%2C" title="getCustomPragmaVal(n: typed; cp: typed{nkSym}): untyped">getCustomPragmaVal(n: typed; cp: typed{nkSym}): untyped</a></li>

</ul>
<ul class="simple nested-toc-section">hasCustomPragma
  <li><a class="reference" href="#hasCustomPragma.m%2Ctyped%2C" title="hasCustomPragma(n: typed; cp: typed{nkSym}): untyped">hasCustomPragma(n: typed; cp: typed{nkSym}): untyped</a></li>

</ul>
<ul class="simple nested-toc-section">unpackVarargs
  <li><a class="reference" href="#unpackVarargs.m%2Cuntyped%2Cvarargs%5Buntyped%5D" title="unpackVarargs(callee: untyped; args: varargs[untyped]): untyped">unpackVarargs(callee: untyped; args: varargs[untyped]): untyped</a></li>

</ul>

    </ul>
  </details>
</li>
<li>
  <details open>
    <summary><a class="reference reference-toplevel" href="#18" id="68">Templates</a></summary>
    <ul class="simple simple-toc-section">
      <ul class="simple nested-toc-section">findChild
  <li><a class="reference" href="#findChild.t%2CNimNode%2Cuntyped" title="findChild(n: NimNode; cond: untyped): NimNode">findChild(n: NimNode; cond: untyped): NimNode</a></li>

</ul>
<ul class="simple nested-toc-section">or
  <li><a class="reference" href="#or.t%2CNimNode%2CNimNode" title="`or`(x, y: NimNode): NimNode">`or`(x, y: NimNode): NimNode</a></li>

</ul>

    </ul>
  </details>
</li>

</ul>

  </div>
  <div class="nine columns" id="content">
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

    <div id="tocRoot"></div>
    
    <p class="module-desc"><p>This module contains the interface to the compiler's abstract syntax tree (<span id="ast_1">AST</span>). Macros operate on this tree.</p>
<p>See also:</p>
<ul class="simple"><li><a class="reference external" href="tut3.html">macros tutorial</a></li>
<li><a class="reference external" href="manual.html#macros">macros section in Nim manual</a></li>
</ul>

<h1><a class="toc-backref" id="the-ast-in-nim" href="#the-ast-in-nim">The AST in Nim</a></h1><p>This section describes how the AST is modelled with Nim's type system. The AST consists of nodes (<tt class="docutils literal"><span class="pre">NimNode</span></tt>) with a variable number of children. Each node has a field named <tt class="docutils literal"><span class="pre">kind</span></tt> which describes what the node contains:</p>
<p><pre class="listing"><span class="Keyword">type</span>
  <span class="Identifier">NimNodeKind</span> <span class="Operator">=</span> <span class="Keyword">enum</span>     <span class="Comment">## kind of a node; only explanatory</span>
    <span class="Identifier">nnkNone</span><span class="Punctuation">,</span>             <span class="Comment">## invalid node kind</span>
    <span class="Identifier">nnkEmpty</span><span class="Punctuation">,</span>            <span class="Comment">## empty node</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">,</span>            <span class="Comment">## node contains an identifier</span>
    <span class="Identifier">nnkIntLit</span><span class="Punctuation">,</span>           <span class="Comment">## node contains an int literal (example: 10)</span>
    <span class="Identifier">nnkStrLit</span><span class="Punctuation">,</span>           <span class="Comment">## node contains a string literal (example: &quot;abc&quot;)</span>
    <span class="Identifier">nnkNilLit</span><span class="Punctuation">,</span>           <span class="Comment">## node contains a nil literal (example: nil)</span>
    <span class="Identifier">nnkCaseStmt</span><span class="Punctuation">,</span>         <span class="Comment">## node represents a case statement</span>
    <span class="Operator">...</span>                  <span class="Comment">## many more</span>
  
  <span class="Identifier">NimNode</span> <span class="Operator">=</span> <span class="Keyword">ref</span> <span class="Identifier">NimNodeObj</span>
  <span class="Identifier">NimNodeObj</span> <span class="Operator">=</span> <span class="Keyword">object</span>
    <span class="Keyword">case</span> <span class="Identifier">kind</span><span class="Punctuation">:</span> <span class="Identifier">NimNodeKind</span>           <span class="Comment">## the node's kind</span>
    <span class="Keyword">of</span> <span class="Identifier">nnkNone</span><span class="Punctuation">,</span> <span class="Identifier">nnkEmpty</span><span class="Punctuation">,</span> <span class="Identifier">nnkNilLit</span><span class="Punctuation">:</span>
      <span class="Keyword">discard</span>                        <span class="Comment">## node contains no additional fields</span>
    <span class="Keyword">of</span> <span class="Identifier">nnkCharLit</span><span class="Operator">..</span><span class="Identifier">nnkUInt64Lit</span><span class="Punctuation">:</span>
      <span class="Identifier">intVal</span><span class="Punctuation">:</span> <span class="Identifier">BiggestInt</span>             <span class="Comment">## the int literal</span>
    <span class="Keyword">of</span> <span class="Identifier">nnkFloatLit</span><span class="Operator">..</span><span class="Identifier">nnkFloat64Lit</span><span class="Punctuation">:</span>
      <span class="Identifier">floatVal</span><span class="Punctuation">:</span> <span class="Identifier">BiggestFloat</span>         <span class="Comment">## the float literal</span>
    <span class="Keyword">of</span> <span class="Identifier">nnkStrLit</span><span class="Operator">..</span><span class="Identifier">nnkTripleStrLit</span><span class="Punctuation">,</span> <span class="Identifier">nnkCommentStmt</span><span class="Punctuation">,</span> <span class="Identifier">nnkIdent</span><span class="Punctuation">,</span> <span class="Identifier">nnkSym</span><span class="Punctuation">:</span>
      <span class="Identifier">strVal</span><span class="Punctuation">:</span> <span class="Identifier">string</span>                 <span class="Comment">## the string literal</span>
    <span class="Keyword">else</span><span class="Punctuation">:</span>
      <span class="Identifier">sons</span><span class="Punctuation">:</span> <span class="Identifier">seq</span><span class="Punctuation">[</span><span class="Identifier">NimNode</span><span class="Punctuation">]</span>             <span class="Comment">## the node's sons (or children)</span></pre></p>
<p>For the <tt class="docutils literal"><span class="pre">NimNode</span></tt> type, the <tt class="docutils literal"><span class="pre">[]</span></tt> operator has been overloaded: <tt class="docutils literal"><span class="pre">n[i]</span></tt> is <tt class="docutils literal"><span class="pre">n</span></tt>'s <tt class="docutils literal"><span class="pre">i</span></tt>-th child.</p>
<p>To specify the AST for the different Nim constructs, the notation <tt class="docutils literal"><span class="pre">nodekind(son1, son2, ...)</span></tt> or <tt class="docutils literal"><span class="pre">nodekind(value)</span></tt> or <tt class="docutils literal"><span class="pre">nodekind(field=value)</span></tt> is used.</p>
<p>Some child may be missing. A missing child is a node of kind <tt class="docutils literal"><span class="pre">nnkEmpty</span></tt>; a child can never be nil.</p>

<h1><a class="toc-backref" id="leaf-nodesslashatoms" href="#leaf-nodesslashatoms">Leaf nodes/Atoms</a></h1><p>A leaf of the AST often corresponds to a terminal symbol in the concrete syntax. Note that the default <tt class="docutils literal"><span class="pre">float</span></tt> in Nim maps to <tt class="docutils literal"><span class="pre">float64</span></tt> such that the default AST for a float is <tt class="docutils literal"><span class="pre">nnkFloat64Lit</span></tt> as below.</p>
<table border="1" class="docutils"><tr><th>Nim expression</th><th>Corresponding AST</th></tr>
<tr><td><tt class="docutils literal"><span class="pre">42</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkIntLit(intVal = 42)</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">42'i8</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkInt8Lit(intVal = 42)</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">42'i16</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkInt16Lit(intVal = 42)</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">42'i32</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkInt32Lit(intVal = 42)</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">42'i64</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkInt64Lit(intVal = 42)</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">42'u8</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkUInt8Lit(intVal = 42)</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">42'u16</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkUInt16Lit(intVal = 42)</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">42'u32</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkUInt32Lit(intVal = 42)</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">42'u64</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkUInt64Lit(intVal = 42)</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">42.0</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkFloat64Lit(floatVal = 42.0)</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">42.0'f32</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkFloat32Lit(floatVal = 42.0)</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">42.0'f64</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkFloat64Lit(floatVal = 42.0)</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">&quot;abc&quot;</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkStrLit(strVal = &quot;abc&quot;)</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">r&quot;abc&quot;</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkRStrLit(strVal = &quot;abc&quot;)</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">&quot;&quot;&quot;abc&quot;&quot;&quot;</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkTripleStrLit(strVal = &quot;abc&quot;)</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">' '</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkCharLit(intVal = 32)</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">nil</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkNilLit()</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">myIdentifier</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkIdent(strVal = &quot;myIdentifier&quot;)</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">myIdentifier</span></tt></td><td>after lookup pass: <tt class="docutils literal"><span class="pre">nnkSym(strVal = &quot;myIdentifier&quot;, ...)</span></tt></td></tr>
</table><p>Identifiers are <tt class="docutils literal"><span class="pre">nnkIdent</span></tt> nodes. After the name lookup pass these nodes get transferred into <tt class="docutils literal"><span class="pre">nnkSym</span></tt> nodes.</p>

<h1><a class="toc-backref" id="callsslashexpressions" href="#callsslashexpressions">Calls/expressions</a></h1>
<h2><a class="toc-backref" id="callsslashexpressions-command-call" href="#callsslashexpressions-command-call">Command call</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Identifier">echo</span> <span class="StringLit">&quot;abc&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;xyz&quot;</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkCommand</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;echo&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkStrLit</span><span class="Punctuation">(</span><span class="StringLit">&quot;abc&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkStrLit</span><span class="Punctuation">(</span><span class="StringLit">&quot;xyz&quot;</span><span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="callsslashexpressions-call-with" href="#callsslashexpressions-call-with">Call with <tt class="docutils literal"><span class="pre">()</span></tt></a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Identifier">echo</span><span class="Punctuation">(</span><span class="StringLit">&quot;abc&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;xyz&quot;</span><span class="Punctuation">)</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkCall</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;echo&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkStrLit</span><span class="Punctuation">(</span><span class="StringLit">&quot;abc&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkStrLit</span><span class="Punctuation">(</span><span class="StringLit">&quot;xyz&quot;</span><span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="callsslashexpressions-infix-operator-call" href="#callsslashexpressions-infix-operator-call">Infix operator call</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="StringLit">&quot;abc&quot;</span> <span class="Operator">&amp;</span> <span class="StringLit">&quot;xyz&quot;</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkInfix</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;&amp;&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkStrLit</span><span class="Punctuation">(</span><span class="StringLit">&quot;abc&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkStrLit</span><span class="Punctuation">(</span><span class="StringLit">&quot;xyz&quot;</span><span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>
<p>Note that with multiple infix operators, the command is parsed by operator precedence.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="DecNumber">5</span> <span class="Operator">+</span> <span class="DecNumber">3</span> <span class="Operator">*</span> <span class="DecNumber">4</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkInfix</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;+&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">5</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkInfix</span><span class="Punctuation">(</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;*&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
    <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
    <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">4</span><span class="Punctuation">)</span>
  <span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>
<p>As a side note, if you choose to use infix operators in a prefix form, the AST behaves as a <a class="reference external" href="#callsslashexpressions-call-with">parenthetical function call</a> with <tt class="docutils literal"><span class="pre">nnkAccQuoted</span></tt>, as follows:</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Punctuation">`</span><span class="Operator">+</span><span class="Punctuation">`</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">,</span> <span class="DecNumber">4</span><span class="Punctuation">)</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkCall</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkAccQuoted</span><span class="Punctuation">(</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;+&quot;</span><span class="Punctuation">)</span>
  <span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">4</span><span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="callsslashexpressions-prefix-operator-call" href="#callsslashexpressions-prefix-operator-call">Prefix operator call</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Operator">?</span> <span class="StringLit">&quot;xyz&quot;</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkPrefix</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;?&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkStrLit</span><span class="Punctuation">(</span><span class="StringLit">&quot;abc&quot;</span><span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="callsslashexpressions-postfix-operator-call" href="#callsslashexpressions-postfix-operator-call">Postfix operator call</a></h2><p><strong>Note:</strong> There are no postfix operators in Nim. However, the <tt class="docutils literal"><span class="pre">nnkPostfix</span></tt> node is used for the <em>asterisk export marker</em> <tt class="docutils literal"><span class="pre">*</span></tt>:</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Identifier">identifier</span><span class="Operator">*</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkPostfix</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;*&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;identifier&quot;</span><span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="callsslashexpressions-call-with-named-arguments" href="#callsslashexpressions-call-with-named-arguments">Call with named arguments</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Identifier">writeLine</span><span class="Punctuation">(</span><span class="Identifier">file</span><span class="Operator">=</span><span class="Identifier">stdout</span><span class="Punctuation">,</span> <span class="StringLit">&quot;hallo&quot;</span><span class="Punctuation">)</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkCall</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;writeLine&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkExprEqExpr</span><span class="Punctuation">(</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;file&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;stdout&quot;</span><span class="Punctuation">)</span>
  <span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkStrLit</span><span class="Punctuation">(</span><span class="StringLit">&quot;hallo&quot;</span><span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="callsslashexpressions-call-with-raw-string-literal" href="#callsslashexpressions-call-with-raw-string-literal">Call with raw string literal</a></h2><p>This is used, for example, in the <tt class="docutils literal"><span class="pre">bindSym</span></tt> examples <a class="reference external" href="manual.html#macros-bindsym">here</a> and with <tt class="docutils literal"><span class="pre">re&quot;some regexp&quot;</span></tt> in the regular expression module.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="RawData">echo&quot;abc&quot;</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkCallStrLit</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;echo&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkRStrLit</span><span class="Punctuation">(</span><span class="StringLit">&quot;hello&quot;</span><span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="callsslashexpressions-dereference-operator" href="#callsslashexpressions-dereference-operator">Dereference operator <tt class="docutils literal"><span class="pre">[]</span></tt></a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Identifier">x</span><span class="Punctuation">[</span><span class="Punctuation">]</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkDerefExpr</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;x&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="callsslashexpressions-addr-operator" href="#callsslashexpressions-addr-operator">Addr operator</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">addr</span><span class="Punctuation">(</span><span class="Identifier">x</span><span class="Punctuation">)</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkAddr</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;x&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="callsslashexpressions-cast-operator" href="#callsslashexpressions-cast-operator">Cast operator</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">cast</span><span class="Punctuation">[</span><span class="Identifier">T</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="Identifier">x</span><span class="Punctuation">)</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkCast</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;T&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;x&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="callsslashexpressions-object-access-operator-dot" href="#callsslashexpressions-object-access-operator-dot">Object access operator <tt class="docutils literal"><span class="pre">.</span></tt></a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Identifier">x</span><span class="Operator">.</span><span class="Identifier">y</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkDotExpr</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;x&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;y&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>
<p>If you use Nim's flexible calling syntax (as in <tt class="docutils literal"><span class="pre">x.len()</span></tt>), the result is the same as above but wrapped in an <tt class="docutils literal"><span class="pre">nnkCall</span></tt>.</p>

<h2><a class="toc-backref" id="callsslashexpressions-array-access-operator" href="#callsslashexpressions-array-access-operator">Array access operator <tt class="docutils literal"><span class="pre">[]</span></tt></a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Identifier">x</span><span class="Punctuation">[</span><span class="Identifier">y</span><span class="Punctuation">]</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkBracketExpr</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;x&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;y&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="callsslashexpressions-parentheses" href="#callsslashexpressions-parentheses">Parentheses</a></h2><p>Parentheses for affecting operator precedence use the <tt class="docutils literal"><span class="pre">nnkPar</span></tt> node.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Punctuation">(</span><span class="Identifier">a</span> <span class="Operator">+</span> <span class="Identifier">b</span><span class="Punctuation">)</span> <span class="Operator">*</span> <span class="Identifier">c</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkInfix</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;*&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkPar</span><span class="Punctuation">(</span>
    <span class="Identifier">nnkInfix</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;+&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;a&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;b&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;c&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="callsslashexpressions-tuple-constructors" href="#callsslashexpressions-tuple-constructors">Tuple Constructors</a></h2><p>Nodes for tuple construction are built with the <tt class="docutils literal"><span class="pre">nnkTupleConstr</span></tt> node.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Punctuation">(</span><span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="DecNumber">2</span><span class="Punctuation">,</span> <span class="DecNumber">3</span><span class="Punctuation">)</span>
<span class="Punctuation">(</span><span class="Identifier">a</span><span class="Punctuation">:</span> <span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="Identifier">b</span><span class="Punctuation">:</span> <span class="DecNumber">2</span><span class="Punctuation">,</span> <span class="Identifier">c</span><span class="Punctuation">:</span> <span class="DecNumber">3</span><span class="Punctuation">)</span>
<span class="Punctuation">(</span><span class="Punctuation">)</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkTupleConstr</span><span class="Punctuation">(</span><span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">1</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">2</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
<span class="Identifier">nnkTupleConstr</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkExprColonExpr</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;a&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">1</span><span class="Punctuation">)</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkExprColonExpr</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;b&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">2</span><span class="Punctuation">)</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkExprColonExpr</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;c&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
<span class="Identifier">nnkTupleConstr</span><span class="Punctuation">(</span><span class="Punctuation">)</span></pre></p>
<p>Since the one tuple would be syntactically identical to parentheses with an expression in them, the parser expects a trailing comma for them. For tuple constructors with field names, this is not necessary.</p>
<p><pre class="listing"><span class="Punctuation">(</span><span class="DecNumber">1</span><span class="Punctuation">,</span><span class="Punctuation">)</span>
<span class="Punctuation">(</span><span class="Identifier">a</span><span class="Punctuation">:</span> <span class="DecNumber">1</span><span class="Punctuation">)</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkTupleConstr</span><span class="Punctuation">(</span><span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">1</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
<span class="Identifier">nnkTupleConstr</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkExprColonExpr</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;a&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">1</span><span class="Punctuation">)</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="callsslashexpressions-curly-braces" href="#callsslashexpressions-curly-braces">Curly braces</a></h2><p>Curly braces are used as the set constructor.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Punctuation">{</span><span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="DecNumber">2</span><span class="Punctuation">,</span> <span class="DecNumber">3</span><span class="Punctuation">}</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkCurly</span><span class="Punctuation">(</span><span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">1</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">2</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>
<p>When used as a table constructor, the syntax is different.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Punctuation">{</span><span class="Identifier">a</span><span class="Punctuation">:</span> <span class="DecNumber">3</span><span class="Punctuation">,</span> <span class="Identifier">b</span><span class="Punctuation">:</span> <span class="DecNumber">5</span><span class="Punctuation">}</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkTableConstr</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkExprColonExpr</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;a&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkExprColonExpr</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;b&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">5</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="callsslashexpressions-brackets" href="#callsslashexpressions-brackets">Brackets</a></h2><p>Brackets are used as the array constructor.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Punctuation">[</span><span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="DecNumber">2</span><span class="Punctuation">,</span> <span class="DecNumber">3</span><span class="Punctuation">]</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkBracket</span><span class="Punctuation">(</span><span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">1</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">2</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="callsslashexpressions-ranges" href="#callsslashexpressions-ranges">Ranges</a></h2><p>Ranges occur in set constructors, case statement branches, or array slices. Internally, the node kind <tt class="docutils literal"><span class="pre">nnkRange</span></tt> is used, but when constructing the AST, construction with <tt class="docutils literal"><span class="pre">..</span></tt> as an infix operator should be used instead.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="FloatNumber">1.</span><span class="Operator">.</span><span class="DecNumber">3</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkInfix</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;..&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">1</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>
<p>Example code:</p>
<p><pre class="listing"><span class="Keyword">macro</span> <span class="Identifier">genRepeatEcho</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">=</span>
  <span class="Identifier">result</span> <span class="Operator">=</span> <span class="Identifier">newNimNode</span><span class="Punctuation">(</span><span class="Identifier">nnkStmtList</span><span class="Punctuation">)</span>
  
  <span class="Keyword">var</span> <span class="Identifier">forStmt</span> <span class="Operator">=</span> <span class="Identifier">newNimNode</span><span class="Punctuation">(</span><span class="Identifier">nnkForStmt</span><span class="Punctuation">)</span> <span class="Comment"># generate a for statement</span>
  <span class="Identifier">forStmt</span><span class="Operator">.</span><span class="Identifier">add</span><span class="Punctuation">(</span><span class="Identifier">ident</span><span class="Punctuation">(</span><span class="StringLit">&quot;i&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Comment"># use the variable `i` for iteration</span>
  
  <span class="Keyword">var</span> <span class="Identifier">rangeDef</span> <span class="Operator">=</span> <span class="Identifier">newNimNode</span><span class="Punctuation">(</span><span class="Identifier">nnkInfix</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">add</span><span class="Punctuation">(</span>
    <span class="Identifier">ident</span><span class="Punctuation">(</span><span class="StringLit">&quot;..&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">add</span><span class="Punctuation">(</span>
    <span class="Identifier">newIntLitNode</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span><span class="Punctuation">,</span><span class="Identifier">newIntLitNode</span><span class="Punctuation">(</span><span class="DecNumber">5</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Comment"># iterate over the range 3..5</span>
  
  <span class="Identifier">forStmt</span><span class="Operator">.</span><span class="Identifier">add</span><span class="Punctuation">(</span><span class="Identifier">rangeDef</span><span class="Punctuation">)</span>
  <span class="Identifier">forStmt</span><span class="Operator">.</span><span class="Identifier">add</span><span class="Punctuation">(</span><span class="Identifier">newCall</span><span class="Punctuation">(</span><span class="Identifier">ident</span><span class="Punctuation">(</span><span class="StringLit">&quot;echo&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">newIntLitNode</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Comment"># meat of the loop</span>
  <span class="Identifier">result</span><span class="Operator">.</span><span class="Identifier">add</span><span class="Punctuation">(</span><span class="Identifier">forStmt</span><span class="Punctuation">)</span>

<span class="Identifier">genRepeatEcho</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Comment"># gives:</span>
                <span class="Comment"># 3</span>
                <span class="Comment"># 3</span>
                <span class="Comment"># 3</span></pre></p>

<h2><a class="toc-backref" id="callsslashexpressions-if-expression" href="#callsslashexpressions-if-expression">If expression</a></h2><p>The representation of the <tt class="docutils literal"><span class="pre">if</span></tt> expression is subtle, but easy to traverse.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">if</span> <span class="Identifier">cond1</span><span class="Punctuation">:</span> <span class="Identifier">expr1</span> <span class="Keyword">elif</span> <span class="Identifier">cond2</span><span class="Punctuation">:</span> <span class="Identifier">expr2</span> <span class="Keyword">else</span><span class="Punctuation">:</span> <span class="Identifier">expr3</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkIfExpr</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkElifExpr</span><span class="Punctuation">(</span><span class="Identifier">cond1</span><span class="Punctuation">,</span> <span class="Identifier">expr1</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkElifExpr</span><span class="Punctuation">(</span><span class="Identifier">cond2</span><span class="Punctuation">,</span> <span class="Identifier">expr2</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkElseExpr</span><span class="Punctuation">(</span><span class="Identifier">expr3</span><span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="callsslashexpressions-documentation-comments" href="#callsslashexpressions-documentation-comments">Documentation Comments</a></h2><p>Double-hash (<tt class="docutils literal"><span class="pre">##</span></tt>) comments in the code actually have their own format, using <tt class="docutils literal"><span class="pre">strVal</span></tt> to get and set the comment text. Single-hash (<tt class="docutils literal"><span class="pre">#</span></tt>) comments are ignored.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Comment">## This is a comment</span>
<span class="Comment">## This is part of the first comment</span>
<span class="Identifier">stmt1</span>
<span class="Comment">## Yet another</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkCommentStmt</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Comment"># only appears once for the first two lines!</span>
<span class="Identifier">stmt1</span>
<span class="Identifier">nnkCommentStmt</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Comment"># another nnkCommentStmt because there is another comment</span>
                 <span class="Comment"># (separate from the first)</span></pre></p>

<h2><a class="toc-backref" id="callsslashexpressions-pragmas" href="#callsslashexpressions-pragmas">Pragmas</a></h2><p>One of Nim's cool features is pragmas, which allow fine-tuning of various aspects of the language. They come in all types, such as adorning procs and objects, but the standalone <tt class="docutils literal"><span class="pre">emit</span></tt> pragma shows the basics with the AST.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Punctuation">{</span><span class="Operator">.</span><span class="Identifier">emit</span><span class="Punctuation">:</span> <span class="StringLit">&quot;#include &lt;stdio.h&gt;&quot;</span><span class="Operator">.</span><span class="Punctuation">}</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkPragma</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkExprColonExpr</span><span class="Punctuation">(</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;emit&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
    <span class="Identifier">nnkStrLit</span><span class="Punctuation">(</span><span class="StringLit">&quot;#include &lt;stdio.h&gt;&quot;</span><span class="Punctuation">)</span> <span class="Comment"># the &quot;argument&quot;</span>
  <span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>
<p>As many <tt class="docutils literal"><span class="pre">nnkIdent</span></tt> appear as there are pragmas between <tt class="docutils literal"><span class="pre">{..}</span></tt>. Note that the declaration of new pragmas is essentially the same:</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Punctuation">{</span><span class="Operator">.</span><span class="Identifier">pragma</span><span class="Punctuation">:</span> <span class="Identifier">cdeclRename</span><span class="Punctuation">,</span> <span class="Identifier">cdecl</span><span class="Operator">.</span><span class="Punctuation">}</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkPragma</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkExprColonExpr</span><span class="Punctuation">(</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;pragma&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Comment"># this is always first when declaring a new pragma</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;cdeclRename&quot;</span><span class="Punctuation">)</span> <span class="Comment"># the name of the pragma</span>
  <span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;cdecl&quot;</span><span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>

<h1><a class="toc-backref" id="statements" href="#statements">Statements</a></h1>
<h2><a class="toc-backref" id="statements-if-statement" href="#statements-if-statement">If statement</a></h2><p>The representation of the if statement is subtle, but easy to traverse. If there is no <tt class="docutils literal"><span class="pre">else</span></tt> branch, no <tt class="docutils literal"><span class="pre">nnkElse</span></tt> child exists.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">if</span> <span class="Identifier">cond1</span><span class="Punctuation">:</span>
  <span class="Identifier">stmt1</span>
<span class="Keyword">elif</span> <span class="Identifier">cond2</span><span class="Punctuation">:</span>
  <span class="Identifier">stmt2</span>
<span class="Keyword">elif</span> <span class="Identifier">cond3</span><span class="Punctuation">:</span>
  <span class="Identifier">stmt3</span>
<span class="Keyword">else</span><span class="Punctuation">:</span>
  <span class="Identifier">stmt4</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkIfStmt</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkElifBranch</span><span class="Punctuation">(</span><span class="Identifier">cond1</span><span class="Punctuation">,</span> <span class="Identifier">stmt1</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkElifBranch</span><span class="Punctuation">(</span><span class="Identifier">cond2</span><span class="Punctuation">,</span> <span class="Identifier">stmt2</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkElifBranch</span><span class="Punctuation">(</span><span class="Identifier">cond3</span><span class="Punctuation">,</span> <span class="Identifier">stmt3</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkElse</span><span class="Punctuation">(</span><span class="Identifier">stmt4</span><span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-when-statement" href="#statements-when-statement">When statement</a></h2><p>Like the <tt class="docutils literal"><span class="pre">if</span></tt> statement, but the root has the kind <tt class="docutils literal"><span class="pre">nnkWhenStmt</span></tt>.</p>

<h2><a class="toc-backref" id="statements-assignment" href="#statements-assignment">Assignment</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Identifier">x</span> <span class="Operator">=</span> <span class="DecNumber">42</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkAsgn</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;x&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">42</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>
<p>This is not the syntax for assignment when combined with <tt class="docutils literal"><span class="pre">var</span></tt>, <tt class="docutils literal"><span class="pre">let</span></tt>, or <tt class="docutils literal"><span class="pre">const</span></tt>.</p>

<h2><a class="toc-backref" id="statements-statement-list" href="#statements-statement-list">Statement list</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Identifier">stmt1</span>
<span class="Identifier">stmt2</span>
<span class="Identifier">stmt3</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkStmtList</span><span class="Punctuation">(</span><span class="Identifier">stmt1</span><span class="Punctuation">,</span> <span class="Identifier">stmt2</span><span class="Punctuation">,</span> <span class="Identifier">stmt3</span><span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-case-statement" href="#statements-case-statement">Case statement</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">case</span> <span class="Identifier">expr1</span>
<span class="Keyword">of</span> <span class="Identifier">expr2</span><span class="Punctuation">,</span> <span class="Identifier">expr3</span><span class="Operator">..</span><span class="Identifier">expr4</span><span class="Punctuation">:</span>
  <span class="Identifier">stmt1</span>
<span class="Keyword">of</span> <span class="Identifier">expr5</span><span class="Punctuation">:</span>
  <span class="Identifier">stmt2</span>
<span class="Keyword">elif</span> <span class="Identifier">cond1</span><span class="Punctuation">:</span>
  <span class="Identifier">stmt3</span>
<span class="Keyword">else</span><span class="Punctuation">:</span>
  <span class="Identifier">stmt4</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkCaseStmt</span><span class="Punctuation">(</span>
  <span class="Identifier">expr1</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkOfBranch</span><span class="Punctuation">(</span><span class="Identifier">expr2</span><span class="Punctuation">,</span> <span class="Identifier">nnkRange</span><span class="Punctuation">(</span><span class="Identifier">expr3</span><span class="Punctuation">,</span> <span class="Identifier">expr4</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">stmt1</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkOfBranch</span><span class="Punctuation">(</span><span class="Identifier">expr5</span><span class="Punctuation">,</span> <span class="Identifier">stmt2</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkElifBranch</span><span class="Punctuation">(</span><span class="Identifier">cond1</span><span class="Punctuation">,</span> <span class="Identifier">stmt3</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkElse</span><span class="Punctuation">(</span><span class="Identifier">stmt4</span><span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>
<p>The <tt class="docutils literal"><span class="pre">nnkElifBranch</span></tt> and <tt class="docutils literal"><span class="pre">nnkElse</span></tt> parts may be missing.</p>

<h2><a class="toc-backref" id="statements-while-statement" href="#statements-while-statement">While statement</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">while</span> <span class="Identifier">expr1</span><span class="Punctuation">:</span>
  <span class="Identifier">stmt1</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkWhileStmt</span><span class="Punctuation">(</span><span class="Identifier">expr1</span><span class="Punctuation">,</span> <span class="Identifier">stmt1</span><span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-for-statement" href="#statements-for-statement">For statement</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">for</span> <span class="Identifier">ident1</span><span class="Punctuation">,</span> <span class="Identifier">ident2</span> <span class="Keyword">in</span> <span class="Identifier">expr1</span><span class="Punctuation">:</span>
  <span class="Identifier">stmt1</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkForStmt</span><span class="Punctuation">(</span><span class="Identifier">ident1</span><span class="Punctuation">,</span> <span class="Identifier">ident2</span><span class="Punctuation">,</span> <span class="Identifier">expr1</span><span class="Punctuation">,</span> <span class="Identifier">stmt1</span><span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-try-statement" href="#statements-try-statement">Try statement</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">try</span><span class="Punctuation">:</span>
  <span class="Identifier">stmt1</span>
<span class="Keyword">except</span> <span class="Identifier">e1</span><span class="Punctuation">,</span> <span class="Identifier">e2</span><span class="Punctuation">:</span>
  <span class="Identifier">stmt2</span>
<span class="Keyword">except</span> <span class="Identifier">e3</span><span class="Punctuation">:</span>
  <span class="Identifier">stmt3</span>
<span class="Keyword">except</span><span class="Punctuation">:</span>
  <span class="Identifier">stmt4</span>
<span class="Keyword">finally</span><span class="Punctuation">:</span>
  <span class="Identifier">stmt5</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkTryStmt</span><span class="Punctuation">(</span>
  <span class="Identifier">stmt1</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkExceptBranch</span><span class="Punctuation">(</span><span class="Identifier">e1</span><span class="Punctuation">,</span> <span class="Identifier">e2</span><span class="Punctuation">,</span> <span class="Identifier">stmt2</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkExceptBranch</span><span class="Punctuation">(</span><span class="Identifier">e3</span><span class="Punctuation">,</span> <span class="Identifier">stmt3</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkExceptBranch</span><span class="Punctuation">(</span><span class="Identifier">stmt4</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkFinally</span><span class="Punctuation">(</span><span class="Identifier">stmt5</span><span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-return-statement" href="#statements-return-statement">Return statement</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">return</span> <span class="Identifier">expr1</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkReturnStmt</span><span class="Punctuation">(</span><span class="Identifier">expr1</span><span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-yield-statement" href="#statements-yield-statement">Yield statement</a></h2><p>Like <tt class="docutils literal"><span class="pre">return</span></tt>, but with <tt class="docutils literal"><span class="pre">nnkYieldStmt</span></tt> kind.</p>
<p><pre class="listing"><span class="Identifier">nnkYieldStmt</span><span class="Punctuation">(</span><span class="Identifier">expr1</span><span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-discard-statement" href="#statements-discard-statement">Discard statement</a></h2><p>Like <tt class="docutils literal"><span class="pre">return</span></tt>, but with <tt class="docutils literal"><span class="pre">nnkDiscardStmt</span></tt> kind.</p>
<p><pre class="listing"><span class="Identifier">nnkDiscardStmt</span><span class="Punctuation">(</span><span class="Identifier">expr1</span><span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-continue-statement" href="#statements-continue-statement">Continue statement</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">continue</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkContinueStmt</span><span class="Punctuation">(</span><span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-break-statement" href="#statements-break-statement">Break statement</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">break</span> <span class="Identifier">otherLocation</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkBreakStmt</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;otherLocation&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>
<p>If <tt class="docutils literal"><span class="pre">break</span></tt> is used without a jump-to location, <tt class="docutils literal"><span class="pre">nnkEmpty</span></tt> replaces <tt class="docutils literal"><span class="pre">nnkIdent</span></tt>.</p>

<h2><a class="toc-backref" id="statements-block-statement" href="#statements-block-statement">Block statement</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">block</span> <span class="Identifier">name</span><span class="Punctuation">:</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkBlockStmt</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;name&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkStmtList</span><span class="Punctuation">(</span><span class="Operator">...</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>
<p>A <tt class="docutils literal"><span class="pre">block</span></tt> doesn't need an name, in which case <tt class="docutils literal"><span class="pre">nnkEmpty</span></tt> is used.</p>

<h2><a class="toc-backref" id="statements-asm-statement" href="#statements-asm-statement">Asm statement</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">asm</span> <span class="LongStringLit">&quot;&quot;&quot;
  some asm
&quot;&quot;&quot;</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkAsmStmt</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Comment"># for pragmas</span>
  <span class="Identifier">nnkTripleStrLit</span><span class="Punctuation">(</span><span class="StringLit">&quot;some asm&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
<span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-import-section" href="#statements-import-section">Import section</a></h2><p>Nim's <tt class="docutils literal"><span class="pre">import</span></tt> statement actually takes different variations depending on what keywords are present. Let's start with the simplest form.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">import</span> <span class="Identifier">std</span><span class="Operator">/</span><span class="Identifier">math</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkImportStmt</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;math&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>
<p>With <tt class="docutils literal"><span class="pre">except</span></tt>, we get <tt class="docutils literal"><span class="pre">nnkImportExceptStmt</span></tt>.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">import</span> <span class="Identifier">std</span><span class="Operator">/</span><span class="Identifier">math</span> <span class="Keyword">except</span> <span class="Identifier">pow</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkImportExceptStmt</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;math&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;pow&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>
<p>Note that <tt class="docutils literal"><span class="pre">import std/math as m</span></tt> does not use a different node; rather, we use <tt class="docutils literal"><span class="pre">nnkImportStmt</span></tt> with <tt class="docutils literal"><span class="pre">as</span></tt> as an infix operator.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">import</span> <span class="Identifier">std</span><span class="Operator">/</span><span class="Identifier">strutils</span> <span class="Keyword">as</span> <span class="Identifier">su</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkImportStmt</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkInfix</span><span class="Punctuation">(</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;as&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;strutils&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;su&quot;</span><span class="Punctuation">)</span>
  <span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-from-statement" href="#statements-from-statement">From statement</a></h2><p>If we use <tt class="docutils literal"><span class="pre">from ... import</span></tt>, the result is different, too.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">from</span> <span class="Identifier">std</span><span class="Operator">/</span><span class="Identifier">math</span> <span class="Keyword">import</span> <span class="Identifier">pow</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkFromStmt</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;math&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;pow&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>
<p>Using <tt class="docutils literal"><span class="pre">from std/math as m import pow</span></tt> works identically to the <tt class="docutils literal"><span class="pre">as</span></tt> modifier with the <tt class="docutils literal"><span class="pre">import</span></tt> statement, but wrapped in <tt class="docutils literal"><span class="pre">nnkFromStmt</span></tt>.</p>

<h2><a class="toc-backref" id="statements-export-statement" href="#statements-export-statement">Export statement</a></h2><p>When you are making an imported module accessible by modules that import yours, the <tt class="docutils literal"><span class="pre">export</span></tt> syntax is pretty straightforward.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">export</span> <span class="Identifier">unsigned</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkExportStmt</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;unsigned&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>
<p>Similar to the <tt class="docutils literal"><span class="pre">import</span></tt> statement, the AST is different for <tt class="docutils literal"><span class="pre">export ... except</span></tt>.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">export</span> <span class="Identifier">math</span> <span class="Keyword">except</span> <span class="Identifier">pow</span> <span class="Comment"># we're going to implement our own exponentiation</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkExportExceptStmt</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;math&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;pow&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-include-statement" href="#statements-include-statement">Include statement</a></h2><p>Like a plain <tt class="docutils literal"><span class="pre">import</span></tt> statement but with <tt class="docutils literal"><span class="pre">nnkIncludeStmt</span></tt>.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">include</span> <span class="Identifier">blocks</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkIncludeStmt</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;blocks&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-var-section" href="#statements-var-section">Var section</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">var</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="DecNumber">3</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkVarSection</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdentDefs</span><span class="Punctuation">(</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;a&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
    <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Comment"># or nnkIdent(...) if the variable declares the type</span>
    <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>
<p>Note that either the second or third (or both) parameters above must exist, as the compiler needs to know the type somehow (which it can infer from the given assignment).</p>
<p>This is not the same AST for all uses of <tt class="docutils literal"><span class="pre">var</span></tt>. See <a class="reference external" href="macros.html#statements-procedure-declaration">Procedure declaration</a> for details.</p>

<h2><a class="toc-backref" id="statements-let-section" href="#statements-let-section">Let section</a></h2><p>This is equivalent to <tt class="docutils literal"><span class="pre">var</span></tt>, but with <tt class="docutils literal"><span class="pre">nnkLetSection</span></tt> rather than <tt class="docutils literal"><span class="pre">nnkVarSection</span></tt>.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">let</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="DecNumber">3</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkLetSection</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdentDefs</span><span class="Punctuation">(</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;a&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
    <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Comment"># or nnkIdent(...) for the type</span>
    <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-const-section" href="#statements-const-section">Const section</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">const</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="DecNumber">3</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkConstSection</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkConstDef</span><span class="Punctuation">(</span> <span class="Comment"># not nnkConstDefs!</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;a&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
    <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Comment"># or nnkIdent(...) if the variable declares the type</span>
    <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Comment"># required in a const declaration!</span>
  <span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-type-section" href="#statements-type-section">Type section</a></h2><p>Starting with the simplest case, a <tt class="docutils literal"><span class="pre">type</span></tt> section appears much like <tt class="docutils literal"><span class="pre">var</span></tt> and <tt class="docutils literal"><span class="pre">const</span></tt>.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">type</span> <span class="Identifier">A</span> <span class="Operator">=</span> <span class="Identifier">int</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkTypeSection</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkTypeDef</span><span class="Punctuation">(</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;A&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
    <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;int&quot;</span><span class="Punctuation">)</span>
  <span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>
<p>Declaring <tt class="docutils literal"><span class="pre">distinct</span></tt> types is similar, with the last <tt class="docutils literal"><span class="pre">nnkIdent</span></tt> wrapped in <tt class="docutils literal"><span class="pre">nnkDistinctTy</span></tt>.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">type</span> <span class="Identifier">MyInt</span> <span class="Operator">=</span> <span class="Keyword">distinct</span> <span class="Identifier">int</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Comment"># ...</span>
<span class="Identifier">nnkTypeDef</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;MyInt&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkDistinctTy</span><span class="Punctuation">(</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;int&quot;</span><span class="Punctuation">)</span>
  <span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>
<p>If a type section uses generic parameters, they are treated here:</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">type</span> <span class="Identifier">A</span><span class="Punctuation">[</span><span class="Identifier">T</span><span class="Punctuation">]</span> <span class="Operator">=</span> <span class="Identifier">expr1</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkTypeSection</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkTypeDef</span><span class="Punctuation">(</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;A&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
    <span class="Identifier">nnkGenericParams</span><span class="Punctuation">(</span>
      <span class="Identifier">nnkIdentDefs</span><span class="Punctuation">(</span>
        <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;T&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
        <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Comment"># if the type is declared with options, like</span>
                    <span class="Comment"># ``[T: SomeInteger]``, they are given here</span>
        <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
      <span class="Punctuation">)</span>
    <span class="Punctuation">)</span>
    <span class="Identifier">expr1</span><span class="Punctuation">,</span>
  <span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>
<p>Note that not all <tt class="docutils literal"><span class="pre">nnkTypeDef</span></tt> utilize <tt class="docutils literal"><span class="pre">nnkIdent</span></tt> as their parameter. One of the most common uses of type declarations is to work with objects.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">type</span> <span class="Identifier">IO</span> <span class="Operator">=</span> <span class="Keyword">object</span> <span class="Keyword">of</span> <span class="Identifier">RootObj</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Comment"># ...</span>
<span class="Identifier">nnkTypeDef</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;IO&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkObjectTy</span><span class="Punctuation">(</span>
    <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Comment"># no pragmas here</span>
    <span class="Identifier">nnkOfInherit</span><span class="Punctuation">(</span>
      <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;RootObj&quot;</span><span class="Punctuation">)</span> <span class="Comment"># inherits from RootObj</span>
    <span class="Punctuation">)</span><span class="Punctuation">,</span>
    <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
  <span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>
<p>Nim's object syntax is rich. Let's take a look at an involved example in its entirety to see some of the complexities.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">type</span> <span class="Identifier">Obj</span><span class="Punctuation">[</span><span class="Identifier">T</span><span class="Punctuation">]</span> <span class="Punctuation">{</span><span class="Operator">.</span><span class="Identifier">inheritable</span><span class="Operator">.</span><span class="Punctuation">}</span> <span class="Operator">=</span> <span class="Keyword">object</span>
  <span class="Identifier">name</span><span class="Punctuation">:</span> <span class="Identifier">string</span>
  <span class="Keyword">case</span> <span class="Identifier">isFat</span><span class="Punctuation">:</span> <span class="Identifier">bool</span>
  <span class="Keyword">of</span> <span class="Identifier">true</span><span class="Punctuation">:</span>
    <span class="Identifier">m</span><span class="Punctuation">:</span> <span class="Identifier">array</span><span class="Punctuation">[</span><span class="DecNumber">100_000</span><span class="Punctuation">,</span> <span class="Identifier">T</span><span class="Punctuation">]</span>
  <span class="Keyword">of</span> <span class="Identifier">false</span><span class="Punctuation">:</span>
    <span class="Identifier">m</span><span class="Punctuation">:</span> <span class="Identifier">array</span><span class="Punctuation">[</span><span class="DecNumber">10</span><span class="Punctuation">,</span> <span class="Identifier">T</span><span class="Punctuation">]</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Comment"># ...</span>
<span class="Identifier">nnkPragmaExpr</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;Obj&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkPragma</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;inheritable&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
<span class="Punctuation">)</span><span class="Punctuation">,</span>
<span class="Identifier">nnkGenericParams</span><span class="Punctuation">(</span>
<span class="Identifier">nnkIdentDefs</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;T&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
<span class="Punctuation">)</span><span class="Punctuation">,</span>
<span class="Identifier">nnkObjectTy</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkRecList</span><span class="Punctuation">(</span> <span class="Comment"># list of object parameters</span>
    <span class="Identifier">nnkIdentDefs</span><span class="Punctuation">(</span>
      <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;name&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
      <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;string&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
      <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
    <span class="Punctuation">)</span><span class="Punctuation">,</span>
    <span class="Identifier">nnkRecCase</span><span class="Punctuation">(</span> <span class="Comment"># case statement within object (not nnkCaseStmt)</span>
      <span class="Identifier">nnkIdentDefs</span><span class="Punctuation">(</span>
        <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;isFat&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
        <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;bool&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
        <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
      <span class="Punctuation">)</span><span class="Punctuation">,</span>
      <span class="Identifier">nnkOfBranch</span><span class="Punctuation">(</span>
        <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;true&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
        <span class="Identifier">nnkRecList</span><span class="Punctuation">(</span> <span class="Comment"># again, a list of object parameters</span>
          <span class="Identifier">nnkIdentDefs</span><span class="Punctuation">(</span>
            <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;m&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
            <span class="Identifier">nnkBracketExpr</span><span class="Punctuation">(</span>
              <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;array&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
              <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">100000</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
              <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;T&quot;</span><span class="Punctuation">)</span>
            <span class="Punctuation">)</span><span class="Punctuation">,</span>
            <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
        <span class="Punctuation">)</span>
      <span class="Punctuation">)</span><span class="Punctuation">,</span>
      <span class="Identifier">nnkOfBranch</span><span class="Punctuation">(</span>
        <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;false&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
        <span class="Identifier">nnkRecList</span><span class="Punctuation">(</span>
          <span class="Identifier">nnkIdentDefs</span><span class="Punctuation">(</span>
            <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;m&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
            <span class="Identifier">nnkBracketExpr</span><span class="Punctuation">(</span>
              <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;array&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
              <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">10</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
              <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;T&quot;</span><span class="Punctuation">)</span>
            <span class="Punctuation">)</span><span class="Punctuation">,</span>
            <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
          <span class="Punctuation">)</span>
        <span class="Punctuation">)</span>
      <span class="Punctuation">)</span>
    <span class="Punctuation">)</span>
  <span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>
<p>Using an <tt class="docutils literal"><span class="pre">enum</span></tt> is similar to using an <tt class="docutils literal"><span class="pre">object</span></tt>.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">type</span> <span class="Identifier">X</span> <span class="Operator">=</span> <span class="Keyword">enum</span>
  <span class="Identifier">First</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Comment"># ...</span>
<span class="Identifier">nnkEnumTy</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;First&quot;</span><span class="Punctuation">)</span> <span class="Comment"># you need at least one nnkIdent or the compiler complains</span>
<span class="Punctuation">)</span></pre></p>
<p>The usage of <tt class="docutils literal"><span class="pre">concept</span></tt> (experimental) is similar to objects.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">type</span> <span class="Identifier">Con</span> <span class="Operator">=</span> <span class="Keyword">concept</span> <span class="Identifier">x</span><span class="Punctuation">,</span><span class="Identifier">y</span><span class="Punctuation">,</span><span class="Identifier">z</span>
  <span class="Punctuation">(</span><span class="Identifier">x</span> <span class="Operator">&amp;</span> <span class="Identifier">y</span> <span class="Operator">&amp;</span> <span class="Identifier">z</span><span class="Punctuation">)</span> <span class="Keyword">is</span> <span class="Identifier">string</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Comment"># ...</span>
<span class="Identifier">nnkTypeClassTy</span><span class="Punctuation">(</span> <span class="Comment"># note this isn't nnkConceptTy!</span>
  <span class="Identifier">nnkArgList</span><span class="Punctuation">(</span>
    <span class="Comment"># ... idents for x, y, z</span>
  <span class="Punctuation">)</span>
  <span class="Comment"># ...</span>
<span class="Punctuation">)</span></pre></p>
<p>Static types, like <tt class="docutils literal"><span class="pre">static[int]</span></tt>, use <tt class="docutils literal"><span class="pre">nnkIdent</span></tt> wrapped in <tt class="docutils literal"><span class="pre">nnkStaticTy</span></tt>.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">type</span> <span class="Identifier">A</span><span class="Punctuation">[</span><span class="Identifier">T</span><span class="Punctuation">:</span> <span class="Keyword">static</span><span class="Punctuation">[</span><span class="Identifier">int</span><span class="Punctuation">]</span><span class="Punctuation">]</span> <span class="Operator">=</span> <span class="Keyword">object</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Comment"># ... within nnkGenericParams</span>
<span class="Identifier">nnkIdentDefs</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;T&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkStaticTy</span><span class="Punctuation">(</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;int&quot;</span><span class="Punctuation">)</span>
  <span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
<span class="Punctuation">)</span>
<span class="Comment"># ...</span></pre></p>
<p>In general, declaring types mirrors this syntax (i.e., <tt class="docutils literal"><span class="pre">nnkStaticTy</span></tt> for <tt class="docutils literal"><span class="pre">static</span></tt>, etc.). Examples follow (exceptions marked by <tt class="docutils literal"><span class="pre">*</span></tt>):</p>
<table border="1" class="docutils"><tr><th>Nim type</th><th>Corresponding AST</th></tr>
<tr><td><tt class="docutils literal"><span class="pre">static</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkStaticTy</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">tuple</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkTupleTy</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">var</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkVarTy</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">ptr</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkPtrTy</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">ref</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkRefTy</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">distinct</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkDistinctTy</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">enum</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkEnumTy</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">concept</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkTypeClassTy</span></tt>*</td></tr>
<tr><td><tt class="docutils literal"><span class="pre">array</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkBracketExpr(nnkIdent(&quot;array&quot;),...</span></tt>*</td></tr>
<tr><td><tt class="docutils literal"><span class="pre">proc</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkProcTy</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">iterator</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkIteratorTy</span></tt></td></tr>
<tr><td><tt class="docutils literal"><span class="pre">object</span></tt></td><td><tt class="docutils literal"><span class="pre">nnkObjectTy</span></tt></td></tr>
</table><p>Take special care when declaring types as <tt class="docutils literal"><span class="pre">proc</span></tt>. The behavior is similar to <tt class="docutils literal"><span class="pre">Procedure declaration</span></tt>, below, but does not treat <tt class="docutils literal"><span class="pre">nnkGenericParams</span></tt>. Generic parameters are treated in the type, not the <tt class="docutils literal"><span class="pre">proc</span></tt> itself.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">type</span> <span class="Identifier">MyProc</span><span class="Punctuation">[</span><span class="Identifier">T</span><span class="Punctuation">]</span> <span class="Operator">=</span> <span class="Keyword">proc</span><span class="Punctuation">(</span><span class="Identifier">x</span><span class="Punctuation">:</span> <span class="Identifier">T</span><span class="Punctuation">)</span> <span class="Punctuation">{</span><span class="Operator">.</span><span class="Identifier">nimcall</span><span class="Operator">.</span><span class="Punctuation">}</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Comment"># ...</span>
<span class="Identifier">nnkTypeDef</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;MyProc&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkGenericParams</span><span class="Punctuation">(</span> <span class="Comment"># here, not with the proc</span>
    <span class="Comment"># ...</span>
  <span class="Punctuation">)</span>
  <span class="Identifier">nnkProcTy</span><span class="Punctuation">(</span> <span class="Comment"># behaves like a procedure declaration from here on</span>
    <span class="Identifier">nnkFormalParams</span><span class="Punctuation">(</span>
      <span class="Comment"># ...</span>
    <span class="Punctuation">)</span><span class="Punctuation">,</span>
    <span class="Identifier">nnkPragma</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;nimcall&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
  <span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>
<p>The same syntax applies to <tt class="docutils literal"><span class="pre">iterator</span></tt> (with <tt class="docutils literal"><span class="pre">nnkIteratorTy</span></tt>), but <em>does not</em> apply to <tt class="docutils literal"><span class="pre">converter</span></tt> or <tt class="docutils literal"><span class="pre">template</span></tt>.</p>
<p>Type class versions of these nodes generally share the same node kind but without any child nodes. The <tt class="docutils literal"><span class="pre">tuple</span></tt> type class is represented by <tt class="docutils literal"><span class="pre">nnkTupleClassTy</span></tt>, while a <tt class="docutils literal"><span class="pre">proc</span></tt> or <tt class="docutils literal"><span class="pre">iterator</span></tt> type class with pragmas has an <tt class="docutils literal"><span class="pre">nnkEmpty</span></tt> node in place of the <tt class="docutils literal"><span class="pre">nnkFormalParams</span></tt> node of a concrete <tt class="docutils literal"><span class="pre">proc</span></tt> or <tt class="docutils literal"><span class="pre">iterator</span></tt> type node.</p>
<p><pre class="listing"><span class="Keyword">type</span> <span class="Identifier">TypeClass</span> <span class="Operator">=</span> <span class="Keyword">proc</span> <span class="Punctuation">{</span><span class="Operator">.</span><span class="Identifier">nimcall</span><span class="Operator">.</span><span class="Punctuation">}</span> <span class="Operator">|</span> <span class="Keyword">ref</span> <span class="Operator">|</span> <span class="Keyword">tuple</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkTypeDef</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;TypeClass&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkInfix</span><span class="Punctuation">(</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;|&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
    <span class="Identifier">nnkProcTy</span><span class="Punctuation">(</span>
      <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
      <span class="Identifier">nnkPragma</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;nimcall&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    <span class="Punctuation">)</span><span class="Punctuation">,</span>
    <span class="Identifier">nnkInfix</span><span class="Punctuation">(</span>
      <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;|&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
      <span class="Identifier">nnkRefTy</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
      <span class="Identifier">nnkTupleClassTy</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
    <span class="Punctuation">)</span>
  <span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-mixin-statement" href="#statements-mixin-statement">Mixin statement</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">mixin</span> <span class="Identifier">x</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkMixinStmt</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;x&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-bind-statement" href="#statements-bind-statement">Bind statement</a></h2><p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">bind</span> <span class="Identifier">x</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkBindStmt</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;x&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-procedure-declaration" href="#statements-procedure-declaration">Procedure declaration</a></h2><p>Let's take a look at a procedure with a lot of interesting aspects to get a feel for how procedure calls are broken down.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">proc</span> <span class="Identifier">hello</span><span class="Operator">*</span><span class="Punctuation">[</span><span class="Identifier">T</span><span class="Punctuation">:</span> <span class="Identifier">SomeInteger</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="Identifier">x</span><span class="Punctuation">:</span> <span class="Identifier">int</span> <span class="Operator">=</span> <span class="DecNumber">3</span><span class="Punctuation">,</span> <span class="Identifier">y</span><span class="Punctuation">:</span> <span class="Identifier">float32</span><span class="Punctuation">)</span><span class="Punctuation">:</span> <span class="Identifier">int</span> <span class="Punctuation">{</span><span class="Operator">.</span><span class="Identifier">inline</span><span class="Operator">.</span><span class="Punctuation">}</span> <span class="Operator">=</span> <span class="Keyword">discard</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkProcDef</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkPostfix</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;*&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;hello&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Comment"># the exported proc name</span>
  <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Comment"># patterns for term rewriting in templates and macros (not procs)</span>
  <span class="Identifier">nnkGenericParams</span><span class="Punctuation">(</span> <span class="Comment"># generic type parameters, like with type declaration</span>
    <span class="Identifier">nnkIdentDefs</span><span class="Punctuation">(</span>
      <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;T&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
      <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;SomeInteger&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
      <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
    <span class="Punctuation">)</span>
  <span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkFormalParams</span><span class="Punctuation">(</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;int&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Comment"># the first FormalParam is the return type. nnkEmpty() if there is none</span>
    <span class="Identifier">nnkIdentDefs</span><span class="Punctuation">(</span>
      <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;x&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
      <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;int&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Comment"># type type (required for procs, not for templates)</span>
      <span class="Identifier">nnkIntLit</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span> <span class="Comment"># a default value</span>
    <span class="Punctuation">)</span><span class="Punctuation">,</span>
    <span class="Identifier">nnkIdentDefs</span><span class="Punctuation">(</span>
      <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;y&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
      <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;float32&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
      <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
    <span class="Punctuation">)</span>
  <span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkPragma</span><span class="Punctuation">(</span><span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;inline&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Comment"># reserved slot for future use</span>
  <span class="Identifier">nnkStmtList</span><span class="Punctuation">(</span><span class="Identifier">nnkDiscardStmt</span><span class="Punctuation">(</span><span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Comment"># the meat of the proc</span>
<span class="Punctuation">)</span></pre></p>
<p>There is another consideration. Nim has flexible type identification for its procs. Even though <tt class="docutils literal"><span class="pre">proc(a: int, b: int)</span></tt> and <tt class="docutils literal"><span class="pre">proc(a, b: int)</span></tt> are equivalent in the code, the AST is a little different for the latter.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">proc</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Punctuation">,</span> <span class="Identifier">b</span><span class="Punctuation">:</span> <span class="Identifier">int</span><span class="Punctuation">)</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Comment"># ...AST as above...</span>
<span class="Identifier">nnkFormalParams</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Comment"># no return here</span>
  <span class="Identifier">nnkIdentDefs</span><span class="Punctuation">(</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;a&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Comment"># the first parameter</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;b&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Comment"># directly to the second parameter</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;int&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Comment"># their shared type identifier</span>
    <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Comment"># default value would go here</span>
  <span class="Punctuation">)</span>
<span class="Punctuation">)</span><span class="Punctuation">,</span>
<span class="Comment"># ...</span></pre></p>
<p>When a procedure uses the special <tt class="docutils literal"><span class="pre">var</span></tt> type return variable, the result is different from that of a var section.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">proc</span> <span class="Identifier">hello</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">:</span> <span class="Keyword">var</span> <span class="Identifier">int</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Comment"># ...</span>
<span class="Identifier">nnkFormalParams</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkVarTy</span><span class="Punctuation">(</span>
    <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;int&quot;</span><span class="Punctuation">)</span>
  <span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-iterator-declaration" href="#statements-iterator-declaration">Iterator declaration</a></h2><p>The syntax for iterators is similar to procs, but with <tt class="docutils literal"><span class="pre">nnkIteratorDef</span></tt> replacing <tt class="docutils literal"><span class="pre">nnkProcDef</span></tt>.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">iterator</span> <span class="Identifier">nonsense</span><span class="Punctuation">[</span><span class="Identifier">T</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="Identifier">x</span><span class="Punctuation">:</span> <span class="Identifier">seq</span><span class="Punctuation">[</span><span class="Identifier">T</span><span class="Punctuation">]</span><span class="Punctuation">)</span><span class="Punctuation">:</span> <span class="Identifier">float</span> <span class="Punctuation">{</span><span class="Operator">.</span><span class="Identifier">closure</span><span class="Operator">.</span><span class="Punctuation">}</span> <span class="Operator">=</span> <span class="Operator">...</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkIteratorDef</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;nonsense&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Operator">...</span>
<span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-converter-declaration" href="#statements-converter-declaration">Converter declaration</a></h2><p>A converter is similar to a proc.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">converter</span> <span class="Identifier">toBool</span><span class="Punctuation">(</span><span class="Identifier">x</span><span class="Punctuation">:</span> <span class="Identifier">float</span><span class="Punctuation">)</span><span class="Punctuation">:</span> <span class="Identifier">bool</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkConverterDef</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;toBool&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Comment"># ...</span>
<span class="Punctuation">)</span></pre></p>

<h2><a class="toc-backref" id="statements-template-declaration" href="#statements-template-declaration">Template declaration</a></h2><p>Templates (as well as macros, as we'll see) have a slightly expanded AST when compared to procs and iterators. The reason for this is <a class="reference external" href="manual.html#term-rewriting-macros">term-rewriting macros</a>. Notice the <tt class="docutils literal"><span class="pre">nnkEmpty()</span></tt> as the second argument to <tt class="docutils literal"><span class="pre">nnkProcDef</span></tt> and <tt class="docutils literal"><span class="pre">nnkIteratorDef</span></tt> above? That's where the term-rewriting macros go.</p>
<p>Concrete syntax:</p>
<p><pre class="listing"><span class="Keyword">template</span> <span class="Identifier">optOpt</span><span class="Punctuation">{</span><span class="Identifier">expr1</span><span class="Punctuation">}</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Punctuation">:</span> <span class="Identifier">int</span><span class="Punctuation">)</span><span class="Punctuation">:</span> <span class="Identifier">int</span></pre></p>
<p>AST:</p>
<p><pre class="listing"><span class="Identifier">nnkTemplateDef</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkIdent</span><span class="Punctuation">(</span><span class="StringLit">&quot;optOpt&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">nnkStmtList</span><span class="Punctuation">(</span> <span class="Comment"># instead of nnkEmpty()</span>
    <span class="Identifier">expr1</span>
  <span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Comment"># follows like a proc or iterator</span>
<span class="Punctuation">)</span></pre></p>
<p>If the template does not have types for its parameters, the type identifiers inside <tt class="docutils literal"><span class="pre">nnkFormalParams</span></tt> just becomes <tt class="docutils literal"><span class="pre">nnkEmpty</span></tt>.</p>

<h2><a class="toc-backref" id="statements-macro-declaration" href="#statements-macro-declaration">Macro declaration</a></h2><p>Macros behave like templates, but <tt class="docutils literal"><span class="pre">nnkTemplateDef</span></tt> is replaced with <tt class="docutils literal"><span class="pre">nnkMacroDef</span></tt>.</p>

<h2><a class="toc-backref" id="statements-hidden-standard-conversion" href="#statements-hidden-standard-conversion">Hidden Standard Conversion</a></h2><p><pre class="listing"><span class="Keyword">var</span> <span class="Identifier">f</span><span class="Punctuation">:</span> <span class="Identifier">float</span> <span class="Operator">=</span> <span class="DecNumber">1</span></pre></p>
<p>The type of &quot;f&quot; is <tt class="docutils literal"><span class="pre">float</span></tt> but the type of &quot;1&quot; is actually <tt class="docutils literal"><span class="pre">int</span></tt>. Inserting <tt class="docutils literal"><span class="pre">int</span></tt> into a <tt class="docutils literal"><span class="pre">float</span></tt> is a type error. Nim inserts the <tt class="docutils literal"><span class="pre">nnkHiddenStdConv</span></tt> node around the <tt class="docutils literal"><span class="pre">nnkIntLit</span></tt> node so that the new node has the correct type of <tt class="docutils literal"><span class="pre">float</span></tt>. This works for any auto converted nodes and makes the conversion explicit.</p>

<h1><a class="toc-backref" id="special-node-kinds" href="#special-node-kinds">Special node kinds</a></h1><p>There are several node kinds that are used for semantic checking or code generation. These are accessible from this module, but should not be used. Other node kinds are especially designed to make AST manipulations easier. These are explained here.</p>
<p>To be written. </p>
</p>
    <div class="section" id="6">
  <h1><a class="toc-backref" href="#6">Imports</a></h1>
  <dl class="item">
    <a class="reference external" href="since.html">since</a>, <a class="reference external" href="assertions.html">assertions</a>, <a class="reference external" href="formatfloat.html">formatfloat</a>
  </dl>
</div>
<div class="section" id="7">
  <h1><a class="toc-backref" href="#7">Types</a></h1>
  <dl class="item">
    <div id="BindSymRule">
  <dt><pre><a href="macros.html#BindSymRule"><span class="Identifier">BindSymRule</span></a> <span class="Other">=</span> <span class="Keyword">enum</span>
  <span class="Identifier">brClosed</span><span class="Other">,</span>                 <span class="Comment">## only the symbols in current scope are bound</span>
  <span class="Identifier">brOpen</span><span class="Other">,</span>                   <span class="Comment">## open for overloaded symbols, but may be a single</span>
                             <span class="Comment">## symbol if not ambiguous (the rules match that of</span>
                             <span class="Comment">## binding in generics)</span>
  <span class="Identifier">brForceOpen</span>                <span class="Comment">## same as brOpen, but it will always be open even</span>
                             <span class="Comment">## if not ambiguous (this cannot be achieved with</span>
                             <span class="Comment">## any other means in the language currently)</span></pre></dt>
  <dd>
    
    Specifies how <tt class="docutils literal"><span class="pre"><span class="Identifier">bindSym</span></span></tt> behaves. The difference between open and closed symbols can be found in <a class="reference external" href="manual.html#symbol-lookup-in-generics-open-and-closed-symbols">manual.html#symbol-lookup-in-generics-open-and-closed-symbols</a>
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L484" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L484" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="LineInfo">
  <dt><pre><a href="macros.html#LineInfo"><span class="Identifier">LineInfo</span></a> <span class="Other">=</span> <span class="Keyword">object</span>
  <span class="Identifier">filename</span><span class="Operator">*</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a>
  <span class="Identifier">line</span><span class="Operator">*</span><span class="Other">,</span> <span class="Identifier">column</span><span class="Operator">*</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a></pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L525" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L525" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="NimIdent">
  <dt><pre><a href="macros.html#NimIdent"><span class="Identifier">NimIdent</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span></span>.} <span class="Other">=</span> <span class="Keyword">object</span> <span class="Keyword">of</span> <a href="system.html#RootObj"><span class="Identifier">RootObj</span></a></pre></dt>
  <dd>
    <div class="deprecation-message">
  <b>Deprecated</b> 
</div>

    Represents a Nim identifier in the AST. <strong>Note</strong>: This is only rarely useful, for identifier construction from a string use <tt class="docutils literal"><span class="pre"><span class="RawData">ident&quot;abc&quot;</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L137" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L137" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="NimNodeKind">
  <dt><pre><a href="macros.html#NimNodeKind"><span class="Identifier">NimNodeKind</span></a> <span class="Other">=</span> <span class="Keyword">enum</span>
  <span class="Identifier">nnkNone</span><span class="Other">,</span> <span class="Identifier">nnkEmpty</span><span class="Other">,</span> <span class="Identifier">nnkIdent</span><span class="Other">,</span> <span class="Identifier">nnkSym</span><span class="Other">,</span> <span class="Identifier">nnkType</span><span class="Other">,</span> <span class="Identifier">nnkCharLit</span><span class="Other">,</span> <span class="Identifier">nnkIntLit</span><span class="Other">,</span>
  <span class="Identifier">nnkInt8Lit</span><span class="Other">,</span> <span class="Identifier">nnkInt16Lit</span><span class="Other">,</span> <span class="Identifier">nnkInt32Lit</span><span class="Other">,</span> <span class="Identifier">nnkInt64Lit</span><span class="Other">,</span> <span class="Identifier">nnkUIntLit</span><span class="Other">,</span> <span class="Identifier">nnkUInt8Lit</span><span class="Other">,</span>
  <span class="Identifier">nnkUInt16Lit</span><span class="Other">,</span> <span class="Identifier">nnkUInt32Lit</span><span class="Other">,</span> <span class="Identifier">nnkUInt64Lit</span><span class="Other">,</span> <span class="Identifier">nnkFloatLit</span><span class="Other">,</span> <span class="Identifier">nnkFloat32Lit</span><span class="Other">,</span>
  <span class="Identifier">nnkFloat64Lit</span><span class="Other">,</span> <span class="Identifier">nnkFloat128Lit</span><span class="Other">,</span> <span class="Identifier">nnkStrLit</span><span class="Other">,</span> <span class="Identifier">nnkRStrLit</span><span class="Other">,</span> <span class="Identifier">nnkTripleStrLit</span><span class="Other">,</span>
  <span class="Identifier">nnkNilLit</span><span class="Other">,</span> <span class="Identifier">nnkComesFrom</span><span class="Other">,</span> <span class="Identifier">nnkDotCall</span><span class="Other">,</span> <span class="Identifier">nnkCommand</span><span class="Other">,</span> <span class="Identifier">nnkCall</span><span class="Other">,</span> <span class="Identifier">nnkCallStrLit</span><span class="Other">,</span>
  <span class="Identifier">nnkInfix</span><span class="Other">,</span> <span class="Identifier">nnkPrefix</span><span class="Other">,</span> <span class="Identifier">nnkPostfix</span><span class="Other">,</span> <span class="Identifier">nnkHiddenCallConv</span><span class="Other">,</span> <span class="Identifier">nnkExprEqExpr</span><span class="Other">,</span>
  <span class="Identifier">nnkExprColonExpr</span><span class="Other">,</span> <span class="Identifier">nnkIdentDefs</span><span class="Other">,</span> <span class="Identifier">nnkVarTuple</span><span class="Other">,</span> <span class="Identifier">nnkPar</span><span class="Other">,</span> <span class="Identifier">nnkObjConstr</span><span class="Other">,</span> <span class="Identifier">nnkCurly</span><span class="Other">,</span>
  <span class="Identifier">nnkCurlyExpr</span><span class="Other">,</span> <span class="Identifier">nnkBracket</span><span class="Other">,</span> <span class="Identifier">nnkBracketExpr</span><span class="Other">,</span> <span class="Identifier">nnkPragmaExpr</span><span class="Other">,</span> <span class="Identifier">nnkRange</span><span class="Other">,</span> <span class="Identifier">nnkDotExpr</span><span class="Other">,</span>
  <span class="Identifier">nnkCheckedFieldExpr</span><span class="Other">,</span> <span class="Identifier">nnkDerefExpr</span><span class="Other">,</span> <span class="Identifier">nnkIfExpr</span><span class="Other">,</span> <span class="Identifier">nnkElifExpr</span><span class="Other">,</span> <span class="Identifier">nnkElseExpr</span><span class="Other">,</span>
  <span class="Identifier">nnkLambda</span><span class="Other">,</span> <span class="Identifier">nnkDo</span><span class="Other">,</span> <span class="Identifier">nnkAccQuoted</span><span class="Other">,</span> <span class="Identifier">nnkTableConstr</span><span class="Other">,</span> <span class="Identifier">nnkBind</span><span class="Other">,</span> <span class="Identifier">nnkClosedSymChoice</span><span class="Other">,</span>
  <span class="Identifier">nnkOpenSymChoice</span><span class="Other">,</span> <span class="Identifier">nnkHiddenStdConv</span><span class="Other">,</span> <span class="Identifier">nnkHiddenSubConv</span><span class="Other">,</span> <span class="Identifier">nnkConv</span><span class="Other">,</span> <span class="Identifier">nnkCast</span><span class="Other">,</span>
  <span class="Identifier">nnkStaticExpr</span><span class="Other">,</span> <span class="Identifier">nnkAddr</span><span class="Other">,</span> <span class="Identifier">nnkHiddenAddr</span><span class="Other">,</span> <span class="Identifier">nnkHiddenDeref</span><span class="Other">,</span> <span class="Identifier">nnkObjDownConv</span><span class="Other">,</span>
  <span class="Identifier">nnkObjUpConv</span><span class="Other">,</span> <span class="Identifier">nnkChckRangeF</span><span class="Other">,</span> <span class="Identifier">nnkChckRange64</span><span class="Other">,</span> <span class="Identifier">nnkChckRange</span><span class="Other">,</span> <span class="Identifier">nnkStringToCString</span><span class="Other">,</span>
  <span class="Identifier">nnkCStringToString</span><span class="Other">,</span> <span class="Identifier">nnkAsgn</span><span class="Other">,</span> <span class="Identifier">nnkFastAsgn</span><span class="Other">,</span> <span class="Identifier">nnkGenericParams</span><span class="Other">,</span> <span class="Identifier">nnkFormalParams</span><span class="Other">,</span>
  <span class="Identifier">nnkOfInherit</span><span class="Other">,</span> <span class="Identifier">nnkImportAs</span><span class="Other">,</span> <span class="Identifier">nnkProcDef</span><span class="Other">,</span> <span class="Identifier">nnkMethodDef</span><span class="Other">,</span> <span class="Identifier">nnkConverterDef</span><span class="Other">,</span>
  <span class="Identifier">nnkMacroDef</span><span class="Other">,</span> <span class="Identifier">nnkTemplateDef</span><span class="Other">,</span> <span class="Identifier">nnkIteratorDef</span><span class="Other">,</span> <span class="Identifier">nnkOfBranch</span><span class="Other">,</span> <span class="Identifier">nnkElifBranch</span><span class="Other">,</span>
  <span class="Identifier">nnkExceptBranch</span><span class="Other">,</span> <span class="Identifier">nnkElse</span><span class="Other">,</span> <span class="Identifier">nnkAsmStmt</span><span class="Other">,</span> <span class="Identifier">nnkPragma</span><span class="Other">,</span> <span class="Identifier">nnkPragmaBlock</span><span class="Other">,</span> <span class="Identifier">nnkIfStmt</span><span class="Other">,</span>
  <span class="Identifier">nnkWhenStmt</span><span class="Other">,</span> <span class="Identifier">nnkForStmt</span><span class="Other">,</span> <span class="Identifier">nnkParForStmt</span><span class="Other">,</span> <span class="Identifier">nnkWhileStmt</span><span class="Other">,</span> <span class="Identifier">nnkCaseStmt</span><span class="Other">,</span>
  <span class="Identifier">nnkTypeSection</span><span class="Other">,</span> <span class="Identifier">nnkVarSection</span><span class="Other">,</span> <span class="Identifier">nnkLetSection</span><span class="Other">,</span> <span class="Identifier">nnkConstSection</span><span class="Other">,</span> <span class="Identifier">nnkConstDef</span><span class="Other">,</span>
  <span class="Identifier">nnkTypeDef</span><span class="Other">,</span> <span class="Identifier">nnkYieldStmt</span><span class="Other">,</span> <span class="Identifier">nnkDefer</span><span class="Other">,</span> <span class="Identifier">nnkTryStmt</span><span class="Other">,</span> <span class="Identifier">nnkFinally</span><span class="Other">,</span> <span class="Identifier">nnkRaiseStmt</span><span class="Other">,</span>
  <span class="Identifier">nnkReturnStmt</span><span class="Other">,</span> <span class="Identifier">nnkBreakStmt</span><span class="Other">,</span> <span class="Identifier">nnkContinueStmt</span><span class="Other">,</span> <span class="Identifier">nnkBlockStmt</span><span class="Other">,</span> <span class="Identifier">nnkStaticStmt</span><span class="Other">,</span>
  <span class="Identifier">nnkDiscardStmt</span><span class="Other">,</span> <span class="Identifier">nnkStmtList</span><span class="Other">,</span> <span class="Identifier">nnkImportStmt</span><span class="Other">,</span> <span class="Identifier">nnkImportExceptStmt</span><span class="Other">,</span>
  <span class="Identifier">nnkExportStmt</span><span class="Other">,</span> <span class="Identifier">nnkExportExceptStmt</span><span class="Other">,</span> <span class="Identifier">nnkFromStmt</span><span class="Other">,</span> <span class="Identifier">nnkIncludeStmt</span><span class="Other">,</span> <span class="Identifier">nnkBindStmt</span><span class="Other">,</span>
  <span class="Identifier">nnkMixinStmt</span><span class="Other">,</span> <span class="Identifier">nnkUsingStmt</span><span class="Other">,</span> <span class="Identifier">nnkCommentStmt</span><span class="Other">,</span> <span class="Identifier">nnkStmtListExpr</span><span class="Other">,</span> <span class="Identifier">nnkBlockExpr</span><span class="Other">,</span>
  <span class="Identifier">nnkStmtListType</span><span class="Other">,</span> <span class="Identifier">nnkBlockType</span><span class="Other">,</span> <span class="Identifier">nnkWith</span><span class="Other">,</span> <span class="Identifier">nnkWithout</span><span class="Other">,</span> <span class="Identifier">nnkTypeOfExpr</span><span class="Other">,</span>
  <span class="Identifier">nnkObjectTy</span><span class="Other">,</span> <span class="Identifier">nnkTupleTy</span><span class="Other">,</span> <span class="Identifier">nnkTupleClassTy</span><span class="Other">,</span> <span class="Identifier">nnkTypeClassTy</span><span class="Other">,</span> <span class="Identifier">nnkStaticTy</span><span class="Other">,</span>
  <span class="Identifier">nnkRecList</span><span class="Other">,</span> <span class="Identifier">nnkRecCase</span><span class="Other">,</span> <span class="Identifier">nnkRecWhen</span><span class="Other">,</span> <span class="Identifier">nnkRefTy</span><span class="Other">,</span> <span class="Identifier">nnkPtrTy</span><span class="Other">,</span> <span class="Identifier">nnkVarTy</span><span class="Other">,</span> <span class="Identifier">nnkConstTy</span><span class="Other">,</span>
  <span class="Identifier">nnkOutTy</span><span class="Other">,</span> <span class="Identifier">nnkDistinctTy</span><span class="Other">,</span> <span class="Identifier">nnkProcTy</span><span class="Other">,</span> <span class="Identifier">nnkIteratorTy</span><span class="Other">,</span> <span class="Identifier">nnkSinkAsgn</span><span class="Other">,</span> <span class="Identifier">nnkEnumTy</span><span class="Other">,</span>
  <span class="Identifier">nnkEnumFieldDef</span><span class="Other">,</span> <span class="Identifier">nnkArgList</span><span class="Other">,</span> <span class="Identifier">nnkPattern</span><span class="Other">,</span> <span class="Identifier">nnkHiddenTryStmt</span><span class="Other">,</span> <span class="Identifier">nnkClosure</span><span class="Other">,</span>
  <span class="Identifier">nnkGotoState</span><span class="Other">,</span> <span class="Identifier">nnkState</span><span class="Other">,</span> <span class="Identifier">nnkBreakState</span><span class="Other">,</span> <span class="Identifier">nnkFuncDef</span><span class="Other">,</span> <span class="Identifier">nnkTupleConstr</span><span class="Other">,</span> <span class="Identifier">nnkError</span><span class="Other">,</span> <span class="Comment">## erroneous AST node</span>
  <span class="Identifier">nnkModuleRef</span><span class="Other">,</span> <span class="Identifier">nnkReplayAction</span><span class="Other">,</span> <span class="Identifier">nnkNilRodNode</span><span class="Other">,</span> <span class="Comment">## internal IC nodes</span>
  <span class="Identifier">nnkOpenSym</span></pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L32" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L32" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="NimNodeKinds">
  <dt><pre><a href="macros.html#NimNodeKinds"><span class="Identifier">NimNodeKinds</span></a> <span class="Other">=</span> <a href="system.html#set"><span class="Identifier">set</span></a><span class="Other">[</span><a href="macros.html#NimNodeKind"><span class="Identifier">NimNodeKind</span></a><span class="Other">]</span></pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L99" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L99" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="NimSym">
  <dt><pre><a href="macros.html#NimSym"><span class="Identifier">NimSym</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span></span>.} <span class="Other">=</span> <span class="Keyword">ref</span> <span class="Identifier">NimSymObj</span></pre></dt>
  <dd>
    <div class="deprecation-message">
  <b>Deprecated</b> 
</div>

    Represents a Nim <em>symbol</em> in the compiler; a <em>symbol</em> is a looked-up <em>ident</em>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L143" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L143" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="NimSymKind">
  <dt><pre><a href="macros.html#NimSymKind"><span class="Identifier">NimSymKind</span></a> <span class="Other">=</span> <span class="Keyword">enum</span>
  <span class="Identifier">nskUnknown</span><span class="Other">,</span> <span class="Identifier">nskConditional</span><span class="Other">,</span> <span class="Identifier">nskDynLib</span><span class="Other">,</span> <span class="Identifier">nskParam</span><span class="Other">,</span> <span class="Identifier">nskGenericParam</span><span class="Other">,</span> <span class="Identifier">nskTemp</span><span class="Other">,</span>
  <span class="Identifier">nskModule</span><span class="Other">,</span> <span class="Identifier">nskType</span><span class="Other">,</span> <span class="Identifier">nskVar</span><span class="Other">,</span> <span class="Identifier">nskLet</span><span class="Other">,</span> <span class="Identifier">nskConst</span><span class="Other">,</span> <span class="Identifier">nskResult</span><span class="Other">,</span> <span class="Identifier">nskProc</span><span class="Other">,</span> <span class="Identifier">nskFunc</span><span class="Other">,</span>
  <span class="Identifier">nskMethod</span><span class="Other">,</span> <span class="Identifier">nskIterator</span><span class="Other">,</span> <span class="Identifier">nskConverter</span><span class="Other">,</span> <span class="Identifier">nskMacro</span><span class="Other">,</span> <span class="Identifier">nskTemplate</span><span class="Other">,</span> <span class="Identifier">nskField</span><span class="Other">,</span>
  <span class="Identifier">nskEnumField</span><span class="Other">,</span> <span class="Identifier">nskForVar</span><span class="Other">,</span> <span class="Identifier">nskLabel</span><span class="Other">,</span> <span class="Identifier">nskStub</span></pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L121" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L121" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="NimTypeKind">
  <dt><pre><a href="macros.html#NimTypeKind"><span class="Identifier">NimTypeKind</span></a> <span class="Other">=</span> <span class="Keyword">enum</span>
  <span class="Identifier">ntyNone</span><span class="Other">,</span> <span class="Identifier">ntyBool</span><span class="Other">,</span> <span class="Identifier">ntyChar</span><span class="Other">,</span> <span class="Identifier">ntyEmpty</span><span class="Other">,</span> <span class="Identifier">ntyAlias</span><span class="Other">,</span> <span class="Identifier">ntyNil</span><span class="Other">,</span> <span class="Identifier">ntyExpr</span><span class="Other">,</span> <span class="Identifier">ntyStmt</span><span class="Other">,</span>
  <span class="Identifier">ntyTypeDesc</span><span class="Other">,</span> <span class="Identifier">ntyGenericInvocation</span><span class="Other">,</span> <span class="Identifier">ntyGenericBody</span><span class="Other">,</span> <span class="Identifier">ntyGenericInst</span><span class="Other">,</span>
  <span class="Identifier">ntyGenericParam</span><span class="Other">,</span> <span class="Identifier">ntyDistinct</span><span class="Other">,</span> <span class="Identifier">ntyEnum</span><span class="Other">,</span> <span class="Identifier">ntyOrdinal</span><span class="Other">,</span> <span class="Identifier">ntyArray</span><span class="Other">,</span> <span class="Identifier">ntyObject</span><span class="Other">,</span>
  <span class="Identifier">ntyTuple</span><span class="Other">,</span> <span class="Identifier">ntySet</span><span class="Other">,</span> <span class="Identifier">ntyRange</span><span class="Other">,</span> <span class="Identifier">ntyPtr</span><span class="Other">,</span> <span class="Identifier">ntyRef</span><span class="Other">,</span> <span class="Identifier">ntyVar</span><span class="Other">,</span> <span class="Identifier">ntySequence</span><span class="Other">,</span> <span class="Identifier">ntyProc</span><span class="Other">,</span>
  <span class="Identifier">ntyPointer</span><span class="Other">,</span> <span class="Identifier">ntyOpenArray</span><span class="Other">,</span> <span class="Identifier">ntyString</span><span class="Other">,</span> <span class="Identifier">ntyCString</span><span class="Other">,</span> <span class="Identifier">ntyForward</span><span class="Other">,</span> <span class="Identifier">ntyInt</span><span class="Other">,</span> <span class="Identifier">ntyInt8</span><span class="Other">,</span>
  <span class="Identifier">ntyInt16</span><span class="Other">,</span> <span class="Identifier">ntyInt32</span><span class="Other">,</span> <span class="Identifier">ntyInt64</span><span class="Other">,</span> <span class="Identifier">ntyFloat</span><span class="Other">,</span> <span class="Identifier">ntyFloat32</span><span class="Other">,</span> <span class="Identifier">ntyFloat64</span><span class="Other">,</span> <span class="Identifier">ntyFloat128</span><span class="Other">,</span>
  <span class="Identifier">ntyUInt</span><span class="Other">,</span> <span class="Identifier">ntyUInt8</span><span class="Other">,</span> <span class="Identifier">ntyUInt16</span><span class="Other">,</span> <span class="Identifier">ntyUInt32</span><span class="Other">,</span> <span class="Identifier">ntyUInt64</span><span class="Other">,</span> <span class="Identifier">ntyUnused0</span><span class="Other">,</span> <span class="Identifier">ntyUnused1</span><span class="Other">,</span>
  <span class="Identifier">ntyUnused2</span><span class="Other">,</span> <span class="Identifier">ntyVarargs</span><span class="Other">,</span> <span class="Identifier">ntyUncheckedArray</span><span class="Other">,</span> <span class="Identifier">ntyError</span><span class="Other">,</span> <span class="Identifier">ntyBuiltinTypeClass</span><span class="Other">,</span>
  <span class="Identifier">ntyUserTypeClass</span><span class="Other">,</span> <span class="Identifier">ntyUserTypeClassInst</span><span class="Other">,</span> <span class="Identifier">ntyCompositeTypeClass</span><span class="Other">,</span> <span class="Identifier">ntyInferred</span><span class="Other">,</span>
  <span class="Identifier">ntyAnd</span><span class="Other">,</span> <span class="Identifier">ntyOr</span><span class="Other">,</span> <span class="Identifier">ntyNot</span><span class="Other">,</span> <span class="Identifier">ntyAnything</span><span class="Other">,</span> <span class="Identifier">ntyStatic</span><span class="Other">,</span> <span class="Identifier">ntyFromExpr</span><span class="Other">,</span> <span class="Identifier">ntyOptDeprecated</span><span class="Other">,</span>
  <span class="Identifier">ntyVoid</span></pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L100" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L100" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="TNimSymKinds">
  <dt><pre><a href="macros.html#TNimSymKinds"><span class="Identifier">TNimSymKinds</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span></span>.} <span class="Other">=</span> <a href="system.html#set"><span class="Identifier">set</span></a><span class="Other">[</span><a href="macros.html#NimSymKind"><span class="Identifier">NimSymKind</span></a><span class="Other">]</span></pre></dt>
  <dd>
    <div class="deprecation-message">
  <b>Deprecated</b> 
</div>

    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L130" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L130" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="TNimTypeKinds">
  <dt><pre><a href="macros.html#TNimTypeKinds"><span class="Identifier">TNimTypeKinds</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span></span>.} <span class="Other">=</span> <a href="system.html#set"><span class="Identifier">set</span></a><span class="Other">[</span><a href="macros.html#NimTypeKind"><span class="Identifier">NimTypeKind</span></a><span class="Other">]</span></pre></dt>
  <dd>
    <div class="deprecation-message">
  <b>Deprecated</b> 
</div>

    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L120" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L120" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

  </dl>
</div>
<div class="section" id="10">
  <h1><a class="toc-backref" href="#10">Consts</a></h1>
  <dl class="item">
    <div id="AtomicNodes">
  <dt><pre><a href="macros.html#AtomicNodes"><span class="Identifier">AtomicNodes</span></a> <span class="Other">=</span> <span class="Other">{</span><span class="DecNumber">nnkNone</span><span class="Other">..</span><span class="DecNumber">nnkNilLit</span><span class="Other">}</span></pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1217" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1217" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="CallNodes">
  <dt><pre><a href="macros.html#CallNodes"><span class="Identifier">CallNodes</span></a> <span class="Other">=</span> <span class="Other">{</span><span class="DecNumber">nnkCall</span><span class="Other">,</span> <span class="DecNumber">nnkInfix</span><span class="Other">,</span> <span class="DecNumber">nnkPrefix</span><span class="Other">,</span> <span class="DecNumber">nnkPostfix</span><span class="Other">,</span> <span class="DecNumber">nnkCommand</span><span class="Other">,</span>
             <span class="DecNumber">nnkCallStrLit</span><span class="Other">,</span> <span class="DecNumber">nnkHiddenCallConv</span><span class="Other">}</span></pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1219" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1219" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="nnkCallKinds">
  <dt><pre><a href="macros.html#nnkCallKinds"><span class="Identifier">nnkCallKinds</span></a> <span class="Other">=</span> <span class="Other">{</span><span class="DecNumber">nnkCall</span><span class="Other">,</span> <span class="DecNumber">nnkInfix</span><span class="Other">,</span> <span class="DecNumber">nnkPrefix</span><span class="Other">,</span> <span class="DecNumber">nnkPostfix</span><span class="Other">,</span> <span class="DecNumber">nnkCommand</span><span class="Other">,</span>
                <span class="DecNumber">nnkCallStrLit</span><span class="Other">,</span> <span class="DecNumber">nnkHiddenCallConv</span><span class="Other">}</span></pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L151" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L151" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="nnkLiterals">
  <dt><pre><a href="macros.html#nnkLiterals"><span class="Identifier">nnkLiterals</span></a> <span class="Other">=</span> <span class="Other">{</span><span class="DecNumber">nnkCharLit</span><span class="Other">..</span><span class="DecNumber">nnkNilLit</span><span class="Other">}</span></pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L149" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L149" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="nnkMutableTy">
  <dt><pre><a href="macros.html#nnkMutableTy"><span class="Identifier">nnkMutableTy</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span></span>.} <span class="Other">=</span> <span class="DecNumber">nnkOutTy</span></pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L133" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L133" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="nnkSharedTy">
  <dt><pre><a href="macros.html#nnkSharedTy"><span class="Identifier">nnkSharedTy</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span></span>.} <span class="Other">=</span> <span class="DecNumber">nnkSinkAsgn</span></pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L134" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L134" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="RoutineNodes">
  <dt><pre><a href="macros.html#RoutineNodes"><span class="Identifier">RoutineNodes</span></a> <span class="Other">=</span> <span class="Other">{</span><span class="DecNumber">nnkProcDef</span><span class="Other">,</span> <span class="DecNumber">nnkFuncDef</span><span class="Other">,</span> <span class="DecNumber">nnkMethodDef</span><span class="Other">,</span> <span class="DecNumber">nnkDo</span><span class="Other">,</span> <span class="DecNumber">nnkLambda</span><span class="Other">,</span>
                <span class="DecNumber">nnkIteratorDef</span><span class="Other">,</span> <span class="DecNumber">nnkTemplateDef</span><span class="Other">,</span> <span class="DecNumber">nnkConverterDef</span><span class="Other">,</span> <span class="DecNumber">nnkMacroDef</span><span class="Other">}</span></pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1215" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1215" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

  </dl>
</div>
<div class="section" id="12">
  <h1><a class="toc-backref" href="#12">Procs</a></h1>
  <dl class="item">
    <div id="$-procs-all">
  <div id="$,LineInfo">
  <dt><pre><span class="Keyword">proc</span> <a href="#%24%2CLineInfo"><span class="Identifier">`$`</span></a><span class="Other">(</span><span class="Identifier">arg</span><span class="Other">:</span> <a href="macros.html#LineInfo"><span class="Identifier">LineInfo</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Return a string representation in the form <tt class="docutils literal"><span class="pre"><span class="Identifier">filepath</span><span class="Punctuation">(</span><span class="Identifier">line</span><span class="Punctuation">,</span> <span class="Identifier">column</span><span class="Punctuation">)</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L529" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L529" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="$,NimIdent">
  <dt><pre><span class="Keyword">proc</span> <a href="#%24%2CNimIdent"><span class="Identifier">`$`</span></a><span class="Other">(</span><span class="Identifier">i</span><span class="Other">:</span> <a href="macros.html#NimIdent"><span class="Identifier">NimIdent</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NStrVal&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since version 0.18.1; Use \'strVal\' instead.&quot;</span><span class="Other">,</span>
                                <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    <div class="deprecation-message">
  <b>Deprecated:</b> Deprecated since version 0.18.1; Use &apos;strVal&apos; instead.
</div>

    Converts a Nim identifier to a string.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L265" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L265" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="$,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#%24%2CNimNode"><span class="Identifier">`$`</span></a><span class="Other">(</span><span class="Identifier">node</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Get the string of an identifier node.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1405" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1405" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="$,NimSym">
  <dt><pre><span class="Keyword">proc</span> <a href="#%24%2CNimSym"><span class="Identifier">`$`</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="macros.html#NimSym"><span class="Identifier">NimSym</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NStrVal&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since version 0.18.1; Use \'strVal\' instead.&quot;</span><span class="Other">,</span>
                              <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    <div class="deprecation-message">
  <b>Deprecated:</b> Deprecated since version 0.18.1; Use &apos;strVal&apos; instead.
</div>

    Converts a Nim symbol to a string.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L269" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L269" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="==-procs-all">
  <div id="==,NimIdent,NimIdent">
  <dt><pre><span class="Keyword">proc</span> <a href="#%3D%3D%2CNimIdent%2CNimIdent"><span class="Identifier">`==`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="macros.html#NimIdent"><span class="Identifier">NimIdent</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;EqIdent&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since version 0.18.1; Use \'==\' on \'NimNode\' instead.&quot;</span><span class="Other">,</span>
                                  <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    <div class="deprecation-message">
  <b>Deprecated:</b> Deprecated since version 0.18.1; Use &apos;==&apos; on &apos;NimNode&apos; instead.
</div>

    Compares two Nim identifiers.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L161" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L161" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="==,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#%3D%3D%2CNimNode%2CNimNode"><span class="Identifier">`==`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;EqNimrodNode&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
                                 <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Compare two Nim nodes. Return true if nodes are structurally equivalent. This means two independently created nodes can be equal.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L165" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L165" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="==,NimSym,NimSym">
  <dt><pre><span class="Keyword">proc</span> <a href="#%3D%3D%2CNimSym%2CNimSym"><span class="Identifier">`==`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="macros.html#NimSym"><span class="Identifier">NimSym</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;EqNimrodNode&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since version 0.18.1; Use \'==(NimNode, NimNode)\' instead.&quot;</span><span class="Other">,</span>
                                <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    <div class="deprecation-message">
  <b>Deprecated:</b> Deprecated since version 0.18.1; Use &apos;==(NimNode, NimNode)&apos; instead.
</div>

    Compares two Nim symbols.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L169" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L169" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="[]-procs-all">
  <div id="[],NimNode,BackwardsIndex">
  <dt><pre><span class="Keyword">proc</span> <a href="#%5B%5D%2CNimNode%2CBackwardsIndex"><span class="Identifier">`[]`</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">i</span><span class="Other">:</span> <a href="system.html#BackwardsIndex"><span class="Identifier">BackwardsIndex</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Get <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>'s <tt class="docutils literal"><span class="pre"><span class="Identifier">i</span></span></tt>'th child.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L186" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L186" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="[],NimNode,int">
  <dt><pre><span class="Keyword">proc</span> <a href="#%5B%5D%2CNimNode%2Cint"><span class="Identifier">`[]`</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">i</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NChild&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Get <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>'s <tt class="docutils literal"><span class="pre"><span class="Identifier">i</span></span></tt>'th child.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L183" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L183" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="[],NimNode,HSlice[T: Ordinal,U: Ordinal]">
  <dt><pre><span class="Keyword">proc</span> <a href="#%5B%5D%2CNimNode%2CHSlice%5BT%3A%20Ordinal%2CU%3A%20Ordinal%5D"><span class="Identifier">`[]`</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">,</span> <span class="Identifier">U</span><span class="Other">:</span> <a href="system.html#Ordinal"><span class="Identifier">Ordinal</span></a><span class="Other">]</span><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">x</span><span class="Other">:</span> <a href="system.html#HSlice"><span class="Identifier">HSlice</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">,</span> <span class="Identifier">U</span><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#seq"><span class="Identifier">seq</span></a><span class="Other">[</span><a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">]</span></pre></dt>
  <dd>
    
    Slice operation for NimNode. Returns a seq of child of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> who inclusive range <tt class="docutils literal"><span class="pre"><span class="Punctuation">[</span><span class="Identifier">n</span><span class="Punctuation">[</span><span class="Identifier">x</span><span class="Operator">.</span><span class="Identifier">a</span><span class="Punctuation">]</span><span class="Punctuation">,</span> <span class="Identifier">n</span><span class="Punctuation">[</span><span class="Identifier">x</span><span class="Operator">.</span><span class="Identifier">b</span><span class="Punctuation">]</span><span class="Punctuation">]</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L192" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L192" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="[]=-procs-all">
  <div id="[]=,NimNode,BackwardsIndex,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#%5B%5D%3D%2CNimNode%2CBackwardsIndex%2CNimNode"><span class="Identifier">`[]=`</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">i</span><span class="Other">:</span> <a href="system.html#BackwardsIndex"><span class="Identifier">BackwardsIndex</span></a><span class="Other">;</span> <span class="Identifier">child</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Set <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>'s <tt class="docutils literal"><span class="pre"><span class="Identifier">i</span></span></tt>'th child to <tt class="docutils literal"><span class="pre"><span class="Identifier">child</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L205" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L205" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="[]=,NimNode,int,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#%5B%5D%3D%2CNimNode%2Cint%2CNimNode"><span class="Identifier">`[]=`</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">i</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">;</span> <span class="Identifier">child</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NSetChild&quot;</span><span class="Other">,</span>
    <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Set <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>'s <tt class="docutils literal"><span class="pre"><span class="Identifier">i</span></span></tt>'th child to <tt class="docutils literal"><span class="pre"><span class="Identifier">child</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L201" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L201" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="add-procs-all">
  <div id="add,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#add%2CNimNode%2CNimNode"><span class="Identifier">add</span></a><span class="Other">(</span><span class="Identifier">father</span><span class="Other">,</span> <span class="Identifier">child</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NAdd&quot;</span><span class="Other">,</span> <span class="Identifier">discardable</span><span class="Other">,</span>
    <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Adds the <tt class="docutils literal"><span class="pre"><span class="Identifier">child</span></span></tt> to the <tt class="docutils literal"><span class="pre"><span class="Identifier">father</span></span></tt> node. Returns the father node so that calls can be nested.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L223" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L223" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="add,NimNode,varargs[NimNode]">
  <dt><pre><span class="Keyword">proc</span> <a href="#add%2CNimNode%2Cvarargs%5BNimNode%5D"><span class="Identifier">add</span></a><span class="Other">(</span><span class="Identifier">father</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">children</span><span class="Other">:</span> <a href="system.html#varargs"><span class="Identifier">varargs</span></a><span class="Other">[</span><a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.
    <span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NAddMultiple&quot;</span><span class="Other">,</span> <span class="Identifier">discardable</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Adds each child of <tt class="docutils literal"><span class="pre"><span class="Identifier">children</span></span></tt> to the <tt class="docutils literal"><span class="pre"><span class="Identifier">father</span></span></tt> node. Returns the <tt class="docutils literal"><span class="pre"><span class="Identifier">father</span></span></tt> node so that calls can be nested.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L228" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L228" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="addIdentIfAbsent-procs-all">
  <div id="addIdentIfAbsent,NimNode,string">
  <dt><pre><span class="Keyword">proc</span> <a href="#addIdentIfAbsent%2CNimNode%2Cstring"><span class="Identifier">addIdentIfAbsent</span></a><span class="Other">(</span><span class="Identifier">dest</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">ident</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Add <tt class="docutils literal"><span class="pre"><span class="Identifier">ident</span></span></tt> to <tt class="docutils literal"><span class="pre"><span class="Identifier">dest</span></span></tt> if it is not present. This is intended for use with pragmas.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1518" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1518" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="addPragma-procs-all">
  <div id="addPragma,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#addPragma%2CNimNode%2CNimNode"><span class="Identifier">addPragma</span></a><span class="Other">(</span><span class="Identifier">someProc</span><span class="Other">,</span> <span class="Identifier">pragma</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Adds pragma to routine definition.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1361" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1361" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="astGenRepr-procs-all">
  <div id="astGenRepr,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#astGenRepr%2CNimNode"><span class="Identifier">astGenRepr</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    <p>Convert the AST <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> to the code required to generate that AST.</p>
<p>See also <a class="reference external" href="./system.html#repr,HSlice[T,U]">system: repr</a>, <a class="reference internal nimdoc" title="proc treeRepr(n: NimNode): string" href="#treeRepr,NimNode">treeRepr</a>, and <a class="reference internal nimdoc" title="proc lispRepr(n: NimNode; indented = false): string" href="#lispRepr,NimNode">lispRepr</a>.</p>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L999" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L999" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="basename-procs-all">
  <div id="basename,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#basename%2CNimNode"><span class="Identifier">basename</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Pull an identifier from prefix/postfix expressions.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1395" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1395" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="basename=-procs-all">
  <div id="basename=,NimNode,string">
  <dt><pre><span class="Keyword">proc</span> <a href="#basename%3D%2CNimNode%2Cstring"><span class="Identifier">basename=</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">val</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1465" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1465" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="bindSym-procs-all">
  <div id="bindSym,,BindSymRule">
  <dt><pre><span class="Keyword">proc</span> <a href="#bindSym%2C%2CBindSymRule"><span class="Identifier">bindSym</span></a><span class="Other">(</span><span class="Identifier">ident</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> <span class="Operator">|</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">rule</span><span class="Other">:</span> <a href="macros.html#BindSymRule"><span class="Identifier">BindSymRule</span></a> <span class="Other">=</span> <span class="Identifier">brClosed</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.
    <span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NBindSym&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    <p>Creates a node that binds <tt class="docutils literal"><span class="pre"><span class="Identifier">ident</span></span></tt> to a symbol node. The bound symbol may be an overloaded symbol. if <tt class="docutils literal"><span class="pre"><span class="Identifier">ident</span></span></tt> is a NimNode, it must have <tt class="docutils literal"><span class="pre"><span class="Identifier">nnkIdent</span></span></tt> kind. If <tt class="docutils literal"><span class="pre"><span class="Identifier">rule</span> <span class="Operator">==</span> <span class="Identifier">brClosed</span></span></tt> either an <tt class="docutils literal"><span class="pre"><span class="Identifier">nnkClosedSymChoice</span></span></tt> tree is returned or <tt class="docutils literal"><span class="pre"><span class="Identifier">nnkSym</span></span></tt> if the symbol is not ambiguous. If <tt class="docutils literal"><span class="pre"><span class="Identifier">rule</span> <span class="Operator">==</span> <span class="Identifier">brOpen</span></span></tt> either an <tt class="docutils literal"><span class="pre"><span class="Identifier">nnkOpenSymChoice</span></span></tt> tree is returned or <tt class="docutils literal"><span class="pre"><span class="Identifier">nnkSym</span></span></tt> if the symbol is not ambiguous. If <tt class="docutils literal"><span class="pre"><span class="Identifier">rule</span> <span class="Operator">==</span> <span class="Identifier">brForceOpen</span></span></tt> always an <tt class="docutils literal"><span class="pre"><span class="Identifier">nnkOpenSymChoice</span></span></tt> tree is returned even if the symbol is not ambiguous.</p>
<p>See the <a class="reference external" href="manual.html#macros-bindsym">manual</a> for more details.</p>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L495" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L495" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="body-procs-all">
  <div id="body,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#body%2CNimNode"><span class="Identifier">body</span></a><span class="Other">(</span><span class="Identifier">someProc</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1373" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1373" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="body=-procs-all">
  <div id="body=,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#body%3D%2CNimNode%2CNimNode"><span class="Identifier">body=</span></a><span class="Other">(</span><span class="Identifier">someProc</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">val</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1384" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1384" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="boolVal-procs-all">
  <div id="boolVal,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#boolVal%2CNimNode"><span class="Identifier">boolVal</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1530" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1530" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="callsite-procs-all">
  <div id="callsite">
  <dt><pre><span class="Keyword">proc</span> <a href="#callsite"><span class="Identifier">callsite</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NCallSite&quot;</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since v0.18.1; use `varargs[untyped]` in the macro prototype instead&quot;</span><span class="Other">,</span>
                           <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    <div class="deprecation-message">
  <b>Deprecated:</b> Deprecated since v0.18.1; use `varargs[untyped]` in the macro prototype instead
</div>

    Returns the AST of the invocation expression that invoked this macro.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L514" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L514" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="copy-procs-all">
  <div id="copy,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#copy%2CNimNode"><span class="Identifier">copy</span></a><span class="Other">(</span><span class="Identifier">node</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    An alias for <a class="reference external" href="#copyNimTree,NimNode">copyNimTree</a>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1498" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1498" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="copyChildrenTo-procs-all">
  <div id="copyChildrenTo,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#copyChildrenTo%2CNimNode%2CNimNode"><span class="Identifier">copyChildrenTo</span></a><span class="Other">(</span><span class="Identifier">src</span><span class="Other">,</span> <span class="Identifier">dest</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Copy all children from <tt class="docutils literal"><span class="pre"><span class="Identifier">src</span></span></tt> to <tt class="docutils literal"><span class="pre"><span class="Identifier">dest</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1304" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1304" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="copyLineInfo-procs-all">
  <div id="copyLineInfo,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#copyLineInfo%2CNimNode%2CNimNode"><span class="Identifier">copyLineInfo</span></a><span class="Other">(</span><span class="Identifier">arg</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">info</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NLineInfo&quot;</span><span class="Other">,</span>
    <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Copy lineinfo from <tt class="docutils literal"><span class="pre"><span class="Identifier">info</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L542" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L542" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="copyNimNode-procs-all">
  <div id="copyNimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#copyNimNode%2CNimNode"><span class="Identifier">copyNimNode</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NCopyNimNode&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
                                        <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Creates a new AST node by copying the node <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>. Note that unlike <tt class="docutils literal"><span class="pre"><span class="Identifier">copyNimTree</span></span></tt>, child nodes of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> are not copied.
<p><strong class="examples_text">Example:</strong></p>
<pre class="listing"><span class="Keyword">macro</span> <span class="Identifier">foo</span><span class="Punctuation">(</span><span class="Identifier">x</span><span class="Punctuation">:</span> <span class="Identifier">typed</span><span class="Punctuation">)</span> <span class="Operator">=</span>
  <span class="Keyword">var</span> <span class="Identifier">s</span> <span class="Operator">=</span> <span class="Identifier">copyNimNode</span><span class="Punctuation">(</span><span class="Identifier">x</span><span class="Punctuation">)</span>
  <span class="Identifier">doAssert</span> <span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">len</span> <span class="Operator">==</span> <span class="DecNumber">0</span>
  <span class="Identifier">doAssert</span> <span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">kind</span> <span class="Operator">==</span> <span class="Identifier">nnkStmtList</span>

<span class="Identifier">foo</span><span class="Punctuation">:</span>
  <span class="Keyword">let</span> <span class="Identifier">x</span> <span class="Operator">=</span> <span class="DecNumber">12</span>
  <span class="Identifier">echo</span> <span class="Identifier">x</span></pre>
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L405" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L405" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="copyNimTree-procs-all">
  <div id="copyNimTree,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#copyNimTree%2CNimNode"><span class="Identifier">copyNimTree</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NCopyNimTree&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
                                        <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Creates a new AST node by recursively copying the node <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>. Note that unlike <tt class="docutils literal"><span class="pre"><span class="Identifier">copyNimNode</span></span></tt>, this copies <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>, the children of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>, etc.
<p><strong class="examples_text">Example:</strong></p>
<pre class="listing"><span class="Keyword">macro</span> <span class="Identifier">foo</span><span class="Punctuation">(</span><span class="Identifier">x</span><span class="Punctuation">:</span> <span class="Identifier">typed</span><span class="Punctuation">)</span> <span class="Operator">=</span>
  <span class="Keyword">var</span> <span class="Identifier">s</span> <span class="Operator">=</span> <span class="Identifier">copyNimTree</span><span class="Punctuation">(</span><span class="Identifier">x</span><span class="Punctuation">)</span>
  <span class="Identifier">doAssert</span> <span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">len</span> <span class="Operator">==</span> <span class="DecNumber">2</span>
  <span class="Identifier">doAssert</span> <span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">kind</span> <span class="Operator">==</span> <span class="Identifier">nnkStmtList</span>

<span class="Identifier">foo</span><span class="Punctuation">:</span>
  <span class="Keyword">let</span> <span class="Identifier">x</span> <span class="Operator">=</span> <span class="DecNumber">12</span>
  <span class="Identifier">echo</span> <span class="Identifier">x</span></pre>
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L418" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L418" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="del-procs-all">
  <div id="del,NimNode,int,int">
  <dt><pre><span class="Keyword">proc</span> <a href="#del%2CNimNode%2Cint%2Cint"><span class="Identifier">del</span></a><span class="Other">(</span><span class="Identifier">father</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">idx</span> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span> <span class="Identifier">n</span> <span class="Other">=</span> <span class="DecNumber">1</span><span class="Other">)</span> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NDel&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Deletes <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> children of <tt class="docutils literal"><span class="pre"><span class="Identifier">father</span></span></tt> starting at index <tt class="docutils literal"><span class="pre"><span class="Identifier">idx</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L233" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L233" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="eqIdent-procs-all">
  <div id="eqIdent,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#eqIdent%2CNimNode%2CNimNode"><span class="Identifier">eqIdent</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;EqIdent&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Style insensitive comparison.  <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="Identifier">b</span></span></tt> can be an identifier or a symbol. Both may be wrapped in an export marker (<tt class="docutils literal"><span class="pre"><span class="Identifier">nnkPostfix</span></span></tt>) or quoted with backticks (<tt class="docutils literal"><span class="pre"><span class="Identifier">nnkAccQuoted</span></span></tt>), these nodes will be unwrapped.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L928" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L928" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="eqIdent,NimNode,string">
  <dt><pre><span class="Keyword">proc</span> <a href="#eqIdent%2CNimNode%2Cstring"><span class="Identifier">eqIdent</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;EqIdent&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Style insensitive comparison.  <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span></span></tt> can be an identifier or a symbol. <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span></span></tt> may be wrapped in an export marker (<tt class="docutils literal"><span class="pre"><span class="Identifier">nnkPostfix</span></span></tt>) or quoted with backticks (<tt class="docutils literal"><span class="pre"><span class="Identifier">nnkAccQuoted</span></span></tt>), these nodes will be unwrapped.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L916" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L916" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="eqIdent,string,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#eqIdent%2Cstring%2CNimNode"><span class="Identifier">eqIdent</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;EqIdent&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Style insensitive comparison.  <tt class="docutils literal"><span class="pre"><span class="Identifier">b</span></span></tt> can be an identifier or a symbol. <tt class="docutils literal"><span class="pre"><span class="Identifier">b</span></span></tt> may be wrapped in an export marker (<tt class="docutils literal"><span class="pre"><span class="Identifier">nnkPostfix</span></span></tt>) or quoted with backticks (<tt class="docutils literal"><span class="pre"><span class="Identifier">nnkAccQuoted</span></span></tt>), these nodes will be unwrapped.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L922" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L922" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="eqIdent,string,string">
  <dt><pre><span class="Keyword">proc</span> <a href="#eqIdent%2Cstring%2Cstring"><span class="Identifier">eqIdent</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;EqIdent&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Style insensitive comparison.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L913" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L913" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="error-procs-all">
  <div id="error,string,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#error%2Cstring%2CNimNode"><span class="Identifier">error</span></a><span class="Other">(</span><span class="Identifier">msg</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> <span class="Other">=</span> <span class="Keyword">nil</span><span class="Other">)</span> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NError&quot;</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> </span><span class="Identifier">noreturn</span><span class="Other">,</span>
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Writes an error message at compile time. The optional <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span><span class="Punctuation">:</span> <span class="Identifier">NimNode</span></span></tt> parameter is used as the source for file and line number information in the compilation error message.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L436" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L436" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="expectIdent-procs-all">
  <div id="expectIdent,NimNode,string">
  <dt><pre><span class="Keyword">proc</span> <a href="#expectIdent%2CNimNode%2Cstring"><span class="Identifier">expectIdent</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">name</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Check that <tt class="docutils literal"><span class="pre"><span class="Identifier">eqIdent</span><span class="Punctuation">(</span><span class="Identifier">n</span><span class="Punctuation">,</span><span class="Identifier">name</span><span class="Punctuation">)</span></span></tt> holds true. If this is not the case, compilation aborts with an error message. This is useful for writing macros that check the AST that is passed to them.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1502" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1502" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="expectKind-procs-all">
  <div id="expectKind,NimNode,NimNodeKind">
  <dt><pre><span class="Keyword">proc</span> <a href="#expectKind%2CNimNode%2CNimNodeKind"><span class="Identifier">expectKind</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">k</span><span class="Other">:</span> <a href="macros.html#NimNodeKind"><span class="Identifier">NimNodeKind</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Checks that <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> is of kind <tt class="docutils literal"><span class="pre"><span class="Identifier">k</span></span></tt>. If this is not the case, compilation aborts with an error message. This is useful for writing macros that check the AST that is passed to them.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L687" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L687" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="expectKind,NimNode,set[NimNodeKind]">
  <dt><pre><span class="Keyword">proc</span> <a href="#expectKind%2CNimNode%2Cset%5BNimNodeKind%5D"><span class="Identifier">expectKind</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">k</span><span class="Other">:</span> <a href="system.html#set"><span class="Identifier">set</span></a><span class="Other">[</span><a href="macros.html#NimNodeKind"><span class="Identifier">NimNodeKind</span></a><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Checks that <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> is of kind <tt class="docutils literal"><span class="pre"><span class="Identifier">k</span></span></tt>. If this is not the case, compilation aborts with an error message. This is useful for writing macros that check the AST that is passed to them.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1221" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1221" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="expectLen-procs-all">
  <div id="expectLen,NimNode,int">
  <dt><pre><span class="Keyword">proc</span> <a href="#expectLen%2CNimNode%2Cint"><span class="Identifier">expectLen</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">len</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Checks that <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> has exactly <tt class="docutils literal"><span class="pre"><span class="Identifier">len</span></span></tt> children. If this is not the case, compilation aborts with an error message. This is useful for writing macros that check its number of arguments.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L699" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L699" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="expectLen,NimNode,int,int">
  <dt><pre><span class="Keyword">proc</span> <a href="#expectLen%2CNimNode%2Cint%2Cint"><span class="Identifier">expectLen</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">min</span><span class="Other">,</span> <span class="Identifier">max</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Checks that <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> has a number of children in the range <tt class="docutils literal"><span class="pre"><span class="Identifier">min</span><span class="Operator">..</span><span class="Identifier">max</span></span></tt>. If this is not the case, compilation aborts with an error message. This is useful for writing macros that check its number of arguments.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L705" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L705" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="expectMinLen-procs-all">
  <div id="expectMinLen,NimNode,int">
  <dt><pre><span class="Keyword">proc</span> <a href="#expectMinLen%2CNimNode%2Cint"><span class="Identifier">expectMinLen</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">min</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Checks that <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> has at least <tt class="docutils literal"><span class="pre"><span class="Identifier">min</span></span></tt> children. If this is not the case, compilation aborts with an error message. This is useful for writing macros that check its number of arguments.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L693" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L693" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="extractDocCommentsAndRunnables-procs-all">
  <div id="extractDocCommentsAndRunnables,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#extractDocCommentsAndRunnables%2CNimNode"><span class="Identifier">extractDocCommentsAndRunnables</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    <p>returns a <tt class="docutils literal"><span class="pre"><span class="Identifier">nnkStmtList</span></span></tt> containing the top-level doc comments and runnableExamples in <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span></span></tt>, stopping at the first child that is neither. Example:</p>
<p><pre class="listing"><span class="Keyword">import</span> <span class="Identifier">std</span><span class="Operator">/</span><span class="Identifier">macros</span>
<span class="Keyword">macro</span> <span class="Identifier">transf</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Punctuation">)</span><span class="Punctuation">:</span> <span class="Identifier">untyped</span> <span class="Operator">=</span>
  <span class="Identifier">result</span> <span class="Operator">=</span> <span class="Identifier">quote</span> <span class="Keyword">do</span><span class="Punctuation">:</span>
    <span class="Keyword">proc</span> <span class="Identifier">fun2</span><span class="Operator">*</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">=</span> <span class="Keyword">discard</span>
  <span class="Keyword">let</span> <span class="Identifier">header</span> <span class="Operator">=</span> <span class="Identifier">extractDocCommentsAndRunnables</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">body</span><span class="Punctuation">)</span>
  <span class="Comment"># correct usage: rest is appended</span>
  <span class="Identifier">result</span><span class="Operator">.</span><span class="Identifier">body</span> <span class="Operator">=</span> <span class="Identifier">header</span>
  <span class="Identifier">result</span><span class="Operator">.</span><span class="Identifier">body</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">quote</span> <span class="Keyword">do</span><span class="Punctuation">:</span> <span class="Keyword">discard</span> <span class="Comment"># just an example</span>
  <span class="Comment"># incorrect usage: nesting inside a nnkStmtList:</span>
  <span class="Comment"># result.body = quote do: (`header`; discard)</span>

<span class="Keyword">proc</span> <span class="Identifier">fun</span><span class="Operator">*</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Punctuation">{</span><span class="Operator">.</span><span class="Identifier">transf</span><span class="Operator">.</span><span class="Punctuation">}</span> <span class="Operator">=</span>
  <span class="Comment">## first comment</span>
  <span class="Identifier">runnableExamples</span><span class="Punctuation">:</span> <span class="Keyword">discard</span>
  <span class="Identifier">runnableExamples</span><span class="Punctuation">:</span> <span class="Keyword">discard</span>
  <span class="Comment">## last comment</span>
  <span class="Keyword">discard</span> <span class="Comment"># first statement after doc comments + runnableExamples</span>
  <span class="Comment">## not docgen'd</span></pre></p>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1780" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1780" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="floatVal-procs-all">
  <div id="floatVal,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#floatVal%2CNimNode"><span class="Identifier">floatVal</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="ctypes.html#BiggestFloat"><span class="Identifier">BiggestFloat</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NFloatVal&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Returns a float from any floating point literal.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L242" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L242" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="floatVal=-procs-all">
  <div id="floatVal=,NimNode,BiggestFloat">
  <dt><pre><span class="Keyword">proc</span> <a href="#floatVal%3D%2CNimNode%2CBiggestFloat"><span class="Identifier">floatVal=</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">val</span><span class="Other">:</span> <a href="ctypes.html#BiggestFloat"><span class="Identifier">BiggestFloat</span></a><span class="Other">)</span> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NSetFloatVal&quot;</span><span class="Other">,</span>
    <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L374" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L374" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="genSym-procs-all">
  <div id="genSym,NimSymKind,string">
  <dt><pre><span class="Keyword">proc</span> <a href="#genSym%2CNimSymKind%2Cstring"><span class="Identifier">genSym</span></a><span class="Other">(</span><span class="Identifier">kind</span><span class="Other">:</span> <a href="macros.html#NimSymKind"><span class="Identifier">NimSymKind</span></a> <span class="Other">=</span> <span class="Identifier">nskLet</span><span class="Other">;</span> <span class="Identifier">ident</span> <span class="Other">=</span> <span class="StringLit">&quot;&quot;</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NGenSym&quot;</span><span class="Other">,</span>
    <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Generates a fresh symbol that is guaranteed to be unique. The symbol needs to occur in a declaration context.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L509" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L509" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="getAlign-procs-all">
  <div id="getAlign,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#getAlign%2CNimNode"><span class="Identifier">getAlign</span></a><span class="Other">(</span><span class="Identifier">arg</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NSizeOf&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
                                   <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Returns the same result as <tt class="docutils literal"><span class="pre"><span class="Identifier">system</span><span class="Operator">.</span><span class="Identifier">alignof</span></span></tt> if the alignment is known by the Nim compiler. It works on <tt class="docutils literal"><span class="pre"><span class="Identifier">NimNode</span></span></tt> for use in macro context. Returns a negative value if the Nim compiler does not know the alignment.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1764" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1764" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="getAst-procs-all">
  <div id="getAst,untyped">
  <dt><pre><span class="Keyword">proc</span> <a href="#getAst%2Cuntyped"><span class="Identifier">getAst</span></a><span class="Other">(</span><span class="Identifier">macroOrTemplate</span><span class="Other">:</span> <a href="system.html#untyped"><span class="Identifier">untyped</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;ExpandToAst&quot;</span><span class="Other">,</span>
    <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    <p>Obtains the AST nodes returned from a macro or template invocation. See also <tt class="docutils literal"><span class="pre"><span class="Identifier">genasts</span><span class="Operator">.</span><span class="Identifier">genAst</span></span></tt>. Example:</p>
<p><pre class="listing"><span class="Keyword">macro</span> <span class="Identifier">FooMacro</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">=</span>
  <span class="Keyword">var</span> <span class="Identifier">ast</span> <span class="Operator">=</span> <span class="Identifier">getAst</span><span class="Punctuation">(</span><span class="Identifier">BarTemplate</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L595" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L595" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="getImpl-procs-all">
  <div id="getImpl,NimSym">
  <dt><pre><span class="Keyword">proc</span> <a href="#getImpl%2CNimSym"><span class="Identifier">getImpl</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="macros.html#NimSym"><span class="Identifier">NimSym</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;GetImpl&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;use `getImpl: NimNode -&gt; NimNode` instead&quot;</span><span class="Other">,</span>
                                   <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    <div class="deprecation-message">
  <b>Deprecated:</b> use `getImpl: NimNode -&gt; NimNode` instead
</div>

    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L263" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L263" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="getImpl,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#getImpl%2CNimNode"><span class="Identifier">getImpl</span></a><span class="Other">(</span><span class="Identifier">symbol</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;GetImpl&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Returns a copy of the declaration of a symbol or <tt class="docutils literal"><span class="pre"><span class="Keyword">nil</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L247" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L247" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="getImplTransformed-procs-all">
  <div id="getImplTransformed,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#getImplTransformed%2CNimNode"><span class="Identifier">getImplTransformed</span></a><span class="Other">(</span><span class="Identifier">symbol</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;GetImplTransf&quot;</span><span class="Other">,</span>
    <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    For a typed proc returns the AST after transformation pass; this is useful for debugging how the compiler transforms code (e.g.: <tt class="docutils literal"><span class="pre"><span class="Keyword">defer</span></span></tt>, <tt class="docutils literal"><span class="pre"><span class="Keyword">for</span></span></tt>) but note that code transformations are implementation dependent and subject to change. See an example in <tt class="docutils literal"><span class="pre"><span class="Identifier">tests</span><span class="Operator">/</span><span class="Identifier">macros</span><span class="Operator">/</span><span class="Identifier">tmacros_various</span><span class="Operator">.</span><span class="Identifier">nim</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L276" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L276" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="getOffset-procs-all">
  <div id="getOffset,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#getOffset%2CNimNode"><span class="Identifier">getOffset</span></a><span class="Other">(</span><span class="Identifier">arg</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NSizeOf&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
                                    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Returns the same result as <tt class="docutils literal"><span class="pre"><span class="Identifier">system</span><span class="Operator">.</span><span class="Identifier">offsetof</span></span></tt> if the offset is known by the Nim compiler. It expects a resolved symbol node from a field of a type. Therefore it only requires one argument instead of two. Returns a negative value if the Nim compiler does not know the offset.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1769" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1769" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="getProjectPath-procs-all">
  <div id="getProjectPath">
  <dt><pre><span class="Keyword">proc</span> <a href="#getProjectPath"><span class="Identifier">getProjectPath</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    <p>Returns the path to the currently compiling project.</p>
<p>This is not to be confused with <a class="reference external" href="system.html#currentSourcePath.t">system.currentSourcePath</a> which returns the path of the source file containing that template call.</p>
<p>For example, assume a <tt class="docutils literal"><span class="pre"><span class="Identifier">dir1</span><span class="Operator">/</span><span class="Identifier">foo</span><span class="Operator">.</span><span class="Identifier">nim</span></span></tt> that imports a <tt class="docutils literal"><span class="pre"><span class="Identifier">dir2</span><span class="Operator">/</span><span class="Identifier">bar</span><span class="Operator">.</span><span class="Identifier">nim</span></span></tt>, have the <tt class="docutils literal"><span class="pre"><span class="Identifier">bar</span><span class="Operator">.</span><span class="Identifier">nim</span></span></tt> print out both <tt class="docutils literal"><span class="pre"><span class="Identifier">getProjectPath</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="Identifier">currentSourcePath</span></span></tt> outputs.</p>
<p>Now when <tt class="docutils literal"><span class="pre"><span class="Identifier">foo</span><span class="Operator">.</span><span class="Identifier">nim</span></span></tt> is compiled, the <tt class="docutils literal"><span class="pre"><span class="Identifier">getProjectPath</span></span></tt> from <tt class="docutils literal"><span class="pre"><span class="Identifier">bar</span><span class="Operator">.</span><span class="Identifier">nim</span></span></tt> will return the <tt class="docutils literal"><span class="pre"><span class="Identifier">dir1</span><span class="Operator">/</span></span></tt> path, while the <tt class="docutils literal"><span class="pre"><span class="Identifier">currentSourcePath</span></span></tt> will return the path to the <tt class="docutils literal"><span class="pre"><span class="Identifier">bar</span><span class="Operator">.</span><span class="Identifier">nim</span></span></tt> source file.</p>
<p>Now when <tt class="docutils literal"><span class="pre"><span class="Identifier">bar</span><span class="Operator">.</span><span class="Identifier">nim</span></span></tt> is compiled directly, the <tt class="docutils literal"><span class="pre"><span class="Identifier">getProjectPath</span></span></tt> will now return the <tt class="docutils literal"><span class="pre"><span class="Identifier">dir2</span><span class="Operator">/</span></span></tt> path, and the <tt class="docutils literal"><span class="pre"><span class="Identifier">currentSourcePath</span></span></tt> will still return the same path, the path to the <tt class="docutils literal"><span class="pre"><span class="Identifier">bar</span><span class="Operator">.</span><span class="Identifier">nim</span></span></tt> source file.</p>
<p>The path returned by this proc is set at compile time.</p>
<p>See also:</p>
<ul class="simple"><li><a class="reference external" href="os.html#getCurrentDir">getCurrentDir proc</a></li>
</ul>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1735" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1735" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="getSize-procs-all">
  <div id="getSize,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#getSize%2CNimNode"><span class="Identifier">getSize</span></a><span class="Other">(</span><span class="Identifier">arg</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NSizeOf&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
                                  <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Returns the same result as <tt class="docutils literal"><span class="pre"><span class="Identifier">system</span><span class="Operator">.</span><span class="Identifier">sizeof</span></span></tt> if the size is known by the Nim compiler. Returns a negative value if the Nim compiler does not know the size.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1760" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1760" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="getType-procs-all">
  <div id="getType,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#getType%2CNimNode"><span class="Identifier">getType</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NGetType&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
                                    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    With 'getType' you can access the node's <span id="type_1">type</span>. A Nim type is mapped to a Nim AST too, so it's slightly confusing but it means the same API can be used to traverse types. Recursive types are flattened for you so there is no danger of infinite recursions during traversal. To resolve recursive types, you have to call 'getType' again. To see what kind of type it is, call <tt class="docutils literal"><span class="pre"><span class="Identifier">typeKind</span></span></tt> on getType's result.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L298" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L298" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="getType,typedesc">
  <dt><pre><span class="Keyword">proc</span> <a href="#getType%2Ctypedesc"><span class="Identifier">getType</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#typedesc"><span class="Identifier">typedesc</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NGetType&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
                                     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Version of <tt class="docutils literal"><span class="pre"><span class="Identifier">getType</span></span></tt> which takes a <tt class="docutils literal"><span class="pre"><span class="Identifier">typedesc</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L306" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L306" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="getTypeImpl-procs-all">
  <div id="getTypeImpl,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#getTypeImpl%2CNimNode"><span class="Identifier">getTypeImpl</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NGetType&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
                                        <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Returns the <span id="type_2">type</span> of a node in a form matching the implementation of the type. Any intermediate aliases are expanded to arrive at the final type implementation. You can instead use <tt class="docutils literal"><span class="pre"><span class="Identifier">getImpl</span></span></tt> on a symbol if you want to find the intermediate aliases.
<p><strong class="examples_text">Example:</strong></p>
<pre class="listing"><span class="Keyword">type</span>
  <span class="Identifier">Vec</span><span class="Punctuation">[</span><span class="Identifier">N</span><span class="Punctuation">:</span> <span class="Keyword">static</span><span class="Punctuation">[</span><span class="Identifier">int</span><span class="Punctuation">]</span><span class="Punctuation">,</span> <span class="Identifier">T</span><span class="Punctuation">]</span> <span class="Operator">=</span> <span class="Keyword">object</span>
    <span class="Identifier">arr</span><span class="Punctuation">:</span> <span class="Identifier">array</span><span class="Punctuation">[</span><span class="Identifier">N</span><span class="Punctuation">,</span> <span class="Identifier">T</span><span class="Punctuation">]</span>
  <span class="Identifier">Vec4</span><span class="Punctuation">[</span><span class="Identifier">T</span><span class="Punctuation">]</span> <span class="Operator">=</span> <span class="Identifier">Vec</span><span class="Punctuation">[</span><span class="DecNumber">4</span><span class="Punctuation">,</span> <span class="Identifier">T</span><span class="Punctuation">]</span>
  <span class="Identifier">Vec4f</span> <span class="Operator">=</span> <span class="Identifier">Vec4</span><span class="Punctuation">[</span><span class="Identifier">float32</span><span class="Punctuation">]</span>
<span class="Keyword">var</span> <span class="Identifier">a</span><span class="Punctuation">:</span> <span class="Identifier">Vec4f</span>
<span class="Keyword">var</span> <span class="Identifier">b</span><span class="Punctuation">:</span> <span class="Identifier">Vec4</span><span class="Punctuation">[</span><span class="Identifier">float32</span><span class="Punctuation">]</span>
<span class="Keyword">var</span> <span class="Identifier">c</span><span class="Punctuation">:</span> <span class="Identifier">Vec</span><span class="Punctuation">[</span><span class="DecNumber">4</span><span class="Punctuation">,</span> <span class="Identifier">float32</span><span class="Punctuation">]</span>
<span class="Keyword">macro</span> <span class="Identifier">dumpTypeImpl</span><span class="Punctuation">(</span><span class="Identifier">x</span><span class="Punctuation">:</span> <span class="Identifier">typed</span><span class="Punctuation">)</span><span class="Punctuation">:</span> <span class="Identifier">untyped</span> <span class="Operator">=</span>
  <span class="Identifier">newLit</span><span class="Punctuation">(</span><span class="Identifier">x</span><span class="Operator">.</span><span class="Identifier">getTypeImpl</span><span class="Operator">.</span><span class="Identifier">repr</span><span class="Punctuation">)</span>
<span class="Keyword">let</span> <span class="Identifier">t</span> <span class="Operator">=</span> <span class="LongStringLit">&quot;&quot;&quot;
object
  arr: array[0 .. 3, float32]&quot;&quot;&quot;</span>
<span class="Identifier">doAssert</span><span class="Punctuation">(</span><span class="Identifier">dumpTypeImpl</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">t</span><span class="Punctuation">)</span>
<span class="Identifier">doAssert</span><span class="Punctuation">(</span><span class="Identifier">dumpTypeImpl</span><span class="Punctuation">(</span><span class="Identifier">b</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">t</span><span class="Punctuation">)</span>
<span class="Identifier">doAssert</span><span class="Punctuation">(</span><span class="Identifier">dumpTypeImpl</span><span class="Punctuation">(</span><span class="Identifier">c</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">t</span><span class="Punctuation">)</span></pre>
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L334" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L334" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="getTypeImpl,typedesc">
  <dt><pre><span class="Keyword">proc</span> <a href="#getTypeImpl%2Ctypedesc"><span class="Identifier">getTypeImpl</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#typedesc"><span class="Identifier">typedesc</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NGetType&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Version of <tt class="docutils literal"><span class="pre"><span class="Identifier">getTypeImpl</span></span></tt> which takes a <tt class="docutils literal"><span class="pre"><span class="Identifier">typedesc</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L370" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L370" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="getTypeInst-procs-all">
  <div id="getTypeInst,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#getTypeInst%2CNimNode"><span class="Identifier">getTypeInst</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NGetType&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
                                        <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Returns the <span id="type_3">type</span> of a node in a form matching the way the type instance was declared in the code.
<p><strong class="examples_text">Example:</strong></p>
<pre class="listing"><span class="Keyword">type</span>
  <span class="Identifier">Vec</span><span class="Punctuation">[</span><span class="Identifier">N</span><span class="Punctuation">:</span> <span class="Keyword">static</span><span class="Punctuation">[</span><span class="Identifier">int</span><span class="Punctuation">]</span><span class="Punctuation">,</span> <span class="Identifier">T</span><span class="Punctuation">]</span> <span class="Operator">=</span> <span class="Keyword">object</span>
    <span class="Identifier">arr</span><span class="Punctuation">:</span> <span class="Identifier">array</span><span class="Punctuation">[</span><span class="Identifier">N</span><span class="Punctuation">,</span> <span class="Identifier">T</span><span class="Punctuation">]</span>
  <span class="Identifier">Vec4</span><span class="Punctuation">[</span><span class="Identifier">T</span><span class="Punctuation">]</span> <span class="Operator">=</span> <span class="Identifier">Vec</span><span class="Punctuation">[</span><span class="DecNumber">4</span><span class="Punctuation">,</span> <span class="Identifier">T</span><span class="Punctuation">]</span>
  <span class="Identifier">Vec4f</span> <span class="Operator">=</span> <span class="Identifier">Vec4</span><span class="Punctuation">[</span><span class="Identifier">float32</span><span class="Punctuation">]</span>
<span class="Keyword">var</span> <span class="Identifier">a</span><span class="Punctuation">:</span> <span class="Identifier">Vec4f</span>
<span class="Keyword">var</span> <span class="Identifier">b</span><span class="Punctuation">:</span> <span class="Identifier">Vec4</span><span class="Punctuation">[</span><span class="Identifier">float32</span><span class="Punctuation">]</span>
<span class="Keyword">var</span> <span class="Identifier">c</span><span class="Punctuation">:</span> <span class="Identifier">Vec</span><span class="Punctuation">[</span><span class="DecNumber">4</span><span class="Punctuation">,</span> <span class="Identifier">float32</span><span class="Punctuation">]</span>
<span class="Keyword">macro</span> <span class="Identifier">dumpTypeInst</span><span class="Punctuation">(</span><span class="Identifier">x</span><span class="Punctuation">:</span> <span class="Identifier">typed</span><span class="Punctuation">)</span><span class="Punctuation">:</span> <span class="Identifier">untyped</span> <span class="Operator">=</span>
  <span class="Identifier">newLit</span><span class="Punctuation">(</span><span class="Identifier">x</span><span class="Operator">.</span><span class="Identifier">getTypeInst</span><span class="Operator">.</span><span class="Identifier">repr</span><span class="Punctuation">)</span>
<span class="Identifier">doAssert</span><span class="Punctuation">(</span><span class="Identifier">dumpTypeInst</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;Vec4f&quot;</span><span class="Punctuation">)</span>
<span class="Identifier">doAssert</span><span class="Punctuation">(</span><span class="Identifier">dumpTypeInst</span><span class="Punctuation">(</span><span class="Identifier">b</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;Vec4[float32]&quot;</span><span class="Punctuation">)</span>
<span class="Identifier">doAssert</span><span class="Punctuation">(</span><span class="Identifier">dumpTypeInst</span><span class="Punctuation">(</span><span class="Identifier">c</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;Vec[4, float32]&quot;</span><span class="Punctuation">)</span></pre>
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L313" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L313" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="getTypeInst,typedesc">
  <dt><pre><span class="Keyword">proc</span> <a href="#getTypeInst%2Ctypedesc"><span class="Identifier">getTypeInst</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#typedesc"><span class="Identifier">typedesc</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NGetType&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Version of <tt class="docutils literal"><span class="pre"><span class="Identifier">getTypeInst</span></span></tt> which takes a <tt class="docutils literal"><span class="pre"><span class="Identifier">typedesc</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L331" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L331" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="hasArgOfName-procs-all">
  <div id="hasArgOfName,NimNode,string">
  <dt><pre><span class="Keyword">proc</span> <a href="#hasArgOfName%2CNimNode%2Cstring"><span class="Identifier">hasArgOfName</span></a><span class="Other">(</span><span class="Identifier">params</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">name</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Search <tt class="docutils literal"><span class="pre"><span class="Identifier">nnkFormalParams</span></span></tt> for an argument.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1509" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1509" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="hint-procs-all">
  <div id="hint,string,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#hint%2Cstring%2CNimNode"><span class="Identifier">hint</span></a><span class="Other">(</span><span class="Identifier">msg</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> <span class="Other">=</span> <span class="Keyword">nil</span><span class="Other">)</span> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NHint&quot;</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Writes a hint message at compile time.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L444" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L444" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="ident-procs-all">
  <div id="ident,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#ident%2CNimNode"><span class="Identifier">ident</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="macros.html#NimIdent"><span class="Identifier">NimIdent</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NIdent&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since version 0.18.1; All functionality is defined on \'NimNode\'.&quot;</span><span class="Other">,</span>
                                   <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    <div class="deprecation-message">
  <b>Deprecated:</b> Deprecated since version 0.18.1; All functionality is defined on &apos;NimNode&apos;.
</div>

    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L257" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L257" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="ident,string">
  <dt><pre><span class="Keyword">proc</span> <a href="#ident%2Cstring"><span class="Identifier">ident</span></a><span class="Other">(</span><span class="Identifier">name</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;StrToIdent&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
                                    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Create a new ident node from a string.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L480" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L480" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="ident=-procs-all">
  <div id="ident=,NimNode,NimIdent">
  <dt><pre><span class="Keyword">proc</span> <a href="#ident%3D%2CNimNode%2CNimIdent"><span class="Identifier">ident=</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">val</span><span class="Other">:</span> <a href="macros.html#NimIdent"><span class="Identifier">NimIdent</span></a><span class="Other">)</span> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NSetIdent&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since version 0.18.1; Generate a new \'NimNode\' with \'ident(string)\' instead.&quot;</span><span class="Other">,</span>
    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    <div class="deprecation-message">
  <b>Deprecated:</b> Deprecated since version 0.18.1; Generate a new &apos;NimNode&apos; with &apos;ident(string)&apos; instead.
</div>

    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L381" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L381" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="infix-procs-all">
  <div id="infix,NimNode,string,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#infix%2CNimNode%2Cstring%2CNimNode"><span class="Identifier">infix</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">op</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1482" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1482" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="insert-procs-all">
  <div id="insert,NimNode,int,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#insert%2CNimNode%2Cint%2CNimNode"><span class="Identifier">insert</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">pos</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Insert node <tt class="docutils literal"><span class="pre"><span class="Identifier">b</span></span></tt> into node <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span></span></tt> at <tt class="docutils literal"><span class="pre"><span class="Identifier">pos</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1450" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1450" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="internalErrorFlag-procs-all">
  <div id="internalErrorFlag">
  <dt><pre><span class="Keyword">proc</span> <a href="#internalErrorFlag"><span class="Identifier">internalErrorFlag</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NError&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
                                   <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Some builtins set an error flag. This is then turned into a proper exception. <strong>Note</strong>: Ordinary application code should not call this.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L575" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L575" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="intVal-procs-all">
  <div id="intVal,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#intVal%2CNimNode"><span class="Identifier">intVal</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="ctypes.html#BiggestInt"><span class="Identifier">BiggestInt</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NIntVal&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
                                      <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Returns an integer value from any integer literal or enum field symbol.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L239" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L239" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="intVal=-procs-all">
  <div id="intVal=,NimNode,BiggestInt">
  <dt><pre><span class="Keyword">proc</span> <a href="#intVal%3D%2CNimNode%2CBiggestInt"><span class="Identifier">intVal=</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">val</span><span class="Other">:</span> <a href="ctypes.html#BiggestInt"><span class="Identifier">BiggestInt</span></a><span class="Other">)</span> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NSetIntVal&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L373" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L373" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="isExported-procs-all">
  <div id="isExported,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#isExported%2CNimNode"><span class="Identifier">isExported</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
                                    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Returns whether the symbol is exported or not.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1776" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1776" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="isInstantiationOf-procs-all">
  <div id="isInstantiationOf,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#isInstantiationOf%2CNimNode%2CNimNode"><span class="Identifier">isInstantiationOf</span></a><span class="Other">(</span><span class="Identifier">instanceProcSym</span><span class="Other">,</span> <span class="Identifier">genProcSym</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.
    <span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;SymIsInstantiationOf&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Checks if a proc symbol is an instance of the generic proc symbol. Useful to check proc symbols against generic symbols returned by <tt class="docutils literal"><span class="pre"><span class="Identifier">bindSym</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L293" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L293" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="kind-procs-all">
  <div id="kind,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#kind%2CNimNode"><span class="Identifier">kind</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="macros.html#NimNodeKind"><span class="Identifier">NimNodeKind</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NKind&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
                                     <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Returns the <tt class="docutils literal"><span class="pre"><span class="Identifier">kind</span></span></tt> of the node <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L236" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L236" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="last-procs-all">
  <div id="last,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#last%2CNimNode"><span class="Identifier">last</span></a><span class="Other">(</span><span class="Identifier">node</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Return the last item in nodes children. Same as <tt class="docutils literal"><span class="pre"><span class="Identifier">node</span><span class="Punctuation">[</span><span class="Operator">^</span><span class="DecNumber">1</span><span class="Punctuation">]</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1210" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1210" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="len-procs-all">
  <div id="len,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#len%2CNimNode"><span class="Identifier">len</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NLen&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
                            <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Returns the number of children of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L180" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L180" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="lineInfo-procs-all">
  <div id="lineInfo,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#lineInfo%2CNimNode"><span class="Identifier">lineInfo</span></a><span class="Other">(</span><span class="Identifier">arg</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Return line info in the form <tt class="docutils literal"><span class="pre"><span class="Identifier">filepath</span><span class="Punctuation">(</span><span class="Identifier">line</span><span class="Punctuation">,</span> <span class="Identifier">column</span><span class="Punctuation">)</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L565" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L565" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="lineInfoObj-procs-all">
  <div id="lineInfoObj,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#lineInfoObj%2CNimNode"><span class="Identifier">lineInfoObj</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="macros.html#LineInfo"><span class="Identifier">LineInfo</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Returns <tt class="docutils literal"><span class="pre"><span class="Identifier">LineInfo</span></span></tt> of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>, using absolute path for <tt class="docutils literal"><span class="pre"><span class="Identifier">filename</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L561" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L561" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="lispRepr-procs-all">
  <div id="lispRepr,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#lispRepr%2CNimNode"><span class="Identifier">lispRepr</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">indented</span> <span class="Other">=</span> <span class="Identifier">false</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    <p>Convert the AST <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> to a human-readable lisp-like string.</p>
<p>See also <tt class="docutils literal"><span class="pre"><span class="Identifier">repr</span></span></tt>, <a class="reference internal nimdoc" title="proc treeRepr(n: NimNode): string" href="#treeRepr,NimNode">treeRepr</a>, and <a class="reference internal nimdoc" title="proc astGenRepr(n: NimNode): string" href="#astGenRepr,NimNode">astGenRepr</a>.</p>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L992" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L992" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="name-procs-all">
  <div id="name,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#name%2CNimNode"><span class="Identifier">name</span></a><span class="Other">(</span><span class="Identifier">someProc</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1312" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1312" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="name=-procs-all">
  <div id="name=,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#name%3D%2CNimNode%2CNimNode"><span class="Identifier">name=</span></a><span class="Other">(</span><span class="Identifier">someProc</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">val</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1323" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1323" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="nestList-procs-all">
  <div id="nestList,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#nestList%2CNimNode%2CNimNode"><span class="Identifier">nestList</span></a><span class="Other">(</span><span class="Identifier">op</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">pack</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Nests the list <tt class="docutils literal"><span class="pre"><span class="Identifier">pack</span></span></tt> into a tree of call expressions: <tt class="docutils literal"><span class="pre"><span class="Punctuation">[</span><span class="Identifier">a</span><span class="Punctuation">,</span> <span class="Identifier">b</span><span class="Punctuation">,</span> <span class="Identifier">c</span><span class="Punctuation">]</span></span></tt> is transformed into <tt class="docutils literal"><span class="pre"><span class="Identifier">op</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Punctuation">,</span> <span class="Identifier">op</span><span class="Punctuation">(</span><span class="Identifier">c</span><span class="Punctuation">,</span> <span class="Identifier">d</span><span class="Punctuation">)</span><span class="Punctuation">)</span></span></tt>. This is also known as fold expression.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L895" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L895" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="nestList,NimNode,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#nestList%2CNimNode%2CNimNode%2CNimNode"><span class="Identifier">nestList</span></a><span class="Other">(</span><span class="Identifier">op</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">pack</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">init</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Nests the list <tt class="docutils literal"><span class="pre"><span class="Identifier">pack</span></span></tt> into a tree of call expressions: <tt class="docutils literal"><span class="pre"><span class="Punctuation">[</span><span class="Identifier">a</span><span class="Punctuation">,</span> <span class="Identifier">b</span><span class="Punctuation">,</span> <span class="Identifier">c</span><span class="Punctuation">]</span></span></tt> is transformed into <tt class="docutils literal"><span class="pre"><span class="Identifier">op</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Punctuation">,</span> <span class="Identifier">op</span><span class="Punctuation">(</span><span class="Identifier">c</span><span class="Punctuation">,</span> <span class="Identifier">d</span><span class="Punctuation">)</span><span class="Punctuation">)</span></span></tt>. This is also known as fold expression.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L905" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L905" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newAssignment-procs-all">
  <div id="newAssignment,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#newAssignment%2CNimNode%2CNimNode"><span class="Identifier">newAssignment</span></a><span class="Other">(</span><span class="Identifier">lhs</span><span class="Other">,</span> <span class="Identifier">rhs</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1162" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1162" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newBlockStmt-procs-all">
  <div id="newBlockStmt,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#newBlockStmt%2CNimNode"><span class="Identifier">newBlockStmt</span></a><span class="Other">(</span><span class="Identifier">body</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Create a new block: stmt.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1143" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1143" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newBlockStmt,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#newBlockStmt%2CNimNode%2CNimNode"><span class="Identifier">newBlockStmt</span></a><span class="Other">(</span><span class="Identifier">label</span><span class="Other">,</span> <span class="Identifier">body</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Create a new block statement with label.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1139" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1139" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newCall-procs-all">
  <div id="newCall,NimIdent,varargs[NimNode]">
  <dt><pre><span class="Keyword">proc</span> <a href="#newCall%2CNimIdent%2Cvarargs%5BNimNode%5D"><span class="Identifier">newCall</span></a><span class="Other">(</span><span class="Identifier">theProc</span><span class="Other">:</span> <a href="macros.html#NimIdent"><span class="Identifier">NimIdent</span></a><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <a href="system.html#varargs"><span class="Identifier">varargs</span></a><span class="Other">[</span><a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since v0.18.1; use \'newCall(string, ...)\' or \'newCall(NimNode, ...)\' instead&quot;</span><span class="Other">,</span>
    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    <div class="deprecation-message">
  <b>Deprecated:</b> Deprecated since v0.18.1; use &apos;newCall(string, ...)&apos; or &apos;newCall(NimNode, ...)&apos; instead
</div>

    Produces a new call node. <tt class="docutils literal"><span class="pre"><span class="Identifier">theProc</span></span></tt> is the proc that is called with the arguments <tt class="docutils literal"><span class="pre"><span class="Identifier">args</span><span class="Punctuation">[</span><span class="FloatNumber">0.</span><span class="Operator">.</span><span class="Punctuation">]</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L727" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L727" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newCall,NimNode,varargs[NimNode]">
  <dt><pre><span class="Keyword">proc</span> <a href="#newCall%2CNimNode%2Cvarargs%5BNimNode%5D"><span class="Identifier">newCall</span></a><span class="Other">(</span><span class="Identifier">theProc</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <a href="system.html#varargs"><span class="Identifier">varargs</span></a><span class="Other">[</span><a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Produces a new call node. <tt class="docutils literal"><span class="pre"><span class="Identifier">theProc</span></span></tt> is the proc that is called with the arguments <tt class="docutils literal"><span class="pre"><span class="Identifier">args</span><span class="Punctuation">[</span><span class="FloatNumber">0.</span><span class="Operator">.</span><span class="Punctuation">]</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L718" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L718" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newCall,string,varargs[NimNode]">
  <dt><pre><span class="Keyword">proc</span> <a href="#newCall%2Cstring%2Cvarargs%5BNimNode%5D"><span class="Identifier">newCall</span></a><span class="Other">(</span><span class="Identifier">theProc</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <a href="system.html#varargs"><span class="Identifier">varargs</span></a><span class="Other">[</span><a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Produces a new call node. <tt class="docutils literal"><span class="pre"><span class="Identifier">theProc</span></span></tt> is the proc that is called with the arguments <tt class="docutils literal"><span class="pre"><span class="Identifier">args</span><span class="Punctuation">[</span><span class="FloatNumber">0.</span><span class="Operator">.</span><span class="Punctuation">]</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L737" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L737" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newColonExpr-procs-all">
  <div id="newColonExpr,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#newColonExpr%2CNimNode%2CNimNode"><span class="Identifier">newColonExpr</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Create new colon expression. newColonExpr(a, b) -&gt; <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span><span class="Punctuation">:</span> <span class="Identifier">b</span></span></tt>
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1170" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1170" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newCommentStmtNode-procs-all">
  <div id="newCommentStmtNode,string">
  <dt><pre><span class="Keyword">proc</span> <a href="#newCommentStmtNode%2Cstring"><span class="Identifier">newCommentStmtNode</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Creates a comment statement node.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L452" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L452" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newConstStmt-procs-all">
  <div id="newConstStmt,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#newConstStmt%2CNimNode%2CNimNode"><span class="Identifier">newConstStmt</span></a><span class="Other">(</span><span class="Identifier">name</span><span class="Other">,</span> <span class="Identifier">value</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Create a new const stmt.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1157" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1157" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newDotExpr-procs-all">
  <div id="newDotExpr,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#newDotExpr%2CNimNode%2CNimNode"><span class="Identifier">newDotExpr</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Create new dot expression. a.dot(b) -&gt; <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">b</span></span></tt>
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1165" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1165" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newEmptyNode-procs-all">
  <div id="newEmptyNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#newEmptyNode"><span class="Identifier">newEmptyNode</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Create a new empty node.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1122" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1122" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newEnum-procs-all">
  <div id="newEnum,NimNode,openArray[NimNode],bool,bool">
  <dt><pre><span class="Keyword">proc</span> <a href="#newEnum%2CNimNode%2CopenArray%5BNimNode%5D%2Cbool%2Cbool"><span class="Identifier">newEnum</span></a><span class="Other">(</span><span class="Identifier">name</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">fields</span><span class="Other">:</span> <a href="system.html#openArray"><span class="Identifier">openArray</span></a><span class="Other">[</span><a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">public</span><span class="Other">,</span> <span class="Identifier">pure</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    <p>Creates a new enum. <tt class="docutils literal"><span class="pre"><span class="Identifier">name</span></span></tt> must be an ident. Fields are allowed to be either idents or EnumFieldDef:</p>
<p><pre class="listing"><span class="Identifier">newEnum</span><span class="Punctuation">(</span>
  <span class="Identifier">name</span>    <span class="Operator">=</span> <span class="Identifier">ident</span><span class="Punctuation">(</span><span class="StringLit">&quot;Colors&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">fields</span>  <span class="Operator">=</span> <span class="Punctuation">[</span><span class="Identifier">ident</span><span class="Punctuation">(</span><span class="StringLit">&quot;Blue&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">ident</span><span class="Punctuation">(</span><span class="StringLit">&quot;Red&quot;</span><span class="Punctuation">)</span><span class="Punctuation">]</span><span class="Punctuation">,</span>
  <span class="Identifier">public</span>  <span class="Operator">=</span> <span class="Identifier">true</span><span class="Punctuation">,</span> <span class="Identifier">pure</span> <span class="Operator">=</span> <span class="Identifier">false</span><span class="Punctuation">)</span>

<span class="Comment"># type Colors* = Blue Red</span></pre></p>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1262" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1262" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newFloatLitNode-procs-all">
  <div id="newFloatLitNode,BiggestFloat">
  <dt><pre><span class="Keyword">proc</span> <a href="#newFloatLitNode%2CBiggestFloat"><span class="Identifier">newFloatLitNode</span></a><span class="Other">(</span><span class="Identifier">f</span><span class="Other">:</span> <a href="ctypes.html#BiggestFloat"><span class="Identifier">BiggestFloat</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Creates a float literal node from <tt class="docutils literal"><span class="pre"><span class="Identifier">f</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L462" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L462" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newIdentDefs-procs-all">
  <div id="newIdentDefs,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#newIdentDefs%2CNimNode%2CNimNode"><span class="Identifier">newIdentDefs</span></a><span class="Other">(</span><span class="Identifier">name</span><span class="Other">,</span> <span class="Identifier">kind</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">default</span> <span class="Other">=</span> <span class="Identifier">newEmptyNode</span><span class="Other">(</span><span class="Other">)</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    <p>Creates a new <tt class="docutils literal"><span class="pre"><span class="Identifier">nnkIdentDefs</span></span></tt> node of a specific kind and value.</p>
<p><tt class="docutils literal"><span class="pre"><span class="Identifier">nnkIdentDefs</span></span></tt> need to have at least three children, but they can have more: first comes a list of identifiers followed by a type and value nodes. This helper proc creates a three node subtree, the first subnode being a single identifier name. Both the <tt class="docutils literal"><span class="pre"><span class="Identifier">kind</span></span></tt> node and <tt class="docutils literal"><span class="pre"><span class="Identifier">default</span></span></tt> (value) nodes may be empty depending on where the <tt class="docutils literal"><span class="pre"><span class="Identifier">nnkIdentDefs</span></span></tt> appears: tuple or object definitions will have an empty <tt class="docutils literal"><span class="pre"><span class="Identifier">default</span></span></tt> node, <tt class="docutils literal"><span class="pre"><span class="Keyword">let</span></span></tt> or <tt class="docutils literal"><span class="pre"><span class="Keyword">var</span></span></tt> blocks may have an empty <tt class="docutils literal"><span class="pre"><span class="Identifier">kind</span></span></tt> node if the identifier is being assigned a value. Example:</p>
<p><pre class="listing"><span class="Keyword">var</span> <span class="Identifier">varSection</span> <span class="Operator">=</span> <span class="Identifier">newNimNode</span><span class="Punctuation">(</span><span class="Identifier">nnkVarSection</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">add</span><span class="Punctuation">(</span>
  <span class="Identifier">newIdentDefs</span><span class="Punctuation">(</span><span class="Identifier">ident</span><span class="Punctuation">(</span><span class="StringLit">&quot;a&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">ident</span><span class="Punctuation">(</span><span class="StringLit">&quot;string&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Identifier">newIdentDefs</span><span class="Punctuation">(</span><span class="Identifier">ident</span><span class="Punctuation">(</span><span class="StringLit">&quot;b&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">newEmptyNode</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">newLit</span><span class="Punctuation">(</span><span class="DecNumber">3</span><span class="Punctuation">)</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
<span class="Comment"># --&gt; var</span>
<span class="Comment">#       a: string</span>
<span class="Comment">#       b = 3</span></pre></p>
<p>If you need to create multiple identifiers you need to use the lower level <tt class="docutils literal"><span class="pre"><span class="Identifier">newNimNode</span></span></tt>:</p>
<p><pre class="listing"><span class="Identifier">result</span> <span class="Operator">=</span> <span class="Identifier">newNimNode</span><span class="Punctuation">(</span><span class="Identifier">nnkIdentDefs</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">add</span><span class="Punctuation">(</span>
  <span class="Identifier">ident</span><span class="Punctuation">(</span><span class="StringLit">&quot;a&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">ident</span><span class="Punctuation">(</span><span class="StringLit">&quot;b&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">ident</span><span class="Punctuation">(</span><span class="StringLit">&quot;c&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">ident</span><span class="Punctuation">(</span><span class="StringLit">&quot;string&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
    <span class="Identifier">newStrLitNode</span><span class="Punctuation">(</span><span class="StringLit">&quot;Hello&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1175" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1175" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newIdentNode-procs-all">
  <div id="newIdentNode,NimIdent">
  <dt><pre><span class="Keyword">proc</span> <a href="#newIdentNode%2CNimIdent"><span class="Identifier">newIdentNode</span></a><span class="Other">(</span><span class="Identifier">i</span><span class="Other">:</span> <a href="macros.html#NimIdent"><span class="Identifier">NimIdent</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;use ident(string)&quot;</span><span class="Other">,</span>
    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    <div class="deprecation-message">
  <b>Deprecated:</b> use ident(string)
</div>

    Creates an identifier node from <tt class="docutils literal"><span class="pre"><span class="Identifier">i</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L469" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L469" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newIdentNode,string">
  <dt><pre><span class="Keyword">proc</span> <a href="#newIdentNode%2Cstring"><span class="Identifier">newIdentNode</span></a><span class="Other">(</span><span class="Identifier">i</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;StrToIdent&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
                                        <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Creates an identifier node from <tt class="docutils literal"><span class="pre"><span class="Identifier">i</span></span></tt>. It is simply an alias for <tt class="docutils literal"><span class="pre"><span class="Identifier">ident</span><span class="Punctuation">(</span><span class="Identifier">string</span><span class="Punctuation">)</span></span></tt>. Use that, it's shorter.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L476" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L476" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newIfStmt-procs-all">
  <div id="newIfStmt,varargs[tuple[NimNode,NimNode]]">
  <dt><pre><span class="Keyword">proc</span> <a href="#newIfStmt%2Cvarargs%5Btuple%5BNimNode%2CNimNode%5D%5D"><span class="Identifier">newIfStmt</span></a><span class="Other">(</span><span class="Identifier">branches</span><span class="Other">:</span> <a href="system.html#varargs"><span class="Identifier">varargs</span></a><span class="Other">[</span><span class="Keyword">tuple</span><span class="Other">[</span><span class="Identifier">cond</span><span class="Other">,</span> <span class="Identifier">body</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">]</span><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    <p>Constructor for <tt class="docutils literal"><span class="pre"><span class="Keyword">if</span></span></tt> statements.</p>
<p><pre class="listing"><span class="Identifier">newIfStmt</span><span class="Punctuation">(</span>
  <span class="Punctuation">(</span><span class="Identifier">Ident</span><span class="Punctuation">,</span> <span class="Identifier">StmtList</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
  <span class="Operator">...</span>
<span class="Punctuation">)</span></pre></p>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1248" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1248" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newIntLitNode-procs-all">
  <div id="newIntLitNode,BiggestInt">
  <dt><pre><span class="Keyword">proc</span> <a href="#newIntLitNode%2CBiggestInt"><span class="Identifier">newIntLitNode</span></a><span class="Other">(</span><span class="Identifier">i</span><span class="Other">:</span> <a href="ctypes.html#BiggestInt"><span class="Identifier">BiggestInt</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Creates an int literal node from <tt class="docutils literal"><span class="pre"><span class="Identifier">i</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L457" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L457" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newLetStmt-procs-all">
  <div id="newLetStmt,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLetStmt%2CNimNode%2CNimNode"><span class="Identifier">newLetStmt</span></a><span class="Other">(</span><span class="Identifier">name</span><span class="Other">,</span> <span class="Identifier">value</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Create a new let stmt.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1152" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1152" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newLit-procs-all">
  <div id="newLit">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit"><span class="Identifier">newLit</span></a><span class="Other">(</span><span class="Identifier">arg</span><span class="Other">:</span> <span class="Keyword">enum</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a></pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L832" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L832" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit_2">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit_2"><span class="Identifier">newLit</span></a><span class="Other">(</span><span class="Identifier">arg</span><span class="Other">:</span> <span class="Keyword">object</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a></pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L843" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L843" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit,ref.">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit%2Cref."><span class="Identifier">newLit</span></a><span class="Other">(</span><span class="Identifier">arg</span><span class="Other">:</span> <span class="Keyword">ref</span> <span class="Keyword">object</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a></pre></dt>
  <dd>
    
    produces a new ref type literal node.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L848" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L848" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit,bool">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit%2Cbool"><span class="Identifier">newLit</span></a><span class="Other">(</span><span class="Identifier">b</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Produces a new boolean literal node.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L800" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L800" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit,char">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit%2Cchar"><span class="Identifier">newLit</span></a><span class="Other">(</span><span class="Identifier">c</span><span class="Other">:</span> <a href="system.html#char"><span class="Identifier">char</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Produces a new character literal node.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L745" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L745" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit,float32">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit%2Cfloat32"><span class="Identifier">newLit</span></a><span class="Other">(</span><span class="Identifier">f</span><span class="Other">:</span> <a href="system.html#float32"><span class="Identifier">float32</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Produces a new float literal node.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L816" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L816" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit,float64">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit%2Cfloat64"><span class="Identifier">newLit</span></a><span class="Other">(</span><span class="Identifier">f</span><span class="Other">:</span> <a href="system.html#float64"><span class="Identifier">float64</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Produces a new float literal node.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L821" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L821" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit,int">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit%2Cint"><span class="Identifier">newLit</span></a><span class="Other">(</span><span class="Identifier">i</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Produces a new integer literal node.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L750" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L750" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit,int8">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit%2Cint8"><span class="Identifier">newLit</span></a><span class="Other">(</span><span class="Identifier">i</span><span class="Other">:</span> <a href="system.html#int8"><span class="Identifier">int8</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Produces a new integer literal node.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L755" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L755" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit,int16">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit%2Cint16"><span class="Identifier">newLit</span></a><span class="Other">(</span><span class="Identifier">i</span><span class="Other">:</span> <a href="system.html#int16"><span class="Identifier">int16</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Produces a new integer literal node.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L760" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L760" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit,int32">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit%2Cint32"><span class="Identifier">newLit</span></a><span class="Other">(</span><span class="Identifier">i</span><span class="Other">:</span> <a href="system.html#int32"><span class="Identifier">int32</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Produces a new integer literal node.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L765" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L765" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit,int64">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit%2Cint64"><span class="Identifier">newLit</span></a><span class="Other">(</span><span class="Identifier">i</span><span class="Other">:</span> <a href="system.html#int64"><span class="Identifier">int64</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Produces a new integer literal node.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L770" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L770" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit,uint">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit%2Cuint"><span class="Identifier">newLit</span></a><span class="Other">(</span><span class="Identifier">i</span><span class="Other">:</span> <a href="system.html#uint"><span class="Identifier">uint</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Produces a new unsigned integer literal node.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L775" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L775" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit,uint8">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit%2Cuint8"><span class="Identifier">newLit</span></a><span class="Other">(</span><span class="Identifier">i</span><span class="Other">:</span> <a href="system.html#uint8"><span class="Identifier">uint8</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Produces a new unsigned integer literal node.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L780" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L780" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit,uint16">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit%2Cuint16"><span class="Identifier">newLit</span></a><span class="Other">(</span><span class="Identifier">i</span><span class="Other">:</span> <a href="system.html#uint16"><span class="Identifier">uint16</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Produces a new unsigned integer literal node.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L785" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L785" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit,uint32">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit%2Cuint32"><span class="Identifier">newLit</span></a><span class="Other">(</span><span class="Identifier">i</span><span class="Other">:</span> <a href="system.html#uint32"><span class="Identifier">uint32</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Produces a new unsigned integer literal node.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L790" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L790" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit,uint64">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit%2Cuint64"><span class="Identifier">newLit</span></a><span class="Other">(</span><span class="Identifier">i</span><span class="Other">:</span> <a href="system.html#uint64"><span class="Identifier">uint64</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Produces a new unsigned integer literal node.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L795" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L795" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit,string">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit%2Cstring"><span class="Identifier">newLit</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Produces a new string literal node.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L804" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L804" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit,array[N,T]">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit%2Carray%5BN%2CT%5D"><span class="Identifier">newLit</span></a><span class="Other">[</span><span class="Identifier">N</span><span class="Other">,</span> <span class="Identifier">T</span><span class="Other">]</span><span class="Other">(</span><span class="Identifier">arg</span><span class="Other">:</span> <a href="system.html#array"><span class="Identifier">array</span></a><span class="Other">[</span><span class="Identifier">N</span><span class="Other">,</span> <span class="Identifier">T</span><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a></pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L838" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L838" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit,T">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit%2CT"><span class="Identifier">newLit</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">:</span> <span class="Keyword">tuple</span><span class="Other">]</span><span class="Other">(</span><span class="Identifier">arg</span><span class="Other">:</span> <span class="Identifier">T</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a></pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L841" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L841" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit,seq[T]">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit%2Cseq%5BT%5D"><span class="Identifier">newLit</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">]</span><span class="Other">(</span><span class="Identifier">arg</span><span class="Other">:</span> <a href="system.html#seq"><span class="Identifier">seq</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a></pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L839" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L839" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newLit,set[T]">
  <dt><pre><span class="Keyword">proc</span> <a href="#newLit%2Cset%5BT%5D"><span class="Identifier">newLit</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">]</span><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#set"><span class="Identifier">set</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a></pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L840" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L840" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newNilLit-procs-all">
  <div id="newNilLit">
  <dt><pre><span class="Keyword">proc</span> <a href="#newNilLit"><span class="Identifier">newNilLit</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    New nil literal shortcut.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1206" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1206" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newNimNode-procs-all">
  <div id="newNimNode,NimNodeKind,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#newNimNode%2CNimNodeKind%2CNimNode"><span class="Identifier">newNimNode</span></a><span class="Other">(</span><span class="Identifier">kind</span><span class="Other">:</span> <a href="macros.html#NimNodeKind"><span class="Identifier">NimNodeKind</span></a><span class="Other">;</span> <span class="Identifier">lineInfoFrom</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> <span class="Other">=</span> <span class="Keyword">nil</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.
    <span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NNewNimNode&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    <p>Creates a new AST node of the specified kind.</p>
<p>The <tt class="docutils literal"><span class="pre"><span class="Identifier">lineInfoFrom</span></span></tt> parameter is used for line information when the produced code crashes. You should ensure that it is set to a node that you are transforming.</p>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L396" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L396" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newPar-procs-all">
  <div id="newPar,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#newPar%2CNimNode"><span class="Identifier">newPar</span></a><span class="Other">(</span><span class="Identifier">exprs</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Create a new parentheses-enclosed expression.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1130" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1130" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="newPar,varargs[NimNode]">
  <dt><pre><span class="Keyword">proc</span> <a href="#newPar%2Cvarargs%5BNimNode%5D"><span class="Identifier">newPar</span></a><span class="Other">(</span><span class="Identifier">exprs</span><span class="Other">:</span> <a href="system.html#varargs"><span class="Identifier">varargs</span></a><span class="Other">[</span><a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;don\'t use newPar/nnkPar to construct tuple expressions; use nnkTupleConstr instead&quot;</span><span class="Other">,</span>
    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    <div class="deprecation-message">
  <b>Deprecated:</b> don&apos;t use newPar/nnkPar to construct tuple expressions; use nnkTupleConstr instead
</div>

    Create a new parentheses-enclosed expression.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1134" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1134" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newProc-procs-all">
  <div id="newProc,openArray[NimNode],NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#newProc%2CopenArray%5BNimNode%5D%2CNimNode%2CNimNode"><span class="Identifier">newProc</span></a><span class="Other">(</span><span class="Identifier">name</span> <span class="Other">=</span> <span class="Identifier">newEmptyNode</span><span class="Other">(</span><span class="Other">)</span><span class="Other">;</span>
             <span class="Identifier">params</span><span class="Other">:</span> <a href="system.html#openArray"><span class="Identifier">openArray</span></a><span class="Other">[</span><a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">]</span> <span class="Other">=</span> <span class="Other">[</span><span class="Identifier">newEmptyNode</span><span class="Other">(</span><span class="Other">)</span><span class="Other">]</span><span class="Other">;</span>
             <span class="Identifier">body</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> <span class="Other">=</span> <span class="Identifier">newStmtList</span><span class="Other">(</span><span class="Other">)</span><span class="Other">;</span> <span class="Identifier">procType</span> <span class="Other">=</span> <span class="Identifier">nnkProcDef</span><span class="Other">;</span>
             <span class="Identifier">pragmas</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> <span class="Other">=</span> <span class="Identifier">newEmptyNode</span><span class="Other">(</span><span class="Other">)</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    <p>Shortcut for creating a new proc.</p>
<p>The <tt class="docutils literal"><span class="pre"><span class="Identifier">params</span></span></tt> array must start with the return type of the proc, followed by a list of IdentDefs which specify the params.</p>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1227" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1227" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newStmtList-procs-all">
  <div id="newStmtList,varargs[NimNode]">
  <dt><pre><span class="Keyword">proc</span> <a href="#newStmtList%2Cvarargs%5BNimNode%5D"><span class="Identifier">newStmtList</span></a><span class="Other">(</span><span class="Identifier">stmts</span><span class="Other">:</span> <a href="system.html#varargs"><span class="Identifier">varargs</span></a><span class="Other">[</span><a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Create a new statement list.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1126" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1126" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newStrLitNode-procs-all">
  <div id="newStrLitNode,string">
  <dt><pre><span class="Keyword">proc</span> <a href="#newStrLitNode%2Cstring"><span class="Identifier">newStrLitNode</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Creates a string literal node from <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L447" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L447" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newTree-procs-all">
  <div id="newTree,NimNodeKind,varargs[NimNode]">
  <dt><pre><span class="Keyword">proc</span> <a href="#newTree%2CNimNodeKind%2Cvarargs%5BNimNode%5D"><span class="Identifier">newTree</span></a><span class="Other">(</span><span class="Identifier">kind</span><span class="Other">:</span> <a href="macros.html#NimNodeKind"><span class="Identifier">NimNodeKind</span></a><span class="Other">;</span> <span class="Identifier">children</span><span class="Other">:</span> <a href="system.html#varargs"><span class="Identifier">varargs</span></a><span class="Other">[</span><a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Produces a new node with children.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L712" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L712" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="newVarStmt-procs-all">
  <div id="newVarStmt,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#newVarStmt%2CNimNode%2CNimNode"><span class="Identifier">newVarStmt</span></a><span class="Other">(</span><span class="Identifier">name</span><span class="Other">,</span> <span class="Identifier">value</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Create a new var stmt.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1147" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1147" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="nodeID-procs-all">
  <div id="nodeID,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#nodeID%2CNimNode"><span class="Identifier">nodeID</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NodeId&quot;</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
                               <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Returns the id of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>, when the compiler has been compiled with the flag <tt class="docutils literal"><span class="pre"><span class="Operator">-</span><span class="Identifier">d</span><span class="Punctuation">:</span><span class="Identifier">useNodeids</span></span></tt>, otherwise returns <tt class="docutils literal"><span class="pre"><span class="Operator">-</span><span class="DecNumber">1</span></span></tt>. This proc is for the purpose to debug the compiler only.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1534" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1534" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="owner-procs-all">
  <div id="owner,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#owner%2CNimNode"><span class="Identifier">owner</span></a><span class="Other">(</span><span class="Identifier">sym</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;SymOwner&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">,</span>
                                    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    <div class="deprecation-message">
  <b>Deprecated</b> 
</div>

    <p>Accepts a node of kind <tt class="docutils literal"><span class="pre"><span class="Identifier">nnkSym</span></span></tt> and returns its owner's symbol. The meaning of 'owner' depends on <tt class="docutils literal"><span class="pre"><span class="Identifier">sym</span></span></tt>'s <tt class="docutils literal"><span class="pre"><span class="Identifier">NimSymKind</span></span></tt> and declaration context. For top level declarations this is an <tt class="docutils literal"><span class="pre"><span class="Identifier">nskModule</span></span></tt> symbol, for proc local variables an <tt class="docutils literal"><span class="pre"><span class="Identifier">nskProc</span></span></tt> symbol, for enum/object fields an <tt class="docutils literal"><span class="pre"><span class="Identifier">nskType</span></span></tt> symbol, etc. For symbols without an owner, <tt class="docutils literal"><span class="pre"><span class="Keyword">nil</span></span></tt> is returned.</p>
<p>See also:</p>
<ul class="simple"><li><a class="reference external" href="#symKind,NimNode">symKind proc</a> to get the kind of a symbol</li>
<li><a class="reference external" href="#getImpl,NimNode">getImpl proc</a> to get the declaration of a symbol</li>
</ul>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L282" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L282" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="params-procs-all">
  <div id="params,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#params%2CNimNode"><span class="Identifier">params</span></a><span class="Other">(</span><span class="Identifier">someProc</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1329" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1329" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="params=-procs-all">
  <div id="params=,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#params%3D%2CNimNode%2CNimNode"><span class="Identifier">params=</span></a><span class="Other">(</span><span class="Identifier">someProc</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">params</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1336" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1336" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="parseExpr-procs-all">
  <div id="parseExpr,string,string">
  <dt><pre><span class="Keyword">proc</span> <a href="#parseExpr%2Cstring%2Cstring"><span class="Identifier">parseExpr</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">filename</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> <span class="Other">=</span> <span class="StringLit">&quot;&quot;</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">noSideEffect</span><span class="Other">,</span>
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Compiles the passed string to its AST representation. Expects a single expression. Raises <tt class="docutils literal"><span class="pre"><span class="Identifier">ValueError</span></span></tt> for parsing errors. A filename can be given for more informative errors.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L579" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L579" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="parseStmt-procs-all">
  <div id="parseStmt,string,string">
  <dt><pre><span class="Keyword">proc</span> <a href="#parseStmt%2Cstring%2Cstring"><span class="Identifier">parseStmt</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">filename</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> <span class="Other">=</span> <span class="StringLit">&quot;&quot;</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">noSideEffect</span><span class="Other">,</span>
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">ValueError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Compiles the passed string to its AST representation. Expects one or more statements. Raises <tt class="docutils literal"><span class="pre"><span class="Identifier">ValueError</span></span></tt> for parsing errors. A filename can be given for more informative errors.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L587" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L587" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="postfix-procs-all">
  <div id="postfix,NimNode,string">
  <dt><pre><span class="Keyword">proc</span> <a href="#postfix%2CNimNode%2Cstring"><span class="Identifier">postfix</span></a><span class="Other">(</span><span class="Identifier">node</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">op</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1476" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1476" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="pragma-procs-all">
  <div id="pragma,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#pragma%2CNimNode"><span class="Identifier">pragma</span></a><span class="Other">(</span><span class="Identifier">someProc</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Get the pragma of a proc type. These will be expanded.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1344" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1344" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="pragma=-procs-all">
  <div id="pragma=,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#pragma%3D%2CNimNode%2CNimNode"><span class="Identifier">pragma=</span></a><span class="Other">(</span><span class="Identifier">someProc</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">val</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Set the pragma of a proc type.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1352" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1352" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="prefix-procs-all">
  <div id="prefix,NimNode,string">
  <dt><pre><span class="Keyword">proc</span> <a href="#prefix%2CNimNode%2Cstring"><span class="Identifier">prefix</span></a><span class="Other">(</span><span class="Identifier">node</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">op</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1479" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1479" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="quote-procs-all">
  <div id="quote,typed,string">
  <dt><pre><span class="Keyword">proc</span> <a href="#quote%2Ctyped%2Cstring"><span class="Identifier">quote</span></a><span class="Other">(</span><span class="Identifier">bl</span><span class="Other">:</span> <a href="system.html#typed"><span class="Identifier">typed</span></a><span class="Other">;</span> <span class="Identifier">op</span> <span class="Other">=</span> <span class="StringLit">&quot;``&quot;</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;QuoteAst&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    <p>Quasi-quoting operator. Accepts an expression or a block and returns the AST that represents it. Within the quoted AST, you are able to interpolate NimNode expressions from the surrounding scope. If no operator is given, quoting is done using backticks. Otherwise, the given operator must be used as a prefix operator for any interpolated expression. The original meaning of the interpolation operator may be obtained by escaping it (by prefixing it with itself) when used as a unary operator: e.g. <tt class="docutils literal"><span class="pre"><span class="Operator">@</span></span></tt> is escaped as <tt class="docutils literal"><span class="pre"><span class="Operator">@@</span></span></tt>, <tt class="docutils literal"><span class="pre"><span class="Operator">&amp;%</span></span></tt> is escaped as <tt class="docutils literal"><span class="pre"><span class="Operator">&amp;%&amp;%</span></span></tt> and so on; see examples.</p>
<p>A custom operator interpolation needs accent quoted (``) whenever it resolves to a symbol.</p>
<p>See also <a class="reference external" href="genasts.html">genasts</a> which avoids some issues with <tt class="docutils literal"><span class="pre"><span class="Identifier">quote</span></span></tt>.</p>

<p><strong class="examples_text">Example:</strong></p>
<pre class="listing"><span class="Keyword">macro</span> <span class="Identifier">check</span><span class="Punctuation">(</span><span class="Identifier">ex</span><span class="Punctuation">:</span> <span class="Identifier">untyped</span><span class="Punctuation">)</span> <span class="Operator">=</span>
  <span class="Comment"># this is a simplified version of the check macro from the</span>
  <span class="Comment"># unittest module.</span>

  <span class="Comment"># If there is a failed check, we want to make it easy for</span>
  <span class="Comment"># the user to jump to the faulty line in the code, so we</span>
  <span class="Comment"># get the line info here:</span>
  <span class="Keyword">var</span> <span class="Identifier">info</span> <span class="Operator">=</span> <span class="Identifier">ex</span><span class="Operator">.</span><span class="Identifier">lineinfo</span>

  <span class="Comment"># We will also display the code string of the failed check:</span>
  <span class="Keyword">var</span> <span class="Identifier">expString</span> <span class="Operator">=</span> <span class="Identifier">ex</span><span class="Operator">.</span><span class="Identifier">toStrLit</span>

  <span class="Comment"># Finally we compose the code to implement the check:</span>
  <span class="Identifier">result</span> <span class="Operator">=</span> <span class="Identifier">quote</span> <span class="Keyword">do</span><span class="Punctuation">:</span>
    <span class="Keyword">if</span> <span class="Keyword">not</span> <span class="Punctuation">`</span><span class="Identifier">ex</span><span class="Punctuation">`</span><span class="Punctuation">:</span>
      <span class="Identifier">echo</span> <span class="Punctuation">`</span><span class="Identifier">info</span><span class="Punctuation">`</span> <span class="Operator">&amp;</span> <span class="StringLit">&quot;: Check failed: &quot;</span> <span class="Operator">&amp;</span> <span class="Punctuation">`</span><span class="Identifier">expString</span><span class="Punctuation">`</span>
<span class="Identifier">check</span> <span class="DecNumber">1</span> <span class="Operator">+</span> <span class="DecNumber">1</span> <span class="Operator">==</span> <span class="DecNumber">2</span></pre>
<p><strong class="examples_text">Example:</strong></p>
<pre class="listing"><span class="Comment"># example showing how to define a symbol that requires backtick without</span>
<span class="Comment"># quoting it.</span>
<span class="Keyword">var</span> <span class="Identifier">destroyCalled</span> <span class="Operator">=</span> <span class="Identifier">false</span>
<span class="Keyword">macro</span> <span class="Identifier">bar</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">=</span>
  <span class="Keyword">let</span> <span class="Identifier">s</span> <span class="Operator">=</span> <span class="Identifier">newTree</span><span class="Punctuation">(</span><span class="Identifier">nnkAccQuoted</span><span class="Punctuation">,</span> <span class="RawData">ident&quot;=destroy&quot;</span><span class="Punctuation">)</span>
  <span class="Comment"># let s = ident&quot;`=destroy`&quot; # this would not work</span>
  <span class="Identifier">result</span> <span class="Operator">=</span> <span class="Identifier">quote</span> <span class="Keyword">do</span><span class="Punctuation">:</span>
    <span class="Keyword">type</span> <span class="Identifier">Foo</span> <span class="Operator">=</span> <span class="Keyword">object</span>
    <span class="Comment"># proc `=destroy`(a: var Foo) = destroyCalled = true # this would not work</span>
    <span class="Keyword">proc</span> <span class="Punctuation">`</span><span class="Identifier">s</span><span class="Punctuation">`</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Punctuation">:</span> <span class="Keyword">var</span> <span class="Identifier">Foo</span><span class="Punctuation">)</span> <span class="Operator">=</span> <span class="Identifier">destroyCalled</span> <span class="Operator">=</span> <span class="Identifier">true</span>
    <span class="Keyword">block</span><span class="Punctuation">:</span>
      <span class="Keyword">let</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="Identifier">Foo</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
<span class="Identifier">bar</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
<span class="Identifier">doAssert</span> <span class="Identifier">destroyCalled</span></pre>
<p><strong class="examples_text">Example:</strong></p>
<pre class="listing"><span class="Comment"># custom `op`</span>
<span class="Keyword">var</span> <span class="Identifier">destroyCalled</span> <span class="Operator">=</span> <span class="Identifier">false</span>
<span class="Keyword">macro</span> <span class="Identifier">bar</span><span class="Punctuation">(</span><span class="Identifier">ident</span><span class="Punctuation">)</span> <span class="Operator">=</span>
  <span class="Keyword">var</span> <span class="Identifier">x</span> <span class="Operator">=</span> <span class="FloatNumber">1.5</span>
  <span class="Identifier">result</span> <span class="Operator">=</span> <span class="Identifier">quote</span><span class="Punctuation">(</span><span class="StringLit">&quot;@&quot;</span><span class="Punctuation">)</span> <span class="Keyword">do</span><span class="Punctuation">:</span>
    <span class="Keyword">type</span> <span class="Identifier">Foo</span> <span class="Operator">=</span> <span class="Keyword">object</span>
    <span class="Keyword">let</span> <span class="Punctuation">`</span><span class="Operator">@</span><span class="Identifier">ident</span><span class="Punctuation">`</span> <span class="Operator">=</span> <span class="DecNumber">0</span> <span class="Comment"># custom op interpolated symbols need quoted (``)</span>
    <span class="Keyword">proc</span> <span class="Punctuation">`</span><span class="Operator">=</span><span class="Identifier">destroy</span><span class="Punctuation">`</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Punctuation">:</span> <span class="Keyword">var</span> <span class="Identifier">Foo</span><span class="Punctuation">)</span> <span class="Operator">=</span>
      <span class="Identifier">doAssert</span> <span class="Operator">@</span><span class="Identifier">x</span> <span class="Operator">==</span> <span class="FloatNumber">1.5</span>
      <span class="Identifier">doAssert</span> <span class="Identifier">compiles</span><span class="Punctuation">(</span><span class="Operator">@</span><span class="Identifier">x</span> <span class="Operator">==</span> <span class="FloatNumber">1.5</span><span class="Punctuation">)</span>
      <span class="Keyword">let</span> <span class="Identifier">b1</span> <span class="Operator">=</span> <span class="Operator">@</span><span class="Punctuation">[</span><span class="DecNumber">1</span><span class="Punctuation">,</span><span class="DecNumber">2</span><span class="Punctuation">]</span>
      <span class="Keyword">let</span> <span class="Identifier">b2</span> <span class="Operator">=</span> <span class="Operator">@@</span><span class="Punctuation">[</span><span class="DecNumber">1</span><span class="Punctuation">,</span><span class="DecNumber">2</span><span class="Punctuation">]</span>
      <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Identifier">b1</span> <span class="Operator">==</span> <span class="StringLit">&quot;[1, 2]&quot;</span>
      <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Identifier">b2</span> <span class="Operator">==</span> <span class="StringLit">&quot;@[1, 2]&quot;</span>
      <span class="Identifier">destroyCalled</span> <span class="Operator">=</span> <span class="Identifier">true</span>
    <span class="Keyword">block</span><span class="Punctuation">:</span>
      <span class="Keyword">let</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="Identifier">Foo</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
<span class="Identifier">bar</span><span class="Punctuation">(</span><span class="Identifier">someident</span><span class="Punctuation">)</span>
<span class="Identifier">doAssert</span> <span class="Identifier">destroyCalled</span>

<span class="Keyword">proc</span> <span class="Punctuation">`</span><span class="Operator">&amp;%</span><span class="Punctuation">`</span><span class="Punctuation">(</span><span class="Identifier">x</span><span class="Punctuation">:</span> <span class="Identifier">int</span><span class="Punctuation">)</span><span class="Punctuation">:</span> <span class="Identifier">int</span> <span class="Operator">=</span> <span class="DecNumber">1</span>
<span class="Keyword">proc</span> <span class="Punctuation">`</span><span class="Operator">&amp;%</span><span class="Punctuation">`</span><span class="Punctuation">(</span><span class="Identifier">x</span><span class="Punctuation">,</span> <span class="Identifier">y</span><span class="Punctuation">:</span> <span class="Identifier">int</span><span class="Punctuation">)</span><span class="Punctuation">:</span> <span class="Identifier">int</span> <span class="Operator">=</span> <span class="DecNumber">2</span>

<span class="Keyword">macro</span> <span class="Identifier">bar2</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">=</span>
  <span class="Keyword">var</span> <span class="Identifier">x</span> <span class="Operator">=</span> <span class="DecNumber">3</span>
  <span class="Identifier">result</span> <span class="Operator">=</span> <span class="Identifier">quote</span><span class="Punctuation">(</span><span class="StringLit">&quot;&amp;%&quot;</span><span class="Punctuation">)</span> <span class="Keyword">do</span><span class="Punctuation">:</span>
    <span class="Keyword">var</span> <span class="Identifier">y</span> <span class="Operator">=</span> <span class="Operator">&amp;%</span><span class="Identifier">x</span> <span class="Comment"># quoting operator</span>
    <span class="Identifier">doAssert</span> <span class="Operator">&amp;%&amp;%</span><span class="Identifier">y</span> <span class="Operator">==</span> <span class="DecNumber">1</span> <span class="Comment"># unary operator =&gt; need to escape</span>
    <span class="Identifier">doAssert</span> <span class="Identifier">y</span> <span class="Operator">&amp;%</span> <span class="Identifier">y</span> <span class="Operator">==</span> <span class="DecNumber">2</span> <span class="Comment"># binary operator =&gt; no need to escape</span>
    <span class="Identifier">doAssert</span> <span class="Identifier">y</span> <span class="Operator">==</span> <span class="DecNumber">3</span>
<span class="Identifier">bar2</span><span class="Punctuation">(</span><span class="Punctuation">)</span></pre>
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L604" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L604" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="sameType-procs-all">
  <div id="sameType,NimNode,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#sameType%2CNimNode%2CNimNode"><span class="Identifier">sameType</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;SameNodeType&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
                                     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Compares two Nim nodes' types. Return true if the types are the same, e.g. true when comparing alias with original type.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L175" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L175" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="setLineInfo-procs-all">
  <div id="setLineInfo,NimNode,string,int,int">
  <dt><pre><span class="Keyword">proc</span> <a href="#setLineInfo%2CNimNode%2Cstring%2Cint%2Cint"><span class="Identifier">setLineInfo</span></a><span class="Other">(</span><span class="Identifier">arg</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">file</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">line</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">;</span> <span class="Identifier">column</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span> {.
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Sets the line info on the NimNode. The file needs to exists, but can be a relative path. If you want to attach line info to a block using <tt class="docutils literal"><span class="pre"><span class="Identifier">quote</span></span></tt> you'll need to add the line information after the quote block.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L549" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L549" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>
<div id="setLineInfo,NimNode,LineInfo">
  <dt><pre><span class="Keyword">proc</span> <a href="#setLineInfo%2CNimNode%2CLineInfo"><span class="Identifier">setLineInfo</span></a><span class="Other">(</span><span class="Identifier">arg</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">lineInfo</span><span class="Other">:</span> <a href="macros.html#LineInfo"><span class="Identifier">LineInfo</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    See <a class="reference external" href="#setLineInfo,NimNode,string,int,int">setLineInfo proc</a>
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L557" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L557" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="signatureHash-procs-all">
  <div id="signatureHash,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#signatureHash%2CNimNode"><span class="Identifier">signatureHash</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NSigHash&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Returns a stable identifier derived from the signature of a symbol. The signature combines many factors such as the type of the symbol, the owning module of the symbol and others. The same identifier is used in the back-end to produce the mangled symbol name.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L357" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L357" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="strVal-procs-all">
  <div id="strVal,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#strVal%2CNimNode"><span class="Identifier">strVal</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NStrVal&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
                                  <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    <p>Returns the string value of an identifier, symbol, comment, or string literal.</p>
<p>See also:</p>
<ul class="simple"><li><a class="reference external" href="#strVal=,NimNode,string">strVal= proc</a> for setting the string value.</li>
</ul>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L249" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L249" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="strVal=-procs-all">
  <div id="strVal=,NimNode,string">
  <dt><pre><span class="Keyword">proc</span> <a href="#strVal%3D%2CNimNode%2Cstring"><span class="Identifier">strVal=</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">val</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NSetStrVal&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
                                        <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    <p>Sets the string value of a string literal or comment. Setting <tt class="docutils literal"><span class="pre"><span class="Identifier">strVal</span></span></tt> is disallowed for <tt class="docutils literal"><span class="pre"><span class="Identifier">nnkIdent</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="Identifier">nnkSym</span></span></tt> nodes; a new node must be created using <tt class="docutils literal"><span class="pre"><span class="Identifier">ident</span></span></tt> or <tt class="docutils literal"><span class="pre"><span class="Identifier">bindSym</span></span></tt> instead.</p>
<p>See also:</p>
<ul class="simple"><li><a class="reference external" href="#strVal,NimNode">strVal proc</a> for getting the string value.</li>
<li><a class="reference external" href="#ident,string">ident proc</a> for creating an identifier.</li>
<li><a class="reference external" href="#bindSym%2C%2CBindSymRule">bindSym proc</a> for binding a symbol.</li>
</ul>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L386" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L386" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="symBodyHash-procs-all">
  <div id="symBodyHash,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#symBodyHash%2CNimNode"><span class="Identifier">symBodyHash</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
                                       <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Returns a stable digest for symbols derived not only from type signature and owning module, but also implementation body. All procs/variables used in the implementation of this symbol are hashed recursively as well, including magics from system module.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L363" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L363" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="symbol-procs-all">
  <div id="symbol,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#symbol%2CNimNode"><span class="Identifier">symbol</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="macros.html#NimSym"><span class="Identifier">NimSym</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NSymbol&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since version 0.18.1; All functionality is defined on \'NimNode\'.&quot;</span><span class="Other">,</span>
                                  <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    <div class="deprecation-message">
  <b>Deprecated:</b> Deprecated since version 0.18.1; All functionality is defined on &apos;NimNode&apos;.
</div>

    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L260" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L260" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="symbol=-procs-all">
  <div id="symbol=,NimNode,NimSym">
  <dt><pre><span class="Keyword">proc</span> <a href="#symbol%3D%2CNimNode%2CNimSym"><span class="Identifier">symbol=</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">val</span><span class="Other">:</span> <a href="macros.html#NimSym"><span class="Identifier">NimSym</span></a><span class="Other">)</span> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NSetSymbol&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since version 0.18.1; Generate a new \'NimNode\' with \'genSym\' instead.&quot;</span><span class="Other">,</span>
                                        <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    <div class="deprecation-message">
  <b>Deprecated:</b> Deprecated since version 0.18.1; Generate a new &apos;NimNode&apos; with &apos;genSym&apos; instead.
</div>

    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L378" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L378" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="symKind-procs-all">
  <div id="symKind,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#symKind%2CNimNode"><span class="Identifier">symKind</span></a><span class="Other">(</span><span class="Identifier">symbol</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="macros.html#NimSymKind"><span class="Identifier">NimSymKind</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NSymKind&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L246" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L246" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="toNimIdent-procs-all">
  <div id="toNimIdent,string">
  <dt><pre><span class="Keyword">proc</span> <a href="#toNimIdent%2Cstring"><span class="Identifier">toNimIdent</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="macros.html#NimIdent"><span class="Identifier">NimIdent</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;StrToIdent&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since version 0.18.0: Use \'ident\' or \'newIdentNode\' instead.&quot;</span><span class="Other">,</span>
                                       <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    <div class="deprecation-message">
  <b>Deprecated:</b> Deprecated since version 0.18.0: Use &apos;ident&apos; or &apos;newIdentNode&apos; instead.
</div>

    Constructs an identifier from the string <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L157" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L157" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="toStrLit-procs-all">
  <div id="toStrLit,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#toStrLit%2CNimNode"><span class="Identifier">toStrLit</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Converts the AST <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> to the concrete Nim code and wraps that in a string literal node.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L519" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L519" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="treeRepr-procs-all">
  <div id="treeRepr,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#treeRepr%2CNimNode"><span class="Identifier">treeRepr</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    <p>Convert the AST <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> to a human-readable tree-like string.</p>
<p>See also <tt class="docutils literal"><span class="pre"><span class="Identifier">repr</span></span></tt>, <a class="reference internal nimdoc" title="proc lispRepr(n: NimNode; indented = false): string" href="#lispRepr,NimNode">lispRepr</a>, and <a class="reference internal nimdoc" title="proc astGenRepr(n: NimNode): string" href="#astGenRepr,NimNode">astGenRepr</a>.</p>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L985" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L985" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="typeKind-procs-all">
  <div id="typeKind,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#typeKind%2CNimNode"><span class="Identifier">typeKind</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="macros.html#NimTypeKind"><span class="Identifier">NimTypeKind</span></a> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NGetType&quot;</span><span class="Other">,</span> <span class="Identifier">noSideEffect</span><span class="Other">,</span>
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Returns the type kind of the node 'n' that should represent a type, that means the node should have been obtained via <tt class="docutils literal"><span class="pre"><span class="Identifier">getType</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L309" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L309" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="unpackInfix-procs-all">
  <div id="unpackInfix,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#unpackInfix%2CNimNode"><span class="Identifier">unpackInfix</span></a><span class="Other">(</span><span class="Identifier">node</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <span class="Keyword">tuple</span><span class="Other">[</span><span class="Identifier">left</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">,</span> <span class="Identifier">op</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">,</span> <span class="Identifier">right</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">]</span> {.
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1494" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1494" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="unpackPostfix-procs-all">
  <div id="unpackPostfix,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#unpackPostfix%2CNimNode"><span class="Identifier">unpackPostfix</span></a><span class="Other">(</span><span class="Identifier">node</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <span class="Keyword">tuple</span><span class="Other">[</span><span class="Identifier">node</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">,</span> <span class="Identifier">op</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span> {.
    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1486" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1486" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="unpackPrefix-procs-all">
  <div id="unpackPrefix,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#unpackPrefix%2CNimNode"><span class="Identifier">unpackPrefix</span></a><span class="Other">(</span><span class="Identifier">node</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <span class="Keyword">tuple</span><span class="Other">[</span><span class="Identifier">node</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">,</span> <span class="Identifier">op</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1490" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1490" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="warning-procs-all">
  <div id="warning,string,NimNode">
  <dt><pre><span class="Keyword">proc</span> <a href="#warning%2Cstring%2CNimNode"><span class="Identifier">warning</span></a><span class="Other">(</span><span class="Identifier">msg</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> <span class="Other">=</span> <span class="Keyword">nil</span><span class="Other">)</span> {.<span class="Identifier">magic</span><span class="Other">:</span> <span class="StringLit">&quot;NWarning&quot;</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Writes a warning message at compile time.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L441" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L441" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>

  </dl>
</div>
<div class="section" id="15">
  <h1><a class="toc-backref" href="#15">Iterators</a></h1>
  <dl class="item">
    <div id="children-iterators-all">
  <div id="children.i,NimNode">
  <dt><pre><span class="Keyword">iterator</span> <a href="#children.i%2CNimNode"><span class="Identifier">children</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Iterates over the children of the NimNode <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1431" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1431" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="items-iterators-all">
  <div id="items.i,NimNode">
  <dt><pre><span class="Keyword">iterator</span> <a href="#items.i%2CNimNode"><span class="Identifier">items</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Iterates over the children of the NimNode <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1421" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1421" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="pairs-iterators-all">
  <div id="pairs.i,NimNode">
  <dt><pre><span class="Keyword">iterator</span> <a href="#pairs.i%2CNimNode"><span class="Identifier">pairs</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <span class="Other">(</span><a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">,</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
  <dd>
    
    Iterates over the children of the NimNode <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> and its indices.
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1426" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1426" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>

  </dl>
</div>
<div class="section" id="17">
  <h1><a class="toc-backref" href="#17">Macros</a></h1>
  <dl class="item">
    <div id="dumpAstGen-macros-all">
  <div id="dumpAstGen.m,untyped">
  <dt><pre><span class="Keyword">macro</span> <a href="#dumpAstGen.m%2Cuntyped"><span class="Identifier">dumpAstGen</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#untyped"><span class="Identifier">untyped</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#untyped"><span class="Identifier">untyped</span></a></pre></dt>
  <dd>
    
    <p>Accepts a block of nim code and prints the parsed abstract syntax tree using the <tt class="docutils literal"><span class="pre"><span class="Identifier">astGenRepr</span></span></tt> proc. Printing is done <em>at compile time</em>.</p>
<p>You can use this as a tool to write macros quicker by writing example outputs and then copying the snippets into the macro for modification.</p>
<p>For example:</p>
<p><pre class="listing"><span class="Identifier">dumpAstGen</span><span class="Punctuation">:</span>
  <span class="Identifier">echo</span> <span class="StringLit">&quot;Hello, World!&quot;</span></pre></p>
<p>Outputs:</p>
<p><pre class="listing"><span class="Identifier">nnkStmtList</span><span class="Operator">.</span><span class="Identifier">newTree</span><span class="Punctuation">(</span>
  <span class="Identifier">nnkCommand</span><span class="Operator">.</span><span class="Identifier">newTree</span><span class="Punctuation">(</span>
    <span class="Identifier">newIdentNode</span><span class="Punctuation">(</span><span class="StringLit">&quot;echo&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span>
    <span class="Identifier">newLit</span><span class="Punctuation">(</span><span class="StringLit">&quot;Hello, World!&quot;</span><span class="Punctuation">)</span>
  <span class="Punctuation">)</span>
<span class="Punctuation">)</span></pre></p>
<p>Also see <tt class="docutils literal"><span class="pre"><span class="Identifier">dumpTree</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="Identifier">dumpLisp</span></span></tt>.</p>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1097" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1097" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="dumpLisp-macros-all">
  <div id="dumpLisp.m,untyped">
  <dt><pre><span class="Keyword">macro</span> <a href="#dumpLisp.m%2Cuntyped"><span class="Identifier">dumpLisp</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#untyped"><span class="Identifier">untyped</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#untyped"><span class="Identifier">untyped</span></a></pre></dt>
  <dd>
    
    <p>Accepts a block of nim code and prints the parsed abstract syntax tree using the <tt class="docutils literal"><span class="pre"><span class="Identifier">lispRepr</span></span></tt> proc. Printing is done <em>at compile time</em>.</p>
<p>You can use this as a tool to explore the Nim's abstract syntax tree and to discover what kind of nodes must be created to represent a certain expression/statement.</p>
<p>For example:</p>
<p><pre class="listing"><span class="Identifier">dumpLisp</span><span class="Punctuation">:</span>
  <span class="Identifier">echo</span> <span class="StringLit">&quot;Hello, World!&quot;</span></pre></p>
<p>Outputs:</p>
<p><pre class="listing"><span class="Punctuation">(</span><span class="Identifier">StmtList</span>
 <span class="Punctuation">(</span><span class="Identifier">Command</span>
  <span class="Punctuation">(</span><span class="Identifier">Ident</span> <span class="StringLit">&quot;echo&quot;</span><span class="Punctuation">)</span>
  <span class="Punctuation">(</span><span class="Identifier">StrLit</span> <span class="StringLit">&quot;Hello, World!&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>
<p>Also see <tt class="docutils literal"><span class="pre"><span class="Identifier">dumpAstGen</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="Identifier">dumpTree</span></span></tt>.</p>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1073" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1073" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="dumpTree-macros-all">
  <div id="dumpTree.m,untyped">
  <dt><pre><span class="Keyword">macro</span> <a href="#dumpTree.m%2Cuntyped"><span class="Identifier">dumpTree</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#untyped"><span class="Identifier">untyped</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#untyped"><span class="Identifier">untyped</span></a></pre></dt>
  <dd>
    
    <p>Accepts a block of nim code and prints the parsed abstract syntax tree using the <tt class="docutils literal"><span class="pre"><span class="Identifier">treeRepr</span></span></tt> proc. Printing is done <em>at compile time</em>.</p>
<p>You can use this as a tool to explore the Nim's abstract syntax tree and to discover what kind of nodes must be created to represent a certain expression/statement.</p>
<p>For example:</p>
<p><pre class="listing"><span class="Identifier">dumpTree</span><span class="Punctuation">:</span>
  <span class="Identifier">echo</span> <span class="StringLit">&quot;Hello, World!&quot;</span></pre></p>
<p>Outputs:</p>
<p><pre class="listing"><span class="Identifier">StmtList</span>
  <span class="Identifier">Command</span>
    <span class="Identifier">Ident</span> <span class="StringLit">&quot;echo&quot;</span>
    <span class="Identifier">StrLit</span> <span class="StringLit">&quot;Hello, World!&quot;</span></pre></p>
<p>Also see <tt class="docutils literal"><span class="pre"><span class="Identifier">dumpAstGen</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="Identifier">dumpLisp</span></span></tt>.</p>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1049" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1049" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="expandMacros-macros-all">
  <div id="expandMacros.m,typed">
  <dt><pre><span class="Keyword">macro</span> <a href="#expandMacros.m%2Ctyped"><span class="Identifier">expandMacros</span></a><span class="Other">(</span><span class="Identifier">body</span><span class="Other">:</span> <a href="system.html#typed"><span class="Identifier">typed</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#untyped"><span class="Identifier">untyped</span></a></pre></dt>
  <dd>
    
    <p>Expands one level of macro - useful for debugging. Can be used to inspect what happens when a macro call is expanded, without altering its result.</p>
<p>For instance,</p>
<p><pre class="listing"><span class="Keyword">import</span> <span class="Identifier">std</span><span class="Operator">/</span><span class="Punctuation">[</span><span class="Identifier">sugar</span><span class="Punctuation">,</span> <span class="Identifier">macros</span><span class="Punctuation">]</span>

<span class="Keyword">let</span>
  <span class="Identifier">x</span> <span class="Operator">=</span> <span class="DecNumber">10</span>
  <span class="Identifier">y</span> <span class="Operator">=</span> <span class="DecNumber">20</span>
<span class="Identifier">expandMacros</span><span class="Punctuation">:</span>
  <span class="Identifier">dump</span><span class="Punctuation">(</span><span class="Identifier">x</span> <span class="Operator">+</span> <span class="Identifier">y</span><span class="Punctuation">)</span></pre></p>
<p>will actually dump <tt class="docutils literal"><span class="pre"><span class="Identifier">x</span> <span class="Operator">+</span> <span class="Identifier">y</span></span></tt>, but at the same time will print at compile time the expansion of the <tt class="docutils literal"><span class="pre"><span class="Identifier">dump</span></span></tt> macro, which in this case is <tt class="docutils literal"><span class="pre"><span class="Identifier">debugEcho</span> <span class="Punctuation">[</span><span class="StringLit">&quot;x + y&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot; = &quot;</span><span class="Punctuation">,</span> <span class="Identifier">x</span> <span class="Operator">+</span> <span class="Identifier">y</span><span class="Punctuation">]</span></span></tt>.</p>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1539" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1539" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="getCustomPragmaVal-macros-all">
  <div id="getCustomPragmaVal.m,typed,">
  <dt><pre><span class="Keyword">macro</span> <a href="#getCustomPragmaVal.m%2Ctyped%2C"><span class="Identifier">getCustomPragmaVal</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#typed"><span class="Identifier">typed</span></a><span class="Other">;</span> <span class="Identifier">cp</span><span class="Other">:</span> <a href="system.html#typed"><span class="Identifier">typed</span></a><span class="Other">{</span><span class="Identifier">nkSym</span><span class="Other">}</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#untyped"><span class="Identifier">untyped</span></a></pre></dt>
  <dd>
    
    <p>Expands to value of custom pragma <tt class="docutils literal"><span class="pre"><span class="Identifier">cp</span></span></tt> of expression <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> which is expected to be <tt class="docutils literal"><span class="pre"><span class="Identifier">nnkDotExpr</span></span></tt>, a proc or a type.</p>
<p>See also <a class="reference internal nimdoc" title="macro hasCustomPragma(n: typed; cp: typed{nkSym}): untyped" href="#hasCustomPragma.m,typed,">hasCustomPragma</a>.</p>
<p><pre class="listing"><span class="Keyword">template</span> <span class="Identifier">serializationKey</span><span class="Punctuation">(</span><span class="Identifier">key</span><span class="Punctuation">:</span> <span class="Identifier">string</span><span class="Punctuation">)</span> <span class="Punctuation">{</span><span class="Operator">.</span><span class="Identifier">pragma</span><span class="Operator">.</span><span class="Punctuation">}</span>
<span class="Keyword">type</span>
  <span class="Identifier">MyObj</span> <span class="Punctuation">{</span><span class="Operator">.</span><span class="Identifier">serializationKey</span><span class="Punctuation">:</span> <span class="StringLit">&quot;mo&quot;</span><span class="Operator">.</span><span class="Punctuation">}</span> <span class="Operator">=</span> <span class="Keyword">object</span>
    <span class="Identifier">myField</span> <span class="Punctuation">{</span><span class="Operator">.</span><span class="Identifier">serializationKey</span><span class="Punctuation">:</span> <span class="StringLit">&quot;mf&quot;</span><span class="Operator">.</span><span class="Punctuation">}</span><span class="Punctuation">:</span> <span class="Identifier">int</span>
<span class="Keyword">var</span> <span class="Identifier">o</span><span class="Punctuation">:</span> <span class="Identifier">MyObj</span>
<span class="Identifier">assert</span><span class="Punctuation">(</span><span class="Identifier">o</span><span class="Operator">.</span><span class="Identifier">myField</span><span class="Operator">.</span><span class="Identifier">getCustomPragmaVal</span><span class="Punctuation">(</span><span class="Identifier">serializationKey</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;mf&quot;</span><span class="Punctuation">)</span>
<span class="Identifier">assert</span><span class="Punctuation">(</span><span class="Identifier">o</span><span class="Operator">.</span><span class="Identifier">getCustomPragmaVal</span><span class="Punctuation">(</span><span class="Identifier">serializationKey</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;mo&quot;</span><span class="Punctuation">)</span>
<span class="Identifier">assert</span><span class="Punctuation">(</span><span class="Identifier">MyObj</span><span class="Operator">.</span><span class="Identifier">getCustomPragmaVal</span><span class="Punctuation">(</span><span class="Identifier">serializationKey</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;mo&quot;</span><span class="Punctuation">)</span></pre></p>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1682" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1682" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="hasCustomPragma-macros-all">
  <div id="hasCustomPragma.m,typed,">
  <dt><pre><span class="Keyword">macro</span> <a href="#hasCustomPragma.m%2Ctyped%2C"><span class="Identifier">hasCustomPragma</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#typed"><span class="Identifier">typed</span></a><span class="Other">;</span> <span class="Identifier">cp</span><span class="Other">:</span> <a href="system.html#typed"><span class="Identifier">typed</span></a><span class="Other">{</span><span class="Identifier">nkSym</span><span class="Other">}</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#untyped"><span class="Identifier">untyped</span></a></pre></dt>
  <dd>
    
    <p>Expands to <tt class="docutils literal"><span class="pre"><span class="Identifier">true</span></span></tt> if expression <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> which is expected to be <tt class="docutils literal"><span class="pre"><span class="Identifier">nnkDotExpr</span></span></tt> (if checking a field), a proc or a type has custom pragma <tt class="docutils literal"><span class="pre"><span class="Identifier">cp</span></span></tt>.</p>
<p>See also <a class="reference internal nimdoc" title="macro getCustomPragmaVal(n: typed; cp: typed{nkSym}): untyped" href="#getCustomPragmaVal.m,typed,">getCustomPragmaVal</a>.</p>
<p><pre class="listing"><span class="Keyword">template</span> <span class="Identifier">myAttr</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Punctuation">{</span><span class="Operator">.</span><span class="Identifier">pragma</span><span class="Operator">.</span><span class="Punctuation">}</span>
<span class="Keyword">type</span>
  <span class="Identifier">MyObj</span> <span class="Operator">=</span> <span class="Keyword">object</span>
    <span class="Identifier">myField</span> <span class="Punctuation">{</span><span class="Operator">.</span><span class="Identifier">myAttr</span><span class="Operator">.</span><span class="Punctuation">}</span><span class="Punctuation">:</span> <span class="Identifier">int</span>

<span class="Keyword">proc</span> <span class="Identifier">myProc</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Punctuation">{</span><span class="Operator">.</span><span class="Identifier">myAttr</span><span class="Operator">.</span><span class="Punctuation">}</span> <span class="Operator">=</span> <span class="Keyword">discard</span>

<span class="Keyword">var</span> <span class="Identifier">o</span><span class="Punctuation">:</span> <span class="Identifier">MyObj</span>
<span class="Identifier">assert</span><span class="Punctuation">(</span><span class="Identifier">o</span><span class="Operator">.</span><span class="Identifier">myField</span><span class="Operator">.</span><span class="Identifier">hasCustomPragma</span><span class="Punctuation">(</span><span class="Identifier">myAttr</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
<span class="Identifier">assert</span><span class="Punctuation">(</span><span class="Identifier">myProc</span><span class="Operator">.</span><span class="Identifier">hasCustomPragma</span><span class="Punctuation">(</span><span class="Identifier">myAttr</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1657" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1657" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="unpackVarargs-macros-all">
  <div id="unpackVarargs.m,untyped,varargs[untyped]">
  <dt><pre><span class="Keyword">macro</span> <a href="#unpackVarargs.m%2Cuntyped%2Cvarargs%5Buntyped%5D"><span class="Identifier">unpackVarargs</span></a><span class="Other">(</span><span class="Identifier">callee</span><span class="Other">:</span> <a href="system.html#untyped"><span class="Identifier">untyped</span></a><span class="Other">;</span> <span class="Identifier">args</span><span class="Other">:</span> <a href="system.html#varargs"><span class="Identifier">varargs</span></a><span class="Other">[</span><a href="system.html#untyped"><span class="Identifier">untyped</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#untyped"><span class="Identifier">untyped</span></a></pre></dt>
  <dd>
    
    Calls <tt class="docutils literal"><span class="pre"><span class="Identifier">callee</span></span></tt> with <tt class="docutils literal"><span class="pre"><span class="Identifier">args</span></span></tt> unpacked as individual arguments. This is useful in 2 cases:<ul class="simple"><li>when forwarding <tt class="docutils literal"><span class="pre"><span class="Identifier">varargs</span><span class="Punctuation">[</span><span class="Identifier">T</span><span class="Punctuation">]</span></span></tt> for some typed <tt class="docutils literal"><span class="pre"><span class="Identifier">T</span></span></tt></li>
<li>when forwarding <tt class="docutils literal"><span class="pre"><span class="Identifier">varargs</span><span class="Punctuation">[</span><span class="Identifier">untyped</span><span class="Punctuation">]</span></span></tt> when <tt class="docutils literal"><span class="pre"><span class="Identifier">args</span></span></tt> can potentially be empty, due to a compiler limitation</li>
</ul>

<p><strong class="examples_text">Example:</strong></p>
<pre class="listing"><span class="Keyword">template</span> <span class="Identifier">call1</span><span class="Punctuation">(</span><span class="Identifier">fun</span><span class="Punctuation">:</span> <span class="Identifier">typed</span><span class="Punctuation">;</span> <span class="Identifier">args</span><span class="Punctuation">:</span> <span class="Identifier">varargs</span><span class="Punctuation">[</span><span class="Identifier">untyped</span><span class="Punctuation">]</span><span class="Punctuation">)</span><span class="Punctuation">:</span> <span class="Identifier">untyped</span> <span class="Operator">=</span>
  <span class="Identifier">unpackVarargs</span><span class="Punctuation">(</span><span class="Identifier">fun</span><span class="Punctuation">,</span> <span class="Identifier">args</span><span class="Punctuation">)</span>
  <span class="Comment"># when varargsLen(args) &gt; 0: fun(args) else: fun() # this would also work</span>
<span class="Keyword">template</span> <span class="Identifier">call2</span><span class="Punctuation">(</span><span class="Identifier">fun</span><span class="Punctuation">:</span> <span class="Identifier">typed</span><span class="Punctuation">;</span> <span class="Identifier">args</span><span class="Punctuation">:</span> <span class="Identifier">varargs</span><span class="Punctuation">[</span><span class="Identifier">typed</span><span class="Punctuation">]</span><span class="Punctuation">)</span><span class="Punctuation">:</span> <span class="Identifier">untyped</span> <span class="Operator">=</span>
  <span class="Identifier">unpackVarargs</span><span class="Punctuation">(</span><span class="Identifier">fun</span><span class="Punctuation">,</span> <span class="Identifier">args</span><span class="Punctuation">)</span>
<span class="Keyword">proc</span> <span class="Identifier">fn1</span><span class="Punctuation">(</span><span class="Identifier">a</span> <span class="Operator">=</span> <span class="DecNumber">0</span><span class="Punctuation">,</span> <span class="Identifier">b</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span> <span class="Operator">=</span> <span class="Keyword">discard</span> <span class="Punctuation">(</span><span class="Identifier">a</span><span class="Punctuation">,</span> <span class="Identifier">b</span><span class="Punctuation">)</span>
<span class="Identifier">call1</span><span class="Punctuation">(</span><span class="Identifier">fn1</span><span class="Punctuation">,</span> <span class="DecNumber">10</span><span class="Punctuation">,</span> <span class="DecNumber">11</span><span class="Punctuation">)</span>
<span class="Identifier">call1</span><span class="Punctuation">(</span><span class="Identifier">fn1</span><span class="Punctuation">)</span> <span class="Comment"># `args` is empty in this case</span>
<span class="Keyword">if</span> <span class="Identifier">false</span><span class="Punctuation">:</span> <span class="Identifier">call2</span><span class="Punctuation">(</span><span class="Identifier">echo</span><span class="Punctuation">,</span> <span class="DecNumber">10</span><span class="Punctuation">,</span> <span class="DecNumber">11</span><span class="Punctuation">)</span> <span class="Comment"># would print 1011</span></pre>
    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1715" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1715" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>

  </dl>
</div>
<div class="section" id="18">
  <h1><a class="toc-backref" href="#18">Templates</a></h1>
  <dl class="item">
    <div id="findChild-templates-all">
  <div id="findChild.t,NimNode,untyped">
  <dt><pre><span class="Keyword">template</span> <a href="#findChild.t%2CNimNode%2Cuntyped"><span class="Identifier">findChild</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">;</span> <span class="Identifier">cond</span><span class="Other">:</span> <a href="system.html#untyped"><span class="Identifier">untyped</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a> {.<span class="Identifier">dirty</span>.}</pre></dt>
  <dd>
    
    <p>Find the first child node matching condition (or nil).</p>
<p><pre class="listing"><span class="Keyword">var</span> <span class="Identifier">res</span> <span class="Operator">=</span> <span class="Identifier">findChild</span><span class="Punctuation">(</span><span class="Identifier">n</span><span class="Punctuation">,</span> <span class="Identifier">it</span><span class="Operator">.</span><span class="Identifier">kind</span> <span class="Operator">==</span> <span class="Identifier">nnkPostfix</span> <span class="Keyword">and</span>
                       <span class="Identifier">it</span><span class="Operator">.</span><span class="Identifier">basename</span><span class="Operator">.</span><span class="Identifier">ident</span> <span class="Operator">==</span> <span class="RawData">ident&quot;foo&quot;</span><span class="Punctuation">)</span></pre></p>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L1436" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L1436" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>
<div id="or-templates-all">
  <div id="or.t,NimNode,NimNode">
  <dt><pre><span class="Keyword">template</span> <a href="#or.t%2CNimNode%2CNimNode"><span class="Identifier">`or`</span></a><span class="Other">(</span><span class="Identifier">x</span><span class="Other">,</span> <span class="Identifier">y</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#NimNode"><span class="Identifier">NimNode</span></a></pre></dt>
  <dd>
    
    <p>Evaluate <tt class="docutils literal"><span class="pre"><span class="Identifier">x</span></span></tt> and when it is not an empty node, return it. Otherwise evaluate to <tt class="docutils literal"><span class="pre"><span class="Identifier">y</span></span></tt>. Can be used to chain several expressions to get the first expression that is not empty.</p>
<p><pre class="listing"><span class="Keyword">let</span> <span class="Identifier">node</span> <span class="Operator">=</span> <span class="Identifier">mightBeEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Keyword">or</span> <span class="Identifier">mightAlsoBeEmpty</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Keyword">or</span> <span class="Identifier">fallbackNode</span></pre></p>

    <a href="https://github.com/nim-lang/Nim/tree/devel/lib/core/macros.nim#L209" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
<a href="https://github.com/nim-lang/Nim/edit/devel/lib/core/macros.nim#L209" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;

  </dd>
</div>

</div>

  </dl>
</div>

  </div>
</div>

      <div class="twelve-columns footer">
        <span class="nim-sprite"></span>
        <br>
        <small style="color: var(--hint);">Made with Nim. Generated: 2025-04-03 14:19:07 UTC</small>
      </div>
    </div>
  </div>
      <script defer data-domain="nim-lang.org" src="https://plausible.io/js/plausible.js"></script>
    
</body>
</html>