transmission/macosx/NSStringAdditions.mm

165 lines
5.3 KiB
Plaintext
Raw Normal View History

// This file Copyright © 2005-2022 Transmission authors and contributors.
// It may be used under the MIT (SPDX: MIT) license.
// License text can be found in the licenses/ folder.
2007-09-16 01:02:06 +00:00
#include <libtransmission/transmission.h>
#include <libtransmission/utils.h>
2007-09-16 01:02:06 +00:00
#import "NSStringAdditions.h"
@interface NSString (Private)
+ (NSString*)stringForSpeed:(CGFloat)speed kb:(NSString*)kb mb:(NSString*)mb gb:(NSString*)gb;
@end
2007-09-16 01:02:06 +00:00
@implementation NSString (NSStringAdditions)
+ (NSString*)ellipsis
2007-09-16 01:02:06 +00:00
{
2017-07-08 08:06:32 +00:00
return @"\xE2\x80\xA6";
2007-09-16 01:02:06 +00:00
}
- (NSString*)stringByAppendingEllipsis
2007-09-16 01:02:06 +00:00
{
return [self stringByAppendingString:NSString.ellipsis];
2007-09-16 01:02:06 +00:00
}
// Maximum supported localization is 9.22 EB, which is the maximum supported filesystem size by macOS, 8 EiB.
// https://developer.apple.com/library/archive/documentation/FileManagement/Conceptual/APFS_Guide/VolumeFormatComparison/VolumeFormatComparison.html
+ (NSString*)stringForFileSize:(uint64_t)size
2007-09-16 01:02:06 +00:00
{
return [NSByteCountFormatter stringFromByteCount:size countStyle:NSByteCountFormatterCountStyleFile];
}
// Maximum supported localization is 9.22 EB, which is the maximum supported filesystem size by macOS, 8 EiB.
// https://developer.apple.com/library/archive/documentation/FileManagement/Conceptual/APFS_Guide/VolumeFormatComparison/VolumeFormatComparison.html
+ (NSString*)stringForFilePartialSize:(uint64_t)partialSize fullSize:(uint64_t)fullSize
{
NSByteCountFormatter* fileSizeFormatter = [[NSByteCountFormatter alloc] init];
NSString* fullSizeString = [fileSizeFormatter stringFromByteCount:fullSize];
//figure out the magnitude of the two, since we can't rely on comparing the units because of localization and pluralization issues (for example, "1 byte of 2 bytes")
BOOL partialUnitsSame;
if (partialSize == 0)
{
partialUnitsSame = YES; //we want to just show "0" when we have no partial data, so always set to the same units
}
else
{
unsigned int const magnitudePartial = log(partialSize) / log(1000);
// we have to catch 0 with a special case, so might as well avoid the math for all of magnitude 0
unsigned int const magnitudeFull = fullSize < 1000 ? 0 : log(fullSize) / log(1000);
partialUnitsSame = magnitudePartial == magnitudeFull;
}
fileSizeFormatter.includesUnit = !partialUnitsSame;
NSString* partialSizeString = [fileSizeFormatter stringFromByteCount:partialSize];
return [NSString stringWithFormat:NSLocalizedString(@"%@ of %@", "file size string"), partialSizeString, fullSizeString];
2007-09-16 01:02:06 +00:00
}
+ (NSString*)stringForSpeed:(CGFloat)speed
2007-09-16 01:02:06 +00:00
{
return [self stringForSpeed:speed kb:NSLocalizedString(@"KB/s", "Transfer speed (kilobytes per second)")
mb:NSLocalizedString(@"MB/s", "Transfer speed (megabytes per second)")
gb:NSLocalizedString(@"GB/s", "Transfer speed (gigabytes per second)")];
2007-09-16 01:02:06 +00:00
}
+ (NSString*)stringForSpeedAbbrev:(CGFloat)speed
2007-09-16 01:02:06 +00:00
{
return [self stringForSpeed:speed kb:@"K" mb:@"M" gb:@"G"];
2007-09-16 01:02:06 +00:00
}
+ (NSString*)stringForRatio:(CGFloat)ratio
2009-03-05 04:31:30 +00:00
{
//N/A is different than libtransmission's
if ((int)ratio == TR_RATIO_NA)
{
2007-09-16 01:02:06 +00:00
return NSLocalizedString(@"N/A", "No Ratio");
}
if ((int)ratio == TR_RATIO_INF)
{
2017-07-08 08:06:32 +00:00
return @"\xE2\x88\x9E";
}
if (ratio < 10.0)
{
return [NSString localizedStringWithFormat:@"%.2f", tr_truncd(ratio, 2)];
}
if (ratio < 100.0)
{
return [NSString localizedStringWithFormat:@"%.1f", tr_truncd(ratio, 1)];
}
return [NSString localizedStringWithFormat:@"%.0f", tr_truncd(ratio, 0)];
2007-09-16 01:02:06 +00:00
}
+ (NSString*)percentString:(CGFloat)progress longDecimals:(BOOL)longDecimals
{
if (progress >= 1.0)
{
return [NSString localizedStringWithFormat:@"%d%%", 100];
}
else if (longDecimals)
{
return [NSString localizedStringWithFormat:@"%.2f%%", tr_truncd(progress * 100.0, 2)];
}
else
{
return [NSString localizedStringWithFormat:@"%.1f%%", tr_truncd(progress * 100.0, 1)];
}
}
- (NSComparisonResult)compareNumeric:(NSString*)string
{
NSStringCompareOptions const comparisonOptions = NSNumericSearch | NSForcedOrderingSearch;
return [self compare:string options:comparisonOptions range:NSMakeRange(0, self.length) locale:NSLocale.currentLocale];
2007-09-16 01:02:06 +00:00
}
- (NSArray<NSString*>*)nonEmptyComponentsSeparatedByCharactersInSet:(NSCharacterSet*)separators
2011-09-19 00:48:30 +00:00
{
NSMutableArray<NSString*>* components = [NSMutableArray array];
for (NSString* evaluatedObject in [self componentsSeparatedByCharactersInSet:separators])
{
if (evaluatedObject.length > 0)
{
[components addObject:evaluatedObject];
}
}
2011-09-19 00:48:30 +00:00
return components;
}
2007-09-16 01:02:06 +00:00
@end
@implementation NSString (Private)
+ (NSString*)stringForSpeed:(CGFloat)speed kb:(NSString*)kb mb:(NSString*)mb gb:(NSString*)gb
{
if (speed <= 999.95) //0.0 KB/s to 999.9 KB/s
{
return [NSString localizedStringWithFormat:@"%.1f %@", speed, kb];
}
speed /= 1000.0;
if (speed <= 99.995) //1.00 MB/s to 99.99 MB/s
{
return [NSString localizedStringWithFormat:@"%.2f %@", speed, mb];
}
else if (speed <= 999.95) //100.0 MB/s to 999.9 MB/s
{
return [NSString localizedStringWithFormat:@"%.1f %@", speed, mb];
}
else //insane speeds
{
return [NSString localizedStringWithFormat:@"%.2f %@", (speed / 1000.0), gb];
}
}
@end