openvrml::mfstring Class Reference

A string array node field value. More...

#include <openvrml/field_value.h>

Inheritance diagram for openvrml::mfstring:

Public Types

typedef std::vector< std::string > value_type
 Type of value. More...
 
- Public Types inherited from openvrml::field_value

Public Member Functions

 mfstring (std::vector< std::string >::size_type n=0, const std::string &value=std::string()) throw ( std::bad_alloc )
 Construct. More...
 
 mfstring (const value_type &value) throw ( std::bad_alloc )
 Construct. More...
 
 mfstring (const mfstring &mfs)
 Construct a copy. More...
 
virtual ~mfstring () throw ()
 Destroy. More...
 
mfstringoperator= (const mfstring &mfs) throw ( std::bad_alloc )
 Assign. More...
 
const value_typevalue () const throw ()
 Access. More...
 
void value (const value_type &val) throw ( std::bad_alloc )
 Mutate. More...
 
void swap (mfstring &mfs) throw ()
 Swap. More...
 
- Public Member Functions inherited from openvrml::field_value
virtual ~field_value ()=0 throw ()
 Destroy. More...
 
std::auto_ptr< field_valueclone () const throw ( std::bad_alloc )
 Polymorphically construct a copy. More...
 
field_valueassign (const field_value &value) throw ( std::bad_cast , std::bad_alloc )
 Virtual assignment. More...
 
type_id type () const throw ()
 Get the field type. More...
 
template<typename FieldValue >
const FieldValue::value_type & value () const throw ()
 Access. More...
 
template<typename FieldValue >
void value (const typename FieldValue::value_type &val) throw ( std::bad_alloc )
 Mutate. More...
 
template<typename FieldValue >
void swap (FieldValue &val) throw ()
 Swap. More...
 

Static Public Attributes

static const type_id field_value_type_id = mfstring_id
 field_value::type_id for this class. More...
 

Private Member Functions

virtual std::auto_ptr< field_valuedo_clone () const throw ( std::bad_alloc )
 Polymorphically construct a copy. More...
 
virtual mfstringdo_assign (const field_value &value) throw ( std::bad_cast , std::bad_alloc )
 Virtual assignment. More...
 
virtual type_id do_type () const throw ()
 Get the field_value::type_id associated with this class. More...
 
virtual void print (std::ostream &) const
 Print to an output stream. More...
 

Related Functions

(Note that these are not member functions.)

bool operator== (const mfstring &lhs, const mfstring &rhs) throw()
 Compare for equality. More...
 
bool operator!= (const mfstring &lhs, const mfstring &rhs) throw()
 Compare for inequality. More...
 
template<> void swap (openvrml::mfstring &a, openvrml::mfstring &b)
 Swap the values of a and b. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from openvrml::field_value
static std::auto_ptr< field_valuecreate (type_id type) throw ( std::bad_alloc )
 Create a default instance of the type specified by type. More...
 
- Protected Member Functions inherited from openvrml::field_value
template<typename ValueType >
 field_value (const ValueType &value, const value_type_constructor_tag &) throw ( std::bad_alloc )
 Construct. More...
 
 field_value (const field_value &value) throw ( std::bad_alloc )
 Construct a copy. More...
 
template<typename FieldValue >
FieldValue & operator= (const FieldValue &fv) throw ( std::bad_alloc )
 Assignment operator. More...
 

Detailed Description

A string array node field value.

Model of
Field Value

Member Typedef Documentation

Constructor & Destructor Documentation

openvrml::mfstring::mfstring ( std::vector< std::string >::size_type  n = 0,
const std::string &  value = std::string() 
)
throw (std::bad_alloc
)
explicit

Construct.

Creates an mfstring with n copies of value.

Parameters
[in]nthe number elements in mfstring::value.
[in]valueused to initialize mfstring::value.
Exceptions
std::bad_allocif memory allocation fails.
Postcondition
mfstring::value.size() is n. Every element in mfstring::value is a copy of value.
openvrml::mfstring::mfstring ( const value_type value)
throw (std::bad_alloc
)
inlineexplicit

Construct.

Parameters
[in]valueinitial value.
Exceptions
std::bad_allocif memory allocation fails.
openvrml::mfstring::mfstring ( const mfstring mfs)

Construct a copy.

Parameters
[in]mfsthe instance to copy.
openvrml::mfstring::~mfstring ( )
throw (
)
virtual

Destroy.

Each of the mfstring's elements is destroyed, and memory allocated for them (if any) is deallocated.

Member Function Documentation

openvrml::mfstring & openvrml::mfstring::operator= ( const mfstring mfs)
throw (std::bad_alloc
)

Assign.

Parameters
[in]mfsthe value to assign.
Returns
a reference to the instance.
Exceptions
std::bad_allocif memory allocation fails.
const openvrml::mfstring::value_type & openvrml::mfstring::value ( ) const
throw (
)

Access.

Returns
the string values.
void openvrml::mfstring::value ( const value_type val)
throw (std::bad_alloc
)

Mutate.

Parameters
[in]valthe new value.
Exceptions
std::bad_allocif memory allocation fails.
void openvrml::mfstring::swap ( mfstring mfs)
throw (
)

Swap.

Parameters
[in,out]mfsthe value to swap with this one.
std::auto_ptr< openvrml::field_value > openvrml::mfstring::do_clone ( ) const
throw (std::bad_alloc
)
privatevirtual

Polymorphically construct a copy.

Returns
a pointer to a copy of the object.
Exceptions
std::bad_allocif memory allocation fails.

Implements openvrml::field_value.

openvrml::mfstring & openvrml::mfstring::do_assign ( const field_value value)
throw ( std::bad_cast ,
std::bad_alloc
)
privatevirtual

Virtual assignment.

Returns
a reference to the object.
Exceptions
std::bad_castif value is not an mfstring object.
std::bad_allocif memory allocation fails.

Implements openvrml::field_value.

openvrml::field_value::type_id openvrml::mfstring::do_type ( ) const
throw (
)
privatevirtual

Get the field_value::type_id associated with this class.

Returns
field_value::mfstring_id.

Implements openvrml::field_value.

void openvrml::mfstring::print ( std::ostream &  out) const
privatevirtual

Print to an output stream.

Parameters
[in,out]outan output stream.

Implements openvrml::field_value.

Friends And Related Function Documentation

bool operator== ( const mfstring lhs,
const mfstring rhs 
)
throw(
)
related

Compare for equality.

Parameters
[in]lhsleft-hand operand.
[in]rhsright-hand operand.
Returns
true if lhs and rhs have the same value; false otherwise.
bool operator!= ( const mfstring lhs,
const mfstring rhs 
)
throw(
)
related

Compare for inequality.

Parameters
[in]lhsleft-hand operand.
[in]rhsright-hand operand.
Returns
true if lhs and rhs do not have the same value; false otherwise.
template<> void swap ( openvrml::mfstring a,
openvrml::mfstring b 
)
related

Swap the values of a and b.

Does not throw.

Parameters
[in,out]a
[in,out]b

Member Data Documentation

const openvrml::field_value::type_id openvrml::mfstring::field_value_type_id = mfstring_id
static

field_value::type_id for this class.