My various dotfiles

chap-26.texi 200KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089509050915092509350945095509650975098509951005101510251035104510551065107510851095110511151125113511451155116511751185119512051215122512351245125512651275128512951305131513251335134513551365137513851395140514151425143514451455146514751485149515051515152515351545155515651575158515951605161516251635164516551665167516851695170517151725173517451755176517751785179518051815182518351845185518651875188518951905191519251935194519551965197519851995200520152025203520452055206520752085209521052115212521352145215521652175218521952205221522252235224522552265227522852295230523152325233523452355236523752385239524052415242524352445245524652475248524952505251525252535254525552565257525852595260526152625263526452655266526752685269527052715272527352745275527652775278527952805281528252835284528552865287528852895290529152925293529452955296529752985299530053015302530353045305530653075308530953105311531253135314531553165317531853195320532153225323532453255326532753285329533053315332533353345335533653375338533953405341534253435344534553465347534853495350535153525353535453555356535753585359536053615362536353645365536653675368536953705371537253735374537553765377537853795380538153825383538453855386538753885389539053915392539353945395539653975398539954005401540254035404540554065407540854095410541154125413541454155416541754185419542054215422542354245425542654275428542954305431543254335434543554365437543854395440544154425443544454455446544754485449545054515452545354545455545654575458545954605461546254635464546554665467546854695470547154725473547454755476547754785479548054815482548354845485548654875488548954905491549254935494549554965497549854995500550155025503550455055506550755085509551055115512551355145515551655175518551955205521552255235524552555265527552855295530553155325533553455355536553755385539554055415542554355445545554655475548554955505551555255535554555555565557555855595560556155625563556455655566556755685569557055715572557355745575557655775578557955805581558255835584558555865587558855895590559155925593559455955596559755985599560056015602560356045605560656075608560956105611561256135614561556165617561856195620562156225623562456255626562756285629563056315632563356345635563656375638563956405641564256435644564556465647564856495650565156525653565456555656565756585659566056615662566356645665566656675668566956705671567256735674567556765677567856795680568156825683568456855686568756885689569056915692569356945695569656975698569957005701570257035704570557065707570857095710571157125713571457155716571757185719572057215722572357245725572657275728572957305731573257335734573557365737573857395740574157425743574457455746574757485749575057515752575357545755575657575758575957605761576257635764576557665767576857695770577157725773577457755776577757785779578057815782578357845785578657875788578957905791579257935794579557965797579857995800580158025803580458055806580758085809581058115812581358145815581658175818581958205821582258235824582558265827582858295830583158325833583458355836583758385839584058415842584358445845584658475848584958505851585258535854585558565857585858595860586158625863586458655866586758685869587058715872587358745875587658775878587958805881588258835884588558865887588858895890589158925893589458955896589758985899590059015902590359045905590659075908590959105911591259135914591559165917591859195920592159225923592459255926592759285929593059315932593359345935593659375938593959405941594259435944594559465947594859495950595159525953595459555956595759585959596059615962596359645965596659675968596959705971597259735974597559765977597859795980598159825983598459855986598759885989599059915992599359945995599659975998599960006001600260036004600560066007600860096010601160126013601460156016601760186019602060216022602360246025602660276028602960306031
  1. @node Glossary (Glossary), Appendix, Environment, Top
  2. @chapter Glossary
  3. @menu
  4. * Glossary::
  5. @end menu
  6. @node Glossary, , Glossary (Glossary), Glossary (Glossary)
  7. @section Glossary
  8. @c including concept-glossary
  9. Each entry in this glossary has the following parts:
  10. @table @asis
  11. @item @t{*}
  12. the term being defined, set in boldface.
  13. @item @t{*}
  14. optional pronunciation, enclosed in square brackets and
  15. set in boldface, as in the following example:
  16. pronounced 'a ,list . The pronunciation key follows
  17. @i{Webster's Third New International Dictionary
  18. the English Language, Unabridged},
  19. except that ``{e}'' is used to notate the schwa (upside-down ``e'') character.
  20. @item @t{*}
  21. the part or parts of speech, set in italics. If a term
  22. can be used as several parts of speech, there is a separate definition
  23. for each part of speech.
  24. @item @t{*}
  25. one or more definitions, organized as follows:
  26. @table @asis
  27. @item --
  28. an optional number, present if there are several
  29. definitions. Lowercase letters might also be used in cases where subdefinitions of
  30. a numbered definition are necessary.
  31. @item --
  32. an optional part of speech, set in italics, present if the
  33. term is one of several parts of speech.
  34. @item --
  35. an optional discipline, set in italics, present if the term
  36. has a standard definition being repeated. For example, ``{Math.}''
  37. @item --
  38. an optional context, present if this definition is
  39. meaningful only in that context. For example, ``(of a @i{symbol})''.
  40. @item --
  41. the definition.
  42. @item --
  43. an optional example sentence. For example,
  44. {``This is an example of an example.''}
  45. @item --
  46. optional cross references.
  47. @end table
  48. @end table
  49. In addition, some terms have idiomatic usage in the Common Lisp
  50. community which is not shared by other communities, or which is not
  51. technically correct. Definitions labeled ``{Idiom.}'' represent
  52. such idiomatic usage; these definitions are sometimes followed by an
  53. explanatory note.
  54. Words in @i{this font} are words with entries in the glossary.
  55. Words in example sentences do not follow this convention.
  56. When an ambiguity arises, the longest matching substring has precedence.
  57. For example, ``@i{complex float}'' refers to a single glossary entry
  58. for ``@i{complex float}'' rather than the combined meaning of the
  59. glossary terms ``@i{complex}'' and ``@i{float}.''
  60. Subscript notation, as in ``@i{something}_n'' means that
  61. the @i{n}th definition of ``@i{something}'' is intended. This
  62. notation is used only in situations where the context might be insufficient
  63. to disambiguate.
  64. The following are abbreviations used in the glossary:
  65. Abbreviation Meaning
  66. @table @asis
  67. @item @i{adj.}
  68. adjective
  69. @item @i{adv.}
  70. adverb
  71. @item @i{ANSI}
  72. compatible with one or more ANSI standards
  73. @item @i{Comp.}
  74. computers
  75. @item @i{Idiom.}
  76. idiomatic
  77. @item @i{IEEE}
  78. compatible with one or more IEEE standards
  79. @item @i{ISO}
  80. compatible with one or more ISO standards
  81. @item @i{Math.}
  82. mathematics
  83. @item @i{Trad.}
  84. traditional
  85. @item @i{n.}
  86. noun
  87. @item @i{v.}
  88. verb
  89. @item @i{v.t.}
  90. transitive verb
  91. @end table
  92. @table @asis
  93. @subheading @b{Non-alphabetic}
  94. @table @asis
  95. @IGindex{()}
  96. @item @b{()}
  97. pronounced 'nil , @i{n.}
  98. an alternative notation for writing the symbol~@b{nil}, used to emphasize
  99. the use of @i{nil} as an @i{empty list}.
  100. @end table
  101. @subheading @b{A}
  102. @table @asis
  103. @IGindex{absolute}
  104. @item @b{absolute}
  105. @i{adj.}
  106. 1. (of a @i{time})
  107. representing a specific point in time.
  108. 2. (of a @i{pathname})
  109. representing a specific position in a directory hierarchy.
  110. See @i{relative}.
  111. @IGindex{access}
  112. @item @b{access}
  113. @i{n.}, @i{v.t.}
  114. 1. @i{v.t.} (a @i{place}, or @i{array})
  115. to @i{read}_1 or @i{write}_1 the @i{value} of
  116. the @i{place}
  117. or an @i{element} of the @i{array}.
  118. 2. @i{n.} (of a @i{place})
  119. an attempt to @i{access}_1 the @i{value} of the @i{place}.
  120. @IGindex{accessibility}
  121. @item @b{accessibility}
  122. @i{n.}
  123. the state of being @i{accessible}.
  124. @IGindex{accessible}
  125. @item @b{accessible}
  126. @i{adj.}
  127. 1. (of an @i{object}) capable of being @i{referenced}.
  128. 2. (of @i{shared slots} or @i{local slots} in an @i{instance} of
  129. a @i{class}) having been defined by the @i{class}
  130. of the @i{instance} or @i{inherited} from a
  131. @i{superclass} of that @i{class}.
  132. 3. (of a @i{symbol} in a @i{package})
  133. capable of being @i{referenced} without a @i{package prefix}
  134. when that @i{package} is current, regardless of whether the
  135. @i{symbol} is @i{present} in that @i{package} or is @i{inherited}.
  136. @IGindex{accessor}
  137. @item @b{accessor}
  138. @i{n.}
  139. an @i{operator} that performs an @i{access}.
  140. See @i{reader} and @i{writer}.
  141. @IGindex{active}
  142. @item @b{active}
  143. @i{adj.}
  144. 1. (of a @i{handler}, a @i{restart}, or a @i{catch tag})
  145. having been @i{established} but not yet @i{disestablished}.
  146. 2. (of an @i{element} of an @i{array})
  147. having an index that is greater than or equal to zero,
  148. but less than the @i{fill pointer} (if any).
  149. For an @i{array} that has no @i{fill pointer},
  150. all @i{elements} are considered @i{active}.
  151. @IGindex{actual adjustability}
  152. @item @b{actual adjustability}
  153. @i{n.} (of an @i{array})
  154. a @i{generalized boolean} that is associated with the @i{array},
  155. representing whether the @i{array} is @i{actually adjustable}.
  156. See also @i{expressed adjustability} and @b{adjustable-array-p}.
  157. @IGindex{actual argument}
  158. @item @b{actual argument}
  159. @i{n.} @i{Trad.}
  160. an @i{argument}.
  161. @IGindex{actual array element type}
  162. @item @b{actual array element type}
  163. @i{n.} (of an @i{array})
  164. the @i{type} for which the @i{array} is actually specialized,
  165. which is the @i{upgraded array element type} of
  166. the @i{expressed array element type} of the @i{array}.
  167. See the @i{function} @b{array-element-type}.
  168. @IGindex{actual complex part type}
  169. @item @b{actual complex part type}
  170. @i{n.} (of a @i{complex})
  171. the @i{type} in which the real and imaginary parts of the @i{complex}
  172. are actually represented, which is the @i{upgraded complex part type} of the
  173. @i{expressed complex part type} of the @i{complex}.
  174. @IGindex{actual parameter}
  175. @item @b{actual parameter}
  176. @i{n.} @i{Trad.}
  177. an @i{argument}.
  178. @IGindex{actually adjustable}
  179. @item @b{actually adjustable}
  180. @i{adj.} (of an @i{array})
  181. such that @b{adjust-array} can adjust its characteristics
  182. by direct modification.
  183. A @i{conforming program} may depend on
  184. an @i{array} being @i{actually adjustable}
  185. only if either that @i{array} is known to have been @i{expressly adjustable}
  186. or if that @i{array} has been explicitly tested by @b{adjustable-array-p}.
  187. @IGindex{adjustability}
  188. @item @b{adjustability}
  189. @i{n.} (of an @i{array})
  190. 1. @i{expressed adjustability}.
  191. 2. @i{actual adjustability}.
  192. @IGindex{adjustable}
  193. @item @b{adjustable}
  194. @i{adj.} (of an @i{array})
  195. 1. @i{expressly adjustable}.
  196. 2. @i{actually adjustable}.
  197. @IGindex{after method}
  198. @item @b{after method}
  199. @i{n.}
  200. a @i{method} having the @i{qualifier} @t{:after}.
  201. @IGindex{alist}
  202. @item @b{alist}
  203. pronounced '\=a ,list , @i{n.}
  204. an @i{association list}.
  205. @IGindex{alphabetic}
  206. @item @b{alphabetic}
  207. @i{n.}, @i{adj.}
  208. 1. @i{adj.} (of a @i{character})
  209. being one of the @i{standard characters} @t{A} through @t{Z}
  210. or @t{a} through @t{z},
  211. or being any @i{implementation-defined} character that has @i{case},
  212. or being some other @i{graphic} @i{character}
  213. defined by the @i{implementation} to be @i{alphabetic}_1.
  214. 2. a. @i{n.}
  215. one of several possible @i{constituent traits} of a @i{character}.
  216. For details, see @ref{Constituent Characters} and @ref{Reader Algorithm}.
  217. b. @i{adj.} (of a @i{character})
  218. being a @i{character}
  219. that has @i{syntax type} @i{constituent} in the @i{current readtable}
  220. and that has the @i{constituent trait} @i{alphabetic}_@{2a@}.
  221. See @i{Figure~2--8}.
  222. @IGindex{alphanumeric}
  223. @item @b{alphanumeric}
  224. @i{adj.} (of a @i{character})
  225. being either an @i{alphabetic}_1 @i{character}
  226. or a @i{numeric} {character}.
  227. @IGindex{ampersand}
  228. @item @b{ampersand}
  229. @i{n.}
  230. the @i{standard character} that is called ``ampersand'' (@t{&}).
  231. See @i{Figure~2--5}.
  232. @IGindex{anonymous}
  233. @item @b{anonymous}
  234. @i{adj.}
  235. 1. (of a @i{class} or @i{function}) having no @i{name}
  236. 2. (of a @i{restart}) having a @i{name} of @b{nil}.
  237. @IGindex{apparently uninterned}
  238. @item @b{apparently uninterned}
  239. @i{adj.}
  240. having a @i{home package} of @b{nil}. (An @i{apparently uninterned} @i{symbol}
  241. might or might not be an @i{uninterned} @i{symbol}. @i{Uninterned symbols}
  242. have a @i{home package} of @b{nil}, but @i{symbols} which have been @i{uninterned}
  243. from their @i{home package} also have a @i{home package} of @b{nil},
  244. even though they might still be @i{interned} in some other @i{package}.)
  245. @IGindex{applicable}
  246. @item @b{applicable}
  247. @i{adj.}
  248. 1. (of a @i{handler}) being an @i{applicable handler}.
  249. 2. (of a @i{method}) being an @i{applicable method}.
  250. 3. (of a @i{restart}) being an @i{applicable restart}.
  251. @IGindex{applicable handler}
  252. @item @b{applicable handler}
  253. @i{n.} (for a @i{condition} being @i{signaled})
  254. an @i{active} @i{handler} for which the associated type contains the
  255. @i{condition}.
  256. @IGindex{applicable method}
  257. @item @b{applicable method}
  258. @i{n.} (of a @i{generic function}
  259. called with @i{arguments})
  260. a @i{method} of the @i{generic function} for which the
  261. @i{arguments} satisfy the @i{parameter specializers}
  262. of that @i{method}.
  263. See @ref{Selecting the Applicable Methods}.
  264. @IGindex{applicable restart}
  265. @item @b{applicable restart}
  266. @i{n.}
  267. 1. (for a @i{condition})
  268. an @i{active} @i{handler} for which the associated test returns
  269. @i{true} when given the @i{condition} as an argument.
  270. 2. (for no particular @i{condition})
  271. an @i{active} @i{handler} for which the associated test returns
  272. @i{true} when given @b{nil} as an argument.
  273. @IGindex{apply}
  274. @item @b{apply}
  275. @i{v.t.} (a @i{function} to a @i{list})
  276. to @i{call} the @i{function} with arguments that are the @i{elements}
  277. of the @i{list}.
  278. {``Applying the function @b{+} to a list of integers returns
  279. the sum of the elements of that list.''}
  280. @IGindex{argument}
  281. @item @b{argument}
  282. @i{n.}
  283. 1. (of a @i{function}) an @i{object} which is offered as data
  284. to the @i{function} when it is @i{called}.
  285. 2. (of a @i{format control}) a @i{format argument}.
  286. @IGindex{argument evaluation order}
  287. @item @b{argument evaluation order}
  288. @i{n.}
  289. the order in which @i{arguments} are evaluated in a function call.
  290. {``The argument evaluation order for Common Lisp is left to right.''}
  291. See @ref{Evaluation}.
  292. @IGindex{argument precedence order}
  293. @item @b{argument precedence order}
  294. @i{n.}
  295. the order in which the @i{arguments} to a @i{generic function} are
  296. considered when sorting the @i{applicable methods} into precedence order.
  297. @IGindex{around method}
  298. @item @b{around method}
  299. @i{n.}
  300. a @i{method} having the @i{qualifier} @t{:around}.
  301. @IGindex{array}
  302. @item @b{array}
  303. @i{n.}
  304. an @i{object} of @i{type} @b{array}, which serves as a container for other
  305. @i{objects} arranged in a Cartesian coordinate system.
  306. @IGindex{array element type}
  307. @item @b{array element type}
  308. @i{n.} (of an @i{array})
  309. 1. a @i{type} associated with the @i{array},
  310. and of which all @i{elements} of the @i{array} are
  311. constrained to be members.
  312. 2. the @i{actual array element type} of the @i{array}.
  313. 3. the @i{expressed array element type} of the @i{array}.
  314. @IGindex{array total size}
  315. @item @b{array total size}
  316. @i{n.}
  317. the total number of @i{elements} in an @i{array}, computed by taking
  318. the product of the @i{dimensions} of the @i{array}.
  319. (The size of a zero-dimensional @i{array} is therefore one.)
  320. @IGindex{assign}
  321. @item @b{assign}
  322. @i{v.t.} (a @i{variable})
  323. to change the @i{value} of the @i{variable} in a @i{binding}
  324. that has already been @i{established}.
  325. See the @i{special operator} @b{setq}.
  326. @IGindex{association list}
  327. @item @b{association list}
  328. @i{n.}
  329. a @i{list} of @i{conses} representing an association
  330. of @i{keys} with @i{values}, where the @i{car} of each
  331. @i{cons} is the @i{key} and the @i{cdr} is the
  332. @i{value} associated with that @i{key}.
  333. @IGindex{asterisk}
  334. @item @b{asterisk}
  335. @i{n.}
  336. the @i{standard character} that is variously called
  337. ``asterisk''
  338. or ``star'' (@t{*}).
  339. See @i{Figure~2--5}.
  340. @IGindex{at-sign}
  341. @item @b{at-sign}
  342. @i{n.}
  343. the @i{standard character} that is variously called
  344. ``commercial at''
  345. or ``at sign'' (@t{@@}).
  346. See @i{Figure~2--5}.
  347. @IGindex{atom}
  348. @item @b{atom}
  349. @i{n.}
  350. any @i{object} that is not a @i{cons}.
  351. {``A vector is an atom.''}
  352. @IGindex{atomic}
  353. @item @b{atomic}
  354. @i{adj.}
  355. being an @i{atom}.
  356. {``The number 3, the symbol @t{foo}, and @b{nil} are atomic.''}
  357. @IGindex{atomic type specifier}
  358. @item @b{atomic type specifier}
  359. @i{n.}
  360. a @i{type specifier} that is @i{atomic}.
  361. For every @i{atomic type specifier}, @i{x}, there is an equivalent
  362. @i{compound type specifier} with no arguments supplied, @t{(@i{x})}.
  363. @IGindex{attribute}
  364. @item @b{attribute}
  365. @i{n.} (of a @i{character})
  366. a program-visible aspect of the @i{character}.
  367. The only @i{standardized} @i{attribute} of a @i{character}
  368. is its @i{code}_2, but @i{implementations} are permitted to have
  369. additional @i{implementation-defined} @i{attributes}.
  370. See @ref{Character Attributes}.
  371. {``An implementation that support fonts
  372. might make font information an attribute of a character,
  373. while others might represent font information separately from characters.''}
  374. @IGindex{aux variable}
  375. @item @b{aux variable}
  376. @i{n.}
  377. a @i{variable} that occurs in the part of a @i{lambda list}
  378. that was introduced by @b{&aux}. Unlike all other @i{variables}
  379. introduced by a @i{lambda-list}, @i{aux variables} are not
  380. @i{parameters}.
  381. @IGindex{auxiliary method}
  382. @item @b{auxiliary method}
  383. @i{n.}
  384. a member of one of two sets of @i{methods}
  385. (the set of @i{primary methods} is the other)
  386. that form an exhaustive partition of the set of @i{methods}
  387. on the @i{method}'s @i{generic function}.
  388. How these sets are determined is dependent on the @i{method combination} type;
  389. see @ref{Introduction to Methods}.
  390. @end table
  391. @subheading @b{B}
  392. @table @asis
  393. @IGindex{backquote}
  394. @item @b{backquote}
  395. @i{n.}
  396. the @i{standard character} that is variously called
  397. ``grave accent''
  398. or ``backquote'' (@t{`}).
  399. See @i{Figure~2--5}.
  400. @IGindex{backslash}
  401. @item @b{backslash}
  402. @i{n.}
  403. the @i{standard character} that is variously called
  404. ``reverse solidus''
  405. or ``backslash'' (@t{\}).
  406. See @i{Figure~2--5}.
  407. @IGindex{base character}
  408. @item @b{base character}
  409. @i{n.}
  410. a @i{character}
  411. of @i{type} @b{base-char}.
  412. @IGindex{base string}
  413. @item @b{base string}
  414. @i{n.}
  415. a @i{string} of @i{type} @b{base-string}.
  416. @IGindex{before method}
  417. @item @b{before method}
  418. @i{n.}
  419. a @i{method} having the @i{qualifier} @t{:before}.
  420. @IGindex{bidirectional}
  421. @item @b{bidirectional}
  422. @i{adj.} (of a @i{stream})
  423. being both an @i{input} @i{stream} and an @i{output} @i{stream}.
  424. @IGindex{binary}
  425. @item @b{binary}
  426. @i{adj.}
  427. 1. (of a @i{stream})
  428. being a @i{stream} that has an @i{element type} that is a @i{subtype} of @i{type} @b{integer}.
  429. The most fundamental operation on a @i{binary} @i{input} @i{stream}
  430. is @b{read-byte} and on a @i{binary} @i{output} @i{stream}
  431. is @b{write-byte}.
  432. See @i{character}.
  433. 2. (of a @i{file})
  434. having been created by opening a @i{binary} @i{stream}.
  435. (It is @i{implementation-dependent} whether this is an detectable aspect
  436. of the @i{file}, or whether any given @i{character} @i{file} can be
  437. treated as a @i{binary} @i{file}.)
  438. @IGindex{bind}
  439. @item @b{bind}
  440. @i{v.t.} (a @i{variable})
  441. to establish a @i{binding} for the @i{variable}.
  442. @IGindex{binding}
  443. @item @b{binding}
  444. @i{n.}
  445. an association between a @i{name} and that which the @i{name}
  446. denotes.
  447. {``A lexical binding is a lexical association between a
  448. name and its value.''}
  449. @IGindex{bit}
  450. @item @b{bit}
  451. @i{n.}
  452. an @i{object} of @i{type} @b{bit};
  453. that is, the @i{integer} @t{0} or the @i{integer} @t{1}.
  454. @IGindex{bit array}
  455. @item @b{bit array}
  456. @i{n.}
  457. a specialized @i{array} that is of @i{type} @t{(array bit)},
  458. and whose elements are of @i{type} @b{bit}.
  459. @IGindex{bit vector}
  460. @item @b{bit vector}
  461. @i{n.}
  462. a specialized @i{vector} that is of @i{type} @b{bit-vector},
  463. and whose elements are of @i{type} @b{bit}.
  464. @IGindex{bit-wise logical operation specifier}
  465. @item @b{bit-wise logical operation specifier}
  466. @i{n.}
  467. an @i{object} which names one of the sixteen possible bit-wise logical
  468. operations that can be performed by the @b{boole} function,
  469. and which is the @i{value} of exactly one of the
  470. @i{constant variables}
  471. @b{boole-clr}, @b{boole-set},
  472. @b{boole-1}, @b{boole-2},
  473. @b{boole-c1}, @b{boole-c2},
  474. @b{boole-and}, @b{boole-ior},
  475. @b{boole-xor}, @b{boole-eqv},
  476. @b{boole-nand}, @b{boole-nor},
  477. @b{boole-andc1}, @b{boole-andc2},
  478. @b{boole-orc1}, or @b{boole-orc2}.
  479. @IGindex{block}
  480. @item @b{block}
  481. @i{n.}
  482. a named lexical @i{exit point},
  483. @i{established} explicitly by @b{block}
  484. or implicitly by @i{operators}
  485. such as @b{loop}, @b{do} and @b{prog},
  486. to which control and values may be transfered by
  487. using a @b{return-from} @i{form} with the name of the @i{block}.
  488. @IGindex{block tag}
  489. @item @b{block tag}
  490. @i{n.}
  491. the @i{symbol} that, within the @i{lexical scope}
  492. of a @b{block} @i{form}, names the @i{block}
  493. @i{established} by that @b{block} @i{form}.
  494. See @b{return} or @b{return-from}.
  495. @IGindex{boa lambda list}
  496. @item @b{boa lambda list}
  497. @i{n.}
  498. a @i{lambda list} that is syntactically like an @i{ordinary lambda list},
  499. but that is processed in ``@b{b}y @b{o}rder of @b{a}rgument'' style.
  500. See @ref{Boa Lambda Lists}.
  501. @IGindex{body parameter}
  502. @item @b{body parameter}
  503. @i{n.}
  504. a @i{parameter} available in certain @i{lambda lists}
  505. which from the point of view of @i{conforming programs}
  506. is like a @i{rest parameter} in every way except that it is introduced
  507. by @b{&body} instead of @b{&rest}. (@i{Implementations} are
  508. permitted to provide extensions which distinguish @i{body parameters}
  509. and @i{rest parameters}---@i{e.g.}, the @i{forms} for @i{operators}
  510. which were defined using a @i{body parameter} might be pretty printed
  511. slightly differently than @i{forms} for @i{operators} which were
  512. defined using @i{rest parameters}.)
  513. @IGindex{boolean}
  514. @item @b{boolean}
  515. @i{n.}
  516. an @i{object} of @i{type} @b{boolean};
  517. that is, one of the following @i{objects}:
  518. the symbol~@b{t} (representing @i{true}),
  519. or the symbol~@b{nil} (representing @i{false}).
  520. See @i{generalized boolean}.
  521. @IGindex{boolean equivalent}
  522. @item @b{boolean equivalent}
  523. @i{n.} (of an @i{object} O_1)
  524. any @i{object} O_2 that has the same truth value as O_1
  525. when both O_1 and O_2 are viewed as @i{generalized booleans}.
  526. @IGindex{bound}
  527. @item @b{bound}
  528. @i{adj.}, @i{v.t.}
  529. 1. @i{adj.} having an associated denotation in a @i{binding}.
  530. {``The variables named by a @b{let} are bound within
  531. its body.''}
  532. See @i{unbound}.
  533. 2. @i{adj.} having a local @i{binding} which
  534. @i{shadows}_2 another.
  535. {``The variable @b{*print-escape*} is bound while in
  536. the @b{princ} function.''}
  537. 3. @i{v.t.} the past tense of @i{bind}.
  538. @IGindex{bound declaration}
  539. @item @b{bound declaration}
  540. @i{n.}
  541. a @i{declaration} that refers to or is associated with a @i{variable}
  542. or @i{function} and that appears within the @i{special form}
  543. that @i{establishes} the @i{variable} or @i{function},
  544. but before the body of that @i{special form}
  545. (specifically, at the head of that @i{form}'s body).
  546. (If a @i{bound declaration} refers to a @i{function} @i{binding} or
  547. a @i{lexical variable} @i{binding}, the @i{scope} of
  548. the @i{declaration} is exactly the @i{scope} of that
  549. @i{binding}. If the @i{declaration} refers to a
  550. @i{dynamic variable} @i{binding}, the @i{scope} of
  551. the @i{declaration} is what the @i{scope} of the
  552. @i{binding} would have been if it were lexical rather than dynamic.)
  553. @IGindex{bounded}
  554. @item @b{bounded}
  555. @i{adj.} (of a @i{sequence} S,
  556. by an ordered pair
  557. of @i{bounding indices} i_@{start@} and i_@{end@})
  558. restricted to a subrange of the @i{elements} of S that includes each @i{element}
  559. beginning with (and including) the one indexed by i_@{start@} and
  560. continuing up to (but not including) the one indexed by i_@{end@}.
  561. @IGindex{bounding index}
  562. @item @b{bounding index}
  563. @i{n.} (of a @i{sequence} with @i{length} n)
  564. either of a conceptual pair of @i{integers}, i_@{start@} and i_@{end@},
  565. respectively called the ``lower bounding index'' and ``upper bounding index'',
  566. such that 0 <= i_@{start@} <= i_@{end@} <= n, and which therefore delimit
  567. a subrange of the @i{sequence} @i{bounded} by i_@{start@} and i_@{end@}.
  568. @IGindex{bounding index designator}
  569. @item @b{bounding index designator}
  570. (for a @i{sequence})
  571. one of two @i{objects} that, taken together as an ordered pair,
  572. behave as a @i{designator} for @i{bounding indices} of the @i{sequence};
  573. that is, they denote @i{bounding indices} of the @i{sequence},
  574. and are either:
  575. an @i{integer} (denoting itself) and @b{nil}
  576. (denoting the @i{length} of the @i{sequence}),
  577. or two @i{integers} (each denoting themselves).
  578. @IGindex{break loop}
  579. @item @b{break loop}
  580. @i{n.}
  581. A variant of the normal @i{Lisp read-eval-print loop} that is recursively
  582. entered, usually because the ongoing @i{evaluation} of some other @i{form}
  583. has been suspended for the purpose of debugging. Often, a @i{break loop}
  584. provides the ability to exit in such a way as to continue the suspended computation.
  585. See the @i{function} @b{break}.
  586. @IGindex{broadcast stream}
  587. @item @b{broadcast stream}
  588. @i{n.}
  589. an @i{output} @i{stream} of @i{type} @b{broadcast-stream}.
  590. @IGindex{built-in class}
  591. @item @b{built-in class}
  592. @i{n.}
  593. a @i{class} that is a @i{generalized instance} of @i{class} @b{built-in-class}.
  594. @IGindex{built-in type}
  595. @item @b{built-in type}
  596. @i{n.}
  597. one of the @i{types} in @i{Figure~4--2}.
  598. @IGindex{byte}
  599. @item @b{byte}
  600. @i{n.}
  601. 1. adjacent bits within an @i{integer}.
  602. (The specific number of bits can vary from point to point in the program;
  603. see the @i{function} @b{byte}.)
  604. 2. an integer in a specified range.
  605. (The specific range can vary from point to point in the program;
  606. see the @i{functions} @b{open} and @b{write-byte}.)
  607. @IGindex{byte specifier}
  608. @item @b{byte specifier}
  609. @i{n.}
  610. An @i{object} of @i{implementation-dependent} nature
  611. that is returned by the @i{function} @b{byte} and
  612. that specifies the range of bits in an @i{integer} to be used
  613. as a @i{byte} by @i{functions} such as @b{ldb}.
  614. @end table
  615. @subheading @b{C}
  616. @table @asis
  617. @IGindex{cadr}
  618. @item @b{cadr}
  619. pronounced 'ka ,de r , @i{n.} (of an @i{object})
  620. the @i{car} of the @i{cdr} of that @i{object}.
  621. @IGindex{call}
  622. @item @b{call}
  623. @i{v.t.}, @i{n.}
  624. 1. @i{v.t.} (a @i{function} with @i{arguments})
  625. to cause the @i{code} represented by that @i{function} to be
  626. @i{executed} in an @i{environment} where @i{bindings} for
  627. the @i{values} of its @i{parameters} have been @i{established}
  628. based on the @i{arguments}.
  629. {``Calling the function @b{+} with the arguments
  630. @t{5} and @t{1} yields a value of @t{6}.''}
  631. 2. @i{n.} a @i{situation} in which a @i{function} is called.
  632. @IGindex{captured initialization form}
  633. @item @b{captured initialization form}
  634. @i{n.}
  635. an @i{initialization form} along with the @i{lexical environment}
  636. in which the @i{form} that defined the @i{initialization form}
  637. was @i{evaluated}.
  638. {``Each newly added shared slot is set to the result of evaluating
  639. the captured initialization form for the slot that was specified
  640. in the @b{defclass} form for the new class.''}
  641. @IGindex{car}
  642. @item @b{car}
  643. @i{n.}
  644. 1. a. (of a @i{cons})
  645. the component of a @i{cons} corresponding to the first
  646. @i{argument} to @b{cons}; the other component is the
  647. @i{cdr}.
  648. {``The function @b{rplaca} modifies the car of a cons.''}
  649. b. (of a @i{list})
  650. the first @i{element} of the @i{list}, or @b{nil} if the
  651. @i{list} is the @i{empty list}.
  652. 2. the @i{object} that is held in the @i{car}_1.
  653. {``The function @b{car} returns the car of a cons.''}
  654. @IGindex{case}
  655. @item @b{case}
  656. @i{n.} (of a @i{character})
  657. the property of being either @i{uppercase} or @i{lowercase}.
  658. Not all @i{characters} have @i{case}.
  659. {``The characters @t{#\A} and @t{#\a} have case,
  660. but the character @t{#\$} has no case.''}
  661. See @ref{Characters With Case} and the @i{function} @b{both-case-p}.
  662. @IGindex{case sensitivity mode}
  663. @item @b{case sensitivity mode}
  664. @i{n.}
  665. one of the @i{symbols}
  666. @t{:upcase}, @t{:downcase}, @t{:preserve}, or @t{:invert}.
  667. @IGindex{catch}
  668. @item @b{catch}
  669. @i{n.}
  670. an @i{exit point} which is @i{established} by a @b{catch}
  671. @i{form} within the @i{dynamic scope} of its body,
  672. which is named by a @i{catch tag},
  673. and to which control and @i{values} may be @i{thrown}.
  674. @IGindex{catch tag}
  675. @item @b{catch tag}
  676. @i{n.}
  677. an @i{object} which names an @i{active} @i{catch}.
  678. (If more than one @i{catch} is active with the same @i{catch tag},
  679. it is only possible to @i{throw} to the innermost such @i{catch}
  680. because the outer one is @i{shadowed}_2.)
  681. @IGindex{cddr}
  682. @item @b{cddr}
  683. pronounced 'kud e ,de r or
  684. pronounced 'ke ,dude r , @i{n.}
  685. (of an @i{object})
  686. the @i{cdr} of the @i{cdr} of that @i{object}.
  687. @IGindex{cdr}
  688. @item @b{cdr}
  689. pronounced 'ku ,de r , @i{n.}
  690. 1. a. (of a @i{cons})
  691. the component of a @i{cons} corresponding to the second @i{argument}
  692. to @b{cons}; the other component is the @i{car}.
  693. {``The function @b{rplacd} modifies the cdr of a cons.''}
  694. b. (of a @i{list} L_1)
  695. either the @i{list} L_2 that contains
  696. the @i{elements} of L_1 that follow after the first,
  697. or else @b{nil} if L_1 is the @i{empty list}.
  698. 2. the @i{object} that is held in the @i{cdr}_1.
  699. {``The function @b{cdr} returns the cdr of a cons.''}
  700. @IGindex{cell}
  701. @item @b{cell}
  702. @i{n.} @i{Trad.} (of an @i{object})
  703. a conceptual @i{slot} of that @i{object}.
  704. The @i{dynamic variable} and global @i{function} @i{bindings}
  705. of a @i{symbol} are sometimes referred to as its @i{value cell}
  706. and @i{function cell}, respectively.
  707. @IGindex{character}
  708. @item @b{character}
  709. @i{n.}, @i{adj.}
  710. 1. @i{n.} an @i{object} of @i{type} @b{character}; that is,
  711. an @i{object} that represents a unitary token in an aggregate quantity of text;
  712. see @ref{Character Concepts}.
  713. 2. @i{adj.}
  714. a. (of a @i{stream})
  715. having an @i{element type} that is a @i{subtype} of @i{type} @b{character}.
  716. The most fundamental operation on a @i{character} @i{input} @i{stream}
  717. is @b{read-char} and on a @i{character} @i{output} @i{stream}
  718. is @b{write-char}. See @i{binary}.
  719. b. (of a @i{file})
  720. having been created by opening a @i{character} @i{stream}.
  721. (It is @i{implementation-dependent} whether this is an inspectable aspect
  722. of the @i{file}, or whether any given @i{binary} @i{file} can be
  723. treated as a @i{character} @i{file}.)
  724. @IGindex{character code}
  725. @item @b{character code}
  726. @i{n.}
  727. 1. one of possibly several @i{attributes} of a @i{character}.
  728. 2. a non-negative @i{integer} less than the @i{value} of @b{char-code-limit}
  729. that is suitable for use as a @i{character code}_1.
  730. @IGindex{character designator}
  731. @item @b{character designator}
  732. @i{n.}
  733. a @i{designator} for a @i{character}; that is,
  734. an @i{object} that denotes a @i{character}
  735. and that is one of:
  736. a @i{designator} for a @i{string} of @i{length} one
  737. (denoting the @i{character} that is its only @i{element}),
  738. or a @i{character} (denoting itself).
  739. @IGindex{circular}
  740. @item @b{circular}
  741. @i{adj.}
  742. 1. (of a @i{list}) a @i{circular list}.
  743. 2. (of an arbitrary @i{object})
  744. having a @i{component}, @i{element}, @i{constituent}_2,
  745. or @i{subexpression} (as appropriate to the context)
  746. that is the @i{object} itself.
  747. @IGindex{circular list}
  748. @item @b{circular list}
  749. @i{n.}
  750. a chain of @i{conses} that has no termination because some
  751. @i{cons} in the chain is the @i{cdr} of a later @i{cons}.
  752. @IGindex{class}
  753. @item @b{class}
  754. @i{n.}
  755. 1. an @i{object} that uniquely determines the structure and behavior of
  756. a set of other @i{objects} called its @i{direct instances},
  757. that contributes structure and behavior to a set of
  758. other @i{objects} called its @i{indirect instances},
  759. and that acts as a @i{type specifier} for a set of objects
  760. called its @i{generalized instances}.
  761. {``The class @b{integer} is a subclass of the class @b{number}.''}
  762. (Note that the phrase ``the @i{class} @t{foo}'' is often substituted for
  763. the more precise phrase ``the @i{class} named @t{foo}''---in both
  764. cases, a @i{class} @i{object} (not a @i{symbol}) is denoted.)
  765. 2. (of an @i{object})
  766. the uniquely determined @i{class} of which the @i{object} is
  767. a @i{direct instance}.
  768. See the @i{function} @b{class-of}.
  769. {``The class of the object returned by @b{gensym}
  770. is @b{symbol}.''}
  771. (Note that with this usage a phrase such as ``its @i{class} is @t{foo}''
  772. is often substituted for the more precise phrase
  773. ``its @i{class} is the @i{class} named @t{foo}''---in both
  774. cases, a @i{class} @i{object} (not a @i{symbol}) is denoted.)
  775. @IGindex{class designator}
  776. @item @b{class designator}
  777. @i{n.}
  778. a @i{designator} for a @i{class}; that is,
  779. an @i{object} that denotes a @i{class}
  780. and that is one of:
  781. a @i{symbol} (denoting the @i{class} named by that @i{symbol};
  782. see the @i{function} @b{find-class})
  783. or a @i{class} (denoting itself).
  784. @IGindex{class precedence list}
  785. @item @b{class precedence list}
  786. @i{n.}
  787. a unique total ordering on a @i{class}
  788. and its @i{superclasses} that is consistent with the
  789. @i{local precedence orders} for the @i{class} and its
  790. @i{superclasses}.
  791. For detailed information, see @ref{Determining the Class Precedence List}.
  792. @IGindex{close}
  793. @item @b{close}
  794. @i{v.t.} (a @i{stream})
  795. to terminate usage of the @i{stream} as a source or sink of data,
  796. permitting the @i{implementation} to reclaim its internal data structures,
  797. and to free any external resources which might have been locked by the
  798. @i{stream} when it was opened.
  799. @IGindex{closed}
  800. @item @b{closed}
  801. @i{adj.} (of a @i{stream})
  802. having been @i{closed} (see @i{@i}{close}).
  803. Some (but not all) operations that are valid on @i{open} @i{streams}
  804. are not valid on @i{closed} @i{streams}.
  805. See @ref{File Operations on Open and Closed Streams}.
  806. @IGindex{closure}
  807. @item @b{closure}
  808. @i{n.}
  809. a @i{lexical closure}.
  810. @IGindex{coalesce}
  811. @item @b{coalesce}
  812. @i{v.t.} (@i{literal objects} that are @i{similar})
  813. to consolidate the identity of those @i{objects},
  814. such that they become the @i{same}
  815. @i{object}.
  816. See @ref{Compiler Terminology}.
  817. @IGindex{code}
  818. @item @b{code}
  819. @i{n.}
  820. 1. @i{Trad.}
  821. any representation of actions to be performed, whether conceptual
  822. or as an actual @i{object}, such as
  823. @i{forms},
  824. @i{lambda expressions},
  825. @i{objects} of @i{type} @i{function},
  826. text in a @i{source file},
  827. or instruction sequences in a @i{compiled file}.
  828. This is a generic term;
  829. the specific nature of the representation depends on its context.
  830. 2. (of a @i{character})
  831. a @i{character code}.
  832. @IGindex{coerce}
  833. @item @b{coerce}
  834. @i{v.t.} (an @i{object} to a @i{type})
  835. to produce an @i{object} from the given @i{object},
  836. without modifying that @i{object},
  837. by following some set of coercion rules that must be specifically
  838. stated for any context in which this term is used.
  839. The resulting @i{object} is necessarily of the indicated @i{type},
  840. except when that type is a @i{subtype} of @i{type} @b{complex}; in that case,
  841. if a @i{complex rational} with an imaginary part of zero would result,
  842. the result is a @i{rational}
  843. rather than a @i{complex}---see @ref{Rule of Canonical Representation for Complex Rationals}.
  844. @IGindex{colon}
  845. @item @b{colon}
  846. @i{n.}
  847. the @i{standard character} that is called ``colon'' (@t{:}).
  848. See @i{Figure~2--5}.
  849. @IGindex{comma}
  850. @item @b{comma}
  851. @i{n.}
  852. the @i{standard character} that is called ``comma'' (@t{,}).
  853. See @i{Figure~2--5}.
  854. @IGindex{compilation}
  855. @item @b{compilation}
  856. @i{n.}
  857. the process of @i{compiling} @i{code} by the @i{compiler}.
  858. @IGindex{compilation environment}
  859. @item @b{compilation environment}
  860. @i{n.}
  861. 1. An @i{environment} that represents information known by the
  862. @i{compiler} about a @i{form} that is being @i{compiled}.
  863. See @ref{Compiler Terminology}.
  864. 2. An @i{object} that represents the
  865. @i{compilation environment}_1
  866. and that is used as a second argument to a @i{macro function}
  867. (which supplies a @i{value} for any @b{&environment} @i{parameter}
  868. in the @i{macro function}'s definition).
  869. @IGindex{compilation unit}
  870. @item @b{compilation unit}
  871. @i{n.}
  872. an interval during which a single unit of compilation is occurring.
  873. See the @i{macro} @b{with-compilation-unit}.
  874. @IGindex{compile}
  875. @item @b{compile}
  876. @i{v.t.}
  877. 1. (@i{code})
  878. to perform semantic preprocessing of the @i{code}, usually optimizing
  879. one or more qualities of the code, such as run-time speed of @i{execution}
  880. or run-time storage usage. The minimum semantic requirements of compilation are
  881. that it must remove all macro calls and arrange for all @i{load time values}
  882. to be resolved prior to run time.
  883. 2. (a @i{function})
  884. to produce a new @i{object} of @i{type} @b{compiled-function}
  885. which represents the result of @i{compiling} the @i{code}
  886. represented by the @i{function}. See the @i{function} @b{compile}.
  887. 3. (a @i{source file})
  888. to produce a @i{compiled file} from a @i{source file}.
  889. See the @i{function} @b{compile-file}.
  890. @IGindex{compile time}
  891. @item @b{compile time}
  892. @i{n.}
  893. the duration of time that the @i{compiler} is processing @i{source code}.
  894. @IGindex{compile-time definition}
  895. @item @b{compile-time definition}
  896. @i{n.}
  897. a definition in the @i{compilation environment}.
  898. @IGindex{compiled code}
  899. @item @b{compiled code}
  900. @i{n.}
  901. 1. @i{compiled functions}.
  902. 2. @i{code} that represents @i{compiled functions},
  903. such as the contents of a @i{compiled file}.
  904. @IGindex{compiled file}
  905. @item @b{compiled file}
  906. @i{n.}
  907. a @i{file} which represents the results of @i{compiling} the
  908. @i{forms} which appeared in a corresponding @i{source file},
  909. and which can be @i{loaded}. See the @i{function} @b{compile-file}.
  910. @IGindex{compiled function}
  911. @item @b{compiled function}
  912. @i{n.}
  913. an @i{object} of @i{type} @b{compiled-function}, which is a @i{function}
  914. that has been @i{compiled}, which contains no references to @i{macros} that
  915. must be expanded at run time, and which contains no unresolved references
  916. to @i{load time values}.
  917. @IGindex{compiler}
  918. @item @b{compiler}
  919. @i{n.}
  920. a facility that is part of Lisp and that translates @i{code}
  921. into an @i{implementation-dependent} form
  922. that might be represented or @i{executed} efficiently.
  923. The functions @b{compile} and @b{compile-file}
  924. permit programs to invoke the @i{compiler}.
  925. @IGindex{compiler macro}
  926. @item @b{compiler macro}
  927. @i{n.}
  928. an auxiliary macro definition for a globally defined @i{function}
  929. or @i{macro} which might or might not be called by any given
  930. @i{conforming implementation} and which must preserve the semantics
  931. of the globally defined @i{function} or @i{macro} but which might
  932. perform some additional optimizations. (Unlike a @i{macro},
  933. a @i{compiler macro} does not extend the syntax of @r{Common Lisp}; rather, it
  934. provides an alternate implementation strategy for some existing syntax
  935. or functionality.)
  936. @IGindex{compiler macro expansion}
  937. @item @b{compiler macro expansion}
  938. @i{n.}
  939. 1. the process of translating a @i{form} into another @i{form}
  940. by a @i{compiler macro}.
  941. 2. the @i{form} resulting from this process.
  942. @IGindex{compiler macro form}
  943. @item @b{compiler macro form}
  944. @i{n.}
  945. a @i{function form} or @i{macro form} whose @i{operator}
  946. has a definition as a @i{compiler macro},
  947. or a @b{funcall} @i{form} whose first @i{argument} is a
  948. @b{function} @i{form} whose @i{argument} is the @i{name}
  949. of a @i{function} that has a definition as a @i{compiler macro}.
  950. @IGindex{compiler macro function}
  951. @item @b{compiler macro function}
  952. @i{n.}
  953. a @i{function} of two arguments, a @i{form} and an
  954. @i{environment}, that implements @i{compiler macro expansion} by
  955. producing either a @i{form} to be used in place of the original
  956. argument @i{form} or else @b{nil}, indicating that the original @i{form}
  957. should not be replaced. See @ref{Compiler Macros}.
  958. @IGindex{complex}
  959. @item @b{complex}
  960. @i{n.}
  961. an @i{object} of @i{type} @b{complex}.
  962. @IGindex{complex float}
  963. @item @b{complex float}
  964. @i{n.}
  965. an @i{object} of @i{type} @b{complex} which has a @i{complex part type}
  966. that is a @i{subtype} of @b{float}.
  967. A @i{complex float} is a @i{complex},
  968. but it is not a @i{float}.
  969. @IGindex{complex part type}
  970. @item @b{complex part type}
  971. @i{n.} (of a @i{complex})
  972. 1. the @i{type} which is used to represent both the real part
  973. and the imaginary part of the @i{complex}.
  974. 2. the @i{actual complex part type} of the @i{complex}.
  975. 3. the @i{expressed complex part type} of the @i{complex}.
  976. @IGindex{complex rational}
  977. @item @b{complex rational}
  978. @i{n.}
  979. an @i{object} of @i{type} @b{complex} which has a @i{complex part type}
  980. that is a @i{subtype} of @b{rational}.
  981. A @i{complex rational} is a @i{complex}, but it is not a @i{rational}.
  982. No @i{complex rational} has an imaginary part of zero because such a
  983. number is always represented by @r{Common Lisp} as an @i{object} of @i{type} @b{rational};
  984. see @ref{Rule of Canonical Representation for Complex Rationals}.
  985. @IGindex{complex single float}
  986. @item @b{complex single float}
  987. @i{n.}
  988. an @i{object} of @i{type} @b{complex} which has a @i{complex part type}
  989. that is a @i{subtype} of @b{single-float}.
  990. A @i{complex single float} is a @i{complex},
  991. but it is not a @i{single float}.
  992. @IGindex{composite stream}
  993. @item @b{composite stream}
  994. @i{n.}
  995. a @i{stream} that is composed of one or more other @i{streams}.
  996. {``@b{make-synonym-stream} creates a composite stream.''}
  997. @IGindex{compound form}
  998. @item @b{compound form}
  999. @i{n.}
  1000. a @i{non-empty} @i{list} which is a @i{form}:
  1001. a @i{special form},
  1002. a @i{lambda form},
  1003. a @i{macro form},
  1004. or a @i{function form}.
  1005. @IGindex{compound type specifier}
  1006. @item @b{compound type specifier}
  1007. @i{n.}
  1008. a @i{type specifier} that is a @i{cons};
  1009. @i{i.e.}, a @i{type specifier} that is not an @i{atomic type specifier}.
  1010. {``@t{(vector single-float)} is a compound type specifier.''}
  1011. @IGindex{concatenated stream}
  1012. @item @b{concatenated stream}
  1013. @i{n.}
  1014. an @i{input} @i{stream} of @i{type} @b{concatenated-stream}.
  1015. @IGindex{condition}
  1016. @item @b{condition}
  1017. @i{n.}
  1018. 1. an @i{object} which represents a @i{situation}---usually,
  1019. but not necessarily, during @i{signaling}.
  1020. 2. an @i{object} of @i{type} @b{condition}.
  1021. @IGindex{condition designator}
  1022. @item @b{condition designator}
  1023. @i{n.}
  1024. one or more @i{objects} that, taken together,
  1025. denote either an existing @i{condition} @i{object}
  1026. or a @i{condition} @i{object} to be implicitly created.
  1027. For details, see @ref{Condition Designators}.
  1028. @IGindex{condition handler}
  1029. @item @b{condition handler}
  1030. @i{n.}
  1031. a @i{function} that might be invoked by the act of @i{signaling},
  1032. that receives the @i{condition} being signaled as its only argument,
  1033. and that is permitted to @i{handle} the @i{condition}
  1034. or to @i{decline}. See @ref{Signaling}.
  1035. @IGindex{condition reporter}
  1036. @item @b{condition reporter}
  1037. @i{n.}
  1038. a @i{function} that describes how a @i{condition} is to be printed
  1039. when the @i{Lisp printer} is invoked while @b{*print-escape*}
  1040. is @i{false}. See @ref{Printing Conditions}.
  1041. @IGindex{conditional newline}
  1042. @item @b{conditional newline}
  1043. @i{n.}
  1044. a point in output where a @i{newline} might be inserted at the
  1045. discretion of the @i{pretty printer}.
  1046. There are four kinds of @i{conditional newlines},
  1047. called ``linear-style,''
  1048. ``fill-style,''
  1049. ``miser-style,''
  1050. and ``mandatory-style.''
  1051. See the @i{function} @b{pprint-newline} and @ref{Dynamic Control of the Arrangement of Output}.
  1052. @IGindex{conformance}
  1053. @item @b{conformance}
  1054. @i{n.}
  1055. a state achieved by proper and complete adherence to the requirements
  1056. of this specification. See @ref{Conformance}.
  1057. @IGindex{conforming code}
  1058. @item @b{conforming code}
  1059. @i{n.}
  1060. @i{code} that is all of part of a @i{conforming program}.
  1061. @IGindex{conforming implementation}
  1062. @item @b{conforming implementation}
  1063. @i{n.}
  1064. an @i{implementation}, used to emphasize complete and correct
  1065. adherance to all conformance criteria.
  1066. A @i{conforming implementation} is capable of
  1067. accepting a @i{conforming program} as input,
  1068. preparing that @i{program} for @i{execution},
  1069. and executing the prepared @i{program} in accordance with this specification.
  1070. An @i{implementation} which
  1071. has been extended may still be a @i{conforming implementation}
  1072. provided that no extension interferes with the correct function of any
  1073. @i{conforming program}.
  1074. @IGindex{conforming processor}
  1075. @item @b{conforming processor}
  1076. @i{n.} @i{ANSI}
  1077. a @i{conforming implementation}.
  1078. @IGindex{conforming program}
  1079. @item @b{conforming program}
  1080. @i{n.}
  1081. a @i{program}, used to emphasize the fact that the @i{program}
  1082. depends for its correctness only upon documented aspects of @r{Common Lisp}, and
  1083. can therefore be expected to run correctly in any @i{conforming implementation}.
  1084. @IGindex{congruent}
  1085. @item @b{congruent}
  1086. @i{n.}
  1087. conforming to the rules of @i{lambda list} congruency, as detailed in
  1088. @ref{Congruent Lambda-lists for all Methods of a Generic Function}.
  1089. @IGindex{cons}
  1090. @item @b{cons}
  1091. @i{n.}@i{v.}
  1092. 1. @i{n.} a compound data @i{object} having two components called the
  1093. @i{car} and the @i{cdr}.
  1094. 2. @i{v.} to create such an @i{object}.
  1095. 3. @i{v.} @i{Idiom.} to create any @i{object}, or to allocate storage.
  1096. @IGindex{constant}
  1097. @item @b{constant}
  1098. @i{n.}
  1099. 1. a @i{constant form}.
  1100. 2. a @i{constant variable}.
  1101. 3. a @i{constant object}.
  1102. 4. a @i{self-evaluating object}.
  1103. @IGindex{constant form}
  1104. @item @b{constant form}
  1105. @i{n.}
  1106. any @i{form}
  1107. for which @i{evaluation} always @i{yields} the same @i{value},
  1108. that neither affects nor is affected by the @i{environment}
  1109. in which it is @i{evaluated} (except that it is permitted to
  1110. refer to the names of @i{constant variables}
  1111. defined in the @i{environment}),
  1112. and
  1113. that neither affects nor is affected by the state of any @i{object}
  1114. except those @i{objects} that are @i{otherwise inaccessible parts}
  1115. of @i{objects} created by the @i{form} itself.
  1116. {``A @b{car} form in which the argument is a
  1117. @b{quote} form is a constant form.''}
  1118. @IGindex{constant object}
  1119. @item @b{constant object}
  1120. @i{n.}
  1121. an @i{object} that is constrained (@i{e.g.}, by its context in a @i{program}
  1122. or by the source from which it was obtained) to be @i{immutable}.
  1123. {``A literal object that has been processed by @b{compile-file}
  1124. is a constant object.''}
  1125. @IGindex{constant variable}
  1126. @item @b{constant variable}
  1127. @i{n.}
  1128. a @i{variable}, the @i{value} of which can never change;
  1129. that is, a @i{keyword}_1 or a @i{named constant}.
  1130. {``The symbols @b{t}, @b{nil}, @t{:direction}, and
  1131. @b{most-positive-fixnum} are constant variables.''}
  1132. @IGindex{constituent}
  1133. @item @b{constituent}
  1134. @i{n.}, @i{adj.}
  1135. 1. a. @i{n.} the @i{syntax type} of a @i{character} that is part of a @i{token}.
  1136. For details, see @ref{Constituent Characters}.
  1137. b. @i{adj.} (of a @i{character})
  1138. having the @i{constituent}_@{1a@} @i{syntax type}_2.
  1139. c. @i{n.} a @i{constituent}_@{1b@} @i{character}.
  1140. 2. @i{n.} (of a @i{composite stream})
  1141. one of possibly several @i{objects} that collectively comprise
  1142. the source or sink of that @i{stream}.
  1143. @IGindex{constituent trait}
  1144. @item @b{constituent trait}
  1145. @i{n.} (of a @i{character})
  1146. one of several classifications of a @i{constituent} @i{character}
  1147. in a @i{readtable}. See @ref{Constituent Characters}.
  1148. @IGindex{constructed stream}
  1149. @item @b{constructed stream}
  1150. @i{n.}
  1151. a @i{stream} whose source or sink is a Lisp @i{object}.
  1152. Note that since a @i{stream} is another Lisp @i{object},
  1153. @i{composite streams} are considered @i{constructed streams}.
  1154. {``A string stream is a constructed stream.''}
  1155. @IGindex{contagion}
  1156. @item @b{contagion}
  1157. @i{n.}
  1158. a process whereby operations on @i{objects} of differing @i{types}
  1159. (@i{e.g.}, arithmetic on mixed @i{types} of @i{numbers}) produce a result
  1160. whose @i{type} is controlled by the dominance of one @i{argument}'s
  1161. @i{type} over the @i{types} of the other @i{arguments}.
  1162. See @ref{Contagion in Numeric Operations}.
  1163. @IGindex{continuable}
  1164. @item @b{continuable}
  1165. @i{n.} (of an @i{error})
  1166. an @i{error} that is @i{correctable} by the @t{continue} restart.
  1167. @IGindex{control form}
  1168. @item @b{control form}
  1169. @i{n.}
  1170. 1. a @i{form} that establishes one or more places to which control
  1171. can be transferred.
  1172. 2. a @i{form} that transfers control.
  1173. @IGindex{copy}
  1174. @item @b{copy}
  1175. @i{n.}
  1176. 1. (of a @i{cons} C)
  1177. a @i{fresh} @i{cons} with the @i{same} @i{car} and @i{cdr} as C.
  1178. 2. (of a @i{list} L)
  1179. a @i{fresh} @i{list} with the @i{same} @i{elements} as L.
  1180. (Only the @i{list structure} is @i{fresh};
  1181. the @i{elements} are the @i{same}.)
  1182. See the @i{function} @b{copy-list}.
  1183. 3. (of an @i{association list} A with @i{elements} A_i)
  1184. a @i{fresh} @i{list} B with @i{elements} B_i, each of which is
  1185. @b{nil} if A_i is @b{nil}, or else a @i{copy} of the @i{cons} A_i.
  1186. See the @i{function} @b{copy-alist}.
  1187. 4. (of a @i{tree} T)
  1188. a @i{fresh} @i{tree} with the @i{same} @i{leaves} as T.
  1189. See the @i{function} @b{copy-tree}.
  1190. 5. (of a @i{random state} R)
  1191. a @i{fresh} @i{random state} that, if used as an argument to
  1192. to the @i{function} @b{random} would produce the same series of ``random''
  1193. values as R would produce.
  1194. 6. (of a @i{structure} S)
  1195. a @i{fresh} @i{structure} that has the same @i{type} as S,
  1196. and that has slot values, each of which is the @i{same} as the
  1197. corresponding slot value of S.
  1198. (Note that since the difference between a @i{cons}, a @i{list},
  1199. and a @i{tree} is a matter of ``view'' or ``intention,'' there can
  1200. be no general-purpose @i{function} which, based solely on the @i{type}
  1201. of an @i{object}, can determine which of these distinct meanings is
  1202. intended. The distinction rests solely on the basis of the text description
  1203. within this document. For example, phrases like ``a @i{copy} of the
  1204. given @i{list}'' or ``copy of the @i{list} @i{x}'' imply the
  1205. second definition.)
  1206. @IGindex{correctable}
  1207. @item @b{correctable}
  1208. @i{adj.} (of an @i{error})
  1209. 1. (by a @i{restart} other than @b{abort}
  1210. that has been associated with the @i{error})
  1211. capable of being corrected by invoking that @i{restart}.
  1212. {``The function @b{cerror} signals an error
  1213. that is correctable by the @b{continue} @i{restart}.''}
  1214. (Note that correctability is not a property of an
  1215. @i{error} @i{object}, but rather a property of the
  1216. @i{dynamic environment} that is in effect when the
  1217. @i{error} is @i{signaled}.
  1218. Specifically, the @i{restart} is ``associated with''
  1219. the @i{error} @i{condition} @i{object}.
  1220. See @ref{Associating a Restart with a Condition}.)
  1221. 2. (when no specific @i{restart} is mentioned)
  1222. @i{correctable}_1 by at least one @i{restart}.
  1223. {``@b{import} signals a correctable error of @i{type} @b{package-error}
  1224. if any of the imported symbols has the same name as
  1225. some distinct symbol already accessible in the package.''}
  1226. @IGindex{current input base}
  1227. @item @b{current input base}
  1228. @i{n.} (in a @i{dynamic environment})
  1229. the @i{radix} that is the @i{value} of @b{*read-base*} in that @i{environment},
  1230. and that is the default @i{radix} employed by the @i{Lisp reader}
  1231. and its related @i{functions}.
  1232. @IGindex{current logical block}
  1233. @item @b{current logical block}
  1234. @i{n.}
  1235. the context of the innermost lexically enclosing use of @b{pprint-logical-block}.
  1236. @IGindex{current output base}
  1237. @item @b{current output base}
  1238. @i{n.} (in a @i{dynamic environment})
  1239. the @i{radix} that is the @i{value} of @b{*print-base*} in that @i{environment},
  1240. and that is the default @i{radix} employed by the @i{Lisp printer}
  1241. and its related @i{functions}.
  1242. @IGindex{current package}
  1243. @item @b{current package}
  1244. @i{n.} (in a @i{dynamic environment})
  1245. the @i{package} that is the @i{value} of @b{*package*} in that @i{environment},
  1246. and that is the default @i{package} employed by the @i{Lisp reader}
  1247. and @i{Lisp printer}, and their related @i{functions}.
  1248. @IGindex{current pprint dispatch table}
  1249. @item @b{current pprint dispatch table}
  1250. @i{n.} (in a @i{dynamic environment})
  1251. the @i{pprint dispatch table} that is the @i{value} of @b{*print-pprint-dispatch*}
  1252. in that @i{environment}, and that is the default @i{pprint dispatch table}
  1253. employed by the @i{pretty printer}.
  1254. @IGindex{current random state}
  1255. @item @b{current random state}
  1256. @i{n.} (in a @i{dynamic environment})
  1257. the @i{random state} that is the @i{value} of @b{*random-state*} in that @i{environment},
  1258. and that is the default @i{random state} employed by @b{random}.
  1259. @IGindex{current readtable}
  1260. @item @b{current readtable}
  1261. @i{n.} (in a @i{dynamic environment})
  1262. the @i{readtable} that is the @i{value} of @b{*readtable*} in that @i{environment},
  1263. and that affects the way in which @i{expressions}_2 are parsed
  1264. into @i{objects} by the @i{Lisp reader}.
  1265. @end table
  1266. @subheading @b{D}
  1267. @table @asis
  1268. @IGindex{data type}
  1269. @item @b{data type}
  1270. @i{n.} @i{Trad.}
  1271. a @i{type}.
  1272. @IGindex{debug I/O}
  1273. @item @b{debug I/O}
  1274. @i{n.}
  1275. the @i{bidirectional} @i{stream}
  1276. that is the @i{value} of the @i{variable} @b{*debug-io*}.
  1277. @IGindex{debugger}
  1278. @item @b{debugger}
  1279. @i{n.}
  1280. a facility that allows the @i{user} to handle a @i{condition} interactively.
  1281. For example, the @i{debugger} might permit interactive
  1282. selection of a @i{restart} from among the @i{active} @i{restarts},
  1283. and it might perform additional @i{implementation-defined} services
  1284. for the purposes of debugging.
  1285. @IGindex{declaration}
  1286. @item @b{declaration}
  1287. @i{n.}
  1288. a @i{global declaration} or @i{local declaration}.
  1289. @IGindex{declaration identifier}
  1290. @item @b{declaration identifier}
  1291. @i{n.}
  1292. one of the @i{symbols}
  1293. @b{declaration},
  1294. @b{dynamic-extent},
  1295. @b{ftype},
  1296. @b{function},
  1297. @b{ignore},
  1298. @b{inline},
  1299. @b{notinline},
  1300. @b{optimize},
  1301. @b{special},
  1302. or @b{type};
  1303. or a @i{symbol} which is the @i{name} of a @i{type};
  1304. or a @i{symbol} which has been @i{declared}
  1305. to be a @i{declaration identifier} by using a @b{declaration}
  1306. @i{declaration}.
  1307. @IGindex{declaration specifier}
  1308. @item @b{declaration specifier}
  1309. @i{n.}
  1310. an @i{expression} that can appear at top level of a @b{declare}
  1311. expression or a @b{declaim} form, or as the argument to @b{proclaim},
  1312. and which has a @i{car} which is a @i{declaration identifier},
  1313. and which has a @i{cdr} that is data interpreted according to rules
  1314. specific to the @i{declaration identifier}.
  1315. @IGindex{declare}
  1316. @item @b{declare}
  1317. @i{v.}
  1318. to @i{establish} a @i{declaration}.
  1319. See @b{declare}, @b{declaim}, or @b{proclaim}.
  1320. @IGindex{decline}
  1321. @item @b{decline}
  1322. @i{v.} (of a @i{handler})
  1323. to return normally without having @i{handled} the @i{condition}
  1324. being @i{signaled}, permitting the signaling process to continue
  1325. as if the @i{handler} had not been present.
  1326. @IGindex{decoded time}
  1327. @item @b{decoded time}
  1328. @i{n.}
  1329. @i{absolute} @i{time}, represented as an ordered series of
  1330. nine @i{objects} which, taken together, form a description of
  1331. a point in calendar time, accurate to the nearest second (except
  1332. that @i{leap seconds} are ignored).
  1333. See @ref{Decoded Time}.
  1334. @IGindex{default method}
  1335. @item @b{default method}
  1336. @i{n.}
  1337. a @i{method} having no @i{parameter specializers} other than
  1338. the @i{class} @b{t}. Such a @i{method} is always an @i{applicable method}
  1339. but might be @i{shadowed}_2 by a more specific @i{method}.
  1340. @IGindex{defaulted initialization argument list}
  1341. @item @b{defaulted initialization argument list}
  1342. @i{n.}
  1343. a @i{list} of alternating initialization argument @i{names} and
  1344. @i{values} in which unsupplied initialization arguments are
  1345. defaulted, used in the protocol for initializing and reinitializing
  1346. @i{instances} of @i{classes}.
  1347. @IGindex{define-method-combination arguments lambda list}
  1348. @item @b{define-method-combination arguments lambda list}
  1349. @i{n.}
  1350. a @i{lambda list} used by the @t{:arguments} option
  1351. to @b{define-method-combination}.
  1352. See @ref{Define-method-combination Arguments Lambda Lists}.
  1353. @IGindex{define-modify-macro lambda list}
  1354. @item @b{define-modify-macro lambda list}
  1355. @i{n.}
  1356. a @i{lambda list} used by @b{define-modify-macro}.
  1357. See @ref{Define-modify-macro Lambda Lists}.
  1358. @IGindex{defined name}
  1359. @item @b{defined name}
  1360. @i{n.}
  1361. a @i{symbol} the meaning of which is defined by @r{Common Lisp}.
  1362. @IGindex{defining form}
  1363. @item @b{defining form}
  1364. @i{n.}
  1365. a @i{form} that has the side-effect of @i{establishing} a definition.
  1366. {``@b{defun} and @b{defparameter} are defining forms.''}
  1367. @IGindex{defsetf lambda list}
  1368. @item @b{defsetf lambda list}
  1369. @i{n.}
  1370. a @i{lambda list} that is like an @i{ordinary lambda list}
  1371. except that it does not permit @b{&aux}
  1372. and that it permits use of @b{&environment}.
  1373. See @ref{Defsetf Lambda Lists}.
  1374. @IGindex{deftype lambda list}
  1375. @item @b{deftype lambda list}
  1376. @i{n.}
  1377. a @i{lambda list} that is like a @i{macro lambda list}
  1378. except that the default @i{value} for unsupplied @i{optional parameters}
  1379. and @i{keyword parameters} is the @i{symbol} @b{*} (rather than @b{nil}).
  1380. See @ref{Deftype Lambda Lists}.
  1381. @IGindex{denormalized}
  1382. @item @b{denormalized}
  1383. @i{adj.}, @i{ANSI}, @i{IEEE} (of a @i{float})
  1384. conforming to the description of ``denormalized'' as described by
  1385. {IEEE Standard for Binary Floating-Point Arithmetic}.
  1386. For example, in an @i{implementation} where the minimum possible exponent
  1387. was @t{-7} but where @t{0.001} was a valid mantissa, the number @t{1.0e-10}
  1388. might be representable as @t{0.001e-7} internally even if the @i{normalized}
  1389. representation would call for it to be represented instead as @t{1.0e-10}
  1390. or @t{0.1e-9}. By their nature, @i{denormalized} @i{floats} generally
  1391. have less precision than @i{normalized} @i{floats}.
  1392. @IGindex{derived type}
  1393. @item @b{derived type}
  1394. @i{n.}
  1395. a @i{type specifier} which is defined in terms of an expansion into another
  1396. @i{type specifier}. @b{deftype} defines @i{derived types},
  1397. and there may be other @i{implementation-defined} @i{operators}
  1398. which do so as well.
  1399. @IGindex{derived type specifier}
  1400. @item @b{derived type specifier}
  1401. @i{n.}
  1402. a @i{type specifier} for a @i{derived type}.
  1403. @IGindex{designator}
  1404. @item @b{designator}
  1405. @i{n.}
  1406. an @i{object} that denotes another @i{object}.
  1407. In the dictionary entry for an @i{operator}
  1408. if a @i{parameter} is described as a @i{designator} for a @i{type},
  1409. the description of the @i{operator} is written in a way
  1410. that assumes that appropriate coercion to that @i{type} has already occurred;
  1411. that is, that the @i{parameter} is already of the denoted @i{type}.
  1412. For more detailed information, see @ref{Designators}.
  1413. @IGindex{destructive}
  1414. @item @b{destructive}
  1415. @i{adj.} (of an @i{operator})
  1416. capable of modifying some program-visible aspect of one or more
  1417. @i{objects} that are either explicit @i{arguments} to the
  1418. @i{operator} or that can be obtained directly or indirectly
  1419. from the @i{global environment} by the @i{operator}.
  1420. @IGindex{destructuring lambda list}
  1421. @item @b{destructuring lambda list}
  1422. @i{n.}
  1423. an @i{extended lambda list} used in @b{destructuring-bind} and
  1424. nested within @i{macro lambda lists}.
  1425. See @ref{Destructuring Lambda Lists}.
  1426. @IGindex{different}
  1427. @item @b{different}
  1428. @i{adj.}
  1429. not the @i{same}
  1430. {``The strings @t{"FOO"} and @t{"foo"} are different under
  1431. @b{equal} but not under @b{equalp}.''}
  1432. @IGindex{digit}
  1433. @item @b{digit}
  1434. @i{n.} (in a @i{radix})
  1435. a @i{character} that is among the possible digits (@t{0} to @t{9},
  1436. @t{A} to @t{Z}, and @t{a} to @t{z}) and that is defined to have an
  1437. associated numeric weight as a digit in that @i{radix}.
  1438. See @ref{Digits in a Radix}.
  1439. @IGindex{dimension}
  1440. @item @b{dimension}
  1441. @i{n.}
  1442. 1. a non-negative @i{integer} indicating the number of
  1443. @i{objects} an @i{array} can hold along one axis.
  1444. If the @i{array} is a @i{vector} with a @i{fill pointer},
  1445. the @i{fill pointer} is ignored.
  1446. {``The second dimension of that array is 7.''}
  1447. 2. an axis of an array.
  1448. {``This array has six dimensions.''}
  1449. @IGindex{direct instance}
  1450. @item @b{direct instance}
  1451. @i{n.} (of a @i{class} C)
  1452. an @i{object} whose @i{class} is C itself,
  1453. rather than some @i{subclass} of C.
  1454. {``The function @b{make-instance} always returns a
  1455. direct instance of the class which is (or is named by)
  1456. its first argument.''}
  1457. @IGindex{direct subclass}
  1458. @item @b{direct subclass}
  1459. @i{n.} (of a @i{class} C_1)
  1460. a @i{class} C_2,
  1461. such that C_1 is a @i{direct superclass} of C_2.
  1462. @IGindex{direct superclass}
  1463. @item @b{direct superclass}
  1464. @i{n.} (of a @i{class} C_1)
  1465. a @i{class} C_2 which was explicitly designated as
  1466. a @i{superclass} of C_1 in the definition of C_1.
  1467. @IGindex{disestablish}
  1468. @item @b{disestablish}
  1469. @i{v.t.}
  1470. to withdraw the @i{establishment} of
  1471. an @i{object},
  1472. a @i{binding},
  1473. an @i{exit point},
  1474. a @i{tag},
  1475. a @i{handler},
  1476. a @i{restart},
  1477. or an @i{environment}.
  1478. @IGindex{disjoint}
  1479. @item @b{disjoint}
  1480. @i{n.} (of @i{types})
  1481. having no @i{elements} in common.
  1482. @IGindex{dispatching macro character}
  1483. @item @b{dispatching macro character}
  1484. @i{n.}
  1485. a @i{macro character} that has an associated table that specifies
  1486. the @i{function} to be called for each @i{character} that is
  1487. seen following the @i{dispatching macro character}.
  1488. See the @i{function} @b{make-dispatch-macro-character}.
  1489. @IGindex{displaced array}
  1490. @item @b{displaced array}
  1491. @i{n.}
  1492. an @i{array} which has no storage of its own, but which is instead
  1493. indirected to the storage of another @i{array}, called its
  1494. @i{target}, at a specified offset, in such a way that any attempt
  1495. to @i{access} the @i{displaced array} implicitly references the
  1496. @i{target} @i{array}.
  1497. @IGindex{distinct}
  1498. @item @b{distinct}
  1499. @i{adj.}
  1500. not @i{identical}.
  1501. @IGindex{documentation string}
  1502. @item @b{documentation string}
  1503. @i{n.} (in a defining @i{form})
  1504. A @i{literal} @i{string} which because of the context in which
  1505. it appears (rather than because of some intrinsically observable
  1506. aspect of the @i{string}) is taken as documentation.
  1507. In some cases, the @i{documentation string} is saved in such a
  1508. way that it can later be obtained by supplying either an @i{object},
  1509. or by supplying a @i{name} and a ``kind'' to the @i{function} @b{documentation}.
  1510. {``The body of code in a @b{defmacro} form can be preceded
  1511. by a documentation string of kind @b{function}.''}
  1512. @IGindex{dot}
  1513. @item @b{dot}
  1514. @i{n.}
  1515. the @i{standard character} that is variously called
  1516. ``full stop,''
  1517. ``period,''
  1518. or ``dot'' (@t{.}).
  1519. See @i{Figure~2--5}.
  1520. @IGindex{dotted list}
  1521. @item @b{dotted list}
  1522. @i{n.}
  1523. a @i{list} which has a terminating @i{atom} that is not @b{nil}.
  1524. (An @i{atom} by itself is not a @i{dotted list}, however.)
  1525. @IGindex{dotted pair}
  1526. @item @b{dotted pair}
  1527. @i{n.}
  1528. 1. a @i{cons} whose @i{cdr} is a @i{non-list}.
  1529. 2. any @i{cons}, used to emphasize the use of the @i{cons}
  1530. as a symmetric data pair.
  1531. @IGindex{double float}
  1532. @item @b{double float}
  1533. @i{n.}
  1534. an @i{object} of @i{type} @b{double-float}.
  1535. @IGindex{double-quote}
  1536. @item @b{double-quote}
  1537. @i{n.}
  1538. the @i{standard character} that is variously called
  1539. ``quotation mark''
  1540. or ``double quote'' (@t{"}).
  1541. See @i{Figure~2--5}.
  1542. @IGindex{dynamic binding}
  1543. @item @b{dynamic binding}
  1544. @i{n.}
  1545. a @i{binding} in a @i{dynamic environment}.
  1546. @IGindex{dynamic environment}
  1547. @item @b{dynamic environment}
  1548. @i{n.}
  1549. that part of an @i{environment} that contains @i{bindings}
  1550. with @i{dynamic extent}. A @i{dynamic environment} contains,
  1551. among other things:
  1552. @i{exit points} established by @b{unwind-protect},
  1553. and
  1554. @i{bindings} of
  1555. @i{dynamic variables},
  1556. @i{exit points} established by @b{catch},
  1557. @i{condition handlers},
  1558. and
  1559. @i{restarts}.
  1560. @IGindex{dynamic extent}
  1561. @item @b{dynamic extent}
  1562. @i{n.}
  1563. an @i{extent} whose duration is bounded by points of
  1564. @i{establishment} and @i{disestablishment} within the execution
  1565. of a particular @i{form}. See @i{indefinite extent}.
  1566. {``Dynamic variable bindings have dynamic extent.''}
  1567. @IGindex{dynamic scope}
  1568. @item @b{dynamic scope}
  1569. @i{n.}
  1570. @i{indefinite scope} along with @i{dynamic extent}.
  1571. @IGindex{dynamic variable}
  1572. @item @b{dynamic variable}
  1573. @i{n.}
  1574. a @i{variable} the @i{binding} for which is in the @i{dynamic environment}.
  1575. See @b{special}.
  1576. @end table
  1577. @subheading @b{E}
  1578. @table @asis
  1579. @IGindex{echo stream}
  1580. @item @b{echo stream}
  1581. @i{n.}
  1582. a @i{stream} of @i{type} @b{echo-stream}.
  1583. @IGindex{effective method}
  1584. @item @b{effective method}
  1585. @i{n.}
  1586. the combination of @i{applicable methods} that are executed
  1587. when a @i{generic function} is invoked with a particular sequence
  1588. of @i{arguments}.
  1589. @IGindex{element}
  1590. @item @b{element}
  1591. @i{n.}
  1592. 1. (of a @i{list})
  1593. an @i{object} that is the @i{car} of one of the @i{conses}
  1594. that comprise the @i{list}.
  1595. 2. (of an @i{array})
  1596. an @i{object} that is stored in the @i{array}.
  1597. 3. (of a @i{sequence})
  1598. an @i{object} that is an @i{element} of the @i{list} or @i{array}
  1599. that is the @i{sequence}.
  1600. 4. (of a @i{type})
  1601. an @i{object} that is a member of the set of @i{objects}
  1602. designated by the @i{type}.
  1603. 5. (of an @i{input} @i{stream})
  1604. a @i{character} or @i{number} (as appropriate to the
  1605. @i{element type} of the @i{stream})
  1606. that is among the ordered series of @i{objects} that can be
  1607. read from the @i{stream} (using @b{read-char} or @b{read-byte},
  1608. as appropriate to the @i{stream}).
  1609. 6. (of an @i{output} @i{stream})
  1610. a @i{character} or @i{number} (as appropriate to the
  1611. @i{element type} of the @i{stream})
  1612. that is among the ordered series of @i{objects} that has been
  1613. or will be written to the @i{stream} (using @b{write-char}
  1614. or @b{write-byte}, as appropriate to the @i{stream}).
  1615. 7. (of a @i{class}) a @i{generalized instance} of the @i{class}.
  1616. @IGindex{element type}
  1617. @item @b{element type}
  1618. @i{n.}
  1619. 1. (of an @i{array}) the @i{array element type} of the @i{array}.
  1620. 2. (of a @i{stream}) the @i{stream element type} of the @i{stream}.
  1621. @IGindex{em}
  1622. @item @b{em}
  1623. @i{n.} @i{Trad.}
  1624. a context-dependent unit of measure commonly used in typesetting,
  1625. equal to the displayed width of of a letter ``M'' in the current font.
  1626. (The letter ``M'' is traditionally chosen because it is typically
  1627. represented by the widest @i{glyph} in the font, and other characters'
  1628. widths are typically fractions of an @i{em}. In implementations providing
  1629. non-Roman characters with wider characters than ``M,'' it is permissible
  1630. for another character to be the @i{implementation-defined} reference character
  1631. for this measure, and for ``M'' to be only a fraction of an @i{em}
  1632. wide.)
  1633. In a fixed width font, a line with @i{n} characters is @i{n}
  1634. @i{ems} wide; in a variable width font, @i{n} @i{ems} is the
  1635. expected upper bound on the width of such a line.
  1636. @IGindex{empty list}
  1637. @item @b{empty list}
  1638. @i{n.}
  1639. the @i{list} containing no @i{elements}. See @i{()}.
  1640. @IGindex{empty type}
  1641. @item @b{empty type}
  1642. @i{n.}
  1643. the @i{type} that contains no @i{elements}, and that is
  1644. a @i{subtype} of all @i{types} (including itself).
  1645. See @i{nil}.
  1646. @IGindex{end of file}
  1647. @item @b{end of file}
  1648. @i{n.}
  1649. 1. the point in an @i{input} @i{stream} beyond which there is
  1650. no further data.
  1651. Whether or not there is such a point on an @i{interactive stream}
  1652. is @i{implementation-defined}.
  1653. 2. a @i{situation} that occurs upon an attempt to obtain data from an
  1654. @i{input stream} that is at the @i{end of file}_1.
  1655. @IGindex{environment}
  1656. @item @b{environment}
  1657. @i{n.}
  1658. 1. a set of @i{bindings}. See @ref{Introduction to Environments}.
  1659. 2. an @i{environment object}.
  1660. {``@b{macroexpand} takes an optional environment argument.''}
  1661. @IGindex{environment object}
  1662. @item @b{environment object}
  1663. @i{n.}
  1664. an @i{object} representing a set of @i{lexical bindings},
  1665. used in the processing of a @i{form} to provide meanings for
  1666. @i{names} within that @i{form}.
  1667. {``@b{macroexpand} takes an optional environment argument.''}
  1668. (The @i{object} @b{nil} when used as an @i{environment object}
  1669. denotes the @i{null lexical environment};
  1670. the @i{values} of @i{environment parameters}
  1671. to @i{macro functions} are @i{objects}
  1672. of @i{implementation-dependent} nature which represent the
  1673. @i{environment}_1 in which the corresponding @i{macro form}
  1674. is to be expanded.)
  1675. See @ref{Environment Objects}.
  1676. @IGindex{environment parameter}
  1677. @item @b{environment parameter}
  1678. @i{n.}
  1679. A @i{parameter} in a @i{defining form} f for which there is no corresponding
  1680. @i{argument}; instead, this @i{parameter} receives as its value an
  1681. @i{environment} @i{object} which corresponds to the
  1682. @i{lexical environment} in which the @i{defining form} f appeared.
  1683. @IGindex{error}
  1684. @item @b{error}
  1685. @i{n.}
  1686. 1. (only in the phrase ``is an error'')
  1687. a @i{situation} in which the semantics of a program are not specified,
  1688. and in which the consequences are undefined.
  1689. 2. a @i{condition} which represents an @i{error} @i{situation}.
  1690. See @ref{Error Terminology}.
  1691. 3. an @i{object} of @i{type} @b{error}.
  1692. @IGindex{error output}
  1693. @item @b{error output}
  1694. @i{n.}
  1695. the @i{output} @i{stream} which is the @i{value} of the @i{dynamic variable}
  1696. @b{*error-output*}.
  1697. @IGindex{escape}
  1698. @item @b{escape}
  1699. @i{n.}, @i{adj.}
  1700. 1. @i{n.} a @i{single escape} or a @i{multiple escape}.
  1701. 2. @i{adj.} @i{single escape} or @i{multiple escape}.
  1702. @IGindex{establish}
  1703. @item @b{establish}
  1704. @i{v.t.}
  1705. to build or bring into being
  1706. a @i{binding},
  1707. a @i{declaration},
  1708. an @i{exit point},
  1709. a @i{tag},
  1710. a @i{handler},
  1711. a @i{restart},
  1712. or an @i{environment}.
  1713. {``@b{let} establishes lexical bindings.''}
  1714. @IGindex{evaluate}
  1715. @item @b{evaluate}
  1716. @i{v.t.} (a @i{form} or an @i{implicit progn})
  1717. to @i{execute} the @i{code} represented by the @i{form}
  1718. (or the series of @i{forms} making up the @i{implicit progn})
  1719. by applying the rules of @i{evaluation},
  1720. returning zero or more values.
  1721. @IGindex{evaluation}
  1722. @item @b{evaluation}
  1723. @i{n.}
  1724. a model whereby @i{forms} are @i{executed}, returning zero or more values.
  1725. Such execution might be implemented directly in one step by an interpreter
  1726. or in two steps by first @i{compiling} the @i{form} and then
  1727. @i{executing} the @i{compiled} @i{code}; this choice is
  1728. dependent both on context and the nature of the @i{implementation},
  1729. but in any case is not in general detectable by any program. The evaluation
  1730. model is designed in such a way that a @i{conforming implementation}
  1731. might legitimately have only a compiler and no interpreter, or vice versa.
  1732. See @ref{The Evaluation Model}.
  1733. @IGindex{evaluation environment}
  1734. @item @b{evaluation environment}
  1735. @i{n.}
  1736. a @i{run-time environment} in which macro expanders
  1737. and code specified by @b{eval-when} to be evaluated
  1738. are evaluated. All evaluations initiated by the @i{compiler}
  1739. take place in the @i{evaluation environment}.
  1740. @IGindex{execute}
  1741. @item @b{execute}
  1742. @i{v.t.} @i{Trad.} (@i{code})
  1743. to perform the imperative actions represented by the @i{code}.
  1744. @IGindex{execution time}
  1745. @item @b{execution time}
  1746. @i{n.}
  1747. the duration of time that @i{compiled code} is being @i{executed}.
  1748. @IGindex{exhaustive partition}
  1749. @item @b{exhaustive partition}
  1750. @i{n.} (of a @i{type})
  1751. a set of @i{pairwise} @i{disjoint} @i{types} that form an
  1752. @i{exhaustive union}.
  1753. @IGindex{exhaustive union}
  1754. @item @b{exhaustive union}
  1755. @i{n.} (of a @i{type})
  1756. a set of @i{subtypes} of the @i{type},
  1757. whose union contains all @i{elements} of that @i{type}.
  1758. @IGindex{exit point}
  1759. @item @b{exit point}
  1760. @i{n.}
  1761. a point in a @i{control form}
  1762. from which (@i{e.g.}, @b{block}),
  1763. through which (@i{e.g.}, @b{unwind-protect}),
  1764. or to which (@i{e.g.}, @b{tagbody})
  1765. control and possibly @i{values} can be transferred both actively by using
  1766. another @i{control form} and passively through the normal control and
  1767. data flow of @i{evaluation}.
  1768. {``@b{catch} and @b{block} establish bindings for
  1769. exit points to which @b{throw} and @b{return-from},
  1770. respectively, can transfer control and values;
  1771. @b{tagbody} establishes a binding for an exit point
  1772. with lexical extent to which @b{go} can transfer control;
  1773. and @b{unwind-protect} establishes an exit point
  1774. through which control might be transferred by
  1775. operators such as @b{throw}, @b{return-from},
  1776. and @b{go}.''}
  1777. @IGindex{explicit return}
  1778. @item @b{explicit return}
  1779. @i{n.}
  1780. the act of transferring control (and possibly @i{values})
  1781. to a @i{block} by using @b{return-from} (or @b{return}).
  1782. @IGindex{explicit use}
  1783. @item @b{explicit use}
  1784. @i{n.} (of a @i{variable} V in a @i{form} F)
  1785. a reference to V that is directly apparent in the normal semantics of F;
  1786. @i{i.e.}, that does not expose any undocumented details of the
  1787. @i{macro expansion} of the @i{form} itself.
  1788. References to V exposed by expanding @i{subforms} of F are, however,
  1789. considered to be @i{explicit uses} of V.
  1790. @IGindex{exponent marker}
  1791. @item @b{exponent marker}
  1792. @i{n.}
  1793. a character that is used in the textual notation for a @i{float}
  1794. to separate the mantissa from the exponent.
  1795. The characters defined as @i{exponent markers} in the @i{standard readtable}
  1796. are shown in Figure 26--1.
  1797. For more information, see @ref{Character Syntax}.
  1798. {``The exponent marker `d' in `3.0d7' indicates
  1799. that this number is to be represented as a double float.''}
  1800. @group
  1801. @noindent
  1802. @w{ Marker Meaning }
  1803. @w{ @t{D} or @t{d} @b{double-float} }
  1804. @w{ @t{E} or @t{e} @b{float} (see @b{*read-default-float-format*}) }
  1805. @w{ @t{F} or @t{f} @b{single-float} }
  1806. @w{ @t{L} or @t{l} @b{long-float} }
  1807. @w{ @t{S} or @t{s} @b{short-float} }
  1808. @noindent
  1809. @w{ Figure 26--1: Exponent Markers }
  1810. @end group
  1811. @IGindex{export}
  1812. @item @b{export}
  1813. @i{v.t.} (a @i{symbol} in a @i{package})
  1814. to add the @i{symbol} to the list of @i{external symbols} of the
  1815. @i{package}.
  1816. @IGindex{exported}
  1817. @item @b{exported}
  1818. @i{adj.} (of a @i{symbol} in a @i{package})
  1819. being an @i{external symbol} of the @i{package}.
  1820. @IGindex{expressed adjustability}
  1821. @item @b{expressed adjustability}
  1822. @i{n.} (of an @i{array})
  1823. a @i{generalized boolean} that is conceptually (but not necessarily actually)
  1824. associated with the @i{array}, representing whether the @i{array}
  1825. is @i{expressly adjustable}.
  1826. See also @i{actual adjustability}.
  1827. @IGindex{expressed array element type}
  1828. @item @b{expressed array element type}
  1829. @i{n.} (of an @i{array})
  1830. the @i{type} which is the @i{array element type}
  1831. implied by a @i{type declaration} for the @i{array},
  1832. or which is the requested @i{array element type} at its time
  1833. of creation, prior to any selection of an @i{upgraded array element type}.
  1834. (@r{Common Lisp} does not provide a way of detecting this @i{type}
  1835. directly at run time, but an @i{implementation} is permitted
  1836. to make assumptions about the @i{array}'s contents and
  1837. the operations which may be performed on the @i{array} when
  1838. this @i{type} is noted during code analysis, even if those
  1839. assumptions would not be valid in general for the
  1840. @i{upgraded array element type} of the
  1841. @i{expressed array element type}.)
  1842. @IGindex{expressed complex part type}
  1843. @item @b{expressed complex part type}
  1844. @i{n.} (of a @i{complex})
  1845. the @i{type} which is implied as the @i{complex part type}
  1846. by a @i{type declaration} for the @i{complex},
  1847. or which is the requested @i{complex part type} at its time of
  1848. creation, prior to any selection of an @i{upgraded complex part type}.
  1849. (@r{Common Lisp} does not provide a way of detecting this @i{type}
  1850. directly at run time, but an @i{implementation} is permitted
  1851. to make assumptions about the operations which may be performed on
  1852. the @i{complex} when this @i{type} is noted during code
  1853. analysis, even if those assumptions would not be valid in general for
  1854. the @i{upgraded complex part type} of the
  1855. @i{expressed complex part type}.)
  1856. @IGindex{expression}
  1857. @item @b{expression}
  1858. @i{n.}
  1859. 1. an @i{object}, often used to emphasize the use
  1860. of the @i{object} to encode or represent information in a specialized
  1861. format, such as program text.
  1862. {``The second expression in a @b{let} form is a list
  1863. of bindings.''}
  1864. 2. the textual notation used to notate an @i{object} in a source file.
  1865. {``The expression @t{'sample} is equivalent to @t{(quote sample)}.''}
  1866. @IGindex{expressly adjustable}
  1867. @item @b{expressly adjustable}
  1868. @i{adj.} (of an @i{array})
  1869. being @i{actually adjustable} by virtue of an explicit request for this
  1870. characteristic having been made at the time of its creation.
  1871. All @i{arrays} that are @i{expressly adjustable}
  1872. are @i{actually adjustable},
  1873. but not necessarily vice versa.
  1874. @IGindex{extended character}
  1875. @item @b{extended character}
  1876. @i{n.}
  1877. a @i{character}
  1878. of @i{type} @b{extended-char}:
  1879. a @i{character} that is not a @i{base character}.
  1880. @IGindex{extended function designator}
  1881. @item @b{extended function designator}
  1882. @i{n.}
  1883. a @i{designator} for a @i{function}; that is,
  1884. an @i{object} that denotes a @i{function}
  1885. and that is one of:
  1886. a @i{function name} (denoting the @i{function} it names
  1887. in the @i{global environment}),
  1888. or a @i{function} (denoting itself).
  1889. The consequences are undefined if
  1890. a @i{function name} is used as an
  1891. @i{extended function designator} but
  1892. it does not have a global definition as a @i{function},
  1893. or if it is a @i{symbol}
  1894. that has a global definition as a @i{macro} or a @i{special form}.
  1895. See also @i{function designator}.
  1896. @IGindex{extended lambda list}
  1897. @item @b{extended lambda list}
  1898. @i{n.}
  1899. a list resembling an @i{ordinary lambda list} in form and purpose, but
  1900. offering additional syntax or functionality not available in an
  1901. @i{ordinary lambda list}.
  1902. {``@b{defmacro} uses extended lambda lists.''}
  1903. @IGindex{extension}
  1904. @item @b{extension}
  1905. @i{n.}
  1906. a facility in an @i{implementation} of @r{Common Lisp}
  1907. that is not specified by this standard.
  1908. @IGindex{extent}
  1909. @item @b{extent}
  1910. @i{n.}
  1911. the interval of time during which a @i{reference} to
  1912. an @i{object},
  1913. a @i{binding},
  1914. an @i{exit point},
  1915. a @i{tag},
  1916. a @i{handler},
  1917. a @i{restart},
  1918. or an @i{environment} is defined.
  1919. @IGindex{external file format}
  1920. @item @b{external file format}
  1921. @i{n.}
  1922. an @i{object} of @i{implementation-dependent} nature which determines
  1923. one of possibly several @i{implementation-dependent} ways in which
  1924. @i{characters} are encoded externally in a @i{character} @i{file}.
  1925. @IGindex{external file format designator}
  1926. @item @b{external file format designator}
  1927. @i{n.}
  1928. a @i{designator} for an @i{external file format}; that is,
  1929. an @i{object} that denotes an @i{external file format}
  1930. and that is one of:
  1931. the @i{symbol} @t{:default}
  1932. (denoting an @i{implementation-dependent} default
  1933. @i{external file format} that can accomodate at least
  1934. the @i{base characters}),
  1935. some other @i{object} defined by the @i{implementation} to be
  1936. an @i{external file format designator}
  1937. (denoting an @i{implementation-defined} @i{external file format}),
  1938. or some other @i{object} defined by the @i{implementation} to be
  1939. an @i{external file format}
  1940. (denoting itself).
  1941. @IGindex{external symbol}
  1942. @item @b{external symbol}
  1943. @i{n.} (of a @i{package})
  1944. a @i{symbol} that is part of the `external interface' to the @i{package}
  1945. and that are @i{inherited}_3 by any other @i{package}
  1946. that @i{uses} the @i{package}.
  1947. When using the @i{Lisp reader},
  1948. if a @i{package prefix} is used,
  1949. the @i{name} of an @i{external symbol} is separated
  1950. from the @i{package} @i{name} by a single @i{package marker}
  1951. while
  1952. the @i{name} of an @i{internal symbol} is separated
  1953. from the @i{package} @i{name} by a double @i{package marker};
  1954. see @ref{Symbols as Tokens}.
  1955. @IGindex{externalizable object}
  1956. @item @b{externalizable object}
  1957. @i{n.}
  1958. an @i{object} that can be used as a @i{literal} @i{object}
  1959. in @i{code} to be processed by the @i{file compiler}.
  1960. @end table
  1961. @subheading @b{F}
  1962. @table @asis
  1963. @IGindex{false}
  1964. @item @b{false}
  1965. @i{n.}
  1966. the @i{symbol} @b{nil},
  1967. used to represent the failure of a @i{predicate} test.
  1968. @IGindex{fbound}
  1969. @item @b{fbound}
  1970. pronounced 'ef ,baund @i{adj.}
  1971. (of a @i{function name})
  1972. @i{bound} in the @i{function} @i{namespace}.
  1973. (The @i{names} of @i{macros} and @i{special operators} are @i{fbound},
  1974. but the nature and @i{type} of the @i{object} which is their @i{value}
  1975. is @i{implementation-dependent}.
  1976. Further, defining a @i{setf expander} @i{F} does not cause the @i{setf function}
  1977. @t{(setf @i{F})} to become defined; as such, if there is a such a definition
  1978. of a @i{setf expander} @i{F}, the @i{function} @t{(setf @i{F})}
  1979. can be @i{fbound} if and only if, by design or coincidence, a
  1980. function binding for @t{(setf @i{F})} has been independently established.)
  1981. See the @i{functions} @b{fboundp} and @b{symbol-function}.
  1982. @IGindex{feature}
  1983. @item @b{feature}
  1984. @i{n.}
  1985. 1. an aspect or attribute
  1986. of @r{Common Lisp},
  1987. of the @i{implementation},
  1988. or of the @i{environment}.
  1989. 2. a @i{symbol} that names a @i{feature}_1.
  1990. See @ref{Features}.
  1991. {``The @t{:ansi-cl} feature is present in all conforming implementations.''}
  1992. @IGindex{feature expression}
  1993. @item @b{feature expression}
  1994. @i{n.}
  1995. A boolean combination of @i{features} used by the @t{#+} and @t{#-}
  1996. @i{reader macros} in order to direct conditional @i{reading} of
  1997. @i{expressions} by the @i{Lisp reader}.
  1998. See @ref{Feature Expressions}.
  1999. @IGindex{features list}
  2000. @item @b{features list}
  2001. @i{n.}
  2002. the @i{list} that is the @i{value} of @b{*features*}.
  2003. @IGindex{file}
  2004. @item @b{file}
  2005. @i{n.}
  2006. a named entry in a @i{file system},
  2007. having an @i{implementation-defined} nature.
  2008. @IGindex{file compiler}
  2009. @item @b{file compiler}
  2010. @i{n.}
  2011. any @i{compiler} which @i{compiles} @i{source code} contained in a @i{file},
  2012. producing a @i{compiled file} as output. The @b{compile-file}
  2013. function is the only interface to such a @i{compiler} provided by @r{Common Lisp},
  2014. but there might be other, @i{implementation-defined} mechanisms for
  2015. invoking the @i{file compiler}.
  2016. @IGindex{file position}
  2017. @item @b{file position}
  2018. @i{n.} (in a @i{stream})
  2019. a non-negative @i{integer} that represents a position in the @i{stream}.
  2020. Not all @i{streams} are able to represent the notion of @i{file position};
  2021. in the description of any @i{operator} which manipulates @i{file positions},
  2022. the behavior for @i{streams} that don't have this notion must be explicitly stated.
  2023. For @i{binary} @i{streams}, the @i{file position} represents the number
  2024. of preceding @i{bytes} in the @i{stream}.
  2025. For @i{character} @i{streams}, the constraint is more relaxed:
  2026. @i{file positions} must increase monotonically, the amount of the increase
  2027. between @i{file positions} corresponding to any two successive characters
  2028. in the @i{stream} is @i{implementation-dependent}.
  2029. @IGindex{file position designator}
  2030. @item @b{file position designator}
  2031. @i{n.} (in a @i{stream})
  2032. a @i{designator} for a @i{file position} in that @i{stream}; that is,
  2033. the symbol @t{:start}
  2034. (denoting @t{0}, the first @i{file position} in that @i{stream}),
  2035. the symbol @t{:end}
  2036. (denoting the last @i{file position} in that @i{stream};
  2037. @i{i.e.}, the position following the last @i{element} of the @i{stream}),
  2038. or a @i{file position} (denoting itself).
  2039. @IGindex{file stream}
  2040. @item @b{file stream}
  2041. @i{n.}
  2042. an @i{object} of @i{type} @b{file-stream}.
  2043. @IGindex{file system}
  2044. @item @b{file system}
  2045. @i{n.}
  2046. a facility which permits aggregations of data to be stored in named
  2047. @i{files} on some medium that is external to the @i{Lisp image}
  2048. and that therefore persists from @i{session} to @i{session}.
  2049. @IGindex{filename}
  2050. @item @b{filename}
  2051. @i{n.}
  2052. a handle, not necessarily ever directly represented as an @i{object},
  2053. that can be used to refer to a @i{file} in a @i{file system}.
  2054. @i{Pathnames} and @i{namestrings} are two kinds of @i{objects}
  2055. that substitute for @i{filenames} in @r{Common Lisp}.
  2056. @IGindex{fill pointer}
  2057. @item @b{fill pointer}
  2058. @i{n.} (of a @i{vector})
  2059. an @i{integer} associated with a @i{vector} that represents the
  2060. index above which no @i{elements} are @i{active}.
  2061. (A @i{fill pointer} is a non-negative @i{integer} no
  2062. larger than the total number of @i{elements} in the @i{vector}.
  2063. Not all @i{vectors} have @i{fill pointers}.)
  2064. @IGindex{finite}
  2065. @item @b{finite}
  2066. @i{adj.} (of a @i{type})
  2067. having a finite number of @i{elements}.
  2068. {``The type specifier @t{(integer 0 5)} denotes a finite type,
  2069. but the type specifiers @b{integer} and @t{(integer 0)} do not.''}
  2070. @IGindex{fixnum}
  2071. @item @b{fixnum}
  2072. @i{n.}
  2073. an @i{integer} of @i{type} @b{fixnum}.
  2074. @IGindex{float}
  2075. @item @b{float}
  2076. @i{n.}
  2077. an @i{object} of @i{type} @b{float}.
  2078. @IGindex{for-value}
  2079. @item @b{for-value}
  2080. @i{adj.} (of a @i{reference} to a @i{binding})
  2081. being a @i{reference} that @i{reads}_1
  2082. the @i{value} of the @i{binding}.
  2083. @IGindex{form}
  2084. @item @b{form}
  2085. @i{n.}
  2086. 1. any @i{object} meant to be @i{evaluated}.
  2087. 2. a @i{symbol},
  2088. a @i{compound form},
  2089. or a @i{self-evaluating object}.
  2090. 3. (for an @i{operator}, as in ``<<@i{operator}>> @i{form}'')
  2091. a @i{compound form} having that @i{operator} as its first element.
  2092. {``A @b{quote} form is a constant form.''}
  2093. @IGindex{formal argument}
  2094. @item @b{formal argument}
  2095. @i{n.} @i{Trad.}
  2096. a @i{parameter}.
  2097. @IGindex{formal parameter}
  2098. @item @b{formal parameter}
  2099. @i{n.} @i{Trad.}
  2100. a @i{parameter}.
  2101. @IGindex{format}
  2102. @item @b{format}
  2103. @i{v.t.} (a @i{format control} and @i{format arguments})
  2104. to perform output as if by @b{format},
  2105. using the @i{format string} and @i{format arguments}.
  2106. @IGindex{format argument}
  2107. @item @b{format argument}
  2108. @i{n.}
  2109. an @i{object} which is used as data by functions such as @b{format}
  2110. which interpret @i{format controls}.
  2111. @IGindex{format control}
  2112. @item @b{format control}
  2113. @i{n.}
  2114. a @i{format string},
  2115. or a @i{function} that obeys the @i{argument} conventions
  2116. for a @i{function} returned by the @b{formatter} @i{macro}.
  2117. See @ref{Compiling Format Strings}.
  2118. @IGindex{format directive}
  2119. @item @b{format directive}
  2120. @i{n.}
  2121. 1. a sequence of @i{characters} in a @i{format string}
  2122. which is introduced by a @i{tilde}, and which is specially
  2123. interpreted by @i{code} which processes @i{format strings}
  2124. to mean that some special operation should be performed, possibly
  2125. involving data supplied by the @i{format arguments} that
  2126. accompanied the @i{format string}. See the @i{function} @b{format}.
  2127. {``In @t{"~D base 10 = ~8R"}, the character
  2128. sequences `@t{~D}' and `@t{~8R}' are format directives.''}
  2129. 2. the conceptual category of all @i{format directives}_1
  2130. which use the same dispatch character.
  2131. {``Both @t{"~3d"} and @t{"~3,'0D"} are valid uses of the
  2132. `@t{~D}' format directive.''}
  2133. @IGindex{format string}
  2134. @item @b{format string}
  2135. @i{n.}
  2136. a @i{string} which can contain both ordinary text and @i{format directives},
  2137. and which is used in conjunction with @i{format arguments} to describe how
  2138. text output should be formatted by certain functions, such as @b{format}.
  2139. @IGindex{free declaration}
  2140. @item @b{free declaration}
  2141. @i{n.}
  2142. a declaration that is not a @i{bound declaration}.
  2143. See @b{declare}.
  2144. @IGindex{fresh}
  2145. @item @b{fresh}
  2146. @i{adj.}
  2147. 1. (of an @i{object} @i{yielded} by a @i{function})
  2148. having been newly-allocated by that @i{function}.
  2149. (The caller of a @i{function} that returns a @i{fresh} @i{object}
  2150. may freely modify the @i{object} without fear that such modification will
  2151. compromise the future correct behavior of that @i{function}.)
  2152. 2. (of a @i{binding} for a @i{name})
  2153. newly-allocated; not shared with other @i{bindings} for that @i{name}.
  2154. @IGindex{freshline}
  2155. @item @b{freshline}
  2156. @i{n.}
  2157. a conceptual operation on a @i{stream}, implemented by the @i{function} @b{fresh-line}
  2158. and by the @i{format directive} @t{~&}, which advances the display position
  2159. to the beginning of the next line (as if a @i{newline} had been typed, or
  2160. the @i{function} @b{terpri} had been called)
  2161. unless the @i{stream} is already known to be positioned at the beginning of a line.
  2162. Unlike @i{newline}, @i{freshline} is not a @i{character}.
  2163. @IGindex{funbound}
  2164. @item @b{funbound}
  2165. pronounced 'ef unbaund @i{n.} (of a @i{function name})
  2166. not @i{fbound}.
  2167. @IGindex{function}
  2168. @item @b{function}
  2169. @i{n.}
  2170. 1. an @i{object} representing code,
  2171. which can be @i{called} with zero or more @i{arguments},
  2172. and which produces zero or more @i{values}.
  2173. 2. an @i{object} of @i{type} @b{function}.
  2174. @IGindex{function block name}
  2175. @item @b{function block name}
  2176. @i{n.} (of a @i{function name})
  2177. The @i{symbol} that would be used as the name of an @i{implicit block}
  2178. which surrounds the body of a @i{function} having that @i{function name}.
  2179. If the @i{function name} is a @i{symbol}, its @i{function block name} is
  2180. the @i{function name} itself.
  2181. If the @i{function name} is a @i{list} whose @i{car} is @b{setf}
  2182. and whose @i{cadr} is a @i{symbol}, its @i{function block name} is
  2183. the @i{symbol} that is the @i{cadr} of the @i{function name}.
  2184. An @i{implementation} which supports additional kinds of @i{function names}
  2185. must specify for each how the corresponding @i{function block name} is computed.
  2186. @IGindex{function cell}
  2187. @item @b{function cell}
  2188. @i{n.} @i{Trad.} (of a @i{symbol})
  2189. The @i{place} which holds the @i{definition} of the
  2190. global @i{function} @i{binding}, if any, named by that @i{symbol},
  2191. and which is @i{accessed} by @b{symbol-function}.
  2192. See @i{cell}.
  2193. @IGindex{function designator}
  2194. @item @b{function designator}
  2195. @i{n.}
  2196. a @i{designator} for a @i{function}; that is,
  2197. an @i{object} that denotes a @i{function}
  2198. and that is one of:
  2199. a @i{symbol} (denoting the @i{function} named by that @i{symbol}
  2200. in the @i{global environment}),
  2201. or a @i{function} (denoting itself).
  2202. The consequences are undefined if
  2203. a @i{symbol} is used as a @i{function designator} but
  2204. it does not have a global definition as a @i{function},
  2205. or it has a global definition as a @i{macro} or a @i{special form}.
  2206. See also @i{extended function designator}.
  2207. @IGindex{function form}
  2208. @item @b{function form}
  2209. @i{n.}
  2210. a @i{form} that is a @i{list} and that has a first element
  2211. which is the @i{name} of a @i{function} to be called on
  2212. @i{arguments} which are the result of @i{evaluating} subsequent
  2213. elements of the @i{function form}.
  2214. @IGindex{function name}
  2215. @item @b{function name}
  2216. @i{n.} (in an @i{environment})
  2217. A @i{symbol} or a @i{list} @t{(setf @i{symbol})}
  2218. that is the @i{name} of a @i{function} in that @i{environment}.
  2219. @IGindex{functional evaluation}
  2220. @item @b{functional evaluation}
  2221. @i{n.}
  2222. the process of extracting a @i{functional value} from a @i{function name}
  2223. or a @i{lambda expression}.
  2224. The evaluator performs @i{functional evaluation}
  2225. implicitly when it encounters a @i{function name}
  2226. or a @i{lambda expression}
  2227. in the @i{car} of a @i{compound form},
  2228. or explicitly when it encounters a @b{function} @i{special form}.
  2229. Neither a use of a @i{symbol} as a @i{function designator} nor a
  2230. use of the @i{function} @b{symbol-function} to extract the @i{functional value}
  2231. of a @i{symbol} is considered a @i{functional evaluation}.
  2232. @IGindex{functional value}
  2233. @item @b{functional value}
  2234. @i{n.}
  2235. 1. (of a @i{function name} N in an @i{environment} E)
  2236. The @i{value} of the @i{binding} named N
  2237. in the @i{function} @i{namespace} for @i{environment} E;
  2238. that is, the contents of the @i{function cell} named N in
  2239. @i{environment} E.
  2240. 2. (of an @i{fbound} @i{symbol} S)
  2241. the contents of the @i{symbol}'s @i{function cell}; that is,
  2242. the @i{value} of the @i{binding} named S
  2243. in the @i{function} @i{namespace} of the @i{global environment}.
  2244. (A @i{name} that is a @i{macro name} in the @i{global environment}
  2245. or is a @i{special operator} might or might not be @i{fbound}.
  2246. But if S is such a @i{name} and is @i{fbound}, the specific
  2247. nature of its @i{functional value} is @i{implementation-dependent};
  2248. in particular, it might or might not be a @i{function}.)
  2249. @IGindex{further compilation}
  2250. @item @b{further compilation}
  2251. @i{n.}
  2252. @i{implementation-dependent} compilation beyond @i{minimal compilation}.
  2253. Further compilation is permitted to take place at @i{run time}.
  2254. {``Block compilation and generation of machine-specific instructions
  2255. are examples of further compilation.''}
  2256. @end table
  2257. @subheading @b{G}
  2258. @table @asis
  2259. @IGindex{general}
  2260. @item @b{general}
  2261. @i{adj.} (of an @i{array})
  2262. having @i{element type} @b{t},
  2263. and consequently able to have any @i{object} as an @i{element}.
  2264. @IGindex{generalized boolean}
  2265. @item @b{generalized boolean}
  2266. @i{n.}
  2267. an @i{object} used as a truth value, where the symbol~@b{nil}
  2268. represents @i{false} and all other @i{objects} represent @i{true}.
  2269. See @i{boolean}.
  2270. @IGindex{generalized instance}
  2271. @item @b{generalized instance}
  2272. @i{n.} (of a @i{class})
  2273. an @i{object} the @i{class} of which is either that @i{class} itself,
  2274. or some subclass of that @i{class}. (Because of the correspondence between
  2275. types and classes, the term ``generalized instance of X''
  2276. implies ``object of type X'' and in cases where X is a @i{class}
  2277. (or @i{class name}) the reverse is also true.
  2278. The former terminology emphasizes the view of X as a @i{class}
  2279. while the latter emphasizes the view of X as a @i{type specifier}.)
  2280. @IGindex{generalized reference}
  2281. @item @b{generalized reference}
  2282. @i{n.}
  2283. a reference to a location storing an @i{object} as if to a @i{variable}.
  2284. (Such a reference can be either to @i{read} or @i{write} the location.)
  2285. See @ref{Generalized Reference}. See also @i{place}.
  2286. @IGindex{generalized synonym stream}
  2287. @item @b{generalized synonym stream}
  2288. @i{n.} (with a @i{synonym stream symbol})
  2289. 1. (to a @i{stream})
  2290. a @i{synonym stream} to the @i{stream},
  2291. or a @i{composite stream} which has as a target
  2292. a @i{generalized synonym stream} to the @i{stream}.
  2293. 2. (to a @i{symbol})
  2294. a @i{synonym stream} to the @i{symbol},
  2295. or a @i{composite stream} which has as a target
  2296. a @i{generalized synonym stream} to the @i{symbol}.
  2297. @IGindex{generic function}
  2298. @item @b{generic function}
  2299. @i{n.}
  2300. a @i{function} whose behavior depends on the @i{classes} or
  2301. identities of the arguments supplied to it and whose parts include, among
  2302. other things, a set of @i{methods}, a @i{lambda list}, and a
  2303. @i{method combination} type.
  2304. @IGindex{generic function lambda list}
  2305. @item @b{generic function lambda list}
  2306. @i{n.}
  2307. A @i{lambda list} that is used to describe data flow into a @i{generic function}.
  2308. See @ref{Generic Function Lambda Lists}.
  2309. @IGindex{gensym}
  2310. @item @b{gensym}
  2311. @i{n.} @i{Trad.}
  2312. an @i{uninterned} @i{symbol}.
  2313. See the @i{function} @b{gensym}.
  2314. @IGindex{global declaration}
  2315. @item @b{global declaration}
  2316. @i{n.}
  2317. a @i{form} that makes certain kinds of information about
  2318. code globally available; that is, a @b{proclaim} @i{form}
  2319. or a @b{declaim} @i{form}.
  2320. @IGindex{global environment}
  2321. @item @b{global environment}
  2322. @i{n.}
  2323. that part of an @i{environment} that contains @i{bindings}
  2324. with @i{indefinite scope} and @i{indefinite extent}.
  2325. @IGindex{global variable}
  2326. @item @b{global variable}
  2327. @i{n.}
  2328. a @i{dynamic variable} or a @i{constant variable}.
  2329. @IGindex{glyph}
  2330. @item @b{glyph}
  2331. @i{n.}
  2332. a visual representation.
  2333. {``Graphic characters have associated glyphs.''}
  2334. @IGindex{go}
  2335. @item @b{go}
  2336. @i{v.}
  2337. to transfer control to a @i{go point}.
  2338. See the @i{special operator} @b{go}.
  2339. @IGindex{go point}
  2340. @item @b{go point}
  2341. one of possibly several @i{exit points} that are @i{established}
  2342. by @b{tagbody} (or other abstractions, such as @b{prog},
  2343. which are built from @b{tagbody}).
  2344. @IGindex{go tag}
  2345. @item @b{go tag}
  2346. @i{n.}
  2347. the @i{symbol} or @i{integer} that, within the @i{lexical scope}
  2348. of a @b{tagbody} @i{form}, names an @i{exit point}
  2349. @i{established} by that @b{tagbody} @i{form}.
  2350. @IGindex{graphic}
  2351. @item @b{graphic}
  2352. @i{adj.} (of a @i{character})
  2353. being a ``printing'' or ``displayable'' @i{character}
  2354. that has a standard visual representation
  2355. as a single @i{glyph}, such as @t{A} or @t{*} or @t{=}.
  2356. @i{Space} is defined to be @i{graphic}.
  2357. Of the @i{standard characters}, all but @i{newline} are @i{graphic}.
  2358. See @i{non-graphic}.
  2359. @end table
  2360. @subheading @b{H}
  2361. @table @asis
  2362. @IGindex{handle}
  2363. @item @b{handle}
  2364. @i{v.} (of a @i{condition} being @i{signaled})
  2365. to perform a non-local transfer of control, terminating the ongoing
  2366. @i{signaling} of the @i{condition}.
  2367. @IGindex{handler}
  2368. @item @b{handler}
  2369. @i{n.}
  2370. a @i{condition handler}.
  2371. @IGindex{hash table}
  2372. @item @b{hash table}
  2373. @i{n.}
  2374. an @i{object} of @i{type} @b{hash-table},
  2375. which provides a mapping from @i{keys} to @i{values}.
  2376. @IGindex{home package}
  2377. @item @b{home package}
  2378. @i{n.} (of a @i{symbol})
  2379. the @i{package}, if any, which is contents of the @i{package cell}
  2380. of the @i{symbol}, and which dictates how the @i{Lisp printer}
  2381. prints the @i{symbol} when it is not @i{accessible} in the
  2382. @i{current package}. (@i{Symbols} which have @b{nil} in their
  2383. @i{package cell} are said to have no @i{home package}, and also
  2384. to be @i{apparently uninterned}.)
  2385. @end table
  2386. @subheading @b{I}
  2387. @table @asis
  2388. @IGindex{I/O customization variable}
  2389. @item @b{I/O customization variable}
  2390. @i{n.}
  2391. one of the @i{stream variables} in Figure 26--2,
  2392. or some other (@i{implementation-defined}) @i{stream variable}
  2393. that is defined by the @i{implementation}
  2394. to be an @i{I/O customization variable}.
  2395. @group
  2396. @noindent
  2397. @w{ *debug-io* *error-io* query-io* }
  2398. @w{ *standard-input* *standard-output* *trace-output* }
  2399. @noindent
  2400. @w{ Figure 26--2: Standardized I/O Customization Variables}
  2401. @end group
  2402. @IGindex{identical}
  2403. @item @b{identical}
  2404. @i{adj.}
  2405. the @i{same} under @b{eq}.
  2406. @IGindex{identifier}
  2407. @item @b{identifier}
  2408. @i{n.}
  2409. 1. a @i{symbol} used to identify or to distinguish @i{names}.
  2410. 2. a @i{string} used the same way.
  2411. @IGindex{immutable}
  2412. @item @b{immutable}
  2413. @i{adj.}
  2414. not subject to change, either because no @i{operator} is provided which is
  2415. capable of effecting such change or because some constraint exists which
  2416. prohibits the use of an @i{operator} that might otherwise be capable of
  2417. effecting such a change. Except as explicitly indicated otherwise,
  2418. @i{implementations} are not required to detect attempts to modify
  2419. @i{immutable} @i{objects} or @i{cells}; the consequences of attempting
  2420. to make such modification are undefined.
  2421. {``Numbers are immutable.''}
  2422. @IGindex{implementation}
  2423. @item @b{implementation}
  2424. @i{n.}
  2425. a system, mechanism, or body of @i{code} that implements the semantics of @r{Common Lisp}.
  2426. @IGindex{implementation limit}
  2427. @item @b{implementation limit}
  2428. @i{n.}
  2429. a restriction imposed by an @i{implementation}.
  2430. @IGindex{implementation-defined}
  2431. @item @b{implementation-defined}
  2432. @i{adj.}
  2433. @i{implementation-dependent}, but required by this specification to be
  2434. defined by each @i{conforming implementation} and to be documented by
  2435. the corresponding implementor.
  2436. @IGindex{implementation-dependent}
  2437. @item @b{implementation-dependent}
  2438. @i{adj.}
  2439. describing a behavior or aspect of @r{Common Lisp} which has been deliberately left
  2440. unspecified, that might be defined in some @i{conforming implementations}
  2441. but not in others, and whose details may differ between @i{implementations}.
  2442. A @i{conforming implementation} is encouraged (but not required) to
  2443. document its treatment of each item in this specification which is
  2444. marked @i{implementation-dependent}, although in some cases
  2445. such documentation might simply identify the item as ``undefined.''
  2446. @IGindex{implementation-independent}
  2447. @item @b{implementation-independent}
  2448. @i{adj.}
  2449. used to identify or emphasize a behavior or aspect of @r{Common Lisp} which does
  2450. not vary between @i{conforming implementations}.
  2451. @IGindex{implicit block}
  2452. @item @b{implicit block}
  2453. @i{n.}
  2454. a @i{block} introduced by a @i{macro form}
  2455. rather than by an explicit @b{block} @i{form}.
  2456. @IGindex{implicit compilation}
  2457. @item @b{implicit compilation}
  2458. @i{n.}
  2459. @i{compilation} performed during @i{evaluation}.
  2460. @IGindex{implicit progn}
  2461. @item @b{implicit progn}
  2462. @i{n.}
  2463. an ordered set of adjacent @i{forms} appearing in another
  2464. @i{form}, and defined by their context in that @i{form}
  2465. to be executed as if within a @b{progn}.
  2466. @IGindex{implicit tagbody}
  2467. @item @b{implicit tagbody}
  2468. @i{n.}
  2469. an ordered set of adjacent @i{forms} and/or @i{tags}
  2470. appearing in another @i{form}, and defined by their context
  2471. in that @i{form} to be executed as if within a @b{tagbody}.
  2472. @IGindex{import}
  2473. @item @b{import}
  2474. @i{v.t.} (a @i{symbol} into a @i{package})
  2475. to make the @i{symbol} be @i{present} in the @i{package}.
  2476. @IGindex{improper list}
  2477. @item @b{improper list}
  2478. @i{n.}
  2479. a @i{list} which is not a @i{proper list}:
  2480. a @i{circular list} or a @i{dotted list}.
  2481. @IGindex{inaccessible}
  2482. @item @b{inaccessible}
  2483. @i{adj.}
  2484. not @i{accessible}.
  2485. @IGindex{indefinite extent}
  2486. @item @b{indefinite extent}
  2487. @i{n.}
  2488. an @i{extent} whose duration is unlimited.
  2489. {``Most Common Lisp objects have indefinite extent.''}
  2490. @IGindex{indefinite scope}
  2491. @item @b{indefinite scope}
  2492. @i{n.}
  2493. @i{scope} that is unlimited.
  2494. @IGindex{indicator}
  2495. @item @b{indicator}
  2496. @i{n.}
  2497. a @i{property indicator}.
  2498. @IGindex{indirect instance}
  2499. @item @b{indirect instance}
  2500. @i{n.} (of a @i{class} C_1)
  2501. an @i{object} of @i{class} C_2,
  2502. where C_2 is a @i{subclass} of C_1.
  2503. {``An integer is an indirect instance of the class @b{number}.''}
  2504. @IGindex{inherit}
  2505. @item @b{inherit}
  2506. @i{v.t.}
  2507. 1. to receive or acquire a quality, trait, or characteristic;
  2508. to gain access to a feature defined elsewhere.
  2509. 2. (a @i{class}) to acquire the structure and behavior defined
  2510. by a @i{superclass}.
  2511. 3. (a @i{package}) to make @i{symbols} @i{exported} by another
  2512. @i{package} @i{accessible} by using @b{use-package}.
  2513. @IGindex{initial pprint dispatch table}
  2514. @item @b{initial pprint dispatch table}
  2515. @i{n.}
  2516. the @i{value} of @b{*print-pprint-dispatch*} at the time the @i{Lisp image} is started.
  2517. @IGindex{initial readtable}
  2518. @item @b{initial readtable}
  2519. @i{n.}
  2520. the @i{value} of @b{*readtable*} at the time the @i{Lisp image} is started.
  2521. @IGindex{initialization argument list}
  2522. @item @b{initialization argument list}
  2523. @i{n.}
  2524. a @i{property list} of initialization argument @i{names} and @i{values}
  2525. used in the protocol for initializing and reinitializing @i{instances} of @i{classes}.
  2526. See @ref{Object Creation and Initialization}.
  2527. @IGindex{initialization form}
  2528. @item @b{initialization form}
  2529. @i{n.}
  2530. a @i{form} used to supply the initial @i{value} for a @i{slot}
  2531. or @i{variable}.
  2532. {``The initialization form for a slot in a @b{defclass} form
  2533. is introduced by the keyword @t{:initform}.''}
  2534. @IGindex{input}
  2535. @item @b{input}
  2536. @i{adj.} (of a @i{stream})
  2537. supporting input operations (@i{i.e.}, being a ``data source'').
  2538. An @i{input} @i{stream} might also be an @i{output} @i{stream},
  2539. in which case it is sometimes called a @i{bidirectional} @i{stream}.
  2540. See the @i{function} @b{input-stream-p}.
  2541. @IGindex{instance}
  2542. @item @b{instance}
  2543. @i{n.}
  2544. 1. a @i{direct instance}.
  2545. 2. a @i{generalized instance}.
  2546. 3. an @i{indirect instance}.
  2547. @IGindex{integer}
  2548. @item @b{integer}
  2549. @i{n.}
  2550. an @i{object} of @i{type} @b{integer}, which represents a mathematical integer.
  2551. @IGindex{interactive stream}
  2552. @item @b{interactive stream}
  2553. @i{n.}
  2554. a @i{stream} on which it makes sense to perform interactive querying.
  2555. See @ref{Interactive Streams}.
  2556. @IGindex{intern}
  2557. @item @b{intern}
  2558. @i{v.t.}
  2559. 1. (a @i{string} in a @i{package})
  2560. to look up the @i{string} in the @i{package},
  2561. returning either a @i{symbol} with that @i{name}
  2562. which was already @i{accessible} in the @i{package}
  2563. or a newly created @i{internal symbol} of the @i{package}
  2564. with that @i{name}.
  2565. 2. @i{Idiom.} generally, to observe a protocol whereby objects which
  2566. are equivalent or have equivalent names under some predicate defined
  2567. by the protocol are mapped to a single canonical object.
  2568. @IGindex{internal symbol}
  2569. @item @b{internal symbol}
  2570. @i{n.} (of a @i{package})
  2571. a symbol which is @i{accessible} in the @i{package},
  2572. but which is not an @i{external symbol} of the @i{package}.
  2573. @IGindex{internal time}
  2574. @item @b{internal time}
  2575. @i{n.}
  2576. @i{time}, represented as an @i{integer} number of @i{internal time units}.
  2577. @i{Absolute} @i{internal time} is measured as an offset
  2578. from an arbitrarily chosen, @i{implementation-dependent} base.
  2579. See @ref{Internal Time}.
  2580. @IGindex{internal time unit}
  2581. @item @b{internal time unit}
  2582. @i{n.}
  2583. a unit of time equal to 1/n of a second,
  2584. for some @i{implementation-defined} @i{integer} value of n.
  2585. See the @i{variable} @b{internal-time-units-per-second}.
  2586. @IGindex{interned}
  2587. @item @b{interned}
  2588. @i{adj.} @i{Trad.}
  2589. 1. (of a @i{symbol}) @i{accessible}_3 in
  2590. any @i{package}.
  2591. 2. (of a @i{symbol} in a specific @i{package})
  2592. @i{present} in that @i{package}.
  2593. @IGindex{interpreted function}
  2594. @item @b{interpreted function}
  2595. @i{n.}
  2596. a @i{function} that is not a @i{compiled function}.
  2597. (It is possible for there to be a @i{conforming implementation} which
  2598. has no @i{interpreted functions}, but a @i{conforming program}
  2599. must not assume that all @i{functions} are @i{compiled functions}.)
  2600. @IGindex{interpreted implementation}
  2601. @item @b{interpreted implementation}
  2602. @i{n.}
  2603. an @i{implementation} that uses an execution strategy for
  2604. @i{interpreted functions} that does not involve a one-time semantic
  2605. analysis pre-pass, and instead uses ``lazy'' (and sometimes repetitious)
  2606. semantic analysis of @i{forms} as they are encountered during execution.
  2607. @IGindex{interval designator}
  2608. @item @b{interval designator}
  2609. @i{n.} (of @i{type} T)
  2610. an ordered pair of @i{objects} that describe a @i{subtype} of T
  2611. by delimiting an interval on the real number line.
  2612. See @ref{Interval Designators}.
  2613. @IGindex{invalid}
  2614. @item @b{invalid}
  2615. @i{n.}, @i{adj.}
  2616. 1. @i{n.}
  2617. a possible @i{constituent trait} of a @i{character}
  2618. which if present signifies that the @i{character}
  2619. cannot ever appear in a @i{token}
  2620. except under the control of a @i{single escape} @i{character}.
  2621. For details, see @ref{Constituent Characters}.
  2622. 2. @i{adj.} (of a @i{character})
  2623. being a @i{character} that has @i{syntax type} @i{constituent}
  2624. in the @i{current readtable} and that has the
  2625. @i{constituent trait} @i{invalid}_1.
  2626. See @i{Figure~2--8}.
  2627. @IGindex{iteration form}
  2628. @item @b{iteration form}
  2629. @i{n.}
  2630. a @i{compound form} whose @i{operator} is named in Figure 26--3,
  2631. or a @i{compound form} that has an @i{implementation-defined} @i{operator}
  2632. and that is defined by the @i{implementation} to be an @i{iteration form}.
  2633. @group
  2634. @noindent
  2635. @w{ do do-external-symbols dotimes }
  2636. @w{ do* do-symbols loop }
  2637. @w{ do-all-symbols dolist }
  2638. @noindent
  2639. @w{ Figure 26--3: Standardized Iteration Forms }
  2640. @end group
  2641. @IGindex{iteration variable}
  2642. @item @b{iteration variable}
  2643. @i{n.}
  2644. a @i{variable} V, the @i{binding} for which was created by an
  2645. @i{explicit use} of V in an @i{iteration form}.
  2646. @end table
  2647. @subheading @b{K}
  2648. @table @asis
  2649. @IGindex{key}
  2650. @item @b{key}
  2651. @i{n.}
  2652. an @i{object} used for selection during retrieval.
  2653. See @i{association list}, @i{property list}, and @i{hash table}.
  2654. Also, see @ref{Sequence Concepts}.
  2655. @IGindex{keyword}
  2656. @item @b{keyword}
  2657. @i{n.}
  2658. 1. a @i{symbol} the @i{home package} of which is the @t{KEYWORD} @i{package}.
  2659. 2. any @i{symbol}, usually but not necessarily in the @t{KEYWORD} @i{package},
  2660. that is used as an identifying marker in keyword-style argument passing.
  2661. See @b{lambda}.
  2662. 3. @i{Idiom.} a @i{lambda list keyword}.
  2663. @IGindex{keyword parameter}
  2664. @item @b{keyword parameter}
  2665. @i{n.}
  2666. A @i{parameter} for which a corresponding keyword @i{argument}
  2667. is optional. (There is no such thing as a required keyword @i{argument}.)
  2668. If the @i{argument} is not supplied, a default value is used.
  2669. See also @i{supplied-p parameter}.
  2670. @IGindex{keyword/value pair}
  2671. @item @b{keyword/value pair}
  2672. @i{n.}
  2673. two successive @i{elements} (a @i{keyword} and a @i{value},
  2674. respectively) of a @i{property list}.
  2675. @end table
  2676. @subheading @b{L}
  2677. @table @asis
  2678. @IGindex{lambda combination}
  2679. @item @b{lambda combination}
  2680. @i{n.} @i{Trad.}
  2681. a @i{lambda form}.
  2682. @IGindex{lambda expression}
  2683. @item @b{lambda expression}
  2684. @i{n.}
  2685. a @i{list} which can be used in place of a @i{function name} in
  2686. certain contexts to denote a @i{function} by directly describing its
  2687. behavior rather than indirectly by referring to the name of an
  2688. @i{established} @i{function}; its name derives from the fact that its
  2689. first element is the @i{symbol} @t{lambda}.
  2690. See @b{lambda}.
  2691. @IGindex{lambda form}
  2692. @item @b{lambda form}
  2693. @i{n.}
  2694. a @i{form} that is a @i{list} and that has a first element
  2695. which is a @i{lambda expression} representing a @i{function}
  2696. to be called on @i{arguments} which are the result of @i{evaluating}
  2697. subsequent elements of the @i{lambda form}.
  2698. @IGindex{lambda list}
  2699. @item @b{lambda list}
  2700. @i{n.}
  2701. a @i{list} that specifies a set of @i{parameters}
  2702. (sometimes called @i{lambda variables})
  2703. and a protocol for receiving @i{values} for those @i{parameters};
  2704. that is,
  2705. an @i{ordinary lambda list},
  2706. an @i{extended lambda list},
  2707. or a @i{modified lambda list}.
  2708. @IGindex{lambda list keyword}
  2709. @item @b{lambda list keyword}
  2710. @i{n.}
  2711. a @i{symbol} whose @i{name} begins with @i{ampersand}
  2712. and that is specially recognized in a @i{lambda list}.
  2713. Note that no @i{standardized} @i{lambda list keyword}
  2714. is in the @t{KEYWORD} @i{package}.
  2715. @IGindex{lambda variable}
  2716. @item @b{lambda variable}
  2717. @i{n.}
  2718. a @i{formal parameter}, used to emphasize the @i{variable}'s
  2719. relation to the @i{lambda list} that @i{established} it.
  2720. @IGindex{leaf}
  2721. @item @b{leaf}
  2722. @i{n.}
  2723. 1. an @i{atom} in a @i{tree}_1.
  2724. 2. a terminal node of a @i{tree}_2.
  2725. @IGindex{leap seconds}
  2726. @item @b{leap seconds}
  2727. @i{n.}
  2728. additional one-second intervals of time that are occasionally inserted
  2729. into the true calendar by official timekeepers as a correction similar
  2730. to ``leap years.'' All @r{Common Lisp} @i{time} representations ignore
  2731. @i{leap seconds}; every day is assumed to be exactly 86400 seconds
  2732. long.
  2733. @IGindex{left-parenthesis}
  2734. @item @b{left-parenthesis}
  2735. @i{n.}
  2736. the @i{standard character} ``@t{(}'',
  2737. that is variously called
  2738. ``left parenthesis''
  2739. or ``open parenthesis''
  2740. See @i{Figure~2--5}.
  2741. @IGindex{length}
  2742. @item @b{length}
  2743. @i{n.} (of a @i{sequence})
  2744. the number of @i{elements} in the @i{sequence}.
  2745. (Note that if the @i{sequence} is a @i{vector} with a
  2746. @i{fill pointer}, its @i{length} is the same as the
  2747. @i{fill pointer} even though the total allocated size of
  2748. the @i{vector} might be larger.)
  2749. @IGindex{lexical binding}
  2750. @item @b{lexical binding}
  2751. @i{n.}
  2752. a @i{binding} in a @i{lexical environment}.
  2753. @IGindex{lexical closure}
  2754. @item @b{lexical closure}
  2755. @i{n.}
  2756. a @i{function} that, when invoked on @i{arguments}, executes
  2757. the body of a @i{lambda expression} in the @i{lexical environment}
  2758. that was captured at the time of the creation of the @i{lexical closure},
  2759. augmented by @i{bindings} of the @i{function}'s @i{parameters}
  2760. to the corresponding @i{arguments}.
  2761. @IGindex{lexical environment}
  2762. @item @b{lexical environment}
  2763. @i{n.}
  2764. that part of the @i{environment} that contains @i{bindings}
  2765. whose names have @i{lexical scope}. A @i{lexical environment}
  2766. contains, among other things:
  2767. ordinary @i{bindings} of @i{variable} @i{names} to @i{values},
  2768. lexically @i{established} @i{bindings} of @i{function names}
  2769. to @i{functions},
  2770. @i{macros},
  2771. @i{symbol macros},
  2772. @i{blocks},
  2773. @i{tags},
  2774. and
  2775. @i{local declarations} (see @b{declare}).
  2776. @IGindex{lexical scope}
  2777. @item @b{lexical scope}
  2778. @i{n.}
  2779. @i{scope} that is limited to a spatial or textual region within the
  2780. establishing @i{form}.
  2781. {``The names of parameters to a function normally are lexically scoped.''}
  2782. @IGindex{lexical variable}
  2783. @item @b{lexical variable}
  2784. @i{n.}
  2785. a @i{variable} the @i{binding} for which is in the
  2786. @i{lexical environment}.
  2787. @IGindex{Lisp image}
  2788. @item @b{Lisp image}
  2789. @i{n.}
  2790. a running instantiation of a @r{Common Lisp} @i{implementation}.
  2791. A @i{Lisp image} is characterized by a single address space in which any
  2792. @i{object} can directly refer to any another in conformance with this specification,
  2793. and by a single, common, @i{global environment}.
  2794. (External operating systems sometimes call this a
  2795. ``core image,''
  2796. ``fork,''
  2797. ``incarnation,''
  2798. ``job,''
  2799. or ``process.'' Note however, that the issue of a ``process'' in such
  2800. an operating system is technically orthogonal to the issue of a @i{Lisp image}
  2801. being defined here. Depending on the operating system, a single ``process''
  2802. might have multiple @i{Lisp images}, and multiple ``processes'' might reside
  2803. in a single @i{Lisp image}. Hence, it is the idea of a fully shared address
  2804. space for direct reference among all @i{objects} which is the defining
  2805. characteristic. Note, too, that two ``processes'' which have a communication
  2806. area that permits the sharing of some but not all @i{objects} are considered
  2807. to be distinct @i{Lisp images}.)
  2808. @IGindex{Lisp printer}
  2809. @item @b{Lisp printer}
  2810. @i{n.} @i{Trad.}
  2811. the procedure that prints the character representation of an
  2812. @i{object} onto a @i{stream}. (This procedure is implemented
  2813. by the @i{function} @b{write}.)
  2814. @IGindex{Lisp read-eval-print loop}
  2815. @item @b{Lisp read-eval-print loop}
  2816. @i{n.} @i{Trad.}
  2817. an endless loop that @i{reads}_2 a @i{form},
  2818. @i{evaluates} it,
  2819. and prints (@i{i.e.}, @i{writes}_2) the results.
  2820. In many @i{implementations},
  2821. the default mode of interaction with @r{Common Lisp} during program development
  2822. is through such a loop.
  2823. @IGindex{Lisp reader}
  2824. @item @b{Lisp reader}
  2825. @i{n.} @i{Trad.}
  2826. the procedure that parses character representations of @i{objects}
  2827. from a @i{stream}, producing @i{objects}.
  2828. (This procedure is implemented by the @i{function} @b{read}.)
  2829. @IGindex{list}
  2830. @item @b{list}
  2831. @i{n.}
  2832. 1. a chain of @i{conses} in which the @i{car} of each
  2833. @i{cons} is an @i{element} of the @i{list},
  2834. and the @i{cdr} of each @i{cons} is either the next
  2835. link in the chain or a terminating @i{atom}.
  2836. See also @i{proper list},
  2837. @i{dotted list},
  2838. or @i{circular list}.
  2839. 2. the @i{type} that is the union of @b{null} and @b{cons}.
  2840. @IGindex{list designator}
  2841. @item @b{list designator}
  2842. @i{n.}
  2843. a @i{designator} for a @i{list} of @i{objects}; that is,
  2844. an @i{object} that denotes a @i{list}
  2845. and that is one of:
  2846. a @i{non-nil} @i{atom}
  2847. (denoting a @i{singleton} @i{list}
  2848. whose @i{element} is that @i{non-nil} @i{atom})
  2849. or a @i{proper list} (denoting itself).
  2850. @IGindex{list structure}
  2851. @item @b{list structure}
  2852. @i{n.} (of a @i{list})
  2853. the set of @i{conses} that make up the @i{list}.
  2854. Note that while the @i{car}_@{1b@} component of each such @i{cons}
  2855. is part of the @i{list structure},
  2856. the @i{objects} that are @i{elements} of the @i{list}
  2857. (@i{i.e.}, the @i{objects} that are the @i{cars}_2 of each @i{cons}
  2858. in the @i{list})
  2859. are not themselves part of its @i{list structure},
  2860. even if they are @i{conses},
  2861. except in the (@i{circular}_2)
  2862. case where the @i{list}
  2863. actually contains one of its @i{tails} as an @i{element}.
  2864. (The @i{list structure} of a @i{list} is sometimes redundantly
  2865. referred to as its ``top-level list structure'' in order to emphasize
  2866. that any @i{conses} that are @i{elements} of the @i{list}
  2867. are not involved.)
  2868. @IGindex{literal}
  2869. @item @b{literal}
  2870. @i{adj.} (of an @i{object})
  2871. referenced directly in a program rather than being computed by the program;
  2872. that is,
  2873. appearing as data in a @b{quote} @i{form},
  2874. or, if the @i{object} is a @i{self-evaluating object},
  2875. appearing as unquoted data.
  2876. {``In the form @t{(cons "one" '("two"))},
  2877. the expressions @t{"one"}, @t{("two")}, and @t{"two"}
  2878. are literal objects.''}
  2879. @IGindex{load}
  2880. @item @b{load}
  2881. @i{v.t.} (a @i{file})
  2882. to cause the @i{code} contained in the @i{file} to be @i{executed}.
  2883. See the @i{function} @b{load}.
  2884. @IGindex{load time}
  2885. @item @b{load time}
  2886. @i{n.}
  2887. the duration of time that the loader is @i{loading} @i{compiled code}.
  2888. @IGindex{load time value}
  2889. @item @b{load time value}
  2890. @i{n.}
  2891. an @i{object} referred to in @i{code} by a @b{load-time-value}
  2892. @i{form}. The @i{value} of such a @i{form} is some specific
  2893. @i{object} which can only be computed in the run-time @i{environment}.
  2894. In the case of @i{file} @i{compilation}, the @i{value} is
  2895. computed once as part of the process of @i{loading} the @i{compiled file},
  2896. and not again. See the @i{special operator} @b{load-time-value}.
  2897. @IGindex{loader}
  2898. @item @b{loader}
  2899. @i{n.}
  2900. a facility that is part of Lisp and that @i{loads} a @i{file}.
  2901. See the @i{function} @b{load}.
  2902. @IGindex{local declaration}
  2903. @item @b{local declaration}
  2904. @i{n.}
  2905. an @i{expression} which may appear only in specially designated
  2906. positions of certain @i{forms}, and which provides information about
  2907. the code contained within the containing @i{form};
  2908. that is, a @b{declare} @i{expression}.
  2909. @IGindex{local precedence order}
  2910. @item @b{local precedence order}
  2911. @i{n.} (of a @i{class})
  2912. a @i{list} consisting of the @i{class} followed by its
  2913. @i{direct superclasses} in the order mentioned in the defining
  2914. @i{form} for the @i{class}.
  2915. @IGindex{local slot}
  2916. @item @b{local slot}
  2917. @i{n.} (of a @i{class})
  2918. a @i{slot} @i{accessible} in only one @i{instance},
  2919. namely the @i{instance} in which the @i{slot} is allocated.
  2920. @IGindex{logical block}
  2921. @item @b{logical block}
  2922. @i{n.}
  2923. a conceptual grouping of related output used by the @i{pretty printer}.
  2924. See the @i{macro} @b{pprint-logical-block} and @ref{Dynamic Control of the Arrangement of Output}.
  2925. @IGindex{logical host}
  2926. @item @b{logical host}
  2927. @i{n.}
  2928. an @i{object} of @i{implementation-dependent} nature
  2929. that is used as the representation of a ``host'' in a @i{logical pathname},
  2930. and that has an associated set of translation rules for converting
  2931. @i{logical pathnames} belonging to that host into @i{physical pathnames}.
  2932. See @ref{Logical Pathnames}.
  2933. @IGindex{logical host designator}
  2934. @item @b{logical host designator}
  2935. @i{n.}
  2936. a @i{designator} for a @i{logical host}; that is,
  2937. an @i{object} that denotes a @i{logical host}
  2938. and that is one of:
  2939. a @i{string} (denoting the @i{logical host} that it names),
  2940. or a @i{logical host} (denoting itself).
  2941. (Note that because the representation of a @i{logical host}
  2942. is @i{implementation-dependent},
  2943. it is possible that an @i{implementation} might represent
  2944. a @i{logical host} as the @i{string} that names it.)
  2945. @IGindex{logical pathname}
  2946. @item @b{logical pathname}
  2947. @i{n.}
  2948. an @i{object} of @i{type} @b{logical-pathname}.
  2949. @IGindex{long float}
  2950. @item @b{long float}
  2951. @i{n.}
  2952. an @i{object} of @i{type} @b{long-float}.
  2953. @IGindex{loop keyword}
  2954. @item @b{loop keyword}
  2955. @i{n.} @i{Trad.}
  2956. a symbol that is a specially recognized part of the syntax of
  2957. an extended @b{loop} @i{form}. Such symbols are recognized by their
  2958. @i{name} (using @b{string=}), not by their identity; as such, they
  2959. may be in any package. A @i{loop keyword} is not a @i{keyword}.
  2960. @IGindex{lowercase}
  2961. @item @b{lowercase}
  2962. @i{adj.} (of a @i{character})
  2963. being among @i{standard characters} corresponding to
  2964. the small letters @t{a} through @t{z},
  2965. or being some other @i{implementation-defined} @i{character}
  2966. that is defined by the @i{implementation} to be @i{lowercase}.
  2967. See @ref{Characters With Case}.
  2968. @end table
  2969. @subheading @b{M}
  2970. @table @asis
  2971. @IGindex{macro}
  2972. @item @b{macro}
  2973. @i{n.}
  2974. 1. a @i{macro form}
  2975. 2. a @i{macro function}.
  2976. 3. a @i{macro name}.
  2977. @IGindex{macro character}
  2978. @item @b{macro character}
  2979. @i{n.}
  2980. a @i{character} which, when encountered by the @i{Lisp reader}
  2981. in its main dispatch loop, introduces a @i{reader macro}_1.
  2982. (@i{Macro characters} have nothing to do with @i{macros}.)
  2983. @IGindex{macro expansion}
  2984. @item @b{macro expansion}
  2985. @i{n.}
  2986. 1. the process of translating a @i{macro form} into another
  2987. @i{form}.
  2988. 2. the @i{form} resulting from this process.
  2989. @IGindex{macro form}
  2990. @item @b{macro form}
  2991. @i{n.}
  2992. a @i{form} that stands for another @i{form}
  2993. (@i{e.g.}, for the purposes of abstraction, information hiding,
  2994. or syntactic convenience);
  2995. that is,
  2996. either a @i{compound form} whose first element is a @i{macro name},
  2997. or a @i{form} that is a @i{symbol} that names a
  2998. @i{symbol macro}.
  2999. @IGindex{macro function}
  3000. @item @b{macro function}
  3001. @i{n.}
  3002. a @i{function} of two arguments, a @i{form} and an
  3003. @i{environment}, that implements @i{macro expansion} by
  3004. producing a @i{form} to be evaluated in place of the original
  3005. argument @i{form}.
  3006. @IGindex{macro lambda list}
  3007. @item @b{macro lambda list}
  3008. @i{n.}
  3009. an @i{extended lambda list} used in @i{forms} that @i{establish}
  3010. @i{macro} definitions, such as @b{defmacro} and @b{macrolet}.
  3011. See @ref{Macro Lambda Lists}.
  3012. @IGindex{macro name}
  3013. @item @b{macro name}
  3014. @i{n.}
  3015. a @i{name} for which @b{macro-function} returns @i{true}
  3016. and which when used as the first element of a @i{compound form}
  3017. identifies that @i{form} as a @i{macro form}.
  3018. @IGindex{macroexpand hook}
  3019. @item @b{macroexpand hook}
  3020. @i{n.}
  3021. the @i{function} that is the @i{value} of @b{*macroexpand-hook*}.
  3022. @IGindex{mapping}
  3023. @item @b{mapping}
  3024. @i{n.}
  3025. 1. a type of iteration in which a @i{function} is successively
  3026. applied to @i{objects} taken from corresponding entries in
  3027. collections such as @i{sequences} or @i{hash tables}.
  3028. 2. @i{Math.} a relation between two sets in which each element of the
  3029. first set (the ``domain'') is assigned one element of the second
  3030. set (the ``range'').
  3031. @IGindex{metaclass}
  3032. @item @b{metaclass}
  3033. @i{n.}
  3034. 1. a @i{class} whose instances are @i{classes}.
  3035. 2. (of an @i{object}) the @i{class} of the @i{class} of the @i{object}.
  3036. @IGindex{Metaobject Protocol}
  3037. @item @b{Metaobject Protocol}
  3038. @i{n.}
  3039. one of many possible descriptions of how a @i{conforming implementation}
  3040. might implement various aspects of the object system. This description is beyond
  3041. the scope of this document, and no @i{conforming implementation} is
  3042. required to adhere to it except as noted explicitly in this specification.
  3043. Nevertheless, its existence helps to establish normative practice,
  3044. and implementors with no reason to diverge from it are encouraged to
  3045. consider making their @i{implementation} adhere to it where possible.
  3046. It is described in detail in @i{The Art of the Metaobject Protocol}.
  3047. @IGindex{method}
  3048. @item @b{method}
  3049. @i{n.}
  3050. an @i{object} that is part of a @i{generic function} and which
  3051. provides information about how that @i{generic function} should
  3052. behave when its @i{arguments} are @i{objects} of certain
  3053. @i{classes} or with certain identities.
  3054. @IGindex{method combination}
  3055. @item @b{method combination}
  3056. @i{n.}
  3057. 1. generally, the composition of a set of @i{methods} to produce an
  3058. @i{effective method} for a @i{generic function}.
  3059. 2. an object of @i{type} @b{method-combination}, which represents the details
  3060. of how the @i{method combination}_1 for one or more
  3061. specific @i{generic functions} is to be performed.
  3062. @IGindex{method-defining form}
  3063. @item @b{method-defining form}
  3064. @i{n.}
  3065. a @i{form} that defines a @i{method} for a @i{generic function},
  3066. whether explicitly or implicitly.
  3067. See @ref{Introduction to Generic Functions}.
  3068. @IGindex{method-defining operator}
  3069. @item @b{method-defining operator}
  3070. @i{n.}
  3071. an @i{operator} corresponding to a @i{method-defining} @i{form}.
  3072. See @i{Figure~7--1}.
  3073. @IGindex{minimal compilation}
  3074. @item @b{minimal compilation}
  3075. @i{n.}
  3076. actions the @i{compiler} must take at compile time.
  3077. See @ref{Compilation Semantics}.
  3078. @IGindex{modified lambda list}
  3079. @item @b{modified lambda list}
  3080. @i{n.}
  3081. a list resembling an @i{ordinary lambda list} in form and purpose,
  3082. but which deviates in syntax or functionality from the definition of an
  3083. @i{ordinary lambda list}.
  3084. See @i{ordinary lambda list}.
  3085. {``@b{deftype} uses a modified lambda list.''}
  3086. @IGindex{most recent}
  3087. @item @b{most recent}
  3088. @i{adj.}
  3089. innermost;
  3090. that is, having been @i{established} (and not yet @i{disestablished})
  3091. more recently than any other of its kind.
  3092. @IGindex{multiple escape}
  3093. @item @b{multiple escape}
  3094. @i{n.}, @i{adj.}
  3095. 1. @i{n.} the @i{syntax type} of a @i{character}
  3096. that is used in pairs to indicate that the enclosed @i{characters}
  3097. are to be treated as @i{alphabetic}_2 @i{characters}
  3098. with their @i{case} preserved.
  3099. For details, see @ref{Multiple Escape Characters}.
  3100. 2. @i{adj.} (of a @i{character})
  3101. having the @i{multiple escape} @i{syntax type}.
  3102. 3. @i{n.} a @i{multiple escape}_2 @i{character}.
  3103. (In the @i{standard readtable},
  3104. @i{vertical-bar} is a @i{multiple escape} @i{character}.)
  3105. @IGindex{multiple values}
  3106. @item @b{multiple values}
  3107. @i{n.}
  3108. 1. more than one @i{value}.
  3109. {``The function @b{truncate} returns multiple values.''}
  3110. 2. a variable number of @i{values}, possibly including zero or one.
  3111. {``The function @b{values} returns multiple values.''}
  3112. 3. a fixed number of values other than one.
  3113. {``The macro @b{multiple-value-bind} is among the few
  3114. operators in @r{Common Lisp} which can detect and manipulate
  3115. multiple values.''}
  3116. @end table
  3117. @subheading @b{N}
  3118. @table @asis
  3119. @IGindex{name}
  3120. @item @b{name}
  3121. @i{n.}, @i{v.t.}
  3122. 1. @i{n.} an @i{identifier} by which an @i{object},
  3123. a @i{binding}, or an @i{exit point}
  3124. is referred to by association using a @i{binding}.
  3125. 2. @i{v.t.} to give a @i{name} to.
  3126. 3. @i{n.} (of an @i{object} having a name component)
  3127. the @i{object} which is that component.
  3128. {``The string which is a symbol's name is returned
  3129. by @b{symbol-name}.''}
  3130. 4. @i{n.} (of a @i{pathname})
  3131. a. the name component, returned by @b{pathname-name}.
  3132. b. the entire namestring, returned by @b{namestring}.
  3133. 5. @i{n.} (of a @i{character})
  3134. a @i{string} that names the @i{character}
  3135. and that has @i{length} greater than one.
  3136. (All @i{non-graphic} @i{characters} are required to have @i{names}
  3137. unless they have some @i{implementation-defined} @i{attribute}
  3138. which is not @i{null}. Whether or not other @i{characters}
  3139. have @i{names} is @i{implementation-dependent}.)
  3140. @IGindex{named constant}
  3141. @item @b{named constant}
  3142. @i{n.}
  3143. a @i{variable} that is defined by @r{Common Lisp},
  3144. by the @i{implementation},
  3145. or by user code (see the @i{macro} @b{defconstant})
  3146. to always @i{yield} the same @i{value} when @i{evaluated}.
  3147. {``The value of a named constant may not be changed
  3148. by assignment or by binding.''}
  3149. @IGindex{namespace}
  3150. @item @b{namespace}
  3151. @i{n.}
  3152. 1. @i{bindings} whose denotations are restricted to a particular kind.
  3153. {``The bindings of names to tags is the tag namespace.''}
  3154. 2. any @i{mapping} whose domain is a set of @i{names}.
  3155. {``A package defines a namespace.''}
  3156. @IGindex{namestring}
  3157. @item @b{namestring}
  3158. @i{n.}
  3159. a @i{string} that represents a @i{filename}
  3160. using either the @i{standardized} notation for naming @i{logical pathnames}
  3161. described in @ref{Syntax of Logical Pathname Namestrings},
  3162. or some @i{implementation-defined} notation for naming a @i{physical pathname}.
  3163. @IGindex{newline}
  3164. @item @b{newline}
  3165. @i{n.}
  3166. the @i{standard character} <@i{Newline}>,
  3167. notated for the @i{Lisp reader} as @t{#\Newline}.
  3168. @IGindex{next method}
  3169. @item @b{next method}
  3170. @i{n.}
  3171. the next @i{method} to be invoked with respect to a given
  3172. @i{method} for a particular set of arguments or argument
  3173. @i{classes}.
  3174. See @ref{Applying method combination to the sorted list of applicable methods}.
  3175. @IGindex{nickname}
  3176. @item @b{nickname}
  3177. @i{n.} (of a @i{package})
  3178. one of possibly several @i{names} that can be used to refer to
  3179. the @i{package} but that is not the primary @i{name}
  3180. of the @i{package}.
  3181. @IGindex{nil}
  3182. @item @b{nil}
  3183. @i{n.}
  3184. the @i{object} that is at once
  3185. the @i{symbol} named @t{"NIL"} in the @t{COMMON-LISP} @i{package},
  3186. the @i{empty list},
  3187. the @i{boolean} (or @i{generalized boolean}) representing @i{false},
  3188. and the @i{name} of the @i{empty type}.
  3189. @IGindex{non-atomic}
  3190. @item @b{non-atomic}
  3191. @i{adj.}
  3192. being other than an @i{atom}; @i{i.e.}, being a @i{cons}.
  3193. @IGindex{non-constant variable}
  3194. @item @b{non-constant variable}
  3195. @i{n.}
  3196. a @i{variable} that is not a @i{constant variable}.
  3197. @IGindex{non-correctable}
  3198. @item @b{non-correctable}
  3199. @i{adj.} (of an @i{error})
  3200. not intentionally @i{correctable}.
  3201. (Because of the dynamic nature of @i{restarts},
  3202. it is neither possible nor generally useful to completely prohibit
  3203. an @i{error} from being @i{correctable}.
  3204. This term is used in order to express an intent that no special effort
  3205. should be made by @i{code} signaling an @i{error} to make
  3206. that @i{error} @i{correctable};
  3207. however, there is no actual requirement on @i{conforming programs}
  3208. or @i{conforming implementations} imposed by this term.)
  3209. @IGindex{non-empty}
  3210. @item @b{non-empty}
  3211. @i{adj.}
  3212. having at least one @i{element}.
  3213. @IGindex{non-generic function}
  3214. @item @b{non-generic function}
  3215. @i{n.}
  3216. a @i{function} that is not a @i{generic function}.
  3217. @IGindex{non-graphic}
  3218. @item @b{non-graphic}
  3219. @i{adj.} (of a @i{character})
  3220. not @i{graphic}.
  3221. See @ref{Graphic Characters}.
  3222. @IGindex{non-list}
  3223. @item @b{non-list}
  3224. @i{n.}, @i{adj.}
  3225. other than a @i{list}; @i{i.e.}, a @i{non-nil} @i{atom}.
  3226. @IGindex{non-local exit}
  3227. @item @b{non-local exit}
  3228. @i{n.}
  3229. a transfer of control (and sometimes @i{values}) to
  3230. an @i{exit point} for reasons other than a @i{normal return}.
  3231. {``The operators @b{go}, @b{throw},
  3232. and @b{return-from} cause a non-local exit.''}
  3233. @IGindex{non-nil}
  3234. @item @b{non-nil}
  3235. @i{n.}, @i{adj.}
  3236. not @b{nil}. Technically, any @i{object} which is not @b{nil} can be
  3237. referred to as @i{true}, but that would tend to imply a unique view
  3238. of the @i{object} as a @i{generalized boolean}.
  3239. Referring to such an @i{object} as @i{non-nil} avoids this implication.
  3240. @IGindex{non-null lexical environment}
  3241. @item @b{non-null lexical environment}
  3242. @i{n.}
  3243. a @i{lexical environment} that has additional information not present in
  3244. the @i{global environment}, such as one or more @i{bindings}.
  3245. @IGindex{non-simple}
  3246. @item @b{non-simple}
  3247. @i{adj.}
  3248. not @i{simple}.
  3249. @IGindex{non-terminating}
  3250. @item @b{non-terminating}
  3251. @i{adj.} (of a @i{macro character})
  3252. being such that it is treated as a constituent @i{character}
  3253. when it appears in the middle of an extended token.
  3254. See @ref{Reader Algorithm}.
  3255. @IGindex{non-top-level form}
  3256. @item @b{non-top-level form}
  3257. @i{n.}
  3258. a @i{form} that, by virtue of its position as a @i{subform}
  3259. of another @i{form}, is not a @i{top level form}.
  3260. See @ref{Processing of Top Level Forms}.
  3261. @IGindex{normal return}
  3262. @item @b{normal return}
  3263. @i{n.}
  3264. the natural transfer of control and @i{values} which occurs after
  3265. the complete @i{execution} of a @i{form}.
  3266. @IGindex{normalized}
  3267. @item @b{normalized}
  3268. @i{adj.}, @i{ANSI}, @i{IEEE} (of a @i{float})
  3269. conforming to the description of ``normalized'' as described by {IEEE Standard for Binary Floating-Point Arithmetic}.
  3270. See @i{denormalized}.
  3271. @IGindex{null}
  3272. @item @b{null}
  3273. @i{adj.}, @i{n.}
  3274. 1. @i{adj.}
  3275. a. (of a @i{list}) having no @i{elements}: empty. See @i{empty list}.
  3276. b. (of a @i{string}) having a @i{length} of zero.
  3277. (It is common, both within this document and in observed spoken behavior,
  3278. to refer to an empty string by an apparent definite reference,
  3279. as in ``the @i{null} @i{string}'' even though no attempt is made to
  3280. @i{intern}_2 null strings. The phrase
  3281. ``a @i{null} @i{string}'' is technically more correct,
  3282. but is generally considered awkward by most Lisp programmers.
  3283. As such, the phrase ``the @i{null} @i{string}''
  3284. should be treated as an indefinite reference in all cases
  3285. except for anaphoric references.)
  3286. c. (of an @i{implementation-defined} @i{attribute} of a @i{character})
  3287. An @i{object} to which the value of that @i{attribute} defaults
  3288. if no specific value was requested.
  3289. 2. @i{n.} an @i{object} of @i{type} @b{null} (the only such @i{object} being @b{nil}).
  3290. @IGindex{null lexical environment}
  3291. @item @b{null lexical environment}
  3292. @i{n.}
  3293. the @i{lexical environment} which has no @i{bindings}.
  3294. @IGindex{number}
  3295. @item @b{number}
  3296. @i{n.}
  3297. an @i{object} of @i{type} @b{number}.
  3298. @IGindex{numeric}
  3299. @item @b{numeric}
  3300. @i{adj.} (of a @i{character})
  3301. being one of the @i{standard characters} @t{0} through @i{9},
  3302. or being some other @i{graphic} @i{character}
  3303. defined by the @i{implementation} to be @i{numeric}.
  3304. @end table
  3305. @subheading @b{O}
  3306. @table @asis
  3307. @IGindex{object}
  3308. @item @b{object}
  3309. @i{n.}
  3310. 1. any Lisp datum.
  3311. {``The function @b{cons} creates an object which refers
  3312. to two other objects.''}
  3313. 2. (immediately following the name of a @i{type})
  3314. an @i{object} which is of that @i{type}, used to emphasize that the
  3315. @i{object} is not just a @i{name} for an object of that @i{type}
  3316. but really an @i{element} of the @i{type} in cases where @i{objects}
  3317. of that @i{type} (such as @b{function} or @b{class}) are commonly
  3318. referred to by @i{name}.
  3319. {``The function @b{symbol-function} takes a function name
  3320. and returns a function object.''}
  3321. @IGindex{object-traversing}
  3322. @item @b{object-traversing}
  3323. @i{adj.}
  3324. operating in succession on components of an @i{object}.
  3325. {``The operators @b{mapcar}, @b{maphash},
  3326. @b{with-package-iterator} and @b{count}
  3327. perform object-traversing operations.''}
  3328. @IGindex{open}
  3329. @item @b{open}
  3330. @i{adj.}, @i{v.t.} (a @i{file})
  3331. 1. @i{v.t.} to create and return a @i{stream} to the @i{file}.
  3332. 2. @i{adj.} (of a @i{stream})
  3333. having been @i{opened}_1, but not yet @i{closed}.
  3334. @IGindex{operator}
  3335. @item @b{operator}
  3336. @i{n.}
  3337. 1. a @i{function}, @i{macro}, or @i{special operator}.
  3338. 2. a @i{symbol} that names
  3339. such a @i{function}, @i{macro}, or @i{special operator}.
  3340. 3. (in a @b{function} @i{special form})
  3341. the @i{cadr} of the @b{function} @i{special form}, which
  3342. might be either an @i{operator}_2 or a @i{lambda expression}.
  3343. 4. (of a @i{compound form})
  3344. the @i{car} of the @i{compound form}, which might be
  3345. either an @i{operator}_2
  3346. or a @i{lambda expression}, and which is never @t{(setf @i{symbol})}.
  3347. @IGindex{optimize quality}
  3348. @item @b{optimize quality}
  3349. @i{n.}
  3350. one of several aspects of a program that might be optimizable by
  3351. certain compilers. Since optimizing one such quality
  3352. might conflict with optimizing another, relative priorities for
  3353. qualities can be established in an @b{optimize} @i{declaration}.
  3354. The @i{standardized} @i{optimize qualities} are
  3355. @t{compilation-speed} (speed of the compilation process),
  3356. @t{debug} (ease of debugging),
  3357. @t{safety} (run-time error checking),
  3358. @t{space} (both code size and run-time space),
  3359. and
  3360. @t{speed} (of the object code).
  3361. @i{Implementations} may define additional @i{optimize qualities}.
  3362. @IGindex{optional parameter}
  3363. @item @b{optional parameter}
  3364. @i{n.}
  3365. A @i{parameter} for which a corresponding positional @i{argument}
  3366. is optional. If the @i{argument} is not supplied, a default value
  3367. is used. See also @i{supplied-p parameter}.
  3368. @IGindex{ordinary function}
  3369. @item @b{ordinary function}
  3370. @i{n.}
  3371. a @i{function} that is not a @i{generic function}.
  3372. @IGindex{ordinary lambda list}
  3373. @item @b{ordinary lambda list}
  3374. @i{n.}
  3375. the kind of @i{lambda list} used by @b{lambda}.
  3376. See @i{modified lambda list} and @i{extended lambda list}.
  3377. {``@b{defun} uses an ordinary lambda list.''}
  3378. @IGindex{otherwise inaccessible part}
  3379. @item @b{otherwise inaccessible part}
  3380. @i{n.} (of an @i{object}, O_1)
  3381. an @i{object}, O_2, which would be made @i{inaccessible} if
  3382. O_1 were made @i{inaccessible}. (Every @i{object} is an
  3383. @i{otherwise inaccessible part} of itself.)
  3384. @IGindex{output}
  3385. @item @b{output}
  3386. @i{adj.} (of a @i{stream})
  3387. supporting output operations (@i{i.e.}, being a ``data sink'').
  3388. An @i{output} @i{stream} might also be an @i{input} @i{stream},
  3389. in which case it is sometimes called a @i{bidirectional} @i{stream}.
  3390. See the @i{function} @b{output-stream-p}.
  3391. @end table
  3392. @subheading @b{P}
  3393. @table @asis
  3394. @IGindex{package}
  3395. @item @b{package}
  3396. @i{n.}
  3397. an @i{object} of @i{type} @b{package}.
  3398. @IGindex{package cell}
  3399. @item @b{package cell}
  3400. @i{n.} @i{Trad.} (of a @i{symbol})
  3401. The @i{place} in a @i{symbol} that holds one of
  3402. possibly several @i{packages} in which the @i{symbol} is
  3403. @i{interned}, called the @i{home package}, or which holds
  3404. @b{nil} if no such @i{package} exists or is known.
  3405. See the @i{function} @b{symbol-package}.
  3406. @IGindex{package designator}
  3407. @item @b{package designator}
  3408. @i{n.}
  3409. a @i{designator} for a @i{package}; that is,
  3410. an @i{object} that denotes a @i{package}
  3411. and that is one of:
  3412. a @i{string designator}
  3413. (denoting the @i{package} that has the @i{string}
  3414. that it designates as its @i{name}
  3415. or as one of its @i{nicknames}),
  3416. or a @i{package} (denoting itself).
  3417. @IGindex{package marker}
  3418. @item @b{package marker}
  3419. @i{n.}
  3420. a character which is used in the textual notation for a symbol
  3421. to separate the package name from the symbol name, and which
  3422. is @i{colon} in the @i{standard readtable}.
  3423. See @ref{Character Syntax}.
  3424. @IGindex{package prefix}
  3425. @item @b{package prefix}
  3426. @i{n.}
  3427. a notation preceding the @i{name} of a @i{symbol} in text that is
  3428. processed by the @i{Lisp reader}, which uses a @i{package} @i{name}
  3429. followed by one or more @i{package markers}, and which indicates that
  3430. the symbol is looked up in the indicated @i{package}.
  3431. @IGindex{package registry}
  3432. @item @b{package registry}
  3433. @i{n.}
  3434. A mapping of @i{names} to @i{package} @i{objects}.
  3435. It is possible for there to be a @i{package} @i{object} which is not
  3436. in this mapping; such a @i{package} is called an @i{unregistered package}.
  3437. @i{Operators} such as @b{find-package} consult this mapping in order
  3438. to find a @i{package} from its @i{name}.
  3439. @i{Operators} such as @b{do-all-symbols}, @b{find-all-symbols},
  3440. and @b{list-all-packages} operate only on @i{packages} that exist
  3441. in the @i{package registry}.
  3442. @IGindex{pairwise}
  3443. @item @b{pairwise}
  3444. @i{adv.} (of an adjective on a set)
  3445. applying individually to all possible pairings of elements of the set.
  3446. {``The types A, B, and C are pairwise disjoint if
  3447. A and B are disjoint,
  3448. B and C are disjoint, and
  3449. A and C are disjoint.''}
  3450. @IGindex{parallel}
  3451. @item @b{parallel}
  3452. @i{adj.} @i{Trad.} (of @i{binding} or @i{assignment})
  3453. done in the style of @b{psetq}, @b{let}, or @b{do};
  3454. that is, first evaluating all of the @i{forms} that produce @i{values},
  3455. and only then @i{assigning} or @i{binding} the @i{variables} (or @i{places}).
  3456. Note that this does not imply traditional computational ``parallelism''
  3457. since the @i{forms} that produce @i{values} are evaluated @i{sequentially}.
  3458. See @i{sequential}.
  3459. @IGindex{parameter}
  3460. @item @b{parameter}
  3461. @i{n.}
  3462. 1. (of a @i{function})
  3463. a @i{variable} in the definition of a @i{function}
  3464. which takes on the @i{value} of a corresponding @i{argument}
  3465. (or of a @i{list} of corresponding arguments)
  3466. to that @i{function} when it is called,
  3467. or
  3468. which in some cases is given a default value because there
  3469. is no corresponding @i{argument}.
  3470. 2. (of a @i{format directive})
  3471. an @i{object} received as data flow by a @i{format directive}
  3472. due to a prefix notation within the @i{format string} at the
  3473. @i{format directive}'s point of use.
  3474. See @ref{Formatted Output}.
  3475. {``In @t{"~3,'0D"}, the number @t{3} and the character
  3476. @t{#\0} are parameters to the @t{~D} format directive.''}
  3477. @IGindex{parameter specializer}
  3478. @item @b{parameter specializer}
  3479. @i{n.}
  3480. 1. (of a @i{method}) an @i{expression} which constrains the
  3481. @i{method} to be applicable only to @i{argument} sequences
  3482. in which the corresponding @i{argument} matches the
  3483. @i{parameter specializer}.
  3484. 2. a @i{class},
  3485. or a @i{list} @t{(eql @i{object})}.
  3486. @IGindex{parameter specializer name}
  3487. @item @b{parameter specializer name}
  3488. @i{n.}
  3489. 1. (of a @i{method} definition) an expression used in code to
  3490. name a @i{parameter specializer}.
  3491. See @ref{Introduction to Methods}.
  3492. 2. a @i{class},
  3493. a @i{symbol} naming a @i{class},
  3494. or a @i{list} @t{(eql @i{form})}.
  3495. @IGindex{pathname}
  3496. @item @b{pathname}
  3497. @i{n.}
  3498. an @i{object} of @i{type} @b{pathname}, which is a structured representation
  3499. of the name of a @i{file}. A @i{pathname} has six components:
  3500. a ``host,''
  3501. a ``device,''
  3502. a ``directory,''
  3503. a ``name,''
  3504. a ``type,'' and
  3505. a ``version.''
  3506. @IGindex{pathname designator}
  3507. @item @b{pathname designator}
  3508. @i{n.}
  3509. a @i{designator} for a @i{pathname}; that is,
  3510. an @i{object} that denotes a @i{pathname}
  3511. and that is one of:
  3512. a @i{pathname} @i{namestring}
  3513. (denoting the corresponding @i{pathname}),
  3514. a @i{stream associated with a file}
  3515. (denoting the @i{pathname} used to open the @i{file};
  3516. this may be, but is not required to be, the actual name of the @i{file}),
  3517. or a @i{pathname} (denoting itself).
  3518. See @ref{File Operations on Open and Closed Streams}.
  3519. @IGindex{physical pathname}
  3520. @item @b{physical pathname}
  3521. @i{n.}
  3522. a @i{pathname} that is not a @i{logical pathname}.
  3523. [Editorial Note by KMP: Still need to reconcile some confusion in the uses of ``generalized
  3524. reference'' and ``place.'' I think one was supposed to refer to the
  3525. abstract concept, and the other to an object (a form), but the usages
  3526. have become blurred.]
  3527. @IGindex{place}
  3528. @item @b{place}
  3529. @i{n.}
  3530. 1. a @i{form} which is suitable for use as a @i{generalized reference}.
  3531. 2. the conceptual location referred to by such a @i{place}_1.
  3532. @IGindex{plist}
  3533. @item @b{plist}
  3534. pronounced 'p\=e ,list @i{n.}
  3535. a @i{property list}.
  3536. @IGindex{portable}
  3537. @item @b{portable}
  3538. @i{adj.} (of @i{code})
  3539. required to produce equivalent results and observable side effects
  3540. in all @i{conforming implementations}.
  3541. @IGindex{potential copy}
  3542. @item @b{potential copy}
  3543. @i{n.} (of an @i{object} O_1 subject to constriants)
  3544. an @i{object} O_2 that if the specified constraints are satisfied
  3545. by O_1 without any modification might or might not be @i{identical}
  3546. to O_1, or else that must be a @i{fresh} @i{object} that
  3547. resembles a @i{copy} of O_1 except that it has been modified as
  3548. necessary to satisfy the constraints.
  3549. @IGindex{potential number}
  3550. @item @b{potential number}
  3551. @i{n.}
  3552. A textual notation that might be parsed by the @i{Lisp reader}
  3553. in some @i{conforming implementation} as a @i{number}
  3554. but is not required to be parsed as a @i{number}.
  3555. No @i{object} is a @i{potential number}---either an @i{object} is
  3556. a @i{number} or it is not.
  3557. See @ref{Potential Numbers as Tokens}.
  3558. @IGindex{pprint dispatch table}
  3559. @item @b{pprint dispatch table}
  3560. @i{n.}
  3561. an @i{object} that can be the @i{value} of @b{*print-pprint-dispatch*}
  3562. and hence can control how @i{objects} are printed when
  3563. @b{*print-pretty*} is @i{true}.
  3564. See @ref{Pretty Print Dispatch Tables}.
  3565. @IGindex{predicate}
  3566. @item @b{predicate}
  3567. @i{n.}
  3568. a @i{function} that returns a @i{generalized boolean}
  3569. as its first value.
  3570. @IGindex{present}
  3571. @item @b{present}
  3572. @i{n.}
  3573. 1. (of a @i{feature} in a @i{Lisp image})
  3574. a state of being that is in effect if and only if the @i{symbol}
  3575. naming the @i{feature} is an @i{element} of the @i{features list}.
  3576. 2. (of a @i{symbol} in a @i{package})
  3577. being accessible in that @i{package} directly,
  3578. rather than being inherited from another @i{package}.
  3579. @IGindex{pretty print}
  3580. @item @b{pretty print}
  3581. @i{v.t.} (an @i{object})
  3582. to invoke the @i{pretty printer} on the @i{object}.
  3583. @IGindex{pretty printer}
  3584. @item @b{pretty printer}
  3585. @i{n.}
  3586. the procedure that prints the character representation of an
  3587. @i{object} onto a @i{stream} when the @i{value} of
  3588. @b{*print-pretty*} is @i{true},
  3589. and that uses layout techniques (@i{e.g.}, indentation) that
  3590. tend to highlight the structure of the @i{object} in a way that
  3591. makes it easier for human readers to parse visually.
  3592. See the @i{variable} @b{*print-pprint-dispatch*} and @ref{The Lisp Pretty Printer}.
  3593. @IGindex{pretty printing stream}
  3594. @item @b{pretty printing stream}
  3595. @i{n.}
  3596. a @i{stream} that does pretty printing. Such streams are created by
  3597. the @i{function} @b{pprint-logical-block} as a link between the output stream
  3598. and the logical block.
  3599. @IGindex{primary method}
  3600. @item @b{primary method}
  3601. @i{n.}
  3602. a member of one of two sets of @i{methods}
  3603. (the set of @i{auxiliary methods} is the other)
  3604. that form an exhaustive partition of the set of @i{methods}
  3605. on the @i{method}'s @i{generic function}.
  3606. How these sets are determined is dependent on the @i{method combination} type;
  3607. see @ref{Introduction to Methods}.
  3608. @IGindex{primary value}
  3609. @item @b{primary value}
  3610. @i{n.} (of @i{values} resulting from the
  3611. @i{evaluation} of a @i{form})
  3612. the first @i{value}, if any, or else @b{nil} if there are no @i{values}.
  3613. {``The primary value returned by @b{truncate} is an
  3614. integer quotient, truncated toward zero.''}
  3615. @IGindex{principal}
  3616. @item @b{principal}
  3617. @i{adj.} (of a value returned by a @r{Common Lisp} @i{function} that
  3618. implements a mathematically irrational or transcendental
  3619. function defined in the complex domain)
  3620. of possibly many (sometimes an infinite number of) correct values for the
  3621. mathematical function, being the particular @i{value} which the corresponding
  3622. @r{Common Lisp} @i{function} has been defined to return.
  3623. @IGindex{print name}
  3624. @item @b{print name}
  3625. @i{n.} @i{Trad.} (usually of a @i{symbol})
  3626. a @i{name}_3.
  3627. @IGindex{printer control variable}
  3628. @item @b{printer control variable}
  3629. @i{n.}
  3630. a @i{variable} whose specific purpose is to control some action
  3631. of the @i{Lisp printer}; that is, one of the @i{variables}
  3632. in @i{Figure~22--1},
  3633. or else some @i{implementation-defined} @i{variable} which is
  3634. defined by the @i{implementation} to be a @i{printer control variable}.
  3635. @IGindex{printer escaping}
  3636. @item @b{printer escaping}
  3637. @i{n.}
  3638. The combined state of the @i{printer control variables}
  3639. @b{*print-escape*} and @b{*print-readably*}.
  3640. If the value of either @b{*print-readably*} or @b{*print-escape*} is @i{true},
  3641. then @i{printer escaping}
  3642. @IGindex{printer escaping}
  3643. is ``enabled'';
  3644. otherwise (if the values of both @b{*print-readably*} and @b{*print-escape*}
  3645. are @i{false}),
  3646. then @i{printer escaping} is ``disabled''.
  3647. @IGindex{printing}
  3648. @item @b{printing}
  3649. @i{adj.} (of a @i{character})
  3650. being a @i{graphic} @i{character} other than @i{space}.
  3651. @IGindex{process}
  3652. @item @b{process}
  3653. @i{v.t.} (a @i{form} by the @i{compiler})
  3654. to perform @i{minimal compilation}, determining the time of
  3655. evaluation for a @i{form}, and possibly @i{evaluating} that
  3656. @i{form} (if required).
  3657. @IGindex{processor}
  3658. @item @b{processor}
  3659. @i{n.}, @i{ANSI}
  3660. an @i{implementation}.
  3661. @IGindex{proclaim}
  3662. @item @b{proclaim}
  3663. @i{v.t.} (a @i{proclamation})
  3664. to @i{establish} that @i{proclamation}.
  3665. @IGindex{proclamation}
  3666. @item @b{proclamation}
  3667. @i{n.}
  3668. a @i{global declaration}.
  3669. @IGindex{prog tag}
  3670. @item @b{prog tag}
  3671. @i{n.} @i{Trad.}
  3672. a @i{go tag}.
  3673. @IGindex{program}
  3674. @item @b{program}
  3675. @i{n.} @i{Trad.}
  3676. @r{Common Lisp} @i{code}.
  3677. @IGindex{programmer}
  3678. @item @b{programmer}
  3679. @i{n.}
  3680. an active entity, typically a human, that writes a @i{program},
  3681. and that might or might not also be a @i{user} of the @i{program}.
  3682. @IGindex{programmer code}
  3683. @item @b{programmer code}
  3684. @i{n.}
  3685. @i{code} that is supplied by the programmer;
  3686. that is, @i{code} that is not @i{system code}.
  3687. @IGindex{proper list}
  3688. @item @b{proper list}
  3689. @i{n.}
  3690. A @i{list} terminated by the @i{empty list}.
  3691. (The @i{empty list} is a @i{proper list}.)
  3692. See @i{improper list}.
  3693. @IGindex{proper name}
  3694. @item @b{proper name}
  3695. @i{n.} (of a @i{class})
  3696. a @i{symbol} that @i{names} the @i{class} whose @i{name}
  3697. is that @i{symbol}.
  3698. See the @i{functions} @b{class-name} and @b{find-class}.
  3699. @IGindex{proper sequence}
  3700. @item @b{proper sequence}
  3701. @i{n.}
  3702. a @i{sequence} which is not an @i{improper list};
  3703. that is, a @i{vector} or a @i{proper list}.
  3704. @IGindex{proper subtype}
  3705. @item @b{proper subtype}
  3706. @i{n.} (of a @i{type})
  3707. a @i{subtype} of the @i{type} which is not the @i{same} @i{type}
  3708. as the @i{type} (@i{i.e.}, its @i{elements} are a ``proper subset'' of the
  3709. @i{type}).
  3710. @IGindex{property}
  3711. @item @b{property}
  3712. @i{n.} (of a @i{property list})
  3713. 1. a conceptual pairing of a @i{property indicator} and its
  3714. associated @i{property value} on a @i{property list}.
  3715. 2. a @i{property value}.
  3716. @IGindex{property indicator}
  3717. @item @b{property indicator}
  3718. @i{n.} (of a @i{property list})
  3719. the @i{name} part of a @i{property}, used as a @i{key}
  3720. when looking up a @i{property value} on a @i{property list}.
  3721. @IGindex{property list}
  3722. @item @b{property list}
  3723. @i{n.}
  3724. 1. a @i{list} containing an even number of @i{elements} that are
  3725. alternating @i{names} (sometimes called @i{indicators}
  3726. or @i{keys}) and @i{values} (sometimes called @i{properties}).
  3727. When there is more than one @i{name} and @i{value} pair with
  3728. the @i{identical} @i{name} in a @i{property list},
  3729. the first such pair determines the @i{property}.
  3730. 2. (of a @i{symbol})
  3731. the component of the @i{symbol} containing a @i{property list}.
  3732. @IGindex{property value}
  3733. @item @b{property value}
  3734. @i{n.} (of a @i{property indicator} on
  3735. a @i{property list})
  3736. the @i{object} associated with the @i{property indicator}
  3737. on the @i{property list}.
  3738. @IGindex{purports to conform}
  3739. @item @b{purports to conform}
  3740. @i{v.}
  3741. makes a good-faith claim of conformance.
  3742. This term expresses intention to conform, regardless of whether the
  3743. goal of that intention is realized in practice.
  3744. For example, language implementations have been known to have bugs,
  3745. and while an @i{implementation} of this specification with bugs
  3746. might not be a @i{conforming implementation}, it can still
  3747. @i{purport to conform}. This is an important distinction in
  3748. certain specific cases; @i{e.g.}, see the @i{variable} @b{*features*}.
  3749. @end table
  3750. @subheading @b{Q}
  3751. @table @asis
  3752. @IGindex{qualified method}
  3753. @item @b{qualified method}
  3754. @i{n.}
  3755. a @i{method} that has one or more @i{qualifiers}.
  3756. @IGindex{qualifier}
  3757. @item @b{qualifier}
  3758. @i{n.} (of a @i{method} for a @i{generic function})
  3759. one of possibly several @i{objects} used to annotate the @i{method}
  3760. in a way that identifies its role in the @i{method combination}.
  3761. The @i{method combination} @i{type} determines
  3762. how many @i{qualifiers} are permitted for each @i{method},
  3763. which @i{qualifiers} are permitted,
  3764. and
  3765. the semantics of those @i{qualifiers}.
  3766. @IGindex{query I/O}
  3767. @item @b{query I/O}
  3768. @i{n.}
  3769. the @i{bidirectional} @i{stream}
  3770. that is the @i{value} of the @i{variable} @b{*query-io*}.
  3771. @IGindex{quoted object}
  3772. @item @b{quoted object}
  3773. @i{n.}
  3774. an @i{object} which is the second element of a
  3775. @b{quote} @i{form}.
  3776. @end table
  3777. @subheading @b{R}
  3778. @table @asis
  3779. @IGindex{radix}
  3780. @item @b{radix}
  3781. @i{n.}
  3782. an @i{integer} between 2 and 36, inclusive, which can be used
  3783. to designate a base with respect to which certain kinds of numeric
  3784. input or output are performed.
  3785. (There are n valid digit characters for any given @i{radix} n,
  3786. and those digits are the first n digits in the sequence
  3787. @t{0}, @t{1}, ..., @t{9}, @t{A}, @t{B}, ..., @t{Z},
  3788. which have the weights
  3789. @t{0}, @t{1}, ..., @t{9}, @t{10}, @t{11}, ..., @t{35},
  3790. respectively.
  3791. Case is not significant in parsing numbers of radix greater
  3792. than @t{10}, so ``9b8a'' and ``9B8A'' denote the same @i{radix}
  3793. @t{16} number.)
  3794. @IGindex{random state}
  3795. @item @b{random state}
  3796. @i{n.}
  3797. an @i{object} of @i{type} @b{random-state}.
  3798. @IGindex{rank}
  3799. @item @b{rank}
  3800. @i{n.}
  3801. a non-negative @i{integer} indicating the number of
  3802. @i{dimensions} of an @i{array}.
  3803. @IGindex{ratio}
  3804. @item @b{ratio}
  3805. @i{n.}
  3806. an @i{object} of @i{type} @b{ratio}.
  3807. @IGindex{ratio marker}
  3808. @item @b{ratio marker}
  3809. @i{n.}
  3810. a character which is used in the textual notation for a @i{ratio}
  3811. to separate the numerator from the denominator, and which
  3812. is @i{slash} in the @i{standard readtable}.
  3813. See @ref{Character Syntax}.
  3814. @IGindex{rational}
  3815. @item @b{rational}
  3816. @i{n.}
  3817. an @i{object} of @i{type} @b{rational}.
  3818. @IGindex{read}
  3819. @item @b{read}
  3820. @i{v.t.}
  3821. 1. (a @i{binding} or @i{slot} or component)
  3822. to obtain the @i{value} of the @i{binding} or @i{slot}.
  3823. 2. (an @i{object} from a @i{stream})
  3824. to parse an @i{object} from its representation on the @i{stream}.
  3825. @IGindex{readably}
  3826. @item @b{readably}
  3827. @i{adv.} (of a manner of printing an @i{object} O_1)
  3828. in such a way as to permit the @i{Lisp Reader} to later @i{parse}
  3829. the printed output into an @i{object} O_2 that is @i{similar} to O_1.
  3830. @IGindex{reader}
  3831. @item @b{reader}
  3832. @i{n.}
  3833. 1. a @i{function} that @i{reads}_1 a @i{variable} or @i{slot}.
  3834. 2. the @i{Lisp reader}.
  3835. @IGindex{reader macro}
  3836. @item @b{reader macro}
  3837. @i{n.}
  3838. 1. a textual notation introduced by dispatch on one or two @i{characters}
  3839. that defines special-purpose syntax for use by the @i{Lisp reader},
  3840. and that is implemented by a @i{reader macro function}.
  3841. See @ref{Reader Algorithm}.
  3842. 2. the @i{character} or @i{characters} that introduce
  3843. a @i{reader macro}_1; that is,
  3844. a @i{macro character}
  3845. or the conceptual pairing of a @i{dispatching macro character} and the
  3846. @i{character} that follows it.
  3847. (A @i{reader macro} is not a kind of @i{macro}.)
  3848. @IGindex{reader macro function}
  3849. @item @b{reader macro function}
  3850. @i{n.}
  3851. a @i{function} @i{designator} that denotes a @i{function}
  3852. that implements a @i{reader macro}_2.
  3853. See the @i{functions} @b{set-macro-character} and @b{set-dispatch-macro-character}.
  3854. @IGindex{readtable}
  3855. @item @b{readtable}
  3856. @i{n.}
  3857. an @i{object} of @i{type} @b{readtable}.
  3858. @IGindex{readtable case}
  3859. @item @b{readtable case}
  3860. @i{n.}
  3861. an attribute of a @i{readtable}
  3862. whose value is a @i{case sensitivity mode},
  3863. and that selects the manner in which @i{characters}
  3864. in a @i{symbol}'s @i{name} are to be treated by
  3865. the @i{Lisp reader}
  3866. and the @i{Lisp printer}.
  3867. See @ref{Effect of Readtable Case on the Lisp Reader} and @ref{Effect of Readtable Case on the Lisp Printer}.
  3868. @IGindex{readtable designator}
  3869. @item @b{readtable designator}
  3870. @i{n.}
  3871. a @i{designator} for a @i{readtable}; that is,
  3872. an @i{object} that denotes a @i{readtable}
  3873. and that is one of:
  3874. @b{nil} (denoting the @i{standard readtable}),
  3875. or a @i{readtable} (denoting itself).
  3876. @IGindex{recognizable subtype}
  3877. @item @b{recognizable subtype}
  3878. @i{n.} (of a @i{type})
  3879. a @i{subtype} of the @i{type} which can be reliably detected
  3880. to be such by the @i{implementation}.
  3881. See the @i{function} @b{subtypep}.
  3882. @IGindex{reference}
  3883. @item @b{reference}
  3884. @i{n.}, @i{v.t.}
  3885. 1. @i{n.} an act or occurrence of referring to an @i{object},
  3886. a @i{binding}, an @i{exit point}, a @i{tag},
  3887. or an @i{environment}.
  3888. 2. @i{v.t.} to refer to an @i{object}, a @i{binding}, an
  3889. @i{exit point}, a @i{tag}, or an @i{environment},
  3890. usually by @i{name}.
  3891. @IGindex{registered package}
  3892. @item @b{registered package}
  3893. @i{n.}
  3894. a @i{package} @i{object} that is installed in the @i{package registry}.
  3895. (Every @i{registered package} has a @i{name} that is a @i{string},
  3896. as well as zero or more @i{string} nicknames.
  3897. All @i{packages} that are initially specified by @r{Common Lisp}
  3898. or created by @b{make-package} or @b{defpackage}
  3899. are @i{registered packages}. @i{Registered packages} can be turned into
  3900. @i{unregistered packages} by @b{delete-package}.)
  3901. @IGindex{relative}
  3902. @item @b{relative}
  3903. @i{adj.}
  3904. 1. (of a @i{time})
  3905. representing an offset from an @i{absolute} @i{time}
  3906. in the units appropriate to that time.
  3907. For example,
  3908. a @i{relative} @i{internal time} is the difference between
  3909. two @i{absolute} @i{internal times}, and is measured in
  3910. @i{internal time units}.
  3911. 2. (of a @i{pathname})
  3912. representing a position in a directory hierarchy by motion
  3913. from a position other than the root, which might therefore vary.
  3914. {``The notation @t{#P"../foo.text"} denotes a relative
  3915. pathname if the host file system is Unix.''}
  3916. See @i{absolute}.
  3917. @IGindex{repertoire}
  3918. @item @b{repertoire}
  3919. @i{n.}, @i{ISO}
  3920. a @i{subtype} of @b{character}. See @ref{Character Repertoires}.
  3921. @IGindex{report}
  3922. @item @b{report}
  3923. @i{n.} (of a @i{condition})
  3924. to @i{call} the @i{function} @b{print-object} on the @i{condition}
  3925. in an @i{environment} where the @i{value} of @b{*print-escape*} is @i{false}.
  3926. @IGindex{report message}
  3927. @item @b{report message}
  3928. @i{n.}
  3929. the text that is output by a @i{condition reporter}.
  3930. @IGindex{required parameter}
  3931. @item @b{required parameter}
  3932. @i{n.}
  3933. A @i{parameter} for which a corresponding positional @i{argument}
  3934. must be supplied when @i{calling} the @i{function}.
  3935. @IGindex{rest list}
  3936. @item @b{rest list}
  3937. @i{n.} (of a @i{function} having a @i{rest parameter})
  3938. The @i{list} to which the @i{rest parameter} is @i{bound} on some
  3939. particular @i{call} to the @i{function}.
  3940. @IGindex{rest parameter}
  3941. @item @b{rest parameter}
  3942. @i{n.}
  3943. A @i{parameter} which was introduced by @b{&rest}.
  3944. @IGindex{restart}
  3945. @item @b{restart}
  3946. @i{n.}
  3947. an @i{object} of @i{type} @b{restart}.
  3948. @IGindex{restart designator}
  3949. @item @b{restart designator}
  3950. @i{n.}
  3951. a @i{designator} for a @i{restart}; that is,
  3952. an @i{object} that denotes a @i{restart}
  3953. and that is one of:
  3954. a @i{non-nil} @i{symbol}
  3955. (denoting the most recently established @i{active}
  3956. @i{restart} whose @i{name} is that @i{symbol}),
  3957. or a @i{restart} (denoting itself).
  3958. @IGindex{restart function}
  3959. @item @b{restart function}
  3960. @i{n.}
  3961. a @i{function} that invokes a @i{restart}, as if by @b{invoke-restart}.
  3962. The primary purpose of a @i{restart function} is to provide an alternate
  3963. interface. By convention, a @i{restart function} usually has the same name
  3964. as the @i{restart} which it invokes. Figure 26--4 shows a list of the
  3965. @i{standardized} @i{restart functions}.
  3966. @group
  3967. @noindent
  3968. @w{ abort muffle-warning use-value }
  3969. @w{ continue store-value }
  3970. @noindent
  3971. @w{ Figure 26--4: Standardized Restart Functions}
  3972. @end group
  3973. @IGindex{return}
  3974. @item @b{return}
  3975. @i{v.t.} (of @i{values})
  3976. 1. (from a @i{block}) to transfer control and @i{values} from the @i{block};
  3977. that is, to cause the @i{block} to @i{yield} the @i{values} immediately
  3978. without doing any further evaluation of the @i{forms} in its body.
  3979. 2. (from a @i{form}) to @i{yield} the @i{values}.
  3980. @IGindex{return value}
  3981. @item @b{return value}
  3982. @i{n.} @i{Trad.}
  3983. a @i{value}_1
  3984. @IGindex{right-parenthesis}
  3985. @item @b{right-parenthesis}
  3986. @i{n.}
  3987. the @i{standard character} ``@t{)}'',
  3988. that is variously called
  3989. ``right parenthesis''
  3990. or ``close parenthesis''
  3991. See @i{Figure~2--5}.
  3992. @IGindex{run time}
  3993. @item @b{run time}
  3994. @i{n.}
  3995. 1. @i{load time}
  3996. 2. @i{execution time}
  3997. @IGindex{run-time compiler}
  3998. @item @b{run-time compiler}
  3999. @i{n.}
  4000. refers to the @b{compile} function or to @i{implicit compilation},
  4001. for which the compilation and run-time @i{environments} are maintained
  4002. in the same @i{Lisp image}.
  4003. @IGindex{run-time definition}
  4004. @item @b{run-time definition}
  4005. @i{n.}
  4006. a definition in the @i{run-time environment}.
  4007. @IGindex{run-time environment}
  4008. @item @b{run-time environment}
  4009. @i{n.}
  4010. the @i{environment} in which a program is @i{executed}.
  4011. @end table
  4012. @subheading @b{S}
  4013. @table @asis
  4014. @IGindex{safe}
  4015. @item @b{safe}
  4016. @i{adj.}
  4017. 1. (of @i{code})
  4018. processed in a @i{lexical environment} where the the highest
  4019. @b{safety} level (@t{3}) was in effect.
  4020. See @b{optimize}.
  4021. 2. (of a @i{call}) a @i{safe call}.
  4022. @IGindex{safe call}
  4023. @item @b{safe call}
  4024. @i{n.}
  4025. a @i{call} in which
  4026. the @i{call},
  4027. the @i{function} being @i{called},
  4028. and the point of @i{functional evaluation}
  4029. are all @i{safe}_1 @i{code}.
  4030. For more detailed information, see @ref{Safe and Unsafe Calls}.
  4031. @IGindex{same}
  4032. @item @b{same}
  4033. @i{adj.}
  4034. 1. (of @i{objects} under a specified @i{predicate})
  4035. indistinguishable by that @i{predicate}.
  4036. {``The symbol @t{car}, the string @t{"car"}, and the string @t{"CAR"}
  4037. are the @t{same} under @b{string-equal}''}.
  4038. 2. (of @i{objects} if no predicate is implied by context)
  4039. indistinguishable by @b{eql}.
  4040. Note that @b{eq} might be capable of distinguishing some
  4041. @i{numbers} and @i{characters} which @b{eql} cannot
  4042. distinguish, but the nature of such, if any,
  4043. is @i{implementation-dependent}.
  4044. Since @b{eq} is used only rarely in this specification,
  4045. @b{eql} is the default predicate when none is mentioned explicitly.
  4046. {``The conses returned by two successive calls to @b{cons}
  4047. are never the same.''}
  4048. 3. (of @i{types}) having the same set of @i{elements};
  4049. that is, each @i{type} is a @i{subtype} of the others.
  4050. {``The types specified by @t{(integer 0 1)},
  4051. @t{(unsigned-byte 1)},
  4052. and @t{bit} are the same.''}
  4053. @IGindex{satisfy the test}
  4054. @item @b{satisfy the test}
  4055. @i{v.}
  4056. (of an @i{object} being considered by a @i{sequence function})
  4057. 1. (for a one @i{argument} test)
  4058. to be in a state such that the @i{function} which is the
  4059. @i{predicate} @i{argument} to the @i{sequence function}
  4060. returns @i{true} when given a single @i{argument} that is the
  4061. result of calling the @i{sequence function}'s @i{key} @i{argument}
  4062. on the @i{object} being considered.
  4063. See @ref{Satisfying a One-Argument Test}.
  4064. 2. (for a two @i{argument} test)
  4065. to be in a state such that the two-place @i{predicate}
  4066. which is the @i{sequence function}'s
  4067. @i{test} @i{argument}
  4068. returns @i{true} when given a first @i{argument} that
  4069. is
  4070. the @i{object} being considered,
  4071. and when given a second @i{argument}
  4072. that is the result of calling the @i{sequence function}'s
  4073. @i{key} @i{argument} on an @i{element} of the
  4074. @i{sequence function}'s @i{sequence} @i{argument}
  4075. which is being tested for equality;
  4076. or to be in a state such that the @i{test-not} @i{function}
  4077. returns @i{false} given the same @i{arguments}.
  4078. See @ref{Satisfying a Two-Argument Test}.
  4079. @IGindex{scope}
  4080. @item @b{scope}
  4081. @i{n.}
  4082. the structural or textual region of code in which @i{references}
  4083. to an @i{object}, a @i{binding}, an @i{exit point},
  4084. a @i{tag}, or an @i{environment} (usually by @i{name})
  4085. can occur.
  4086. @IGindex{script}
  4087. @item @b{script}
  4088. @i{n.} @i{ISO}
  4089. one of possibly several sets that form an @i{exhaustive partition}
  4090. of the type @b{character}. See @ref{Character Scripts}.
  4091. @IGindex{secondary value}
  4092. @item @b{secondary value}
  4093. @i{n.} (of @i{values} resulting from the
  4094. @i{evaluation} of a @i{form})
  4095. the second @i{value}, if any,
  4096. or else @b{nil} if there are fewer than two @i{values}.
  4097. {``The secondary value returned by @b{truncate} is a remainder.''}
  4098. @IGindex{section}
  4099. @item @b{section}
  4100. @i{n.}
  4101. a partitioning of output by a @i{conditional newline} on a @i{pretty printing stream}.
  4102. See @ref{Dynamic Control of the Arrangement of Output}.
  4103. @IGindex{self-evaluating object}
  4104. @item @b{self-evaluating object}
  4105. @i{n.}
  4106. an @i{object} that is neither a @i{symbol} nor a
  4107. @i{cons}.
  4108. If a @i{self-evaluating object} is @i{evaluated},
  4109. it @i{yields} itself as its only @i{value}.
  4110. {``Strings are self-evaluating objects.''}
  4111. @IGindex{semi-standard}
  4112. @item @b{semi-standard}
  4113. @i{adj.} (of a language feature)
  4114. not required to be implemented by any @i{conforming implementation},
  4115. but nevertheless recommended as the canonical approach in situations where
  4116. an @i{implementation} does plan to support such a feature.
  4117. The presence of @i{semi-standard} aspects in the language is intended
  4118. to lessen portability problems and reduce the risk of gratuitous divergence
  4119. among @i{implementations} that might stand in the way of future
  4120. standardization.
  4121. @IGindex{semicolon}
  4122. @item @b{semicolon}
  4123. @i{n.}
  4124. the @i{standard character} that is called ``semicolon'' (@t{;}).
  4125. See @i{Figure~2--5}.
  4126. @IGindex{sequence}
  4127. @item @b{sequence}
  4128. @i{n.}
  4129. 1. an ordered collection of elements
  4130. 2. a @i{vector} or a @i{list}.
  4131. @IGindex{sequence function}
  4132. @item @b{sequence function}
  4133. @i{n.}
  4134. one of the @i{functions} in @i{Figure~17--1},
  4135. or an @i{implementation-defined} @i{function}
  4136. that operates on one or more @i{sequences}.
  4137. and that is defined by the @i{implementation} to be a @i{sequence function}.
  4138. @IGindex{sequential}
  4139. @item @b{sequential}
  4140. @i{adj.} @i{Trad.} (of @i{binding} or @i{assignment})
  4141. done in the style of @b{setq}, @b{let*}, or @b{do*};
  4142. that is, interleaving the evaluation of the @i{forms} that produce @i{values}
  4143. with the @i{assignments} or @i{bindings} of the @i{variables} (or @i{places}).
  4144. See @i{parallel}.
  4145. @IGindex{sequentially}
  4146. @item @b{sequentially}
  4147. @i{adv.}
  4148. in a @i{sequential} way.
  4149. @IGindex{serious condition}
  4150. @item @b{serious condition}
  4151. @i{n.}
  4152. a @i{condition} of @i{type} @b{serious-condition},
  4153. which represents a @i{situation} that is generally sufficiently
  4154. severe that entry into the @i{debugger} should be expected if
  4155. the @i{condition} is @i{signaled} but not @i{handled}.
  4156. @IGindex{session}
  4157. @item @b{session}
  4158. @i{n.}
  4159. the conceptual aggregation of events in a @i{Lisp image} from the time
  4160. it is started to the time it is terminated.
  4161. @IGindex{set}
  4162. @item @b{set}
  4163. @i{v.t.} @i{Trad.} (any @i{variable}
  4164. or a @i{symbol} that
  4165. is the @i{name} of a @i{dynamic variable})
  4166. to @i{assign} the @i{variable}.
  4167. @IGindex{setf expander}
  4168. @item @b{setf expander}
  4169. @i{n.}
  4170. a function used by @b{setf} to compute the @i{setf expansion}
  4171. of a @i{place}.
  4172. @IGindex{setf expansion}
  4173. @item @b{setf expansion}
  4174. @i{n.}
  4175. a set of five @i{expressions}_1 that, taken together, describe
  4176. how to store into a @i{place}
  4177. and which @i{subforms} of the macro call associated with the
  4178. @i{place} are evaluated.
  4179. See @ref{Setf Expansions}.
  4180. @IGindex{setf function}
  4181. @item @b{setf function}
  4182. @i{n.}
  4183. a @i{function} whose @i{name} is @t{(setf @i{symbol})}.
  4184. @IGindex{setf function name}
  4185. @item @b{setf function name}
  4186. @i{n.} (of a @i{symbol} @i{S})
  4187. the @i{list} @t{(setf @i{S})}.
  4188. @IGindex{shadow}
  4189. @item @b{shadow}
  4190. @i{v.t.}
  4191. 1. to override the meaning of.
  4192. {``That binding of @t{X} shadows an outer one.''}
  4193. 2. to hide the presence of.
  4194. {``That @b{macrolet} of @t{F} shadows the
  4195. outer @b{flet} of @t{F}.''}
  4196. 3. to replace.
  4197. {``That package shadows the symbol @t{cl:car} with
  4198. its own symbol @t{car}.''}
  4199. @IGindex{shadowing symbol}
  4200. @item @b{shadowing symbol}
  4201. @i{n.} (in a @i{package})
  4202. an @i{element} of the @i{package}'s @i{shadowing symbols list}.
  4203. @IGindex{shadowing symbols list}
  4204. @item @b{shadowing symbols list}
  4205. @i{n.} (of a @i{package})
  4206. a @i{list}, associated with the @i{package},
  4207. of @i{symbols} that are to be exempted from `symbol conflict errors'
  4208. detected when packages are @i{used}.
  4209. See the @i{function} @b{package-shadowing-symbols}.
  4210. @IGindex{shared slot}
  4211. @item @b{shared slot}
  4212. @i{n.} (of a @i{class})
  4213. a @i{slot} @i{accessible} in more than one @i{instance}
  4214. of a @i{class}; specifically, such a @i{slot} is @i{accessible}
  4215. in all @i{direct instances} of the @i{class} and in those
  4216. @i{indirect instances} whose @i{class} does not
  4217. @i{shadow}_1 the @i{slot}.
  4218. @IGindex{sharpsign}
  4219. @item @b{sharpsign}
  4220. @i{n.}
  4221. the @i{standard character} that is variously called ``number sign,'' ``sharp,''
  4222. or ``sharp sign'' (@t{#}).
  4223. See @i{Figure~2--5}.
  4224. @IGindex{short float}
  4225. @item @b{short float}
  4226. @i{n.}
  4227. an @i{object} of @i{type} @b{short-float}.
  4228. @IGindex{sign}
  4229. @item @b{sign}
  4230. @i{n.}
  4231. one of the @i{standard characters} ``@t{+}'' or ``@t{-}''.
  4232. @IGindex{signal}
  4233. @item @b{signal}
  4234. @i{v.}
  4235. to announce, using a standard protocol, that a particular situation,
  4236. represented by a @i{condition}, has been detected.
  4237. See @ref{Condition System Concepts}.
  4238. @IGindex{signature}
  4239. @item @b{signature}
  4240. @i{n.} (of a @i{method})
  4241. a description of the @i{parameters} and
  4242. @i{parameter specializers} for the @i{method} which
  4243. determines the @i{method}'s applicability for a given set of
  4244. required @i{arguments}, and which also describes the
  4245. @i{argument} conventions for its other, non-required
  4246. @i{arguments}.
  4247. @IGindex{similar}
  4248. @item @b{similar}
  4249. @i{adj.} (of two @i{objects})
  4250. defined to be equivalent under the @i{similarity} relationship.
  4251. @IGindex{similarity}
  4252. @item @b{similarity}
  4253. @i{n.}
  4254. a two-place conceptual equivalence predicate,
  4255. which is independent of the @i{Lisp image}
  4256. so that two @i{objects} in different @i{Lisp images}
  4257. can be understood to be equivalent under this predicate.
  4258. See @ref{Literal Objects in Compiled Files}.
  4259. @IGindex{simple}
  4260. @item @b{simple}
  4261. @i{adj.}
  4262. 1. (of an @i{array}) being of @i{type} @b{simple-array}.
  4263. 2. (of a @i{character})
  4264. having no @i{implementation-defined} @i{attributes},
  4265. or else having @i{implementation-defined} @i{attributes}
  4266. each of which has the @i{null} value for that @i{attribute}.
  4267. @IGindex{simple array}
  4268. @item @b{simple array}
  4269. @i{n.}
  4270. an @i{array} of @i{type} @b{simple-array}.
  4271. @IGindex{simple bit array}
  4272. @item @b{simple bit array}
  4273. @i{n.}
  4274. a @i{bit array} that is a @i{simple array};
  4275. that is, an @i{object} of @i{type} @t{(simple-array bit)}.
  4276. @IGindex{simple bit vector}
  4277. @item @b{simple bit vector}
  4278. @i{n.}
  4279. a @i{bit vector} of @i{type} @b{simple-bit-vector}.
  4280. @IGindex{simple condition}
  4281. @item @b{simple condition}
  4282. @i{n.}
  4283. a @i{condition} of @i{type} @b{simple-condition}.
  4284. @IGindex{simple general vector}
  4285. @item @b{simple general vector}
  4286. @i{n.}
  4287. a @i{simple vector}.
  4288. @IGindex{simple string}
  4289. @item @b{simple string}
  4290. @i{n.}
  4291. a @i{string} of @i{type} @b{simple-string}.
  4292. @IGindex{simple vector}
  4293. @item @b{simple vector}
  4294. @i{n.}
  4295. a @i{vector} of @i{type} @b{simple-vector},
  4296. sometimes called a ``@i{simple general vector}.''
  4297. Not all @i{vectors} that are @i{simple} are @i{simple vectors}---only
  4298. those that have @i{element type} @b{t}.
  4299. @IGindex{single escape}
  4300. @item @b{single escape}
  4301. @i{n.}, @i{adj.}
  4302. 1. @i{n.} the @i{syntax type} of a @i{character}
  4303. that indicates that the next @i{character} is
  4304. to be treated as an @i{alphabetic}_2 @i{character}
  4305. with its @i{case} preserved.
  4306. For details, see @ref{Single Escape Character}.
  4307. 2. @i{adj.} (of a @i{character})
  4308. having the @i{single escape} @i{syntax type}.
  4309. 3. @i{n.} a @i{single escape}_2 @i{character}.
  4310. (In the @i{standard readtable},
  4311. @i{slash} is the only @i{single escape}.)
  4312. @IGindex{single float}
  4313. @item @b{single float}
  4314. @i{n.}
  4315. an @i{object} of @i{type} @b{single-float}.
  4316. @IGindex{single-quote}
  4317. @item @b{single-quote}
  4318. @i{n.}
  4319. the @i{standard character} that is variously called
  4320. ``apostrophe,''
  4321. ``acute accent,''
  4322. ``quote,''
  4323. or ``single quote'' (@t{'}).
  4324. See @i{Figure~2--5}.
  4325. @IGindex{singleton}
  4326. @item @b{singleton}
  4327. @i{adj.} (of a @i{sequence})
  4328. having only one @i{element}.
  4329. {``@t{(list 'hello)} returns a singleton list.''}
  4330. @IGindex{situation}
  4331. @item @b{situation}
  4332. @i{n.}
  4333. the @i{evaluation} of a @i{form} in a specific @i{environment}.
  4334. @IGindex{slash}
  4335. @item @b{slash}
  4336. @i{n.}
  4337. the @i{standard character} that is variously called
  4338. ``solidus''
  4339. or ``slash'' (@t{/}).
  4340. See @i{Figure~2--5}.
  4341. @IGindex{slot}
  4342. @item @b{slot}
  4343. @i{n.}
  4344. a component of an @i{object} that can store a @i{value}.
  4345. @IGindex{slot specifier}
  4346. @item @b{slot specifier}
  4347. @i{n.}
  4348. a representation of a @i{slot}
  4349. that includes the @i{name} of the @i{slot} and zero or more @i{slot} options.
  4350. A @i{slot} option pertains only to a single @i{slot}.
  4351. @IGindex{source code}
  4352. @item @b{source code}
  4353. @i{n.}
  4354. @i{code} representing @i{objects} suitable for @i{evaluation}
  4355. (@i{e.g.}, @i{objects} created by @b{read},
  4356. by @i{macro expansion},
  4357. or by @i{compiler macro expansion}).
  4358. @IGindex{source file}
  4359. @item @b{source file}
  4360. @i{n.}
  4361. a @i{file} which contains a textual representation of @i{source code},
  4362. that can be edited, @i{loaded}, or @i{compiled}.
  4363. @IGindex{space}
  4364. @item @b{space}
  4365. @i{n.}
  4366. the @i{standard character} <@i{Space}>,
  4367. notated for the @i{Lisp reader} as @t{#\Space}.
  4368. @IGindex{special form}
  4369. @item @b{special form}
  4370. @i{n.}
  4371. a @i{list}, other than a @i{macro form}, which is a
  4372. @i{form} with special syntax or special @i{evaluation}
  4373. rules or both, possibly manipulating the @i{evaluation}
  4374. @i{environment} or control flow or both. The first element of
  4375. a @i{special form} is a @i{special operator}.
  4376. @IGindex{special operator}
  4377. @item @b{special operator}
  4378. @i{n.}
  4379. one of a fixed set of @i{symbols},
  4380. enumerated in @i{Figure~3--2},
  4381. that may appear in the @i{car} of
  4382. a @i{form} in order to identify the @i{form} as a @i{special form}.
  4383. @IGindex{special variable}
  4384. @item @b{special variable}
  4385. @i{n.} @i{Trad.}
  4386. a @i{dynamic variable}.
  4387. @IGindex{specialize}
  4388. @item @b{specialize}
  4389. @i{v.t.} (a @i{generic function})
  4390. to define a @i{method} for the @i{generic function}, or in other words,
  4391. to refine the behavior of the @i{generic function} by giving it a specific
  4392. meaning for a particular set of @i{classes} or @i{arguments}.
  4393. @IGindex{specialized}
  4394. @item @b{specialized}
  4395. @i{adj.}
  4396. 1. (of a @i{generic function})
  4397. having @i{methods} which @i{specialize} the @i{generic function}.
  4398. 2. (of an @i{array})
  4399. having an @i{actual array element type}
  4400. that is a @i{proper subtype} of the @i{type} @b{t};
  4401. see @ref{Array Elements}.
  4402. {``@t{(make-array 5 :element-type 'bit)} makes an array of length
  4403. five that is specialized for bits.''}
  4404. @IGindex{specialized lambda list}
  4405. @item @b{specialized lambda list}
  4406. @i{n.}
  4407. an @i{extended lambda list} used in @i{forms} that @i{establish}
  4408. @i{method} definitions, such as @b{defmethod}.
  4409. See @ref{Specialized Lambda Lists}.
  4410. @IGindex{spreadable argument list designator}
  4411. @item @b{spreadable argument list designator}
  4412. @i{n.}
  4413. a @i{designator} for a @i{list} of @i{objects}; that is,
  4414. an @i{object} that denotes a @i{list}
  4415. and that is a @i{non-null} @i{list} L1 of length n,
  4416. whose last element is a @i{list} L2 of length m
  4417. (denoting a list L3 of length m+n-1 whose @i{elements} are
  4418. L1_i for i < n-1 followed by L2_j for j < m).
  4419. {``The list (1 2 (3 4 5)) is a spreadable argument list designator for
  4420. the list (1 2 3 4 5).''}
  4421. @IGindex{stack allocate}
  4422. @item @b{stack allocate}
  4423. @i{v.t.} @i{Trad.}
  4424. to allocate in a non-permanent way, such as on a stack. Stack-allocation
  4425. is an optimization technique used in some @i{implementations} for
  4426. allocating certain kinds of @i{objects} that have @i{dynamic extent}.
  4427. Such @i{objects} are allocated on the stack rather than in the heap
  4428. so that their storage can be freed as part of unwinding the stack rather
  4429. than taking up space in the heap until the next garbage collection.
  4430. What @i{types} (if any) can have @i{dynamic extent} can vary
  4431. from @i{implementation} to @i{implementation}. No
  4432. @i{implementation} is ever required to perform stack-allocation.
  4433. @IGindex{stack-allocated}
  4434. @item @b{stack-allocated}
  4435. @i{adj.} @i{Trad.}
  4436. having been @i{stack allocated}.
  4437. @IGindex{standard character}
  4438. @item @b{standard character}
  4439. @i{n.}
  4440. a @i{character} of @i{type} @b{standard-char}, which is one of a fixed set of 96
  4441. such @i{characters} required to be present in all @i{conforming implementations}.
  4442. See @ref{Standard Characters}.
  4443. @IGindex{standard class}
  4444. @item @b{standard class}
  4445. @i{n.}
  4446. a @i{class} that is a @i{generalized instance} of @i{class} @b{standard-class}.
  4447. @IGindex{standard generic function}
  4448. @item @b{standard generic function}
  4449. a @i{function} of @i{type} @b{standard-generic-function}.
  4450. @IGindex{standard input}
  4451. @item @b{standard input}
  4452. @i{n.}
  4453. the @i{input} @i{stream} which is the @i{value} of the @i{dynamic variable}
  4454. @b{*standard-input*}.
  4455. @IGindex{standard method combination}
  4456. @item @b{standard method combination}
  4457. @i{n.}
  4458. the @i{method combination} named @b{standard}.
  4459. @IGindex{standard object}
  4460. @item @b{standard object}
  4461. @i{n.}
  4462. an @i{object} that is
  4463. a @i{generalized instance}
  4464. of @i{class} @b{standard-object}.
  4465. @IGindex{standard output}
  4466. @item @b{standard output}
  4467. @i{n.}
  4468. the @i{output} @i{stream} which is the @i{value} of the @i{dynamic variable}
  4469. @b{*standard-output*}.
  4470. @IGindex{standard pprint dispatch table}
  4471. @item @b{standard pprint dispatch table}
  4472. @i{n.}
  4473. A @i{pprint dispatch table} that is @i{different} from
  4474. the @i{initial pprint dispatch table},
  4475. that implements @i{pretty printing} as described in this specification,
  4476. and that, unlike other @i{pprint dispatch tables},
  4477. must never be modified by any program.
  4478. (Although the definite reference ``the @i{standard pprint dispatch table}''
  4479. is generally used
  4480. within this document, it is actually @i{implementation-dependent} whether a
  4481. single @i{object} fills the role of the @i{standard pprint dispatch table},
  4482. or whether there might be multiple such objects, any one of which could be used on any
  4483. given occasion where ``the @i{standard pprint dispatch table}'' is called for.
  4484. As such, this phrase should be seen as an indefinite reference
  4485. in all cases except for anaphoric references.)
  4486. @IGindex{standard readtable}
  4487. @item @b{standard readtable}
  4488. @i{n.}
  4489. A @i{readtable} that is @i{different} from the @i{initial readtable},
  4490. that implements the @i{expression} syntax defined in this specification,
  4491. and that, unlike other @i{readtables}, must never be modified by any program.
  4492. (Although the definite reference ``the @i{standard readtable}'' is generally used
  4493. within this document, it is actually @i{implementation-dependent} whether a
  4494. single @i{object} fills the role of the @i{standard readtable},
  4495. or whether there might be multiple such objects, any one of which could be used on any
  4496. given occasion where ``the @i{standard readtable}'' is called for.
  4497. As such, this phrase should be seen as an indefinite reference
  4498. in all cases except for anaphoric references.)
  4499. @IGindex{standard syntax}
  4500. @item @b{standard syntax}
  4501. @i{n.}
  4502. the syntax represented by the @i{standard readtable}
  4503. and used as a reference syntax throughout this document.
  4504. See @ref{Character Syntax}.
  4505. @IGindex{standardized}
  4506. @item @b{standardized}
  4507. @i{adj.} (of a @i{name}, @i{object}, or definition)
  4508. having been defined by @r{Common Lisp}.
  4509. {``All standardized variables that are required to
  4510. hold bidirectional streams have ``@t{-io*}'' in their name.''}
  4511. @IGindex{startup environment}
  4512. @item @b{startup environment}
  4513. @i{n.}
  4514. the @i{global environment} of the running @i{Lisp image}
  4515. from which the @i{compiler} was invoked.
  4516. @IGindex{step}
  4517. @item @b{step}
  4518. @i{v.t.}, @i{n.}
  4519. 1. @i{v.t.} (an iteration @i{variable}) to @i{assign} the @i{variable}
  4520. a new @i{value} at the end of an iteration, in preparation for a new iteration.
  4521. 2. @i{n.} the @i{code} that identifies how the next value in an iteration
  4522. is to be computed.
  4523. 3. @i{v.t.} (@i{code}) to specially execute the @i{code}, pausing at
  4524. intervals to allow user confirmation or intervention, usually for debugging.
  4525. @IGindex{stream}
  4526. @item @b{stream}
  4527. @i{n.}
  4528. an @i{object} that can be used with an input or output function to
  4529. identify an appropriate source or sink of @i{characters} or
  4530. @i{bytes} for that operation.
  4531. @IGindex{stream associated with a file}
  4532. @item @b{stream associated with a file}
  4533. @i{n.}
  4534. a @i{file stream}, or a @i{synonym stream} the @i{target}
  4535. of which is a @i{stream associated with a file}.
  4536. Such a @i{stream} cannot be created with
  4537. @b{make-two-way-stream},
  4538. @b{make-echo-stream},
  4539. @b{make-broadcast-stream},
  4540. @b{make-concatenated-stream},
  4541. @b{make-string-input-stream},
  4542. or @b{make-string-output-stream}.
  4543. @IGindex{stream designator}
  4544. @item @b{stream designator}
  4545. @i{n.}
  4546. a @i{designator} for a @i{stream}; that is,
  4547. an @i{object} that denotes a @i{stream}
  4548. and that is one of:
  4549. @b{t} (denoting the @i{value} of @b{*terminal-io*}),
  4550. @b{nil} (denoting the @i{value} of @b{*standard-input*}
  4551. for @i{input} @i{stream designators}
  4552. or denoting the @i{value} of @b{*standard-output*}
  4553. for @i{output} @i{stream designators}),
  4554. or a @i{stream} (denoting itself).
  4555. @IGindex{stream element type}
  4556. @item @b{stream element type}
  4557. @i{n.} (of a @i{stream})
  4558. the @i{type} of data for which the @i{stream} is specialized.
  4559. @IGindex{stream variable}
  4560. @item @b{stream variable}
  4561. @i{n.}
  4562. a @i{variable} whose @i{value} must be a @i{stream}.
  4563. @IGindex{stream variable designator}
  4564. @item @b{stream variable designator}
  4565. @i{n.}
  4566. a @i{designator} for a @i{stream variable}; that is,
  4567. a @i{symbol} that denotes a @i{stream variable}
  4568. and that is one of:
  4569. @b{t} (denoting @b{*terminal-io*}),
  4570. @b{nil} (denoting @b{*standard-input*}
  4571. for @i{input} @i{stream variable designators}
  4572. or denoting @b{*standard-output*}
  4573. for @i{output} @i{stream variable designators}),
  4574. or some other @i{symbol} (denoting itself).
  4575. @IGindex{string}
  4576. @item @b{string}
  4577. @i{n.}
  4578. a specialized @i{vector} that is of @i{type} @b{string},
  4579. and whose elements are of @i{type} @b{character} or a @i{subtype} of @i{type} @b{character}.
  4580. @IGindex{string designator}
  4581. @item @b{string designator}
  4582. @i{n.}
  4583. a @i{designator} for a @i{string}; that is,
  4584. an @i{object} that denotes a @i{string}
  4585. and that is one of:
  4586. a @i{character} (denoting a @i{singleton} @i{string}
  4587. that has the @i{character} as its only @i{element}),
  4588. a @i{symbol} (denoting the @i{string} that is its @i{name}),
  4589. or a @i{string} (denoting itself).
  4590. The intent is that this term be consistent with the behavior of @b{string};
  4591. @i{implementations} that extend @b{string} must extend the meaning of
  4592. this term in a compatible way.
  4593. @IGindex{string equal}
  4594. @item @b{string equal}
  4595. @i{adj.}
  4596. the @i{same} under @b{string-equal}.
  4597. @IGindex{string stream}
  4598. @item @b{string stream}
  4599. @i{n.}
  4600. a @i{stream} of @i{type} @b{string-stream}.
  4601. @IGindex{structure}
  4602. @item @b{structure}
  4603. @i{n.}
  4604. an @i{object} of @i{type} @b{structure-object}.
  4605. @IGindex{structure class}
  4606. @item @b{structure class}
  4607. @i{n.}
  4608. a @i{class} that is a @i{generalized instance} of @i{class} @b{structure-class}.
  4609. @IGindex{structure name}
  4610. @item @b{structure name}
  4611. @i{n.}
  4612. a @i{name} defined with @b{defstruct}.
  4613. Usually, such a @i{type} is also a @i{structure class},
  4614. but there may be @i{implementation-dependent} situations
  4615. in which this is not so, if the @t{:type} option to @b{defstruct} is used.
  4616. @IGindex{style warning}
  4617. @item @b{style warning}
  4618. @i{n.}
  4619. a @i{condition} of @i{type} @b{style-warning}.
  4620. @IGindex{subclass}
  4621. @item @b{subclass}
  4622. @i{n.}
  4623. a @i{class} that @i{inherits} from another @i{class},
  4624. called a @i{superclass}.
  4625. (No @i{class} is a @i{subclass} of itself.)
  4626. @IGindex{subexpression}
  4627. @item @b{subexpression}
  4628. @i{n.} (of an @i{expression})
  4629. an @i{expression} that is contained within the @i{expression}.
  4630. (In fact, the state of being a @i{subexpression} is not an attribute
  4631. of the @i{subexpression}, but really an attribute of the containing
  4632. @i{expression} since the @i{same} @i{object} can at once be
  4633. a @i{subexpression} in one context, and not in another.)
  4634. @IGindex{subform}
  4635. @item @b{subform}
  4636. @i{n.} (of a @i{form})
  4637. an @i{expression} that is a @i{subexpression} of the @i{form},
  4638. and which by virtue of its position in that @i{form} is also a
  4639. @i{form}.
  4640. {``@t{(f x)} and @t{x}, but not @t{exit}, are subforms of
  4641. @t{(return-from exit (f x))}.''}
  4642. @IGindex{subrepertoire}
  4643. @item @b{subrepertoire}
  4644. @i{n.}
  4645. a subset of a @i{repertoire}.
  4646. @IGindex{subtype}
  4647. @item @b{subtype}
  4648. @i{n.}
  4649. a @i{type} whose membership is the same as or a proper subset of the
  4650. membership of another @i{type}, called a @i{supertype}.
  4651. (Every @i{type} is a @i{subtype} of itself.)
  4652. @IGindex{superclass}
  4653. @item @b{superclass}
  4654. @i{n.}
  4655. a @i{class} from which another @i{class}
  4656. (called a @i{subclass}) @i{inherits}.
  4657. (No @i{class} is a @i{superclass} of itself.)
  4658. See @i{subclass}.
  4659. @IGindex{supertype}
  4660. @item @b{supertype}
  4661. @i{n.}
  4662. a @i{type} whose membership is the same as or a proper superset
  4663. of the membership of another @i{type}, called a @i{subtype}.
  4664. (Every @i{type} is a @i{supertype} of itself.)
  4665. See @i{subtype}.
  4666. @IGindex{supplied-p parameter}
  4667. @item @b{supplied-p parameter}
  4668. @i{n.}
  4669. a @i{parameter} which recieves its @i{generalized boolean} value
  4670. implicitly due to the presence or absence of an @i{argument}
  4671. corresponding to another @i{parameter}
  4672. (such as an @i{optional parameter} or a @i{rest parameter}).
  4673. See @ref{Ordinary Lambda Lists}.
  4674. @IGindex{symbol}
  4675. @item @b{symbol}
  4676. @i{n.}
  4677. an @i{object} of @i{type} @b{symbol}.
  4678. @IGindex{symbol macro}
  4679. @item @b{symbol macro}
  4680. @i{n.}
  4681. a @i{symbol} that stands for another @i{form}.
  4682. See the @i{macro} @b{symbol-macrolet}.
  4683. @IGindex{synonym stream}
  4684. @item @b{synonym stream}
  4685. @i{n.}
  4686. 1. a @i{stream} of @i{type} @b{synonym-stream},
  4687. which is consequently a @i{stream} that is an alias for another @i{stream},
  4688. which is the @i{value} of a @i{dynamic variable}
  4689. whose @i{name} is the @i{synonym stream symbol} of the @i{synonym stream}.
  4690. See the @i{function} @b{make-synonym-stream}.
  4691. 2. (to a @i{stream})
  4692. a @i{synonym stream} which has the @i{stream} as the @i{value}
  4693. of its @i{synonym stream symbol}.
  4694. 3. (to a @i{symbol})
  4695. a @i{synonym stream} which has the @i{symbol} as its
  4696. @i{synonym stream symbol}.
  4697. @IGindex{synonym stream symbol}
  4698. @item @b{synonym stream symbol}
  4699. @i{n.} (of a @i{synonym stream})
  4700. the @i{symbol} which names the @i{dynamic variable} which has as its
  4701. @i{value} another @i{stream} for which the @i{synonym stream}
  4702. is an alias.
  4703. @IGindex{syntax type}
  4704. @item @b{syntax type}
  4705. @i{n.} (of a @i{character})
  4706. one of several classifications, enumerated in @i{Figure~2--6},
  4707. that are used for dispatch during parsing by the @i{Lisp reader}.
  4708. See @ref{Character Syntax Types}.
  4709. @IGindex{system class}
  4710. @item @b{system class}
  4711. @i{n.}
  4712. a @i{class} that may be of @i{type} @b{built-in-class} in a @i{conforming implementation}
  4713. and hence cannot be inherited by @i{classes} defined by @i{conforming programs}.
  4714. @IGindex{system code}
  4715. @item @b{system code}
  4716. @i{n.}
  4717. @i{code} supplied by the @i{implementation} to implement this specification
  4718. (@i{e.g.}, the definition of @b{mapcar})
  4719. or generated automatically in support of this specification
  4720. (@i{e.g.}, during method combination);
  4721. that is, @i{code} that is not @i{programmer code}.
  4722. @end table
  4723. @subheading @b{T}
  4724. @table @asis
  4725. @IGindex{t}
  4726. @item @b{t}
  4727. @i{n.}
  4728. 1. a. the @i{boolean} representing true.
  4729. b. the canonical @i{generalized boolean} representing true.
  4730. (Although any @i{object} other than @b{nil} is considered @i{true}
  4731. as a @i{generalized boolean},
  4732. @t{t} is generally used when there is no special reason to prefer one
  4733. such @i{object} over another.)
  4734. 2. the @i{name} of the @i{type} to which all @i{objects} belong---the
  4735. @i{supertype} of all @i{types} (including itself).
  4736. 3. the @i{name} of the @i{superclass} of all @i{classes} except itself.
  4737. @IGindex{tag}
  4738. @item @b{tag}
  4739. @i{n.}
  4740. 1. a @i{catch tag}.
  4741. 2. a @i{go tag}.
  4742. @IGindex{tail}
  4743. @item @b{tail}
  4744. @i{n.} (of a @i{list})
  4745. an @i{object} that is the @i{same} as either some @i{cons}
  4746. which makes up that @i{list} or the @i{atom} (if any) which terminates
  4747. the @i{list}.
  4748. {``The empty list is a tail of every proper list.''}
  4749. @IGindex{target}
  4750. @item @b{target}
  4751. @i{n.}
  4752. 1. (of a @i{constructed stream})
  4753. a @i{constituent} of the @i{constructed stream}.
  4754. {``The target of a synonym stream is
  4755. the value of its synonym stream symbol.''}
  4756. 2. (of a @i{displaced array})
  4757. the @i{array} to which the @i{displaced array} is displaced.
  4758. (In the case of a chain of @i{constructed streams} or @i{displaced arrays},
  4759. the unqualified term ``@i{target}'' always refers to the immediate
  4760. @i{target} of the first item in the chain, not the immediate target
  4761. of the last item.)
  4762. @IGindex{terminal I/O}
  4763. @item @b{terminal I/O}
  4764. @i{n.}
  4765. the @i{bidirectional} @i{stream}
  4766. that is the @i{value} of the @i{variable} @b{*terminal-io*}.
  4767. @IGindex{terminating}
  4768. @item @b{terminating}
  4769. @i{n.} (of a @i{macro character})
  4770. being such that, if it appears while parsing a token, it terminates that token.
  4771. See @ref{Reader Algorithm}.
  4772. @IGindex{tertiary value}
  4773. @item @b{tertiary value}
  4774. @i{n.} (of @i{values} resulting from the
  4775. @i{evaluation} of a @i{form})
  4776. the third @i{value}, if any,
  4777. or else @b{nil} if there are fewer than three @i{values}.
  4778. @IGindex{throw}
  4779. @item @b{throw}
  4780. @i{v.}
  4781. to transfer control and @i{values} to a @i{catch}.
  4782. See the @i{special operator} @b{throw}.
  4783. @IGindex{tilde}
  4784. @item @b{tilde}
  4785. @i{n.}
  4786. the @i{standard character} that is called ``tilde'' (@t{~}).
  4787. See @i{Figure~2--5}.
  4788. @IGindex{time}
  4789. @item @b{time}
  4790. a representation of a point (@i{absolute} @i{time})
  4791. or an interval (@i{relative} @i{time})
  4792. on a time line.
  4793. See @i{decoded time}, @i{internal time}, and @i{universal time}.
  4794. @IGindex{time zone}
  4795. @item @b{time zone}
  4796. @i{n.}
  4797. a @i{rational} multiple of @t{1/3600} between @t{-24} (inclusive)
  4798. and @t{24} (inclusive) that represents a time zone as a number of hours
  4799. offset from Greenwich Mean Time. Time zone values increase with motion to the west,
  4800. so Massachusetts, U.S.A. is in time zone @t{5},
  4801. California, U.S.A. is time zone @t{8},
  4802. and Moscow, Russia is time zone @i{-3}.
  4803. (When ``daylight savings time'' is separately represented
  4804. as an @i{argument} or @i{return value}, the @i{time zone}
  4805. that accompanies it does not depend on whether daylight savings time
  4806. is in effect.)
  4807. @IGindex{token}
  4808. @item @b{token}
  4809. @i{n.}
  4810. a textual representation for a @i{number} or a @i{symbol}.
  4811. See @ref{Interpretation of Tokens}.
  4812. @IGindex{top level form}
  4813. @item @b{top level form}
  4814. @i{n.}
  4815. a @i{form} which is processed specially by @b{compile-file} for
  4816. the purposes of enabling @i{compile time} @i{evaluation} of that
  4817. @i{form}.
  4818. @i{Top level forms} include those @i{forms} which
  4819. are not @i{subforms} of any other @i{form},
  4820. and certain other cases. See @ref{Processing of Top Level Forms}.
  4821. @IGindex{trace output}
  4822. @item @b{trace output}
  4823. @i{n.}
  4824. the @i{output} @i{stream} which is the @i{value} of the @i{dynamic variable}
  4825. @b{*trace-output*}.
  4826. @IGindex{tree}
  4827. @item @b{tree}
  4828. @i{n.}
  4829. 1. a binary recursive data structure made up of @i{conses} and
  4830. @i{atoms}: the @i{conses} are themselves also @i{trees}
  4831. (sometimes called ``subtrees'' or ``branches''), and the @i{atoms}
  4832. are terminal nodes (sometimes called @i{leaves}). Typically,
  4833. the @i{leaves} represent data while the branches establish some
  4834. relationship among that data.
  4835. 2. in general, any recursive data structure that has some notion of
  4836. ``branches'' and @i{leaves}.
  4837. @IGindex{tree structure}
  4838. @item @b{tree structure}
  4839. @i{n.} (of a @i{tree}_1)
  4840. the set of @i{conses} that make up the @i{tree}.
  4841. Note that while the @i{car}_@{1b@} component of each such @i{cons}
  4842. is part of the @i{tree structure},
  4843. the @i{objects} that are the @i{cars}_2 of each @i{cons}
  4844. in the @i{tree}
  4845. are not themselves part of its @i{tree structure}
  4846. unless they are also @i{conses}.
  4847. @IGindex{true}
  4848. @item @b{true}
  4849. @i{n.}
  4850. any @i{object}
  4851. that is not @i{false}
  4852. and that is used to represent the success of a @i{predicate} test.
  4853. See @i{t}_1.
  4854. @IGindex{truename}
  4855. @item @b{truename}
  4856. @i{n.}
  4857. 1. the canonical @i{filename} of a @i{file} in the @i{file system}.
  4858. See @ref{Truenames}.
  4859. 2. a @i{pathname} representing a @i{truename}_1.
  4860. @IGindex{two-way stream}
  4861. @item @b{two-way stream}
  4862. @i{n.}
  4863. a @i{stream} of @i{type} @b{two-way-stream},
  4864. which is a @i{bidirectional} @i{composite stream} that
  4865. receives its input from an associated @i{input} @i{stream}
  4866. and sends its output to an associated @i{output} @i{stream}.
  4867. @IGindex{type}
  4868. @item @b{type}
  4869. @i{n.}
  4870. 1. a set of @i{objects}, usually with common structure, behavior, or purpose.
  4871. (Note that the expression ``@i{X} is of type @i{S_a}''
  4872. naturally implies that ``@i{X} is of type @i{S_b}'' if
  4873. @i{S_a} is a @i{subtype} of @i{S_b}.)
  4874. 2. (immediately following the name of a @i{type})
  4875. a @i{subtype} of that @i{type}.
  4876. {``The type @b{vector} is an array type.''}
  4877. @IGindex{type declaration}
  4878. @item @b{type declaration}
  4879. @i{n.}
  4880. a @i{declaration} that asserts that every reference to a
  4881. specified @i{binding} within the scope of the @i{declaration}
  4882. results in some @i{object} of the specified @i{type}.
  4883. @IGindex{type equivalent}
  4884. @item @b{type equivalent}
  4885. @i{adj.} (of two @i{types} X and Y)
  4886. having the same @i{elements};
  4887. that is, X is a @i{subtype} of Y
  4888. and Y is a @i{subtype} of X.
  4889. @IGindex{type expand}
  4890. @item @b{type expand}
  4891. @i{n.}
  4892. to fully expand a @i{type specifier}, removing any references to
  4893. @i{derived types}. (@r{Common Lisp} provides no program interface to cause
  4894. this to occur, but the semantics of @r{Common Lisp} are such that every
  4895. @i{implementation} must be able to do this internally, and some
  4896. situations involving @i{type specifiers} are most easily described
  4897. in terms of a fully expanded @i{type specifier}.)
  4898. @IGindex{type specifier}
  4899. @item @b{type specifier}
  4900. @i{n.}
  4901. an @i{expression} that denotes a @i{type}.
  4902. {``The symbol @t{random-state}, the list @t{(integer 3 5)},
  4903. the list @t{(and list (not null))}, and the class named
  4904. @t{standard-class} are type specifiers.''}
  4905. @end table
  4906. @subheading @b{U}
  4907. @table @asis
  4908. @IGindex{unbound}
  4909. @item @b{unbound}
  4910. @i{adj.}
  4911. not having an associated denotation in a @i{binding}.
  4912. See @i{bound}.
  4913. @IGindex{unbound variable}
  4914. @item @b{unbound variable}
  4915. @i{n.}
  4916. a @i{name} that is syntactically plausible as the name of a
  4917. @i{variable} but which is not @i{bound}
  4918. in the @i{variable} @i{namespace}.
  4919. @IGindex{undefined function}
  4920. @item @b{undefined function}
  4921. @i{n.}
  4922. a @i{name} that is syntactically plausible as the name of a
  4923. @i{function} but which is not @i{bound}
  4924. in the @i{function} @i{namespace}.
  4925. @IGindex{unintern}
  4926. @item @b{unintern}
  4927. @i{v.t.} (a @i{symbol} in a @i{package})
  4928. to make the @i{symbol} not be @i{present} in that @i{package}.
  4929. (The @i{symbol} might continue to be @i{accessible} by inheritance.)
  4930. @IGindex{uninterned}
  4931. @item @b{uninterned}
  4932. @i{adj.} (of a @i{symbol})
  4933. not @i{accessible} in any @i{package}; @i{i.e.}, not @i{interned}_1.
  4934. @IGindex{universal time}
  4935. @item @b{universal time}
  4936. @i{n.}
  4937. @i{time}, represented as a non-negative @i{integer} number of seconds.
  4938. @i{Absolute} @i{universal time} is measured as an offset
  4939. from the beginning of the year 1900 (ignoring @i{leap seconds}).
  4940. See @ref{Universal Time}.
  4941. @IGindex{unqualified method}
  4942. @item @b{unqualified method}
  4943. @i{n.}
  4944. a @i{method} with no @i{qualifiers}.
  4945. @IGindex{unregistered package}
  4946. @item @b{unregistered package}
  4947. @i{n.}
  4948. a @i{package} @i{object} that is not present in the @i{package registry}.
  4949. An @i{unregistered package} has no @i{name}; @i{i.e.}, its @i{name} is @b{nil}.
  4950. See the @i{function} @b{delete-package}.
  4951. @IGindex{unsafe}
  4952. @item @b{unsafe}
  4953. @i{adj.} (of @i{code})
  4954. not @i{safe}. (Note that, unless explicitly specified otherwise,
  4955. if a particular kind of error checking is
  4956. guaranteed only in a @i{safe} context, the same checking might or might not occur
  4957. in that context if it were @i{unsafe}; describing a context as @i{unsafe}
  4958. means that certain kinds of error checking are not reliably enabled
  4959. but does not guarantee that error checking is definitely disabled.)
  4960. @IGindex{unsafe call}
  4961. @item @b{unsafe call}
  4962. @i{n.}
  4963. a @i{call} that is not a @i{safe call}.
  4964. For more detailed information, see @ref{Safe and Unsafe Calls}.
  4965. @IGindex{upgrade}
  4966. @item @b{upgrade}
  4967. @i{v.t.} (a declared @i{type} to an actual @i{type})
  4968. 1. (when creating an @i{array})
  4969. to substitute an @i{actual array element type}
  4970. for an @i{expressed array element type}
  4971. when choosing an appropriately @i{specialized} @i{array} representation.
  4972. See the @i{function} @b{upgraded-array-element-type}.
  4973. 2. (when creating a @i{complex})
  4974. to substitute an @i{actual complex part type}
  4975. for an @i{expressed complex part type}
  4976. when choosing an appropriately @i{specialized} @i{complex} representation.
  4977. See the @i{function} @b{upgraded-complex-part-type}.
  4978. @IGindex{upgraded array element type}
  4979. @item @b{upgraded array element type}
  4980. @i{n.} (of a @i{type})
  4981. a @i{type} that is a @i{supertype} of the @i{type}
  4982. and that is used instead of the @i{type} whenever the
  4983. @i{type} is used as an @i{array element type}
  4984. for object creation or type discrimination.
  4985. See @ref{Array Upgrading}.
  4986. @IGindex{upgraded complex part type}
  4987. @item @b{upgraded complex part type}
  4988. @i{n.} (of a @i{type})
  4989. a @i{type} that is a @i{supertype} of the @i{type}
  4990. and that is used instead of the @i{type} whenever the
  4991. @i{type} is used as a @i{complex part type}
  4992. for object creation or type discrimination.
  4993. See the @i{function} @b{upgraded-complex-part-type}.
  4994. @IGindex{uppercase}
  4995. @item @b{uppercase}
  4996. @i{adj.} (of a @i{character})
  4997. being among @i{standard characters} corresponding to
  4998. the capital letters @t{A} through @t{Z},
  4999. or being some other @i{implementation-defined} @i{character}
  5000. that is defined by the @i{implementation} to be @i{uppercase}.
  5001. See @ref{Characters With Case}.
  5002. @IGindex{use}
  5003. @item @b{use}
  5004. @i{v.t.} (a @i{package} P_1)
  5005. to @i{inherit} the @i{external symbols} of P_1.
  5006. (If a package P_2 uses P_1,
  5007. the @i{external symbols} of P_1
  5008. become @i{internal symbols} of P_2
  5009. unless they are explicitly @i{exported}.)
  5010. {``The package @t{CL-USER} uses the package @t{CL}.''}
  5011. @IGindex{use list}
  5012. @item @b{use list}
  5013. @i{n.} (of a @i{package})
  5014. a (possibly empty) @i{list} associated with each @i{package}
  5015. which determines what other @i{packages} are currently being
  5016. @i{used} by that @i{package}.
  5017. @IGindex{user}
  5018. @item @b{user}
  5019. @i{n.}
  5020. an active entity, typically a human, that invokes or interacts with a
  5021. @i{program} at run time, but that is not necessarily a @i{programmer}.
  5022. @end table
  5023. @subheading @b{V}
  5024. @table @asis
  5025. @IGindex{valid array dimension}
  5026. @item @b{valid array dimension}
  5027. @i{n.}
  5028. a @i{fixnum} suitable for use as an @i{array} @i{dimension}.
  5029. Such a @i{fixnum} must be greater than or equal to zero,
  5030. and less than the @i{value} of @b{array-dimension-limit}.
  5031. When multiple @i{array} @i{dimensions} are to be used together to specify a
  5032. multi-dimensional @i{array}, there is also an implied constraint
  5033. that the product of all of the @i{dimensions} be less than the @i{value} of
  5034. @b{array-total-size-limit}.
  5035. @IGindex{valid array index}
  5036. @item @b{valid array index}
  5037. @i{n.} (of an @i{array})
  5038. a @i{fixnum} suitable for use as one of possibly several indices needed
  5039. to name an @i{element} of the @i{array} according to a multi-dimensional
  5040. Cartesian coordinate system. Such a @i{fixnum} must
  5041. be greater than or equal to zero,
  5042. and must be less than the corresponding @i{dimension}_1
  5043. of the @i{array}.
  5044. (Unless otherwise explicitly specified,
  5045. the phrase ``a @i{list} of @i{valid array indices}'' further implies
  5046. that the @i{length} of the @i{list} must be the same as the
  5047. @i{rank} of the @i{array}.)
  5048. {``For a @t{2} by~@t{3} array,
  5049. valid array indices for the first dimension are @t{0} and~@t{1}, and
  5050. valid array indices for the second dimension are @t{0}, @t{1} and~@t{2}.''}
  5051. @IGindex{valid array row-major index}
  5052. @item @b{valid array row-major index}
  5053. @i{n.} (of an @i{array},
  5054. which might have any number
  5055. of @i{dimensions}_2)
  5056. a single @i{fixnum} suitable for use in naming any @i{element}
  5057. of the @i{array}, by viewing the array's storage as a linear
  5058. series of @i{elements} in row-major order.
  5059. Such a @i{fixnum} must be greater than or equal to zero,
  5060. and less than the @i{array total size} of the @i{array}.
  5061. @IGindex{valid fill pointer}
  5062. @item @b{valid fill pointer}
  5063. @i{n.} (of an @i{array})
  5064. a @i{fixnum} suitable for use as a @i{fill pointer} for the @i{array}.
  5065. Such a @i{fixnum} must be greater than or equal to zero,
  5066. and less than or equal to the @i{array total size} of the @i{array}.
  5067. [Editorial Note by KMP: The ``valid pathname xxx'' definitions were taken from
  5068. text found in make-pathname, but look wrong to me.
  5069. I'll fix them later.]
  5070. @IGindex{valid logical pathname host}
  5071. @item @b{valid logical pathname host}
  5072. @i{n.}
  5073. a @i{string} that has been defined as the name of a @i{logical host}.
  5074. See the @i{function} @b{load-logical-pathname-translations}.
  5075. @IGindex{valid pathname device}
  5076. @item @b{valid pathname device}
  5077. @i{n.}
  5078. a @i{string},
  5079. @b{nil},
  5080. @t{:unspecific},
  5081. or some other @i{object} defined by the @i{implementation}
  5082. to be a @i{valid pathname device}.
  5083. @IGindex{valid pathname directory}
  5084. @item @b{valid pathname directory}
  5085. @i{n.}
  5086. a @i{string},
  5087. a @i{list} of @i{strings},
  5088. @b{nil},
  5089. @t{:wild},
  5090. @t{:unspecific},
  5091. or some other @i{object} defined by the @i{implementation}
  5092. to be a @i{valid directory component}.
  5093. @IGindex{valid pathname host}
  5094. @item @b{valid pathname host}
  5095. @i{n.}
  5096. a @i{valid physical pathname host}
  5097. or a @i{valid logical pathname host}.
  5098. @IGindex{valid pathname name}
  5099. @item @b{valid pathname name}
  5100. @i{n.}
  5101. a @i{string},
  5102. @b{nil},
  5103. @t{:wild},
  5104. @t{:unspecific},
  5105. or some other @i{object} defined by the @i{implementation}
  5106. to be a @i{valid pathname name}.
  5107. @IGindex{valid pathname type}
  5108. @item @b{valid pathname type}
  5109. @i{n.}
  5110. a @i{string},
  5111. @b{nil},
  5112. @t{:wild},
  5113. @t{:unspecific}.
  5114. @IGindex{valid pathname version}
  5115. @item @b{valid pathname version}
  5116. @i{n.}
  5117. a non-negative @i{integer},
  5118. or one of @t{:wild},
  5119. @t{:newest},
  5120. @t{:unspecific},
  5121. or @b{nil}.
  5122. The symbols @t{:oldest}, @t{:previous}, and @t{:installed} are
  5123. @i{semi-standard} special version symbols.
  5124. @IGindex{valid physical pathname host}
  5125. @item @b{valid physical pathname host}
  5126. @i{n.}
  5127. any of
  5128. a @i{string},
  5129. a @i{list} of @i{strings},
  5130. or the symbol @t{:unspecific},
  5131. that is recognized by the implementation as the name of a host.
  5132. @IGindex{valid sequence index}
  5133. @item @b{valid sequence index}
  5134. @i{n.} (of a @i{sequence})
  5135. an @i{integer} suitable for use to name an @i{element}
  5136. of the @i{sequence}. Such an @i{integer} must
  5137. be greater than or equal to zero,
  5138. and must be less than the @i{length} of the @i{sequence}.
  5139. (If the @i{sequence} is an @i{array},
  5140. the @i{valid sequence index} is further constrained to be a @i{fixnum}.)
  5141. @IGindex{value}
  5142. @item @b{value}
  5143. @i{n.}
  5144. 1. a. one of possibly several @i{objects} that are the result of
  5145. an @i{evaluation}.
  5146. b. (in a situation where exactly one value is expected from the
  5147. @i{evaluation} of a @i{form})
  5148. the @i{primary value} returned by the @i{form}.
  5149. c. (of @i{forms} in an @i{implicit progn}) one of possibly
  5150. several @i{objects} that result from the @i{evaluation}
  5151. of the last @i{form}, or @b{nil} if there are no @i{forms}.
  5152. 2. an @i{object} associated with a @i{name} in a @i{binding}.
  5153. 3. (of a @i{symbol}) the @i{value} of the @i{dynamic variable}
  5154. named by that symbol.
  5155. 4. an @i{object} associated with a @i{key}
  5156. in an @i{association list},
  5157. a @i{property list},
  5158. or a @i{hash table}.
  5159. @IGindex{value cell}
  5160. @item @b{value cell}
  5161. @i{n.} @i{Trad.} (of a @i{symbol})
  5162. The @i{place} which holds the @i{value}, if any, of the
  5163. @i{dynamic variable} named by that @i{symbol},
  5164. and which is @i{accessed} by @b{symbol-value}.
  5165. See @i{cell}.
  5166. @IGindex{variable}
  5167. @item @b{variable}
  5168. @i{n.}
  5169. a @i{binding} in which a @i{symbol} is the @i{name}
  5170. used to refer to an @i{object}.
  5171. @IGindex{vector}
  5172. @item @b{vector}
  5173. @i{n.}
  5174. a one-dimensional @i{array}.
  5175. @IGindex{vertical-bar}
  5176. @item @b{vertical-bar}
  5177. @i{n.}
  5178. the @i{standard character} that is called ``vertical bar'' (@t{|}).
  5179. See @i{Figure~2--5}.
  5180. @end table
  5181. @subheading @b{W}
  5182. @table @asis
  5183. @IGindex{whitespace}
  5184. @item @b{whitespace}
  5185. @i{n.}
  5186. 1. one or more @i{characters} that are
  5187. either the @i{graphic} @i{character} @t{#\Space}
  5188. or else @i{non-graphic} characters such as @t{#\Newline}
  5189. that only move the print position.
  5190. 2. a. @i{n.} the @i{syntax type} of a @i{character}
  5191. that is a @i{token} separator.
  5192. For details, see @ref{Whitespace Characters}.
  5193. b. @i{adj.} (of a @i{character})
  5194. having the @i{whitespace}_@{2a@} @i{syntax type}_2.
  5195. c. @i{n.} a @i{whitespace}_@{2b@} @i{character}.
  5196. @IGindex{wild}
  5197. @item @b{wild}
  5198. @i{adj.}
  5199. 1. (of a @i{namestring}) using an @i{implementation-defined}
  5200. syntax for naming files, which might ``match'' any of possibly several
  5201. possible @i{filenames}, and which can therefore be used to refer to
  5202. the aggregate of the @i{files} named by those @i{filenames}.
  5203. 2. (of a @i{pathname}) a structured representation of a name which
  5204. might ``match'' any of possibly several @i{pathnames}, and which can
  5205. therefore be used to refer to the aggregate of the @i{files} named by those
  5206. @i{pathnames}. The set of @i{wild} @i{pathnames} includes, but
  5207. is not restricted to, @i{pathnames} which have a component which is
  5208. @t{:wild}, or which have a directory component which contains @t{:wild}
  5209. or @t{:wild-inferors}.
  5210. See the @i{function} @b{wild-pathname-p}.
  5211. @IGindex{write}
  5212. @item @b{write}
  5213. @i{v.t.}
  5214. 1. (a @i{binding} or @i{slot} or component)
  5215. to change the @i{value} of the @i{binding} or @i{slot}.
  5216. 2. (an @i{object} to a @i{stream})
  5217. to output a representation of the @i{object} to the @i{stream}.
  5218. @IGindex{writer}
  5219. @item @b{writer}
  5220. @i{n.}
  5221. a @i{function} that @i{writes}_1 a @i{variable} or @i{slot}.
  5222. @end table
  5223. @subheading @b{Y}
  5224. @table @asis
  5225. @IGindex{yield}
  5226. @item @b{yield}
  5227. @i{v.t.} (@i{values})
  5228. to produce the @i{values} as the result of @i{evaluation}.
  5229. {``The form @t{(+ 2 3)} yields @t{5}.''}
  5230. @end table
  5231. @end table
  5232. @c end of including concept-glossary
  5233. @c %**end of chapter