include/afb/afb-req-v1.h

   1 /*
   2  * Copyright (C) 2016, 2017 "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-common.h"
  22
  23 /*
  24  * Stores 'req' on heap for asynchrnous use.
  25  * Returns a pointer to the stored 'req' or NULL on memory depletion.
  26  * The count of reference to 'req' is incremented on success
  27  * (see afb_req_addref).
  28  */
  29 static inline struct afb_req *afb_req_store_v1(struct afb_req req)
  30 {
  31         struct afb_req *result = (struct afb_req*)malloc(sizeof *result);
  32         if (result) {
  33                 *result = req;
  34                 afb_req_addref(req);
  35         }
  36         return result;
  37 }
  38
  39 /*
  40  * Retrieves the afb_req stored at 'req' and frees the memory.
  41  * Returns the stored request.
  42  * The count of reference is UNCHANGED, thus, normally, the
  43  * function 'afb_req_unref' should be called on the result
  44  * after that the asynchronous reply if sent.
  45  */
  46 static inline struct afb_req afb_req_unstore_v1(struct afb_req *req)
  47 {
  48         struct afb_req result = *req;
  49         free(req);
  50         return result;
  51 }
  52