uk.ac.starlink.ttools.task
Class DoubleArrayParameter

java.lang.Object
  extended by uk.ac.starlink.task.Parameter<double[]>
      extended by uk.ac.starlink.ttools.task.DoubleArrayParameter

public class DoubleArrayParameter
extends Parameter<double[]>

Parameter for acquiring a fixed-length array of floating point values.

Since:
19 Sep 2014
Author:
Mark Taylor

Field Summary
 
Fields inherited from class uk.ac.starlink.task.Parameter
BY_NAME
 
Constructor Summary
DoubleArrayParameter(String name, int count)
          Constructor.
 
Method Summary
 double[] doublesValue(Environment env)
          Returns the parameter value as an array of doubles.
 float[] floatsValue(Environment env)
          Returns the parameter value as an array of floats.
 String objectToString(Environment env, double[] dvals)
          Takes a typed value of this parameter and formats it as a string which may be used for presentation to the user.
 double[] stringToObject(Environment env, String stringval)
          Takes a non-blank string, as supplied by the execution environment, and turns it into a typed value for this parameter.
 
Methods inherited from class uk.ac.starlink.task.Parameter
clearValue, getDescription, getName, getPosition, getPreferExplicit, getPrompt, getStringDefault, getUsage, getValueClass, isNullPermitted, objectValue, setDescription, setDescription, setName, setNullPermitted, setPosition, setPreferExplicit, setPrompt, setStringDefault, setUsage, setValue, setValueFromObject, setValueFromString, stringValue, toArray, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

DoubleArrayParameter

public DoubleArrayParameter(String name,
                            int count)
Constructor.

Parameters:
name - parameter name
count - numeric array length
Method Detail

doublesValue

public double[] doublesValue(Environment env)
                      throws TaskException
Returns the parameter value as an array of doubles.

Parameters:
env - execution environment
Returns:
array value
Throws:
TaskException

floatsValue

public float[] floatsValue(Environment env)
                    throws TaskException
Returns the parameter value as an array of floats.

Parameters:
env - execution environment
Returns:
array value
Throws:
TaskException

stringToObject

public double[] stringToObject(Environment env,
                               String stringval)
                        throws TaskException
Description copied from class: Parameter
Takes a non-blank string, as supplied by the execution environment, and turns it into a typed value for this parameter. This method also performs validation, so if the string value is unacceptable in any way, a ParameterValueException should be thrown.

It is an error to supply a null or empty string value.

If this method fails (throws a ParameterValueException) and if allowClassnameValue is set, then a subsequent attempt will be made to interpret the stringVal as the classname of a suitable class with a no-arg constructor.

Specified by:
stringToObject in class Parameter<double[]>
Parameters:
env - execution environment; in most cases this is not required but for some purposes environment-specific characteristics may influence the result
stringval - non-null, non-empty string value
Returns:
typed value
Throws:
TaskException

objectToString

public String objectToString(Environment env,
                             double[] dvals)
                      throws TaskException
Description copied from class: Parameter
Takes a typed value of this parameter and formats it as a string which may be used for presentation to the user. Ideally, round-tripping between this method and stringToObject should be possible, but that is not in general required/guaranteed.

The default implementation uses the value's toString method, but subclasses can override this for smarter behaviour.

Overrides:
objectToString in class Parameter<double[]>
Parameters:
env - execution environment
dvals - typed parameter value
Returns:
string value for presentation
Throws:
TaskException


Copyright © 2015 Central Laboratory of the Research Councils. All Rights Reserved.