package us.daveread.utility.formatcheck.gui;

 import java.util.Date;

 import java.text.NumberFormat;

 import java.text.DecimalFormat;

 /**

  * <p>Title: Utils

  * <p>Description: Utility methods

  * <p>Copyright: Copyright (c) 2005

  * <p>This program is free software; you can redistribute it and/or modify

  * it under the terms of the GNU General Public License as published by

  * the Free Software Foundation; either version 2 of the License, or

  * (at your option) any later version.

  * <p>This program is distributed in the hope that it will be useful,

  * but WITHOUT ANY WARRANTY; without even the implied warranty of

  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

  * GNU General Public License for more details.

  * <p>You should have received a copy of the GNU General Public License

  * along with this program; if not, write to the Free Software

  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

  * </p>

  *

  * @author David Read

  * @version $Id: Utils.java,v 1.1.1.1 2006/05/22 02:14:09 daveread Exp $

  */

 public class Utils {

   /** Force two-digit output -- used by timeElapsedFormat */

   static NumberFormat twoDigitFormat = new DecimalFormat("00");

   /**

    * No one should instanciate this class

    */

   private Utils() {

   }

   /**

    * Ensure that a given character is inserted at intervals along a String.

    * This is typically used to force including a space or CR periodically.

    * The method will walk through the supplied data string, looking for characters

    * that are in the break characters String.  If found, and the minimum number

    * of characters have been traversed, the insert string is inserted and the

    * character count reset.  If the maximum section length is reached and no

    * break characters have been found, the insert string is inserted anyway.

    *

    * @param saData String The string to have characters inserted into

    * @param saInsert String The string to insert into the data string

    * @param iaMinSectionLength int The mimumum number of characters in the data

    *      string, that must occur between inserted strings

    * @param iaMaxSectionLength int The maximum number of characters to allow

    *      in the data string between inserted strings

    * @param saBreakCharacters String The characters that signal a possible

    *      insertion point in the data string

    *

    * @return String The updated data string.  If the data string is null, a null

    *      String is returned.

    */

   public final static String characterInsert(String saData, String saInsert,

                                              int iaMinSectionLength,

                                              int iaMaxSectionLength,

                                              String saBreakCharacters) {

     StringBuffer sblResult;

     char clData[];

     int ilLen, ilPosit, ilSectionLength;

     if (saData != null) {

       ilLen = saData.length();

       clData = new char[ilLen];

       saData.getChars(0, ilLen, clData, 0);

       ilPosit = 0;

       ilSectionLength = 0;

       sblResult = new StringBuffer(ilLen * 2);

       for (ilPosit = 0; ilPosit < ilLen; ++ilPosit) {

         sblResult.append(clData[ilPosit]);

         ++ilSectionLength;

         if (saInsert.length() >= 1 && clData[ilPosit] == saInsert.charAt(0)) {

           ilSectionLength = 0;

         }

         else if ( (ilSectionLength >= iaMinSectionLength &&

                    saBreakCharacters.indexOf(clData[ilPosit]) >= 0) ||

                  ilSectionLength >= iaMaxSectionLength) {

           sblResult.append(saInsert);

           ilSectionLength = 0;

         }

       }

       saData = sblResult.toString();

     }

     return saData;

   }

   /**

    * Determine the number of elapsed seconds and convert to H:M:S display.

    *

    * @param aStart Date The starting time

    * @param aStop Date The ending time

    *

    * @return String The formatted elapsed time between start and stop

    */

   public final static String timeElapsedFormat(Date aStart, Date aStop) {

     String result;

     long seconds;

     if (aStart == null || aStop == null) {

       result = "Unknown";

     } else if (aStart.compareTo(aStop) > 0) {

       result = "Starts After End";

     } else {

       seconds = (aStop.getTime() - aStart.getTime()) / 1000;

       result = "";

       if (seconds >= 3600) {

         result += twoDigitFormat.format(seconds / 3600) + ":";

         seconds %= 3600;

       }

       result += twoDigitFormat.format(seconds / 60) + ":";

       seconds %= 60;

       result += twoDigitFormat.format(seconds);

     }

     return result;

   }

 }