xref: /aosp_15_r20/external/curl/lib/bufref.h (revision 6236dae45794135f37c4eb022389c904c8b0090d)
1*6236dae4SAndroid Build Coastguard Worker #ifndef HEADER_CURL_BUFREF_H
2*6236dae4SAndroid Build Coastguard Worker #define HEADER_CURL_BUFREF_H
3*6236dae4SAndroid Build Coastguard Worker /***************************************************************************
4*6236dae4SAndroid Build Coastguard Worker  *                                  _   _ ____  _
5*6236dae4SAndroid Build Coastguard Worker  *  Project                     ___| | | |  _ \| |
6*6236dae4SAndroid Build Coastguard Worker  *                             / __| | | | |_) | |
7*6236dae4SAndroid Build Coastguard Worker  *                            | (__| |_| |  _ <| |___
8*6236dae4SAndroid Build Coastguard Worker  *                             \___|\___/|_| \_\_____|
9*6236dae4SAndroid Build Coastguard Worker  *
10*6236dae4SAndroid Build Coastguard Worker  * Copyright (C) Daniel Stenberg, <[email protected]>, et al.
11*6236dae4SAndroid Build Coastguard Worker  *
12*6236dae4SAndroid Build Coastguard Worker  * This software is licensed as described in the file COPYING, which
13*6236dae4SAndroid Build Coastguard Worker  * you should have received as part of this distribution. The terms
14*6236dae4SAndroid Build Coastguard Worker  * are also available at https://curl.se/docs/copyright.html.
15*6236dae4SAndroid Build Coastguard Worker  *
16*6236dae4SAndroid Build Coastguard Worker  * You may opt to use, copy, modify, merge, publish, distribute and/or sell
17*6236dae4SAndroid Build Coastguard Worker  * copies of the Software, and permit persons to whom the Software is
18*6236dae4SAndroid Build Coastguard Worker  * furnished to do so, under the terms of the COPYING file.
19*6236dae4SAndroid Build Coastguard Worker  *
20*6236dae4SAndroid Build Coastguard Worker  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
21*6236dae4SAndroid Build Coastguard Worker  * KIND, either express or implied.
22*6236dae4SAndroid Build Coastguard Worker  *
23*6236dae4SAndroid Build Coastguard Worker  * SPDX-License-Identifier: curl
24*6236dae4SAndroid Build Coastguard Worker  *
25*6236dae4SAndroid Build Coastguard Worker  ***************************************************************************/
26*6236dae4SAndroid Build Coastguard Worker 
27*6236dae4SAndroid Build Coastguard Worker /*
28*6236dae4SAndroid Build Coastguard Worker  * Generic buffer reference.
29*6236dae4SAndroid Build Coastguard Worker  */
30*6236dae4SAndroid Build Coastguard Worker struct bufref {
31*6236dae4SAndroid Build Coastguard Worker   void (*dtor)(void *);         /* Associated destructor. */
32*6236dae4SAndroid Build Coastguard Worker   const unsigned char *ptr;     /* Referenced data buffer. */
33*6236dae4SAndroid Build Coastguard Worker   size_t len;                   /* The data size in bytes. */
34*6236dae4SAndroid Build Coastguard Worker #ifdef DEBUGBUILD
35*6236dae4SAndroid Build Coastguard Worker   int signature;                /* Detect API use mistakes. */
36*6236dae4SAndroid Build Coastguard Worker #endif
37*6236dae4SAndroid Build Coastguard Worker };
38*6236dae4SAndroid Build Coastguard Worker 
39*6236dae4SAndroid Build Coastguard Worker 
40*6236dae4SAndroid Build Coastguard Worker void Curl_bufref_init(struct bufref *br);
41*6236dae4SAndroid Build Coastguard Worker void Curl_bufref_set(struct bufref *br, const void *ptr, size_t len,
42*6236dae4SAndroid Build Coastguard Worker                      void (*dtor)(void *));
43*6236dae4SAndroid Build Coastguard Worker const unsigned char *Curl_bufref_ptr(const struct bufref *br);
44*6236dae4SAndroid Build Coastguard Worker size_t Curl_bufref_len(const struct bufref *br);
45*6236dae4SAndroid Build Coastguard Worker CURLcode Curl_bufref_memdup(struct bufref *br, const void *ptr, size_t len);
46*6236dae4SAndroid Build Coastguard Worker void Curl_bufref_free(struct bufref *br);
47*6236dae4SAndroid Build Coastguard Worker 
48*6236dae4SAndroid Build Coastguard Worker #endif
49