class Net::IMAP

def list(refname, mailbox)

++
TODO: support LIST-EXTENDED extension [RFC5258]. Needed for IMAP4rev2.
--

#]
#, \\
#=> [#, \\
p imap.list("", "foo/%")
imap.create("foo/baz")
imap.create("foo/bar")

===== For example:

Related: #lsub, MailboxList

The return value is an array of MailboxList.

name of +refname+ and the hierarchy delimiter are returned.
which mailboxes to match. If +mailbox+ is empty, the root
If +refname+ is empty, +mailbox+ is used directly to determine

characters *except* the hierarchy delimiter.
directory-based mailbox hierarchy); and "%", which matches all
*including* the hierarchy delimiter (for instance, "/" on a UNIX-hosted
may be used in +mailbox+: "*", which matches all characters
mailbox or (via wildcards) mailboxes under that context. Two wildcards
directory in a directory-based mailbox hierarchy). +mailbox+ specifies a
to the client. +refname+ provides a context (for instance, a base
and returns a subset of names from the complete set of all names available
Sends a {LIST command [IMAP4rev1 ยง6.3.8]}[https://www.rfc-editor.org/rfc/rfc3501#section-6.3.8]
def list(refname, mailbox)
  synchronize do
    send_command("LIST", refname, mailbox)
    clear_responses("LIST")
  end
end