PEAR Manual
Prev		Next

Config_Container::createBlank()

Config_Container::createBlank() -- Add blank line to item

Synopsis

require_once 'Config/Container.php';

objectConfig_Container::createBlank ([mixed $where = 'bottom' [, mixed $target = NULL]])

Description

The current item must be a section. This is a helper method that calls createItem()

Parameter

string $where: Where to create the new item ('top', 'bottom', 'before', 'after')
object $target: Required only if 'before' or 'after' is used for $where

Return value

object - reference to new item

Throws

Table 37-1. Possible PEAR_Error values

Error code	Error value	Meaning	Solution
	""

Note

This function can not be called statically.

Example

Example 37-1. Create a new directive using createBlank()

$section =& new Config_Container('section', 'conf');
$directive =& $section->createDirective('user', 'mansion');
$section->createBlank('before', $directive);

Prev	Home	Next
Config_Container::countChildren()	Up	Config_Container::createComment()