diff options
Diffstat (limited to 'TAO/tao/Sequence_T.h')
-rw-r--r-- | TAO/tao/Sequence_T.h | 89 |
1 files changed, 1 insertions, 88 deletions
diff --git a/TAO/tao/Sequence_T.h b/TAO/tao/Sequence_T.h index 952d1a6af7f..94df1ddcb6a 100644 --- a/TAO/tao/Sequence_T.h +++ b/TAO/tao/Sequence_T.h @@ -767,94 +767,7 @@ public: // reference elements, which are freed using release(). The freebuf // function will ignore null pointers passed to it. - // Functions to create, destroy, and adjust the underlying buffer. - virtual void _allocate_buffer (CORBA::ULong length); - virtual void _deallocate_buffer (void); - virtual void _shrink_buffer (CORBA::ULong new_length, - CORBA::ULong old_length); -}; - -// ************************************************************* - -template<size_t MAX> -class TAO_Bounded_WString_Sequence : public TAO_Bounded_Base_Sequence -{ - // = TITLE - // Bounded sequence of wstrings. - // - // = DESCRIPTION - // As its unbounded counterpart it duplicates and releases strings - // (via CORBA::wstring_dup and CORBA::wstring_free) under the - // control of a per sequence flag, but the capacity of the - // sequence is bound on the type. -public: - TAO_Bounded_WString_Sequence (void); - // {SPEC} - // For bounded sequences, the maximum length is part of the type and - // cannot be set or modified, while for unbounded sequences, the - // default constructor also sets the maximum length to 0. The - // default constructor for a bounded sequence always allocates a - // contents vector, so it always sets the release flag to TRUE. - - TAO_Bounded_WString_Sequence (CORBA::ULong length, - CORBA::WChar* *value, - CORBA::Boolean release = 0); - // {SPEC} - // The ``T *data'' constructor (as shown in the example above) - // allows the length and contents of a bounded or unbounded sequence - // to be set. For unbounded sequences, it also allows the initial - // value of the maximum length to be set. For this constructor, - // ownership of the contents vector is determined by the release - // parameter---FALSE means the caller owns the storage, while TRUE - // means that the sequence assumes ownership of the storage. - // - // If release is TRUE, the contents vector must have been allocated - // using the sequence allocbuf function, and the sequence will pass - // it to freebuf when finished with it. - - TAO_Bounded_WString_Sequence (const TAO_Bounded_WString_Sequence<MAX> &); - // {SPEC} - // Management Functions'' on page 16. The copy constructor creates a - // new sequence with the same maximum and length as the given - // sequence, copies each of its current elements (items zero through - // length--1), and sets the release flag to TRUE. - - TAO_Bounded_WString_Sequence &operator= (const TAO_Bounded_WString_Sequence<MAX> &); - // {SPEC} - // The assignment operator deep copies its parameter, releasing - // old storage if necessary. It behaves as if the original sequence - // is destroyed via its destructor and then the source sequence - // copied using the copy constructor. - - ~TAO_Bounded_WString_Sequence (void); - // {SPEC} - // If release=TRUE, the destructor destroys each of the current - // elements (items zero through length-1). - - TAO_SeqElem_WString_Manager operator[] (CORBA::ULong slot) const; - // read-write accessor - - static CORBA::WChar **allocbuf (CORBA::ULong length); - // {SPEC} - // The allocbuf function allocates a vector of T elements that can - // be passed to the T *data constructor. The length of the vector is - // given by the nelems function argument. The allocbuf function - // initializes each element using its default constructor, except - // for (w)strings, which are initialized to null pointers, and object - // references, which are initialized to suitably typed nil object - // references. A null pointer is returned if allocbuf for some - // reason cannot allocate the requested vector. Vectors allocated by - // allocbuf should be freed using the freebuf function. - - static void freebuf (CORBA::WChar **buffer); - // {SPEC} - // The freebuf function ensures that the destructor for each element - // is called before the buffer is destroyed, except for string - // elements, which are freed using wstring_free(), and object - // reference elements, which are freed using release(). The freebuf - // function will ignore null pointers passed to it. - - // Functions to create, destroy, and adjust the underlying buffer. + // @@ Please document me. virtual void _allocate_buffer (CORBA::ULong length); virtual void _deallocate_buffer (void); virtual void _shrink_buffer (CORBA::ULong new_length, |