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/