012d4c96e2
See recent commit "error: Document Error API usage rules" for rationale. Signed-off-by: Markus Armbruster <armbru@redhat.com> Reviewed-by: Eric Blake <eblake@redhat.com> Reviewed-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> Message-Id: <20200707160613.848843-18-armbru@redhat.com>
52 lines
1.8 KiB
C
52 lines
1.8 KiB
C
/*
|
|
* Clone Visitor
|
|
*
|
|
* Copyright (C) 2016 Red Hat, Inc.
|
|
*
|
|
* This work is licensed under the terms of the GNU GPL, version 2 or later.
|
|
* See the COPYING file in the top-level directory.
|
|
*
|
|
*/
|
|
|
|
#ifndef QAPI_CLONE_VISITOR_H
|
|
#define QAPI_CLONE_VISITOR_H
|
|
|
|
#include "qapi/visitor.h"
|
|
|
|
/*
|
|
* The clone visitor is for direct use only by the QAPI_CLONE() macro;
|
|
* it requires that the root visit occur on an object, list, or
|
|
* alternate, and is not usable directly on built-in QAPI types.
|
|
*/
|
|
typedef struct QapiCloneVisitor QapiCloneVisitor;
|
|
|
|
void *qapi_clone(const void *src, bool (*visit_type)(Visitor *, const char *,
|
|
void **, Error **));
|
|
void qapi_clone_members(void *dst, const void *src, size_t sz,
|
|
bool (*visit_type_members)(Visitor *, void *,
|
|
Error **));
|
|
|
|
/*
|
|
* Deep-clone QAPI object @src of the given @type, and return the result.
|
|
*
|
|
* Not usable on QAPI scalars (integers, strings, enums), nor on a
|
|
* QAPI object that references the 'any' type. Safe when @src is NULL.
|
|
*/
|
|
#define QAPI_CLONE(type, src) \
|
|
((type *)qapi_clone(src, \
|
|
(bool (*)(Visitor *, const char *, void **, \
|
|
Error **))visit_type_ ## type))
|
|
|
|
/*
|
|
* Copy deep clones of @type members from @src to @dst.
|
|
*
|
|
* Not usable on QAPI scalars (integers, strings, enums), nor on a
|
|
* QAPI object that references the 'any' type.
|
|
*/
|
|
#define QAPI_CLONE_MEMBERS(type, dst, src) \
|
|
qapi_clone_members(dst, src, sizeof(type), \
|
|
(bool (*)(Visitor *, void *, \
|
|
Error **))visit_type_ ## type ## _members)
|
|
|
|
#endif
|