samples/apifest1/day1/parsingsolution/src/org/netbeans/apifest/boolcircuit/Circuit.java
author Jaroslav Tulach <jtulach@netbeans.org>
Sat, 14 Jun 2008 09:56:12 +0200
changeset 132 3bc4c54f4bcc
parent 52 4257f4cf226b
child 133 50bf1b976c0d
permissions -rw-r--r--
Truncating all examples to 80 characters per line
jtulach@52
     1
/*
jtulach@52
     2
 * The contents of this file are subject to the terms of the Common Development
jtulach@52
     3
 * and Distribution License (the License). You may not use this file except in
jtulach@52
     4
 * compliance with the License.
jtulach@52
     5
 *
jtulach@52
     6
 * You can obtain a copy of the License at http://www.netbeans.org/cddl.html
jtulach@52
     7
 * or http://www.netbeans.org/cddl.txt.
jtulach@52
     8
 *
jtulach@52
     9
 * When distributing Covered Code, include this CDDL Header Notice in each file
jtulach@52
    10
 * and include the License file at http://www.netbeans.org/cddl.txt.
jtulach@52
    11
 * If applicable, add the following below the CDDL Header, with the fields
jtulach@52
    12
 * enclosed by brackets [] replaced by your own identifying information:
jtulach@52
    13
 * "Portions Copyrighted [year] [name of copyright owner]"
jtulach@52
    14
 *
jtulach@52
    15
 * The Original Software is NetBeans. The Initial Developer of the Original
jtulach@52
    16
 * Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
jtulach@52
    17
 * Microsystems, Inc. All Rights Reserved.
jtulach@52
    18
 */
jtulach@52
    19
jtulach@52
    20
package org.netbeans.apifest.boolcircuit;
jtulach@52
    21
jtulach@52
    22
// BEGIN: apifest.day1.parsingsolution.Circuit
jtulach@52
    23
/**
jtulach@52
    24
 * Usage:
jtulach@52
    25
 * First method parse must be called with valid logical expression on input.
jtulach@52
    26
 * If it returns zero then it is possible to call method evaluate with array
jtulach@52
    27
 * of input values as parameter. Method evaluate can be invoked many time with
jtulach@52
    28
 * different input values.
jtulach@52
    29
 * Method parse can be called anytime to change logical expression.
jtulach@52
    30
 */
jtulach@52
    31
public class Circuit {
jtulach@52
    32
    
jtulach@52
    33
    /** Parses logical expression
jtulach@52
    34
     * @param string representation of logical expression
jtulach@52
    35
     * Valid tokens:
jtulach@52
    36
     * Input values are represented by x and number starting from 1 eg.: x1
jtulach@52
    37
     * AND, NOT, OR and brackets '(',')' can be used.
jtulach@52
    38
     * Example of valid expression: x1 AND x2
jtulach@132
    39
     * @return 0 when input expression is validated and parsed. 
jtulach@132
    40
     * Return nonzero value otherwise.
jtulach@52
    41
     */
jtulach@52
    42
    public int parse(String expression) {
jtulach@52
    43
        return 0;
jtulach@52
    44
    }
jtulach@52
    45
    
jtulach@52
    46
    /** Evaluate logical expression
jtulach@132
    47
     * @param array of boolean input values. Size of array must
jtulach@132
    48
     * correspond to number of variables used in expression
jtulach@132
    49
     * If size of array is bigger then only first N values are used 
jtulach@132
    50
     * to evaluate expression. Remaining values are ignored.
jtulach@52
    51
     * If size of array is smaller then IllegalArgumentException is thrown.
jtulach@132
    52
     * If no expression is set by method parse then 
jtulach@132
    53
     * IllegalStateException is thrown.
jtulach@52
    54
     */
jtulach@52
    55
    public boolean evaluate(boolean [] x) {
jtulach@52
    56
        return true;
jtulach@52
    57
        
jtulach@52
    58
    }
jtulach@52
    59
    
jtulach@52
    60
}
jtulach@52
    61
// END: apifest.day1.parsingsolution.Circuit
jtulach@52
    62