ACE: ACE_Read_Buffer class Reference

00038   : stream_ (fp),
00039     close_on_delete_ (close_on_delete),
00040     allocator_ (alloc)
00041 {
00042   ACE_TRACE ("ACE_Read_Buffer::ACE_Read_Buffer");
00043   if (this->allocator_ == 0)
00044     this->allocator_ = ACE_Allocator::instance ();
00045 }

00051   : stream_ (ACE_OS::fdopen (handle, ACE_TEXT ("r"))),
00052     close_on_delete_ (close_on_delete),
00053     allocator_ (alloc)
00054 {
00055   ACE_TRACE ("ACE_Read_Buffer::ACE_Read_Buffer");
00056 
00057   if (this->allocator_ == 0)
00058     this->allocator_ = ACE_Allocator::instance ();
00059 }

00063 {
00064   ACE_TRACE ("ACE_Read_Buffer::~ACE_Read_Buffer");
00065 
00066   if (this->close_on_delete_)
00067     ACE_OS::fclose (this->stream_);
00068 }

00027 {
00028   ACE_TRACE ("ACE_Read_Buffer::alloc");
00029   return this->allocator_;
00030 }

00023 {
00024 #if defined (ACE_HAS_DUMP)
00025   ACE_TRACE ("ACE_Read_Buffer::dump");
00026   ACE_DEBUG ((LM_DEBUG, ACE_BEGIN_DUMP, this));
00027   ACE_DEBUG ((LM_DEBUG,  ACE_TEXT ("size_ = %d"), this->size_));
00028   ACE_DEBUG ((LM_DEBUG,  ACE_TEXT ("\noccurrences_ = %d"), this->occurrences_));
00029   ACE_DEBUG ((LM_DEBUG,  ACE_TEXT ("\nstream_ = %x"), this->stream_));
00030   ACE_DEBUG ((LM_DEBUG,  ACE_TEXT ("\nallocator_ = %x"), this->allocator_));
00031   ACE_DEBUG ((LM_DEBUG, ACE_END_DUMP));
00032 #endif /* ACE_HAS_DUMP */
00033 }

00078 {
00079   ACE_TRACE ("ACE_Read_Buffer::read");
00080   this->occurrences_ = 0;
00081   this->size_ = 0;
00082   return this->rec_read (term, search, replace);
00083 }

00098 {
00099   ACE_TRACE ("ACE_Read_Buffer::rec_read");
00100   // This is our temporary workspace.
00101   char buf[BUFSIZ];
00102 
00103   int c = EOF;
00104   size_t slot = 0;
00105   int done = 0;
00106 
00107   // Read in the file char by char
00108   while (slot < BUFSIZ)
00109     {
00110       c = ACE_OS::getc (this->stream_);
00111 
00112       // Don't insert EOF into the buffer...
00113       if (c == EOF)
00114         {
00115           ACE_OS::ungetc (c, this->stream_);
00116           break;
00117         }
00118       else if (c == term)
00119         done = 1;
00120 
00121       // Check for possible substitutions.
00122       if (c == search)
00123         {
00124           ++this->occurrences_;
00125 
00126           if (replace >= 0)
00127             c = replace;
00128         }
00129 
00130       buf[slot++] = (char) c;
00131 
00132       // Substitutions must be made before checking for termination.
00133       if (done)
00134         break;
00135     }
00136 
00137   // Increment the number of bytes.
00138   this->size_ += slot;
00139 
00140   // Don't bother going any farther if the total size is 0.
00141   if (this->size_ == 0)
00142     return 0;
00143 
00144   char *result = 0;
00145 
00146   // Recurse, when the recursion bottoms out, allocate the result
00147   // buffer.
00148   if (done || c == EOF)
00149     {
00150       // Use the allocator to acquire the memory.  The + 1 allows
00151       // space for the null terminator.
00152       result = (char *) this->allocator_->malloc (this->size_ + 1);
00153 
00154       if (result == 0)
00155         {
00156           errno = ENOMEM;
00157           return 0;
00158         }
00159       result += this->size_;
00160 
00161       // Null terminate the buffer.
00162       *result = '\0';
00163     }
00164   else if ((result = this->rec_read (term, search, replace)) == 0)
00165     return 0;
00166 
00167   // Copy buf into the appropriate location starting from end of
00168   // buffer.  Peter says this is confusing and that we should use
00169   // memcpy() ;-)
00170   for (size_t j = slot; j > 0; j--)
00171     *--result = buf[j - 1];
00172 
00173   return result;
00174 }

00020 {
00021   ACE_TRACE ("ACE_Read_Buffer::replaced");
00022   return this->occurrences_;
00023 }

00011 {
00012   ACE_TRACE ("ACE_Read_Buffer::size");
00013   return this->size_;
00014 }


Public Member Functions
	ACE_Read_Buffer (FILE fp, bool close_on_delete=false, ACE_Allocator =0)
	Read from a FILE *.
	ACE_Read_Buffer (ACE_HANDLE handle, bool close_on_delete=false, ACE_Allocator *=0)
	Read from an open HANDLE.
	~ACE_Read_Buffer (void)
	Closes the FILE *.
char *	read (int terminator=EOF, int search= '\n', int replace= '\0')
size_t	replaced (void) const
	Returns the number of characters replaced during a `read`.
size_t	size (void) const
ACE_Allocator *	alloc (void) const
	Returns a pointer to its allocator.
void	dump (void) const
	Dump the state of the object.
Private Member Functions
void	operator= (const ACE_Read_Buffer &)
	ACE_Read_Buffer (const ACE_Read_Buffer &)
char *	rec_read (int term, int search, int replace)
	Recursive helper method that does the work...
Private Attributes
size_t	size_
	The total number of characters in the buffer.
size_t	occurrences_
	The total number of characters replaced.
FILE *	stream_
	The stream we are reading from.
bool const	close_on_delete_
ACE_Allocator *	allocator_
	Pointer to the allocator.

ACE_Read_Buffer Class Reference

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation