{"id":808725,"url":"http://patchwork.ozlabs.org/api/patches/808725/?format=json","web_url":"http://patchwork.ozlabs.org/project/qemu-devel/patch/20170901153758.8628-4-armbru@redhat.com/","project":{"id":14,"url":"http://patchwork.ozlabs.org/api/projects/14/?format=json","name":"QEMU Development","link_name":"qemu-devel","list_id":"qemu-devel.nongnu.org","list_email":"qemu-devel@nongnu.org","web_url":"","scm_url":"","webscm_url":"","list_archive_url":"","list_archive_url_format":"","commit_url_format":""},"msgid":"<20170901153758.8628-4-armbru@redhat.com>","list_archive_url":null,"date":"2017-09-01T15:37:14","name":"[PULL,v2,03/47] qobject: Explain how QNum works, and why","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"bf079b9a845453168c19dcf2244e485f6e5b3781","submitter":{"id":2645,"url":"http://patchwork.ozlabs.org/api/people/2645/?format=json","name":"Markus Armbruster","email":"armbru@redhat.com"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/qemu-devel/patch/20170901153758.8628-4-armbru@redhat.com/mbox/","series":[{"id":1049,"url":"http://patchwork.ozlabs.org/api/series/1049/?format=json","web_url":"http://patchwork.ozlabs.org/project/qemu-devel/list/?series=1049","date":"2017-09-01T15:37:14","name":"[PULL,v2,01/47] qapi: Fix error handling code on alternate conflict","version":2,"mbox":"http://patchwork.ozlabs.org/series/1049/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/808725/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/808725/checks/","tags":{},"related":[],"headers":{"Return-Path":"","X-Original-To":"incoming@patchwork.ozlabs.org","Delivered-To":"patchwork-incoming@bilbo.ozlabs.org","Authentication-Results":["ozlabs.org;\n\tspf=pass (mailfrom) smtp.mailfrom=nongnu.org\n\t(client-ip=2001:4830:134:3::11; helo=lists.gnu.org;\n\tenvelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org;\n\treceiver=)","ext-mx07.extmail.prod.ext.phx2.redhat.com;\n\tdmarc=none (p=none dis=none) header.from=redhat.com","ext-mx07.extmail.prod.ext.phx2.redhat.com;\n\tspf=fail smtp.mailfrom=armbru@redhat.com"],"Received":["from lists.gnu.org (lists.gnu.org [IPv6:2001:4830:134:3::11])\n\t(using TLSv1 with cipher AES256-SHA (256/256 bits))\n\t(No client certificate requested)\n\tby ozlabs.org (Postfix) with ESMTPS id 3xkNh70lBjz9t3P\n\tfor ;\n\tSat, 2 Sep 2017 01:39:03 +1000 (AEST)","from localhost ([::1]:46298 helo=lists.gnu.org)\n\tby lists.gnu.org with esmtp (Exim 4.71) (envelope-from\n\t)\n\tid 1dno29-0006cS-5F\n\tfor incoming@patchwork.ozlabs.org; Fri, 01 Sep 2017 11:39:01 -0400","from eggs.gnu.org ([2001:4830:134:3::10]:51349)\n\tby lists.gnu.org with esmtp (Exim 4.71)\n\t(envelope-from ) id 1dno1E-0006Vb-63\n\tfor qemu-devel@nongnu.org; Fri, 01 Sep 2017 11:38:08 -0400","from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)\n\t(envelope-from ) id 1dno1B-0001at-2i\n\tfor qemu-devel@nongnu.org; Fri, 01 Sep 2017 11:38:04 -0400","from mx1.redhat.com ([209.132.183.28]:60150)\n\tby eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)\n\t(Exim 4.71) (envelope-from ) id 1dno1A-0001aU-Ta\n\tfor qemu-devel@nongnu.org; Fri, 01 Sep 2017 11:38:01 -0400","from smtp.corp.redhat.com\n\t(int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13])\n\t(using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits))\n\t(No client certificate requested)\n\tby mx1.redhat.com (Postfix) with ESMTPS id F3D3EC0467C4\n\tfor ; Fri, 1 Sep 2017 15:37:59 +0000 (UTC)","from blackfin.pond.sub.org (ovpn-116-75.ams2.redhat.com\n\t[10.36.116.75])\n\tby smtp.corp.redhat.com (Postfix) with ESMTPS id C32F27821A\n\tfor ; Fri, 1 Sep 2017 15:37:59 +0000 (UTC)","by blackfin.pond.sub.org (Postfix, from userid 1000)\n\tid 4B9C21138665; Fri, 1 Sep 2017 17:37:58 +0200 (CEST)"],"DMARC-Filter":"OpenDMARC Filter v1.3.2 mx1.redhat.com F3D3EC0467C4","From":"Markus Armbruster ","To":"qemu-devel@nongnu.org","Date":"Fri, 1 Sep 2017 17:37:14 +0200","Message-Id":"<20170901153758.8628-4-armbru@redhat.com>","In-Reply-To":"<20170901153758.8628-1-armbru@redhat.com>","References":"<20170901153758.8628-1-armbru@redhat.com>","MIME-Version":"1.0","Content-Type":"text/plain; charset=UTF-8","X-Scanned-By":"MIMEDefang 2.79 on 10.5.11.13","X-Greylist":"Sender IP whitelisted, not delayed by milter-greylist-4.5.16\n\t(mx1.redhat.com [10.5.110.31]);\n\tFri, 01 Sep 2017 15:38:00 +0000 (UTC)","Content-Transfer-Encoding":"quoted-printable","X-detected-operating-system":"by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]\n\t[fuzzy]","X-Received-From":"209.132.183.28","Subject":"[Qemu-devel] [PULL v2 03/47] qobject: Explain how QNum works,\n\tand why","X-BeenThere":"qemu-devel@nongnu.org","X-Mailman-Version":"2.1.21","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","Errors-To":"qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org","Sender":"\"Qemu-devel\"\n\t"},"content":"Suggested-by: Max Reitz \nSigned-off-by: Markus Armbruster \nMessage-Id: <1503384739-17207-1-git-send-email-armbru@redhat.com>\nReviewed-by: Marc-André Lureau \n[Comment typos fixed]\n---\n include/qapi/qmp/qnum.h | 21 +++++++++++++++++++++\n 1 file changed, 21 insertions(+)","diff":"diff --git a/include/qapi/qmp/qnum.h b/include/qapi/qmp/qnum.h\nindex 09d745c490..d6b0791139 100644\n--- a/include/qapi/qmp/qnum.h\n+++ b/include/qapi/qmp/qnum.h\n@@ -23,6 +23,27 @@ typedef enum {\n QNUM_DOUBLE\n } QNumKind;\n \n+/*\n+ * QNum encapsulates how our dialect of JSON fills in the blanks left\n+ * by the JSON specification (RFC 7159) regarding numbers.\n+ *\n+ * Conceptually, we treat number as an abstract type with three\n+ * concrete subtypes: floating-point, signed integer, unsigned\n+ * integer. QNum implements this as a discriminated union of double,\n+ * int64_t, uint64_t.\n+ *\n+ * The JSON parser picks the subtype as follows. If the number has a\n+ * decimal point or an exponent, it is floating-point. Else if it\n+ * fits into int64_t, it's signed integer. Else if it fits into\n+ * uint64_t, it's unsigned integer. Else it's floating-point.\n+ *\n+ * Any number can serve as double: qnum_get_double() converts under\n+ * the hood.\n+ *\n+ * An integer can serve as signed / unsigned integer as long as it is\n+ * in range: qnum_get_try_int() / qnum_get_try_uint() check range and\n+ * convert under the hood.\n+ */\n typedef struct QNum {\n QObject base;\n QNumKind kind;\n","prefixes":["PULL","v2","03/47"]}