An os_head is the portion of an os_page or an os_framed_page that contains elements to define meta-information. Meta-information provides information about the page to the browser. Elements within an os_head are not rendered by the browser. os_page and os_framed_page have an os_head by containment, so in most cases it is unnecessary to create an os_head explicitly.

Elements are inserted into an os_head through either the add() member function or operator<< . The os_head title can be specified in a constructor or through the title() member function. An os_head can contain elements like an os_meta_info object.

Declaration


  #include <ospace/web/head.h>
class os_head : public os_element_group

Interface

Constructor

os_head()

Constructs an empty head.

Constructor

os_head( const string& title )

Constructs a head with title title .

Constructor

os_head( const os_head& rhs )

Constructs a head that is a copy of rhs .

Destructor

/* virtual */ ~os_head()

Destroys the head.

os_head& operator=( const os_head& rhs )

Replaces the head contents with a copy of rhs and returns a reference to the head.

clone

/* virtual */ os_element* clone() const

Returns a base class pointer to a heap-based deep copy of the head.

print

/* virtual */ void print( ostream& os ) const

Prints the head to os .

title

os_head& title( const string& title )

Sets the title to title and returns a reference to the head.

title

string title() const

Returns the title, or the empty string if not set.