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

Error code | Error value | Meaning | Solution
--- | --- | --- | ---
| "" |  |

## Note

This function can not be called statically.

## Example

Example 31-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()