edu.jas.structure
Interface ElemFactory<C extends Element<C>>

All Superinterfaces:

java.io.Serializable

All Known Subinterfaces:

AbelianGroupFactory<C>, AlgebraFactory<A,C>, ModulFactory<M,C>, MonoidFactory<C>, RingFactory<C>

All Known Implementing Classes:

AlgebraicNumberRing, BigComplex, BigDecimal, BigInteger, BigOctonion, BigQuaternion, BigRational, GenMatrixRing, GenPolynomialRing, GenSolvablePolynomialRing, GenVectorModul, LocalRing, LocalRing, ModIntegerRing, QuotientRing, QuotientRing, ResidueRing, ResidueRing

public interface ElemFactory<C extends Element<C>>
extends java.io.Serializable

Element factory interface. Defines embedding of integers, parsing and random element construction.

Author:

Heinz Kredel

Method Summary

C	copy(C c) Create a copy of Element c.
C	fromInteger(java.math.BigInteger a) Get the Element for a.
C	fromInteger(long a) Get the Element for a.
C	parse(java.io.Reader r) Parse from Reader.
C	parse(java.lang.String s) Parse from String.
C	random(int n) Generate a random Element with size less equal to n.
C	random(int n, java.util.Random random) Generate a random Element with size less equal to n.

Method Detail

fromInteger

C fromInteger(long a)

Get the Element for a.

Parameters:

a - long

Returns:

element corresponding to a.

fromInteger

C fromInteger(java.math.BigInteger a)

Get the Element for a.

Parameters:

a - java.math.BigInteger.

Returns:

element corresponding to a.

random

C random(int n)

Generate a random Element with size less equal to n.

Parameters:

n -

Returns:

a random element.

random

C random(int n,
         java.util.Random random)

Generate a random Element with size less equal to n.

Parameters:

n -

random - is a source for random bits.

Returns:

a random element.

copy

C copy(C c)

Create a copy of Element c.

Parameters:

c -

Returns:

a copy of c.

parse

C parse(java.lang.String s)

Parse from String.

Parameters:

s - String.

Returns:

a Element corresponding to s.

parse

C parse(java.io.Reader r)

Parse from Reader.

Parameters:

r - Reader.

Returns:

the next Element found on r.