Logo
Distributed Genetic Programming Framework
print print

File org.dgpf.gp.automaton.instructions.Write.java

Here you can find all the information about the file org.dgpf.gp.automaton.instructions.Write.java. You may explore it here or download it onto your local disk.
/*
 * Copyright (c) 2005 Thomas Weise
 *
 * E-Mail           : tweise@gmx.de
 * Creation Date    : 2005-11-25 14:36:46
 * Original Filename: org.dgpf.automaton.instructions.Write.java
 * Version          : 2.2.1
 * Last modification: 2006-05-08
 *                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.automaton.instructions;

import org.dgpf.gp.automaton.base.Automaton;
import org.dgpf.gp.automaton.base.Expression;
import org.dgpf.gp.automaton.base.Instruction;
import org.dgpf.gp.automaton.search.InstructionHandler;
import org.dgpf.gp.automaton.search.ProgramContext;
import org.sfc.math.stochastic.Randomizer;

/**
 * The write instruction. This instruction is internal and only
 * known by the genetics system.
 *
 * @author Thomas Weise
 */

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

  private static  final long    serialVersionUID  = 1;
/**
 * The shared singleton handler instance.
 */

  public  static  final InstructionHandler<Instruction> HANDLER
                                = WriteHandler.INSTANCE;

/**
 * What to write.
 */

  private               Expression  m_what            ;
/**
 * The address to write to.
 */

  private         final int         m_address         ;
/**
 * <code>true</code> if the write should be indirect.
 */

  private         final boolean     m_indirect        ;

/**
 * Create a new write instruction.
 * @param p_what      The expression which returns what to write.
 * @param p_address   The target address to write to.
 * @param p_indirect  <code>true</code> if the write should be indirect.
 */

  public  Write (final Expression p_what,
                 final int        p_address,
                 final boolean    p_indirect)
    {
    super(1 + p_what.get_complexity());
    this.m_what      = p_what;
    this.m_address   = p_address;
    this.m_indirect  = p_indirect;
    }

/**
 * Initialize a write instruction.
 * @param p_what      The expression which returns what to write.
 */

  final void  init  (final Expression p_what)
    {
    this.set_ticks(1 + p_what.get_complexity());
    this.m_what      = p_what;
    }

/**
 * Obtain the address which is used by this operation to write to.
 * @return  The address to write (directly or indirectly) to.
 */

  public  final int get_address ()
    {
    return this.m_address;
    }

/**
 * Returns <code>true</code> if this operation is a indirect memory access.
 * @return  <code>true</code> if and only if this operation represents an
 *          indirect memory access.
 */

  public  final boolean is_indirect ()
    {
    return this.m_indirect;
    }

/**
 * Obtain what to be written by this instruction.
 * @return What to be written by this instruction.
 */

  public  final Expression  get_what  ()
    {
    return this.m_what;
    }



/**
 * Wrap an expression into a random write body.
 * @param p_what        The expression to be wrapped.
 * @param p_random      The randomizer.
 * @param p_memory_size The count of memory cells currently available.
 * @return  The new write instruction.
 */

  public  static  final Write wrap  (final Expression      p_what,
                                     final Randomizer      p_random,
                                     final int             p_memory_size)
    {
    int l_addr;

    l_addr = p_what.get_handler().get_internal_address(p_what, p_random);

    if( (l_addr < 0) || p_random.nextBoolean() )
      {
      l_addr = ProgramContext.random_address(p_memory_size, p_random);
      }

    return new Write(p_what, l_addr, p_random.nextDouble() < 0.3d);
    }


/**
 * Checks wether this object is equal to another object.
 * @param p_object  The object to compare with.
 * @return  <code>true</code> if and only if the two objects are exactly
 *          equal.
 */

  @Override
  public  final boolean equals  (final Object p_object)
    {
    Write l_be;

    if(p_object == thisreturn true;

    if(p_object instanceof Write)
      {
      l_be = ((Write)p_object);
      if(l_be.m_address == this.m_address)
        {
        if(l_be.m_indirect == this.m_indirect)
          {
          return (l_be.m_what.equals(this.m_what));
          }
        }
      }

    return false;
    }

/**
 * This method is called when the instruction is executed. It performs the
 * work of the instruction.
 * @param p_automate    The automate it is invoked on.
 * @return  This method must return always <code>-1</code>.
 */

  @Override
  protected final int   execute (final Automaton p_automate)
    {
    int l_i;

    l_i = this.m_what.execute(p_automate);
    if(this.m_indirect)
      {
      p_automate.write_rel(this.m_address, l_i);
      }
    else
      {
      p_automate.write(this.m_address, l_i);
      }

    return RETURN;
    }



/**
 * Obtain the count of memory cells this item needs.
 * @return  The count of memory cells this item needs.
 */

  @Override
  public  final int   get_memory_size ()
    {
    return Math.max(this.m_address+1, this.m_what.get_memory_size());
    }

/**
 * 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)
    {
    boolean l_b;

    l_b = this.m_indirect;
    p_sb.append("mem[");
    if(l_b) p_sb.append('[');
    p_sb.append(this.m_address);
    if(l_b) p_sb.append(']');
    p_sb.append("]=");

    this.m_what.to_string(p_sb);
    }

/**
 * Returns the genetic handler of the code construct.
 * @return The genetic handler of the code construct.
 */

  @Override
  public final InstructionHandler<Instruction> get_handler ()
    {
    return HANDLER;
    }
  }

File Information:

file name:Write.java
package:org.dgpf.gp.automaton.instructions
qualified name:org.dgpf.gp.automaton.instructions.Write.java
file type:Java Source File
download location:download http://dgpf.sourceforge.net/source/org/dgpf/gp/automaton/instructions/Write.java
size:6.530 KB (6687 B)
uploaded: 2015-07-22 04:10:55 GMT+0000
last update: 2006-05-08 13:38:46 GMT+0000
last access: 2017-11-21 15:43:32 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-21 15:43:32 GMT+0000.
Valid CSS Valid XHTML 1.1
Valid RSS SourceForge.net Logo