5.1.152 subst

Syntax:

subst ( poly_expression, variable, poly_expression )
subst ( poly_expression, variable, poly_expression ,... variable, poly_expression )
subst ( vector_expression, variable, poly_expression )
subst ( ideal_expression, variable, poly_expression )
subst ( module_expression, variable, poly_expression )

Type:

poly, vector, ideal or module (corresponding to the first argument)

Purpose:

substitutes one or more ring variable(s)/parameter variable(s) by (a) polynomial(s). Note that in the case of more than one substitution pair, the substitutions will be performed sequentially and not simultaneously. The below examples illustrate this behaviour.
Note, that the coefficients must be polynomial when substituting a parameter.

Example:

ring r=0,(x,y,z),dp; poly f=x2+y2+z2+x+y+z; subst(f,x,y,y,z); // first substitute x by y, then y by z ==> 3z2+3z subst(f,y,z,x,y); // first substitute y by z, then x by y ==> y2+2z2+y+2z