====== Standard Generic Function REINITIALIZE-INSTANCE ====== ====Syntax==== * **reinitialize-instance** //instance ''&rest'' initargs ''&key'' ''&allow-other-keys''// → //instance// ====Method Signatures==== * **reinitialize-instance** (//instance// **[[CL:Types:standard-object]]**) //''&rest'' initargs// ====Arguments and Values==== * //instance// - an //[[CL:Glossary:object]]//. * //initargs// - an //[[CL:Glossary:initialization argument list]]//. ====Description==== The //[[CL:Glossary:generic function]]// **reinitialize-instance** can be used to change the values of //[[CL:Glossary:local slot|local slots]]// of an //instance// according to //initargs//. This //[[CL:Glossary:generic function]]// can be called by users. The system-supplied primary //[[CL:Glossary:method]]// for **reinitialize-instance** checks the validity of //initargs// and signals an error if an //initarg// is supplied that is not declared as valid. The //[[CL:Glossary:method]]// then calls the generic function **[[CL:Functions:shared-initialize]]** with the following arguments: the //instance//, **[[CL:Constant Variables:nil]]** (which means no //[[CL:Glossary:slot|slots]]// should be initialized according to their initforms), and the //initargs// it received. ====Examples==== None. ====Side Effects==== The //[[CL:Glossary:generic function]]// **reinitialize-instance** changes the values of //[[CL:Glossary:local slot|local slots]]//. ====Affected By==== None. ====Exceptional Situations==== The system-supplied primary //[[CL:Glossary:method]]// for **reinitialize-instance** signals an error if an //initarg// is supplied that is not declared as valid. ====See Also==== * **[[CL:Functions:initialize-instance|Generic Function INITIALIZE-INSTANCE]]** * **[[CL:Functions:shared-initialize|Generic Function SHARED-INITIALIZE]]** * **[[CL:Functions:update-instance-for-redefined-class|Generic Function UPDATE-INSTANCE-FOR-REDEFINED-CLASS]]** * **[[CL:Functions:update-instance-for-different-class|Generic Function UPDATE-INSTANCE-FOR-DIFFERENT-CLASS]]** * **[[CL:Functions:slot-boundp|Function SLOT-BOUNDP]]** * **[[CL:Functions:slot-makunbound|Function SLOT-MAKUNBOUND]]** * {\secref\InstanceReInit} * {\secref\InitargRules} * {\secref\DeclaringInitargValidity} ====Notes==== //Initargs// are declared as valid by using the **'':initarg''** option to **[[CL:Macros:defclass]]**, or by defining //[[CL:Glossary:method|methods]]// for **reinitialize-instance** or **[[CL:Functions:shared-initialize]]**. The keyword name of each keyword parameter specifier in the //[[CL:Glossary:lambda list]]// of any //[[CL:Glossary:method]]// defined on **reinitialize-instance** or **[[CL:Functions:shared-initialize]]** is declared as a valid initialization argument name for all //[[CL:Glossary:class|classes]]// for which that //[[CL:Glossary:method]]// is applicable. \issue{INITIALIZATION-FUNCTION-KEYWORD-CHECKING}