NAME

src/pmc/env.pmc - System Environment

DESCRIPTION

Env is a singleton class which provides access to the system environment.

XXX Think about returning Pair back. Currently there is no way to iterate over environment keys.

Methods

void *get_pointer()
void set_pointer(void *ptr)
These two functions are part of the singleton creation interface. For more information see src/pmc.c.
PMC *get_iter()
Returns a new iterator for the environment. This method is questionable, as environ is not in ISO-C.
INTVAL elements()
Returns the number of elements in the environment. This method is questionable, as environ is not in ISO-C.
INTVAL get_integer()
Returns the size of the hash.
FLOATVAL get_number()
Returns the size of the hash.
STRING *get_string_keyed(PMC *key)
Returns the Parrot string value for the environment variable *key.
STRING *get_string_keyed_int(PMC *key)
Returns the Parrot string value for the environment variable at position pos.Used during iteration.
STRING *get_pmc_keyed(PMC *key)
Returns a String PMC for the environment variable *key.
void set_string_keyed(PMC *key, STRING *value)
Sets the environment variable *key to *value.
void set_pmc_keyed(PMC *key, PMC *value)
Sets the environment variable *key to *value.
INTVAL exists_keyed(PMC *key)
Returns whether the environment variable for *key exists.
void delete_keyed(PMC *key)
Deletes the the environment variable for *key.

SEE ALS0

PDD - http://www.parrotcode.org/docs/pdd/pdd17_pdd.html#Hash_types

Environment in Perl 6 - http://dev.perl.org/perl6/rfc/318.html

Module for Perl 5 - http://search.cpan.org/~stas/Env-C-0.06/