[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PATCH 2/4] qobject-input-visitor: Document full_name_nth()
From: |
Markus Armbruster |
Subject: |
[Qemu-devel] [PATCH 2/4] qobject-input-visitor: Document full_name_nth() |
Date: |
Thu, 27 Apr 2017 10:41:24 +0200 |
Signed-off-by: Markus Armbruster <address@hidden>
---
qapi/qobject-input-visitor.c | 11 +++++++++++
1 file changed, 11 insertions(+)
diff --git a/qapi/qobject-input-visitor.c b/qapi/qobject-input-visitor.c
index 865e948..2530959 100644
--- a/qapi/qobject-input-visitor.c
+++ b/qapi/qobject-input-visitor.c
@@ -55,6 +55,17 @@ static QObjectInputVisitor *to_qiv(Visitor *v)
return container_of(v, QObjectInputVisitor, visitor);
}
+/*
+ * Find the full name of something @qiv is currently visiting.
+ * @qiv is visiting something named @name in the stack of containers
+ * @qiv->stack.
+ * If @n is zero, return its full name.
+ * If @n is positive, return the full name of the @n-th container
+ * counting from the top. The stack of containers must have at least
+ * @n elements.
+ * The returned string is valid until the next full_name_nth(@v) or
+ * destruction of @v.
+ */
static const char *full_name_nth(QObjectInputVisitor *qiv, const char *name,
int n)
{
--
2.7.4
- [Qemu-devel] [PATCH 0/4] qapi: Loose ends, Markus Armbruster, 2017/04/27
- [Qemu-devel] [PATCH 2/4] qobject-input-visitor: Document full_name_nth(),
Markus Armbruster <=
- [Qemu-devel] [PATCH 3/4] qapi: Document intended use of @name within alternate visits, Markus Armbruster, 2017/04/27
- [Qemu-devel] [PATCH 4/4] qobject-input-visitor: Catch misuse of end_struct vs. end_list, Markus Armbruster, 2017/04/27
- Re: [Qemu-devel] [PATCH 4/4] qobject-input-visitor: Catch misuse of end_struct vs. end_list, Marc-André Lureau, 2017/04/27
- Re: [Qemu-devel] [PATCH 4/4] qobject-input-visitor: Catch misuse of end_struct vs. end_list, Markus Armbruster, 2017/04/27
- Re: [Qemu-devel] [PATCH 4/4] qobject-input-visitor: Catch misuse of end_struct vs. end_list, Marc-André Lureau, 2017/04/27
- Re: [Qemu-devel] [PATCH 4/4] qobject-input-visitor: Catch misuse of end_struct vs. end_list, Markus Armbruster, 2017/04/27
- Re: [Qemu-devel] [PATCH 4/4] qobject-input-visitor: Catch misuse of end_struct vs. end_list, Eric Blake, 2017/04/27
- Re: [Qemu-devel] [PATCH 4/4] qobject-input-visitor: Catch misuse of end_struct vs. end_list, Markus Armbruster, 2017/04/27