Logo
Distributed Genetic Programming Framework
print print

File org.dgpf.gp.vm.base.IInstructionHandler.java

Here you can find all the information about the file org.dgpf.gp.vm.base.IInstructionHandler.java. You may explore it here or download it onto your local disk.
/*
 * Copyright (c) 2006 Thomas Weise
 * 
 * E-Mail           : tweise@gmx.de
 * Creation Date    : 2006-06-27 14:22:34
 * Original Filename: org.dgpf.gp.vm.base.IInstructionHandler.java
 * Version          : 1.0.0
 * Last modification: 2006-06-27
 *                by: Thomas Weise
 * 
 * License          : GNU LESSER GENERAL PUBLIC LICENSE
 *                    Version 2.1, February 1999
 *                    You should have received a copy of this license along
 *                    with this library; if not, write to the Free Software
 *                    Foundation, Inc., 59 Temple Place, Suite 330, Boston,
 *                    MA 02111-1307, USA or download the license under
 *                    http://www.gnu.org/copyleft/lesser.html.
 *                    
 * Warranty         : This software is provided "as is" without any
 *                    warranty; without even the implied warranty of
 *                    merchantability or fitness for a particular purpose.
 *                    See the Gnu Lesser General Public License for more
 *                    details.
 */

 
package org.dgpf.gp.vm.base;


import org.dgpf.gp.vm.mutation.MutationInfo;
import org.dgpf.search.api.utils.IMutator;

/**
 * The instruction handler interface. All instructions must have an
 * associated instruction handler.
 * 
 * @author Thomas Weise
 */

public interface  IInstructionHandler
       extends    IMutator<Instruction, VMContext, MutationInfo>  
  {
/**
 * Create a new randomized instance of the instruction handled by this
 * handler.
 * @param p_context The vm context to be used.
 * @param p_info    The information record holding the infos on the
 *                  instruction to be created.
 * @return  The new instruction instance.
 */

  public  abstract  Instruction create      (final VMContext    p_context,
                                             final MutationInfo p_info);
/**
 * Replace a memory access address by another one.
 * @param p_instruction The instruction to replace the address.
 * @param p_old         The old address.
 * @param p_new         The new address.
 * @return  The new instruction where the address relacement has been
 *          performed, or the old one if no replacement was needed.  
 */

  public abstract   Instruction swap_address(final Instruction p_instruction,
                                             final int         p_old,
                                             final int         p_new);
  
/**
 * This method tells if this instruction can be useful at the end of a
 * procedure. A comparison, for example, will never be useful, since
 * its result will always get lost.
 * @return <code>true</code> if and only if an instruction is useful at the
 *         end of a procedure.
 */

  public abstract   boolean is_useful_at_end();
  
/**
 * This method tells if this instruction can be useful at the beginning of
 * a procedure. A pop, for example, will never be useful, since the stack
 * of a procedure is initially empty.
 * @return <code>true</code> if and only if an instruction is useful at the
 *         beginning of a procedure.
 */

  public abstract   boolean is_useful_at_begin();
  
/**
 * Get an instruction that better represents the passed in instruction.
 * @param p_i   The instruction to replace.
 * @return  An instruction that better represents <code>p_i</code>, or
 *          <code>p_i</code> if it is already perfect, or <code>null</code>
 *          if <code>p_i</code> itself is totally useless.
 */

  public abstract   Instruction get_replacement (final Instruction p_i);
  
/**
 * Try to melt two instructions together. The second instruction is of
 * the type this instruction handler handles. This method will only be
 * called from the optimizer if it is guaranteed that the first instruction
 * does not influence the parameters of second one.
 * @param p_first   The first instruction.
 * @param p_second  The second instruction.
 * @return  An instruction able to replace the sequence of these both
 *          instructions, or <code>null</code> if no valid replacement
 *          coult be found.
 */

  public  abstract  Instruction try_melt  (final Instruction p_first,
                                           final Instruction p_second);
  }

File Information:

file name:IInstructionHandler.java
package:org.dgpf.gp.vm.base
qualified name:org.dgpf.gp.vm.base.IInstructionHandler.java
file type:Java Source File
download location:download http://dgpf.sourceforge.net/source/org/dgpf/gp/vm/base/IInstructionHandler.java
size:4.266 KB (4369 B)
uploaded: 2015-07-22 04:10:56 GMT+0000
last update: 2006-07-25 07:45:23 GMT+0000
last access: 2017-11-22 09:23:09 GMT+0000

statistics online since 2006-01-02.   RSS Feed
Contact us by sending an email to tweise@gmx.de to receive further information, to report errors, or to join our project.
All content on this site (http://dgpf.sourceforge.net/) is LGPL-licensed.
http://dgpf.sourceforge.net/scripts/source/source.php last modified at 2015-07-22 04:10:53 GMT+0000 served at 2017-11-22 09:23:09 GMT+0000.
Valid CSS Valid XHTML 1.1
Valid RSS SourceForge.net Logo