codesimian
Class PrimitiveArray

java.lang.Object
  extended by codesimian.CS
      extended by codesimian.DefaultCS
          extended by codesimian.PrimitiveArray
All Implemented Interfaces:
CodeSimian, java.io.Serializable
Direct Known Subclasses:
PrimitiveArray.ByteArray, PrimitiveArray.IntArray

public abstract class PrimitiveArray
extends DefaultCS

Contains inner subclasses for efficiently using primitive arrays.

For efficiency, does NOT use the PROXY (setExec(CS) and getExec()) for some functions. This would usually cause infinite-loops, but its ok here because primitives are LEAFs in a tree therefore cant be in a cycle.

If you want to insert and delete from the array, you should use a tree, where leafs contain small primitive arrays, and put those classes here when you build them.

THIS CLASS IS NOT FINISHED

See Also:
Serialized Form

Nested Class Summary
static class PrimitiveArray.ByteArray
          stores all params as bytes (instead of CSs) in an array, and converts them to CS by using the constant-pool when requested.
THIS CLASS WAS NOT AUTOMATICLY-GENERATED BY PrimitiveArray.javaCodeForSubclass(byte[].class), but it should be.
static class PrimitiveArray.IntArray
          stores all params as ints (instead of CSs) in an array, and converts them to CS by using the constant-pool when requested.
THIS CLASS WAS NOT AUTOMATICLY-GENERATED BY PrimitiveArray.javaCodeForSubclass(int[].class), but it should be.
 
Field Summary
 
Fields inherited from class codesimian.CS
DESCRIPTION, END, EXECPROXY, FUEL, HEAP, JAVACODE, MYFUEL, NAME, NEWINSTANCE, NULL, PARENT, PARSEPRIORITY, PREV, TESTER
 
Constructor Summary
PrimitiveArray()
           
 
Method Summary
 double D()
          Execute this CS and cast to double.
 boolean deleteP(int index)
          WARNING: if returns false, could have deleted but not moved other params down 1 index.
WARNING: if duplicates not allowed, can not slide params down 1 index the standard way, returns false.
 double DForProxy()
          D() and DForProxy() are the 2 most important functions in CS.
 boolean insertP(int index, CS value)
          same as setP(int,CS) but inserts instead of overwriting.
 byte isIllusion(int index)
          Describes if the CS in an index is an illusion or not.
static java.lang.String javaCodeForSubclass(java.lang.Class arrayType)
          returns a String of Java code for an inner subclass of PrimitiveArray, to be copy/pasted into PrimitiveArray.java (or automaticly modify that file?).
 java.lang.String keyword()
          For the CodeSimian language as a String.
CodeSimian language keyword, like "+" "*" "max" ">" etc.

Override this function if you want to specify a keyword other than how I derive them from the class name, like + for Add.

Some CSs might never be intended to be used in the language by their keyword.
The best example (4/05) is Num, because it is used in the language like "3.4" instead of "num()".
 int maxP()
          Maximum quantity of Params
 int minP()
          For DForProxy().
Minimum number of parameters in param[] needed to call DForProxy().
Defines which indexs of param[] DForProxy() can use.
Functions with a different number of parameters must override this.
OVERRIDE THIS FUNCTION IF EXEC USES A DIFFERENT NUMBER OF PARAMETERS.
Default is 1.
 
Methods inherited from class codesimian.DefaultCS
B, C, countP, decrementMyFuel, description, F, fuel, getExec, getObject, heap, I, indexP, indexPName, insertB, insertC, insertD, insertF, insertI, insertJ, insertL, insertL, insertL1, insertS, insertZ, J, javaCode, LForProxy, LForProxy, myFuel, name, newInstance, objectToCS, objectToCSArray, objectToCSArray, P, prevD, prevL, PType, S, setB, setC, setCountP, setD, setD, setExec, setF, setFuel, setI, setJ, setL, setL, setL, setL1, setMyFuel, setName, setObject, setP, setPrevExec, setS, setZ, start, toString, V, Z
 
