Logo
Distributed Genetic Programming Framework
print print

File org.dgpf.gp.vm.instructions.ctrl.Goto.java

Here you can find all the information about the file org.dgpf.gp.vm.instructions.ctrl.Goto.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-26 08:21:11
 * Original Filename: org.dgpf.gp.vm.instructions.ctrl.Goto.java
 * Version          : 1.0.0
 * Last modification: 2006-07-15
 *                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.instructions.ctrl;

import org.dgpf.gp.vm.base.IInstructionHandler;
import org.dgpf.gp.vm.base.Instruction;
import org.dgpf.gp.vm.base.VM;
import org.dgpf.gp.vm.instructions.BasicCosts;
import org.dgpf.gp.vm.instructions.InstructionCache;

/**
 * The unconditional goto operation.
 *
 * @author Thomas Weise
 */

public class Goto extends Instruction
  {
/**
 * The serial version uid.
 */

  private static final long serialVersionUID = 1;
/**
 * The procedure to be unconditional jump.
 */

  private final int       m_target;
/**
 * <code>true</code> if and only if this is an unconditional jump.
 */

  private final boolean   m_unconditional ;
  
/**
 * The hidden unconditional jump cache.
 */

  private static  final InstructionCache<Goto> UNC_CACHE
                    = new InstructionCache<Goto>(10)
    {
    
/**
 * Internally create a new instruction.
 * @param p_target The target property.
 * @return  The new instruction.
 */

    @Override
    protected final Goto create(final int p_target)
      {
      if(p_target >= 100) return null;      
      return new Goto(p_target, true);
      }
    };
  
/**
 * The hidden conditional jump cache.
 */

  private static  final InstructionCache<Goto> C_CACHE
                    = new InstructionCache<Goto>(10)
    {
    
/**
 * Internally create a new instruction.
 * @param p_target The target property.
 * @return  The new instruction.
 */

    @Override
    protected final Goto create(final int p_target)
      {
      if(p_target >= 100) return null;      
      return new Goto(p_target, false);
      }
    };
  
/**
 * Create a new push-c instruction.
 * @param p_target        The targetant to be pushed.
 * @param p_unconditional <code>true</code> if and only if this is an
 *                        unconditional jump.
 */

  Goto      (final int      p_target,
             final boolean  p_unconditional)
    {
    super();
    this.m_target        = p_target;
    this.m_unconditional = p_unconditional;
    }
  
/**
 * Obtain a new push-c targetant.
 * @param p_target        The targetant value to use.
 * @param p_unconditional <code>true</code> if and only if this is an
 *                        unconditional jump.
 * @return The new push-c targetant.
 */

  public  static  final Goto create(final int      p_target,
                                    final boolean  p_unconditional)
    {
    Goto l_c;
    
    l_c = (p_unconditional ? UNC_CACHE : C_CACHE).get(p_target);
    if(l_c != null) return l_c;
    return new Goto(p_target, p_unconditional);
    }
  
/**
 * Execute this instruction on a virtual machine.
 * @param p_machine The virtual machine to execute on.
 * @return  The cost of the execution of the last instruction.
 */

  @Override
  protected   final double  execute (final VM p_machine)
    {
    if(this.m_unconditional)
      {  
      p_machine.jump(this.m_target); 
      return BasicCosts.JUMP_COSTS;
      }
    
    if(p_machine.get_zero_flag()) p_machine.jump(this.m_target);  
    return BasicCosts.COND_JUMP_COSTS;
    }
  
  
/**
 * Store this objects content into a string builder.
 * @param p_sb  The string builder to store stuff into.
 */

  @Override
  public  final void  to_string (final StringBuilder p_sb)
    {
    if(this.m_unconditional) p_sb.append("goto ");
    else                     p_sb.append("if zf then goto ");
    p_sb.append(this.m_target);
    }
  
/**
 * Perform a write replace of this object.
 * @return  The object to store.
 */

  private final Object writeReplace()
    {
    Object  l_o;
    
    l_o = (this.m_unconditional ? UNC_CACHE : C_CACHE).get(this.m_target);
    if(l_o != null) return l_o;
    return this;
    }

/**
 * Deserialize to the proper instance.
 * @return  The globally shared instance.
 */

  private final Object readResolve()
    {
    return this.writeReplace();
    }
  

/**
 * Obtain the call target.
 * @return The call target.
 */

  public  final int get_target()
    {
    return this.m_target;
    }
  
/**
 * Returns <code>true</code> if and only if this is an unconditional jump.
 * @return <code>true</code> if and only if this is an unconditional jump.
 */

  public  final boolean is_unconditional()
    {
    return this.m_unconditional;
    }

/**
 * Obtain the instruction handler to be used for this sort of instructions.
 * @return The instruction handler to be used for this sort of instructions.
 */

  @Override
  public  final IInstructionHandler get_handler()
    {
    return GotoHandler.INSTANCE;
    }
  
/**
 * Check whether this instruction equals to a specified object, called
 * internally.
 * @param p_o   The object to compare with, which is of the same class as
 *              this instruction.
 * @return  <code>true</code> if and only if this instruction equals
 *          the specified object.
 */

  @Override
  protected boolean does_equal  (final Object p_o)
    {
    Goto l_g;
    
    l_g = ((Goto)p_o);
    
    return ((l_g.m_unconditional == this.m_unconditional) &&
            (l_g.m_target == this.m_target));
    }
  
  
/**
 * Get a string that can be copy-pasted into a java file an that creates
 * this instruction.
 * @param p_b The string builder to add with. 
 */

  @Override
  public final void    to_creation_string (final StringBuilder p_b)
    {
    p_b.append("Goto.create(");
    p_b.append(this.m_target);
    p_b.append(", ");
    p_b.append(this.m_unconditional);
    p_b.append(')');
    }
  }

File Information:

file name:Goto.java
package:org.dgpf.gp.vm.instructions.ctrl
qualified name:org.dgpf.gp.vm.instructions.ctrl.Goto.java
file type:Java Source File
download location:download http://dgpf.sourceforge.net/source/org/dgpf/gp/vm/instructions/ctrl/Goto.java
size:6.624 KB (6783 B)
uploaded: 2015-07-22 04:10:58 GMT+0000
last update: 2006-07-16 06:36:04 GMT+0000
last access: 2017-11-18 23:12:20 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-18 23:12:20 GMT+0000.
Valid CSS Valid XHTML 1.1
Valid RSS SourceForge.net Logo