Branch data     Line data    Source code

       1                 :             : #include "mem.h"
       2                 :             : #include "mem_internal.h"
       3                 :             : 
       4                 :             : /**
       5                 :             :  * @brief Concatenate one data descriptor onto another through @ref mem_core_data
       6                 :             :  *
       7                 :             :  * This wrapper is the public append entry point for raw descriptor-to-descriptor
       8                 :             :  * transfers. Both descriptors must be in data mode. The actual transfer is
       9                 :             :  * delegated to @ref mem_core_data, so the payload is appended byte for byte,
      10                 :             :  * self-aliasing is supported, and only the destination element size controls
      11                 :             :  * whether the source payload size is acceptable
      12                 :             :  *
      13                 :             :  * @param destination Pointer to the destination descriptor in data mode
      14                 :             :  * @param source Pointer to the source descriptor in data mode
      15                 :             :  * @return `SUCCESS` on success; `FAILURE` otherwise
      16                 :             :  */
      17                 :          18 : Return mem_concat_data(
      18                 :             :         memory       *destination,
      19                 :             :         const memory *source)
      20                 :             : {
      21                 :          18 :         return(mem_core_data(TRANSFER_APPEND,destination,source));
      22                 :             : }