---
title: "Enumeration of Places"
canonical: "https://docs.magma-maths.org/v2.30-1/GlobalFields/ClassFieldTheoryForGlobalFunctionFields/place-enumeration.html"
source: "https://docs.magma-maths.org/v2.30-1/GlobalFields/ClassFieldTheoryForGlobalFunctionFields/place-enumeration.md"
part: "Global Fields"
chapter: "Class Field Theory for Global Function Fields"
breadcrumbs:
  - {"title": "Magma Handbook", "source": "https://docs.magma-maths.org/v2.30-1/index.md"}
  - {"title": "Global Fields", "source": "https://docs.magma-maths.org/v2.30-1/GlobalFields/index-global-fields.md"}
  - {"title": "Class Field Theory for Global Function Fields", "source": "https://docs.magma-maths.org/v2.30-1/GlobalFields/ClassFieldTheoryForGlobalFunctionFields/index-class-field-theory-for-global-function-fields.md"}
prev: {"title": "Related Functions", "source": "https://docs.magma-maths.org/v2.30-1/GlobalFields/ClassFieldTheoryForGlobalFunctionFields/related.md"}
next: {"title": "Bibliography", "source": "https://docs.magma-maths.org/v2.30-1/GlobalFields/ClassFieldTheoryForGlobalFunctionFields/bibliography.md"}
intrinsics:
  - {"name": "PlaceEnumInit", "signature": "PlaceEnumInit(K): FldFun -> PlcEnum"}
  - {"name": "PlaceEnumInit", "signature": "PlaceEnumInit(P): PlcFunElt -> PlcEnum"}
  - {"name": "PlaceEnumInit", "signature": "PlaceEnumInit(K, Pos): FldFun, [RngIntElt] -> PlcEnum"}
  - {"name": "PlaceEnumCopy", "signature": "PlaceEnumCopy(R): PlcEnum -> PlcEnum"}
  - {"name": "PlaceEnumPosition", "signature": "PlaceEnumPosition(R): PlcEnum -> [RngIntElt]"}
  - {"name": "PlaceEnumNext", "signature": "PlaceEnumNext(R): PlcEnum -> PlcFunElt"}
  - {"name": "PlaceEnumCurrent", "signature": "PlaceEnumCurrent(R): PlcEnum -> PlcFunElt"}
---

# Enumeration of Places

In several situations one needs to loop over the places of a function field until either the one finds a place with special properties or until they generate a certain group. The functions listed here support this.

<a id="function-placeenuminit-fldfun"></a>
## `PlaceEnumInit(K): FldFun -> PlcEnum`

```magma
Coprime: Any                        Default: 
All    : BoolElt                    Default: false
```

Initialises an enumeration process for places of the function field $K$. The enumeration process will loop over all irreducible polynomials of the underlying finite field and for each polynomial over all primes lying above it.

If `Coprime` is given, it should be either a set of places that should be ignored in the process or a divisor. In case a divisor is passed in only places coprime to the divisor will be returned.

If `All` is `false`, the infinite places won’t be considered.

<a id="function-placeenuminit-plcfunelt"></a>
## `PlaceEnumInit(P): PlcFunElt -> PlcEnum`

```magma
Coprime: Any                    Default: 
```

Constructs an enumeration process for places starting at the place $P$.

If `Coprime` is given, it should be either a set of places that should be ignored in the process or a divisor. In case a divisor is passed in only places coprime to the divisor will be returned.

<a id="function-placeenuminit-fldfun-rngintelt"></a>
## `PlaceEnumInit(K, Pos): FldFun, [RngIntElt] -> PlcEnum`

```magma
Coprime: Any                    Default: 
```

Constructs an enumeration environment that starts at the place of the function field $K$ indexed by *Pos* as returned from [`PlaceEnumPosition`](https://docs.magma-maths.org/v2.30-1/GlobalFields/ClassFieldTheoryForGlobalFunctionFields/place-enumeration.md#function-fldfunab-placeenumposition).

<a id="function-placeenumcopy-plcenum"></a>
## `PlaceEnumCopy(R): PlcEnum -> PlcEnum`

Copies the environment and the current state of the enumeration process for places $R$.

<a id="function-fldfunab-placeenumposition"></a>
## `PlaceEnumPosition(R): PlcEnum -> [RngIntElt]`

Returns a list of integers that acts as an index to the places as enumerated by the environment $R$.

<a id="function-placeenumnext-plcenum"></a>
## `PlaceEnumNext(R): PlcEnum -> PlcFunElt`

Returns the “next” place of the process $R$.

<a id="function-placeenumcurrent-plcenum"></a>
## `PlaceEnumCurrent(R): PlcEnum -> PlcFunElt`

Returns the current place pointed to by the environment $R$, i.e. the last place returned by `PlaceEnumNext`.
