summaryrefslogtreecommitdiff
path: root/ace/Read_Buffer.h
diff options
context:
space:
mode:
Diffstat (limited to 'ace/Read_Buffer.h')
-rw-r--r--ace/Read_Buffer.h114
1 files changed, 0 insertions, 114 deletions
diff --git a/ace/Read_Buffer.h b/ace/Read_Buffer.h
deleted file mode 100644
index ad1bef9fa32..00000000000
--- a/ace/Read_Buffer.h
+++ /dev/null
@@ -1,114 +0,0 @@
-/* -*- C++ -*- */
-
-//=============================================================================
-/**
- * @file Read_Buffer.h
- *
- * $Id$
- *
- * @author Doug Schmidt and Seth Widoff
- */
-//=============================================================================
-
-
-#ifndef ACE_READ_BUFFER_H
-#define ACE_READ_BUFFER_H
-#include "ace/pre.h"
-
-#include "ace/ACE.h"
-
-#if !defined (ACE_LACKS_PRAGMA_ONCE)
-# pragma once
-#endif /* ACE_LACKS_PRAGMA_ONCE */
-
-#include "ace/Malloc.h"
-
-/**
- * @class ACE_Read_Buffer
- *
- * @brief Efficiently reads an artibrarily large buffer from an input
- * stream up to and including a termination character. Also
- * performs search/replace on single occurrences a character in
- * the buffer using the principles of Integrated Layer
- * Processing.
- *
- * This implementation is optimized to do a single dynamic
- * allocation and make only one copy of the data. It uses
- * recursion and the run-time stack to accomplish this
- * efficiently.
- */
-class ACE_Export ACE_Read_Buffer
-{
-public:
- // = Initialization and termination methods.
- /// Read from a FILE *.
- ACE_Read_Buffer (FILE *fp,
- int close_on_delete = 0,
- ACE_Allocator * = 0);
-
- /// Read from an open HANDLE.
- ACE_Read_Buffer (ACE_HANDLE handle,
- int close_on_delete = 0,
- ACE_Allocator * = 0);
-
- /// Closes the FILE *.
- ~ACE_Read_Buffer (void);
-
- /**
- * Returns a pointer dynamically allocated with
- * <ACE_Allocator::malloc> to data from the input stream up to (and
- * including) the <terminator>. If <search> is >= 0 then all
- * occurrences of the <search> value are substituted with the
- * <replace> value. The last of the byte of data is a 0, so that
- * <strlen> can be used on it. The caller is responsible for
- * freeing the pointer returned from this method using the
- * <ACE_Allocator::free>.
- */
- char *read (int terminator = EOF,
- int search = '\n',
- int replace = '\0');
-
- /// Returns the number of characters replaced during a <read>.
- size_t replaced (void) const;
-
- /// Returns the size of the allocated buffer obtained during a
- /// <read>, not including the null terminator.
- size_t size (void) const;
-
- /// Returns a pointer to its allocator.
- ACE_Allocator *alloc (void) const;
-
- /// Dump the state of the object.
- void dump (void) const;
-
-private:
- /// Recursive helper method that does the work...
- char *rec_read (int term, int search, int replace);
-
- /// The total number of characters in the buffer.
- size_t size_;
-
- /// The total number of characters replaced.
- size_t occurrences_;
-
- /// The stream we are reading from.
- FILE *stream_;
-
- /// Keeps track of whether we should close the FILE in the
- /// destructor.
- int close_on_delete_;
-
- /// Pointer to the allocator.
- ACE_Allocator *allocator_;
-
- // = Disallow copying and assignment...
- ACE_UNIMPLEMENTED_FUNC (void operator= (const ACE_Read_Buffer &))
- ACE_UNIMPLEMENTED_FUNC (ACE_Read_Buffer (const ACE_Read_Buffer &))
-};
-
-#if defined (__ACE_INLINE__)
-# include "ace/Read_Buffer.i"
-#endif /* __ACE_INLINE__ */
-
-#include "ace/post.h"
-#endif /* ACE_READ_BUFFER_H */