samples/apifest1/day1/parsingsolution/src/org/netbeans/apifest/boolcircuit/Circuit.java
author Jaroslav Tulach <jtulach@netbeans.org>
Sat, 14 Jun 2008 09:58:08 +0200
changeset 153 b5cbb797ec0a
parent 133 50bf1b976c0d
child 154 0fd5e9c500b9
permissions -rw-r--r--
up to line 2000
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@153
    25
 * First method parse must be called with valid logical expression on input.
jtulach@153
    26
 * If it returns zero then it is possible to call method evaluate with array
jtulach@153
    27
 * of input values as parameter. Method evaluate can be invoked many time with
jtulach@153
    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@153
    39
     * @return 0 when input expression is validated and parsed. Return nonzero value otherwise.
jtulach@52
    40
     */
jtulach@52
    41
    public int parse(String expression) {
jtulach@52
    42
        return 0;
jtulach@52
    43
    }
jtulach@52
    44
    
jtulach@52
    45
    /** Evaluate logical expression
jtulach@153
    46
     * @param array of boolean input values. Size of array must correspond to number
jtulach@153
    47
     * of variables used in expression
jtulach@153
    48
     * If size of array is bigger then only first N values are used to evaluate expression.
jtulach@153
    49
     * Remaining values are ignored.
jtulach@52
    50
     * If size of array is smaller then IllegalArgumentException is thrown.
jtulach@153
    51
     * If no expression is set by method parse then IllegalStateException is thrown.
jtulach@52
    52
     */
jtulach@52
    53
    public boolean evaluate(boolean [] x) {
jtulach@52
    54
        return true;
jtulach@52
    55
        
jtulach@52
    56
    }
jtulach@52
    57
    
jtulach@52
    58
}
jtulach@52
    59
// END: apifest.day1.parsingsolution.Circuit
jtulach@52
    60