A page of ConfigDeclarations that may be loaded or unloaded. More...

#include "configPage.h"

Public Member Functions
void	clear ()
	Removes all of the declarations from the page. More...

bool	delete_declaration (ConfigDeclaration *decl)
	Removes the indicated declaration from the page and deletes it. More...

const ConfigDeclaration *	get_declaration (size_t n) const
	Returns the nth declaration on the page. More...

const std::string &	get_name () const

size_t	get_num_declarations () const

int	get_page_seq () const

const std::string &	get_signature () const

int	get_sort () const

std::string	get_string_value (size_t n) const
	Returns the value assigned by the nth declaration on the page. More...

int	get_trust_level () const

std::string	get_variable_name (size_t n) const
	Returns the variable named by the nth declaration on the page. More...

bool	is_implicit () const

bool	is_special () const

bool	is_variable_used (size_t n) const
	Returns true if the nth active variable on the page has been used by code, false otherwise. More...

ConfigDeclaration *	make_declaration (const std::string &variable, const std::string &value)
	Adds the indicated variable/value pair as a new declaration on the page. More...

ConfigDeclaration *	make_declaration (ConfigVariableCore *variable, const std::string &value)
	Adds the indicated variable/value pair as a new declaration on the page. More...

ConfigDeclaration *	modify_declaration (size_t n)

bool	operator< (const ConfigPage &other) const
	Sorts two pages in order based on the order in which their respective pages were loaded, and the order in which they appear within the same page. More...

void	output (std::ostream &out) const

void	output_brief_signature (std::ostream &out) const
	Outputs the first few hex digits of the signature. More...

bool	read_encrypted_prc (std::istream &in, const std::string &password)
	Automatically decrypts and reads the stream, given the indicated password. More...

bool	read_prc (std::istream &in)
	Reads the contents of a complete prc file, as returned by the indicated istream, into the current page file. More...

void	set_sort (int sort)

void	set_trust_level (int trust_level)

void	write (std::ostream &out) const

Static Public Member Functions
static ConfigPage *	get_default_page ()
	Returns a pointer to the global "default page". More...

static ConfigPage *	get_local_page ()
	Returns a pointer to the global "local page". More...

Public Attributes
	get_name
	Returns the name of the page. More...

	get_num_declarations
	Returns the number of declarations on the page. More...

	get_page_seq
	Returns the sequence number of the page. More...

	get_signature
	Returns the raw binary signature that was found in the prc file, if any. More...

	get_sort
	Returns the explicit sort order of this particular ConfigPage. More...

	get_trust_level
	Returns the trust level associated with this page. More...

	is_implicit
	Returns true if the page was loaded by implicitly searching the config path on startup, or false if it was explicitly loaded by dynamic code after initial startup. More...

	is_special
	Returns true if this is the special "default" or "local" page, or false if it is an ordinary page, e.g. More...

	modify_declaration
	Returns a modifiable pointer to the nth declaration on the page. More...

	set_sort
	Changes the explicit sort order of this particular ConfigPage. More...

	set_trust_level
	Explicitly sets the trust level on this particular page. More...

Friends
class	ConfigPageManager

Detailed Description

A page of ConfigDeclarations that may be loaded or unloaded.

Typically this represents a single .prc file that is read from disk at runtime, but it may also represent a list of declarations built up by application code and explicitly loaded.

Definition at line 30 of file configPage.h.

Member Function Documentation

◆ clear()

void ConfigPage::clear ( )

Removes all of the declarations from the page.

Definition at line 103 of file configPage.cxx.

Referenced by read_prc().

◆ delete_declaration()

bool ConfigPage::delete_declaration ( ConfigDeclaration * decl )

Removes the indicated declaration from the page and deletes it.

Returns true if the declaration is successfully removed, false if it was not on the page.

Definition at line 263 of file configPage.cxx.

Referenced by ConfigVariableCore::clear_local_value().

◆ get_declaration()

const ConfigDeclaration * ConfigPage::get_declaration ( size_t n ) const

Returns the nth declaration on the page.

Definition at line 289 of file configPage.cxx.

◆ get_default_page()

ConfigPage * ConfigPage::get_default_page ( )

static

Returns a pointer to the global "default page".

This is the ConfigPage that lists all variables' original default values.

Definition at line 64 of file configPage.cxx.

◆ get_local_page()

ConfigPage * ConfigPage::get_local_page ( )

static

Returns a pointer to the global "local page".

This is the ConfigPage that lists the locally-assigned values for any variables in the world that have such a local assignment.

Definition at line 77 of file configPage.cxx.

Referenced by ConfigVariableCore::clear_local_value(), and ConfigVariableCore::make_local_value().

◆ get_string_value()

string ConfigPage::get_string_value ( size_t n ) const

Returns the value assigned by the nth declaration on the page.

Definition at line 318 of file configPage.cxx.

◆ get_variable_name()

string ConfigPage::get_variable_name ( size_t n ) const

Returns the variable named by the nth declaration on the page.

Definition at line 309 of file configPage.cxx.

◆ is_variable_used()

bool ConfigPage::is_variable_used ( size_t n ) const

Returns true if the nth active variable on the page has been used by code, false otherwise.

Definition at line 328 of file configPage.cxx.

◆ make_declaration() [1/2]

ConfigDeclaration * ConfigPage::make_declaration	(	const std::string &	variable,
		const std::string &	value
	)

Adds the indicated variable/value pair as a new declaration on the page.

Definition at line 237 of file configPage.cxx.

