Re: PowerMean

From:

Lew <noone@lewscanon.com>

Newsgroups:

comp.lang.java.help

Date:

Wed, 02 Sep 2009 20:25:10 -0400

Message-ID:

<h7n2d8$t8p$1@news.albasani.net>

Roedy Green wrote:

I wrote a little test program for newbies to show them how to compute
averages of a list of numbers in various ways. The code is posted
below. One function I called "powerMean". I presume I am not the
first person ever to compose such a function, and thus it must have an
established name. I wonder if anyone knows what it is.

...
    /**
     * Compute ordinary arithmetic average
     *
     * @param numbers array of doubles
     *
     * @return the ordinary arithmetic average or NaN for an empty
array.
     */
    @SuppressWarnings( { "WeakerAccess" } )

Whence comes this argument to @SuppressWarnings?

    public static double arthmeticMean( double... numbers )
        {
        if ( numbers.length == 0 )

I note that in this and the other methods you take no protection against
NullPointerException, usually a dangerous omission with respect to public
method arguments. That is, of course, a perfectly legitimate strategy but
should be reflected in the Javadocs with an @throws NullPointerException clause.

--
Lew