include/afb/afb-req-v1.h

   1 /*
   2  * Copyright (C) 2015-2020 "IoT.bzh"
   3  * Author: José Bollo <jose.bollo@iot.bzh>
   4  *
   5  * Licensed under the Apache License, Version 2.0 (the "License");
   6  * you may not use this file except in compliance with the License.
   7  * You may obtain a copy of the License at
   8  *
   9  *   http://www.apache.org/licenses/LICENSE-2.0
  10  *
  11  * Unless required by applicable law or agreed to in writing, software
  12  * distributed under the License is distributed on an "AS IS" BASIS,
  13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14  * See the License for the specific language governing permissions and
  15  * limitations under the License.
  16  */
  17
  18 #pragma once
  19
  20 #include <stdlib.h>
  21 #include "afb-req-x1.h"
  22
  23 /** @addtogroup AFB_REQ
  24  *  @{ */
  25
  26 /**
  27  * @deprecated use bindings version 3
  28  *
  29  * Stores 'req' on heap for asynchrnous use.
  30  * Returns a pointer to the stored 'req' or NULL on memory depletion.
  31  * The count of reference to 'req' is incremented on success
  32  * (see afb_req_addref).
  33  */
  34 static inline struct afb_req_x1 *afb_req_x1_store_v1(struct afb_req_x1 req)
  35 {
  36         struct afb_req_x1 *result = (struct afb_req_x1*)malloc(sizeof *result);
  37         if (result) {
  38                 *result = req;
  39                 afb_req_x1_addref(req);
  40         }
  41         return result;
  42 }
  43
  44 /**
  45  * @deprecated use bindings version 3
  46  *
  47  * Retrieves the afb_req stored at 'req' and frees the memory.
  48  * Returns the stored request.
  49  * The count of reference is UNCHANGED, thus, normally, the
  50  * function 'afb_req_unref' should be called on the result
  51  * after that the asynchronous reply if sent.
  52  */
  53 static inline struct afb_req_x1 afb_req_unstore_x1_v1(struct afb_req_x1 *req)
  54 {
  55         struct afb_req_x1 result = *req;
  56         free(req);
  57         return result;
  58 }
  59
  60
  61 /** @} */