public inbox for [email protected]  
help / color / mirror / Atom feed
From: David G. Johnston <[email protected]>
To: [email protected] <[email protected]>
Subject: Clarification of "void" type
Date: Wed, 15 Jun 2016 15:32:37 -0400
Message-ID: <CAKFQuwZky1t8YxvCidPJJjtE5yb8TR9W5-c0ZchQW21r=9OJZg@mail.gmail.com> (raw)
List-Unsubscribe: <mailto:[email protected]?body=unsub%20pgsql-docs>

The section on pseudo-types names "void" and describes is thusly:

"""
Indicates that a function returns no value.
"""

This can be reasonably interpreted to mean:  "Use this when you don't want
the execution of a function to return a value." (i.e., the empty set)

The following paragraph, suitably marked up, would be a nice addition:

If a function declares "RETURNS void" the result of executing the function
will be a single row and column whose type pg_typeof() returns "void".
Void is not null and typically displays textually as the empty string.

I'd maybe modify the table to read:

void : A value that has no content: used to indicate that a function
returns no value.

https://www.postgresql.org/docs/devel/static/datatype-pseudo.html

David J.


reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected]
  Subject: Re: Clarification of "void" type
  In-Reply-To: <CAKFQuwZky1t8YxvCidPJJjtE5yb8TR9W5-c0ZchQW21r=9OJZg@mail.gmail.com>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox