| Index: third_party/protobuf/src/google/protobuf/stubs/bytestream.h
|
| diff --git a/third_party/protobuf/src/google/protobuf/stubs/bytestream.h b/third_party/protobuf/src/google/protobuf/stubs/bytestream.h
|
| deleted file mode 100644
|
| index de8e0204580ae80af6d1b2226f899b3bb9595a57..0000000000000000000000000000000000000000
|
| --- a/third_party/protobuf/src/google/protobuf/stubs/bytestream.h
|
| +++ /dev/null
|
| @@ -1,348 +0,0 @@
|
| -// Protocol Buffers - Google's data interchange format
|
| -// Copyright 2008 Google Inc. All rights reserved.
|
| -// https://developers.google.com/protocol-buffers/
|
| -//
|
| -// Redistribution and use in source and binary forms, with or without
|
| -// modification, are permitted provided that the following conditions are
|
| -// met:
|
| -//
|
| -// * Redistributions of source code must retain the above copyright
|
| -// notice, this list of conditions and the following disclaimer.
|
| -// * Redistributions in binary form must reproduce the above
|
| -// copyright notice, this list of conditions and the following disclaimer
|
| -// in the documentation and/or other materials provided with the
|
| -// distribution.
|
| -// * Neither the name of Google Inc. nor the names of its
|
| -// contributors may be used to endorse or promote products derived from
|
| -// this software without specific prior written permission.
|
| -//
|
| -// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
| -// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
| -// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
| -// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
| -// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
| -// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
| -// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
| -// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
| -// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
| -// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
| -// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
| -
|
| -// This file declares the ByteSink and ByteSource abstract interfaces. These
|
| -// interfaces represent objects that consume (ByteSink) or produce (ByteSource)
|
| -// a sequence of bytes. Using these abstract interfaces in your APIs can help
|
| -// make your code work with a variety of input and output types.
|
| -//
|
| -// This file also declares the following commonly used implementations of these
|
| -// interfaces.
|
| -//
|
| -// ByteSink:
|
| -// UncheckedArrayByteSink Writes to an array, without bounds checking
|
| -// CheckedArrayByteSink Writes to an array, with bounds checking
|
| -// GrowingArrayByteSink Allocates and writes to a growable buffer
|
| -// StringByteSink Writes to an STL string
|
| -// NullByteSink Consumes a never-ending stream of bytes
|
| -//
|
| -// ByteSource:
|
| -// ArrayByteSource Reads from an array or string/StringPiece
|
| -// LimitedByteSource Limits the number of bytes read from an
|
| -
|
| -#ifndef GOOGLE_PROTOBUF_STUBS_BYTESTREAM_H_
|
| -#define GOOGLE_PROTOBUF_STUBS_BYTESTREAM_H_
|
| -
|
| -#include <stddef.h>
|
| -#include <string>
|
| -
|
| -#include <google/protobuf/stubs/common.h>
|
| -#include <google/protobuf/stubs/stringpiece.h>
|
| -
|
| -class CordByteSink;
|
| -class MemBlock;
|
| -
|
| -namespace google {
|
| -namespace protobuf {
|
| -namespace strings {
|
| -
|
| -// An abstract interface for an object that consumes a sequence of bytes. This
|
| -// interface offers 3 different ways to append data, and a Flush() function.
|
| -//
|
| -// Example:
|
| -//
|
| -// string my_data;
|
| -// ...
|
| -// ByteSink* sink = ...
|
| -// sink->Append(my_data.data(), my_data.size());
|
| -// sink->Flush();
|
| -//
|
| -class LIBPROTOBUF_EXPORT ByteSink {
|
| - public:
|
| - ByteSink() {}
|
| - virtual ~ByteSink() {}
|
| -
|
| - // Appends the "n" bytes starting at "bytes".
|
| - virtual void Append(const char* bytes, size_t n) = 0;
|
| -
|
| - // Flushes internal buffers. The default implemenation does nothing. ByteSink
|
| - // subclasses may use internal buffers that require calling Flush() at the end
|
| - // of the stream.
|
| - virtual void Flush();
|
| -
|
| - private:
|
| - GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(ByteSink);
|
| -};
|
| -
|
| -// An abstract interface for an object that produces a fixed-size sequence of
|
| -// bytes.
|
| -//
|
| -// Example:
|
| -//
|
| -// ByteSource* source = ...
|
| -// while (source->Available() > 0) {
|
| -// StringPiece data = source->Peek();
|
| -// ... do something with "data" ...
|
| -// source->Skip(data.length());
|
| -// }
|
| -//
|
| -class LIBPROTOBUF_EXPORT ByteSource {
|
| - public:
|
| - ByteSource() {}
|
| - virtual ~ByteSource() {}
|
| -
|
| - // Returns the number of bytes left to read from the source. Available()
|
| - // should decrease by N each time Skip(N) is called. Available() may not
|
| - // increase. Available() returning 0 indicates that the ByteSource is
|
| - // exhausted.
|
| - //
|
| - // Note: Size() may have been a more appropriate name as it's more
|
| - // indicative of the fixed-size nature of a ByteSource.
|
| - virtual size_t Available() const = 0;
|
| -
|
| - // Returns a StringPiece of the next contiguous region of the source. Does not
|
| - // reposition the source. The returned region is empty iff Available() == 0.
|
| - //
|
| - // The returned region is valid until the next call to Skip() or until this
|
| - // object is destroyed, whichever occurs first.
|
| - //
|
| - // The length of the returned StringPiece will be <= Available().
|
| - virtual StringPiece Peek() = 0;
|
| -
|
| - // Skips the next n bytes. Invalidates any StringPiece returned by a previous
|
| - // call to Peek().
|
| - //
|
| - // REQUIRES: Available() >= n
|
| - virtual void Skip(size_t n) = 0;
|
| -
|
| - // Writes the next n bytes in this ByteSource to the given ByteSink, and
|
| - // advances this ByteSource past the copied bytes. The default implementation
|
| - // of this method just copies the bytes normally, but subclasses might
|
| - // override CopyTo to optimize certain cases.
|
| - //
|
| - // REQUIRES: Available() >= n
|
| - virtual void CopyTo(ByteSink* sink, size_t n);
|
| -
|
| - private:
|
| - GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(ByteSource);
|
| -};
|
| -
|
| -//
|
| -// Some commonly used implementations of ByteSink
|
| -//
|
| -
|
| -// Implementation of ByteSink that writes to an unsized byte array. No
|
| -// bounds-checking is performed--it is the caller's responsibility to ensure
|
| -// that the destination array is large enough.
|
| -//
|
| -// Example:
|
| -//
|
| -// char buf[10];
|
| -// UncheckedArrayByteSink sink(buf);
|
| -// sink.Append("hi", 2); // OK
|
| -// sink.Append(data, 100); // WOOPS! Overflows buf[10].
|
| -//
|
| -class LIBPROTOBUF_EXPORT UncheckedArrayByteSink : public ByteSink {
|
| - public:
|
| - explicit UncheckedArrayByteSink(char* dest) : dest_(dest) {}
|
| - virtual void Append(const char* data, size_t n);
|
| -
|
| - // Returns the current output pointer so that a caller can see how many bytes
|
| - // were produced.
|
| - //
|
| - // Note: this method is not part of the ByteSink interface.
|
| - char* CurrentDestination() const { return dest_; }
|
| -
|
| - private:
|
| - char* dest_;
|
| - GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(UncheckedArrayByteSink);
|
| -};
|
| -
|
| -// Implementation of ByteSink that writes to a sized byte array. This sink will
|
| -// not write more than "capacity" bytes to outbuf. Once "capacity" bytes are
|
| -// appended, subsequent bytes will be ignored and Overflowed() will return true.
|
| -// Overflowed() does not cause a runtime error (i.e., it does not CHECK fail).
|
| -//
|
| -// Example:
|
| -//
|
| -// char buf[10];
|
| -// CheckedArrayByteSink sink(buf, 10);
|
| -// sink.Append("hi", 2); // OK
|
| -// sink.Append(data, 100); // Will only write 8 more bytes
|
| -//
|
| -class LIBPROTOBUF_EXPORT CheckedArrayByteSink : public ByteSink {
|
| - public:
|
| - CheckedArrayByteSink(char* outbuf, size_t capacity);
|
| - virtual void Append(const char* bytes, size_t n);
|
| -
|
| - // Returns the number of bytes actually written to the sink.
|
| - size_t NumberOfBytesWritten() const { return size_; }
|
| -
|
| - // Returns true if any bytes were discarded, i.e., if there was an
|
| - // attempt to write more than 'capacity' bytes.
|
| - bool Overflowed() const { return overflowed_; }
|
| -
|
| - private:
|
| - char* outbuf_;
|
| - const size_t capacity_;
|
| - size_t size_;
|
| - bool overflowed_;
|
| - GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(CheckedArrayByteSink);
|
| -};
|
| -
|
| -// Implementation of ByteSink that allocates an internal buffer (a char array)
|
| -// and expands it as needed to accomodate appended data (similar to a string),
|
| -// and allows the caller to take ownership of the internal buffer via the
|
| -// GetBuffer() method. The buffer returned from GetBuffer() must be deleted by
|
| -// the caller with delete[]. GetBuffer() also sets the internal buffer to be
|
| -// empty, and subsequent appends to the sink will create a new buffer. The
|
| -// destructor will free the internal buffer if GetBuffer() was not called.
|
| -//
|
| -// Example:
|
| -//
|
| -// GrowingArrayByteSink sink(10);
|
| -// sink.Append("hi", 2);
|
| -// sink.Append(data, n);
|
| -// const char* buf = sink.GetBuffer(); // Ownership transferred
|
| -// delete[] buf;
|
| -//
|
| -class LIBPROTOBUF_EXPORT GrowingArrayByteSink : public strings::ByteSink {
|
| - public:
|
| - explicit GrowingArrayByteSink(size_t estimated_size);
|
| - virtual ~GrowingArrayByteSink();
|
| - virtual void Append(const char* bytes, size_t n);
|
| -
|
| - // Returns the allocated buffer, and sets nbytes to its size. The caller takes
|
| - // ownership of the buffer and must delete it with delete[].
|
| - char* GetBuffer(size_t* nbytes);
|
| -
|
| - private:
|
| - void Expand(size_t amount);
|
| - void ShrinkToFit();
|
| -
|
| - size_t capacity_;
|
| - char* buf_;
|
| - size_t size_;
|
| - GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(GrowingArrayByteSink);
|
| -};
|
| -
|
| -// Implementation of ByteSink that appends to the given string.
|
| -// Existing contents of "dest" are not modified; new data is appended.
|
| -//
|
| -// Example:
|
| -//
|
| -// string dest = "Hello ";
|
| -// StringByteSink sink(&dest);
|
| -// sink.Append("World", 5);
|
| -// assert(dest == "Hello World");
|
| -//
|
| -class LIBPROTOBUF_EXPORT StringByteSink : public ByteSink {
|
| - public:
|
| - explicit StringByteSink(string* dest) : dest_(dest) {}
|
| - virtual void Append(const char* data, size_t n);
|
| -
|
| - private:
|
| - string* dest_;
|
| - GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(StringByteSink);
|
| -};
|
| -
|
| -// Implementation of ByteSink that discards all data.
|
| -//
|
| -// Example:
|
| -//
|
| -// NullByteSink sink;
|
| -// sink.Append(data, data.size()); // All data ignored.
|
| -//
|
| -class LIBPROTOBUF_EXPORT NullByteSink : public ByteSink {
|
| - public:
|
| - NullByteSink() {}
|
| - virtual void Append(const char *data, size_t n) {}
|
| -
|
| - private:
|
| - GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(NullByteSink);
|
| -};
|
| -
|
| -//
|
| -// Some commonly used implementations of ByteSource
|
| -//
|
| -
|
| -// Implementation of ByteSource that reads from a StringPiece.
|
| -//
|
| -// Example:
|
| -//
|
| -// string data = "Hello";
|
| -// ArrayByteSource source(data);
|
| -// assert(source.Available() == 5);
|
| -// assert(source.Peek() == "Hello");
|
| -//
|
| -class LIBPROTOBUF_EXPORT ArrayByteSource : public ByteSource {
|
| - public:
|
| - explicit ArrayByteSource(StringPiece s) : input_(s) {}
|
| -
|
| - virtual size_t Available() const;
|
| - virtual StringPiece Peek();
|
| - virtual void Skip(size_t n);
|
| -
|
| - private:
|
| - StringPiece input_;
|
| - GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(ArrayByteSource);
|
| -};
|
| -
|
| -// Implementation of ByteSource that wraps another ByteSource, limiting the
|
| -// number of bytes returned.
|
| -//
|
| -// The caller maintains ownership of the underlying source, and may not use the
|
| -// underlying source while using the LimitByteSource object. The underlying
|
| -// source's pointer is advanced by n bytes every time this LimitByteSource
|
| -// object is advanced by n.
|
| -//
|
| -// Example:
|
| -//
|
| -// string data = "Hello World";
|
| -// ArrayByteSource abs(data);
|
| -// assert(abs.Available() == data.size());
|
| -//
|
| -// LimitByteSource limit(abs, 5);
|
| -// assert(limit.Available() == 5);
|
| -// assert(limit.Peek() == "Hello");
|
| -//
|
| -class LIBPROTOBUF_EXPORT LimitByteSource : public ByteSource {
|
| - public:
|
| - // Returns at most "limit" bytes from "source".
|
| - LimitByteSource(ByteSource* source, size_t limit);
|
| -
|
| - virtual size_t Available() const;
|
| - virtual StringPiece Peek();
|
| - virtual void Skip(size_t n);
|
| -
|
| - // We override CopyTo so that we can forward to the underlying source, in
|
| - // case it has an efficient implementation of CopyTo.
|
| - virtual void CopyTo(ByteSink* sink, size_t n);
|
| -
|
| - private:
|
| - ByteSource* source_;
|
| - size_t limit_;
|
| -};
|
| -
|
| -} // namespace strings
|
| -} // namespace protobuf
|
| -} // namespace google
|
| -
|
| -#endif // GOOGLE_PROTOBUF_STUBS_BYTESTREAM_H_
|
|
|