/ Celestin Apprentice 4 / Apprentice-Release4.iso / Languages / RLaB 1.18c / manual / getenv.tex

< prev

next >

MacOS 8.1

Win98

DOS

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 67 65 74 65 6e 76 20 |\section|{getenv |
|00000010| 2d 2d 2d 20 47 65 74 20 | 45 6e 76 69 72 6f 6e 6d |--- Get |Environm|
|00000020| 65 6e 74 61 6c 20 56 61 | 72 69 61 62 6c 65 7d 0d |ental Va|riable}.|
|00000030| 5c 6c 61 62 65 6c 7b 66 | 6e 3a 67 65 74 65 6e 76 |\label{f|n:getenv|
|00000040| 7d 0d 5c 69 6e 64 65 78 | 7b 67 65 74 65 6e 76 28 |}.\index|{getenv(|
|00000050| 29 7d 0d 5c 69 6e 64 65 | 78 7b 45 6e 76 69 72 6f |)}.\inde|x{Enviro|
|00000060| 6e 6d 65 6e 74 61 6c 20 | 76 61 72 69 61 62 6c 65 |nmental |variable|
|00000070| 73 7d 0d 5c 69 6e 64 65 | 78 7b 47 65 74 74 69 6e |s}.\inde|x{Gettin|
|00000080| 67 20 65 6e 76 69 72 6f | 6e 6d 65 6e 74 61 6c 20 |g enviro|nmental |
|00000090| 76 61 72 69 61 62 6c 65 | 73 7d 0d 5c 69 6e 64 65 |variable|s}.\inde|
|000000a0| 78 7b 76 61 72 69 61 62 | 6c 65 73 21 65 6e 76 69 |x{variab|les!envi|
|000000b0| 72 6f 6e 6d 65 6e 74 61 | 6c 7d 0d 5c 62 65 67 69 |ronmenta|l}.\begi|
|000000c0| 6e 7b 72 61 69 6c 7d 0d | 47 65 74 45 6e 76 20 3a |n{rail}.|GetEnv :|
|000000d0| 20 27 67 65 74 65 6e 76 | 27 20 27 28 27 20 53 74 | 'getenv|' '(' St|
|000000e0| 72 69 6e 67 20 20 27 29 | 27 20 3b 0d 5c 65 6e 64 |ring  ')|' ;.\end|
|000000f0| 7b 72 61 69 6c 7d 0d 0d | 5c 76 65 72 62 2b 67 65 |{rail}..|\verb+ge|
|00000100| 74 65 6e 76 2b 20 73 65 | 61 72 63 68 65 73 20 74 |tenv+ se|arches t|
|00000110| 68 65 20 65 6e 76 69 72 | 6f 6e 6d 65 6e 74 20 6c |he envir|onment l|
|00000120| 69 73 74 20 66 6f 72 20 | 61 20 73 74 72 69 6e 67 |ist for |a string|
|00000130| 20 74 68 61 74 20 6d 61 | 74 63 68 65 73 0d 74 68 | that ma|tches.th|
|00000140| 65 20 73 74 72 69 6e 67 | 20 61 72 67 75 6d 65 6e |e string| argumen|
|00000150| 74 2e 20 20 54 68 65 20 | 76 61 6c 75 65 20 6f 66 |t.  The |value of|
|00000160| 20 74 68 65 20 65 6e 76 | 69 72 6f 6e 6d 65 6e 74 | the env|ironment|
|00000170| 20 76 61 72 69 61 62 6c | 65 20 69 73 20 72 65 74 | variabl|e is ret|
|00000180| 75 72 6e 65 64 0d 61 73 | 20 61 20 73 74 72 69 6e |urned.as| a strin|
|00000190| 67 2e 20 0d 0d 54 68 65 | 20 5c 76 65 72 62 2b 67 |g. ..The| \verb+g|
|000001a0| 65 74 65 6e 76 2b 20 66 | 75 6e 63 74 69 6f 6e 20 |etenv+ f|unction |
|000001b0| 69 73 20 6d 6f 73 74 6c | 79 20 61 20 77 72 61 70 |is mostl|y a wrap|
|000001c0| 70 65 72 20 61 72 6f 75 | 6e 64 20 74 68 65 20 43 |per arou|nd the C|
|000001d0| 20 6c 61 6e 67 75 61 67 | 65 0d 66 75 6e 63 74 69 | languag|e.functi|
|000001e0| 6f 6e 20 6f 66 20 74 68 | 65 20 73 61 6d 65 20 6e |on of th|e same n|
|000001f0| 61 6d 65 2e 20 20 54 68 | 69 73 20 6d 65 61 6e 73 |ame.  Th|is means|
|00000200| 20 74 68 61 74 20 69 74 | 73 20 62 65 68 61 76 69 | that it|s behavi|
|00000210| 6f 72 20 20 64 65 70 65 | 6e 64 73 0d 75 70 6f 6e |or  depe|nds.upon|
|00000220| 20 74 68 65 20 75 6e 64 | 65 72 6c 79 69 6e 67 20 | the und|erlying |
|00000230| 69 6d 70 6c 65 6d 65 6e | 74 61 74 69 6f 6e 2e 20 |implemen|tation. |
|00000240| 4f 6e 20 73 79 73 74 65 | 6d 73 20 77 69 74 68 20 |On syste|ms with |
|00000250| 49 53 4f 20 43 20 6c 69 | 62 72 61 72 69 65 73 2c |ISO C li|braries,|
|00000260| 20 0d 5c 76 65 72 62 2b | 67 65 74 65 6e 76 2b 20 | .\verb+|getenv+ |
|00000270| 77 69 6c 6c 20 72 65 74 | 75 72 6e 20 61 20 7a 65 |will ret|urn a ze|
|00000280| 72 6f 20 6c 65 6e 67 74 | 68 20 73 74 72 69 6e 67 |ro lengt|h string|
|00000290| 20 69 66 20 74 68 65 20 | 65 6e 76 69 72 6f 6e 6d | if the |environm|
|000002a0| 65 6e 74 0d 76 61 72 69 | 61 62 6c 65 20 64 6f 65 |ent.vari|able doe|
|000002b0| 73 20 6e 6f 74 20 65 78 | 69 73 74 2e 20 0d 0d 5c |s not ex|ist. ..\|
|000002c0| 70 61 72 61 67 72 61 70 | 68 7b 45 78 61 6d 70 6c |paragrap|h{Exampl|
|000002d0| 65 7d 0d 5c 69 6e 64 65 | 78 7b 65 78 61 6d 70 6c |e}.\inde|x{exampl|
|000002e0| 65 20 6f 66 20 67 65 74 | 65 6e 76 28 29 7d 0d 5c |e of get|env()}.\|
|000002f0| 69 6e 64 65 78 7b 67 65 | 74 65 6e 76 28 29 21 65 |index{ge|tenv()!e|
|00000300| 78 61 6d 70 6c 65 7d 0d | 5c 62 65 67 69 6e 7b 76 |xample}.|\begin{v|
|00000310| 65 72 62 61 74 69 6d 7d | 0d 3e 20 67 65 74 65 6e |erbatim}|.> geten|
|00000320| 76 28 22 48 4f 4d 45 22 | 29 0d 2f 68 6f 6d 65 2f |v("HOME"|)./home/|
|00000330| 62 72 61 64 68 0d 3e 20 | 67 65 74 65 6e 76 28 22 |bradh.> |getenv("|
|00000340| 4e 4f 54 5f 48 4f 4d 45 | 22 29 0d 0d 3e 20 6d 79 |NOT_HOME|")..> my|
|00000350| 5f 6e 61 6d 65 20 3d 20 | 67 65 74 65 6e 76 28 22 |_name = |getenv("|
|00000360| 4c 4f 47 4e 41 4d 45 22 | 29 0d 20 6d 79 5f 6e 61 |LOGNAME"|). my_na|
|00000370| 6d 65 20 3d 0d 62 72 61 | 64 68 0d 3e 20 6d 79 5f |me =.bra|dh.> my_|
|00000380| 6d 61 63 68 69 6e 65 20 | 3d 20 67 65 74 65 6e 76 |machine |= getenv|
|00000390| 28 22 48 4f 53 54 54 59 | 50 45 22 29 0d 20 6d 79 |("HOSTTY|PE"). my|
|000003a0| 5f 6d 61 63 68 69 6e 65 | 20 3d 0d 69 33 38 36 0d |_machine| =.i386.|
|000003b0| 5c 65 6e 64 7b 76 65 72 | 62 61 74 69 6d 7d 0d 0d |\end{ver|batim}..|
|000003c0| 5c 6e 65 77 70 61 67 65 | 0d 0d 0d 0d 0d 0d 0d    |\newpage|....... |
+--------+-------------------------+-------------------------+--------+--------+