An os_title defines the title of a page and provides meta-information about the page. The content of os_title can be specified in a constructor or through operator= .

Although an os_title is not rendered with the page content, browsers typically display the os_title as a label on the browser window or within a history list. The length of the title is not limited; however, it may be truncated by some browsers. To minimize this possibility, the title typically should be limited to fewer than 64 characters.

An os_head has an os_title by containment, so it is unnecessary in most cases to create an os_title explicitly.

Declaration


  #include <ospace/web/title.h>
class os_title : public os_element

Interface

Constructor

os_title()

Constructs an empty title.

Constructor

os_title( const string& title )

Constructs a title from title .

Constructor

os_title( const os_title& rhs )

Constructs a title that is a copy of rhs .

Destructor

/* virtual */ ~os_title()

Destroys the title.

os_title& operator=( const string& rhs )

Replaces the title with a copy of rhs .

os_title& operator=( const os_title& rhs )

Replaces the contents of the title with a copy of rhs .

string

operator string() const

Converts the title to a string .

clone

/* virtual */ os_element* clone() const

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

print

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

Prints the title to os .