Not: Difference between revisions

From APL Wiki
Jump to navigation Jump to search
(→‎Extensions: Fix K extension (=, not ≠))
m (Text replacement - "<source" to "<syntaxhighlight")
Tags: Mobile edit Mobile web edit
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
{{Built-in|Not|~}} is a [[monadic]] [[scalar function]] that returns the [[wikipedia:Negation|logical negation]] of a [[Boolean]] argument—that is, 0 if the argument is 1 and 1 if it is 0. In some languages, such as [[J]], it is extended so that Not <source lang=apl inline>x</source> is equivalent to <source lang=apl inline>1-x</source> while in others, such as [[K]], it is extended so that Not <source lang=apl inline>x</source> is equivalent to <source lang=apl inline>0=x</source>.
{{Built-in|Not|~}} is a [[monadic]] [[scalar function]] that returns the [[wikipedia:Negation|logical negation]] of a [[Boolean]] argument—that is, 0 if the argument is 1 and 1 if it is 0. In some languages, such as [[J]], it is extended so that Not <syntaxhighlight lang=apl inline>x</syntaxhighlight> is equivalent to <syntaxhighlight lang=apl inline>1-x</syntaxhighlight> while in others, such as [[K]], it is extended so that Not <syntaxhighlight lang=apl inline>x</syntaxhighlight> is equivalent to <syntaxhighlight lang=apl inline>0=x</syntaxhighlight>.


== Examples ==
== Examples ==


<source lang=apl>
<syntaxhighlight lang=apl>
       ~ 0 1 1 0 1
       ~ 0 1 1 0 1
1 0 0 1 0
1 0 0 1 0
</source>
</syntaxhighlight>
Attempting to negate a non-[[Boolean]] argument usually results in a [[DOMAIN ERROR]]. In some languages it may instead [[subtract]] the argument from one.
Attempting to negate a non-[[Boolean]] argument usually results in a [[DOMAIN ERROR]]. In some languages it may instead [[subtract]] the argument from one.
<source lang=apl>
<syntaxhighlight lang=apl>
       ~ 0 0.5 1
       ~ 0 0.5 1
DOMAIN ERROR
DOMAIN ERROR
       ~0 0.5 1
       ~0 0.5 1
       ∧
       ∧
</source>
</syntaxhighlight>


== Properties ==
== Properties ==
Line 21: Line 21:
== History ==
== History ==


[[A Programming Language]] negates arrays using an overbar symbol like <math>\overline{p}</math>, matching a convention sometimes used in mathematics. In [[APL\360]] the current symbol <source lang=apl inline>~</source> was chosen, also due to its use in mathematics. Mathematical usage has arguably diverged from APL in this respect, as the negation of a variable <math>p</math> is now more often written <math>\neg p</math> when a prefix operator is desired.
[[A Programming Language]] negates arrays using an overbar symbol like <math>\overline{p}</math>, matching a convention sometimes used in mathematics. In [[APL\360]] the current symbol <syntaxhighlight lang=apl inline>~</syntaxhighlight> was chosen, also due to its use in mathematics. Mathematical usage has arguably diverged from APL in this respect, as the negation of a variable <math>p</math> is now more often written <math>\neg p</math> when a prefix operator is desired.


The arithmetic extension <source lang=apl inline>~x</source> {{←→}} <source lang=apl inline>1-x</source> was introduced to the array langauge family by [[J]]. For arguments in the interval <math>[0,1]</math> this extension may be seen as a probabilistic interpretation of negation.
The arithmetic extension <syntaxhighlight lang=apl inline>~x</syntaxhighlight> {{←→}} <syntaxhighlight lang=apl inline>1-x</syntaxhighlight> was introduced to the array langauge family by [[J]]. For arguments in the interval <math>[0,1]</math> this extension may be seen as a probabilistic interpretation of negation.


