.\"replace the program in this_object()
.TH replace_program 3 "5 Sep 1994" MudOS "LPC Library Functions"
 
.SH NAME
replace_program() - replaces the program in this_object()
 
.SH SYNOPSIS
void replace_program( string str );
 
.SH DESCRIPTION
replace_program() replaces the program in this_object() with that of an 
object it inherits.  The string argument is the filename of the object 
whose program is to be used.  Once the replacement takes place, the current 
object effectively becomes a clone of that other object, but with its 
current filename and global variable values. The program is not actually 
replaced until the current execution is completed.
 
.SH SEE ALSO
clone_object(3), new(3)