mirror of https://github.com/grpc/grpc.git
The C based gRPC (C++, Python, Ruby, Objective-C, PHP, C#)
https://grpc.io/
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
76 lines
2.1 KiB
76 lines
2.1 KiB
/* |
|
* |
|
* 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
|
|
|