PEAR Manual
PrevNext

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 24-1. Possible PEAR_Error values

Error codeError valueMeaningSolution
 ""  

Note

This function can not be called statically.

Example

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

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