Twice Shell

[ EDITING: pi_logipat.txt ]

*pi_logipat.txt*	Logical Patterns			May 01, 2019

Author:  Charles E. Campbell  <NcampObell@SdrPchip.AorgM-NOSPAM>
Copyright: (c) 2004-2016 by Charles E. Campbell	*logiPat-copyright*
           The VIM LICENSE applies to LogiPat.vim and LogiPat.txt
           (see |copyright|) except use "LogiPat" instead of "Vim"
	   No warranty, express or implied.  Use At-Your-Own-Risk.

==============================================================================
1. Contents					*logiPat* *logiPat-contents*

==============================================================================
2. LogiPat Manual			*logiPat-manual* *logiPat-man*

*logiPat-arg* *logiPat-input* *logiPat-pattern* *logiPat-operators*
	Boolean logic patterns are composed of

operators  ! = not
			           | = logical-or
			           & = logical-and
			grouping   ( ... )
			patterns   "pattern"

*logiPat-cmd*
	:LogiPat {boolean-logic pattern}		*:LogiPat*
		:LogiPat is a command which takes a boolean-logic
		argument (|logiPat-arg|).

:LP {boolean-logic pattern}			*:LP*
		:LP is a shorthand command version of :LogiPat
		(|logiPat-cmd|).

:LPE {boolean-logic pattern}			*:LPE*
		No search is done, but the conversion from the
		boolean logic pattern to the regular expression
		is performed and echoed onto the display.

:LogiPatFlags {search flags}			*LogiPat-flags*
		LogiPat uses the |search()| command.  The flags
		passed to that call to search() may be specified
		by the :LogiPatFlags command.

:LPF {search flags}				*:LPF*
		:LPF is a shorthand version of :LogiPatFlags.

:let pat=LogiPat({boolean-logic pattern})	*LogiPat()*
		If one calls LogiPat() directly, no search
		is done, but the transformation from the boolean
		logic pattern into a regular expression pattern
		is performed and returned.

To get a " inside a pattern, as opposed to having it delimit
	the pattern, double it.

==============================================================================
3. LogiPat Examples					*logiPat-examples*

LogiPat takes Boolean logic arguments and produces a regular
	expression which implements the choices.  A series of examples
	follows:
>
	:LogiPat "abc"
<		will search for lines containing the string  :abc:
>
	:LogiPat "ab""cd"
<		will search for lines containing the string  :ab"cd:
>
	:LogiPat !"abc"
<		will search for lines which don't contain the string  :abc:
>
	:LogiPat "abc"|"def"
<		will search for lines which contain either the string
		:abc:  or the string  :def:
>
	:LogiPat !("abc"|"def")
<		will search for lines which don't contain either
		of the strings  :abc:  or  :def:
>
	:LogiPat "abc"&"def"
<		will search for lines which contain both of the strings
		:abc:  and  :def:
>
	:let pat= LogiPat('!"abc"')
<		will return the regular expression which will match
		all lines not containing  :abc: .  The double quotes
		are needed to pass normal patterns to LogiPat, and
		differentiate such patterns from boolean logic
		operators.

==============================================================================
4. Caveat						*logiPat-caveat*

The "not" operator may be fragile; ie. it may not always play well
	with the & (logical-and) and | (logical-or) operators.  Please try out
	your patterns, possibly with :set hls, to insure that what is matching
	is what you want.

==============================================================================
5. LogiPat History					*logiPat-history*

v4 Jun 22, 2015 * LogiPat has been picked up by Bram M for standard
			  plugin distribution; hence the name change
	v3 Sep 25, 2006 * LP_Or() fixed; it now encapsulates its output
	                  in \%(...\) parentheses
	   Dec 12, 2011 * |:LPE| added
			* "" is mapped to a single " and left inside patterns
	v2 May 31, 2005	* LPF and LogiPatFlags commands weren't working
	v1 May 23, 2005	* initial release

==============================================================================
vim:tw=78:ts=8:noet:ft=help

[ CLOSE ]

Name	Size	Attr	Date	Action
[FILE] netbeans.txt	37.20 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] options.txt	456.68 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] os_390.txt	4.62 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] os_amiga.txt	5.63 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] os_beos.txt	292 B	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] os_dos.txt	15.33 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] os_haiku.txt	8.63 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] os_mac.txt	6.84 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] os_mint.txt	389 B	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] os_msdos.txt	521 B	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] os_os2.txt	295 B	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] os_qnx.txt	3.96 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] os_risc.txt	325 B	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] os_unix.txt	2.54 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] os_vms.txt	33.08 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] os_win32.txt	15.18 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] pattern.txt	64.10 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] pi_getscript.txt	22.03 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] pi_gzip.txt	1.53 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] pi_logipat.txt	4.10 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] pi_netrw.txt	144.16 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] pi_paren.txt	2.75 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] pi_spec.txt	4.03 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] pi_tar.txt	7.74 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] pi_tutor.txt	2.00 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] pi_vimball.txt	11.25 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] pi_zip.txt	8.66 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] popup.txt	48.17 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] print.txt	30.54 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] quickfix.txt	98.72 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] quickref.txt	72.81 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] quotes.txt	12.45 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] recover.txt	10.76 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] remote.txt	13.21 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] repeat.txt	57.76 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] rileft.txt	4.94 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] russian.txt	2.95 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] scroll.txt	14.12 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] sign.txt	26.99 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] spell.txt	63.09 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] sponsor.txt	2.54 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] starting.txt	77.03 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] syntax.txt	255.35 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] tabpage.txt	20.99 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] tags	408.33 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] tagsrch.txt	40.32 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] term.txt	55.07 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] terminal.txt	72.95 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] testing.txt	24.01 KB	---A	26-07-10 15:25	DL REN ATTR DEL
[FILE] textprop.txt	20.35 KB	---A	26-07-10 15:25	DL REN ATTR DEL

TWICE

[ EDITING: pi_logipat.txt ]