---
title: "Structure Operations"
canonical: "https://docs.magma-maths.org/v2.30-1/BasicRings/Integers/operation.html"
source: "https://docs.magma-maths.org/v2.30-1/BasicRings/Integers/operation.md"
part: "Basic Rings"
chapter: "Ring of Integers"
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"}
  - {"title": "Ring of Integers", "source": "https://docs.magma-maths.org/v2.30-1/BasicRings/Integers/index-integers.md"}
prev: {"title": "Creation Functions", "source": "https://docs.magma-maths.org/v2.30-1/BasicRings/Integers/creation.md"}
next: {"title": "Element Operations", "source": "https://docs.magma-maths.org/v2.30-1/BasicRings/Integers/operation-element.md"}
intrinsics:
  - {"name": "Category", "signature": "Category(Z): RngInt -> Cat"}
  - {"name": "Parent", "signature": "Parent(Z): RngInt -> PowerStructure"}
  - {"name": "PrimeRing", "signature": "PrimeRing(Z): RngInt -> RngInt"}
  - {"name": "Center", "signature": "Center(Z): RngInt -> RngInt"}
  - {"name": "AdditiveGroup", "signature": "AdditiveGroup(Z): RngInt -> GrpAb, Map"}
  - {"name": "MultiplicativeGroup", "signature": "MultiplicativeGroup(Z): RngInt -> GrpAb, Map"}
  - {"name": "UnitGroup", "signature": "UnitGroup(Z): RngInt -> GrpAb, Map"}
  - {"name": "ClassGroup", "signature": "ClassGroup(Z): RngInt -> GrpAb, Map"}
  - {"name": "FieldOfFractions", "signature": "FieldOfFractions(Z): RngInt -> FldRat"}
  - {"name": "sub", "signature": "sub< Z | n >: RngInt, RngIntElt -> RngInt"}
  - {"name": "Characteristic", "signature": "Characteristic(Z): RngInt -> RngIntElt"}
  - {"name": "Signature", "signature": "Signature(Z): RngInt -> RngIntElt, RngIntElt"}
  - {"name": "IsCommutative", "signature": "IsCommutative(Z): RngInt -> BoolElt"}
  - {"name": "IsUnitary", "signature": "IsUnitary(Z): RngInt -> BoolElt"}
  - {"name": "IsFinite", "signature": "IsFinite(Z): RngInt -> BoolElt"}
  - {"name": "IsOrdered", "signature": "IsOrdered(Z): RngInt -> BoolElt"}
  - {"name": "IsField", "signature": "IsField(Z): RngInt -> BoolElt"}
  - {"name": "IsEuclideanDomain", "signature": "IsEuclideanDomain(Z): RngInt -> BoolElt"}
  - {"name": "IsPID", "signature": "IsPID(Z): RngInt -> BoolElt"}
  - {"name": "IsUFD", "signature": "IsUFD(Z): RngInt -> BoolElt"}
  - {"name": "IsDivisionRing", "signature": "IsDivisionRing(Z): RngInt -> BoolElt"}
  - {"name": "IsEuclideanRing", "signature": "IsEuclideanRing(Z): RngInt -> BoolElt"}
  - {"name": "IsPrincipalIdealRing", "signature": "IsPrincipalIdealRing(Z): RngInt -> BoolElt"}
  - {"name": "IsDomain", "signature": "IsDomain(Z): RngInt -> BoolElt"}
  - {"name": "eq", "signature": "Z eq R: RngInt, Rng -> BoolElt"}
  - {"name": "ne", "signature": "Z ne R: RngInt, Rng -> BoolElt"}
---

# Structure Operations

The following generic ring functions are applicable to the ring of integers and its elements.

## Related Structures

<a id="function-category-rngint"></a>
### `Category(Z): RngInt -> Cat`

<a id="function-parent-rngint"></a>
### `Parent(Z): RngInt -> PowerStructure`

<a id="function-primering-rngint"></a>
### `PrimeRing(Z): RngInt -> RngInt`

<a id="function-center-rngint"></a>
### `Center(Z): RngInt -> RngInt`

<a id="function-additivegroup-rngint"></a>
### `AdditiveGroup(Z): RngInt -> GrpAb, Map`

Create the abelian group of integers under addition. This returns an infinite (additive) abelian group $A$ of rank 1 together with a map from $A$ to the ring of integers $Z$, sending $A.1$ to $1$.

<a id="function-multiplicativegroup-rngint"></a>
### `MultiplicativeGroup(Z): RngInt -> GrpAb, Map`

<a id="function-unitgroup-rngint"></a>
### `UnitGroup(Z): RngInt -> GrpAb, Map`

Create the abelian group of invertible integers, that is, an abelian group isomorphic to the multiplicative subgroup $\langle -1\rangle$. This returns an (additive) abelian group $A$ of order $2$ together with a map from $A$ to the ring of integers $Z$, sending $A.1$ to $-1$.

<a id="function-classgroup-rngint"></a>
### `ClassGroup(Z): RngInt -> GrpAb, Map`

The class group of the ring of ${\mathbb{Z}}$ (which is trivial).

<a id="function-fieldoffractions-rngint"></a>
### `FieldOfFractions(Z): RngInt -> FldRat`

Create the field of fractions ${\mathbb{Q}}$ of the ring of rational integers.

<a id="constructor-constructor-sub-rngint-rngintelt-rngint"></a>
### `sub< Z | n >: RngInt, RngIntElt -> RngInt`

Given $Z$, the ring of integers or an ideal of it, and an element $n$ of $Z$, create the ideal $aZ\cap Z$ of the ring of integers. Note that this creates an ideal, not just a subring.

## Numerical Invariants

<a id="function-characteristic-rngint"></a>
### `Characteristic(Z): RngInt -> RngIntElt`

<a id="function-signature-rngint"></a>
### `Signature(Z): RngInt -> RngIntElt, RngIntElt`

The signature of ${\mathbb{Z}}$ as an order of ${\mathbb{Q}}$, i.e. `1, 0`.

## Ring Predicates and Booleans

<a id="function-iscommutative-rngint"></a>
### `IsCommutative(Z): RngInt -> BoolElt`

<a id="function-isunitary-rngint"></a>
### `IsUnitary(Z): RngInt -> BoolElt`

<a id="function-isfinite-rngint"></a>
### `IsFinite(Z): RngInt -> BoolElt`

<a id="function-isordered-rngint"></a>
### `IsOrdered(Z): RngInt -> BoolElt`

<a id="function-isfield-rngint"></a>
### `IsField(Z): RngInt -> BoolElt`

<a id="function-iseuclideandomain-rngint"></a>
### `IsEuclideanDomain(Z): RngInt -> BoolElt`

<a id="function-ispid-rngint"></a>
### `IsPID(Z): RngInt -> BoolElt`

<a id="function-isufd-rngint"></a>
### `IsUFD(Z): RngInt -> BoolElt`

<a id="function-isdivisionring-rngint"></a>
### `IsDivisionRing(Z): RngInt -> BoolElt`

<a id="function-iseuclideanring-rngint"></a>
### `IsEuclideanRing(Z): RngInt -> BoolElt`

<a id="function-isprincipalidealring-rngint"></a>
### `IsPrincipalIdealRing(Z): RngInt -> BoolElt`

<a id="function-isdomain-rngint"></a>
### `IsDomain(Z): RngInt -> BoolElt`

<a id="operation-op-eq-rngint-rng"></a>
### `Z eq R: RngInt, Rng -> BoolElt`

<a id="operation-op-ne-rngint-rng"></a>
### `Z ne R: RngInt, Rng -> BoolElt`
