GRPC Core  43.0.0
Data Structures | Macros | Typedefs
slice_type.h File Reference
#include <stddef.h>
#include <grpc/support/port_platform.h>

Go to the source code of this file.

Data Structures

struct  grpc_slice
 A grpc_slice s, if initialized, represents the byte range s.bytes[0..s.length-1]. More...
 
union  grpc_slice::grpc_slice_data
 
struct  grpc_slice::grpc_slice_data::grpc_slice_refcounted
 
struct  grpc_slice::grpc_slice_data::grpc_slice_inlined
 
struct  grpc_slice_buffer
 Represents an expandable array of slices, to be interpreted as a single item. More...
 

Macros

#define GRPC_SLICE_INLINE_EXTRA_SIZE   sizeof(void*)
 Slice API. More...
 
#define GRPC_SLICE_INLINED_SIZE   (sizeof(size_t) + sizeof(uint8_t*) - 1 + GRPC_SLICE_INLINE_EXTRA_SIZE)
 
#define GRPC_SLICE_BUFFER_INLINE_ELEMENTS   6
 
#define GRPC_SLICE_START_PTR(slice)
 
#define GRPC_SLICE_LENGTH(slice)
 
#define GRPC_SLICE_SET_LENGTH(slice, newlen)
 
#define GRPC_SLICE_END_PTR(slice)   GRPC_SLICE_START_PTR(slice) + GRPC_SLICE_LENGTH(slice)
 
#define GRPC_SLICE_IS_EMPTY(slice)   (GRPC_SLICE_LENGTH(slice) == 0)
 

Typedefs

typedef struct grpc_slice grpc_slice
 
typedef struct grpc_slice_buffer grpc_slice_buffer
 Represents an expandable array of slices, to be interpreted as a single item. More...
 

Macro Definition Documentation

◆ GRPC_SLICE_BUFFER_INLINE_ELEMENTS

#define GRPC_SLICE_BUFFER_INLINE_ELEMENTS   6

◆ GRPC_SLICE_END_PTR

#define GRPC_SLICE_END_PTR (   slice)    GRPC_SLICE_START_PTR(slice) + GRPC_SLICE_LENGTH(slice)

◆ GRPC_SLICE_INLINE_EXTRA_SIZE

#define GRPC_SLICE_INLINE_EXTRA_SIZE   sizeof(void*)

Slice API.

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.

The data-structure for slices is exposed here to allow non-gpr code to build slices from whatever data they have available.

When defining interfaces that handle slices, care should be taken to define reference ownership semantics (who should call unref?) and mutability constraints (is the callee allowed to modify the slice?)

◆ GRPC_SLICE_INLINED_SIZE

#define GRPC_SLICE_INLINED_SIZE   (sizeof(size_t) + sizeof(uint8_t*) - 1 + GRPC_SLICE_INLINE_EXTRA_SIZE)

◆ GRPC_SLICE_IS_EMPTY

#define GRPC_SLICE_IS_EMPTY (   slice)    (GRPC_SLICE_LENGTH(slice) == 0)

◆ GRPC_SLICE_LENGTH

#define GRPC_SLICE_LENGTH (   slice)
Value:
((slice).refcount ? (slice).data.refcounted.length \
: (slice).data.inlined.length)

◆ GRPC_SLICE_SET_LENGTH

#define GRPC_SLICE_SET_LENGTH (   slice,
  newlen 
)
Value:
((slice).refcount ? ((slice).data.refcounted.length = (size_t)(newlen)) \
: ((slice).data.inlined.length = (uint8_t)(newlen)))

◆ GRPC_SLICE_START_PTR

#define GRPC_SLICE_START_PTR (   slice)
Value:
((slice).refcount ? (slice).data.refcounted.bytes \
: (slice).data.inlined.bytes)

Typedef Documentation

◆ grpc_slice

typedef struct grpc_slice grpc_slice

◆ grpc_slice_buffer

Represents an expandable array of slices, to be interpreted as a single item.