slice.h

Go to the documentation of this file.

/*
 *
 * 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 GRPCPP_IMPL_CODEGEN_SLICE_H
#define GRPCPP_IMPL_CODEGEN_SLICE_H

#include <grpcpp/impl/codegen/config.h>
#include <grpcpp/impl/codegen/core_codegen_interface.h>
#include <grpcpp/impl/codegen/string_ref.h>

#include <grpc/impl/codegen/slice.h>

namespace grpc {

class Slice final {
 public:
  Slice();
  ~Slice();

  enum AddRef { ADD_REF };
  Slice(grpc_slice slice, AddRef);

  enum StealRef { STEAL_REF };
  Slice(grpc_slice slice, StealRef);

  Slice(size_t len);

  Slice(const void* buf, size_t len);

  Slice(const grpc::string& str);

  enum StaticSlice { STATIC_SLICE };

  Slice(const void* buf, size_t len, StaticSlice);

  Slice(const Slice& other);

  Slice& operator=(Slice other) {
    std::swap(slice_, other.slice_);
    return *this;
  }

  Slice(void* buf, size_t len, void (*destroy)(void*), void* user_data);

  Slice(void* buf, size_t len, void (*destroy)(void*))
      : Slice(buf, len, destroy, buf) {}

  Slice(void* buf, size_t len, void (*destroy)(void*, size_t));

  size_t size() const { return GRPC_SLICE_LENGTH(slice_); }

  const uint8_t* begin() const { return GRPC_SLICE_START_PTR(slice_); }

  const uint8_t* end() const { return GRPC_SLICE_END_PTR(slice_); }

  grpc_slice c_slice() const;

 private:
  friend class ByteBuffer;

  grpc_slice slice_;
};

inline grpc::string_ref StringRefFromSlice(const grpc_slice* slice) {
  return grpc::string_ref(
      reinterpret_cast<const char*>(GRPC_SLICE_START_PTR(*slice)),
      GRPC_SLICE_LENGTH(*slice));
}

inline grpc::string StringFromCopiedSlice(grpc_slice slice) {
  return grpc::string(reinterpret_cast<char*>(GRPC_SLICE_START_PTR(slice)),
                      GRPC_SLICE_LENGTH(slice));
}

inline grpc_slice SliceReferencingString(const grpc::string& str) {
  return g_core_codegen_interface->grpc_slice_from_static_buffer(str.data(),
                                                                 str.length());
}

inline grpc_slice SliceFromCopiedString(const grpc::string& str) {
  return g_core_codegen_interface->grpc_slice_from_copied_buffer(str.data(),
                                                                 str.length());
}

}  // namespace grpc

#endif  // GRPCPP_IMPL_CODEGEN_SLICE_H