== Extensions ==
== Extensions ==
Line 32: Line 32:
| None                                || [[APL\360]], [[APL2]], [[APLX]], [[SHARP APL]], [[Dyalog APL]], [[GNU APL]], [[ngn/apl]], [[dzaima/APL]]
| None                                || [[APL\360]], [[APL2]], [[APLX]], [[SHARP APL]], [[Dyalog APL]], [[GNU APL]], [[ngn/apl]], [[dzaima/APL]]
|-
|-
| <source lang=apl inline>1-⍵</source> || [[J]], [[BQN]], [[Extended Dyalog APL]]
| <syntaxhighlight lang=apl inline>1-⍵</syntaxhighlight> || [[J]], [[BQN]], [[Extended Dyalog APL]]
|-
|-
| <source lang=apl inline>0=⍵</source> || [[K]]
| <syntaxhighlight lang=apl inline>0=⍵</syntaxhighlight> || [[K]]
|}
|}



Latest revision as of 22:18, 10 September 2022

~

Not (~) is a monadic scalar function that returns the logical negation of a Boolean argument—that is, 0 if the argument is 1 and 1 if it is 0. In some languages, such as J, it is extended so that Not x is equivalent to 1-x while in others, such as K, it is extended so that Not x is equivalent to 0=x.

Examples

      ~ 0 1 1 0 1
1 0 0 1 0

Attempting to negate a non-Boolean argument usually results in a DOMAIN ERROR. In some languages it may instead subtract the argument from one.

      ~ 0 0.5 1
DOMAIN ERROR
      ~0 0.5 1
      ∧

Properties

Not is the only Boolean function of a single argument which depends on that argument (it is not constant) and is not trivial (the same as Identity). Not is its own Inverse.

History

A Programming Language negates arrays using an overbar symbol like , matching a convention sometimes used in mathematics. In APL\360 the current symbol ~ was chosen, also due to its use in mathematics. Mathematical usage has arguably diverged from APL in this respect, as the negation of a variable is now more often written when a prefix operator is desired.

The arithmetic extension ~x 1-x was introduced to the array langauge family by J. For arguments in the interval this extension may be seen as a probabilistic interpretation of negation.

Extensions

Extension Languages
None APL\360, APL2, APLX, SHARP APL, Dyalog APL, GNU APL, ngn/apl, dzaima/APL
1-⍵ J, BQN, Extended Dyalog APL
0=⍵ K

See also

External links

Lessons

Documentation


APL built-ins [edit]
Primitives (Timeline) Functions
Scalar
Monadic ConjugateNegateSignumReciprocalMagnitudeExponentialNatural LogarithmFloorCeilingFactorialNotPi TimesRollTypeImaginarySquare Root
Dyadic AddSubtractTimesDivideResiduePowerLogarithmMinimumMaximumBinomialComparison functionsBoolean functions (And, Or, Nand, Nor) ∙ GCDLCMCircularComplexRoot
Non-Scalar
Structural ShapeReshapeTallyDepthRavelEnlistTableCatenateReverseRotateTransposeRazeMixSplitEncloseNestCut (K)PairLinkPartitioned EnclosePartition
Selection FirstPickTakeDropUniqueIdentityStopSelectReplicateExpandSet functions (IntersectionUnionWithout) ∙ Bracket indexingIndexCartesian ProductSort
Selector Index generatorGradeIndex OfInterval IndexIndicesDealPrefix and suffix vectors
Computational MatchNot MatchMembershipFindNub SieveEncodeDecodeMatrix InverseMatrix DivideFormatExecuteMaterialiseRange
Operators Monadic EachCommuteConstantReplicateExpandReduceWindowed ReduceScanOuter ProductKeyI-BeamSpawnFunction axis
Dyadic BindCompositions (Compose, Reverse Compose, Beside, Withe, Atop, Over) ∙ Inner ProductDeterminantPowerAtUnderRankDepthVariantStencilCutDirect definition (operator)
Quad names Index originComparison toleranceMigration levelAtomic vector