text: // Copyright 2010 Cyrus Najmabadi
  //
  // 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., 51
  // Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  
  NSComparisonResult compareStringsNaturally(NSString* i1, NSString* i2);
  NSComparisonResult compareStringsFunction(id i1, id i2, void* context);
  
  @interface StringUtilities : NSObject {
  }
  
  + (NSString*) makeCanonical:(NSString*) title;
  + (NSString*) makeDisplay:(NSString*) title;
  
  + (NSString*) nonNilString:(NSString*) string;
  
  + (NSString*) stringByAddingPercentEscapes:(NSString*) string;
  
  + (NSString*) asciiString:(NSString*) string;
  + (NSString*) stringFromUnichar:(unichar) c;
  
  + (NSArray*) splitIntoChunks:(NSString*) string;
  
  + (NSUInteger) hashString:(NSString*) string;
  
  + (unichar) starCharacter;
  + (NSString*) emptyStarString;
  + (NSString*) halfStarString;
  + (NSString*) starString;
  
  + (NSString*) randomString:(NSInteger) length;
  
  @end
  