---

TStringUtils.java

/*
*  Name:      TStringUtils.java
*  Author:    Francisco Vides Fernandez
*  Summary:   Miscellaneous functions for formatting strings
*  Date:      $Date: 2003/10/02 22:25:06 $
*  Revision:  $Revision: 1.2 $
*
*  Copyright (C) 2001-2003  Francisco Vides Fernandez <pax@dedalo-ing.com>
*
*  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.
*
*  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.
*
*  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.
*/

package org.mpcl.text;

import java.util.ArrayList;
import java.util.List;
import java.util.StringTokenizer;


public class TStringUtils
{

  //
  //  S E L E C T O R S
  //

  public static List _tokenizeKeys (String yKEYS)
  {

    StringTokenizer   tTokenizer;
    List              tTokenList = new ArrayList();

    try
    {
      tTokenizer = new StringTokenizer (yKEYS);
      while ( tTokenizer.hasMoreTokens() )
      {
        tTokenList.add (tTokenizer.nextToken());
      }
    }
    catch (NullPointerException tEXCEPTION)
    {
      // we do nothing if the string is null
    }
    return tTokenList;

  }  // _tokenizeKeys()

  public static String _wrapString (String ySOURCE, int iMAX_LENGTH)
  {
    return _wrapString (ySOURCE, iMAX_LENGTH, ' ', "...");
  }

  public static String _wrapString (String ySOURCE, int iMAX_LENGTH, char cLAST_CHAR)
  {
    return _wrapString (ySOURCE, iMAX_LENGTH, cLAST_CHAR, "...");
  }

  public static String _wrapString ( String ySOURCE     ,
                                     int    iMAX_LENGTH ,
                                     char   cLAST_CHAR  ,
                                     String ySUFFIX     )
  {

    int      iLastIndex;
    String   yWrapped;
    
    if ( ( ySOURCE == null ) || ( ySOURCE.length() <= iMAX_LENGTH ) )
    {
      yWrapped = ySOURCE;
    }
    else
    {
      yWrapped   = ySOURCE.substring (0, iMAX_LENGTH);
      iLastIndex = yWrapped.lastIndexOf (cLAST_CHAR);
      if ( iLastIndex >= 0 )
      {
        yWrapped = yWrapped.substring (0, iLastIndex);
      }
      yWrapped += ySUFFIX;
    }
    return yWrapped;

  }  // _wrapString()

}  // class TStringUtils

---