home *** CD-ROM | disk | FTP | other *** search
open in: 
MacOS 8.1
|
Win98
|
DOS
browse contents |
view JSON data
|
view as text
This file was processed as: Amigaguide Document
(document/amigaGuide).
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| dexvert
| Amigaguide Document (document/amigaGuide)
| magic
| Supported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| AmigaGuide file, ISO-8859 text
| default
| |
| 100%
| perlTextCheck
| Likely Text (Perl)
| default
| |
| 100%
| siegfried
| x-fmt/111 Plain Text File
| default
| |
| 100%
| detectItEasy
| Format: plain text[LF]
| default (weak)
|
|
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 40 44 61 74 61 42 61 73 | 65 20 63 70 70 0a 40 4d |@DataBas|e cpp.@M|
|00000010| 61 73 74 65 72 20 63 70 | 70 0a 40 28 43 29 20 74 |aster cp|p.@(C) t|
|00000020| 72 61 6e 73 6c 61 74 69 | 6f 6e 20 66 72 6f 6d 20 |ranslati|on from |
|00000030| 4d 61 6b 65 69 6e 66 6f | 20 62 79 20 49 6e 66 6f |Makeinfo| by Info|
|00000040| 32 47 75 69 64 65 2e 52 | 45 58 58 20 a9 20 31 39 |2Guide.R|EXX . 19|
|00000050| 39 33 20 41 2e 50 6f 6e | 7a 69 6f 0a 23 23 0a 40 |93 A.Pon|zio.##.@|
|00000060| 4e 6f 64 65 20 4d 61 69 | 6e 20 22 63 70 70 22 0a |Node Mai|n "cpp".|
|00000070| 0a 28 49 6e 64 69 72 65 | 63 74 29 0a 20 40 7b 22 |.(Indire|ct). @{"|
|00000080| 20 54 6f 70 20 22 20 4c | 69 6e 6b 20 22 54 6f 70 | Top " L|ink "Top|
|00000090| 22 7d 0a 20 40 7b 22 20 | 47 6c 6f 62 61 6c 20 41 |"}. @{" |Global A|
|000000a0| 63 74 69 6f 6e 73 20 22 | 20 4c 69 6e 6b 20 22 47 |ctions "| Link "G|
|000000b0| 6c 6f 62 61 6c 20 41 63 | 74 69 6f 6e 73 22 7d 0a |lobal Ac|tions"}.|
|000000c0| 20 40 7b 22 20 43 6f 6d | 6d 61 6e 64 73 20 22 20 | @{" Com|mands " |
|000000d0| 4c 69 6e 6b 20 22 43 6f | 6d 6d 61 6e 64 73 22 7d |Link "Co|mmands"}|
|000000e0| 0a 20 40 7b 22 20 48 65 | 61 64 65 72 20 46 69 6c |. @{" He|ader Fil|
|000000f0| 65 73 20 22 20 4c 69 6e | 6b 20 22 48 65 61 64 65 |es " Lin|k "Heade|
|00000100| 72 20 46 69 6c 65 73 22 | 7d 0a 20 40 7b 22 20 48 |r Files"|}. @{" H|
|00000110| 65 61 64 65 72 20 55 73 | 65 73 20 22 20 4c 69 6e |eader Us|es " Lin|
|00000120| 6b 20 22 48 65 61 64 65 | 72 20 55 73 65 73 22 7d |k "Heade|r Uses"}|
|00000130| 0a 20 40 7b 22 20 49 6e | 63 6c 75 64 65 20 53 79 |. @{" In|clude Sy|
|00000140| 6e 74 61 78 20 22 20 4c | 69 6e 6b 20 22 49 6e 63 |ntax " L|ink "Inc|
|00000150| 6c 75 64 65 20 53 79 6e | 74 61 78 22 7d 0a 20 40 |lude Syn|tax"}. @|
|00000160| 7b 22 20 49 6e 63 6c 75 | 64 65 20 4f 70 65 72 61 |{" Inclu|de Opera|
|00000170| 74 69 6f 6e 20 22 20 4c | 69 6e 6b 20 22 49 6e 63 |tion " L|ink "Inc|
|00000180| 6c 75 64 65 20 4f 70 65 | 72 61 74 69 6f 6e 22 7d |lude Ope|ration"}|
|00000190| 0a 20 40 7b 22 20 4f 6e | 63 65 2d 4f 6e 6c 79 20 |. @{" On|ce-Only |
|000001a0| 22 20 4c 69 6e 6b 20 22 | 4f 6e 63 65 2d 4f 6e 6c |" Link "|Once-Onl|
|000001b0| 79 22 7d 0a 20 40 7b 22 | 20 49 6e 68 65 72 69 74 |y"}. @{"| Inherit|
|000001c0| 61 6e 63 65 20 22 20 4c | 69 6e 6b 20 22 49 6e 68 |ance " L|ink "Inh|
|000001d0| 65 72 69 74 61 6e 63 65 | 22 7d 0a 20 40 7b 22 20 |eritance|"}. @{" |
|000001e0| 4d 61 63 72 6f 73 20 22 | 20 4c 69 6e 6b 20 22 4d |Macros "| Link "M|
|000001f0| 61 63 72 6f 73 22 7d 0a | 20 40 7b 22 20 53 69 6d |acros"}.| @{" Sim|
|00000200| 70 6c 65 20 4d 61 63 72 | 6f 73 20 22 20 4c 69 6e |ple Macr|os " Lin|
|00000210| 6b 20 22 53 69 6d 70 6c | 65 20 4d 61 63 72 6f 73 |k "Simpl|e Macros|
|00000220| 22 7d 0a 20 40 7b 22 20 | 41 72 67 75 6d 65 6e 74 |"}. @{" |Argument|
|00000230| 20 4d 61 63 72 6f 73 20 | 22 20 4c 69 6e 6b 20 22 | Macros |" Link "|
|00000240| 41 72 67 75 6d 65 6e 74 | 20 4d 61 63 72 6f 73 22 |Argument| Macros"|
|00000250| 7d 0a 20 40 7b 22 20 50 | 72 65 64 65 66 69 6e 65 |}. @{" P|redefine|
|00000260| 64 20 22 20 4c 69 6e 6b | 20 22 50 72 65 64 65 66 |d " Link| "Predef|
|00000270| 69 6e 65 64 22 7d 0a 20 | 40 7b 22 20 53 74 61 6e |ined"}. |@{" Stan|
|00000280| 64 61 72 64 20 50 72 65 | 64 65 66 69 6e 65 64 20 |dard Pre|defined |
|00000290| 22 20 4c 69 6e 6b 20 22 | 53 74 61 6e 64 61 72 64 |" Link "|Standard|
|000002a0| 20 50 72 65 64 65 66 69 | 6e 65 64 22 7d 0a 20 40 | Predefi|ned"}. @|
|000002b0| 7b 22 20 4e 6f 6e 73 74 | 61 6e 64 61 72 64 20 50 |{" Nonst|andard P|
|000002c0| 72 65 64 65 66 69 6e 65 | 64 20 22 20 4c 69 6e 6b |redefine|d " Link|
|000002d0| 20 22 4e 6f 6e 73 74 61 | 6e 64 61 72 64 20 50 72 | "Nonsta|ndard Pr|
|000002e0| 65 64 65 66 69 6e 65 64 | 22 7d 0a 20 40 7b 22 20 |edefined|"}. @{" |
|000002f0| 53 74 72 69 6e 67 69 66 | 69 63 61 74 69 6f 6e 20 |Stringif|ication |
|00000300| 22 20 4c 69 6e 6b 20 22 | 53 74 72 69 6e 67 69 66 |" Link "|Stringif|
|00000310| 69 63 61 74 69 6f 6e 22 | 7d 0a 20 40 7b 22 20 43 |ication"|}. @{" C|
|00000320| 6f 6e 63 61 74 65 6e 61 | 74 69 6f 6e 20 22 20 4c |oncatena|tion " L|
|00000330| 69 6e 6b 20 22 43 6f 6e | 63 61 74 65 6e 61 74 69 |ink "Con|catenati|
|00000340| 6f 6e 22 7d 0a 20 40 7b | 22 20 55 6e 64 65 66 69 |on"}. @{|" Undefi|
|00000350| 6e 69 6e 67 20 22 20 4c | 69 6e 6b 20 22 55 6e 64 |ning " L|ink "Und|
|00000360| 65 66 69 6e 69 6e 67 22 | 7d 0a 20 40 7b 22 20 52 |efining"|}. @{" R|
|00000370| 65 64 65 66 69 6e 69 6e | 67 20 22 20 4c 69 6e 6b |edefinin|g " Link|
|00000380| 20 22 52 65 64 65 66 69 | 6e 69 6e 67 22 7d 0a 20 | "Redefi|ning"}. |
|00000390| 40 7b 22 20 4d 61 63 72 | 6f 20 50 69 74 66 61 6c |@{" Macr|o Pitfal|
|000003a0| 6c 73 20 22 20 4c 69 6e | 6b 20 22 4d 61 63 72 6f |ls " Lin|k "Macro|
|000003b0| 20 50 69 74 66 61 6c 6c | 73 22 7d 0a 20 40 7b 22 | Pitfall|s"}. @{"|
|000003c0| 20 4d 69 73 6e 65 73 74 | 69 6e 67 20 22 20 4c 69 | Misnest|ing " Li|
|000003d0| 6e 6b 20 22 4d 69 73 6e | 65 73 74 69 6e 67 22 7d |nk "Misn|esting"}|
|000003e0| 0a 20 40 7b 22 20 4d 61 | 63 72 6f 20 50 61 72 65 |. @{" Ma|cro Pare|
|000003f0| 6e 74 68 65 73 65 73 20 | 22 20 4c 69 6e 6b 20 22 |ntheses |" Link "|
|00000400| 4d 61 63 72 6f 20 50 61 | 72 65 6e 74 68 65 73 65 |Macro Pa|renthese|
|00000410| 73 22 7d 0a 20 40 7b 22 | 20 53 77 61 6c 6c 6f 77 |s"}. @{"| Swallow|
|00000420| 20 53 65 6d 69 63 6f 6c | 6f 6e 20 22 20 4c 69 6e | Semicol|on " Lin|
|00000430| 6b 20 22 53 77 61 6c 6c | 6f 77 20 53 65 6d 69 63 |k "Swall|ow Semic|
|00000440| 6f 6c 6f 6e 22 7d 0a 20 | 40 7b 22 20 53 69 64 65 |olon"}. |@{" Side|
|00000450| 20 45 66 66 65 63 74 73 | 20 22 20 4c 69 6e 6b 20 | Effects| " Link |
|00000460| 22 53 69 64 65 20 45 66 | 66 65 63 74 73 22 7d 0a |"Side Ef|fects"}.|
|00000470| 20 40 7b 22 20 53 65 6c | 66 2d 52 65 66 65 72 65 | @{" Sel|f-Refere|
|00000480| 6e 63 65 20 22 20 4c 69 | 6e 6b 20 22 53 65 6c 66 |nce " Li|nk "Self|
|00000490| 2d 52 65 66 65 72 65 6e | 63 65 22 7d 0a 20 40 7b |-Referen|ce"}. @{|
|000004a0| 22 20 41 72 67 75 6d 65 | 6e 74 20 50 72 65 73 63 |" Argume|nt Presc|
|000004b0| 61 6e 20 22 20 4c 69 6e | 6b 20 22 41 72 67 75 6d |an " Lin|k "Argum|
|000004c0| 65 6e 74 20 50 72 65 73 | 63 61 6e 22 7d 0a 20 40 |ent Pres|can"}. @|
|000004d0| 7b 22 20 43 61 73 63 61 | 64 65 64 20 4d 61 63 72 |{" Casca|ded Macr|
|000004e0| 6f 73 20 22 20 4c 69 6e | 6b 20 22 43 61 73 63 61 |os " Lin|k "Casca|
|000004f0| 64 65 64 20 4d 61 63 72 | 6f 73 22 7d 0a 20 40 7b |ded Macr|os"}. @{|
|00000500| 22 20 4e 65 77 6c 69 6e | 65 73 20 69 6e 20 41 72 |" Newlin|es in Ar|
|00000510| 67 73 20 22 20 4c 69 6e | 6b 20 22 4e 65 77 6c 69 |gs " Lin|k "Newli|
|00000520| 6e 65 73 20 69 6e 20 41 | 72 67 73 22 7d 0a 20 40 |nes in A|rgs"}. @|
|00000530| 7b 22 20 43 6f 6e 64 69 | 74 69 6f 6e 61 6c 73 20 |{" Condi|tionals |
|00000540| 22 20 4c 69 6e 6b 20 22 | 43 6f 6e 64 69 74 69 6f |" Link "|Conditio|
|00000550| 6e 61 6c 73 22 7d 0a 20 | 40 7b 22 20 43 6f 6e 64 |nals"}. |@{" Cond|
|00000560| 69 74 69 6f 6e 61 6c 20 | 55 73 65 73 20 22 20 4c |itional |Uses " L|
|00000570| 69 6e 6b 20 22 43 6f 6e | 64 69 74 69 6f 6e 61 6c |ink "Con|ditional|
|00000580| 20 55 73 65 73 22 7d 0a | 20 40 7b 22 20 43 6f 6e | Uses"}.| @{" Con|
|00000590| 64 69 74 69 6f 6e 61 6c | 20 53 79 6e 74 61 78 20 |ditional| Syntax |
|000005a0| 22 20 4c 69 6e 6b 20 22 | 43 6f 6e 64 69 74 69 6f |" Link "|Conditio|
|000005b0| 6e 61 6c 20 53 79 6e 74 | 61 78 22 7d 0a 20 40 7b |nal Synt|ax"}. @{|
|000005c0| 22 20 23 69 66 20 43 6f | 6d 6d 61 6e 64 20 22 20 |" #if Co|mmand " |
|000005d0| 4c 69 6e 6b 20 22 23 69 | 66 20 43 6f 6d 6d 61 6e |Link "#i|f Comman|
|000005e0| 64 22 7d 0a 20 40 7b 22 | 20 23 65 6c 73 65 20 43 |d"}. @{"| #else C|
|000005f0| 6f 6d 6d 61 6e 64 20 22 | 20 4c 69 6e 6b 20 22 23 |ommand "| Link "#|
|00000600| 65 6c 73 65 20 43 6f 6d | 6d 61 6e 64 22 7d 0a 20 |else Com|mand"}. |
|00000610| 40 7b 22 20 23 65 6c 69 | 66 20 43 6f 6d 6d 61 6e |@{" #eli|f Comman|
|00000620| 64 20 22 20 4c 69 6e 6b | 20 22 23 65 6c 69 66 20 |d " Link| "#elif |
|00000630| 43 6f 6d 6d 61 6e 64 22 | 7d 0a 20 40 7b 22 20 44 |Command"|}. @{" D|
|00000640| 65 6c 65 74 65 64 20 43 | 6f 64 65 20 22 20 4c 69 |eleted C|ode " Li|
|00000650| 6e 6b 20 22 44 65 6c 65 | 74 65 64 20 43 6f 64 65 |nk "Dele|ted Code|
|00000660| 22 7d 0a 20 40 7b 22 20 | 43 6f 6e 64 69 74 69 6f |"}. @{" |Conditio|
|00000670| 6e 61 6c 73 2d 4d 61 63 | 72 6f 73 20 22 20 4c 69 |nals-Mac|ros " Li|
|00000680| 6e 6b 20 22 43 6f 6e 64 | 69 74 69 6f 6e 61 6c 73 |nk "Cond|itionals|
|00000690| 2d 4d 61 63 72 6f 73 22 | 7d 0a 20 40 7b 22 20 41 |-Macros"|}. @{" A|
|000006a0| 73 73 65 72 74 69 6f 6e | 73 20 22 20 4c 69 6e 6b |ssertion|s " Link|
|000006b0| 20 22 41 73 73 65 72 74 | 69 6f 6e 73 22 7d 0a 20 | "Assert|ions"}. |
|000006c0| 40 7b 22 20 23 65 72 72 | 6f 72 20 43 6f 6d 6d 61 |@{" #err|or Comma|
|000006d0| 6e 64 20 22 20 4c 69 6e | 6b 20 22 23 65 72 72 6f |nd " Lin|k "#erro|
|000006e0| 72 20 43 6f 6d 6d 61 6e | 64 22 7d 0a 20 40 7b 22 |r Comman|d"}. @{"|
|000006f0| 20 43 6f 6d 62 69 6e 69 | 6e 67 20 53 6f 75 72 63 | Combini|ng Sourc|
|00000700| 65 73 20 22 20 4c 69 6e | 6b 20 22 43 6f 6d 62 69 |es " Lin|k "Combi|
|00000710| 6e 69 6e 67 20 53 6f 75 | 72 63 65 73 22 7d 0a 20 |ning Sou|rces"}. |
|00000720| 40 7b 22 20 4f 74 68 65 | 72 20 43 6f 6d 6d 61 6e |@{" Othe|r Comman|
|00000730| 64 73 20 22 20 4c 69 6e | 6b 20 22 4f 74 68 65 72 |ds " Lin|k "Other|
|00000740| 20 43 6f 6d 6d 61 6e 64 | 73 22 7d 0a 20 40 7b 22 | Command|s"}. @{"|
|00000750| 20 4f 75 74 70 75 74 20 | 22 20 4c 69 6e 6b 20 22 | Output |" Link "|
|00000760| 4f 75 74 70 75 74 22 7d | 0a 20 40 7b 22 20 49 6e |Output"}|. @{" In|
|00000770| 76 6f 63 61 74 69 6f 6e | 20 22 20 4c 69 6e 6b 20 |vocation| " Link |
|00000780| 22 49 6e 76 6f 63 61 74 | 69 6f 6e 22 7d 0a 20 40 |"Invocat|ion"}. @|
|00000790| 7b 22 20 43 6f 6e 63 65 | 70 74 20 49 6e 64 65 78 |{" Conce|pt Index|
|000007a0| 20 22 20 4c 69 6e 6b 20 | 22 43 6f 6e 63 65 70 74 | " Link |"Concept|
|000007b0| 20 49 6e 64 65 78 22 7d | 0a 20 40 7b 22 20 49 6e | Index"}|. @{" In|
|000007c0| 64 65 78 20 22 20 4c 69 | 6e 6b 20 22 49 6e 64 65 |dex " Li|nk "Inde|
|000007d0| 78 22 7d 0a 40 45 6e 64 | 4e 6f 64 65 20 22 4d 61 |x"}.@End|Node "Ma|
|000007e0| 69 6e 22 0a 0a 40 4e 6f | 64 65 20 22 54 6f 70 22 |in"..@No|de "Top"|
|000007f0| 20 22 54 6f 70 22 0a 40 | 4e 65 78 74 20 22 47 6c | "Top".@|Next "Gl|
|00000800| 6f 62 61 6c 20 41 63 74 | 69 6f 6e 73 22 20 22 47 |obal Act|ions" "G|
|00000810| 6c 6f 62 61 6c 20 41 63 | 74 69 6f 6e 73 22 0a 40 |lobal Ac|tions".@|
|00000820| 50 72 65 76 20 22 22 20 | 22 22 0a 40 54 6f 63 20 |Prev "" |"".@Toc |
|00000830| 22 22 20 22 22 0a 0a 3e | 3e 20 47 6f 20 42 61 63 |"" ""..>|> Go Bac|
|00000840| 6b 20 74 6f 20 40 7b 22 | 47 63 63 47 75 69 64 65 |k to @{"|GccGuide|
|00000850| 22 20 4c 69 6e 6b 20 22 | 67 63 63 3a 67 63 63 67 |" Link "|gcc:gccg|
|00000860| 75 69 64 65 2f 4d 61 69 | 6e 22 20 30 7d 2e 20 3c |uide/Mai|n" 0}. <|
|00000870| 3c 0a 0a 54 68 65 20 43 | 20 50 72 65 70 72 6f 63 |<..The C| Preproc|
|00000880| 65 73 73 6f 72 0a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |essor.**|********|
|00000890| 2a 2a 2a 2a 2a 2a 2a 2a | 0a 0a 20 20 20 54 68 65 |********|.. The|
|000008a0| 20 43 20 70 72 65 70 72 | 6f 63 65 73 73 6f 72 20 | C prepr|ocessor |
|000008b0| 69 73 20 61 20 22 6d 61 | 63 72 6f 20 70 72 6f 63 |is a "ma|cro proc|
|000008c0| 65 73 73 6f 72 22 20 74 | 68 61 74 20 69 73 20 75 |essor" t|hat is u|
|000008d0| 73 65 64 20 61 75 74 6f | 6d 61 74 69 63 61 6c 6c |sed auto|maticall|
|000008e0| 79 0a 62 79 20 74 68 65 | 20 43 20 63 6f 6d 70 69 |y.by the| C compi|
|000008f0| 6c 65 72 20 74 6f 20 74 | 72 61 6e 73 66 6f 72 6d |ler to t|ransform|
|00000900| 20 79 6f 75 72 20 70 72 | 6f 67 72 61 6d 20 62 65 | your pr|ogram be|
|00000910| 66 6f 72 65 20 61 63 74 | 75 61 6c 20 63 6f 6d 70 |fore act|ual comp|
|00000920| 69 6c 61 74 69 6f 6e 2e | 0a 49 74 20 69 73 20 63 |ilation.|.It is c|
|00000930| 61 6c 6c 65 64 20 61 20 | 6d 61 63 72 6f 20 70 72 |alled a |macro pr|
|00000940| 6f 63 65 73 73 6f 72 20 | 62 65 63 61 75 73 65 20 |ocessor |because |
|00000950| 69 74 20 61 6c 6c 6f 77 | 73 20 79 6f 75 20 74 6f |it allow|s you to|
|00000960| 20 64 65 66 69 6e 65 20 | 22 6d 61 63 72 6f 73 22 | define |"macros"|
|00000970| 2c 0a 77 68 69 63 68 20 | 61 72 65 20 62 72 69 65 |,.which |are brie|
|00000980| 66 20 61 62 62 72 65 76 | 69 61 74 69 6f 6e 73 20 |f abbrev|iations |
|00000990| 66 6f 72 20 6c 6f 6e 67 | 65 72 20 63 6f 6e 73 74 |for long|er const|
|000009a0| 72 75 63 74 73 2e 0a 0a | 20 20 20 54 68 65 20 43 |ructs...| The C|
|000009b0| 20 70 72 65 70 72 6f 63 | 65 73 73 6f 72 20 70 72 | preproc|essor pr|
|000009c0| 6f 76 69 64 65 73 20 66 | 6f 75 72 20 73 65 70 61 |ovides f|our sepa|
|000009d0| 72 61 74 65 20 66 61 63 | 69 6c 69 74 69 65 73 20 |rate fac|ilities |
|000009e0| 74 68 61 74 20 79 6f 75 | 20 63 61 6e 0a 75 73 65 |that you| can.use|
|000009f0| 20 61 73 20 79 6f 75 20 | 73 65 65 20 66 69 74 3a | as you |see fit:|
|00000a00| 0a 0a 20 20 20 2a 20 49 | 6e 63 6c 75 73 69 6f 6e |.. * I|nclusion|
|00000a10| 20 6f 66 20 68 65 61 64 | 65 72 20 66 69 6c 65 73 | of head|er files|
|00000a20| 2e 20 20 54 68 65 73 65 | 20 61 72 65 20 66 69 6c |. These| are fil|
|00000a30| 65 73 20 6f 66 20 64 65 | 63 6c 61 72 61 74 69 6f |es of de|claratio|
|00000a40| 6e 73 20 74 68 61 74 0a | 20 20 20 20 20 63 61 6e |ns that.| can|
|00000a50| 20 62 65 20 73 75 62 73 | 74 69 74 75 74 65 64 20 | be subs|tituted |
|00000a60| 69 6e 74 6f 20 79 6f 75 | 72 20 70 72 6f 67 72 61 |into you|r progra|
|00000a70| 6d 2e 0a 0a 20 20 20 2a | 20 4d 61 63 72 6f 20 65 |m... *| Macro e|
|00000a80| 78 70 61 6e 73 69 6f 6e | 2e 20 20 59 6f 75 20 63 |xpansion|. You c|
|00000a90| 61 6e 20 64 65 66 69 6e | 65 20 22 6d 61 63 72 6f |an defin|e "macro|
|00000aa0| 73 22 2c 20 77 68 69 63 | 68 20 61 72 65 20 61 62 |s", whic|h are ab|
|00000ab0| 62 72 65 76 69 61 74 69 | 6f 6e 73 0a 20 20 20 20 |breviati|ons. |
|00000ac0| 20 66 6f 72 20 61 72 62 | 69 74 72 61 72 79 20 66 | for arb|itrary f|
|00000ad0| 72 61 67 6d 65 6e 74 73 | 20 6f 66 20 43 20 63 6f |ragments| of C co|
|00000ae0| 64 65 2c 20 61 6e 64 20 | 74 68 65 6e 20 74 68 65 |de, and |then the|
|00000af0| 20 43 20 70 72 65 70 72 | 6f 63 65 73 73 6f 72 20 | C prepr|ocessor |
|00000b00| 77 69 6c 6c 0a 20 20 20 | 20 20 72 65 70 6c 61 63 |will. | replac|
|00000b10| 65 20 74 68 65 20 6d 61 | 63 72 6f 73 20 77 69 74 |e the ma|cros wit|
|00000b20| 68 20 74 68 65 69 72 20 | 64 65 66 69 6e 69 74 69 |h their |definiti|
|00000b30| 6f 6e 73 20 74 68 72 6f | 75 67 68 6f 75 74 20 74 |ons thro|ughout t|
|00000b40| 68 65 20 70 72 6f 67 72 | 61 6d 2e 0a 0a 20 20 20 |he progr|am... |
|00000b50| 2a 20 43 6f 6e 64 69 74 | 69 6f 6e 61 6c 20 63 6f |* Condit|ional co|
|00000b60| 6d 70 69 6c 61 74 69 6f | 6e 2e 20 20 55 73 69 6e |mpilatio|n. Usin|
|00000b70| 67 20 73 70 65 63 69 61 | 6c 20 70 72 65 70 72 6f |g specia|l prepro|
|00000b80| 63 65 73 73 6f 72 20 63 | 6f 6d 6d 61 6e 64 73 2c |cessor c|ommands,|
|00000b90| 20 79 6f 75 0a 20 20 20 | 20 20 63 61 6e 20 69 6e | you. | can in|
|00000ba0| 63 6c 75 64 65 20 6f 72 | 20 65 78 63 6c 75 64 65 |clude or| exclude|
|00000bb0| 20 70 61 72 74 73 20 6f | 66 20 74 68 65 20 70 72 | parts o|f the pr|
|00000bc0| 6f 67 72 61 6d 20 61 63 | 63 6f 72 64 69 6e 67 20 |ogram ac|cording |
|00000bd0| 74 6f 20 76 61 72 69 6f | 75 73 0a 20 20 20 20 20 |to vario|us. |
|00000be0| 63 6f 6e 64 69 74 69 6f | 6e 73 2e 0a 0a 20 20 20 |conditio|ns... |
|00000bf0| 2a 20 4c 69 6e 65 20 63 | 6f 6e 74 72 6f 6c 2e 20 |* Line c|ontrol. |
|00000c00| 20 49 66 20 79 6f 75 20 | 75 73 65 20 61 20 70 72 | If you |use a pr|
|00000c10| 6f 67 72 61 6d 20 74 6f | 20 63 6f 6d 62 69 6e 65 |ogram to| combine|
|00000c20| 20 6f 72 20 72 65 61 72 | 72 61 6e 67 65 20 73 6f | or rear|range so|
|00000c30| 75 72 63 65 0a 20 20 20 | 20 20 66 69 6c 65 73 20 |urce. | files |
|00000c40| 69 6e 74 6f 20 61 6e 20 | 69 6e 74 65 72 6d 65 64 |into an |intermed|
|00000c50| 69 61 74 65 20 66 69 6c | 65 20 77 68 69 63 68 20 |iate fil|e which |
|00000c60| 69 73 20 74 68 65 6e 20 | 63 6f 6d 70 69 6c 65 64 |is then |compiled|
|00000c70| 2c 20 79 6f 75 20 63 61 | 6e 0a 20 20 20 20 20 75 |, you ca|n. u|
|00000c80| 73 65 20 6c 69 6e 65 20 | 63 6f 6e 74 72 6f 6c 20 |se line |control |
|00000c90| 74 6f 20 69 6e 66 6f 72 | 6d 20 74 68 65 20 63 6f |to infor|m the co|
|00000ca0| 6d 70 69 6c 65 72 20 6f | 66 20 77 68 65 72 65 20 |mpiler o|f where |
|00000cb0| 65 61 63 68 20 73 6f 75 | 72 63 65 20 6c 69 6e 65 |each sou|rce line|
|00000cc0| 0a 20 20 20 20 20 6f 72 | 69 67 69 6e 61 6c 6c 79 |. or|iginally|
|00000cd0| 20 63 61 6d 65 20 66 72 | 6f 6d 2e 0a 0a 20 20 20 | came fr|om... |
|00000ce0| 43 20 70 72 65 70 72 6f | 63 65 73 73 6f 72 73 20 |C prepro|cessors |
|00000cf0| 76 61 72 79 20 69 6e 20 | 73 6f 6d 65 20 64 65 74 |vary in |some det|
|00000d00| 61 69 6c 73 2e 20 20 54 | 68 69 73 20 6d 61 6e 75 |ails. T|his manu|
|00000d10| 61 6c 20 64 69 73 63 75 | 73 73 65 73 20 74 68 65 |al discu|sses the|
|00000d20| 20 47 4e 55 0a 43 20 70 | 72 65 70 72 6f 63 65 73 | GNU.C p|reproces|
|00000d30| 73 6f 72 2c 20 74 68 65 | 20 43 20 43 6f 6d 70 61 |sor, the| C Compa|
|00000d40| 74 69 62 6c 65 20 43 6f | 6d 70 69 6c 65 72 20 50 |tible Co|mpiler P|
|00000d50| 72 65 70 72 6f 63 65 73 | 73 6f 72 2e 20 20 54 68 |reproces|sor. Th|
|00000d60| 65 20 47 4e 55 20 43 0a | 70 72 65 70 72 6f 63 65 |e GNU C.|preproce|
|00000d70| 73 73 6f 72 20 70 72 6f | 76 69 64 65 73 20 61 20 |ssor pro|vides a |
|00000d80| 73 75 70 65 72 73 65 74 | 20 6f 66 20 74 68 65 20 |superset| of the |
|00000d90| 66 65 61 74 75 72 65 73 | 20 6f 66 20 41 4e 53 49 |features| of ANSI|
|00000da0| 20 53 74 61 6e 64 61 72 | 64 20 43 2e 0a 0a 20 20 | Standar|d C... |
|00000db0| 20 41 4e 53 49 20 53 74 | 61 6e 64 61 72 64 20 43 | ANSI St|andard C|
|00000dc0| 20 72 65 71 75 69 72 65 | 73 20 74 68 65 20 72 65 | require|s the re|
|00000dd0| 6a 65 63 74 69 6f 6e 20 | 6f 66 20 6d 61 6e 79 20 |jection |of many |
|00000de0| 68 61 72 6d 6c 65 73 73 | 20 63 6f 6e 73 74 72 75 |harmless| constru|
|00000df0| 63 74 73 0a 63 6f 6d 6d | 6f 6e 6c 79 20 75 73 65 |cts.comm|only use|
|00000e00| 64 20 62 79 20 74 6f 64 | 61 79 27 73 20 43 20 70 |d by tod|ay's C p|
|00000e10| 72 6f 67 72 61 6d 73 2e | 20 20 53 75 63 68 20 69 |rograms.| Such i|
|00000e20| 6e 63 6f 6d 70 61 74 69 | 62 69 6c 69 74 79 20 77 |ncompati|bility w|
|00000e30| 6f 75 6c 64 20 62 65 0a | 69 6e 63 6f 6e 76 65 6e |ould be.|inconven|
|00000e40| 69 65 6e 74 20 66 6f 72 | 20 75 73 65 72 73 2c 20 |ient for| users, |
|00000e50| 73 6f 20 74 68 65 20 47 | 4e 55 20 43 20 70 72 65 |so the G|NU C pre|
|00000e60| 70 72 6f 63 65 73 73 6f | 72 20 69 73 20 63 6f 6e |processo|r is con|
|00000e70| 66 69 67 75 72 65 64 20 | 74 6f 0a 61 63 63 65 70 |figured |to.accep|
|00000e80| 74 20 74 68 65 73 65 20 | 63 6f 6e 73 74 72 75 63 |t these |construc|
|00000e90| 74 73 20 62 79 20 64 65 | 66 61 75 6c 74 2e 20 20 |ts by de|fault. |
|00000ea0| 53 74 72 69 63 74 6c 79 | 20 73 70 65 61 6b 69 6e |Strictly| speakin|
|00000eb0| 67 2c 20 74 6f 20 67 65 | 74 20 41 4e 53 49 0a 53 |g, to ge|t ANSI.S|
|00000ec0| 74 61 6e 64 61 72 64 20 | 43 2c 20 79 6f 75 20 6d |tandard |C, you m|
|00000ed0| 75 73 74 20 75 73 65 20 | 74 68 65 20 6f 70 74 69 |ust use |the opti|
|00000ee0| 6f 6e 73 20 60 2d 74 72 | 69 67 72 61 70 68 73 27 |ons `-tr|igraphs'|
|00000ef0| 2c 20 60 2d 75 6e 64 65 | 66 27 20 61 6e 64 0a 60 |, `-unde|f' and.`|
|00000f00| 2d 70 65 64 61 6e 74 69 | 63 27 2c 20 62 75 74 20 |-pedanti|c', but |
|00000f10| 69 6e 20 70 72 61 63 74 | 69 63 65 20 74 68 65 20 |in pract|ice the |
|00000f20| 63 6f 6e 73 65 71 75 65 | 6e 63 65 73 20 6f 66 20 |conseque|nces of |
|00000f30| 68 61 76 69 6e 67 20 73 | 74 72 69 63 74 20 41 4e |having s|trict AN|
|00000f40| 53 49 0a 53 74 61 6e 64 | 61 72 64 20 43 20 6d 61 |SI.Stand|ard C ma|
|00000f50| 6b 65 20 69 74 20 75 6e | 64 65 73 69 72 61 62 6c |ke it un|desirabl|
|00000f60| 65 20 74 6f 20 64 6f 20 | 74 68 69 73 2e 20 40 7b |e to do |this. @{|
|00000f70| 22 49 6e 76 6f 63 61 74 | 69 6f 6e 22 20 4c 69 6e |"Invocat|ion" Lin|
|00000f80| 6b 20 22 49 6e 76 6f 63 | 61 74 69 6f 6e 22 7d 20 |k "Invoc|ation"} |
|00000f90| 2e 0a 0a 2a 20 4d 65 6e | 75 3a 0a 0a 2a 20 40 7b |...* Men|u:..* @{|
|00000fa0| 22 47 6c 6f 62 61 6c 20 | 41 63 74 69 6f 6e 73 22 |"Global |Actions"|
|00000fb0| 20 4c 69 6e 6b 20 22 47 | 6c 6f 62 61 6c 20 41 63 | Link "G|lobal Ac|
|00000fc0| 74 69 6f 6e 73 22 7d 20 | 20 20 20 20 41 63 74 69 |tions"} | Acti|
|00000fd0| 6f 6e 73 20 6d 61 64 65 | 20 75 6e 69 66 6f 72 6d |ons made| uniform|
|00000fe0| 6c 79 20 6f 6e 20 61 6c | 6c 20 69 6e 70 75 74 20 |ly on al|l input |
|00000ff0| 66 69 6c 65 73 2e 0a 2a | 20 40 7b 22 43 6f 6d 6d |files..*| @{"Comm|
|00001000| 61 6e 64 73 22 20 4c 69 | 6e 6b 20 22 43 6f 6d 6d |ands" Li|nk "Comm|
|00001010| 61 6e 64 73 22 7d 20 20 | 20 20 20 20 20 20 20 20 |ands"} | |
|00001020| 20 47 65 6e 65 72 61 6c | 20 73 79 6e 74 61 78 20 | General| syntax |
|00001030| 6f 66 20 70 72 65 70 72 | 6f 63 65 73 73 6f 72 20 |of prepr|ocessor |
|00001040| 63 6f 6d 6d 61 6e 64 73 | 2e 0a 2a 20 40 7b 22 48 |commands|..* @{"H|
|00001050| 65 61 64 65 72 20 46 69 | 6c 65 73 22 20 4c 69 6e |eader Fi|les" Lin|
|00001060| 6b 20 22 48 65 61 64 65 | 72 20 46 69 6c 65 73 22 |k "Heade|r Files"|
|00001070| 7d 20 20 20 20 20 20 20 | 48 6f 77 20 61 6e 64 20 |} |How and |
|00001080| 77 68 79 20 74 6f 20 75 | 73 65 20 68 65 61 64 65 |why to u|se heade|
|00001090| 72 20 66 69 6c 65 73 2e | 0a 2a 20 40 7b 22 4d 61 |r files.|.* @{"Ma|
|000010a0| 63 72 6f 73 22 20 4c 69 | 6e 6b 20 22 4d 61 63 72 |cros" Li|nk "Macr|
|000010b0| 6f 73 22 7d 20 20 20 20 | 20 20 20 20 20 20 20 20 |os"} | |
|000010c0| 20 48 6f 77 20 61 6e 64 | 20 77 68 79 20 74 6f 20 | How and| why to |
|000010d0| 75 73 65 20 6d 61 63 72 | 6f 73 2e 0a 2a 20 40 7b |use macr|os..* @{|
|000010e0| 22 43 6f 6e 64 69 74 69 | 6f 6e 61 6c 73 22 20 4c |"Conditi|onals" L|
|000010f0| 69 6e 6b 20 22 43 6f 6e | 64 69 74 69 6f 6e 61 6c |ink "Con|ditional|
|00001100| 73 22 7d 20 20 20 20 20 | 20 20 48 6f 77 20 61 6e |s"} | How an|
|00001110| 64 20 77 68 79 20 74 6f | 20 75 73 65 20 63 6f 6e |d why to| use con|
|00001120| 64 69 74 69 6f 6e 61 6c | 73 2e 0a 2a 20 40 7b 22 |ditional|s..* @{"|
|00001130| 43 6f 6d 62 69 6e 69 6e | 67 20 53 6f 75 72 63 65 |Combinin|g Source|
|00001140| 73 22 20 4c 69 6e 6b 20 | 22 43 6f 6d 62 69 6e 69 |s" Link |"Combini|
|00001150| 6e 67 20 53 6f 75 72 63 | 65 73 22 7d 20 20 55 73 |ng Sourc|es"} Us|
|00001160| 65 20 6f 66 20 6c 69 6e | 65 20 63 6f 6e 74 72 6f |e of lin|e contro|
|00001170| 6c 20 77 68 65 6e 20 79 | 6f 75 20 63 6f 6d 62 69 |l when y|ou combi|
|00001180| 6e 65 20 73 6f 75 72 63 | 65 20 66 69 6c 65 73 2e |ne sourc|e files.|
|00001190| 0a 2a 20 40 7b 22 4f 74 | 68 65 72 20 43 6f 6d 6d |.* @{"Ot|her Comm|
|000011a0| 61 6e 64 73 22 20 4c 69 | 6e 6b 20 22 4f 74 68 65 |ands" Li|nk "Othe|
|000011b0| 72 20 43 6f 6d 6d 61 6e | 64 73 22 7d 20 20 20 20 |r Comman|ds"} |
|000011c0| 20 4d 69 73 63 65 6c 6c | 61 6e 65 6f 75 73 20 70 | Miscell|aneous p|
|000011d0| 72 65 70 72 6f 63 65 73 | 73 6f 72 20 63 6f 6d 6d |reproces|sor comm|
|000011e0| 61 6e 64 73 2e 0a 2a 20 | 40 7b 22 4f 75 74 70 75 |ands..* |@{"Outpu|
|000011f0| 74 22 20 4c 69 6e 6b 20 | 22 4f 75 74 70 75 74 22 |t" Link |"Output"|
|00001200| 7d 20 20 20 20 20 20 20 | 20 20 20 20 20 20 46 6f |} | Fo|
|00001210| 72 6d 61 74 20 6f 66 20 | 6f 75 74 70 75 74 20 66 |rmat of |output f|
|00001220| 72 6f 6d 20 74 68 65 20 | 43 20 70 72 65 70 72 6f |rom the |C prepro|
|00001230| 63 65 73 73 6f 72 2e 0a | 2a 20 40 7b 22 49 6e 76 |cessor..|* @{"Inv|
|00001240| 6f 63 61 74 69 6f 6e 22 | 20 4c 69 6e 6b 20 22 49 |ocation"| Link "I|
|00001250| 6e 76 6f 63 61 74 69 6f | 6e 22 7d 20 20 20 20 20 |nvocatio|n"} |
|00001260| 20 20 20 20 48 6f 77 20 | 74 6f 20 69 6e 76 6f 6b | How |to invok|
|00001270| 65 20 74 68 65 20 70 72 | 65 70 72 6f 63 65 73 73 |e the pr|eprocess|
|00001280| 6f 72 3b 20 63 6f 6d 6d | 61 6e 64 20 6f 70 74 69 |or; comm|and opti|
|00001290| 6f 6e 73 2e 0a 2a 20 40 | 7b 22 43 6f 6e 63 65 70 |ons..* @|{"Concep|
|000012a0| 74 20 49 6e 64 65 78 22 | 20 4c 69 6e 6b 20 22 43 |t Index"| Link "C|
|000012b0| 6f 6e 63 65 70 74 20 49 | 6e 64 65 78 22 7d 20 20 |oncept I|ndex"} |
|000012c0| 20 20 20 20 49 6e 64 65 | 78 20 6f 66 20 63 6f 6e | Inde|x of con|
|000012d0| 63 65 70 74 73 20 61 6e | 64 20 74 65 72 6d 73 2e |cepts an|d terms.|
|000012e0| 0a 2a 20 40 7b 22 49 6e | 64 65 78 22 20 4c 69 6e |.* @{"In|dex" Lin|
|000012f0| 6b 20 22 49 6e 64 65 78 | 22 7d 20 20 20 20 20 20 |k "Index|"} |
|00001300| 20 20 20 20 20 20 20 20 | 49 6e 64 65 78 20 6f 66 | |Index of|
|00001310| 20 63 6f 6d 6d 61 6e 64 | 73 2c 20 70 72 65 64 65 | command|s, prede|
|00001320| 66 69 6e 65 64 20 6d 61 | 63 72 6f 73 20 61 6e 64 |fined ma|cros and|
|00001330| 20 6f 70 74 69 6f 6e 73 | 2e 0a 0a 40 45 6e 64 4e | options|...@EndN|
|00001340| 6f 64 65 0a 0a 0a 40 4e | 6f 64 65 20 22 47 6c 6f |ode...@N|ode "Glo|
|00001350| 62 61 6c 20 41 63 74 69 | 6f 6e 73 22 20 22 47 6c |bal Acti|ons" "Gl|
|00001360| 6f 62 61 6c 20 41 63 74 | 69 6f 6e 73 22 0a 40 4e |obal Act|ions".@N|
|00001370| 65 78 74 20 22 43 6f 6d | 6d 61 6e 64 73 22 20 22 |ext "Com|mands" "|
|00001380| 43 6f 6d 6d 61 6e 64 73 | 22 0a 40 50 72 65 76 20 |Commands|".@Prev |
|00001390| 22 54 6f 70 22 20 22 54 | 6f 70 22 0a 40 54 6f 63 |"Top" "T|op".@Toc|
|000013a0| 20 22 54 6f 70 22 20 22 | 54 6f 70 22 0a 54 72 61 | "Top" "|Top".Tra|
|000013b0| 6e 73 66 6f 72 6d 61 74 | 69 6f 6e 73 20 4d 61 64 |nsformat|ions Mad|
|000013c0| 65 20 47 6c 6f 62 61 6c | 6c 79 0a 3d 3d 3d 3d 3d |e Global|ly.=====|
|000013d0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |========|========|
|000013e0| 3d 3d 3d 3d 3d 3d 3d 3d | 0a 0a 20 20 20 4d 6f 73 |========|.. Mos|
|000013f0| 74 20 43 20 70 72 65 70 | 72 6f 63 65 73 73 6f 72 |t C prep|rocessor|
|00001400| 20 66 65 61 74 75 72 65 | 73 20 61 72 65 20 69 6e | feature|s are in|
|00001410| 61 63 74 69 76 65 20 75 | 6e 6c 65 73 73 20 79 6f |active u|nless yo|
|00001420| 75 20 67 69 76 65 20 73 | 70 65 63 69 66 69 63 0a |u give s|pecific.|
|00001430| 63 6f 6d 6d 61 6e 64 73 | 20 74 6f 20 72 65 71 75 |commands| to requ|
|00001440| 65 73 74 20 74 68 65 69 | 72 20 75 73 65 2e 20 20 |est thei|r use. |
|00001450| 28 50 72 65 70 72 6f 63 | 65 73 73 6f 72 20 63 6f |(Preproc|essor co|
|00001460| 6d 6d 61 6e 64 73 20 61 | 72 65 20 6c 69 6e 65 73 |mmands a|re lines|
|00001470| 0a 73 74 61 72 74 69 6e | 67 20 77 69 74 68 20 60 |.startin|g with `|
|00001480| 23 27 3b 20 40 7b 22 43 | 6f 6d 6d 61 6e 64 73 22 |#'; @{"C|ommands"|
|00001490| 20 4c 69 6e 6b 20 22 43 | 6f 6d 6d 61 6e 64 73 22 | Link "C|ommands"|
|000014a0| 7d 29 2e 20 20 42 75 74 | 20 74 68 65 72 65 20 61 |}). But| there a|
|000014b0| 72 65 20 74 68 72 65 65 | 0a 74 72 61 6e 73 66 6f |re three|.transfo|
|000014c0| 72 6d 61 74 69 6f 6e 73 | 20 74 68 61 74 20 74 68 |rmations| that th|
|000014d0| 65 20 70 72 65 70 72 6f | 63 65 73 73 6f 72 20 61 |e prepro|cessor a|
|000014e0| 6c 77 61 79 73 20 6d 61 | 6b 65 73 20 6f 6e 20 61 |lways ma|kes on a|
|000014f0| 6c 6c 20 74 68 65 20 69 | 6e 70 75 74 20 69 74 0a |ll the i|nput it.|
|00001500| 72 65 63 65 69 76 65 73 | 2c 20 65 76 65 6e 20 69 |receives|, even i|
|00001510| 6e 20 74 68 65 20 61 62 | 73 65 6e 63 65 20 6f 66 |n the ab|sence of|
|00001520| 20 63 6f 6d 6d 61 6e 64 | 73 2e 0a 0a 20 20 20 2a | command|s... *|
|00001530| 20 41 6c 6c 20 43 20 63 | 6f 6d 6d 65 6e 74 73 20 | All C c|omments |
|00001540| 61 72 65 20 72 65 70 6c | 61 63 65 64 20 77 69 74 |are repl|aced wit|
|00001550| 68 20 73 69 6e 67 6c 65 | 20 73 70 61 63 65 73 2e |h single| spaces.|
|00001560| 0a 0a 20 20 20 2a 20 42 | 61 63 6b 73 6c 61 73 68 |.. * B|ackslash|
|00001570| 2d 4e 65 77 6c 69 6e 65 | 20 73 65 71 75 65 6e 63 |-Newline| sequenc|
|00001580| 65 73 20 61 72 65 20 64 | 65 6c 65 74 65 64 2c 20 |es are d|eleted, |
|00001590| 6e 6f 20 6d 61 74 74 65 | 72 20 77 68 65 72 65 2e |no matte|r where.|
|000015a0| 20 20 54 68 69 73 0a 20 | 20 20 20 20 66 65 61 74 | This. | feat|
|000015b0| 75 72 65 20 61 6c 6c 6f | 77 73 20 79 6f 75 20 74 |ure allo|ws you t|
|000015c0| 6f 20 62 72 65 61 6b 20 | 6c 6f 6e 67 20 6c 69 6e |o break |long lin|
|000015d0| 65 73 20 66 6f 72 20 63 | 6f 73 6d 65 74 69 63 20 |es for c|osmetic |
|000015e0| 70 75 72 70 6f 73 65 73 | 0a 20 20 20 20 20 77 69 |purposes|. wi|
|000015f0| 74 68 6f 75 74 20 63 68 | 61 6e 67 69 6e 67 20 74 |thout ch|anging t|
|00001600| 68 65 69 72 20 6d 65 61 | 6e 69 6e 67 2e 0a 0a 20 |heir mea|ning... |
|00001610| 20 20 2a 20 50 72 65 64 | 65 66 69 6e 65 64 20 6d | * Pred|efined m|
|00001620| 61 63 72 6f 20 6e 61 6d | 65 73 20 61 72 65 20 72 |acro nam|es are r|
|00001630| 65 70 6c 61 63 65 64 20 | 77 69 74 68 20 74 68 65 |eplaced |with the|
|00001640| 69 72 20 65 78 70 61 6e | 73 69 6f 6e 73 20 0a 20 |ir expan|sions . |
|00001650| 20 20 20 20 28 40 7b 22 | 50 72 65 64 65 66 69 6e | (@{"|Predefin|
|00001660| 65 64 22 20 4c 69 6e 6b | 20 22 50 72 65 64 65 66 |ed" Link| "Predef|
|00001670| 69 6e 65 64 22 7d 29 2e | 0a 0a 20 20 20 54 68 65 |ined"}).|.. The|
|00001680| 20 66 69 72 73 74 20 74 | 77 6f 20 74 72 61 6e 73 | first t|wo trans|
|00001690| 66 6f 72 6d 61 74 69 6f | 6e 73 20 61 72 65 20 64 |formatio|ns are d|
|000016a0| 6f 6e 65 20 2a 62 65 66 | 6f 72 65 2a 20 6e 65 61 |one *bef|ore* nea|
|000016b0| 72 6c 79 20 61 6c 6c 20 | 6f 74 68 65 72 0a 70 61 |rly all |other.pa|
|000016c0| 72 73 69 6e 67 20 61 6e | 64 20 62 65 66 6f 72 65 |rsing an|d before|
|000016d0| 20 70 72 65 70 72 6f 63 | 65 73 73 6f 72 20 63 6f | preproc|essor co|
|000016e0| 6d 6d 61 6e 64 73 20 61 | 72 65 20 72 65 63 6f 67 |mmands a|re recog|
|000016f0| 6e 69 7a 65 64 2e 20 20 | 54 68 75 73 2c 20 66 6f |nized. |Thus, fo|
|00001700| 72 0a 65 78 61 6d 70 6c | 65 2c 20 79 6f 75 20 63 |r.exampl|e, you c|
|00001710| 61 6e 20 73 70 6c 69 74 | 20 61 20 6c 69 6e 65 20 |an split| a line |
|00001720| 63 6f 73 6d 65 74 69 63 | 61 6c 6c 79 20 77 69 74 |cosmetic|ally wit|
|00001730| 68 20 42 61 63 6b 73 6c | 61 73 68 2d 4e 65 77 6c |h Backsl|ash-Newl|
|00001740| 69 6e 65 0a 61 6e 79 77 | 68 65 72 65 20 28 65 78 |ine.anyw|here (ex|
|00001750| 63 65 70 74 20 77 68 65 | 6e 20 74 72 69 67 72 61 |cept whe|n trigra|
|00001760| 70 68 73 20 61 72 65 20 | 69 6e 20 75 73 65 3b 20 |phs are |in use; |
|00001770| 73 65 65 20 62 65 6c 6f | 77 29 2e 0a 0a 20 20 20 |see belo|w)... |
|00001780| 20 20 2f 2a 0a 20 20 20 | 20 20 2a 2f 20 23 20 2f | /*. | */ # /|
|00001790| 2a 0a 20 20 20 20 20 2a | 2f 20 64 65 66 69 5c 0a |*. *|/ defi\.|
|000017a0| 20 20 20 20 20 6e 65 20 | 46 4f 5c 0a 20 20 20 20 | ne |FO\. |
|000017b0| 20 4f 20 31 30 5c 0a 20 | 20 20 20 20 32 30 0a 0a | O 10\. | 20..|
|000017c0| 69 73 20 65 71 75 69 76 | 61 6c 65 6e 74 20 69 6e |is equiv|alent in|
|000017d0| 74 6f 20 60 23 64 65 66 | 69 6e 65 20 46 4f 4f 20 |to `#def|ine FOO |
|000017e0| 31 30 32 30 27 2e 20 20 | 59 6f 75 20 63 61 6e 20 |1020'. |You can |
|000017f0| 73 70 6c 69 74 20 65 76 | 65 6e 20 61 6e 20 65 73 |split ev|en an es|
|00001800| 63 61 70 65 0a 73 65 71 | 75 65 6e 63 65 20 77 69 |cape.seq|uence wi|
|00001810| 74 68 20 42 61 63 6b 73 | 6c 61 73 68 2d 4e 65 77 |th Backs|lash-New|
|00001820| 6c 69 6e 65 2e 20 20 46 | 6f 72 20 65 78 61 6d 70 |line. F|or examp|
|00001830| 6c 65 2c 20 79 6f 75 20 | 63 61 6e 20 73 70 6c 69 |le, you |can spli|
|00001840| 74 20 60 22 66 6f 6f 5c | 62 61 72 22 27 0a 62 65 |t `"foo\|bar"'.be|
|00001850| 74 77 65 65 6e 20 74 68 | 65 20 60 5c 27 20 61 6e |tween th|e `\' an|
|00001860| 64 20 74 68 65 20 60 62 | 27 20 74 6f 20 67 65 74 |d the `b|' to get|
|00001870| 0a 0a 20 20 20 20 20 22 | 66 6f 6f 5c 5c 0a 20 20 |.. "|foo\\. |
|00001880| 20 20 20 62 61 72 22 0a | 0a 54 68 69 73 20 62 65 | bar".|.This be|
|00001890| 68 61 76 69 6f 72 20 69 | 73 20 75 6e 63 6c 65 61 |havior i|s unclea|
|000018a0| 6e 3a 20 69 6e 20 61 6c | 6c 20 6f 74 68 65 72 20 |n: in al|l other |
|000018b0| 63 6f 6e 74 65 78 74 73 | 2c 20 61 20 42 61 63 6b |contexts|, a Back|
|000018c0| 73 6c 61 73 68 20 63 61 | 6e 20 62 65 0a 69 6e 73 |slash ca|n be.ins|
|000018d0| 65 72 74 65 64 20 69 6e | 20 61 20 73 74 72 69 6e |erted in| a strin|
|000018e0| 67 20 63 6f 6e 73 74 61 | 6e 74 20 61 73 20 61 6e |g consta|nt as an|
|000018f0| 20 6f 72 64 69 6e 61 72 | 79 20 63 68 61 72 61 63 | ordinar|y charac|
|00001900| 74 65 72 20 62 79 20 77 | 72 69 74 69 6e 67 20 61 |ter by w|riting a|
|00001910| 0a 64 6f 75 62 6c 65 20 | 42 61 63 6b 73 6c 61 73 |.double |Backslas|
|00001920| 68 2c 20 61 6e 64 20 74 | 68 69 73 20 63 72 65 61 |h, and t|his crea|
|00001930| 74 65 73 20 61 6e 20 65 | 78 63 65 70 74 69 6f 6e |tes an e|xception|
|00001940| 2e 20 20 42 75 74 20 74 | 68 65 20 41 4e 53 49 20 |. But t|he ANSI |
|00001950| 43 0a 73 74 61 6e 64 61 | 72 64 20 72 65 71 75 69 |C.standa|rd requi|
|00001960| 72 65 73 20 69 74 2e 20 | 20 28 53 74 72 69 63 74 |res it. | (Strict|
|00001970| 20 41 4e 53 49 20 43 20 | 64 6f 65 73 20 6e 6f 74 | ANSI C |does not|
|00001980| 20 61 6c 6c 6f 77 20 4e | 65 77 6c 69 6e 65 73 20 | allow N|ewlines |
|00001990| 69 6e 20 73 74 72 69 6e | 67 0a 63 6f 6e 73 74 61 |in strin|g.consta|
|000019a0| 6e 74 73 2c 20 73 6f 20 | 74 68 65 79 20 64 6f 20 |nts, so |they do |
|000019b0| 6e 6f 74 20 63 6f 6e 73 | 69 64 65 72 20 74 68 69 |not cons|ider thi|
|000019c0| 73 20 61 20 70 72 6f 62 | 6c 65 6d 2e 29 0a 0a 20 |s a prob|lem.).. |
|000019d0| 20 20 42 75 74 20 74 68 | 65 72 65 20 61 72 65 20 | But th|ere are |
|000019e0| 61 20 66 65 77 20 65 78 | 63 65 70 74 69 6f 6e 73 |a few ex|ceptions|
|000019f0| 20 74 6f 20 61 6c 6c 20 | 74 68 72 65 65 20 74 72 | to all |three tr|
|00001a00| 61 6e 73 66 6f 72 6d 61 | 74 69 6f 6e 73 2e 0a 0a |ansforma|tions...|
|00001a10| 20 20 20 2a 20 43 20 63 | 6f 6d 6d 65 6e 74 73 20 | * C c|omments |
|00001a20| 61 6e 64 20 70 72 65 64 | 65 66 69 6e 65 64 20 6d |and pred|efined m|
|00001a30| 61 63 72 6f 20 6e 61 6d | 65 73 20 61 72 65 20 6e |acro nam|es are n|
|00001a40| 6f 74 20 72 65 63 6f 67 | 6e 69 7a 65 64 20 69 6e |ot recog|nized in|
|00001a50| 73 69 64 65 20 61 0a 20 | 20 20 20 20 60 23 69 6e |side a. | `#in|
|00001a60| 63 6c 75 64 65 27 20 63 | 6f 6d 6d 61 6e 64 20 69 |clude' c|ommand i|
|00001a70| 6e 20 77 68 69 63 68 20 | 74 68 65 20 66 69 6c 65 |n which |the file|
|00001a80| 20 6e 61 6d 65 20 69 73 | 20 64 65 6c 69 6d 69 74 | name is| delimit|
|00001a90| 65 64 20 77 69 74 68 20 | 60 3c 27 0a 20 20 20 20 |ed with |`<'. |
|00001aa0| 20 61 6e 64 20 60 3e 27 | 2e 0a 0a 20 20 20 2a 20 | and `>'|... * |
|00001ab0| 43 20 63 6f 6d 6d 65 6e | 74 73 20 61 6e 64 20 70 |C commen|ts and p|
|00001ac0| 72 65 64 65 66 69 6e 65 | 64 20 6d 61 63 72 6f 20 |redefine|d macro |
|00001ad0| 6e 61 6d 65 73 20 61 72 | 65 20 6e 65 76 65 72 20 |names ar|e never |
|00001ae0| 72 65 63 6f 67 6e 69 7a | 65 64 20 77 69 74 68 69 |recogniz|ed withi|
|00001af0| 6e 20 61 0a 20 20 20 20 | 20 63 68 61 72 61 63 74 |n a. | charact|
|00001b00| 65 72 20 6f 72 20 73 74 | 72 69 6e 67 20 63 6f 6e |er or st|ring con|
|00001b10| 73 74 61 6e 74 2e 20 20 | 28 53 74 72 69 63 74 6c |stant. |(Strictl|
|00001b20| 79 20 73 70 65 61 6b 69 | 6e 67 2c 20 74 68 69 73 |y speaki|ng, this|
|00001b30| 20 69 73 20 74 68 65 0a | 20 20 20 20 20 72 75 6c | is the.| rul|
|00001b40| 65 2c 20 6e 6f 74 20 61 | 6e 20 65 78 63 65 70 74 |e, not a|n except|
|00001b50| 69 6f 6e 2c 20 62 75 74 | 20 69 74 20 69 73 20 77 |ion, but| it is w|
|00001b60| 6f 72 74 68 20 6e 6f 74 | 69 6e 67 20 68 65 72 65 |orth not|ing here|
|00001b70| 20 61 6e 79 77 61 79 2e | 29 0a 0a 20 20 20 2a 20 | anyway.|).. * |
|00001b80| 42 61 63 6b 73 6c 61 73 | 68 2d 4e 65 77 6c 69 6e |Backslas|h-Newlin|
|00001b90| 65 20 6d 61 79 20 6e 6f | 74 20 73 61 66 65 6c 79 |e may no|t safely|
|00001ba0| 20 62 65 20 75 73 65 64 | 20 77 69 74 68 69 6e 20 | be used| within |
|00001bb0| 61 6e 20 41 4e 53 49 20 | 22 74 72 69 67 72 61 70 |an ANSI |"trigrap|
|00001bc0| 68 22 2e 0a 20 20 20 20 | 20 54 72 69 67 72 61 70 |h".. | Trigrap|
|00001bd0| 68 73 20 61 72 65 20 63 | 6f 6e 76 65 72 74 65 64 |hs are c|onverted|
|00001be0| 20 62 65 66 6f 72 65 20 | 42 61 63 6b 73 6c 61 73 | before |Backslas|
|00001bf0| 68 2d 4e 65 77 6c 69 6e | 65 20 69 73 20 64 65 6c |h-Newlin|e is del|
|00001c00| 65 74 65 64 2e 20 20 49 | 66 0a 20 20 20 20 20 79 |eted. I|f. y|
|00001c10| 6f 75 20 77 72 69 74 65 | 20 77 68 61 74 20 6c 6f |ou write| what lo|
|00001c20| 6f 6b 73 20 6c 69 6b 65 | 20 61 20 74 72 69 67 72 |oks like| a trigr|
|00001c30| 61 70 68 20 77 69 74 68 | 20 61 20 42 61 63 6b 73 |aph with| a Backs|
|00001c40| 6c 61 73 68 2d 4e 65 77 | 6c 69 6e 65 0a 20 20 20 |lash-New|line. |
|00001c50| 20 20 69 6e 73 69 64 65 | 2c 20 74 68 65 20 42 61 | inside|, the Ba|
|00001c60| 63 6b 73 6c 61 73 68 2d | 4e 65 77 6c 69 6e 65 20 |ckslash-|Newline |
|00001c70| 69 73 20 64 65 6c 65 74 | 65 64 20 61 73 20 75 73 |is delet|ed as us|
|00001c80| 75 61 6c 2c 20 62 75 74 | 20 69 74 20 69 73 20 74 |ual, but| it is t|
|00001c90| 68 65 6e 0a 20 20 20 20 | 20 74 6f 6f 20 6c 61 74 |hen. | too lat|
|00001ca0| 65 20 74 6f 20 72 65 63 | 6f 67 6e 69 7a 65 20 74 |e to rec|ognize t|
|00001cb0| 68 65 20 74 72 69 67 72 | 61 70 68 2e 0a 0a 20 20 |he trigr|aph... |
|00001cc0| 20 20 20 54 68 69 73 20 | 65 78 63 65 70 74 69 6f | This |exceptio|
|00001cd0| 6e 20 69 73 20 72 65 6c | 65 76 61 6e 74 20 6f 6e |n is rel|evant on|
|00001ce0| 6c 79 20 69 66 20 79 6f | 75 20 75 73 65 20 74 68 |ly if yo|u use th|
|00001cf0| 65 20 60 2d 74 72 69 67 | 72 61 70 68 73 27 20 6f |e `-trig|raphs' o|
|00001d00| 70 74 69 6f 6e 0a 20 20 | 20 20 20 74 6f 20 65 6e |ption. | to en|
|00001d10| 61 62 6c 65 20 74 72 69 | 67 72 61 70 68 20 70 72 |able tri|graph pr|
|00001d20| 6f 63 65 73 73 69 6e 67 | 2e 20 20 40 7b 22 49 6e |ocessing|. @{"In|
|00001d30| 76 6f 63 61 74 69 6f 6e | 22 20 4c 69 6e 6b 20 22 |vocation|" Link "|
|00001d40| 49 6e 76 6f 63 61 74 69 | 6f 6e 22 7d 20 0a 0a 40 |Invocati|on"} ..@|
|00001d50| 45 6e 64 4e 6f 64 65 0a | 0a 0a 40 4e 6f 64 65 20 |EndNode.|..@Node |
|00001d60| 22 43 6f 6d 6d 61 6e 64 | 73 22 20 22 43 6f 6d 6d |"Command|s" "Comm|
|00001d70| 61 6e 64 73 22 0a 40 4e | 65 78 74 20 22 48 65 61 |ands".@N|ext "Hea|
|00001d80| 64 65 72 20 46 69 6c 65 | 73 22 20 22 48 65 61 64 |der File|s" "Head|
|00001d90| 65 72 20 46 69 6c 65 73 | 22 0a 40 50 72 65 76 20 |er Files|".@Prev |
|00001da0| 22 47 6c 6f 62 61 6c 20 | 41 63 74 69 6f 6e 73 22 |"Global |Actions"|
|00001db0| 20 22 47 6c 6f 62 61 6c | 20 41 63 74 69 6f 6e 73 | "Global| Actions|
|00001dc0| 22 0a 40 54 6f 63 20 22 | 54 6f 70 22 20 22 54 6f |".@Toc "|Top" "To|
|00001dd0| 70 22 0a 50 72 65 70 72 | 6f 63 65 73 73 6f 72 20 |p".Prepr|ocessor |
|00001de0| 43 6f 6d 6d 61 6e 64 73 | 0a 3d 3d 3d 3d 3d 3d 3d |Commands|.=======|
|00001df0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 0a 0a |========|======..|
|00001e00| 20 20 20 4d 6f 73 74 20 | 70 72 65 70 72 6f 63 65 | Most |preproce|
|00001e10| 73 73 6f 72 20 66 65 61 | 74 75 72 65 73 20 61 72 |ssor fea|tures ar|
|00001e20| 65 20 61 63 74 69 76 65 | 20 6f 6e 6c 79 20 69 66 |e active| only if|
|00001e30| 20 79 6f 75 20 75 73 65 | 20 70 72 65 70 72 6f 63 | you use| preproc|
|00001e40| 65 73 73 6f 72 0a 63 6f | 6d 6d 61 6e 64 73 20 74 |essor.co|mmands t|
|00001e50| 6f 20 72 65 71 75 65 73 | 74 20 74 68 65 69 72 20 |o reques|t their |
|00001e60| 75 73 65 2e 0a 0a 20 20 | 20 50 72 65 70 72 6f 63 |use... | Preproc|
|00001e70| 65 73 73 6f 72 20 63 6f | 6d 6d 61 6e 64 73 20 61 |essor co|mmands a|
|00001e80| 72 65 20 6c 69 6e 65 73 | 20 69 6e 20 79 6f 75 72 |re lines| in your|
|00001e90| 20 70 72 6f 67 72 61 6d | 20 74 68 61 74 20 73 74 | program| that st|
|00001ea0| 61 72 74 20 77 69 74 68 | 20 60 23 27 2e 0a 54 68 |art with| `#'..Th|
|00001eb0| 65 20 60 23 27 20 69 73 | 20 66 6f 6c 6c 6f 77 65 |e `#' is| followe|
|00001ec0| 64 20 62 79 20 61 6e 20 | 69 64 65 6e 74 69 66 69 |d by an |identifi|
|00001ed0| 65 72 20 74 68 61 74 20 | 69 73 20 74 68 65 20 22 |er that |is the "|
|00001ee0| 63 6f 6d 6d 61 6e 64 20 | 6e 61 6d 65 22 2e 20 20 |command |name". |
|00001ef0| 46 6f 72 0a 65 78 61 6d | 70 6c 65 2c 20 60 23 64 |For.exam|ple, `#d|
|00001f00| 65 66 69 6e 65 27 20 69 | 73 20 74 68 65 20 63 6f |efine' i|s the co|
|00001f10| 6d 6d 61 6e 64 20 74 68 | 61 74 20 64 65 66 69 6e |mmand th|at defin|
|00001f20| 65 73 20 61 20 6d 61 63 | 72 6f 2e 20 20 57 68 69 |es a mac|ro. Whi|
|00001f30| 74 65 73 70 61 63 65 20 | 69 73 0a 61 6c 73 6f 20 |tespace |is.also |
|00001f40| 61 6c 6c 6f 77 65 64 20 | 62 65 66 6f 72 65 20 61 |allowed |before a|
|00001f50| 6e 64 20 61 66 74 65 72 | 20 74 68 65 20 60 23 27 |nd after| the `#'|
|00001f60| 2e 0a 0a 20 20 20 54 68 | 65 20 73 65 74 20 6f 66 |... Th|e set of|
|00001f70| 20 76 61 6c 69 64 20 63 | 6f 6d 6d 61 6e 64 20 6e | valid c|ommand n|
|00001f80| 61 6d 65 73 20 69 73 20 | 66 69 78 65 64 2e 20 20 |ames is |fixed. |
|00001f90| 50 72 6f 67 72 61 6d 73 | 20 63 61 6e 6e 6f 74 20 |Programs| cannot |
|00001fa0| 64 65 66 69 6e 65 20 6e | 65 77 0a 70 72 65 70 72 |define n|ew.prepr|
|00001fb0| 6f 63 65 73 73 6f 72 20 | 63 6f 6d 6d 61 6e 64 73 |ocessor |commands|
|00001fc0| 2e 0a 0a 20 20 20 53 6f | 6d 65 20 63 6f 6d 6d 61 |... So|me comma|
|00001fd0| 6e 64 20 6e 61 6d 65 73 | 20 72 65 71 75 69 72 65 |nd names| require|
|00001fe0| 20 61 72 67 75 6d 65 6e | 74 73 3b 20 74 68 65 73 | argumen|ts; thes|
|00001ff0| 65 20 6d 61 6b 65 20 75 | 70 20 74 68 65 20 72 65 |e make u|p the re|
|00002000| 73 74 20 6f 66 20 74 68 | 65 0a 63 6f 6d 6d 61 6e |st of th|e.comman|
|00002010| 64 20 6c 69 6e 65 20 61 | 6e 64 20 6d 75 73 74 20 |d line a|nd must |
|00002020| 62 65 20 73 65 70 61 72 | 61 74 65 64 20 66 72 6f |be separ|ated fro|
|00002030| 6d 20 74 68 65 20 63 6f | 6d 6d 61 6e 64 20 6e 61 |m the co|mmand na|
|00002040| 6d 65 20 62 79 20 77 68 | 69 74 65 73 70 61 63 65 |me by wh|itespace|
|00002050| 2e 0a 46 6f 72 20 65 78 | 61 6d 70 6c 65 2c 20 60 |..For ex|ample, `|
|00002060| 23 64 65 66 69 6e 65 27 | 20 6d 75 73 74 20 62 65 |#define'| must be|
|00002070| 20 66 6f 6c 6c 6f 77 65 | 64 20 62 79 20 61 20 6d | followe|d by a m|
|00002080| 61 63 72 6f 20 6e 61 6d | 65 20 61 6e 64 20 74 68 |acro nam|e and th|
|00002090| 65 0a 69 6e 74 65 6e 64 | 65 64 20 65 78 70 61 6e |e.intend|ed expan|
|000020a0| 73 69 6f 6e 20 6f 66 20 | 74 68 65 20 6d 61 63 72 |sion of |the macr|
|000020b0| 6f 2e 0a 0a 20 20 20 41 | 20 70 72 65 70 72 6f 63 |o... A| preproc|
|000020c0| 65 73 73 6f 72 20 63 6f | 6d 6d 61 6e 64 20 63 61 |essor co|mmand ca|
|000020d0| 6e 6e 6f 74 20 62 65 20 | 6d 6f 72 65 20 74 68 61 |nnot be |more tha|
|000020e0| 6e 20 6f 6e 65 20 6c 69 | 6e 65 20 69 6e 20 6e 6f |n one li|ne in no|
|000020f0| 72 6d 61 6c 0a 63 69 72 | 63 75 6d 73 74 61 6e 63 |rmal.cir|cumstanc|
|00002100| 65 73 2e 20 20 49 74 20 | 6d 61 79 20 62 65 20 73 |es. It |may be s|
|00002110| 70 6c 69 74 20 63 6f 73 | 6d 65 74 69 63 61 6c 6c |plit cos|meticall|
|00002120| 79 20 77 69 74 68 20 42 | 61 63 6b 73 6c 61 73 68 |y with B|ackslash|
|00002130| 2d 4e 65 77 6c 69 6e 65 | 2c 0a 62 75 74 20 74 68 |-Newline|,.but th|
|00002140| 61 74 20 68 61 73 20 6e | 6f 20 65 66 66 65 63 74 |at has n|o effect|
|00002150| 20 6f 6e 20 69 74 73 20 | 6d 65 61 6e 69 6e 67 2e | on its |meaning.|
|00002160| 20 20 43 6f 6d 6d 65 6e | 74 73 20 63 6f 6e 74 61 | Commen|ts conta|
|00002170| 69 6e 69 6e 67 20 4e 65 | 77 6c 69 6e 65 73 0a 63 |ining Ne|wlines.c|
|00002180| 61 6e 20 61 6c 73 6f 20 | 64 69 76 69 64 65 20 74 |an also |divide t|
|00002190| 68 65 20 63 6f 6d 6d 61 | 6e 64 20 69 6e 74 6f 20 |he comma|nd into |
|000021a0| 6d 75 6c 74 69 70 6c 65 | 20 6c 69 6e 65 73 2c 20 |multiple| lines, |
|000021b0| 62 75 74 20 74 68 65 20 | 63 6f 6d 6d 65 6e 74 73 |but the |comments|
|000021c0| 20 61 72 65 0a 63 68 61 | 6e 67 65 64 20 74 6f 20 | are.cha|nged to |
|000021d0| 53 70 61 63 65 73 20 62 | 65 66 6f 72 65 20 74 68 |Spaces b|efore th|
|000021e0| 65 20 63 6f 6d 6d 61 6e | 64 20 69 73 20 69 6e 74 |e comman|d is int|
|000021f0| 65 72 70 72 65 74 65 64 | 2e 20 20 54 68 65 20 6f |erpreted|. The o|
|00002200| 6e 6c 79 20 77 61 79 20 | 61 0a 73 69 67 6e 69 66 |nly way |a.signif|
|00002210| 69 63 61 6e 74 20 4e 65 | 77 6c 69 6e 65 20 63 61 |icant Ne|wline ca|
|00002220| 6e 20 6f 63 63 75 72 20 | 69 6e 20 61 20 70 72 65 |n occur |in a pre|
|00002230| 70 72 6f 63 65 73 73 6f | 72 20 63 6f 6d 6d 61 6e |processo|r comman|
|00002240| 64 20 69 73 20 77 69 74 | 68 69 6e 20 61 0a 73 74 |d is wit|hin a.st|
|00002250| 72 69 6e 67 20 63 6f 6e | 73 74 61 6e 74 20 6f 72 |ring con|stant or|
|00002260| 20 63 68 61 72 61 63 74 | 65 72 20 63 6f 6e 73 74 | charact|er const|
|00002270| 61 6e 74 2e 20 20 4e 6f | 74 65 20 74 68 61 74 20 |ant. No|te that |
|00002280| 6d 6f 73 74 20 43 20 63 | 6f 6d 70 69 6c 65 72 73 |most C c|ompilers|
|00002290| 20 74 68 61 74 0a 6d 69 | 67 68 74 20 62 65 20 61 | that.mi|ght be a|
|000022a0| 70 70 6c 69 65 64 20 74 | 6f 20 74 68 65 20 6f 75 |pplied t|o the ou|
|000022b0| 74 70 75 74 20 66 72 6f | 6d 20 74 68 65 20 70 72 |tput fro|m the pr|
|000022c0| 65 70 72 6f 63 65 73 73 | 6f 72 20 64 6f 20 6e 6f |eprocess|or do no|
|000022d0| 74 20 61 63 63 65 70 74 | 0a 73 74 72 69 6e 67 20 |t accept|.string |
|000022e0| 6f 72 20 63 68 61 72 61 | 63 74 65 72 20 63 6f 6e |or chara|cter con|
|000022f0| 73 74 61 6e 74 73 20 63 | 6f 6e 74 61 69 6e 69 6e |stants c|ontainin|
|00002300| 67 20 4e 65 77 6c 69 6e | 65 73 2e 0a 0a 20 20 20 |g Newlin|es... |
|00002310| 54 68 65 20 60 23 27 20 | 61 6e 64 20 74 68 65 20 |The `#' |and the |
|00002320| 63 6f 6d 6d 61 6e 64 20 | 6e 61 6d 65 20 63 61 6e |command |name can|
|00002330| 6e 6f 74 20 63 6f 6d 65 | 20 66 72 6f 6d 20 61 20 |not come| from a |
|00002340| 6d 61 63 72 6f 20 65 78 | 70 61 6e 73 69 6f 6e 2e |macro ex|pansion.|
|00002350| 20 20 46 6f 72 0a 65 78 | 61 6d 70 6c 65 2c 20 69 | For.ex|ample, i|
|00002360| 66 20 60 66 6f 6f 27 20 | 69 73 20 64 65 66 69 6e |f `foo' |is defin|
|00002370| 65 64 20 61 73 20 61 20 | 6d 61 63 72 6f 20 65 78 |ed as a |macro ex|
|00002380| 70 61 6e 64 69 6e 67 20 | 74 6f 20 60 64 65 66 69 |panding |to `defi|
|00002390| 6e 65 27 2c 20 74 68 61 | 74 0a 64 6f 65 73 20 6e |ne', tha|t.does n|
|000023a0| 6f 74 20 6d 61 6b 65 20 | 60 23 66 6f 6f 27 20 61 |ot make |`#foo' a|
|000023b0| 20 76 61 6c 69 64 20 70 | 72 65 70 72 6f 63 65 73 | valid p|reproces|
|000023c0| 73 6f 72 20 63 6f 6d 6d | 61 6e 64 2e 0a 0a 40 45 |sor comm|and...@E|
|000023d0| 6e 64 4e 6f 64 65 0a 0a | 0a 40 4e 6f 64 65 20 22 |ndNode..|.@Node "|
|000023e0| 48 65 61 64 65 72 20 46 | 69 6c 65 73 22 20 22 48 |Header F|iles" "H|
|000023f0| 65 61 64 65 72 20 46 69 | 6c 65 73 22 0a 40 4e 65 |eader Fi|les".@Ne|
|00002400| 78 74 20 22 4d 61 63 72 | 6f 73 22 20 22 4d 61 63 |xt "Macr|os" "Mac|
|00002410| 72 6f 73 22 0a 40 50 72 | 65 76 20 22 43 6f 6d 6d |ros".@Pr|ev "Comm|
|00002420| 61 6e 64 73 22 20 22 43 | 6f 6d 6d 61 6e 64 73 22 |ands" "C|ommands"|
|00002430| 0a 40 54 6f 63 20 22 54 | 6f 70 22 20 22 54 6f 70 |.@Toc "T|op" "Top|
|00002440| 22 0a 48 65 61 64 65 72 | 20 46 69 6c 65 73 0a 3d |".Header| Files.=|
|00002450| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 0a 0a 20 20 20 |========|===.. |
|00002460| 41 20 68 65 61 64 65 72 | 20 66 69 6c 65 20 69 73 |A header| file is|
|00002470| 20 61 20 66 69 6c 65 20 | 63 6f 6e 74 61 69 6e 69 | a file |containi|
|00002480| 6e 67 20 43 20 64 65 63 | 6c 61 72 61 74 69 6f 6e |ng C dec|laration|
|00002490| 73 20 61 6e 64 20 6d 61 | 63 72 6f 0a 64 65 66 69 |s and ma|cro.defi|
|000024a0| 6e 69 74 69 6f 6e 73 20 | 28 40 7b 22 4d 61 63 72 |nitions |(@{"Macr|
|000024b0| 6f 73 22 20 4c 69 6e 6b | 20 22 4d 61 63 72 6f 73 |os" Link| "Macros|
|000024c0| 22 7d 29 20 74 6f 20 62 | 65 20 73 68 61 72 65 64 |"}) to b|e shared|
|000024d0| 20 62 65 74 77 65 65 6e | 20 73 65 76 65 72 61 6c | between| several|
|000024e0| 20 73 6f 75 72 63 65 0a | 66 69 6c 65 73 2e 20 20 | source.|files. |
|000024f0| 59 6f 75 20 72 65 71 75 | 65 73 74 20 74 68 65 20 |You requ|est the |
|00002500| 75 73 65 20 6f 66 20 61 | 20 68 65 61 64 65 72 20 |use of a| header |
|00002510| 66 69 6c 65 20 69 6e 20 | 79 6f 75 72 20 70 72 6f |file in |your pro|
|00002520| 67 72 61 6d 20 77 69 74 | 68 20 74 68 65 20 43 0a |gram wit|h the C.|
|00002530| 70 72 65 70 72 6f 63 65 | 73 73 6f 72 20 63 6f 6d |preproce|ssor com|
|00002540| 6d 61 6e 64 20 60 23 69 | 6e 63 6c 75 64 65 27 2e |mand `#i|nclude'.|
|00002550| 0a 0a 2a 20 4d 65 6e 75 | 3a 0a 0a 2a 20 40 7b 22 |..* Menu|:..* @{"|
|00002560| 48 65 61 64 65 72 20 55 | 73 65 73 22 20 4c 69 6e |Header U|ses" Lin|
|00002570| 6b 20 22 48 65 61 64 65 | 72 20 55 73 65 73 22 7d |k "Heade|r Uses"}|
|00002580| 20 20 20 20 20 20 20 20 | 20 20 57 68 61 74 20 68 | | What h|
|00002590| 65 61 64 65 72 20 66 69 | 6c 65 73 20 61 72 65 20 |eader fi|les are |
|000025a0| 75 73 65 64 20 66 6f 72 | 2e 0a 2a 20 40 7b 22 49 |used for|..* @{"I|
|000025b0| 6e 63 6c 75 64 65 20 53 | 79 6e 74 61 78 22 20 4c |nclude S|yntax" L|
|000025c0| 69 6e 6b 20 22 49 6e 63 | 6c 75 64 65 20 53 79 6e |ink "Inc|lude Syn|
|000025d0| 74 61 78 22 7d 20 20 20 | 20 20 20 20 48 6f 77 20 |tax"} | How |
|000025e0| 74 6f 20 77 72 69 74 65 | 20 60 23 69 6e 63 6c 75 |to write| `#inclu|
|000025f0| 64 65 27 20 63 6f 6d 6d | 61 6e 64 73 2e 0a 2a 20 |de' comm|ands..* |
|00002600| 40 7b 22 49 6e 63 6c 75 | 64 65 20 4f 70 65 72 61 |@{"Inclu|de Opera|
|00002610| 74 69 6f 6e 22 20 4c 69 | 6e 6b 20 22 49 6e 63 6c |tion" Li|nk "Incl|
|00002620| 75 64 65 20 4f 70 65 72 | 61 74 69 6f 6e 22 7d 20 |ude Oper|ation"} |
|00002630| 20 20 20 57 68 61 74 20 | 60 23 69 6e 63 6c 75 64 | What |`#includ|
|00002640| 65 27 20 64 6f 65 73 2e | 0a 2a 20 40 7b 22 4f 6e |e' does.|.* @{"On|
|00002650| 63 65 2d 4f 6e 6c 79 22 | 20 4c 69 6e 6b 20 22 4f |ce-Only"| Link "O|
|00002660| 6e 63 65 2d 4f 6e 6c 79 | 22 7d 20 09 09 50 72 65 |nce-Only|"} ..Pre|
|00002670| 76 65 6e 74 69 6e 67 20 | 6d 75 6c 74 69 70 6c 65 |venting |multiple|
|00002680| 20 69 6e 63 6c 75 73 69 | 6f 6e 20 6f 66 20 6f 6e | inclusi|on of on|
|00002690| 65 20 68 65 61 64 65 72 | 20 66 69 6c 65 2e 0a 2a |e header| file..*|
|000026a0| 20 40 7b 22 49 6e 68 65 | 72 69 74 61 6e 63 65 22 | @{"Inhe|ritance"|
|000026b0| 20 4c 69 6e 6b 20 22 49 | 6e 68 65 72 69 74 61 6e | Link "I|nheritan|
|000026c0| 63 65 22 7d 20 20 20 20 | 20 20 20 20 20 20 49 6e |ce"} | In|
|000026d0| 63 6c 75 64 69 6e 67 20 | 6f 6e 65 20 68 65 61 64 |cluding |one head|
|000026e0| 65 72 20 66 69 6c 65 20 | 69 6e 20 61 6e 6f 74 68 |er file |in anoth|
|000026f0| 65 72 20 68 65 61 64 65 | 72 20 66 69 6c 65 2e 0a |er heade|r file..|
|00002700| 0a 40 45 6e 64 4e 6f 64 | 65 0a 0a 0a 40 4e 6f 64 |.@EndNod|e...@Nod|
|00002710| 65 20 22 48 65 61 64 65 | 72 20 55 73 65 73 22 20 |e "Heade|r Uses" |
|00002720| 22 48 65 61 64 65 72 20 | 55 73 65 73 22 0a 40 4e |"Header |Uses".@N|
|00002730| 65 78 74 20 22 49 6e 63 | 6c 75 64 65 20 53 79 6e |ext "Inc|lude Syn|
|00002740| 74 61 78 22 20 22 49 6e | 63 6c 75 64 65 20 53 79 |tax" "In|clude Sy|
|00002750| 6e 74 61 78 22 0a 40 50 | 72 65 76 20 22 48 65 61 |ntax".@P|rev "Hea|
|00002760| 64 65 72 20 46 69 6c 65 | 73 22 20 22 48 65 61 64 |der File|s" "Head|
|00002770| 65 72 20 46 69 6c 65 73 | 22 0a 40 54 6f 63 20 22 |er Files|".@Toc "|
|00002780| 48 65 61 64 65 72 20 46 | 69 6c 65 73 22 20 22 48 |Header F|iles" "H|
|00002790| 65 61 64 65 72 20 46 69 | 6c 65 73 22 0a 55 73 65 |eader Fi|les".Use|
|000027a0| 73 20 6f 66 20 48 65 61 | 64 65 72 20 46 69 6c 65 |s of Hea|der File|
|000027b0| 73 0a 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |s.------|--------|
|000027c0| 2d 2d 2d 2d 2d 2d 0a 0a | 20 20 20 48 65 61 64 65 |------..| Heade|
|000027d0| 72 20 66 69 6c 65 73 20 | 73 65 72 76 65 20 74 77 |r files |serve tw|
|000027e0| 6f 20 6b 69 6e 64 73 20 | 6f 66 20 70 75 72 70 6f |o kinds |of purpo|
|000027f0| 73 65 73 2e 0a 0a 20 20 | 20 2a 20 53 79 73 74 65 |ses... | * Syste|
|00002800| 6d 20 68 65 61 64 65 72 | 20 66 69 6c 65 73 20 64 |m header| files d|
|00002810| 65 63 6c 61 72 65 20 74 | 68 65 20 69 6e 74 65 72 |eclare t|he inter|
|00002820| 66 61 63 65 73 20 74 6f | 20 70 61 72 74 73 20 6f |faces to| parts o|
|00002830| 66 20 74 68 65 0a 20 20 | 20 20 20 6f 70 65 72 61 |f the. | opera|
|00002840| 74 69 6e 67 20 73 79 73 | 74 65 6d 2e 20 20 59 6f |ting sys|tem. Yo|
|00002850| 75 20 69 6e 63 6c 75 64 | 65 20 74 68 65 6d 20 69 |u includ|e them i|
|00002860| 6e 20 79 6f 75 72 20 70 | 72 6f 67 72 61 6d 20 74 |n your p|rogram t|
|00002870| 6f 20 73 75 70 70 6c 79 | 20 74 68 65 0a 20 20 20 |o supply| the. |
|00002880| 20 20 64 65 66 69 6e 69 | 74 69 6f 6e 73 20 61 6e | defini|tions an|
|00002890| 64 20 64 65 63 6c 61 72 | 61 74 69 6f 6e 73 20 79 |d declar|ations y|
|000028a0| 6f 75 20 6e 65 65 64 20 | 74 6f 20 69 6e 76 6f 6b |ou need |to invok|
|000028b0| 65 20 73 79 73 74 65 6d | 20 63 61 6c 6c 73 20 61 |e system| calls a|
|000028c0| 6e 64 0a 20 20 20 20 20 | 6c 69 62 72 61 72 69 65 |nd. |librarie|
|000028d0| 73 2e 0a 0a 20 20 20 2a | 20 59 6f 75 72 20 6f 77 |s... *| Your ow|
|000028e0| 6e 20 68 65 61 64 65 72 | 20 66 69 6c 65 73 20 63 |n header| files c|
|000028f0| 6f 6e 74 61 69 6e 20 64 | 65 63 6c 61 72 61 74 69 |ontain d|eclarati|
|00002900| 6f 6e 73 20 66 6f 72 20 | 69 6e 74 65 72 66 61 63 |ons for |interfac|
|00002910| 65 73 20 62 65 74 77 65 | 65 6e 0a 20 20 20 20 20 |es betwe|en. |
|00002920| 74 68 65 20 73 6f 75 72 | 63 65 20 66 69 6c 65 73 |the sour|ce files|
|00002930| 20 6f 66 20 79 6f 75 72 | 20 70 72 6f 67 72 61 6d | of your| program|
|00002940| 2e 20 20 45 61 63 68 20 | 74 69 6d 65 20 79 6f 75 |. Each |time you|
|00002950| 20 68 61 76 65 20 61 20 | 67 72 6f 75 70 20 6f 66 | have a |group of|
|00002960| 0a 20 20 20 20 20 72 65 | 6c 61 74 65 64 20 64 65 |. re|lated de|
|00002970| 63 6c 61 72 61 74 69 6f | 6e 73 20 61 6e 64 20 6d |claratio|ns and m|
|00002980| 61 63 72 6f 20 64 65 66 | 69 6e 69 74 69 6f 6e 73 |acro def|initions|
|00002990| 20 61 6c 6c 20 6f 72 20 | 6d 6f 73 74 20 6f 66 20 | all or |most of |
|000029a0| 77 68 69 63 68 0a 20 20 | 20 20 20 61 72 65 20 6e |which. | are n|
|000029b0| 65 65 64 65 64 20 69 6e | 20 73 65 76 65 72 61 6c |eeded in| several|
|000029c0| 20 64 69 66 66 65 72 65 | 6e 74 20 73 6f 75 72 63 | differe|nt sourc|
|000029d0| 65 20 66 69 6c 65 73 2c | 20 69 74 20 69 73 20 61 |e files,| it is a|
|000029e0| 20 67 6f 6f 64 20 69 64 | 65 61 20 74 6f 0a 20 20 | good id|ea to. |
|000029f0| 20 20 20 63 72 65 61 74 | 65 20 61 20 68 65 61 64 | creat|e a head|
|00002a00| 65 72 20 66 69 6c 65 20 | 66 6f 72 20 74 68 65 6d |er file |for them|
|00002a10| 2e 0a 0a 20 20 20 49 6e | 63 6c 75 64 69 6e 67 20 |... In|cluding |
|00002a20| 61 20 68 65 61 64 65 72 | 20 66 69 6c 65 20 70 72 |a header| file pr|
|00002a30| 6f 64 75 63 65 73 20 74 | 68 65 20 73 61 6d 65 20 |oduces t|he same |
|00002a40| 72 65 73 75 6c 74 73 20 | 69 6e 20 43 20 63 6f 6d |results |in C com|
|00002a50| 70 69 6c 61 74 69 6f 6e | 20 61 73 0a 63 6f 70 79 |pilation| as.copy|
|00002a60| 69 6e 67 20 74 68 65 20 | 68 65 61 64 65 72 20 66 |ing the |header f|
|00002a70| 69 6c 65 20 69 6e 74 6f | 20 65 61 63 68 20 73 6f |ile into| each so|
|00002a80| 75 72 63 65 20 66 69 6c | 65 20 74 68 61 74 20 6e |urce fil|e that n|
|00002a90| 65 65 64 73 20 69 74 2e | 20 20 42 75 74 20 73 75 |eeds it.| But su|
|00002aa0| 63 68 0a 63 6f 70 79 69 | 6e 67 20 77 6f 75 6c 64 |ch.copyi|ng would|
|00002ab0| 20 62 65 20 74 69 6d 65 | 2d 63 6f 6e 73 75 6d 69 | be time|-consumi|
|00002ac0| 6e 67 20 61 6e 64 20 65 | 72 72 6f 72 2d 70 72 6f |ng and e|rror-pro|
|00002ad0| 6e 65 2e 20 20 57 69 74 | 68 20 61 20 68 65 61 64 |ne. Wit|h a head|
|00002ae0| 65 72 20 66 69 6c 65 2c | 0a 74 68 65 20 72 65 6c |er file,|.the rel|
|00002af0| 61 74 65 64 20 64 65 63 | 6c 61 72 61 74 69 6f 6e |ated dec|laration|
|00002b00| 73 20 61 70 70 65 61 72 | 20 69 6e 20 6f 6e 6c 79 |s appear| in only|
|00002b10| 20 6f 6e 65 20 70 6c 61 | 63 65 2e 20 20 49 66 20 | one pla|ce. If |
|00002b20| 74 68 65 79 20 6e 65 65 | 64 20 74 6f 20 62 65 0a |they nee|d to be.|
|00002b30| 63 68 61 6e 67 65 64 2c | 20 74 68 65 79 20 63 61 |changed,| they ca|
|00002b40| 6e 20 62 65 20 63 68 61 | 6e 67 65 64 20 69 6e 20 |n be cha|nged in |
|00002b50| 6f 6e 65 20 70 6c 61 63 | 65 2c 20 61 6e 64 20 70 |one plac|e, and p|
|00002b60| 72 6f 67 72 61 6d 73 20 | 74 68 61 74 20 69 6e 63 |rograms |that inc|
|00002b70| 6c 75 64 65 0a 74 68 65 | 20 68 65 61 64 65 72 20 |lude.the| header |
|00002b80| 66 69 6c 65 20 77 69 6c | 6c 20 61 75 74 6f 6d 61 |file wil|l automa|
|00002b90| 74 69 63 61 6c 6c 79 20 | 75 73 65 20 74 68 65 20 |tically |use the |
|00002ba0| 6e 65 77 20 76 65 72 73 | 69 6f 6e 20 77 68 65 6e |new vers|ion when|
|00002bb0| 20 6e 65 78 74 0a 72 65 | 63 6f 6d 70 69 6c 65 64 | next.re|compiled|
|00002bc0| 2e 20 20 54 68 65 20 68 | 65 61 64 65 72 20 66 69 |. The h|eader fi|
|00002bd0| 6c 65 20 65 6c 69 6d 69 | 6e 61 74 65 73 20 74 68 |le elimi|nates th|
|00002be0| 65 20 6c 61 62 6f 72 20 | 6f 66 20 66 69 6e 64 69 |e labor |of findi|
|00002bf0| 6e 67 20 61 6e 64 0a 63 | 68 61 6e 67 69 6e 67 20 |ng and.c|hanging |
|00002c00| 61 6c 6c 20 74 68 65 20 | 63 6f 70 69 65 73 20 61 |all the |copies a|
|00002c10| 73 20 77 65 6c 6c 20 61 | 73 20 74 68 65 20 72 69 |s well a|s the ri|
|00002c20| 73 6b 20 74 68 61 74 20 | 61 20 66 61 69 6c 75 72 |sk that |a failur|
|00002c30| 65 20 74 6f 20 66 69 6e | 64 20 6f 6e 65 0a 63 6f |e to fin|d one.co|
|00002c40| 70 79 20 77 69 6c 6c 20 | 72 65 73 75 6c 74 20 69 |py will |result i|
|00002c50| 6e 20 69 6e 63 6f 6e 73 | 69 73 74 65 6e 63 69 65 |n incons|istencie|
|00002c60| 73 20 77 69 74 68 69 6e | 20 61 20 70 72 6f 67 72 |s within| a progr|
|00002c70| 61 6d 2e 0a 0a 20 20 20 | 54 68 65 20 75 73 75 61 |am... |The usua|
|00002c80| 6c 20 63 6f 6e 76 65 6e | 74 69 6f 6e 20 69 73 20 |l conven|tion is |
|00002c90| 74 6f 20 67 69 76 65 20 | 68 65 61 64 65 72 20 66 |to give |header f|
|00002ca0| 69 6c 65 73 20 6e 61 6d | 65 73 20 74 68 61 74 20 |iles nam|es that |
|00002cb0| 65 6e 64 20 77 69 74 68 | 0a 60 2e 68 27 2e 0a 0a |end with|.`.h'...|
|00002cc0| 40 45 6e 64 4e 6f 64 65 | 0a 0a 0a 40 4e 6f 64 65 |@EndNode|...@Node|
|00002cd0| 20 22 49 6e 63 6c 75 64 | 65 20 53 79 6e 74 61 78 | "Includ|e Syntax|
|00002ce0| 22 20 22 49 6e 63 6c 75 | 64 65 20 53 79 6e 74 61 |" "Inclu|de Synta|
|00002cf0| 78 22 0a 40 4e 65 78 74 | 20 22 49 6e 63 6c 75 64 |x".@Next| "Includ|
|00002d00| 65 20 4f 70 65 72 61 74 | 69 6f 6e 22 20 22 49 6e |e Operat|ion" "In|
|00002d10| 63 6c 75 64 65 20 4f 70 | 65 72 61 74 69 6f 6e 22 |clude Op|eration"|
|00002d20| 0a 40 50 72 65 76 20 22 | 48 65 61 64 65 72 20 55 |.@Prev "|Header U|
|00002d30| 73 65 73 22 20 22 48 65 | 61 64 65 72 20 55 73 65 |ses" "He|ader Use|
|00002d40| 73 22 0a 40 54 6f 63 20 | 22 48 65 61 64 65 72 20 |s".@Toc |"Header |
|00002d50| 46 69 6c 65 73 22 20 22 | 48 65 61 64 65 72 20 46 |Files" "|Header F|
|00002d60| 69 6c 65 73 22 0a 54 68 | 65 20 60 23 69 6e 63 6c |iles".Th|e `#incl|
|00002d70| 75 64 65 27 20 43 6f 6d | 6d 61 6e 64 0a 2d 2d 2d |ude' Com|mand.---|
|00002d80| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00002d90| 2d 2d 2d 0a 0a 20 20 20 | 42 6f 74 68 20 75 73 65 |---.. |Both use|
|00002da0| 72 20 61 6e 64 20 73 79 | 73 74 65 6d 20 68 65 61 |r and sy|stem hea|
|00002db0| 64 65 72 20 66 69 6c 65 | 73 20 61 72 65 20 69 6e |der file|s are in|
|00002dc0| 63 6c 75 64 65 64 20 75 | 73 69 6e 67 20 74 68 65 |cluded u|sing the|
|00002dd0| 20 70 72 65 70 72 6f 63 | 65 73 73 6f 72 0a 63 6f | preproc|essor.co|
|00002de0| 6d 6d 61 6e 64 20 60 23 | 69 6e 63 6c 75 64 65 27 |mmand `#|include'|
|00002df0| 2e 20 20 49 74 20 68 61 | 73 20 74 68 72 65 65 20 |. It ha|s three |
|00002e00| 76 61 72 69 61 6e 74 73 | 3a 0a 0a 60 23 69 6e 63 |variants|:..`#inc|
|00002e10| 6c 75 64 65 20 3c 46 49 | 4c 45 3e 27 0a 20 20 20 |lude <FI|LE>'. |
|00002e20| 20 20 54 68 69 73 20 76 | 61 72 69 61 6e 74 20 69 | This v|ariant i|
|00002e30| 73 20 75 73 65 64 20 66 | 6f 72 20 73 79 73 74 65 |s used f|or syste|
|00002e40| 6d 20 68 65 61 64 65 72 | 20 66 69 6c 65 73 2e 20 |m header| files. |
|00002e50| 20 49 74 20 73 65 61 72 | 63 68 65 73 20 66 6f 72 | It sear|ches for|
|00002e60| 20 61 0a 20 20 20 20 20 | 66 69 6c 65 20 6e 61 6d | a. |file nam|
|00002e70| 65 64 20 46 49 4c 45 20 | 69 6e 20 61 20 6c 69 73 |ed FILE |in a lis|
|00002e80| 74 20 6f 66 20 64 69 72 | 65 63 74 6f 72 69 65 73 |t of dir|ectories|
|00002e90| 20 73 70 65 63 69 66 69 | 65 64 20 62 79 20 79 6f | specifi|ed by yo|
|00002ea0| 75 2c 20 74 68 65 6e 20 | 69 6e 0a 20 20 20 20 20 |u, then |in. |
|00002eb0| 61 20 73 74 61 6e 64 61 | 72 64 20 6c 69 73 74 20 |a standa|rd list |
|00002ec0| 6f 66 20 73 79 73 74 65 | 6d 20 64 69 72 65 63 74 |of syste|m direct|
|00002ed0| 6f 72 69 65 73 2e 20 20 | 59 6f 75 20 73 70 65 63 |ories. |You spec|
|00002ee0| 69 66 79 20 64 69 72 65 | 63 74 6f 72 69 65 73 20 |ify dire|ctories |
|00002ef0| 74 6f 0a 20 20 20 20 20 | 73 65 61 72 63 68 20 66 |to. |search f|
|00002f00| 6f 72 20 68 65 61 64 65 | 72 20 66 69 6c 65 73 20 |or heade|r files |
|00002f10| 77 69 74 68 20 74 68 65 | 20 63 6f 6d 6d 61 6e 64 |with the| command|
|00002f20| 20 6f 70 74 69 6f 6e 20 | 60 2d 49 27 20 0a 20 20 | option |`-I' . |
|00002f30| 20 20 20 28 40 7b 22 49 | 6e 76 6f 63 61 74 69 6f | (@{"I|nvocatio|
|00002f40| 6e 22 20 4c 69 6e 6b 20 | 22 49 6e 76 6f 63 61 74 |n" Link |"Invocat|
|00002f50| 69 6f 6e 22 7d 29 2e 20 | 20 54 68 65 20 6f 70 74 |ion"}). | The opt|
|00002f60| 69 6f 6e 20 60 2d 6e 6f | 73 74 64 69 6e 63 27 20 |ion `-no|stdinc' |
|00002f70| 69 6e 68 69 62 69 74 73 | 20 73 65 61 72 63 68 69 |inhibits| searchi|
|00002f80| 6e 67 20 74 68 65 0a 20 | 20 20 20 20 73 74 61 6e |ng the. | stan|
|00002f90| 64 61 72 64 20 73 79 73 | 74 65 6d 20 64 69 72 65 |dard sys|tem dire|
|00002fa0| 63 74 6f 72 69 65 73 3b | 20 69 6e 20 74 68 69 73 |ctories;| in this|
|00002fb0| 20 63 61 73 65 20 6f 6e | 6c 79 20 74 68 65 20 64 | case on|ly the d|
|00002fc0| 69 72 65 63 74 6f 72 69 | 65 73 20 79 6f 75 0a 20 |irectori|es you. |
|00002fd0| 20 20 20 20 73 70 65 63 | 69 66 79 20 61 72 65 20 | spec|ify are |
|00002fe0| 73 65 61 72 63 68 65 64 | 2e 0a 0a 20 20 20 20 20 |searched|... |
|00002ff0| 54 68 65 20 70 61 72 73 | 69 6e 67 20 6f 66 20 74 |The pars|ing of t|
|00003000| 68 69 73 20 66 6f 72 6d | 20 6f 66 20 60 23 69 6e |his form| of `#in|
|00003010| 63 6c 75 64 65 27 20 69 | 73 20 73 6c 69 67 68 74 |clude' i|s slight|
|00003020| 6c 79 20 73 70 65 63 69 | 61 6c 20 62 65 63 61 75 |ly speci|al becau|
|00003030| 73 65 0a 20 20 20 20 20 | 63 6f 6d 6d 65 6e 74 73 |se. |comments|
|00003040| 20 61 72 65 20 6e 6f 74 | 20 72 65 63 6f 67 6e 69 | are not| recogni|
|00003050| 7a 65 64 20 77 69 74 68 | 69 6e 20 74 68 65 20 60 |zed with|in the `|
|00003060| 3c 2e 2e 2e 3e 27 2e 20 | 20 54 68 75 73 2c 20 69 |<...>'. | Thus, i|
|00003070| 6e 0a 20 20 20 20 20 60 | 23 69 6e 63 6c 75 64 65 |n. `|#include|
|00003080| 20 3c 78 2f 2a 79 3e 27 | 20 74 68 65 20 60 2f 2a | <x/*y>'| the `/*|
|00003090| 27 20 64 6f 65 73 20 6e | 6f 74 20 73 74 61 72 74 |' does n|ot start|
|000030a0| 20 61 20 63 6f 6d 6d 65 | 6e 74 20 61 6e 64 20 74 | a comme|nt and t|
|000030b0| 68 65 0a 20 20 20 20 20 | 63 6f 6d 6d 61 6e 64 20 |he. |command |
|000030c0| 73 70 65 63 69 66 69 65 | 73 20 69 6e 63 6c 75 73 |specifie|s inclus|
|000030d0| 69 6f 6e 20 6f 66 20 61 | 20 73 79 73 74 65 6d 20 |ion of a| system |
|000030e0| 68 65 61 64 65 72 20 66 | 69 6c 65 20 6e 61 6d 65 |header f|ile name|
|000030f0| 64 20 60 78 2f 2a 79 27 | 2e 0a 20 20 20 20 20 4f |d `x/*y'|.. O|
|00003100| 66 20 63 6f 75 72 73 65 | 2c 20 61 20 68 65 61 64 |f course|, a head|
|00003110| 65 72 20 66 69 6c 65 20 | 77 69 74 68 20 73 75 63 |er file |with suc|
|00003120| 68 20 61 20 6e 61 6d 65 | 20 69 73 20 75 6e 6c 69 |h a name| is unli|
|00003130| 6b 65 6c 79 20 74 6f 20 | 65 78 69 73 74 20 6f 6e |kely to |exist on|
|00003140| 0a 20 20 20 20 20 55 6e | 69 78 2c 20 77 68 65 72 |. Un|ix, wher|
|00003150| 65 20 73 68 65 6c 6c 20 | 77 69 6c 64 63 61 72 64 |e shell |wildcard|
|00003160| 20 66 65 61 74 75 72 65 | 73 20 77 6f 75 6c 64 20 | feature|s would |
|00003170| 6d 61 6b 65 20 69 74 20 | 68 61 72 64 20 74 6f 0a |make it |hard to.|
|00003180| 20 20 20 20 20 6d 61 6e | 69 70 75 6c 61 74 65 2e | man|ipulate.|
|00003190| 0a 0a 20 20 20 20 20 54 | 68 65 20 61 72 67 75 6d |.. T|he argum|
|000031a0| 65 6e 74 20 46 49 4c 45 | 20 6d 61 79 20 6e 6f 74 |ent FILE| may not|
|000031b0| 20 63 6f 6e 74 61 69 6e | 20 61 20 60 3e 27 20 63 | contain| a `>' c|
|000031c0| 68 61 72 61 63 74 65 72 | 2e 20 20 49 74 20 6d 61 |haracter|. It ma|
|000031d0| 79 2c 0a 20 20 20 20 20 | 68 6f 77 65 76 65 72 2c |y,. |however,|
|000031e0| 20 63 6f 6e 74 61 69 6e | 20 61 20 60 3c 27 20 63 | contain| a `<' c|
|000031f0| 68 61 72 61 63 74 65 72 | 2e 0a 0a 60 23 69 6e 63 |haracter|...`#inc|
|00003200| 6c 75 64 65 20 22 46 49 | 4c 45 22 27 0a 20 20 20 |lude "FI|LE"'. |
|00003210| 20 20 54 68 69 73 20 76 | 61 72 69 61 6e 74 20 69 | This v|ariant i|
|00003220| 73 20 75 73 65 64 20 66 | 6f 72 20 68 65 61 64 65 |s used f|or heade|
|00003230| 72 20 66 69 6c 65 73 20 | 6f 66 20 79 6f 75 72 20 |r files |of your |
|00003240| 6f 77 6e 20 70 72 6f 67 | 72 61 6d 2e 20 20 49 74 |own prog|ram. It|
|00003250| 0a 20 20 20 20 20 73 65 | 61 72 63 68 65 73 20 66 |. se|arches f|
|00003260| 6f 72 20 61 20 66 69 6c | 65 20 6e 61 6d 65 64 20 |or a fil|e named |
|00003270| 46 49 4c 45 20 66 69 72 | 73 74 20 69 6e 20 74 68 |FILE fir|st in th|
|00003280| 65 20 63 75 72 72 65 6e | 74 20 64 69 72 65 63 74 |e curren|t direct|
|00003290| 6f 72 79 2c 0a 20 20 20 | 20 20 74 68 65 6e 20 69 |ory,. | then i|
|000032a0| 6e 20 74 68 65 20 73 61 | 6d 65 20 64 69 72 65 63 |n the sa|me direc|
|000032b0| 74 6f 72 69 65 73 20 75 | 73 65 64 20 66 6f 72 20 |tories u|sed for |
|000032c0| 73 79 73 74 65 6d 20 68 | 65 61 64 65 72 20 66 69 |system h|eader fi|
|000032d0| 6c 65 73 2e 20 20 54 68 | 65 0a 20 20 20 20 20 63 |les. Th|e. c|
|000032e0| 75 72 72 65 6e 74 20 64 | 69 72 65 63 74 6f 72 79 |urrent d|irectory|
|000032f0| 20 69 73 20 74 68 65 20 | 64 69 72 65 63 74 6f 72 | is the |director|
|00003300| 79 20 6f 66 20 74 68 65 | 20 63 75 72 72 65 6e 74 |y of the| current|
|00003310| 20 69 6e 70 75 74 20 66 | 69 6c 65 2e 20 20 49 74 | input f|ile. It|
|00003320| 0a 20 20 20 20 20 69 73 | 20 74 72 69 65 64 20 66 |. is| tried f|
|00003330| 69 72 73 74 20 62 65 63 | 61 75 73 65 20 69 74 20 |irst bec|ause it |
|00003340| 69 73 20 70 72 65 73 75 | 6d 65 64 20 74 6f 20 62 |is presu|med to b|
|00003350| 65 20 74 68 65 20 6c 6f | 63 61 74 69 6f 6e 20 6f |e the lo|cation o|
|00003360| 66 20 74 68 65 0a 20 20 | 20 20 20 66 69 6c 65 73 |f the. | files|
|00003370| 20 74 68 61 74 20 74 68 | 65 20 63 75 72 72 65 6e | that th|e curren|
|00003380| 74 20 69 6e 70 75 74 20 | 66 69 6c 65 20 72 65 66 |t input |file ref|
|00003390| 65 72 73 20 74 6f 2e 20 | 20 28 49 66 20 74 68 65 |ers to. | (If the|
|000033a0| 20 60 2d 49 2d 27 20 6f | 70 74 69 6f 6e 0a 20 20 | `-I-' o|ption. |
|000033b0| 20 20 20 69 73 20 75 73 | 65 64 2c 20 74 68 65 20 | is us|ed, the |
|000033c0| 73 70 65 63 69 61 6c 20 | 74 72 65 61 74 6d 65 6e |special |treatmen|
|000033d0| 74 20 6f 66 20 74 68 65 | 20 63 75 72 72 65 6e 74 |t of the| current|
|000033e0| 20 64 69 72 65 63 74 6f | 72 79 20 69 73 0a 20 20 | directo|ry is. |
|000033f0| 20 20 20 69 6e 68 69 62 | 69 74 65 64 2e 29 0a 0a | inhib|ited.)..|
|00003400| 20 20 20 20 20 54 68 65 | 20 61 72 67 75 6d 65 6e | The| argumen|
|00003410| 74 20 46 49 4c 45 20 6d | 61 79 20 6e 6f 74 20 63 |t FILE m|ay not c|
|00003420| 6f 6e 74 61 69 6e 20 60 | 22 27 20 63 68 61 72 61 |ontain `|"' chara|
|00003430| 63 74 65 72 73 2e 20 20 | 49 66 20 62 61 63 6b 73 |cters. |If backs|
|00003440| 6c 61 73 68 65 73 0a 20 | 20 20 20 20 6f 63 63 75 |lashes. | occu|
|00003450| 72 20 77 69 74 68 69 6e | 20 46 49 4c 45 2c 20 74 |r within| FILE, t|
|00003460| 68 65 79 20 61 72 65 20 | 63 6f 6e 73 69 64 65 72 |hey are |consider|
|00003470| 65 64 20 6f 72 64 69 6e | 61 72 79 20 74 65 78 74 |ed ordin|ary text|
|00003480| 20 63 68 61 72 61 63 74 | 65 72 73 2c 0a 20 20 20 | charact|ers,. |
|00003490| 20 20 6e 6f 74 20 65 73 | 63 61 70 65 20 63 68 61 | not es|cape cha|
|000034a0| 72 61 63 74 65 72 73 2e | 20 20 4e 6f 6e 65 20 6f |racters.| None o|
|000034b0| 66 20 74 68 65 20 63 68 | 61 72 61 63 74 65 72 20 |f the ch|aracter |
|000034c0| 65 73 63 61 70 65 20 73 | 65 71 75 65 6e 63 65 73 |escape s|equences|
|000034d0| 0a 20 20 20 20 20 61 70 | 70 72 6f 70 72 69 61 74 |. ap|propriat|
|000034e0| 65 20 74 6f 20 73 74 72 | 69 6e 67 20 63 6f 6e 73 |e to str|ing cons|
|000034f0| 74 61 6e 74 73 20 69 6e | 20 43 20 61 72 65 20 70 |tants in| C are p|
|00003500| 72 6f 63 65 73 73 65 64 | 2e 20 20 54 68 75 73 2c |rocessed|. Thus,|
|00003510| 0a 20 20 20 20 20 60 23 | 69 6e 63 6c 75 64 65 20 |. `#|include |
|00003520| 22 78 5c 6e 5c 5c 79 22 | 27 20 73 70 65 63 69 66 |"x\n\\y"|' specif|
|00003530| 69 65 73 20 61 20 66 69 | 6c 65 6e 61 6d 65 20 63 |ies a fi|lename c|
|00003540| 6f 6e 74 61 69 6e 69 6e | 67 20 74 68 72 65 65 0a |ontainin|g three.|
|00003550| 20 20 20 20 20 62 61 63 | 6b 73 6c 61 73 68 65 73 | bac|kslashes|
|00003560| 2e 20 20 49 74 20 69 73 | 20 6e 6f 74 20 63 6c 65 |. It is| not cle|
|00003570| 61 72 20 77 68 79 20 74 | 68 69 73 20 62 65 68 61 |ar why t|his beha|
|00003580| 76 69 6f 72 20 69 73 20 | 65 76 65 72 20 75 73 65 |vior is |ever use|
|00003590| 66 75 6c 2c 20 62 75 74 | 0a 20 20 20 20 20 74 68 |ful, but|. th|
|000035a0| 65 20 41 4e 53 49 20 73 | 74 61 6e 64 61 72 64 20 |e ANSI s|tandard |
|000035b0| 73 70 65 63 69 66 69 65 | 73 20 69 74 2e 0a 0a 60 |specifie|s it...`|
|000035c0| 23 69 6e 63 6c 75 64 65 | 20 41 4e 59 54 48 49 4e |#include| ANYTHIN|
|000035d0| 47 20 45 4c 53 45 27 0a | 20 20 20 20 20 54 68 69 |G ELSE'.| Thi|
|000035e0| 73 20 76 61 72 69 61 6e | 74 20 69 73 20 63 61 6c |s varian|t is cal|
|000035f0| 6c 65 64 20 61 20 22 63 | 6f 6d 70 75 74 65 64 20 |led a "c|omputed |
|00003600| 23 69 6e 63 6c 75 64 65 | 22 2e 20 20 41 6e 79 20 |#include|". Any |
|00003610| 60 23 69 6e 63 6c 75 64 | 65 27 0a 20 20 20 20 20 |`#includ|e'. |
|00003620| 63 6f 6d 6d 61 6e 64 20 | 77 68 6f 73 65 20 61 72 |command |whose ar|
|00003630| 67 75 6d 65 6e 74 20 64 | 6f 65 73 20 6e 6f 74 20 |gument d|oes not |
|00003640| 66 69 74 20 74 68 65 20 | 61 62 6f 76 65 20 74 77 |fit the |above tw|
|00003650| 6f 20 66 6f 72 6d 73 20 | 69 73 20 61 0a 20 20 20 |o forms |is a. |
|00003660| 20 20 63 6f 6d 70 75 74 | 65 64 20 69 6e 63 6c 75 | comput|ed inclu|
|00003670| 64 65 2e 20 20 54 68 65 | 20 74 65 78 74 20 41 4e |de. The| text AN|
|00003680| 59 54 48 49 4e 47 20 45 | 4c 53 45 20 69 73 20 63 |YTHING E|LSE is c|
|00003690| 68 65 63 6b 65 64 20 66 | 6f 72 20 6d 61 63 72 6f |hecked f|or macro|
|000036a0| 0a 20 20 20 20 20 63 61 | 6c 6c 73 2c 20 77 68 69 |. ca|lls, whi|
|000036b0| 63 68 20 61 72 65 20 65 | 78 70 61 6e 64 65 64 20 |ch are e|xpanded |
|000036c0| 28 40 7b 22 4d 61 63 72 | 6f 73 22 20 4c 69 6e 6b |(@{"Macr|os" Link|
|000036d0| 20 22 4d 61 63 72 6f 73 | 22 7d 29 2e 20 20 57 68 | "Macros|"}). Wh|
|000036e0| 65 6e 20 74 68 69 73 20 | 69 73 20 64 6f 6e 65 2c |en this |is done,|
|000036f0| 0a 20 20 20 20 20 74 68 | 65 20 72 65 73 75 6c 74 |. th|e result|
|00003700| 20 6d 75 73 74 20 66 69 | 74 20 6f 6e 65 20 6f 66 | must fi|t one of|
|00003710| 20 74 68 65 20 61 62 6f | 76 65 20 74 77 6f 20 76 | the abo|ve two v|
|00003720| 61 72 69 61 6e 74 73 2d | 2d 69 6e 20 70 61 72 74 |ariants-|-in part|
|00003730| 69 63 75 6c 61 72 2c 0a | 20 20 20 20 20 74 68 65 |icular,.| the|
|00003740| 20 65 78 70 61 6e 64 65 | 64 20 74 65 78 74 20 6d | expande|d text m|
|00003750| 75 73 74 20 69 6e 20 74 | 68 65 20 65 6e 64 20 62 |ust in t|he end b|
|00003760| 65 20 73 75 72 72 6f 75 | 6e 64 65 64 20 62 79 20 |e surrou|nded by |
|00003770| 65 69 74 68 65 72 20 71 | 75 6f 74 65 73 0a 20 20 |either q|uotes. |
|00003780| 20 20 20 6f 72 20 61 6e | 67 6c 65 20 62 72 61 63 | or an|gle brac|
|00003790| 65 73 2e 0a 0a 20 20 20 | 20 20 54 68 69 73 20 66 |es... | This f|
|000037a0| 65 61 74 75 72 65 20 61 | 6c 6c 6f 77 73 20 79 6f |eature a|llows yo|
|000037b0| 75 20 74 6f 20 64 65 66 | 69 6e 65 20 61 20 6d 61 |u to def|ine a ma|
|000037c0| 63 72 6f 20 77 68 69 63 | 68 20 63 6f 6e 74 72 6f |cro whic|h contro|
|000037d0| 6c 73 20 74 68 65 20 66 | 69 6c 65 0a 20 20 20 20 |ls the f|ile. |
|000037e0| 20 6e 61 6d 65 20 74 6f | 20 62 65 20 75 73 65 64 | name to| be used|
|000037f0| 20 61 74 20 61 20 6c 61 | 74 65 72 20 70 6f 69 6e | at a la|ter poin|
|00003800| 74 20 69 6e 20 74 68 65 | 20 70 72 6f 67 72 61 6d |t in the| program|
|00003810| 2e 20 20 4f 6e 65 20 61 | 70 70 6c 69 63 61 74 69 |. One a|pplicati|
|00003820| 6f 6e 0a 20 20 20 20 20 | 6f 66 20 74 68 69 73 20 |on. |of this |
|00003830| 69 73 20 74 6f 20 61 6c | 6c 6f 77 20 61 20 73 69 |is to al|low a si|
|00003840| 74 65 2d 63 6f 6e 66 69 | 67 75 72 61 74 69 6f 6e |te-confi|guration|
|00003850| 20 66 69 6c 65 20 66 6f | 72 20 79 6f 75 72 20 70 | file fo|r your p|
|00003860| 72 6f 67 72 61 6d 20 74 | 6f 0a 20 20 20 20 20 73 |rogram t|o. s|
|00003870| 70 65 63 69 66 79 20 74 | 68 65 20 6e 61 6d 65 73 |pecify t|he names|
|00003880| 20 6f 66 20 74 68 65 20 | 73 79 73 74 65 6d 20 69 | of the |system i|
|00003890| 6e 63 6c 75 64 65 20 66 | 69 6c 65 73 20 74 6f 20 |nclude f|iles to |
|000038a0| 62 65 20 75 73 65 64 2e | 20 20 54 68 69 73 0a 20 |be used.| This. |
|000038b0| 20 20 20 20 63 61 6e 20 | 68 65 6c 70 20 69 6e 20 | can |help in |
|000038c0| 70 6f 72 74 69 6e 67 20 | 74 68 65 20 70 72 6f 67 |porting |the prog|
|000038d0| 72 61 6d 20 74 6f 20 76 | 61 72 69 6f 75 73 20 6f |ram to v|arious o|
|000038e0| 70 65 72 61 74 69 6e 67 | 20 73 79 73 74 65 6d 73 |perating| systems|
|000038f0| 20 69 6e 0a 20 20 20 20 | 20 77 68 69 63 68 20 74 | in. | which t|
|00003900| 68 65 20 6e 65 63 65 73 | 73 61 72 79 20 73 79 73 |he neces|sary sys|
|00003910| 74 65 6d 20 68 65 61 64 | 65 72 20 66 69 6c 65 73 |tem head|er files|
|00003920| 20 61 72 65 20 66 6f 75 | 6e 64 20 69 6e 20 64 69 | are fou|nd in di|
|00003930| 66 66 65 72 65 6e 74 0a | 20 20 20 20 20 70 6c 61 |fferent.| pla|
|00003940| 63 65 73 2e 0a 0a 40 45 | 6e 64 4e 6f 64 65 0a 0a |ces...@E|ndNode..|
|00003950| 0a 40 4e 6f 64 65 20 22 | 49 6e 63 6c 75 64 65 20 |.@Node "|Include |
|00003960| 4f 70 65 72 61 74 69 6f | 6e 22 20 22 49 6e 63 6c |Operatio|n" "Incl|
|00003970| 75 64 65 20 4f 70 65 72 | 61 74 69 6f 6e 22 0a 40 |ude Oper|ation".@|
|00003980| 4e 65 78 74 20 22 4f 6e | 63 65 2d 4f 6e 6c 79 22 |Next "On|ce-Only"|
|00003990| 20 22 4f 6e 63 65 2d 4f | 6e 6c 79 22 0a 40 50 72 | "Once-O|nly".@Pr|
|000039a0| 65 76 20 22 49 6e 63 6c | 75 64 65 20 53 79 6e 74 |ev "Incl|ude Synt|
|000039b0| 61 78 22 20 22 49 6e 63 | 6c 75 64 65 20 53 79 6e |ax" "Inc|lude Syn|
|000039c0| 74 61 78 22 0a 40 54 6f | 63 20 22 48 65 61 64 65 |tax".@To|c "Heade|
|000039d0| 72 20 46 69 6c 65 73 22 | 20 22 48 65 61 64 65 72 |r Files"| "Header|
|000039e0| 20 46 69 6c 65 73 22 0a | 48 6f 77 20 60 23 69 6e | Files".|How `#in|
|000039f0| 63 6c 75 64 65 27 20 57 | 6f 72 6b 73 0a 2d 2d 2d |clude' W|orks.---|
|00003a00| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00003a10| 2d 0a 0a 20 20 20 54 68 | 65 20 60 23 69 6e 63 6c |-.. Th|e `#incl|
|00003a20| 75 64 65 27 20 63 6f 6d | 6d 61 6e 64 20 77 6f 72 |ude' com|mand wor|
|00003a30| 6b 73 20 62 79 20 64 69 | 72 65 63 74 69 6e 67 20 |ks by di|recting |
|00003a40| 74 68 65 20 43 20 70 72 | 65 70 72 6f 63 65 73 73 |the C pr|eprocess|
|00003a50| 6f 72 20 74 6f 20 73 63 | 61 6e 0a 74 68 65 20 73 |or to sc|an.the s|
|00003a60| 70 65 63 69 66 69 65 64 | 20 66 69 6c 65 20 61 73 |pecified| file as|
|00003a70| 20 69 6e 70 75 74 20 62 | 65 66 6f 72 65 20 63 6f | input b|efore co|
|00003a80| 6e 74 69 6e 75 69 6e 67 | 20 77 69 74 68 20 74 68 |ntinuing| with th|
|00003a90| 65 20 72 65 73 74 20 6f | 66 20 74 68 65 0a 63 75 |e rest o|f the.cu|
|00003aa0| 72 72 65 6e 74 20 66 69 | 6c 65 2e 20 20 54 68 65 |rrent fi|le. The|
|00003ab0| 20 6f 75 74 70 75 74 20 | 66 72 6f 6d 20 74 68 65 | output |from the|
|00003ac0| 20 70 72 65 70 72 6f 63 | 65 73 73 6f 72 20 63 6f | preproc|essor co|
|00003ad0| 6e 74 61 69 6e 73 20 74 | 68 65 20 6f 75 74 70 75 |ntains t|he outpu|
|00003ae0| 74 0a 61 6c 72 65 61 64 | 79 20 67 65 6e 65 72 61 |t.alread|y genera|
|00003af0| 74 65 64 2c 20 66 6f 6c | 6c 6f 77 65 64 20 62 79 |ted, fol|lowed by|
|00003b00| 20 74 68 65 20 6f 75 74 | 70 75 74 20 72 65 73 75 | the out|put resu|
|00003b10| 6c 74 69 6e 67 20 66 72 | 6f 6d 20 74 68 65 20 69 |lting fr|om the i|
|00003b20| 6e 63 6c 75 64 65 64 0a | 66 69 6c 65 2c 20 66 6f |ncluded.|file, fo|
|00003b30| 6c 6c 6f 77 65 64 20 62 | 79 20 74 68 65 20 6f 75 |llowed b|y the ou|
|00003b40| 74 70 75 74 20 74 68 61 | 74 20 63 6f 6d 65 73 20 |tput tha|t comes |
|00003b50| 66 72 6f 6d 20 74 68 65 | 20 74 65 78 74 20 61 66 |from the| text af|
|00003b60| 74 65 72 20 74 68 65 0a | 60 23 69 6e 63 6c 75 64 |ter the.|`#includ|
|00003b70| 65 27 20 63 6f 6d 6d 61 | 6e 64 2e 20 20 46 6f 72 |e' comma|nd. For|
|00003b80| 20 65 78 61 6d 70 6c 65 | 2c 20 67 69 76 65 6e 20 | example|, given |
|00003b90| 74 77 6f 20 66 69 6c 65 | 73 20 61 73 20 66 6f 6c |two file|s as fol|
|00003ba0| 6c 6f 77 73 3a 0a 0a 20 | 20 20 20 20 2f 2a 20 46 |lows:.. | /* F|
|00003bb0| 69 6c 65 20 70 72 6f 67 | 72 61 6d 2e 63 20 2a 2f |ile prog|ram.c */|
|00003bc0| 0a 20 20 20 20 20 69 6e | 74 20 78 3b 0a 20 20 20 |. in|t x;. |
|00003bd0| 20 20 23 69 6e 63 6c 75 | 64 65 20 22 68 65 61 64 | #inclu|de "head|
|00003be0| 65 72 2e 68 22 0a 20 20 | 20 20 20 0a 20 20 20 20 |er.h". | . |
|00003bf0| 20 6d 61 69 6e 20 28 29 | 0a 20 20 20 20 20 7b 0a | main ()|. {.|
|00003c00| 20 20 20 20 20 20 20 70 | 72 69 6e 74 66 20 28 74 | p|rintf (t|
|00003c10| 65 73 74 20 28 29 29 3b | 0a 20 20 20 20 20 7d 0a |est ());|. }.|
|00003c20| 20 20 20 20 20 0a 20 20 | 20 20 20 0a 20 20 20 20 | . | . |
|00003c30| 20 2f 2a 20 46 69 6c 65 | 20 68 65 61 64 65 72 2e | /* File| header.|
|00003c40| 68 20 2a 2f 0a 20 20 20 | 20 20 63 68 61 72 20 2a |h */. | char *|
|00003c50| 74 65 73 74 20 28 29 3b | 0a 0a 74 68 65 20 6f 75 |test ();|..the ou|
|00003c60| 74 70 75 74 20 67 65 6e | 65 72 61 74 65 64 20 62 |tput gen|erated b|
|00003c70| 79 20 74 68 65 20 43 20 | 70 72 65 70 72 6f 63 65 |y the C |preproce|
|00003c80| 73 73 6f 72 20 66 6f 72 | 20 60 70 72 6f 67 72 61 |ssor for| `progra|
|00003c90| 6d 2e 63 27 20 61 73 20 | 69 6e 70 75 74 0a 77 6f |m.c' as |input.wo|
|00003ca0| 75 6c 64 20 62 65 0a 0a | 20 20 20 20 20 69 6e 74 |uld be..| int|
|00003cb0| 20 78 3b 0a 20 20 20 20 | 20 63 68 61 72 20 2a 74 | x;. | char *t|
|00003cc0| 65 73 74 20 28 29 3b 0a | 20 20 20 20 20 0a 20 20 |est ();.| . |
|00003cd0| 20 20 20 6d 61 69 6e 20 | 28 29 0a 20 20 20 20 20 | main |(). |
|00003ce0| 7b 0a 20 20 20 20 20 20 | 20 70 72 69 6e 74 66 20 |{. | printf |
|00003cf0| 28 74 65 73 74 20 28 29 | 29 3b 0a 20 20 20 20 20 |(test ()|);. |
|00003d00| 7d 0a 0a 20 20 20 49 6e | 63 6c 75 64 65 64 20 66 |}.. In|cluded f|
|00003d10| 69 6c 65 73 20 61 72 65 | 20 6e 6f 74 20 6c 69 6d |iles are| not lim|
|00003d20| 69 74 65 64 20 74 6f 20 | 64 65 63 6c 61 72 61 74 |ited to |declarat|
|00003d30| 69 6f 6e 73 20 61 6e 64 | 20 6d 61 63 72 6f 0a 64 |ions and| macro.d|
|00003d40| 65 66 69 6e 69 74 69 6f | 6e 73 3b 20 74 68 6f 73 |efinitio|ns; thos|
|00003d50| 65 20 61 72 65 20 6d 65 | 72 65 6c 79 20 74 68 65 |e are me|rely the|
|00003d60| 20 74 79 70 69 63 61 6c | 20 75 73 65 73 2e 20 20 | typical| uses. |
|00003d70| 41 6e 79 20 66 72 61 67 | 6d 65 6e 74 20 6f 66 20 |Any frag|ment of |
|00003d80| 61 20 43 0a 70 72 6f 67 | 72 61 6d 20 63 61 6e 20 |a C.prog|ram can |
|00003d90| 62 65 20 69 6e 63 6c 75 | 64 65 64 20 66 72 6f 6d |be inclu|ded from|
|00003da0| 20 61 6e 6f 74 68 65 72 | 20 66 69 6c 65 2e 20 20 | another| file. |
|00003db0| 54 68 65 20 69 6e 63 6c | 75 64 65 20 66 69 6c 65 |The incl|ude file|
|00003dc0| 20 63 6f 75 6c 64 20 65 | 76 65 6e 0a 63 6f 6e 74 | could e|ven.cont|
|00003dd0| 61 69 6e 20 74 68 65 20 | 62 65 67 69 6e 6e 69 6e |ain the |beginnin|
|00003de0| 67 20 6f 66 20 61 20 73 | 74 61 74 65 6d 65 6e 74 |g of a s|tatement|
|00003df0| 20 74 68 61 74 20 69 73 | 20 63 6f 6e 63 6c 75 64 | that is| conclud|
|00003e00| 65 64 20 69 6e 20 74 68 | 65 0a 63 6f 6e 74 61 69 |ed in th|e.contai|
|00003e10| 6e 69 6e 67 20 66 69 6c | 65 2c 20 6f 72 20 74 68 |ning fil|e, or th|
|00003e20| 65 20 65 6e 64 20 6f 66 | 20 61 20 73 74 61 74 65 |e end of| a state|
|00003e30| 6d 65 6e 74 20 74 68 61 | 74 20 77 61 73 20 73 74 |ment tha|t was st|
|00003e40| 61 72 74 65 64 20 69 6e | 20 74 68 65 0a 69 6e 63 |arted in| the.inc|
|00003e50| 6c 75 64 69 6e 67 20 66 | 69 6c 65 2e 20 20 48 6f |luding f|ile. Ho|
|00003e60| 77 65 76 65 72 2c 20 61 | 20 63 6f 6d 6d 65 6e 74 |wever, a| comment|
|00003e70| 20 6f 72 20 61 20 73 74 | 72 69 6e 67 20 6f 72 20 | or a st|ring or |
|00003e80| 63 68 61 72 61 63 74 65 | 72 20 63 6f 6e 73 74 61 |characte|r consta|
|00003e90| 6e 74 0a 6d 61 79 20 6e | 6f 74 20 73 74 61 72 74 |nt.may n|ot start|
|00003ea0| 20 69 6e 20 74 68 65 20 | 69 6e 63 6c 75 64 65 64 | in the |included|
|00003eb0| 20 66 69 6c 65 20 61 6e | 64 20 66 69 6e 69 73 68 | file an|d finish|
|00003ec0| 20 69 6e 20 74 68 65 20 | 69 6e 63 6c 75 64 69 6e | in the |includin|
|00003ed0| 67 20 66 69 6c 65 2e 0a | 41 6e 20 75 6e 74 65 72 |g file..|An unter|
|00003ee0| 6d 69 6e 61 74 65 64 20 | 63 6f 6d 6d 65 6e 74 2c |minated |comment,|
|00003ef0| 20 73 74 72 69 6e 67 20 | 63 6f 6e 73 74 61 6e 74 | string |constant|
|00003f00| 20 6f 72 20 63 68 61 72 | 61 63 74 65 72 20 63 6f | or char|acter co|
|00003f10| 6e 73 74 61 6e 74 20 69 | 6e 20 61 6e 0a 69 6e 63 |nstant i|n an.inc|
|00003f20| 6c 75 64 65 64 20 66 69 | 6c 65 20 69 73 20 63 6f |luded fi|le is co|
|00003f30| 6e 73 69 64 65 72 65 64 | 20 74 6f 20 65 6e 64 20 |nsidered| to end |
|00003f40| 28 77 69 74 68 20 61 6e | 20 65 72 72 6f 72 20 6d |(with an| error m|
|00003f50| 65 73 73 61 67 65 29 20 | 61 74 20 74 68 65 20 65 |essage) |at the e|
|00003f60| 6e 64 0a 6f 66 20 74 68 | 65 20 66 69 6c 65 2e 0a |nd.of th|e file..|
|00003f70| 0a 20 20 20 54 68 65 20 | 6c 69 6e 65 20 66 6f 6c |. The |line fol|
|00003f80| 6c 6f 77 69 6e 67 20 74 | 68 65 20 60 23 69 6e 63 |lowing t|he `#inc|
|00003f90| 6c 75 64 65 27 20 63 6f | 6d 6d 61 6e 64 20 69 73 |lude' co|mmand is|
|00003fa0| 20 61 6c 77 61 79 73 20 | 74 72 65 61 74 65 64 20 | always |treated |
|00003fb0| 61 73 20 61 0a 73 65 70 | 61 72 61 74 65 20 6c 69 |as a.sep|arate li|
|00003fc0| 6e 65 20 62 79 20 74 68 | 65 20 43 20 70 72 65 70 |ne by th|e C prep|
|00003fd0| 72 6f 63 65 73 73 6f 72 | 20 65 76 65 6e 20 69 66 |rocessor| even if|
|00003fe0| 20 74 68 65 20 69 6e 63 | 6c 75 64 65 64 20 66 69 | the inc|luded fi|
|00003ff0| 6c 65 20 6c 61 63 6b 73 | 20 61 0a 66 69 6e 61 6c |le lacks| a.final|
|00004000| 20 6e 65 77 6c 69 6e 65 | 2e 0a 0a 40 45 6e 64 4e | newline|...@EndN|
|00004010| 6f 64 65 0a 0a 0a 40 4e | 6f 64 65 20 22 4f 6e 63 |ode...@N|ode "Onc|
|00004020| 65 2d 4f 6e 6c 79 22 20 | 22 4f 6e 63 65 2d 4f 6e |e-Only" |"Once-On|
|00004030| 6c 79 22 0a 40 4e 65 78 | 74 20 22 49 6e 68 65 72 |ly".@Nex|t "Inher|
|00004040| 69 74 61 6e 63 65 22 20 | 22 49 6e 68 65 72 69 74 |itance" |"Inherit|
|00004050| 61 6e 63 65 22 0a 40 50 | 72 65 76 20 22 49 6e 63 |ance".@P|rev "Inc|
|00004060| 6c 75 64 65 20 4f 70 65 | 72 61 74 69 6f 6e 22 20 |lude Ope|ration" |
|00004070| 22 49 6e 63 6c 75 64 65 | 20 4f 70 65 72 61 74 69 |"Include| Operati|
|00004080| 6f 6e 22 0a 40 54 6f 63 | 20 22 48 65 61 64 65 72 |on".@Toc| "Header|
|00004090| 20 46 69 6c 65 73 22 20 | 22 48 65 61 64 65 72 20 | Files" |"Header |
|000040a0| 46 69 6c 65 73 22 0a 4f | 6e 63 65 2d 4f 6e 6c 79 |Files".O|nce-Only|
|000040b0| 20 49 6e 63 6c 75 64 65 | 20 46 69 6c 65 73 0a 2d | Include| Files.-|
|000040c0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000040d0| 2d 2d 2d 2d 2d 2d 0a 0a | 20 20 20 56 65 72 79 20 |------..| Very |
|000040e0| 6f 66 74 65 6e 2c 20 6f | 6e 65 20 68 65 61 64 65 |often, o|ne heade|
|000040f0| 72 20 66 69 6c 65 20 69 | 6e 63 6c 75 64 65 73 20 |r file i|ncludes |
|00004100| 61 6e 6f 74 68 65 72 2e | 20 20 49 74 20 63 61 6e |another.| It can|
|00004110| 20 65 61 73 69 6c 79 20 | 72 65 73 75 6c 74 0a 74 | easily |result.t|
|00004120| 68 61 74 20 61 20 63 65 | 72 74 61 69 6e 20 68 65 |hat a ce|rtain he|
|00004130| 61 64 65 72 20 66 69 6c | 65 20 69 73 20 69 6e 63 |ader fil|e is inc|
|00004140| 6c 75 64 65 64 20 6d 6f | 72 65 20 74 68 61 6e 20 |luded mo|re than |
|00004150| 6f 6e 63 65 2e 20 20 54 | 68 69 73 20 6d 61 79 20 |once. T|his may |
|00004160| 6c 65 61 64 0a 74 6f 20 | 65 72 72 6f 72 73 2c 20 |lead.to |errors, |
|00004170| 69 66 20 74 68 65 20 68 | 65 61 64 65 72 20 66 69 |if the h|eader fi|
|00004180| 6c 65 20 64 65 66 69 6e | 65 73 20 73 74 72 75 63 |le defin|es struc|
|00004190| 74 75 72 65 20 74 79 70 | 65 73 20 6f 72 20 74 79 |ture typ|es or ty|
|000041a0| 70 65 64 65 66 73 2c 20 | 61 6e 64 0a 69 73 20 63 |pedefs, |and.is c|
|000041b0| 65 72 74 61 69 6e 6c 79 | 20 77 61 73 74 65 66 75 |ertainly| wastefu|
|000041c0| 6c 2e 20 20 54 68 65 72 | 65 66 6f 72 65 2c 20 77 |l. Ther|efore, w|
|000041d0| 65 20 6f 66 74 65 6e 20 | 77 69 73 68 20 74 6f 20 |e often |wish to |
|000041e0| 70 72 65 76 65 6e 74 20 | 6d 75 6c 74 69 70 6c 65 |prevent |multiple|
|000041f0| 0a 69 6e 63 6c 75 73 69 | 6f 6e 20 6f 66 20 61 20 |.inclusi|on of a |
|00004200| 68 65 61 64 65 72 20 66 | 69 6c 65 2e 0a 0a 20 20 |header f|ile... |
|00004210| 20 54 68 65 20 73 74 61 | 6e 64 61 72 64 20 77 61 | The sta|ndard wa|
|00004220| 79 20 74 6f 20 64 6f 20 | 74 68 69 73 20 69 73 20 |y to do |this is |
|00004230| 74 6f 20 65 6e 63 6c 6f | 73 65 20 74 68 65 20 65 |to enclo|se the e|
|00004240| 6e 74 69 72 65 20 72 65 | 61 6c 20 63 6f 6e 74 65 |ntire re|al conte|
|00004250| 6e 74 73 0a 6f 66 20 74 | 68 65 20 66 69 6c 65 20 |nts.of t|he file |
|00004260| 69 6e 20 61 20 63 6f 6e | 64 69 74 69 6f 6e 61 6c |in a con|ditional|
|00004270| 2c 20 6c 69 6b 65 20 74 | 68 69 73 3a 0a 0a 20 20 |, like t|his:.. |
|00004280| 20 20 20 23 69 66 6e 64 | 65 66 20 5f 5f 46 49 4c | #ifnd|ef __FIL|
|00004290| 45 5f 46 4f 4f 5f 53 45 | 45 4e 5f 5f 0a 20 20 20 |E_FOO_SE|EN__. |
|000042a0| 20 20 23 64 65 66 69 6e | 65 20 5f 5f 46 49 4c 45 | #defin|e __FILE|
|000042b0| 5f 46 4f 4f 5f 53 45 45 | 4e 5f 5f 0a 20 20 20 20 |_FOO_SEE|N__. |
|000042c0| 20 0a 20 20 20 20 20 54 | 48 45 20 45 4e 54 49 52 | . T|HE ENTIR|
|000042d0| 45 20 46 49 4c 45 0a 20 | 20 20 20 20 0a 20 20 20 |E FILE. | . |
|000042e0| 20 20 23 65 6e 64 69 66 | 20 2f 2a 20 5f 5f 46 49 | #endif| /* __FI|
|000042f0| 4c 45 5f 46 4f 4f 5f 53 | 45 45 4e 5f 5f 20 2a 2f |LE_FOO_S|EEN__ */|
|00004300| 0a 0a 20 20 20 54 68 65 | 20 6d 61 63 72 6f 20 60 |.. The| macro `|
|00004310| 5f 5f 46 49 4c 45 5f 46 | 4f 4f 5f 53 45 45 4e 5f |__FILE_F|OO_SEEN_|
|00004320| 5f 27 20 69 6e 64 69 63 | 61 74 65 73 20 74 68 61 |_' indic|ates tha|
|00004330| 74 20 74 68 65 20 66 69 | 6c 65 20 68 61 73 20 62 |t the fi|le has b|
|00004340| 65 65 6e 0a 69 6e 63 6c | 75 64 65 64 20 6f 6e 63 |een.incl|uded onc|
|00004350| 65 20 61 6c 72 65 61 64 | 79 3b 20 69 74 73 20 6e |e alread|y; its n|
|00004360| 61 6d 65 20 73 68 6f 75 | 6c 64 20 62 65 67 69 6e |ame shou|ld begin|
|00004370| 20 77 69 74 68 20 60 5f | 5f 27 20 74 6f 20 61 76 | with `_|_' to av|
|00004380| 6f 69 64 0a 63 6f 6e 66 | 6c 69 63 74 73 20 77 69 |oid.conf|licts wi|
|00004390| 74 68 20 75 73 65 72 20 | 70 72 6f 67 72 61 6d 73 |th user |programs|
|000043a0| 2c 20 61 6e 64 20 69 74 | 20 73 68 6f 75 6c 64 20 |, and it| should |
|000043b0| 63 6f 6e 74 61 69 6e 20 | 74 68 65 20 6e 61 6d 65 |contain |the name|
|000043c0| 20 6f 66 20 74 68 65 20 | 66 69 6c 65 0a 61 6e 64 | of the |file.and|
|000043d0| 20 73 6f 6d 65 20 61 64 | 64 69 74 69 6f 6e 61 6c | some ad|ditional|
|000043e0| 20 74 65 78 74 2c 20 74 | 6f 20 61 76 6f 69 64 20 | text, t|o avoid |
|000043f0| 63 6f 6e 66 6c 69 63 74 | 73 20 77 69 74 68 20 6f |conflict|s with o|
|00004400| 74 68 65 72 20 68 65 61 | 64 65 72 20 66 69 6c 65 |ther hea|der file|
|00004410| 73 2e 0a 0a 20 20 20 54 | 68 65 20 47 4e 55 20 43 |s... T|he GNU C|
|00004420| 20 70 72 65 70 72 6f 63 | 65 73 73 6f 72 20 69 73 | preproc|essor is|
|00004430| 20 70 72 6f 67 72 61 6d | 6d 65 64 20 74 6f 20 6e | program|med to n|
|00004440| 6f 74 69 63 65 20 77 68 | 65 6e 20 61 20 68 65 61 |otice wh|en a hea|
|00004450| 64 65 72 20 66 69 6c 65 | 0a 75 73 65 73 20 74 68 |der file|.uses th|
|00004460| 69 73 20 70 61 72 74 69 | 63 75 6c 61 72 20 63 6f |is parti|cular co|
|00004470| 6e 73 74 72 75 63 74 20 | 61 6e 64 20 68 61 6e 64 |nstruct |and hand|
|00004480| 6c 65 20 69 74 20 65 66 | 66 69 63 69 65 6e 74 6c |le it ef|ficientl|
|00004490| 79 2e 20 20 49 66 20 61 | 20 68 65 61 64 65 72 0a |y. If a| header.|
|000044a0| 66 69 6c 65 20 69 73 20 | 63 6f 6e 74 61 69 6e 65 |file is |containe|
|000044b0| 64 20 65 6e 74 69 72 65 | 6c 79 20 69 6e 20 61 20 |d entire|ly in a |
|000044c0| 60 23 69 66 6e 64 65 66 | 27 20 63 6f 6e 64 69 74 |`#ifndef|' condit|
|000044d0| 69 6f 6e 61 6c 2c 20 74 | 68 65 6e 20 69 74 20 72 |ional, t|hen it r|
|000044e0| 65 63 6f 72 64 73 0a 74 | 68 61 74 20 66 61 63 74 |ecords.t|hat fact|
|000044f0| 2e 20 20 49 66 20 61 20 | 73 75 62 73 65 71 75 65 |. If a |subseque|
|00004500| 6e 74 20 60 23 69 6e 63 | 6c 75 64 65 27 20 73 70 |nt `#inc|lude' sp|
|00004510| 65 63 69 66 69 65 73 20 | 74 68 65 20 73 61 6d 65 |ecifies |the same|
|00004520| 20 66 69 6c 65 2c 20 61 | 6e 64 20 74 68 65 0a 6d | file, a|nd the.m|
|00004530| 61 63 72 6f 20 69 6e 20 | 74 68 65 20 60 23 69 66 |acro in |the `#if|
|00004540| 6e 64 65 66 27 20 69 73 | 20 61 6c 72 65 61 64 79 |ndef' is| already|
|00004550| 20 64 65 66 69 6e 65 64 | 2c 20 74 68 65 6e 20 74 | defined|, then t|
|00004560| 68 65 20 66 69 6c 65 20 | 69 73 20 65 6e 74 69 72 |he file |is entir|
|00004570| 65 6c 79 0a 73 6b 69 70 | 70 65 64 2c 20 77 69 74 |ely.skip|ped, wit|
|00004580| 68 6f 75 74 20 65 76 65 | 6e 20 72 65 61 64 69 6e |hout eve|n readin|
|00004590| 67 20 69 74 2e 0a 0a 20 | 20 20 54 68 65 72 65 20 |g it... | There |
|000045a0| 69 73 20 61 6c 73 6f 20 | 61 6e 20 65 78 70 6c 69 |is also |an expli|
|000045b0| 63 69 74 20 63 6f 6d 6d | 61 6e 64 20 74 6f 20 74 |cit comm|and to t|
|000045c0| 65 6c 6c 20 74 68 65 20 | 70 72 65 70 72 6f 63 65 |ell the |preproce|
|000045d0| 73 73 6f 72 20 74 68 61 | 74 20 69 74 0a 6e 65 65 |ssor tha|t it.nee|
|000045e0| 64 20 6e 6f 74 20 69 6e | 63 6c 75 64 65 20 61 20 |d not in|clude a |
|000045f0| 66 69 6c 65 20 6d 6f 72 | 65 20 74 68 61 6e 20 6f |file mor|e than o|
|00004600| 6e 63 65 2e 20 20 54 68 | 69 73 20 69 73 20 63 61 |nce. Th|is is ca|
|00004610| 6c 6c 65 64 20 60 23 70 | 72 61 67 6d 61 20 6f 6e |lled `#p|ragma on|
|00004620| 63 65 27 2c 0a 61 6e 64 | 20 77 61 73 20 75 73 65 |ce',.and| was use|
|00004630| 64 20 2a 69 6e 20 61 64 | 64 69 74 69 6f 6e 20 74 |d *in ad|dition t|
|00004640| 6f 2a 20 74 68 65 20 60 | 23 69 66 6e 64 65 66 27 |o* the `|#ifndef'|
|00004650| 20 63 6f 6e 64 69 74 69 | 6f 6e 61 6c 20 61 72 6f | conditi|onal aro|
|00004660| 75 6e 64 20 74 68 65 0a | 63 6f 6e 74 65 6e 74 73 |und the.|contents|
|00004670| 20 6f 66 20 74 68 65 20 | 68 65 61 64 65 72 20 66 | of the |header f|
|00004680| 69 6c 65 2e 20 20 60 23 | 70 72 61 67 6d 61 20 6f |ile. `#|pragma o|
|00004690| 6e 63 65 27 20 69 73 20 | 6e 6f 77 20 6f 62 73 6f |nce' is |now obso|
|000046a0| 6c 65 74 65 20 61 6e 64 | 20 73 68 6f 75 6c 64 0a |lete and| should.|
|000046b0| 6e 6f 74 20 62 65 20 75 | 73 65 64 20 61 74 20 61 |not be u|sed at a|
|000046c0| 6c 6c 2e 0a 0a 20 20 20 | 49 6e 20 74 68 65 20 4f |ll... |In the O|
|000046d0| 62 6a 65 63 74 69 76 65 | 20 43 20 6c 61 6e 67 75 |bjective| C langu|
|000046e0| 61 67 65 2c 20 74 68 65 | 72 65 20 69 73 20 61 20 |age, the|re is a |
|000046f0| 76 61 72 69 61 6e 74 20 | 6f 66 20 60 23 69 6e 63 |variant |of `#inc|
|00004700| 6c 75 64 65 27 20 63 61 | 6c 6c 65 64 0a 60 23 69 |lude' ca|lled.`#i|
|00004710| 6d 70 6f 72 74 27 20 77 | 68 69 63 68 20 69 6e 63 |mport' w|hich inc|
|00004720| 6c 75 64 65 73 20 61 20 | 66 69 6c 65 2c 20 62 75 |ludes a |file, bu|
|00004730| 74 20 64 6f 65 73 20 73 | 6f 20 61 74 20 6d 6f 73 |t does s|o at mos|
|00004740| 74 20 6f 6e 63 65 2e 20 | 20 49 66 20 79 6f 75 20 |t once. | If you |
|00004750| 75 73 65 0a 60 23 69 6d | 70 6f 72 74 27 20 2a 69 |use.`#im|port' *i|
|00004760| 6e 73 74 65 61 64 20 6f | 66 2a 20 60 23 69 6e 63 |nstead o|f* `#inc|
|00004770| 6c 75 64 65 27 2c 20 74 | 68 65 6e 20 79 6f 75 20 |lude', t|hen you |
|00004780| 64 6f 6e 27 74 20 6e 65 | 65 64 20 74 68 65 20 63 |don't ne|ed the c|
|00004790| 6f 6e 64 69 74 69 6f 6e | 61 6c 73 0a 69 6e 73 69 |ondition|als.insi|
|000047a0| 64 65 20 74 68 65 20 68 | 65 61 64 65 72 20 66 69 |de the h|eader fi|
|000047b0| 6c 65 20 74 6f 20 70 72 | 65 76 65 6e 74 20 6d 75 |le to pr|event mu|
|000047c0| 6c 74 69 70 6c 65 20 65 | 78 65 63 75 74 69 6f 6e |ltiple e|xecution|
|000047d0| 20 6f 66 20 74 68 65 20 | 63 6f 6e 74 65 6e 74 73 | of the |contents|
|000047e0| 2e 0a 0a 20 20 20 60 23 | 69 6d 70 6f 72 74 27 20 |... `#|import' |
|000047f0| 69 73 20 6f 62 73 6f 6c | 65 74 65 20 62 65 63 61 |is obsol|ete beca|
|00004800| 75 73 65 20 69 74 20 69 | 73 20 6e 6f 74 20 61 20 |use it i|s not a |
|00004810| 77 65 6c 6c 2d 64 65 73 | 69 67 6e 65 64 20 66 65 |well-des|igned fe|
|00004820| 61 74 75 72 65 2e 20 20 | 49 74 0a 72 65 71 75 69 |ature. |It.requi|
|00004830| 72 65 73 20 74 68 65 20 | 75 73 65 72 73 20 6f 66 |res the |users of|
|00004840| 20 61 20 68 65 61 64 65 | 72 20 66 69 6c 65 2d 2d | a heade|r file--|
|00004850| 74 68 65 20 61 70 70 6c | 69 63 61 74 69 6f 6e 73 |the appl|ications|
|00004860| 20 70 72 6f 67 72 61 6d | 6d 65 72 73 2d 2d 74 6f | program|mers--to|
|00004870| 0a 6b 6e 6f 77 20 74 68 | 61 74 20 61 20 63 65 72 |.know th|at a cer|
|00004880| 74 61 69 6e 20 68 65 61 | 64 65 72 20 66 69 6c 65 |tain hea|der file|
|00004890| 20 73 68 6f 75 6c 64 20 | 6f 6e 6c 79 20 62 65 20 | should |only be |
|000048a0| 69 6e 63 6c 75 64 65 64 | 20 6f 6e 63 65 2e 20 20 |included| once. |
|000048b0| 49 74 20 69 73 0a 6d 75 | 63 68 20 62 65 74 74 65 |It is.mu|ch bette|
|000048c0| 72 20 66 6f 72 20 74 68 | 65 20 68 65 61 64 65 72 |r for th|e header|
|000048d0| 20 66 69 6c 65 27 73 20 | 69 6d 70 6c 65 6d 65 6e | file's |implemen|
|000048e0| 74 6f 72 20 74 6f 20 77 | 72 69 74 65 20 74 68 65 |tor to w|rite the|
|000048f0| 20 66 69 6c 65 20 73 6f | 20 74 68 61 74 0a 75 73 | file so| that.us|
|00004900| 65 72 73 20 64 6f 6e 27 | 74 20 6e 65 65 64 20 74 |ers don'|t need t|
|00004910| 6f 20 6b 6e 6f 77 20 74 | 68 69 73 2e 20 20 55 73 |o know t|his. Us|
|00004920| 69 6e 67 20 60 23 69 66 | 6e 64 65 66 27 20 61 63 |ing `#if|ndef' ac|
|00004930| 63 6f 6d 70 6c 69 73 68 | 65 73 20 74 68 69 73 20 |complish|es this |
|00004940| 67 6f 61 6c 2e 0a 0a 40 | 45 6e 64 4e 6f 64 65 0a |goal...@|EndNode.|
|00004950| 0a 0a 40 4e 6f 64 65 20 | 22 49 6e 68 65 72 69 74 |..@Node |"Inherit|
|00004960| 61 6e 63 65 22 20 22 49 | 6e 68 65 72 69 74 61 6e |ance" "I|nheritan|
|00004970| 63 65 22 0a 40 50 72 65 | 76 20 22 4f 6e 63 65 2d |ce".@Pre|v "Once-|
|00004980| 4f 6e 6c 79 22 20 22 4f | 6e 63 65 2d 4f 6e 6c 79 |Only" "O|nce-Only|
|00004990| 22 0a 40 54 6f 63 20 22 | 48 65 61 64 65 72 20 46 |".@Toc "|Header F|
|000049a0| 69 6c 65 73 22 20 22 48 | 65 61 64 65 72 20 46 69 |iles" "H|eader Fi|
|000049b0| 6c 65 73 22 0a 49 6e 68 | 65 72 69 74 61 6e 63 65 |les".Inh|eritance|
|000049c0| 20 61 6e 64 20 48 65 61 | 64 65 72 20 46 69 6c 65 | and Hea|der File|
|000049d0| 73 0a 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 3d 3d |s.======|========|
|000049e0| 3d 3d 3d 3d 3d 3d 3d 3d | 3d 3d 3d 3d 3d 3d 0a 0a |========|======..|
|000049f0| 20 20 20 22 49 6e 68 65 | 72 69 74 61 6e 63 65 22 | "Inhe|ritance"|
|00004a00| 20 69 73 20 77 68 61 74 | 20 68 61 70 70 65 6e 73 | is what| happens|
|00004a10| 20 77 68 65 6e 20 6f 6e | 65 20 6f 62 6a 65 63 74 | when on|e object|
|00004a20| 20 6f 72 20 66 69 6c 65 | 20 64 65 72 69 76 65 73 | or file| derives|
|00004a30| 20 73 6f 6d 65 0a 6f 66 | 20 69 74 73 20 63 6f 6e | some.of| its con|
|00004a40| 74 65 6e 74 73 20 62 79 | 20 76 69 72 74 75 61 6c |tents by| virtual|
|00004a50| 20 63 6f 70 79 69 6e 67 | 20 66 72 6f 6d 20 61 6e | copying| from an|
|00004a60| 6f 74 68 65 72 20 6f 62 | 6a 65 63 74 20 6f 72 20 |other ob|ject or |
|00004a70| 66 69 6c 65 2e 20 20 49 | 6e 20 74 68 65 0a 63 61 |file. I|n the.ca|
|00004a80| 73 65 20 6f 66 20 43 20 | 68 65 61 64 65 72 20 66 |se of C |header f|
|00004a90| 69 6c 65 73 2c 20 69 6e | 68 65 72 69 74 61 6e 63 |iles, in|heritanc|
|00004aa0| 65 20 6d 65 61 6e 73 20 | 74 68 61 74 20 6f 6e 65 |e means |that one|
|00004ab0| 20 68 65 61 64 65 72 20 | 66 69 6c 65 20 69 6e 63 | header |file inc|
|00004ac0| 6c 75 64 65 73 0a 61 6e | 6f 74 68 65 72 20 68 65 |ludes.an|other he|
|00004ad0| 61 64 65 72 20 66 69 6c | 65 20 61 6e 64 20 74 68 |ader fil|e and th|
|00004ae0| 65 6e 20 72 65 70 6c 61 | 63 65 73 20 6f 72 20 61 |en repla|ces or a|
|00004af0| 64 64 73 20 73 6f 6d 65 | 74 68 69 6e 67 2e 0a 0a |dds some|thing...|
|00004b00| 20 20 20 49 66 20 74 68 | 65 20 69 6e 68 65 72 69 | If th|e inheri|
|00004b10| 74 69 6e 67 20 68 65 61 | 64 65 72 20 66 69 6c 65 |ting hea|der file|
|00004b20| 20 61 6e 64 20 74 68 65 | 20 62 61 73 65 20 68 65 | and the| base he|
|00004b30| 61 64 65 72 20 66 69 6c | 65 20 68 61 76 65 20 64 |ader fil|e have d|
|00004b40| 69 66 66 65 72 65 6e 74 | 0a 6e 61 6d 65 73 2c 20 |ifferent|.names, |
|00004b50| 74 68 65 6e 20 69 6e 68 | 65 72 69 74 61 6e 63 65 |then inh|eritance|
|00004b60| 20 69 73 20 73 74 72 61 | 69 67 68 74 66 6f 72 77 | is stra|ightforw|
|00004b70| 61 72 64 3a 20 73 69 6d | 70 6c 79 20 77 72 69 74 |ard: sim|ply writ|
|00004b80| 65 20 60 23 69 6e 63 6c | 75 64 65 0a 22 42 41 53 |e `#incl|ude."BAS|
|00004b90| 45 22 27 20 69 6e 20 74 | 68 65 20 69 6e 68 65 72 |E"' in t|he inher|
|00004ba0| 69 74 69 6e 67 20 66 69 | 6c 65 2e 0a 0a 20 20 20 |iting fi|le... |
|00004bb0| 53 6f 6d 65 74 69 6d 65 | 73 20 69 74 20 69 73 20 |Sometime|s it is |
|00004bc0| 6e 65 63 65 73 73 61 72 | 79 20 74 6f 20 67 69 76 |necessar|y to giv|
|00004bd0| 65 20 74 68 65 20 69 6e | 68 65 72 69 74 69 6e 67 |e the in|heriting|
|00004be0| 20 66 69 6c 65 20 74 68 | 65 20 73 61 6d 65 20 6e | file th|e same n|
|00004bf0| 61 6d 65 0a 61 73 20 74 | 68 65 20 62 61 73 65 20 |ame.as t|he base |
|00004c00| 66 69 6c 65 2e 20 20 54 | 68 69 73 20 69 73 20 6c |file. T|his is l|
|00004c10| 65 73 73 20 73 74 72 61 | 69 67 68 74 66 6f 72 77 |ess stra|ightforw|
|00004c20| 61 72 64 2e 0a 0a 20 20 | 20 46 6f 72 20 65 78 61 |ard... | For exa|
|00004c30| 6d 70 6c 65 2c 20 73 75 | 70 70 6f 73 65 20 61 6e |mple, su|ppose an|
|00004c40| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 20 70 72 6f | applica|tion pro|
|00004c50| 67 72 61 6d 20 75 73 65 | 73 20 74 68 65 20 73 79 |gram use|s the sy|
|00004c60| 73 74 65 6d 20 68 65 61 | 64 65 72 0a 66 69 6c 65 |stem hea|der.file|
|00004c70| 20 60 73 79 73 2f 73 69 | 67 6e 61 6c 2e 68 27 2c | `sys/si|gnal.h',|
|00004c80| 20 62 75 74 20 74 68 65 | 20 76 65 72 73 69 6f 6e | but the| version|
|00004c90| 20 6f 66 20 60 2f 75 73 | 72 2f 69 6e 63 6c 75 64 | of `/us|r/includ|
|00004ca0| 65 2f 73 79 73 2f 73 69 | 67 6e 61 6c 2e 68 27 20 |e/sys/si|gnal.h' |
|00004cb0| 6f 6e 0a 61 20 70 61 72 | 74 69 63 75 6c 61 72 20 |on.a par|ticular |
|00004cc0| 73 79 73 74 65 6d 20 64 | 6f 65 73 6e 27 74 20 64 |system d|oesn't d|
|00004cd0| 6f 20 77 68 61 74 20 74 | 68 65 20 61 70 70 6c 69 |o what t|he appli|
|00004ce0| 63 61 74 69 6f 6e 20 70 | 72 6f 67 72 61 6d 20 65 |cation p|rogram e|
|00004cf0| 78 70 65 63 74 73 2e 0a | 49 74 20 6d 69 67 68 74 |xpects..|It might|
|00004d00| 20 62 65 20 63 6f 6e 76 | 65 6e 69 65 6e 74 20 74 | be conv|enient t|
|00004d10| 6f 20 64 65 66 69 6e 65 | 20 61 20 22 6c 6f 63 61 |o define| a "loca|
|00004d20| 6c 22 20 76 65 72 73 69 | 6f 6e 2c 20 70 65 72 68 |l" versi|on, perh|
|00004d30| 61 70 73 20 75 6e 64 65 | 72 20 74 68 65 0a 6e 61 |aps unde|r the.na|
|00004d40| 6d 65 20 60 2f 75 73 72 | 2f 6c 6f 63 61 6c 2f 69 |me `/usr|/local/i|
|00004d50| 6e 63 6c 75 64 65 2f 73 | 79 73 2f 73 69 67 6e 61 |nclude/s|ys/signa|
|00004d60| 6c 2e 68 27 2c 20 74 6f | 20 6f 76 65 72 72 69 64 |l.h', to| overrid|
|00004d70| 65 20 6f 72 20 61 64 64 | 20 74 6f 20 74 68 65 20 |e or add| to the |
|00004d80| 6f 6e 65 0a 73 75 70 70 | 6c 69 65 64 20 62 79 20 |one.supp|lied by |
|00004d90| 74 68 65 20 73 79 73 74 | 65 6d 2e 0a 0a 20 20 20 |the syst|em... |
|00004da0| 59 6f 75 20 63 61 6e 20 | 64 6f 20 74 68 69 73 20 |You can |do this |
|00004db0| 62 79 20 75 73 69 6e 67 | 20 74 68 65 20 6f 70 74 |by using| the opt|
|00004dc0| 69 6f 6e 20 60 2d 49 2e | 27 20 66 6f 72 20 63 6f |ion `-I.|' for co|
|00004dd0| 6d 70 69 6c 61 74 69 6f | 6e 2c 20 61 6e 64 0a 77 |mpilatio|n, and.w|
|00004de0| 72 69 74 69 6e 67 20 61 | 20 66 69 6c 65 20 60 73 |riting a| file `s|
|00004df0| 79 73 2f 73 69 67 6e 61 | 6c 2e 68 27 20 74 68 61 |ys/signa|l.h' tha|
|00004e00| 74 20 64 6f 65 73 20 77 | 68 61 74 20 74 68 65 20 |t does w|hat the |
|00004e10| 61 70 70 6c 69 63 61 74 | 69 6f 6e 20 70 72 6f 67 |applicat|ion prog|
|00004e20| 72 61 6d 0a 65 78 70 65 | 63 74 73 2e 20 20 42 75 |ram.expe|cts. Bu|
|00004e30| 74 20 6d 61 6b 69 6e 67 | 20 74 68 69 73 20 66 69 |t making| this fi|
|00004e40| 6c 65 20 69 6e 63 6c 75 | 64 65 20 74 68 65 20 73 |le inclu|de the s|
|00004e50| 74 61 6e 64 61 72 64 20 | 60 73 79 73 2f 73 69 67 |tandard |`sys/sig|
|00004e60| 6e 61 6c 2e 68 27 20 69 | 73 0a 6e 6f 74 20 73 6f |nal.h' i|s.not so|
|00004e70| 20 65 61 73 79 2d 2d 77 | 72 69 74 69 6e 67 20 60 | easy--w|riting `|
|00004e80| 23 69 6e 63 6c 75 64 65 | 20 3c 73 79 73 2f 73 69 |#include| <sys/si|
|00004e90| 67 6e 61 6c 2e 68 3e 27 | 20 69 6e 20 74 68 61 74 |gnal.h>'| in that|
|00004ea0| 20 66 69 6c 65 20 64 6f | 65 73 6e 27 74 0a 77 6f | file do|esn't.wo|
|00004eb0| 72 6b 2c 20 62 65 63 61 | 75 73 65 20 69 74 20 69 |rk, beca|use it i|
|00004ec0| 6e 63 6c 75 64 65 73 20 | 79 6f 75 72 20 6f 77 6e |ncludes |your own|
|00004ed0| 20 76 65 72 73 69 6f 6e | 20 6f 66 20 74 68 65 20 | version| of the |
|00004ee0| 66 69 6c 65 2c 20 6e 6f | 74 20 74 68 65 0a 73 74 |file, no|t the.st|
|00004ef0| 61 6e 64 61 72 64 20 73 | 79 73 74 65 6d 20 76 65 |andard s|ystem ve|
|00004f00| 72 73 69 6f 6e 2e 20 20 | 55 73 65 64 20 69 6e 20 |rsion. |Used in |
|00004f10| 74 68 61 74 20 66 69 6c | 65 20 69 74 73 65 6c 66 |that fil|e itself|
|00004f20| 2c 20 74 68 69 73 20 6c | 65 61 64 73 20 74 6f 20 |, this l|eads to |
|00004f30| 61 6e 0a 69 6e 66 69 6e | 69 74 65 20 72 65 63 75 |an.infin|ite recu|
|00004f40| 72 73 69 6f 6e 20 61 6e | 64 20 61 20 66 61 74 61 |rsion an|d a fata|
|00004f50| 6c 20 65 72 72 6f 72 20 | 69 6e 20 63 6f 6d 70 69 |l error |in compi|
|00004f60| 6c 61 74 69 6f 6e 2e 0a | 0a 20 20 20 60 23 69 6e |lation..|. `#in|
|00004f70| 63 6c 75 64 65 20 3c 2f | 75 73 72 2f 69 6e 63 6c |clude </|usr/incl|
|00004f80| 75 64 65 2f 73 79 73 2f | 73 69 67 6e 61 6c 2e 68 |ude/sys/|signal.h|
|00004f90| 3e 27 20 77 6f 75 6c 64 | 20 66 69 6e 64 20 74 68 |>' would| find th|
|00004fa0| 65 20 70 72 6f 70 65 72 | 20 66 69 6c 65 2c 0a 62 |e proper| file,.b|
|00004fb0| 75 74 20 74 68 61 74 20 | 69 73 20 6e 6f 74 20 63 |ut that |is not c|
|00004fc0| 6c 65 61 6e 2c 20 73 69 | 6e 63 65 20 69 74 20 6d |lean, si|nce it m|
|00004fd0| 61 6b 65 73 20 61 6e 20 | 61 73 73 75 6d 70 74 69 |akes an |assumpti|
|00004fe0| 6f 6e 20 61 62 6f 75 74 | 20 77 68 65 72 65 20 74 |on about| where t|
|00004ff0| 68 65 0a 73 79 73 74 65 | 6d 20 68 65 61 64 65 72 |he.syste|m header|
|00005000| 20 66 69 6c 65 20 69 73 | 20 66 6f 75 6e 64 2e 20 | file is| found. |
|00005010| 20 54 68 69 73 20 69 73 | 20 62 61 64 20 66 6f 72 | This is| bad for|
|00005020| 20 6d 61 69 6e 74 65 6e | 61 6e 63 65 2c 20 73 69 | mainten|ance, si|
|00005030| 6e 63 65 20 69 74 0a 6d | 65 61 6e 73 20 74 68 61 |nce it.m|eans tha|
|00005040| 74 20 61 6e 79 20 63 68 | 61 6e 67 65 20 69 6e 20 |t any ch|ange in |
|00005050| 77 68 65 72 65 20 74 68 | 65 20 73 79 73 74 65 6d |where th|e system|
|00005060| 27 73 20 68 65 61 64 65 | 72 20 66 69 6c 65 73 20 |'s heade|r files |
|00005070| 61 72 65 20 6b 65 70 74 | 0a 72 65 71 75 69 72 65 |are kept|.require|
|00005080| 73 20 61 20 63 68 61 6e | 67 65 20 73 6f 6d 65 77 |s a chan|ge somew|
|00005090| 68 65 72 65 20 65 6c 73 | 65 2e 0a 0a 20 20 20 54 |here els|e... T|
|000050a0| 68 65 20 63 6c 65 61 6e | 20 77 61 79 20 74 6f 20 |he clean| way to |
|000050b0| 73 6f 6c 76 65 20 74 68 | 69 73 20 70 72 6f 62 6c |solve th|is probl|
|000050c0| 65 6d 20 69 73 20 74 6f | 20 75 73 65 20 60 23 69 |em is to| use `#i|
|000050d0| 6e 63 6c 75 64 65 5f 6e | 65 78 74 27 2c 20 77 68 |nclude_n|ext', wh|
|000050e0| 69 63 68 0a 6d 65 61 6e | 73 2c 20 22 49 6e 63 6c |ich.mean|s, "Incl|
|000050f0| 75 64 65 20 74 68 65 20 | 2a 6e 65 78 74 2a 20 66 |ude the |*next* f|
|00005100| 69 6c 65 20 77 69 74 68 | 20 74 68 69 73 20 6e 61 |ile with| this na|
|00005110| 6d 65 2e 22 20 20 54 68 | 69 73 20 63 6f 6d 6d 61 |me." Th|is comma|
|00005120| 6e 64 20 77 6f 72 6b 73 | 0a 6c 69 6b 65 20 60 23 |nd works|.like `#|
|00005130| 69 6e 63 6c 75 64 65 27 | 20 65 78 63 65 70 74 20 |include'| except |
|00005140| 69 6e 20 73 65 61 72 63 | 68 69 6e 67 20 66 6f 72 |in searc|hing for|
|00005150| 20 74 68 65 20 73 70 65 | 63 69 66 69 65 64 20 66 | the spe|cified f|
|00005160| 69 6c 65 3a 20 69 74 20 | 73 74 61 72 74 73 0a 73 |ile: it |starts.s|
|00005170| 65 61 72 63 68 69 6e 67 | 20 74 68 65 20 6c 69 73 |earching| the lis|
|00005180| 74 20 6f 66 20 68 65 61 | 64 65 72 20 66 69 6c 65 |t of hea|der file|
|00005190| 20 64 69 72 65 63 74 6f | 72 69 65 73 20 2a 61 66 | directo|ries *af|
|000051a0| 74 65 72 2a 20 74 68 65 | 20 64 69 72 65 63 74 6f |ter* the| directo|
|000051b0| 72 79 20 69 6e 0a 77 68 | 69 63 68 20 74 68 65 20 |ry in.wh|ich the |
|000051c0| 63 75 72 72 65 6e 74 20 | 66 69 6c 65 20 77 61 73 |current |file was|
|000051d0| 20 66 6f 75 6e 64 2e 0a | 0a 20 20 20 53 75 70 70 | found..|. Supp|
|000051e0| 6f 73 65 20 79 6f 75 20 | 73 70 65 63 69 66 79 20 |ose you |specify |
|000051f0| 60 2d 49 20 2f 75 73 72 | 2f 6c 6f 63 61 6c 2f 69 |`-I /usr|/local/i|
|00005200| 6e 63 6c 75 64 65 27 2c | 20 61 6e 64 20 74 68 65 |nclude',| and the|
|00005210| 20 6c 69 73 74 20 6f 66 | 0a 64 69 72 65 63 74 6f | list of|.directo|
|00005220| 72 69 65 73 20 74 6f 20 | 73 65 61 72 63 68 20 61 |ries to |search a|
|00005230| 6c 73 6f 20 69 6e 63 6c | 75 64 65 73 20 60 2f 75 |lso incl|udes `/u|
|00005240| 73 72 2f 69 6e 63 6c 75 | 64 65 27 3b 20 61 6e 64 |sr/inclu|de'; and|
|00005250| 20 73 75 70 70 6f 73 65 | 20 74 68 61 74 0a 62 6f | suppose| that.bo|
|00005260| 74 68 20 64 69 72 65 63 | 74 6f 72 69 65 73 20 63 |th direc|tories c|
|00005270| 6f 6e 74 61 69 6e 20 61 | 20 66 69 6c 65 20 6e 61 |ontain a| file na|
|00005280| 6d 65 64 20 60 73 79 73 | 2f 73 69 67 6e 61 6c 2e |med `sys|/signal.|
|00005290| 68 27 2e 20 20 4f 72 64 | 69 6e 61 72 79 0a 60 23 |h'. Ord|inary.`#|
|000052a0| 69 6e 63 6c 75 64 65 20 | 3c 73 79 73 2f 73 69 67 |include |<sys/sig|
|000052b0| 6e 61 6c 2e 68 3e 27 20 | 66 69 6e 64 73 20 74 68 |nal.h>' |finds th|
|000052c0| 65 20 66 69 6c 65 20 75 | 6e 64 65 72 20 60 2f 75 |e file u|nder `/u|
|000052d0| 73 72 2f 6c 6f 63 61 6c | 2f 69 6e 63 6c 75 64 65 |sr/local|/include|
|000052e0| 27 2e 0a 49 66 20 74 68 | 61 74 20 66 69 6c 65 20 |'..If th|at file |
|000052f0| 63 6f 6e 74 61 69 6e 73 | 20 60 23 69 6e 63 6c 75 |contains| `#inclu|
|00005300| 64 65 5f 6e 65 78 74 20 | 3c 73 79 73 2f 73 69 67 |de_next |<sys/sig|
|00005310| 6e 61 6c 2e 68 3e 27 2c | 20 69 74 20 73 74 61 72 |nal.h>',| it star|
|00005320| 74 73 0a 73 65 61 72 63 | 68 69 6e 67 20 61 66 74 |ts.searc|hing aft|
|00005330| 65 72 20 74 68 61 74 20 | 64 69 72 65 63 74 6f 72 |er that |director|
|00005340| 79 2c 20 61 6e 64 20 66 | 69 6e 64 73 20 74 68 65 |y, and f|inds the|
|00005350| 20 66 69 6c 65 20 69 6e | 20 60 2f 75 73 72 2f 69 | file in| `/usr/i|
|00005360| 6e 63 6c 75 64 65 27 2e | 0a 0a 40 45 6e 64 4e 6f |nclude'.|..@EndNo|
|00005370| 64 65 0a 0a 0a 40 4e 6f | 64 65 20 22 4d 61 63 72 |de...@No|de "Macr|
|00005380| 6f 73 22 20 22 4d 61 63 | 72 6f 73 22 0a 40 4e 65 |os" "Mac|ros".@Ne|
|00005390| 78 74 20 22 43 6f 6e 64 | 69 74 69 6f 6e 61 6c 73 |xt "Cond|itionals|
|000053a0| 22 20 22 43 6f 6e 64 69 | 74 69 6f 6e 61 6c 73 22 |" "Condi|tionals"|
|000053b0| 0a 40 50 72 65 76 20 22 | 48 65 61 64 65 72 20 46 |.@Prev "|Header F|
|000053c0| 69 6c 65 73 22 20 22 48 | 65 61 64 65 72 20 46 69 |iles" "H|eader Fi|
|000053d0| 6c 65 73 22 0a 40 54 6f | 63 20 22 54 6f 70 22 20 |les".@To|c "Top" |
|000053e0| 22 54 6f 70 22 0a 4d 61 | 63 72 6f 73 0a 3d 3d 3d |"Top".Ma|cros.===|
|000053f0| 3d 3d 3d 0a 0a 20 20 20 | 41 20 6d 61 63 72 6f 20 |===.. |A macro |
|00005400| 69 73 20 61 20 73 6f 72 | 74 20 6f 66 20 61 62 62 |is a sor|t of abb|
|00005410| 72 65 76 69 61 74 69 6f | 6e 20 77 68 69 63 68 20 |reviatio|n which |
|00005420| 79 6f 75 20 63 61 6e 20 | 64 65 66 69 6e 65 20 6f |you can |define o|
|00005430| 6e 63 65 20 61 6e 64 20 | 74 68 65 6e 0a 75 73 65 |nce and |then.use|
|00005440| 20 6c 61 74 65 72 2e 20 | 20 54 68 65 72 65 20 61 | later. | There a|
|00005450| 72 65 20 6d 61 6e 79 20 | 63 6f 6d 70 6c 69 63 61 |re many |complica|
|00005460| 74 65 64 20 66 65 61 74 | 75 72 65 73 20 61 73 73 |ted feat|ures ass|
|00005470| 6f 63 69 61 74 65 64 20 | 77 69 74 68 20 6d 61 63 |ociated |with mac|
|00005480| 72 6f 73 0a 69 6e 20 74 | 68 65 20 43 20 70 72 65 |ros.in t|he C pre|
|00005490| 70 72 6f 63 65 73 73 6f | 72 2e 0a 0a 2a 20 4d 65 |processo|r...* Me|
|000054a0| 6e 75 3a 0a 0a 2a 20 40 | 7b 22 53 69 6d 70 6c 65 |nu:..* @|{"Simple|
|000054b0| 20 4d 61 63 72 6f 73 22 | 20 4c 69 6e 6b 20 22 53 | Macros"| Link "S|
|000054c0| 69 6d 70 6c 65 20 4d 61 | 63 72 6f 73 22 7d 20 20 |imple Ma|cros"} |
|000054d0| 20 20 20 4d 61 63 72 6f | 73 20 74 68 61 74 20 61 | Macro|s that a|
|000054e0| 6c 77 61 79 73 20 65 78 | 70 61 6e 64 20 74 68 65 |lways ex|pand the|
|000054f0| 20 73 61 6d 65 20 77 61 | 79 2e 0a 2a 20 40 7b 22 | same wa|y..* @{"|
|00005500| 41 72 67 75 6d 65 6e 74 | 20 4d 61 63 72 6f 73 22 |Argument| Macros"|
|00005510| 20 4c 69 6e 6b 20 22 41 | 72 67 75 6d 65 6e 74 20 | Link "A|rgument |
|00005520| 4d 61 63 72 6f 73 22 7d | 20 20 20 4d 61 63 72 6f |Macros"}| Macro|
|00005530| 73 20 74 68 61 74 20 61 | 63 63 65 70 74 20 61 72 |s that a|ccept ar|
|00005540| 67 75 6d 65 6e 74 73 20 | 74 68 61 74 20 61 72 65 |guments |that are|
|00005550| 20 73 75 62 73 74 69 74 | 75 74 65 64 0a 20 20 20 | substit|uted. |
|00005560| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00005570| 20 20 20 20 69 6e 74 6f | 20 74 68 65 20 6d 61 63 | into| the mac|
|00005580| 72 6f 20 65 78 70 61 6e | 73 69 6f 6e 2e 0a 2a 20 |ro expan|sion..* |
|00005590| 40 7b 22 50 72 65 64 65 | 66 69 6e 65 64 22 20 4c |@{"Prede|fined" L|
|000055a0| 69 6e 6b 20 22 50 72 65 | 64 65 66 69 6e 65 64 22 |ink "Pre|defined"|
|000055b0| 7d 20 20 20 20 20 20 20 | 20 50 72 65 64 65 66 69 |} | Predefi|
|000055c0| 6e 65 64 20 6d 61 63 72 | 6f 73 20 74 68 61 74 20 |ned macr|os that |
|000055d0| 61 72 65 20 61 6c 77 61 | 79 73 20 61 76 61 69 6c |are alwa|ys avail|
|000055e0| 61 62 6c 65 2e 0a 2a 20 | 40 7b 22 53 74 72 69 6e |able..* |@{"Strin|
|000055f0| 67 69 66 69 63 61 74 69 | 6f 6e 22 20 4c 69 6e 6b |gificati|on" Link|
|00005600| 20 22 53 74 72 69 6e 67 | 69 66 69 63 61 74 69 6f | "String|ificatio|
|00005610| 6e 22 7d 20 20 20 4d 61 | 63 72 6f 20 61 72 67 75 |n"} Ma|cro argu|
|00005620| 6d 65 6e 74 73 20 63 6f | 6e 76 65 72 74 65 64 20 |ments co|nverted |
|00005630| 69 6e 74 6f 20 73 74 72 | 69 6e 67 20 63 6f 6e 73 |into str|ing cons|
|00005640| 74 61 6e 74 73 2e 0a 2a | 20 40 7b 22 43 6f 6e 63 |tants..*| @{"Conc|
|00005650| 61 74 65 6e 61 74 69 6f | 6e 22 20 4c 69 6e 6b 20 |atenatio|n" Link |
|00005660| 22 43 6f 6e 63 61 74 65 | 6e 61 74 69 6f 6e 22 7d |"Concate|nation"}|
|00005670| 20 20 20 20 20 42 75 69 | 6c 64 69 6e 67 20 74 6f | Bui|lding to|
|00005680| 6b 65 6e 73 20 66 72 6f | 6d 20 70 61 72 74 73 20 |kens fro|m parts |
|00005690| 74 61 6b 65 6e 20 66 72 | 6f 6d 20 6d 61 63 72 6f |taken fr|om macro|
|000056a0| 20 61 72 67 75 6d 65 6e | 74 73 2e 0a 2a 20 40 7b | argumen|ts..* @{|
|000056b0| 22 55 6e 64 65 66 69 6e | 69 6e 67 22 20 4c 69 6e |"Undefin|ing" Lin|
|000056c0| 6b 20 22 55 6e 64 65 66 | 69 6e 69 6e 67 22 7d 20 |k "Undef|ining"} |
|000056d0| 20 20 20 20 20 20 20 43 | 61 6e 63 65 6c 6c 69 6e | C|ancellin|
|000056e0| 67 20 61 20 6d 61 63 72 | 6f 27 73 20 64 65 66 69 |g a macr|o's defi|
|000056f0| 6e 69 74 69 6f 6e 2e 0a | 2a 20 40 7b 22 52 65 64 |nition..|* @{"Red|
|00005700| 65 66 69 6e 69 6e 67 22 | 20 4c 69 6e 6b 20 22 52 |efining"| Link "R|
|00005710| 65 64 65 66 69 6e 69 6e | 67 22 7d 20 20 20 20 20 |edefinin|g"} |
|00005720| 20 20 20 43 68 61 6e 67 | 69 6e 67 20 61 20 6d 61 | Chang|ing a ma|
|00005730| 63 72 6f 27 73 20 64 65 | 66 69 6e 69 74 69 6f 6e |cro's de|finition|
|00005740| 2e 0a 2a 20 40 7b 22 4d | 61 63 72 6f 20 50 69 74 |..* @{"M|acro Pit|
|00005750| 66 61 6c 6c 73 22 20 4c | 69 6e 6b 20 22 4d 61 63 |falls" L|ink "Mac|
|00005760| 72 6f 20 50 69 74 66 61 | 6c 6c 73 22 7d 20 20 20 |ro Pitfa|lls"} |
|00005770| 20 4d 61 63 72 6f 73 20 | 63 61 6e 20 63 6f 6e 66 | Macros |can conf|
|00005780| 75 73 65 20 74 68 65 20 | 75 6e 77 61 72 79 2e 20 |use the |unwary. |
|00005790| 20 48 65 72 65 20 77 65 | 20 65 78 70 6c 61 69 6e | Here we| explain|
|000057a0| 0a 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |. | |
|000057b0| 20 20 20 20 20 20 20 20 | 73 65 76 65 72 61 6c 20 | |several |
|000057c0| 63 6f 6d 6d 6f 6e 20 70 | 72 6f 62 6c 65 6d 73 20 |common p|roblems |
|000057d0| 61 6e 64 20 73 74 72 61 | 6e 67 65 20 66 65 61 74 |and stra|nge feat|
|000057e0| 75 72 65 73 2e 0a 0a 40 | 45 6e 64 4e 6f 64 65 0a |ures...@|EndNode.|
|000057f0| 0a 0a 40 4e 6f 64 65 20 | 22 53 69 6d 70 6c 65 20 |..@Node |"Simple |
|00005800| 4d 61 63 72 6f 73 22 20 | 22 53 69 6d 70 6c 65 20 |Macros" |"Simple |
|00005810| 4d 61 63 72 6f 73 22 0a | 40 4e 65 78 74 20 22 41 |Macros".|@Next "A|
|00005820| 72 67 75 6d 65 6e 74 20 | 4d 61 63 72 6f 73 22 20 |rgument |Macros" |
|00005830| 22 41 72 67 75 6d 65 6e | 74 20 4d 61 63 72 6f 73 |"Argumen|t Macros|
|00005840| 22 0a 40 50 72 65 76 20 | 22 4d 61 63 72 6f 73 22 |".@Prev |"Macros"|
|00005850| 20 22 4d 61 63 72 6f 73 | 22 0a 40 54 6f 63 20 22 | "Macros|".@Toc "|
|00005860| 4d 61 63 72 6f 73 22 20 | 22 4d 61 63 72 6f 73 22 |Macros" |"Macros"|
|00005870| 0a 53 69 6d 70 6c 65 20 | 4d 61 63 72 6f 73 0a 2d |.Simple |Macros.-|
|00005880| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 0a 0a 20 20 |--------|----.. |
|00005890| 20 41 20 22 73 69 6d 70 | 6c 65 20 6d 61 63 72 6f | A "simp|le macro|
|000058a0| 22 20 69 73 20 61 20 6b | 69 6e 64 20 6f 66 20 61 |" is a k|ind of a|
|000058b0| 62 62 72 65 76 69 61 74 | 69 6f 6e 2e 20 20 49 74 |bbreviat|ion. It|
|000058c0| 20 69 73 20 61 20 6e 61 | 6d 65 20 77 68 69 63 68 | is a na|me which|
|000058d0| 0a 73 74 61 6e 64 73 20 | 66 6f 72 20 61 20 66 72 |.stands |for a fr|
|000058e0| 61 67 6d 65 6e 74 20 6f | 66 20 63 6f 64 65 2e 20 |agment o|f code. |
|000058f0| 20 53 6f 6d 65 20 70 65 | 6f 70 6c 65 20 72 65 66 | Some pe|ople ref|
|00005900| 65 72 20 74 6f 20 74 68 | 65 73 65 20 61 73 20 22 |er to th|ese as "|
|00005910| 6d 61 6e 69 66 65 73 74 | 0a 63 6f 6e 73 74 61 6e |manifest|.constan|
|00005920| 74 73 22 2e 0a 0a 20 20 | 20 42 65 66 6f 72 65 20 |ts"... | Before |
|00005930| 79 6f 75 20 63 61 6e 20 | 75 73 65 20 61 20 6d 61 |you can |use a ma|
|00005940| 63 72 6f 2c 20 79 6f 75 | 20 6d 75 73 74 20 22 64 |cro, you| must "d|
|00005950| 65 66 69 6e 65 22 20 69 | 74 20 65 78 70 6c 69 63 |efine" i|t explic|
|00005960| 69 74 6c 79 20 77 69 74 | 68 20 74 68 65 0a 60 23 |itly wit|h the.`#|
|00005970| 64 65 66 69 6e 65 27 20 | 63 6f 6d 6d 61 6e 64 2e |define' |command.|
|00005980| 20 20 60 23 64 65 66 69 | 6e 65 27 20 69 73 20 66 | `#defi|ne' is f|
|00005990| 6f 6c 6c 6f 77 65 64 20 | 62 79 20 74 68 65 20 6e |ollowed |by the n|
|000059a0| 61 6d 65 20 6f 66 20 74 | 68 65 20 6d 61 63 72 6f |ame of t|he macro|
|000059b0| 20 61 6e 64 0a 74 68 65 | 6e 20 74 68 65 20 63 6f | and.the|n the co|
|000059c0| 64 65 20 69 74 20 73 68 | 6f 75 6c 64 20 62 65 20 |de it sh|ould be |
|000059d0| 61 6e 20 61 62 62 72 65 | 76 69 61 74 69 6f 6e 20 |an abbre|viation |
|000059e0| 66 6f 72 2e 20 20 46 6f | 72 20 65 78 61 6d 70 6c |for. Fo|r exampl|
|000059f0| 65 2c 0a 0a 20 20 20 20 | 20 23 64 65 66 69 6e 65 |e,.. | #define|
|00005a00| 20 42 55 46 46 45 52 5f | 53 49 5a 45 20 31 30 32 | BUFFER_|SIZE 102|
|00005a10| 30 0a 0a 64 65 66 69 6e | 65 73 20 61 20 6d 61 63 |0..defin|es a mac|
|00005a20| 72 6f 20 6e 61 6d 65 64 | 20 60 42 55 46 46 45 52 |ro named| `BUFFER|
|00005a30| 5f 53 49 5a 45 27 20 61 | 73 20 61 6e 20 61 62 62 |_SIZE' a|s an abb|
|00005a40| 72 65 76 69 61 74 69 6f | 6e 20 66 6f 72 20 74 68 |reviatio|n for th|
|00005a50| 65 20 74 65 78 74 0a 60 | 31 30 32 30 27 2e 20 20 |e text.`|1020'. |
|00005a60| 54 68 65 72 65 66 6f 72 | 65 2c 20 69 66 20 73 6f |Therefor|e, if so|
|00005a70| 6d 65 77 68 65 72 65 20 | 61 66 74 65 72 20 74 68 |mewhere |after th|
|00005a80| 69 73 20 60 23 64 65 66 | 69 6e 65 27 20 63 6f 6d |is `#def|ine' com|
|00005a90| 6d 61 6e 64 20 74 68 65 | 72 65 0a 63 6f 6d 65 73 |mand the|re.comes|
|00005aa0| 20 61 20 43 20 73 74 61 | 74 65 6d 65 6e 74 20 6f | a C sta|tement o|
|00005ab0| 66 20 74 68 65 20 66 6f | 72 6d 0a 0a 20 20 20 20 |f the fo|rm.. |
|00005ac0| 20 66 6f 6f 20 3d 20 28 | 63 68 61 72 20 2a 29 20 | foo = (|char *) |
|00005ad0| 78 6d 61 6c 6c 6f 63 20 | 28 42 55 46 46 45 52 5f |xmalloc |(BUFFER_|
|00005ae0| 53 49 5a 45 29 3b 0a 0a | 74 68 65 6e 20 74 68 65 |SIZE);..|then the|
|00005af0| 20 43 20 70 72 65 70 72 | 6f 63 65 73 73 6f 72 20 | C prepr|ocessor |
|00005b00| 77 69 6c 6c 20 72 65 63 | 6f 67 6e 69 7a 65 20 61 |will rec|ognize a|
|00005b10| 6e 64 20 22 65 78 70 61 | 6e 64 22 20 74 68 65 20 |nd "expa|nd" the |
|00005b20| 6d 61 63 72 6f 0a 60 42 | 55 46 46 45 52 5f 53 49 |macro.`B|UFFER_SI|
|00005b30| 5a 45 27 2c 20 72 65 73 | 75 6c 74 69 6e 67 20 69 |ZE', res|ulting i|
|00005b40| 6e 0a 0a 20 20 20 20 20 | 66 6f 6f 20 3d 20 28 63 |n.. |foo = (c|
|00005b50| 68 61 72 20 2a 29 20 78 | 6d 61 6c 6c 6f 63 20 28 |har *) x|malloc (|
|00005b60| 31 30 32 30 29 3b 0a 0a | 74 68 65 20 64 65 66 69 |1020);..|the defi|
|00005b70| 6e 69 74 69 6f 6e 20 6d | 75 73 74 20 62 65 20 61 |nition m|ust be a|
|00005b80| 20 73 69 6e 67 6c 65 20 | 6c 69 6e 65 3b 20 68 6f | single |line; ho|
|00005b90| 77 65 76 65 72 2c 20 69 | 74 20 6d 61 79 20 6e 6f |wever, i|t may no|
|00005ba0| 74 20 65 6e 64 20 69 6e | 20 74 68 65 0a 6d 69 64 |t end in| the.mid|
|00005bb0| 64 6c 65 20 6f 66 20 61 | 20 6d 75 6c 74 69 2d 6c |dle of a| multi-l|
|00005bc0| 69 6e 65 20 73 74 72 69 | 6e 67 20 63 6f 6e 73 74 |ine stri|ng const|
|00005bd0| 61 6e 74 20 6f 72 20 63 | 68 61 72 61 63 74 65 72 |ant or c|haracter|
|00005be0| 20 63 6f 6e 73 74 61 6e | 74 2e 0a 0a 20 20 20 54 | constan|t... T|
|00005bf0| 68 65 20 75 73 65 20 6f | 66 20 61 6c 6c 20 75 70 |he use o|f all up|
|00005c00| 70 65 72 20 63 61 73 65 | 20 66 6f 72 20 6d 61 63 |per case| for mac|
|00005c10| 72 6f 20 6e 61 6d 65 73 | 20 69 73 20 61 20 73 74 |ro names| is a st|
|00005c20| 61 6e 64 61 72 64 20 63 | 6f 6e 76 65 6e 74 69 6f |andard c|onventio|
|00005c30| 6e 2e 0a 50 72 6f 67 72 | 61 6d 73 20 61 72 65 20 |n..Progr|ams are |
|00005c40| 65 61 73 69 65 72 20 74 | 6f 20 72 65 61 64 20 77 |easier t|o read w|
|00005c50| 68 65 6e 20 69 74 20 69 | 73 20 70 6f 73 73 69 62 |hen it i|s possib|
|00005c60| 6c 65 20 74 6f 20 74 65 | 6c 6c 20 61 74 20 61 20 |le to te|ll at a |
|00005c70| 67 6c 61 6e 63 65 0a 77 | 68 69 63 68 20 6e 61 6d |glance.w|hich nam|
|00005c80| 65 73 20 61 72 65 20 6d | 61 63 72 6f 73 2e 0a 0a |es are m|acros...|
|00005c90| 20 20 20 4e 6f 72 6d 61 | 6c 6c 79 2c 20 61 20 6d | Norma|lly, a m|
|00005ca0| 61 63 72 6f 20 64 65 66 | 69 6e 69 74 69 6f 6e 20 |acro def|inition |
|00005cb0| 6d 75 73 74 20 62 65 20 | 61 20 73 69 6e 67 6c 65 |must be |a single|
|00005cc0| 20 6c 69 6e 65 2c 20 6c | 69 6b 65 20 61 6c 6c 20 | line, l|ike all |
|00005cd0| 43 0a 70 72 65 70 72 6f | 63 65 73 73 6f 72 20 63 |C.prepro|cessor c|
|00005ce0| 6f 6d 6d 61 6e 64 73 2e | 20 20 28 59 6f 75 20 63 |ommands.| (You c|
|00005cf0| 61 6e 20 73 70 6c 69 74 | 20 61 20 6c 6f 6e 67 20 |an split| a long |
|00005d00| 6d 61 63 72 6f 20 64 65 | 66 69 6e 69 74 69 6f 6e |macro de|finition|
|00005d10| 0a 63 6f 73 6d 65 74 69 | 63 61 6c 6c 79 20 77 69 |.cosmeti|cally wi|
|00005d20| 74 68 20 42 61 63 6b 73 | 6c 61 73 68 2d 4e 65 77 |th Backs|lash-New|
|00005d30| 6c 69 6e 65 2e 29 20 20 | 54 68 65 72 65 20 69 73 |line.) |There is|
|00005d40| 20 6f 6e 65 20 65 78 63 | 65 70 74 69 6f 6e 3a 20 | one exc|eption: |
|00005d50| 4e 65 77 6c 69 6e 65 73 | 0a 63 61 6e 20 62 65 20 |Newlines|.can be |
|00005d60| 69 6e 63 6c 75 64 65 64 | 20 69 6e 20 74 68 65 20 |included| in the |
|00005d70| 6d 61 63 72 6f 20 64 65 | 66 69 6e 69 74 69 6f 6e |macro de|finition|
|00005d80| 20 69 66 20 77 69 74 68 | 69 6e 20 61 20 73 74 72 | if with|in a str|
|00005d90| 69 6e 67 20 6f 72 20 63 | 68 61 72 61 63 74 65 72 |ing or c|haracter|
|00005da0| 0a 63 6f 6e 73 74 61 6e | 74 2e 20 20 42 79 20 74 |.constan|t. By t|
|00005db0| 68 65 20 73 61 6d 65 20 | 74 6f 6b 65 6e 2c 20 69 |he same |token, i|
|00005dc0| 74 20 69 73 20 6e 6f 74 | 20 70 6f 73 73 69 62 6c |t is not| possibl|
|00005dd0| 65 20 66 6f 72 20 61 20 | 6d 61 63 72 6f 20 64 65 |e for a |macro de|
|00005de0| 66 69 6e 69 74 69 6f 6e | 0a 74 6f 20 63 6f 6e 74 |finition|.to cont|
|00005df0| 61 69 6e 20 61 6e 20 75 | 6e 62 61 6c 61 6e 63 65 |ain an u|nbalance|
|00005e00| 64 20 71 75 6f 74 65 20 | 63 68 61 72 61 63 74 65 |d quote |characte|
|00005e10| 72 3b 20 74 68 65 20 64 | 65 66 69 6e 69 74 69 6f |r; the d|efinitio|
|00005e20| 6e 20 61 75 74 6f 6d 61 | 74 69 63 61 6c 6c 79 0a |n automa|tically.|
|00005e30| 65 78 74 65 6e 64 73 20 | 74 6f 20 69 6e 63 6c 75 |extends |to inclu|
|00005e40| 64 65 20 74 68 65 20 6d | 61 74 63 68 69 6e 67 20 |de the m|atching |
|00005e50| 71 75 6f 74 65 20 63 68 | 61 72 61 63 74 65 72 20 |quote ch|aracter |
|00005e60| 74 68 61 74 20 65 6e 64 | 73 20 74 68 65 20 73 74 |that end|s the st|
|00005e70| 72 69 6e 67 20 6f 72 0a | 63 68 61 72 61 63 74 65 |ring or.|characte|
|00005e80| 72 20 63 6f 6e 73 74 61 | 6e 74 2e 20 20 43 6f 6d |r consta|nt. Com|
|00005e90| 6d 65 6e 74 73 20 77 69 | 74 68 69 6e 20 61 20 6d |ments wi|thin a m|
|00005ea0| 61 63 72 6f 20 64 65 66 | 69 6e 69 74 69 6f 6e 20 |acro def|inition |
|00005eb0| 6d 61 79 20 63 6f 6e 74 | 61 69 6e 0a 4e 65 77 6c |may cont|ain.Newl|
|00005ec0| 69 6e 65 73 2c 20 77 68 | 69 63 68 20 6d 61 6b 65 |ines, wh|ich make|
|00005ed0| 20 6e 6f 20 64 69 66 66 | 65 72 65 6e 63 65 20 73 | no diff|erence s|
|00005ee0| 69 6e 63 65 20 74 68 65 | 20 63 6f 6d 6d 65 6e 74 |ince the| comment|
|00005ef0| 73 20 61 72 65 20 65 6e | 74 69 72 65 6c 79 0a 72 |s are en|tirely.r|
|00005f00| 65 70 6c 61 63 65 64 20 | 77 69 74 68 20 53 70 61 |eplaced |with Spa|
|00005f10| 63 65 73 20 72 65 67 61 | 72 64 6c 65 73 73 20 6f |ces rega|rdless o|
|00005f20| 66 20 74 68 65 69 72 20 | 63 6f 6e 74 65 6e 74 73 |f their |contents|
|00005f30| 2e 0a 0a 20 20 20 41 73 | 69 64 65 20 66 72 6f 6d |... As|ide from|
|00005f40| 20 74 68 65 20 61 62 6f | 76 65 2c 20 74 68 65 72 | the abo|ve, ther|
|00005f50| 65 20 69 73 20 6e 6f 20 | 72 65 73 74 72 69 63 74 |e is no |restrict|
|00005f60| 69 6f 6e 20 6f 6e 20 77 | 68 61 74 20 63 61 6e 20 |ion on w|hat can |
|00005f70| 67 6f 20 69 6e 20 61 0a | 6d 61 63 72 6f 20 62 6f |go in a.|macro bo|
|00005f80| 64 79 2e 20 20 50 61 72 | 65 6e 74 68 65 73 65 73 |dy. Par|entheses|
|00005f90| 20 6e 65 65 64 20 6e 6f | 74 20 62 61 6c 61 6e 63 | need no|t balanc|
|00005fa0| 65 2e 20 20 54 68 65 20 | 62 6f 64 79 20 6e 65 65 |e. The |body nee|
|00005fb0| 64 20 6e 6f 74 20 72 65 | 73 65 6d 62 6c 65 0a 76 |d not re|semble.v|
|00005fc0| 61 6c 69 64 20 43 20 63 | 6f 64 65 2e 20 20 28 4f |alid C c|ode. (O|
|00005fd0| 66 20 63 6f 75 72 73 65 | 2c 20 79 6f 75 20 6d 69 |f course|, you mi|
|00005fe0| 67 68 74 20 67 65 74 20 | 65 72 72 6f 72 20 6d 65 |ght get |error me|
|00005ff0| 73 73 61 67 65 73 20 66 | 72 6f 6d 20 74 68 65 20 |ssages f|rom the |
|00006000| 43 0a 63 6f 6d 70 69 6c | 65 72 20 77 68 65 6e 20 |C.compil|er when |
|00006010| 79 6f 75 20 75 73 65 20 | 74 68 65 20 6d 61 63 72 |you use |the macr|
|00006020| 6f 2e 29 0a 0a 20 20 20 | 54 68 65 20 43 20 70 72 |o.).. |The C pr|
|00006030| 65 70 72 6f 63 65 73 73 | 6f 72 20 73 63 61 6e 73 |eprocess|or scans|
|00006040| 20 79 6f 75 72 20 70 72 | 6f 67 72 61 6d 20 73 65 | your pr|ogram se|
|00006050| 71 75 65 6e 74 69 61 6c | 6c 79 2c 20 73 6f 20 6d |quential|ly, so m|
|00006060| 61 63 72 6f 0a 64 65 66 | 69 6e 69 74 69 6f 6e 73 |acro.def|initions|
|00006070| 20 74 61 6b 65 20 65 66 | 66 65 63 74 20 61 74 20 | take ef|fect at |
|00006080| 74 68 65 20 70 6c 61 63 | 65 20 79 6f 75 20 77 72 |the plac|e you wr|
|00006090| 69 74 65 20 74 68 65 6d | 2e 20 20 54 68 65 72 65 |ite them|. There|
|000060a0| 66 6f 72 65 2c 20 74 68 | 65 0a 66 6f 6c 6c 6f 77 |fore, th|e.follow|
|000060b0| 69 6e 67 20 69 6e 70 75 | 74 20 74 6f 20 74 68 65 |ing inpu|t to the|
|000060c0| 20 43 20 70 72 65 70 72 | 6f 63 65 73 73 6f 72 0a | C prepr|ocessor.|
|000060d0| 0a 20 20 20 20 20 66 6f | 6f 20 3d 20 58 3b 0a 20 |. fo|o = X;. |
|000060e0| 20 20 20 20 23 64 65 66 | 69 6e 65 20 58 20 34 0a | #def|ine X 4.|
|000060f0| 20 20 20 20 20 62 61 72 | 20 3d 20 58 3b 0a 0a 70 | bar| = X;..p|
|00006100| 72 6f 64 75 63 65 73 20 | 61 73 20 6f 75 74 70 75 |roduces |as outpu|
|00006110| 74 0a 0a 20 20 20 20 20 | 66 6f 6f 20 3d 20 58 3b |t.. |foo = X;|
|00006120| 0a 20 20 20 20 20 0a 20 | 20 20 20 20 62 61 72 20 |. . | bar |
|00006130| 3d 20 34 3b 0a 0a 20 20 | 20 41 66 74 65 72 20 74 |= 4;.. | After t|
|00006140| 68 65 20 70 72 65 70 72 | 6f 63 65 73 73 6f 72 20 |he prepr|ocessor |
|00006150| 65 78 70 61 6e 64 73 20 | 61 20 6d 61 63 72 6f 20 |expands |a macro |
|00006160| 6e 61 6d 65 2c 20 74 68 | 65 20 6d 61 63 72 6f 27 |name, th|e macro'|
|00006170| 73 20 64 65 66 69 6e 69 | 74 69 6f 6e 0a 62 6f 64 |s defini|tion.bod|
|00006180| 79 20 69 73 20 61 70 70 | 65 6e 64 65 64 20 74 6f |y is app|ended to|
|00006190| 20 74 68 65 20 66 72 6f | 6e 74 20 6f 66 20 74 68 | the fro|nt of th|
|000061a0| 65 20 72 65 6d 61 69 6e | 69 6e 67 20 69 6e 70 75 |e remain|ing inpu|
|000061b0| 74 2c 20 61 6e 64 20 74 | 68 65 20 63 68 65 63 6b |t, and t|he check|
|000061c0| 20 66 6f 72 0a 6d 61 63 | 72 6f 20 63 61 6c 6c 73 | for.mac|ro calls|
|000061d0| 20 63 6f 6e 74 69 6e 75 | 65 73 2e 20 20 54 68 65 | continu|es. The|
|000061e0| 72 65 66 6f 72 65 2c 20 | 74 68 65 20 6d 61 63 72 |refore, |the macr|
|000061f0| 6f 20 62 6f 64 79 20 63 | 61 6e 20 63 6f 6e 74 61 |o body c|an conta|
|00006200| 69 6e 20 63 61 6c 6c 73 | 20 74 6f 0a 6f 74 68 65 |in calls| to.othe|
|00006210| 72 20 6d 61 63 72 6f 73 | 2e 20 20 46 6f 72 20 65 |r macros|. For e|
|00006220| 78 61 6d 70 6c 65 2c 20 | 61 66 74 65 72 0a 0a 20 |xample, |after.. |
|00006230| 20 20 20 20 23 64 65 66 | 69 6e 65 20 42 55 46 53 | #def|ine BUFS|
|00006240| 49 5a 45 20 31 30 32 30 | 0a 20 20 20 20 20 23 64 |IZE 1020|. #d|
|00006250| 65 66 69 6e 65 20 54 41 | 42 4c 45 53 49 5a 45 20 |efine TA|BLESIZE |
|00006260| 42 55 46 53 49 5a 45 0a | 0a 74 68 65 20 6e 61 6d |BUFSIZE.|.the nam|
|00006270| 65 20 60 54 41 42 4c 45 | 53 49 5a 45 27 20 77 68 |e `TABLE|SIZE' wh|
|00006280| 65 6e 20 75 73 65 64 20 | 69 6e 20 74 68 65 20 70 |en used |in the p|
|00006290| 72 6f 67 72 61 6d 20 77 | 6f 75 6c 64 20 67 6f 20 |rogram w|ould go |
|000062a0| 74 68 72 6f 75 67 68 20 | 74 77 6f 0a 73 74 61 67 |through |two.stag|
|000062b0| 65 73 20 6f 66 20 65 78 | 70 61 6e 73 69 6f 6e 2c |es of ex|pansion,|
|000062c0| 20 72 65 73 75 6c 74 69 | 6e 67 20 75 6c 74 69 6d | resulti|ng ultim|
|000062d0| 61 74 65 6c 79 20 69 6e | 20 60 31 30 32 30 27 2e |ately in| `1020'.|
|000062e0| 0a 0a 20 20 20 54 68 69 | 73 20 69 73 20 6e 6f 74 |.. Thi|s is not|
|000062f0| 20 61 74 20 61 6c 6c 20 | 74 68 65 20 73 61 6d 65 | at all |the same|
|00006300| 20 61 73 20 64 65 66 69 | 6e 69 6e 67 20 60 54 41 | as defi|ning `TA|
|00006310| 42 4c 45 53 49 5a 45 27 | 20 74 6f 20 62 65 20 60 |BLESIZE'| to be `|
|00006320| 31 30 32 30 27 2e 0a 54 | 68 65 20 60 23 64 65 66 |1020'..T|he `#def|
|00006330| 69 6e 65 27 20 66 6f 72 | 20 60 54 41 42 4c 45 53 |ine' for| `TABLES|
|00006340| 49 5a 45 27 20 75 73 65 | 73 20 65 78 61 63 74 6c |IZE' use|s exactl|
|00006350| 79 20 74 68 65 20 62 6f | 64 79 20 79 6f 75 20 73 |y the bo|dy you s|
|00006360| 70 65 63 69 66 79 2d 2d | 69 6e 0a 74 68 69 73 20 |pecify--|in.this |
|00006370| 63 61 73 65 2c 20 60 42 | 55 46 53 49 5a 45 27 2d |case, `B|UFSIZE'-|
|00006380| 2d 61 6e 64 20 64 6f 65 | 73 20 6e 6f 74 20 63 68 |-and doe|s not ch|
|00006390| 65 63 6b 20 74 6f 20 73 | 65 65 20 77 68 65 74 68 |eck to s|ee wheth|
|000063a0| 65 72 20 69 74 20 74 6f | 6f 20 69 73 20 74 68 65 |er it to|o is the|
|000063b0| 0a 6e 61 6d 65 20 6f 66 | 20 61 20 6d 61 63 72 6f |.name of| a macro|
|000063c0| 2e 20 20 49 74 27 73 20 | 6f 6e 6c 79 20 77 68 65 |. It's |only whe|
|000063d0| 6e 20 79 6f 75 20 2a 75 | 73 65 2a 20 60 54 41 42 |n you *u|se* `TAB|
|000063e0| 4c 45 53 49 5a 45 27 20 | 74 68 61 74 20 74 68 65 |LESIZE' |that the|
|000063f0| 20 72 65 73 75 6c 74 0a | 6f 66 20 69 74 73 20 65 | result.|of its e|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.
