---
title: "Introduction to Rings"
canonical: "https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/index-introduction-to-rings.html"
source: "https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/index-introduction-to-rings.md"
part: "Basic Rings"
chapter: "Introduction to Rings"
breadcrumbs:
  - {"title": "Magma Handbook", "source": "https://docs.magma-maths.org/v2.30-1/index.md"}
  - {"title": "Basic Rings", "source": "https://docs.magma-maths.org/v2.30-1/BasicRings/index-basic-rings.md"}
prev: {"title": "Basic Rings", "source": "https://docs.magma-maths.org/v2.30-1/BasicRings/index-basic-rings.md"}
next: {"title": "Overview", "source": "https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/overview.md"}
---

<a id="detail"></a>
<a id="rngintro"></a>
# Introduction to Rings

- [Overview](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/overview.md)
- [The World of Rings](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/world.md)
  - [New Rings from Existing Ones](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/world.md#new-rings-from-existing-ones)
- [Coercion](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/coercion.md)
  - [Automatic Coercion](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/coercion.md#automatic-coercion)
  - [Forced Coercion](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/coercion.md#forced-coercion)
- [Generic Ring Functions](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md)
  - [Related Structures](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#related-structures)
    - [`Parent(R): Rng → Pow`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-parent-rng)
    - [`Category(R): Rng → Cat`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-category-rng)
    - [`Type(R): Rng → Cat`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-type-rng)
    - [`PrimeField(F): Fld → Fld`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-primefield-fld)
    - [`PrimeRing(R): Rng → Rng`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-primering-rng)
    - [`Centre(R): Rng → Rng`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-centre-rng)
    - [`Center(R): Rng → Rng`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-center-rng)
  - [Numerical Invariants](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#numerical-invariants)
    - [`Characteristic(R): Rng → RngIntElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-characteristic-rng)
    - [`# R: Rng → RngIntElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#operation-operation-rng-rngintelt)
  - [Predicates and Boolean Operations](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#predicates-and-boolean-operations)
    - [`IsCommutative(R): Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-iscommutative-rng)
    - [`IsUnitary(R): Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-isunitary-rng)
    - [`IsFinite(R): Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-isfinite-rng)
    - [`IsOrdered(R): Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-isordered-rng)
    - [`IsField(R): Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-isfield-rng)
    - [`IsDivisionRing(R): Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-isdivisionring-rng)
    - [`IsEuclideanDomain(R): Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-iseuclideandomain-rng)
    - [`IsEuclideanRing(R): Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-iseuclideanring-rng)
    - [`IsMagmaEuclideanRing(R): Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-ismagmaeuclideanring-rng)
    - [`IsPID(R): Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-ispid-rng)
    - [`IsPrincipalIdealDomain(R): Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-isprincipalidealdomain-rng)
    - [`IsPIR(R): Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-ispir-rng)
    - [`IsPrincipalIdealRing(R): Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-isprincipalidealring-rng)
    - [`IsUFD(R): Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-isufd-rng)
    - [`IsUniqueFactorizationDomain(R): Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-isuniquefactorizationdomain-rng)
    - [`IsDomain(R): Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-isdomain-rng)
    - [`IsIntegralDomain(R): Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-isintegraldomain-rng)
    - [`HasGCD(R): Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#function-hasgcd-rng)
    - [`R eq S: Rng, Rng → Rng`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#operation-op-eq-rng-rng)
    - [`R ne S: Rng, Rng → Rng`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/generic.md#operation-op-ne-rng-rng)
- [Generic Element Functions](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md)
  - [Parent and Category](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#parent-and-category)
    - [`Parent(r): RngElt → Rng`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-parent-rngelt)
    - [`Category(r): RngElt → Cat`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-category-rngelt)
    - [`Type(r): RngElt → Cat`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-type-rngelt)
  - [Creation of Elements](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#creation-of-elements)
    - [`Zero(R): Rng → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-zero-rng)
    - [`One(R): Rng → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-one-rng)
    - [`Id(R): Rng → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-id-rng)
    - [`R ! a: Rng, RngElt → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-op-rng-rngelt)
    - [`Random(R): Rng → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-random-rng)
    - [`Representative(R): Rng → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-representative-rng)
    - [`Rep(R): Rng → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-rep-rng)
  - [Arithmetic Operations](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#arithmetic-operations)
    - [`+ a: RngElt → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-operation-rngelt-rngelt)
    - [`- a: RngElt → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-operation-rngelt-rngelt-2)
    - [`a + b: RngElt, RngElt → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-op-plus-rngelt-rngelt)
    - [`a - b: RngElt, RngElt → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-op-minus-rngelt-rngelt)
    - [`a * b: RngElt, RngElt → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-op-times-rngelt-rngelt)
    - [`a ^ k: RngElt, RngIntElt → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-op-pow-rngelt-rngintelt)
    - [`a / b: RngElt, RngElt → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-op-div-rngelt-rngelt)
    - [`a +:= b: RngElt, RngElt → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-operation-rngelt-rngelt-rngelt)
    - [`a -:= b: RngElt, RngElt → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-operation-rngelt-rngelt-rngelt-2)
    - [`a *:= b: RngElt, RngElt → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-operation-rngelt-rngelt-rngelt-3)
    - [`a /:= b: RngElt, RngElt → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-operation-rngelt-rngelt-rngelt-4)
    - [`a ^:= k: RngElt, RngIntElt → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-operation-rngelt-rngintelt-rngelt)
  - [Equality and Membership](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#equality-and-membership)
    - [`a eq b: RngElt, RngElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-op-eq-rngelt-rngelt)
    - [`a ne b: RngElt, RngElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-op-ne-rngelt-rngelt)
    - [`R eq S: Rng, Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-op-eq-rng-rng-2)
    - [`R ne S: Rng, Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-op-ne-rng-rng-2)
    - [`a in R: RngElt, Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-op-in-rngelt-rng)
    - [`a notin R: RngElt, Rng → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-op-notin-rngelt-rng)
  - [Predicates on Ring Elements](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#predicates-on-ring-elements)
    - [`IsZero(a): RngElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-iszero-rngelt)
    - [`IsOne(a): RngElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-isone-rngelt)
    - [`IsMinusOne(a): RngElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-isminusone-rngelt)
    - [`IsUnit(a): RngElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-isunit-rngelt)
    - [`IsIdempotent(x): RngElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-isidempotent-rngelt)
    - [`IsNilpotent(x): RngElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-isnilpotent-rngelt)
    - [`IsZeroDivisor(x): RngElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-iszerodivisor-rngelt)
    - [`IsIrreducible(x): RngElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-isirreducible-rngelt)
    - [`IsPrime(x): RngElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-isprime-rngelt)
  - [Comparison of Ring Elements](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#comparison-of-ring-elements)
    - [`a gt b: RngElt, RngElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-op-gt-rngelt-rngelt)
    - [`a ge b: RngElt, RngElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-op-ge-rngelt-rngelt)
    - [`a lt b: RngElt, RngElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-op-lt-rngelt-rngelt)
    - [`a le b: RngElt, RngElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#operation-op-le-rngelt-rngelt)
    - [`Maximum(a, b): RngElt, RngElt → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-maximum-rngelt-rngelt)
    - [`Maximum(Q): [RngIntElt] → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-maximum-rngintelt)
    - [`Minimum(a, b): RngElt, RngElt → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-minimum-rngelt-rngelt)
    - [`Minimum(Q): [RngIntElt] → RngElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/element.md#function-minimum-rngintelt)
- [Ideals and Quotient Rings](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/ideal-quotient.md)
  - [Defining Ideals and Quotient Rings](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/ideal-quotient.md#defining-ideals-and-quotient-rings)
    - [`ideal< R | a₁, ..., aᵣ >: Rng, RngElt, ..., RngElt → RngIdl`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/ideal-quotient.md#constructor-constructor-ideal-rng-rngelt-rngelt-rngidl)
    - [`quo< R | aᵣ, ..., aᵣ >: Rng, RngElt, ..., RngElt → Rng`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/ideal-quotient.md#constructor-constructor-quo-rng-rngelt-rngelt-rng)
    - [`R / I: Rng, RngIdl → Rng`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/ideal-quotient.md#operation-op-div-rng-rngidl)
    - [`PowerIdeal(R): Rng → PowIdl`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/ideal-quotient.md#function-powerideal-rng)
  - [Arithmetic Operations on Ideals](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/ideal-quotient.md#arithmetic-operations-on-ideals)
    - [`I + J: RngIdl, RngIdl → RngIdl`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/ideal-quotient.md#operation-op-plus-rngidl-rngidl)
    - [`I * J: RngIdl, RngIdl → RngIdl`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/ideal-quotient.md#operation-op-times-rngidl-rngidl)
    - [`I meet J: RngIdl, RngIdl → RngIdl`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/ideal-quotient.md#operation-op-meet-rngidl-rngidl)
  - [Boolean Operators on Ideals](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/ideal-quotient.md#boolean-operators-on-ideals)
    - [`a in I: RngElt, RngIdl → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/ideal-quotient.md#operation-op-in-rngelt-rngidl)
    - [`a notin I: RngElt, RngIdl → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/ideal-quotient.md#operation-op-notin-rngelt-rngidl)
    - [`I eq J: RngIdl, RngIdl → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/ideal-quotient.md#operation-op-eq-rngidl-rngidl)
    - [`I ne J: RngIdl, RngIdl → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/ideal-quotient.md#operation-op-ne-rngidl-rngidl)
    - [`I subset J: RngIdl, RngIdl → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/ideal-quotient.md#operation-op-subset-rngidl-rngidl)
    - [`I notsubset J: RngIdl, RngIdl → BoolElt`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/ideal-quotient.md#operation-operation-notsubset-rngidl-rngidl-boolelt)
- [Other Ring Constructions](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/creation-other.md)
  - [Residue Class Fields](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/creation-other.md#residue-class-fields)
    - [`ResidueClassField(I): Rng → Fld, Map`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/creation-other.md#function-residueclassfield-rng)
  - [Localization](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/creation-other.md#localization)
    - [`loc< R | a₁, ..., aᵣ >: Rng, RngElt, ..., RngElt → Rng, Map`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/creation-other.md#constructor-constructor-loc-rng-rngelt-rngelt-rng-map)
    - [`Localization(R, P): Rng, Rng → Rng, Map`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/creation-other.md#function-localization-rng-rng)
  - [Completion](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/creation-other.md#completion)
    - [`comp< R | a₁, ..., aᵣ >: Rng, RngElt, ..., RngElt → Rng, Map`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/creation-other.md#constructor-constructor-comp-rng-rngelt-rngelt-rng-map)
    - [`Completion(R, P): Rng, Rng → Rng, Map`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/creation-other.md#function-completion-rng-rng)
  - [Transcendental Extension](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/creation-other.md#transcendental-extension)
    - [`ext< R | >: Rng → RngUPol`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/creation-other.md#constructor-constructor-ext-rng-rngupol)
    - [`ext< R, n | >: Rng, RngIntElt → RngMPol`](https://docs.magma-maths.org/v2.30-1/BasicRings/IntroductionToRings/creation-other.md#constructor-constructor-ext-rng-rngintelt-rngmpol)
