|
|
|
/*
|
|
|
|
*
|
|
|
|
* Copyright 2015 gRPC authors.
|
|
|
|
*
|
|
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
* you may not use this file except in compliance with the License.
|
|
|
|
* You may obtain a copy of the License at
|
|
|
|
*
|
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
*
|
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
* See the License for the specific language governing permissions and
|
|
|
|
* limitations under the License.
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef GRPCXX_SUPPORT_SLICE_H
|
|
|
|
#define GRPCXX_SUPPORT_SLICE_H
|
|
|
|
|
|
|
|
#include <grpc++/support/config.h>
|
|
|
|
#include <grpc/slice.h>
|
|
|
|
|
|
|
|
namespace grpc {
|
|
|
|
|
|
|
|
/// A wrapper around \a grpc_slice.
|
|
|
|
///
|
|
|
|
/// A slice represents a contiguous reference counted array of bytes.
|
|
|
|
/// It is cheap to take references to a slice, and it is cheap to create a
|
|
|
|
/// slice pointing to a subset of another slice.
|
|
|
|
class Slice final {
|
|
|
|
public:
|
|
|
|
/// Construct an empty slice.
|
|
|
|
Slice();
|
|
|
|
/// Destructor - drops one reference.
|
|
|
|
~Slice();
|
|
|
|
|
|
|
|
enum AddRef { ADD_REF };
|
|
|
|
/// Construct a slice from \a slice, adding a reference.
|
|
|
|
Slice(grpc_slice slice, AddRef);
|
|
|
|
|
|
|
|
enum StealRef { STEAL_REF };
|
|
|
|
/// Construct a slice from \a slice, stealing a reference.
|
|
|
|
Slice(grpc_slice slice, StealRef);
|
|
|
|
|
|
|
|
/// Copy constructor, adds a reference.
|
|
|
|
Slice(const Slice& other);
|
|
|
|
|
|
|
|
/// Assignment, reference count is unchanged.
|
|
|
|
Slice& operator=(Slice other) {
|
|
|
|
std::swap(slice_, other.slice_);
|
|
|
|
return *this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/// Byte size.
|
|
|
|
size_t size() const { return GRPC_SLICE_LENGTH(slice_); }
|
|
|
|
|
|
|
|
/// Raw pointer to the beginning (first element) of the slice.
|
|
|
|
const uint8_t* begin() const { return GRPC_SLICE_START_PTR(slice_); }
|
|
|
|
|
|
|
|
/// Raw pointer to the end (one byte \em past the last element) of the slice.
|
|
|
|
const uint8_t* end() const { return GRPC_SLICE_END_PTR(slice_); }
|
|
|
|
|
|
|
|
/// Raw C slice. Caller needs to call grpc_slice_unref when done.
|
|
|
|
grpc_slice c_slice() const { return grpc_slice_ref(slice_); }
|
|
|
|
|
|
|
|
private:
|
|
|
|
friend class ByteBuffer;
|
|
|
|
|
|
|
|
grpc_slice slice_;
|
|
|
|
};
|
|
|
|
|
|
|
|
} // namespace grpc
|
|
|
|
|
|
|
|
#endif // GRPCXX_SUPPORT_SLICE_H
|