---
layout: doc
title: system / replace_program
---
# replace_program

### NAME

    replace_program() - replaces the program in this_object()

### SYNOPSIS

    void replace_program( string str );

### 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.

### SEE ALSO

    clone_object(3), new(3)

