summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--THANKS1
-rw-r--r--ace/Message_Block.h16
2 files changed, 14 insertions, 3 deletions
diff --git a/THANKS b/THANKS
index a076e44ddf9..b5ed5311241 100644
--- a/THANKS
+++ b/THANKS
@@ -878,6 +878,7 @@ Chris Leishman <chris_leishman@freeonline.com.au>
Klemen Zagar <klemen.zagar@irj.si>
Rick Ohnemus <rjohnemus@systemware-inc.com>
Adamo, Vince <adamo@vignette.com>
+Defang Zhou <dzhou@zoo.uvm.edu>
I would particularly like to thank Paul Stephenson, who worked with me
at Ericsson. Paul devised the recursive Makefile scheme that
diff --git a/ace/Message_Block.h b/ace/Message_Block.h
index ea520e5b157..a6b750c212c 100644
--- a/ace/Message_Block.h
+++ b/ace/Message_Block.h
@@ -361,12 +361,22 @@ public:
// top-level <Message_Block>.
// = <ACE_Data_Block> methods.
+
ACE_Data_Block *data_block (void) const;
- // Get the data block.
+ // Get a pointer to the data block. Note that the <ACE_Message_Block>
+ // still references the block; this call does not change the reference
+ // count.
+
void data_block (ACE_Data_Block *);
- // Set the data block (releasing the original one).
+ // Set a new data block pointer. The original <ACE_Data_Block> is released
+ // as a result of this call. If you need to keep the original block, call
+ // <replace_data_block> instead. Upon return, this <ACE_Message_Block>
+ // holds a pointer to the new <ACE_Data_Block>, taking over the reference
+ // you held on it prior to the call.
+
ACE_Data_Block *replace_data_block (ACE_Data_Block*);
- // Set the data block (returning the original one).
+ // Set a new data block pointer. A pointer to the original <ACE_Data_Block>
+ // is returned, and not released (as it is with <data_block>).
// = The continuation field chains together composite messages.
ACE_Message_Block *cont (void) const;