An os_literal is text that is not encoded during conversion to HTML. The content of an os_literal is transferred to the HTML output stream exactly as the content was specified. In this respect, os_literal differs from os_text . The content of os_literal can be specified in a constructor or through operator= .

An os_literal can be used to add special character entity references to a page. The global functions os_copyright() , os_registered() , and os_plus_minus() add the copyright symbol, ©, the registered symbol, ť, and the plus/minus symbol, .

Declaration


  #include <ospace/web/literal.h>
class os_literal : public os_element

Interface

Constructor

os_literal()

Constructs an empty text literal.

Constructor

os_literal( const string& text )

Constructs a text literal containing a copy of text .

Constructor

os_literal( const os_literal& rhs )

Constructs a text literal that is a copy of rhs .

Destructor

/* virtual */ ~os_literal()

Destroys the text literal.

os_literal& operator=( const os_literal& rhs )

Replaces the text literal contents with a copy of rhs .

os_literal& operator=( const string& rhs )

Replaces the text literal contents with a copy of rhs .

string

operator string() const

Converts the text literal to a string .

clone

/* virtual */ os_element* clone() const

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

print

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

Prints the text literal to os .