References ConfigVariableManager::make_variable().

Referenced by ConfigVariableCore::make_local_value().

◆ make_declaration() [2/2]

ConfigDeclaration * ConfigPage::make_declaration	(	ConfigVariableCore *	variable,
		const std::string &	value
	)

Adds the indicated variable/value pair as a new declaration on the page.

Definition at line 246 of file configPage.cxx.

◆ operator<()

bool ConfigPage::operator< ( const ConfigPage & other ) const

inline

Sorts two pages in order based on the order in which their respective pages were loaded, and the order in which they appear within the same page.

Definition at line 19 of file configPage.I.

References get_page_seq, and get_sort.

◆ output_brief_signature()

void ConfigPage::output_brief_signature ( std::ostream & out ) const

Outputs the first few hex digits of the signature.

Definition at line 346 of file configPage.cxx.

◆ read_encrypted_prc()

bool ConfigPage::read_encrypted_prc	(	std::istream &	in,
		const std::string &	password
	)

Automatically decrypts and reads the stream, given the indicated password.

Note that if the password is incorrect, the result may be garbage.

Definition at line 224 of file configPage.cxx.

◆ read_prc()

bool ConfigPage::read_prc ( std::istream & in )

Reads the contents of a complete prc file, as returned by the indicated istream, into the current page file.

Returns true on success, or false on some I/O error.

This is a low-level interface. Normally you do not need to call it directly. See the global functions load_prc_file() and unload_prc_file(), defined in panda/src/putil, for a higher-level interface.

Definition at line 124 of file configPage.cxx.

References clear().

Member Data Documentation

◆ get_name

const std::string & ConfigPage::get_name

inline

Returns the name of the page.

If the page was loaded from a .prc file, this is usually the filename.

Definition at line 43 of file configPage.h.

Referenced by ConfigDeclaration::get_filename_value().

◆ get_num_declarations

size_t ConfigPage::get_num_declarations

Returns the number of declarations on the page.

Definition at line 77 of file configPage.h.

◆ get_page_seq

int ConfigPage::get_page_seq

inline

Returns the sequence number of the page.

Sequence numbers for a particular class (implicit vs. explicit) of pages are assigned as each page is loaded; each page is given a higher sequence number than all the pages loaded before it.

The implicit_load pages, which are discovered in the file system automatically, have a different set of sequence numbers than the explicit pages.

Definition at line 58 of file configPage.h.

Referenced by operator<().

◆ get_signature

const std::string & ConfigPage::get_signature

inline

Returns the raw binary signature that was found in the prc file, if any.

This method is probably not terribly useful for most applications.

Definition at line 60 of file configPage.h.

◆ get_sort

int ConfigPage::get_sort

inline

Returns the explicit sort order of this particular ConfigPage.

See set_sort().

Definition at line 52 of file configPage.h.

Referenced by operator<().

◆ get_trust_level

int ConfigPage::get_trust_level

inline

Returns the trust level associated with this page.

An untrusted page is trust level 0; if the page was loaded from a signed .prc file, its trust level is the index number of the certificate that signed it. Generally, a higher trust level value represents a greater level of trust.

Definition at line 59 of file configPage.h.

◆ is_implicit

bool ConfigPage::is_implicit

inline

Returns true if the page was loaded by implicitly searching the config path on startup, or false if it was explicitly loaded by dynamic code after initial startup.

Definition at line 48 of file configPage.h.

◆ is_special

bool ConfigPage::is_special

inline

Returns true if this is the special "default" or "local" page, or false if it is an ordinary page, e.g.

an implicit page loaded from a prc file at startup, or an explicit page created by ConfigPageManager::make_explicit_page().

Definition at line 47 of file configPage.h.

◆ modify_declaration

ConfigDeclaration * ConfigPage::modify_declaration

Returns a modifiable pointer to the nth declaration on the page.

Any modifications will appear in the output, if the page is written out with ConfigPage::write().

Definition at line 77 of file configPage.h.

◆ set_sort

void ConfigPage::set_sort

Changes the explicit sort order of this particular ConfigPage.

Lower- numbered pages supercede higher-numbered pages. Initially, all explicitly- loaded pages have sort value 0, and implicitly-loaded pages (found on disk) have sort value 10; you may set an individual page higher or lower to influence its priority relative to other pages.

Definition at line 52 of file configPage.h.

◆ set_trust_level

void ConfigPage::set_trust_level

inline

Explicitly sets the trust level on this particular page.

Note that any subsequent changes to the page, or to any variable declarations on it, will reset the trust level to zero.

Definition at line 59 of file configPage.h.

The documentation for this class was generated from the following files:

dtool/src/prc/configPage.h
dtool/src/prc/configPage.cxx
dtool/src/prc/configPage.I

Public Member Functions

Static Public Member Functions

Public Attributes

Friends

Detailed Description

Member Function Documentation

◆ clear()

◆ delete_declaration()

◆ get_declaration()

◆ get_default_page()

◆ get_local_page()

◆ get_string_value()

◆ get_variable_name()

◆ is_variable_used()

◆ make_declaration() [1/2]

◆ make_declaration() [2/2]

◆ operator<()

◆ output_brief_signature()

◆ read_encrypted_prc()

◆ read_prc()

Member Data Documentation

◆ get_name

◆ get_num_declarations

◆ get_page_seq

◆ get_signature

◆ get_sort

◆ get_trust_level

◆ is_implicit

◆ is_special

◆ modify_declaration

◆ set_sort

◆ set_trust_level