mathlib documentation


Nontrivial types #

THIS FILE IS SYNCHRONIZED WITH MATHLIB4. Any changes to this file require a corresponding PR to mathlib4.

A type is nontrivial if it contains at least two elements. This is useful in particular for rings (where it is equivalent to the fact that zero is different from one) and for vector spaces (where it is equivalent to the fact that the dimension is positive).

We introduce a typeclass nontrivial formalizing this property.

structure nontrivial (α : Type u_3) :
  • exists_pair_ne : (x y : α), x y

Predicate typeclass for expressing that a type is not reduced to a single element. In rings, this is equivalent to 0 ≠ 1. In vector spaces, this is equivalent to positive dimension.

Instances of this typeclass
theorem nontrivial_iff {α : Type u_1} :
nontrivial α (x y : α), x y
theorem exists_pair_ne (α : Type u_1) [nontrivial α] :
(x y : α), x y
theorem decidable.exists_ne {α : Type u_1} [nontrivial α] [decidable_eq α] (x : α) :
(y : α), y x
theorem exists_ne {α : Type u_1} [nontrivial α] (x : α) :
(y : α), y x
theorem nontrivial_of_ne {α : Type u_1} (x y : α) (h : x y) :
theorem nontrivial_of_lt {α : Type u_1} [preorder α] (x y : α) (h : x < y) :
theorem exists_pair_lt (α : Type u_1) [nontrivial α] [linear_order α] :
(x y : α), x < y
theorem nontrivial_iff_lt {α : Type u_1} [linear_order α] :
nontrivial α (x y : α), x < y
theorem nontrivial_iff_exists_ne {α : Type u_1} (x : α) :
nontrivial α (y : α), y x
theorem subtype.nontrivial_iff_exists_ne {α : Type u_1} (p : α Prop) (x : subtype p) :
nontrivial (subtype p) (y : α) (hy : p y), y x
@[protected, instance]
@[protected, instance]
def nontrivial.to_nonempty {α : Type u_1} [nontrivial α] :

See Note [lower instance priority]

Note that since this and nonempty_of_inhabited are the most "obvious" way to find a nonempty instance if no direct instance can be found, we give this a higher priority than the usual 100.

noncomputable def nontrivial_psum_unique (α : Type u_1) [inhabited α] :

An inhabited type is either nontrivial, or has a unique element.

theorem subsingleton_iff {α : Type u_1} :
subsingleton α (x y : α), x = y
theorem not_nontrivial (α : Type u_1) [subsingleton α] :
theorem not_subsingleton (α : Type u_1) [h : nontrivial α] :

A type is either a subsingleton or nontrivial.

@[protected, instance]
def option.nontrivial {α : Type u_1} [nonempty α] :
theorem function.injective.nontrivial {α : Type u_1} {β : Type u_2} [nontrivial α] {f : α β} (hf : function.injective f) :

Pushforward a nontrivial instance along an injective function.

theorem function.surjective.nontrivial {α : Type u_1} {β : Type u_2} [nontrivial β] {f : α β} (hf : function.surjective f) :

Pullback a nontrivial instance along a surjective function.

theorem function.injective.exists_ne {α : Type u_1} {β : Type u_2} [nontrivial α] {f : α β} (hf : function.injective f) (y : β) :
(x : α), f x y

An injective function from a nontrivial type has an argument at which it does not take a given value.

@[protected, instance]
def nontrivial_prod_right {α : Type u_1} {β : Type u_2} [nonempty α] [nontrivial β] :
nontrivial × β)
@[protected, instance]
def nontrivial_prod_left {α : Type u_1} {β : Type u_2} [nontrivial α] [nonempty β] :
nontrivial × β)
theorem pi.nontrivial_at {I : Type u_3} {f : I Type u_4} (i' : I) [inst : (i : I), nonempty (f i)] [nontrivial (f i')] :
nontrivial (Π (i : I), f i)

A pi type is nontrivial if it's nonempty everywhere and nontrivial somewhere.

@[protected, instance]
def pi.nontrivial {I : Type u_3} {f : I Type u_4} [inhabited I] [inst : (i : I), nonempty (f i)] [nontrivial (f inhabited.default)] :
nontrivial (Π (i : I), f i)

As a convenience, provide an instance automatically if (f default) is nontrivial.

If a different index has the non-trivial type, then use haveI := nontrivial_at that_index.

@[protected, instance]
def function.nontrivial {α : Type u_1} {β : Type u_2} [h : nonempty α] [nontrivial β] :
nontrivial β)

Simp lemmas for nontriviality tactic

theorem subsingleton.le {α : Type u_1} [preorder α] [subsingleton α] (x y : α) :
x y
@[protected, instance]