#include <grpc/support/port_platform.h>#include <grpc/impl/codegen/slice.h>#include <grpc/support/sync.h>
Go to the source code of this file.
Macros | |
| #define | GRPC_SLICE_MALLOC(len) grpc_slice_malloc(len) |
Enumerations | |
| enum | grpc_slice_ref_whom { GRPC_SLICE_REF_TAIL = 1, GRPC_SLICE_REF_HEAD = 2, GRPC_SLICE_REF_BOTH = 1 + 2 } |
Macro Definition Documentation
◆ GRPC_SLICE_MALLOC
| #define GRPC_SLICE_MALLOC | ( | len | ) | grpc_slice_malloc(len) |
Definition at line 70 of file include/grpc/slice.h.
Enumeration Type Documentation
◆ grpc_slice_ref_whom
| enum grpc_slice_ref_whom |
| Enumerator | |
|---|---|
| GRPC_SLICE_REF_TAIL | |
| GRPC_SLICE_REF_HEAD | |
| GRPC_SLICE_REF_BOTH | |
Definition at line 107 of file include/grpc/slice.h.
Function Documentation
◆ grpc_empty_slice()
| GPRAPI grpc_slice grpc_empty_slice | ( | void | ) |
Definition at line 42 of file slice/slice.cc.
◆ grpc_slice_buf_start_eq()
| GPRAPI int grpc_slice_buf_start_eq | ( | grpc_slice | a, |
| const void * | b, | ||
| size_t | blen | ||
| ) |
return non-zero if the first blen bytes of a are equal to b
Definition at line 441 of file slice/slice.cc.
◆ grpc_slice_chr()
| GPRAPI int grpc_slice_chr | ( | grpc_slice | s, |
| char | c | ||
| ) |
Definition at line 455 of file slice/slice.cc.
◆ grpc_slice_cmp()
| GPRAPI int grpc_slice_cmp | ( | grpc_slice | a, |
| grpc_slice | b | ||
| ) |
Returns <0 if a < b, ==0 if a == b, >0 if a > b The order is arbitrary, and is not guaranteed to be stable across different versions of the API.
Definition at line 419 of file slice/slice.cc.
◆ grpc_slice_copy()
| GPRAPI grpc_slice grpc_slice_copy | ( | grpc_slice | s | ) |
Copy slice - create a new slice that contains the same data as s
Definition at line 46 of file slice/slice.cc.
◆ grpc_slice_dup()
| GPRAPI grpc_slice grpc_slice_dup | ( | grpc_slice | a | ) |
Return a slice pointing to newly allocated memory that has the same contents as s
Definition at line 485 of file slice/slice.cc.
◆ grpc_slice_eq()
| GPRAPI int grpc_slice_eq | ( | grpc_slice | a, |
| grpc_slice | b | ||
| ) |
Definition at line 387 of file slice/slice.cc.
◆ grpc_slice_from_copied_buffer()
| GPRAPI grpc_slice grpc_slice_from_copied_buffer | ( | const char * | source, |
| size_t | len | ||
| ) |
Create a slice by copying a buffer. Equivalent to: grpc_slice slice = grpc_slice_malloc(len); memcpy(slice->data, source, len);
Definition at line 170 of file slice/slice.cc.
◆ grpc_slice_from_copied_string()
| GPRAPI grpc_slice grpc_slice_from_copied_string | ( | const char * | source | ) |
Create a slice by copying a string. Does not preserve null terminators. Equivalent to: size_t len = strlen(source); grpc_slice slice = grpc_slice_malloc(len); memcpy(slice->data, source, len);
Definition at line 177 of file slice/slice.cc.
◆ grpc_slice_from_static_buffer()
| GPRAPI grpc_slice grpc_slice_from_static_buffer | ( | const void * | source, |
| size_t | len | ||
| ) |
Create a slice pointing to constant memory
Definition at line 85 of file slice/slice.cc.
◆ grpc_slice_from_static_string()
| GPRAPI grpc_slice grpc_slice_from_static_string | ( | const char * | source | ) |
Create a slice pointing to constant memory
Definition at line 89 of file slice/slice.cc.
◆ grpc_slice_is_equivalent()
| GPRAPI int grpc_slice_is_equivalent | ( | grpc_slice | a, |
| grpc_slice | b | ||
| ) |
Do two slices point at the same memory, with the same length If a or b is inlined, actually compares data
Definition at line 433 of file slice/slice.cc.
◆ grpc_slice_malloc()
| GPRAPI grpc_slice grpc_slice_malloc | ( | size_t | length | ) |
Equivalent to grpc_slice_new(malloc(len), len, free), but saves one malloc() call. Aborts if malloc() fails.
Definition at line 227 of file slice/slice.cc.
◆ grpc_slice_malloc_large()
| GPRAPI grpc_slice grpc_slice_malloc_large | ( | size_t | length | ) |
Definition at line 217 of file slice/slice.cc.
◆ grpc_slice_new()
| GPRAPI grpc_slice grpc_slice_new | ( | void * | p, |
| size_t | len, | ||
| void(*)(void *) | destroy | ||
| ) |
Create a slice pointing at some data. Calls malloc to allocate a refcount for the object, and arranges that destroy will be called with the pointer passed in at destruction.
Definition at line 103 of file slice/slice.cc.
◆ grpc_slice_new_with_len()
| GPRAPI grpc_slice grpc_slice_new_with_len | ( | void * | p, |
| size_t | len, | ||
| void(*)(void *, size_t) | destroy | ||
| ) |
Equivalent to grpc_slice_new, but with a two argument destroy function that also takes the slice length.
Definition at line 161 of file slice/slice.cc.
◆ grpc_slice_new_with_user_data()
| GPRAPI grpc_slice grpc_slice_new_with_user_data | ( | void * | p, |
| size_t | len, | ||
| void(*)(void *) | destroy, | ||
| void * | user_data | ||
| ) |
Equivalent to grpc_slice_new, but with a separate pointer that is passed to the destroy function. This function can be useful when the data is part of a larger structure that must be destroyed when the data is no longer needed.
Definition at line 93 of file slice/slice.cc.
◆ grpc_slice_rchr()
| GPRAPI int grpc_slice_rchr | ( | grpc_slice | s, |
| char | c | ||
| ) |
return the index of the last instance of c in s, or -1 if not found
Definition at line 446 of file slice/slice.cc.
◆ grpc_slice_ref()
| GPRAPI grpc_slice grpc_slice_ref | ( | grpc_slice | s | ) |
Increment the refcount of s. Requires slice is initialized. Returns s.
Definition at line 27 of file slice_api.cc.
◆ grpc_slice_slice()
| GPRAPI int grpc_slice_slice | ( | grpc_slice | haystack, |
| grpc_slice | needle | ||
| ) |
return the index of the first occurrence of needle in haystack, or -1 if it's not found
Definition at line 461 of file slice/slice.cc.
◆ grpc_slice_split_head()
| GPRAPI grpc_slice grpc_slice_split_head | ( | grpc_slice * | s, |
| size_t | split | ||
| ) |
Splits s into two: modifies s to be s[split:s.length], and returns a new slice, sharing a refcount with s, that contains s[0:split]. Requires s initialized, split <= s.length
Definition at line 347 of file slice/slice.cc.
◆ grpc_slice_split_tail()
| GPRAPI grpc_slice grpc_slice_split_tail | ( | grpc_slice * | s, |
| size_t | split | ||
| ) |
Splits s into two: modifies s to be s[0:split], and returns a new slice, sharing a refcount with s, that contains s[split:s.length]. Requires s initialized, split <= s.length
Definition at line 343 of file slice/slice.cc.
◆ grpc_slice_split_tail_maybe_ref()
| GPRAPI grpc_slice grpc_slice_split_tail_maybe_ref | ( | grpc_slice * | s, |
| size_t | split, | ||
| grpc_slice_ref_whom | ref_whom | ||
| ) |
The same as grpc_slice_split_tail, but with an option to skip altering refcounts (grpc_slice_split_tail_maybe_ref(..., true) is equivalent to grpc_slice_split_tail(...))
Definition at line 286 of file slice/slice.cc.
◆ grpc_slice_str_cmp()
| GPRAPI int grpc_slice_str_cmp | ( | grpc_slice | a, |
| const char * | b | ||
| ) |
Definition at line 426 of file slice/slice.cc.
◆ grpc_slice_sub()
| GPRAPI grpc_slice grpc_slice_sub | ( | grpc_slice | s, |
| size_t | begin, | ||
| size_t | end | ||
| ) |
Return a result slice derived from s, which shares a ref count with s, where result.data==s.data+begin, and result.length==end-begin. The ref count of s is increased by one. Do not assign result back to s. Requires s initialized, begin <= end, begin <= s.length, and end <= source->length.
Definition at line 268 of file slice/slice.cc.
◆ grpc_slice_sub_no_ref()
| GPRAPI grpc_slice grpc_slice_sub_no_ref | ( | grpc_slice | s, |
| size_t | begin, | ||
| size_t | end | ||
| ) |
The same as grpc_slice_sub, but without altering the ref count
Definition at line 264 of file slice/slice.cc.
◆ grpc_slice_to_c_string()
| GPRAPI char* grpc_slice_to_c_string | ( | grpc_slice | s | ) |
Return a copy of slice as a C string. Offers no protection against embedded NULL's. Returned string must be freed with gpr_free.
Definition at line 35 of file slice/slice.cc.
◆ grpc_slice_unref()
| GPRAPI void grpc_slice_unref | ( | grpc_slice | s | ) |
Decrement the ref count of s. If the ref count of s reaches zero, all slices sharing the ref count are destroyed, and considered no longer initialized. If s is ultimately derived from a call to grpc_slice_new(start, len, dest) where dest!=NULL , then (*dest)(start) is called, else if s is ultimately derived from a call to grpc_slice_new_with_len(start, len, dest) where dest!=NULL , then (*dest)(start, len). Requires s initialized.
Definition at line 32 of file slice_api.cc.