From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail
From: Jean Louis <bugs@gnu.support>
Newsgroups: gmane.emacs.help
Subject: Useful function `completing-read-multiple'
Date: Sat, 12 Jun 2021 20:05:31 +0300
Message-ID: <courier.0000000060C4E96A.00000CFA@stw1.rcdrun.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214";
	logging-data="37616"; mail-complaints-to="usenet@ciao.gmane.io"
To: Help GNU Emacs <help-gnu-emacs@gnu.org>
Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Sat Jun 12 19:06:42 2021
Return-path: <help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org>
Envelope-to: geh-help-gnu-emacs@m.gmane-mx.org
Original-Received: from lists.gnu.org ([209.51.188.17])
	by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org>)
	id 1ls75m-0009ia-G5
	for geh-help-gnu-emacs@m.gmane-mx.org; Sat, 12 Jun 2021 19:06:42 +0200
Original-Received: from localhost ([::1]:52328 helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org>)
	id 1ls75l-0000IY-I3
	for geh-help-gnu-emacs@m.gmane-mx.org; Sat, 12 Jun 2021 13:06:41 -0400
Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:37820)
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <support1@rcdrun.com>)
 id 1ls75S-0000I5-AG
 for help-gnu-emacs@gnu.org; Sat, 12 Jun 2021 13:06:22 -0400
Original-Received: from stw1.rcdrun.com ([217.170.207.13]:34421)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <support1@rcdrun.com>)
 id 1ls75Q-0003J2-MU
 for help-gnu-emacs@gnu.org; Sat, 12 Jun 2021 13:06:21 -0400
Original-Received: from localhost ([::ffff:197.157.0.23])
 (AUTH: PLAIN admin, TLS: TLS1.3,256bits,ECDHE_RSA_AES_256_GCM_SHA384)
 by stw1.rcdrun.com with ESMTPSA
 id 00000000000D59E6.0000000060C4E96A.00000CFA; Sat, 12 Jun 2021 10:05:46 -0700
Received-SPF: pass client-ip=217.170.207.13; envelope-from=support1@rcdrun.com;
 helo=stw1.rcdrun.com
X-Spam_score_int: 12
X-Spam_score: 1.2
X-Spam_bar: +
X-Spam_report: (1.2 / 5.0 requ) BAYES_05=-0.5,
 HEADER_FROM_DIFFERENT_DOMAINS=0.248, RCVD_IN_SORBS_WEB=1.5,
 SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no
X-Spam_action: no action
X-BeenThere: help-gnu-emacs@gnu.org
X-Mailman-Version: 2.1.23
Precedence: list
List-Id: Users list for the GNU Emacs text editor <help-gnu-emacs.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/help-gnu-emacs>,
 <mailto:help-gnu-emacs-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/help-gnu-emacs>
List-Post: <mailto:help-gnu-emacs@gnu.org>
List-Help: <mailto:help-gnu-emacs-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/help-gnu-emacs>,
 <mailto:help-gnu-emacs-request@gnu.org?subject=subscribe>
Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org
Original-Sender: "help-gnu-emacs"
 <help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org>
Xref: news.gmane.io gmane.emacs.help:130780
Archived-At: <http://permalink.gmane.org/gmane.emacs.help/130780>


Here is one good way to make multiple selections, very handy to
select for example multiple tags, so to tag objects, files, etc.

(let* ((collection '("emacs" "emacs-lisp" "visual"))
       (crm-separator "[ 	]*,[ 	]*" )
       (tags (completing-read-multiple "Tags: " collection nil t)))
  tags) ⇒ ("emacs" "visual")

The `completing-read-multiple' allows user to write multiple tags
or multiple selections separated in this case by comma. Beware,
there is invisible tab in the variable `crm-separator'.