[back] [prev] [next] [index] [root]

<p>&nbsp;<p>
<hr noshade size="5">
<h2><a name="SubfieldAdd"></a>
SubfieldAdd
</h2>

Adds a subfield to the given order.

<p><p>

<h3>
Syntax:
</h3>
<pre>SubfieldAdd(o, sub, alpha);</pre>

<p>

<table>
<tr>
<td>order</td>
<td><pre>  o  </pre></td>
<td></td>
</tr>
<tr>
<td>order</td>
<td><pre>  sub  </pre></td>
<td>subfield</td>
</tr>
<tr>
<td>algebraic element</td>
<td><pre>  alpha  </pre></td>
<td>primitive element of sub in o</td>
</tr>
</table>

<p>


See also:&nbsp;&nbsp;<a href="kashref.html#OrderSubfield">OrderSubfield</a>, <a href="kashref.html#OrderSubfieldSub">OrderSubfieldSub</a>, <a href="kashref.html#SubfieldGet">SubfieldGet</a>

<p>

<h3>
Description:
</h3>
This function adds a subfield to the given order. It checks if this
subfield was known. In this case, true is returned. The subfield
must be given as an equation order.

<p><p>

<p>
<hr>
<p>
<h3>
Example:
</h3>

<pre>

kash> o:=Order(Z,2,2);
Generating polynomial: x^2 - 2

kash> O:=Order(o,2,3);
      F[1]
        /
       /
   E1[1]
  /
 /
Q
F  [ 1]     x^2 - 3
E 1[ 1]     x^2 - 2

kash> Oa:=OrderAbs(O);
Generating polynomial: x^4 - 10*x^2 + 1

kash> SubfieldAdd(Oa,o,EltMove(OrderBasis(o)[2],Oa));
> true

</pre>

<p>


<hr>

<p>
<a href="../kashref.html"><- back</a>[back] [prev] [next] [index] [root]