Home Online Manual
Top
Back: stdhilb
Forward: system
FastBack: Functions and system variables
FastForward: Control structures
Up: Functions
Top: Singular Manual
Contents: Table of Contents
Index: Index
About: About this document

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
See ideal; map; module; poly; substitute; vector.