Methods inherited from class codesimian.CS
addP, addP, addP, addP, addP, BForProxy, CForProxy, clone, cost, deleteP, FForProxy, IForProxy, javaCode, JForProxy, L, L, L, L, L, maxD, minD, overwrites, parent, parsePriority, PB, PC, PD, PF, PI, PJ, PL, prevB, prevC, prevF, prevI, prevJ, prevS, prevZ, proxyOf, PS, PZ, reflect, reflect, setB, setC, setCost, setDescription, setF, setHeap, setI, setJ, setL, setL, setParent, setParsePriority, setProxyOf, setPType, setS, setTester, setZ, SForProxy, tester, VForProxy, voidReflect, ZForProxy
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

PrimitiveArray

public PrimitiveArray()
Method Detail

DForProxy

public double DForProxy()
Description copied from class: CS
D() and DForProxy() are the 2 most important functions in CS. They execute this CS. All other execute functions, by default, use DForProxy instead of reinventing-the-wheel for their own type.

For example, J() calls JForProxy() which calls DForProxy(). D() calls DForProxy() directly.

Execute this CS and cast to double. D() is the main EXECUTE function. D() uses DForProxy(). DForProxy() is the main action of every CS, the most important function. By default, all other primitive EXECUTE functions defer to D.
Functions that EXECUTE this CS: L(Class) L(int,Class,int) Z() B() C() S() I() J() F() D() V()

Specified by:
DForProxy in class DefaultCS

D

public double D()
Description copied from class: CS
Execute this CS and cast to double. All subclasses should override DForProxy() instead of D().

Overrides:
D in class CS
See Also:
CS.L(java.lang.Class)

keyword

public java.lang.String keyword()
Description copied from class: DefaultCS
For the CodeSimian language as a String.
CodeSimian language keyword, like "+" "*" "max" ">" etc.

Override this function if you want to specify a keyword other than how I derive them from the class name, like + for Add.

Some CSs might never be intended to be used in the language by their keyword.
The best example (4/05) is Num, because it is used in the language like "3.4" instead of "num()".
Default: Returns class name, minus package name (and its dots), and change the first letter to lowercase.

For example, CS.MaxParams does not override keyword(), which returns "maxP".

Overrides:
keyword in class DefaultCS
See Also:
CS.parent(), CS.newInstance(), CS.name()

isIllusion

public byte isIllusion(int index)
Description copied from class: CS
Describes if the CS in an index is an illusion or not. Example (S extends CS): new S("8fakeCSs") contains a String containing 8 chars. It only appears to contain 8 CSs. new S("8fakeCSs").P(3) returns the same as Const.pool('k'); //P(4).C() == 'e' Therefore S should override isIllusion to return 1 for every index.

Since illusions are constantly overwritten (to give the illusion that they change), if isIllusion(x)==1 then it must be true that: overwrites(x)==1 or overwrites(x)==0. It may equal 0 because that says you dont know (even though it is true).

Overrides:
isIllusion in class CS
See Also:
CS.overwrites(int), S.isIllusion(int)

minP

public int minP()
Description copied from class: DefaultCS
For DForProxy().
Minimum number of parameters in param[] needed to call DForProxy().
Defines which indexs of param[] DForProxy() can use.
Functions with a different number of parameters must override this.
OVERRIDE THIS FUNCTION IF EXEC USES A DIFFERENT NUMBER OF PARAMETERS.
Default is 1.

Overrides:
minP in class DefaultCS

maxP

public int maxP()
Description copied from class: CS
Maximum quantity of Params

Overrides:
maxP in class CS

deleteP

public boolean deleteP(int index)
Description copied from class: DefaultCS
WARNING: if returns false, could have deleted but not moved other params down 1 index.
WARNING: if duplicates not allowed, can not slide params down 1 index the standard way, returns false.

Overrides:
deleteP in class DefaultCS

insertP

public boolean insertP(int index,
                       CS value)
Description copied from class: CS
same as setP(int,CS) but inserts instead of overwriting. All higher params slide up 1 index.

Overrides:
insertP in class DefaultCS

javaCodeForSubclass

public static java.lang.String javaCodeForSubclass(java.lang.Class arrayType)
returns a String of Java code for an inner subclass of PrimitiveArray, to be copy/pasted into PrimitiveArray.java (or automaticly modify that file?).

This should replace the hard-coded subclasses ByteArray and IntArray. DO NOT MAKE ANY MORE SUBCLASSES UNTIL YOU FINISH javaCodeForSubclass(Class).

Parameters:
arrayType - any of boolean[].class, byte[].class, int[].class, float[].class, etc. (Later, support may be added for multidimensional array types like int[][][].class, but not yet.)