64
52
<!-- constructors -->
70
The <code>Time</code> constructor create a time object which is
71
initialized with the current time.
79
The <code>Time</code> constructor create a time object which is
80
initialized with the time argument.
86
<args>Integer Integer Integer</args>
88
The <code>Time</code> constructor create a time object which is
89
initialized with the time specific arguments, which are the
90
hour, the minutes and the seconds.
58
The <code>Time</code> constructor create a time object which is
59
initialized with the current time.
67
The <code>Time</code> constructor create a time object which is
68
initialized with the time argument.
74
<args>Integer Integer Integer</args>
76
The <code>Time</code> constructor create a time object which is
77
initialized with the time specific arguments, which are the
78
hour, the minutes and the seconds.
102
The <code>add</code> method adds the time argument in seconds to
103
the current time value This method is useful to compute a time
104
in the future, in reference to the current time.
109
<name>add-minutes</name>
113
The <code>add-minutes</code> method adds one or several minutes to
114
the current time value. This method is useful to compute a time
115
in the future, in reference to the current time.
120
<name>add-hours</name>
124
The <code>add-hour</code> method adds one or several hours to
125
the current time value. This method is useful to compute a time
126
in the future, in reference to the current time.
131
<name>add-days</name>
135
The <code>add-days</code> method adds one or several days to
136
the current time value. This method is useful to compute a time
137
in the future, in reference to the current time.
142
<name>set-time</name>
146
The <code>set-time</code> method set the absolute time in seconds.
151
<name>get-time</name>
155
The <code>get-time</code> method returns absolute time in seconds
162
<args>none|Boolean</args>
164
The <code>seconds</code> method returns the number of
165
seconds after the minute. Without argument, the number of
166
seconds is computed in reference to the local time. With a
167
boolean argument set to <code>true</code>, the number of seconds
168
is computed in reference to the UTC time. If the argument is
169
false, the local time is used. The returned value is the range 0
177
<args>none|Boolean</args>
179
The <code>minutes</code> method returns the number of
180
minutes after the hour. Without argument, the number of
181
minutes is computed in reference to the local time. With a
182
boolean argument set to <code>true</code>, the number of minutes
183
is computed in reference to the UTC time. If the argument is
184
false, the local time is used. The returned value is the range 0
192
<args>none|Boolean</args>
194
The <code>hours</code> method returns the number of hours
195
since midnight. Without argument, the number of
196
hours is computed in reference to the local time. With a
197
boolean argument set to <code>true</code>, the number of hours
198
is computed in reference to the UTC time. If the argument is
199
false, the local time is used. The returned value is the range 0
207
<args>none|Boolean</args>
209
The <code>format</code> method returns a formatted representation
210
of the time in the form of <em>hh:mm:ss</em>. Without argument,
211
the time is computed in reference to the local time. With a
212
boolean argument set to <code>true</code>, the time is computed
213
in reference to the UTC time. If the argument is false, the
221
<args>none|Boolean</args>
223
The <code>to-iso</code> method returns a formatted representation
224
of the time as specified by ISO-8601. Without argument, the time
225
is computed in reference to the local time. With a boolean
226
argument set to <code>true</code>, the time is computed in
227
reference to the UTC time. If the argument is false, the
237
The <code>to-rfc</code> method returns a formatted representation
238
of the time as specified by RFC-2822. The time is computed in
239
reference to the local time.
90
The <code>add</code> method adds the time argument in seconds to
91
the current time value This method is useful to compute a time
92
in the future, in reference to the current time.
97
<name>add-minutes</name>
101
The <code>add-minutes</code> method adds one or several minutes to
102
the current time value. This method is useful to compute a time
103
in the future, in reference to the current time.
108
<name>add-hours</name>
112
The <code>add-hour</code> method adds one or several hours to
113
the current time value. This method is useful to compute a time
114
in the future, in reference to the current time.
119
<name>add-days</name>
123
The <code>add-days</code> method adds one or several days to
124
the current time value. This method is useful to compute a time
125
in the future, in reference to the current time.
130
<name>set-time</name>
134
The <code>set-time</code> method set the absolute time in seconds.
139
<name>get-time</name>
141
<args>none|Boolean</args>
143
The <code>get-time</code> method returns absolute time in
144
seconds. Without argument, the absolute time is computed in
145
reference to the UTC time. With a boolean argument set
146
to <code>true</code>, the time is computed in reference to the
147
UTC time. If the argument is <code>false</code>, the local time
155
<args>none|Boolean</args>
157
The <code>seconds</code> method returns the number of
158
seconds after the minute. Without argument, the number of
159
seconds is computed in reference to the UTC time. With a
160
boolean argument set to <code>true</code>, the number of seconds
161
is computed in reference to the UTC time. If the argument is
162
<code>false</code>, the local time is used. The returned value
163
is the range 0 to 60.
170
<args>none|Boolean</args>
172
The <code>minutes</code> method returns the number of
173
minutes after the hour. Without argument, the number of
174
minutes is computed in reference to the UTC time. With a
175
boolean argument set to <code>true</code>, the number of minutes
176
is computed in reference to the UTC time. If the argument is
177
<code>false</code>, the local time is used. The returned value
178
is the range 0 to 60.
185
<args>none|Boolean</args>
187
The <code>hours</code> method returns the number of hours
188
since midnight. Without argument, the number of
189
hours is computed in reference to the local time. With a
190
boolean argument set to <code>true</code>, the number of hours
191
is computed in reference to the UTC time. If the argument is
192
<code>false</code>, the local time is used. The returned value
193
is the range 0 to 23.
200
<args>none|Boolean</args>
202
The <code>format</code> method returns a formatted representation
203
of the time in the form of <em>hh:mm:ss</em>. Without argument,
204
the time is computed in reference to the local time. With a
205
boolean argument set to <code>true</code>, the time is computed
206
in reference to the UTC time. If the argument
207
is <code>false</code>, the local time is used.
214
<args>none|Boolean</args>
216
The <code>to-iso</code> method returns a formatted representation
217
of the time as specified by ISO-8601. Without argument, the time
218
is computed in reference to the local time. With a boolean
219
argument set to <code>true</code>, the time is computed in
220
reference to the UTC time. If the argument
221
is <code>false</code>, the local time is used.
228
<args>none|Boolean</args>
230
The <code>to-rfc</code> method returns a formatted representation
231
of the time as specified by RFC-2822. Without argument, the time
232
is computed in reference to the local time. With a boolean
233
argument set to <code>true</code>, the time is computed in
234
reference to the UTC time. If the argument
235
is <code>false</code>, the local time is used.
240
<name>get-base-day</name>
244
The <code>get-base-day</code> method returns the absolute time
245
rounded to the beginning of the day.
252
259
<!-- synopsis -->
254
The <code>Date</code> is a derived class designed to manipulate
255
dates. The date computation is based on an <em>modified proleptic
256
gregorian</em> calendar. This proleptic feature means that the
257
actual calendar (gregorian) is extended beyond year 1582 (its
258
introduction year) and modified in order to support the year
259
0. This kind of calendar is somehow similar to the astronomical
260
gregorian calendar except that the reference date is 0 for the ATC
261
system -- <afnix/> time coordinated--. This method presents the
262
advantage to support negative time. It should be noted that the 0
263
reference does not means year 1BC since year 0 did not exist at that
264
time (the concept of zero is fairly new) and more important, the date
265
expressed in the form 1BC generally refers to the Julian calendar
266
since the date is before 1582. Although, the class provides several
267
methods to access the individual fields, it is also possible to get a
268
string representation that conforms to ISO-8601 or to
269
RFC-2822. With 1 argument, the date is initialized with the time
270
clock specified as an integer argument. With 3 or 6 arguments, the
271
date is expressed with its different elements.
261
The <code>Date</code> is a derived class designed to manipulate
262
dates. The date computation is based on an <em>modified proleptic
263
gregorian</em> calendar. This proleptic feature means that the
264
actual calendar (gregorian) is extended beyond year 1582 (its
265
introduction year) and modified in order to support the year
266
0. This kind of calendar is somehow similar to the astronomical
267
gregorian calendar except that the reference date is 0 for
268
special coordinated time. This method presents the
269
advantage to support negative time. It should be noted that the 0
270
reference does not means year 1BC since year 0 did not exist at that
271
time (the concept of zero is fairly new) and more important, the date
272
expressed in the form 1BC generally refers to the Julian calendar
273
since the date is before 1582. Although, the class provides several
274
methods to access the individual fields, it is also possible to get a
275
string representation that conforms to ISO-8601 or to
276
RFC-2822. With 1 argument, the date is initialized with the time
277
clock specified as an integer argument. With 3 or 6 arguments, the
278
date is expressed with its different elements.
274
281
<!-- predicate -->
282
289
<!-- constructors -->
288
The <code>Date</code> constructor creates a date object which is
289
initialized with the current time.
297
The <code>Date</code> constructor creates a date object which is
298
initialized with the time argument.
304
<args>Integer Integer Integer</args>
306
The <code>Date</code> constructor creates a date object which is
307
initialized with the date specific arguments, which are the
308
year, the month and the day in the month.
314
<args>Integer Integer Integer Integer Integer Integer</args>
316
The <code>Date</code> constructor creates a date object which is
317
initialized with the date specific arguments, which are the
318
year, the month, the day in the month, the hours, the minutes
295
The <code>Date</code> constructor creates a date object which is
296
initialized with the current time.
304
The <code>Date</code> constructor creates a date object which is
305
initialized with the time argument.
311
<args>Integer Integer Integer</args>
313
The <code>Date</code> constructor creates a date object which is
314
initialized with the date specific arguments, which are the
315
year, the month and the day in the month.
321
<args>Integer Integer Integer Integer Integer Integer</args>
323
The <code>Date</code> constructor creates a date object which is
324
initialized with the date specific arguments, which are the
325
year, the month, the day in the month, the hours, the minutes
331
The <code>year</code> method returns the date year. the returned
332
value is an absolute year value which can be negative.
341
The <code>month</code> method returns the month in the year. The
342
returned value is the range 1 to 12.
351
The <code>day</code> method returns the day in the
352
month. The returned value is the range 1 to 31.
357
<name>week-day</name>
361
The <code>week-day</code> method returns the day in the
362
week. The returned value is the range 0 to 6 in reference to Sunday.
367
<name>year-day</name>
371
The <code>year-day</code> method returns the day in the
372
year. The returned value is the range 1 to 366 in reference to
382
The <code>map-day</code> method returns a formatted representation
388
<name>map-month</name>
392
The <code>map-month</code> method returns a formatted representation
400
<args>none|Boolean</args>
402
The <code>format</code> method returns a formatted representation
403
of the date. Without argument, the time is computed in reference
404
to the local time. With a boolean argument set to
405
<code>true</code>, the time is computed in reference to the UTC
406
time. If the argument is false, the local time is used.
413
<args>none|Boolean</args>
415
The <code>to-iso</code> method returns a formatted representation
416
of the date as specified by ISO-8601. Without argument, the time
417
is computed in reference to the local time. With a boolean
418
argument set to <code>true</code>, the time is computed in
419
reference to the UTC time. If the argument is false, the
429
The <code>to-rfc</code> method returns a formatted representation
430
of the date as specified by RFC-2822. The time is computed in
431
reference to the local time.
440
The <code>to-date</code> method returns a formatted representation
441
of the date only as specified by ISO-8601. With this method, the
442
time value is not included in the representation.
449
<args>none|Boolean</args>
451
The <code>to-time</code> method returns a formatted representation
452
of the time as returned by the <code>Time format</code> method.
457
<name>get-base-day</name>
461
The <code>get-base-day</code> method returns the absolute time
462
rounded to the beginning of the day.
467
<name>add-years</name>
471
The <code>add-years</code> method add one or several years to the
477
<name>add-months</name>
481
The <code>add-months</code> method add one or several months to the
336
<args>none|Boolean</args>
338
The <code>year</code> method returns the date year. the returned
339
value is an absolute year value which can be negative. Without
340
argument, the number of years is computed in reference to the
341
local time. With a boolean argument set to <code>true</code>,
342
the number of years is computed in reference to the UTC time. If
343
the argument is <code>false</code>, the local time is used.
350
<args>none|Boolean</args>
352
The <code>month</code> method returns the month in the year. The
353
returned value is the range 1 to 12. Without argument, the number of
354
months is computed in reference to the local time. With a
355
boolean argument set to <code>true</code>, the number of months
356
is computed in reference to the UTC time. If the argument is
357
<code>false</code>, the local time is used.
364
<args>none|Boolean</args>
366
The <code>day</code> method returns the day in the
367
month. The returned value is the range 1 to 31. Without argument,
368
the number of days is computed in reference to the local
369
time. With a boolean argument set to <code>true</code>, the
370
number of days is computed in reference to the UTC time. If the
371
argument is <code>false</code>, the local time is used.
376
<name>week-day</name>
378
<args>none|Boolean</args>
380
The <code>week-day</code> method returns the day in the
381
week. The returned value is the range 0 to 6 in reference to
382
Sunday. Without argument, the day is computed in
383
reference to the local time. With a boolean argument set
384
to <code>true</code>, the day is computed in reference to the
385
UTC time. If the argument is <code>false</code>, the local time
391
<name>year-day</name>
393
<args>none|Boolean</args>
395
The <code>year-day</code> method returns the day in the
396
year. The returned value is the range 1 to 366 in reference to
397
January 1st. Without argument, the day is computed in
398
reference to the local time. With a boolean argument set
399
to <code>true</code>, the day is computed in reference to the
400
UTC time. If the argument is <code>false</code>, the local time
408
<args>none|Boolean</args>
410
The <code>map-day</code> method returns a formatted representation
411
of the day. Without argument, the day is computed in
412
reference to the local time. With a boolean argument set
413
to <code>true</code>, the day is computed in reference to the
414
UTC time. If the argument is <code>false</code>, the local time
420
<name>map-month</name>
422
<args>none|Boolean</args>
424
The <code>map-month</code> method returns a formatted representation
425
of the month. Without argument, the month is computed in
426
reference to the local time. With a boolean argument set
427
to <code>true</code>, the month is computed in reference to the
428
UTC time. If the argument is <code>false</code>, the local time
436
<args>none|Boolean</args>
438
The <code>format</code> method returns a formatted representation
439
of the date. Without argument, the time is computed in reference
440
to the local time. With a boolean argument set to
441
<code>true</code>, the time is computed in reference to the UTC
442
time. If the argument is <code>false</code>, the local time is
450
<args>none|Boolean</args>
452
The <code>to-iso</code> method returns a formatted representation
453
of the date as specified by ISO-8601. Without argument, the time
454
is computed in reference to the local time. With a boolean
455
argument set to <code>true</code>, the time is computed in
456
reference to the UTC time. If the argument
457
is <code>false</code>, the local time is used.
466
The <code>to-web</code> method returns a formatted representation
467
of the date as specified by RFC-1123.
474
<args>none|Boolean</args>
476
The <code>to-rfc</code> method returns a formatted representation
477
of the date as specified by RFC-2822. Without argument, the time
478
is computed in reference to the local time. With a boolean
479
argument set to <code>true</code>, the time is computed in
480
reference to the UTC time. If the argument
481
is <code>false</code>, the local time is used.
488
<args>none|Boolean</args>
490
The <code>to-date</code> method returns a formatted representation
491
of the date only as specified by ISO-8601. With this method, the
492
time value is not included in the representation. Without
493
argument, the date is computed in reference to the local
494
time. With a boolean argument set to <code>true</code>, the date
495
is computed in reference to the UTC time. If the argument
496
is <code>false</code>, the local time is used.
503
<args>none|Boolean</args>
505
The <code>to-time</code> method returns a formatted representation
506
of the time as returned by the <code>Time format</code>
507
method. Without argument, the time is computed in reference to
508
the local time. With a boolean argument set
509
to <code>true</code>, the time is computed in reference to the
510
UTC time. If the argument is <code>false</code>, the local time
516
<name>add-years</name>
520
The <code>add-years</code> method add one or several years to the
526
<name>add-months</name>
530
The <code>add-months</code> method add one or several months to the
517
566
<!-- constructors -->
523
The <code>Options</code> constructor creates a default option
524
object without a user message.
572
The <code>Options</code> constructor creates a default option
573
object without a user message.
532
The <code>Options</code> constructor creates an empty option object
533
with a user message. The user message is used by the
534
<code>usage</code> method.
581
The <code>Options</code> constructor creates an empty option object
582
with a user message. The user message is used by the
583
<code>usage</code> method.
546
The <code>reset</code> method resets the object data structure
547
but do not remove the option descriptors. After a reset operation, the
548
class is ready to parse another string vector.
557
The <code>usage</code> method prints a usage message with a user
558
message and a one line description per option.
559
removing all messages.
568
The <code>parse</code> method parse a vector and fill the option
569
data structure. The parse method is generally called with the
570
interpreter argument vector.
579
The <code>empty-</code> predicate returns true if the argument
580
vector is empty. The argument vector is filled wit the string
581
that are not options during the parsing process.
586
<name>add-list-option</name>
588
<args>Character String String</args>
590
The <code>add-list-option</code> method creates a new list
591
option. The list option is defined by the option character and
592
the option string. The first argument is the option
593
character. The second argument is the option list string. The
594
third argument is the option message. During the parsing
595
process, the list option have a string argument which must match
596
one string associated with the option character.
601
<name>get-unique-option</name>
602
<retn>Character String</retn>
605
The <code>add-unique-option</code> method creates a new single
606
option. The option is defined only by its character. The first
607
argument is the option character. The second argument is the
608
option message. During the parsing process, a unique option does
609
not have an argument.
614
<name>add-string-option</name>
616
<args>Character String</args>
618
The <code>add-string-option</code> method creates a new string
619
option. The option is defined only by its character. The first
620
argument is the option character. The second argument is the
621
option message. During the parsing process, a string option have
627
<name>add-vector-option</name>
628
<retn>Character String</retn>
631
The <code>add-vector-option</code> method creates a new vector
632
option. The option is defined only by its character. The first
633
argument is the option character. The second argument is the
634
option message. During the parsing process, a vector option have
635
a string argument which is accumulated in a vector.
640
<name>set-user-message</name>
644
The <code>set-user-message</code> method sets the global
645
option user message. The user message is used by the
646
<code>usage</code> method.
651
<name>get-user-message</name>
655
The <code>get-user-message</code> method returns the global
656
option user message. The user message is used by the
657
<code>usage</code> method.
662
<name>get-unique-option</name>
664
<args>Character</args>
666
The <code>get-unique-option</code> method returns the flag
667
associated with an option. If the option has been detected
668
during the parsing process, the method returns true. This method
669
works also for string option or list option to indicate if the
670
string has been set for that option. with a vector option, it is
671
simpler to get the vector and check for the vector length. The
672
first argument is the option character to use for testing.
677
<name>get-string-option</name>
679
<args>Character</args>
681
The <code>get-string-option</code> method returns the string
682
associated with a string option. In order to make sure that a
683
string option has been properly set during the parsing process,
684
it is recommended to use the <code>get-unique-option</code>
685
method. The first argument is the option character to use for
686
the string retrieval.
691
<name>get-vector-option</name>
693
<args>Character</args>
695
The <code>get-vector-option</code> method returns the vector
696
associated with a vector option. The first argument is the
697
option character to use for the vector retrieval.
702
<name>get-vector-arguments</name>
706
The <code>get-vector-arguments</code> method returns the vector
707
arguments built during the parsing process.
595
The <code>reset</code> method resets the object data structure
596
but do not remove the option descriptors. After a reset operation, the
597
class is ready to parse another string vector.
606
The <code>usage</code> method prints a usage message with a user
607
message and a one line description per option.
608
removing all messages.
617
The <code>parse</code> method parse a vector and fill the option
618
data structure. The parse method is generally called with the
619
interpreter argument vector.
628
The <code>empty-</code> predicate returns true if the argument
629
vector is empty. The argument vector is filled wit the string
630
that are not options during the parsing process.
635
<name>add-list-option</name>
637
<args>Character String String</args>
639
The <code>add-list-option</code> method creates a new list
640
option. The list option is defined by the option character and
641
the option string. The first argument is the option
642
character. The second argument is the option list string. The
643
third argument is the option message. During the parsing
644
process, the list option have a string argument which must match
645
one string associated with the option character.
650
<name>get-unique-option</name>
651
<retn>Character String</retn>
654
The <code>add-unique-option</code> method creates a new single
655
option. The option is defined only by its character. The first
656
argument is the option character. The second argument is the
657
option message. During the parsing process, a unique option does
658
not have an argument.
663
<name>add-string-option</name>
665
<args>Character String</args>
667
The <code>add-string-option</code> method creates a new string
668
option. The option is defined only by its character. The first
669
argument is the option character. The second argument is the
670
option message. During the parsing process, a string option have
676
<name>add-vector-option</name>
677
<retn>Character String</retn>
680
The <code>add-vector-option</code> method creates a new vector
681
option. The option is defined only by its character. The first
682
argument is the option character. The second argument is the
683
option message. During the parsing process, a vector option have
684
a string argument which is accumulated in a vector.
689
<name>set-user-message</name>
693
The <code>set-user-message</code> method sets the global
694
option user message. The user message is used by the
695
<code>usage</code> method.
700
<name>get-user-message</name>
704
The <code>get-user-message</code> method returns the global
705
option user message. The user message is used by the
706
<code>usage</code> method.
711
<name>get-unique-option</name>
713
<args>Character</args>
715
The <code>get-unique-option</code> method returns the flag
716
associated with an option. If the option has been detected
717
during the parsing process, the method returns true. This method
718
works also for string option or list option to indicate if the
719
string has been set for that option. with a vector option, it is
720
simpler to get the vector and check for the vector length. The
721
first argument is the option character to use for testing.
726
<name>get-string-option</name>
728
<args>Character</args>
730
The <code>get-string-option</code> method returns the string
731
associated with a string option. In order to make sure that a
732
string option has been properly set during the parsing process,
733
it is recommended to use the <code>get-unique-option</code>
734
method. The first argument is the option character to use for
735
the string retrieval.
740
<name>get-vector-option</name>
742
<args>Character</args>
744
The <code>get-vector-option</code> method returns the vector
745
associated with a vector option. The first argument is the
746
option character to use for the vector retrieval.
751
<name>get-vector-arguments</name>
755
The <code>get-vector-arguments</code> method returns the vector
756
arguments built during the parsing process.
715
764
<!-- =================================================================== -->
718
<func nameset="afnix:sys">
723
The <code>exit</code> function terminates the executing program
724
with the exit code specified as the argument.
728
<func nameset="afnix:sys">
733
The <code>sleep</code> function pause the specific thread for a
734
certain time. The time argument is expressed in milliseconds. This
735
function returns nil.
739
<func nameset="afnix:sys">
740
<name>get-option</name>
742
<args>Character</args>
744
The <code>get-option</code> function returns a formatted string
745
equivalent to the system option as specified by the character
750
<func nameset="afnix:sys">
751
<name>get-random</name>
753
<args>none|Integer</args>
755
The <code>get-random</code> function returns a random integer
756
number. Without argument, the integer range is machine
757
dependent. With one integer argument, the resulting integer number
758
is less than the specified maximum bound.
762
<func nameset="afnix:sys">
763
<name>get-random-real</name>
767
The <code>get-random-real</code> function returns a random real
768
number between 0.0 and 1.0.
772
<func nameset="afnix:sys">
773
<name>get-unique-id</name>
777
The <code>get-unique-id</code> function returns an unique integer
778
number. The returned number is unique across the session.
782
<func nameset="afnix:sys">
787
The <code>get-pid</code> function returns the process identifier
788
(pid). The returned value is a positive integer.
792
<func nameset="afnix:sys">
797
The <code>get-env</code> function returns the environment variable
798
associated with the string argument. If the environment does not
799
exist an exception is raised.
803
<func nameset="afnix:sys">
804
<name>get-host-name</name>
808
The <code>get-host-name</code> function returns the host name. The
809
host name can be either a simple name or a canonical name with its
810
domain, depending on the system configuration.
814
<func nameset="afnix:sys">
815
<name>get-user-name</name>
819
The <code>get-user-name</code> function returns the current user
767
<func nameset="afnix:sys">
772
The <code>exit</code> function terminates the executing program
773
with the exit code specified as the argument.
777
<func nameset="afnix:sys">
782
The <code>sleep</code> function pause the specific thread for a
783
certain time. The time argument is expressed in milliseconds. This
784
function returns nil.
788
<func nameset="afnix:sys">
789
<name>get-option</name>
791
<args>Character</args>
793
The <code>get-option</code> function returns a formatted string
794
equivalent to the system option as specified by the character
799
<func nameset="afnix:sys">
800
<name>get-unique-id</name>
804
The <code>get-unique-id</code> function returns an unique integer
805
number. The returned number is unique across the session.
809
<func nameset="afnix:sys">
814
The <code>get-pid</code> function returns the process identifier
815
(pid). The returned value is a positive integer.
819
<func nameset="afnix:sys">
824
The <code>get-env</code> function returns the environment variable
825
associated with the string argument. If the environment does not
826
exist an exception is raised.
830
<func nameset="afnix:sys">
831
<name>get-host-name</name>
835
The <code>get-host-name</code> function returns the host name. The
836
host name can be either a simple name or a canonical name with its
837
domain, depending on the system configuration.
841
<func nameset="afnix:sys">
842
<name>get-user-name</name>
846
The <code>get-user-name</code> function returns the current user