1 | /****************************************************************************** |
---|
2 | * $Id: NSStringAdditions.m 7024 2008-11-03 03:41:49Z livings124 $ |
---|
3 | * |
---|
4 | * Copyright (c) 2005-2008 Transmission authors and contributors |
---|
5 | * |
---|
6 | * Permission is hereby granted, free of charge, to any person obtaining a |
---|
7 | * copy of this software and associated documentation files (the "Software"), |
---|
8 | * to deal in the Software without restriction, including without limitation |
---|
9 | * the rights to use, copy, modify, merge, publish, distribute, sublicense, |
---|
10 | * and/or sell copies of the Software, and to permit persons to whom the |
---|
11 | * Software is furnished to do so, subject to the following conditions: |
---|
12 | * |
---|
13 | * The above copyright notice and this permission notice shall be included in |
---|
14 | * all copies or substantial portions of the Software. |
---|
15 | * |
---|
16 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
---|
17 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
---|
18 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
---|
19 | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
---|
20 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
---|
21 | * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
---|
22 | * DEALINGS IN THE SOFTWARE. |
---|
23 | *****************************************************************************/ |
---|
24 | |
---|
25 | #import "NSStringAdditions.h" |
---|
26 | #import "NSApplicationAdditions.h" |
---|
27 | #import <transmission.h> |
---|
28 | |
---|
29 | @implementation NSString (NSStringAdditions) |
---|
30 | |
---|
31 | + (NSString *) ellipsis |
---|
32 | { |
---|
33 | return [NSString stringWithUTF8String: "\xE2\x80\xA6"]; |
---|
34 | } |
---|
35 | |
---|
36 | - (NSString *) stringByAppendingEllipsis |
---|
37 | { |
---|
38 | return [self stringByAppendingString: [NSString ellipsis]]; |
---|
39 | } |
---|
40 | |
---|
41 | + (NSString *) stringForFileSize: (uint64_t) size |
---|
42 | { |
---|
43 | if (size < 1024) |
---|
44 | return [NSString stringWithFormat: @"%lld %@", size, NSLocalizedString(@"bytes", "File size - bytes")]; |
---|
45 | |
---|
46 | CGFloat convertedSize; |
---|
47 | NSString * unit; |
---|
48 | if (size < pow(1024, 2)) |
---|
49 | { |
---|
50 | convertedSize = size / 1024.0f; |
---|
51 | unit = NSLocalizedString(@"KB", "File size - kilobytes"); |
---|
52 | } |
---|
53 | else if (size < pow(1024, 3)) |
---|
54 | { |
---|
55 | convertedSize = size / powf(1024.0f, 2.0f); |
---|
56 | unit = NSLocalizedString(@"MB", "File size - megabytes"); |
---|
57 | } |
---|
58 | else if (size < pow(1024, 4)) |
---|
59 | { |
---|
60 | convertedSize = size / powf(1024.0f, 3.0f); |
---|
61 | unit = NSLocalizedString(@"GB", "File size - gigabytes"); |
---|
62 | } |
---|
63 | else |
---|
64 | { |
---|
65 | convertedSize = size / powf(1024.0f, 4.0f); |
---|
66 | unit = NSLocalizedString(@"TB", "File size - terabytes"); |
---|
67 | } |
---|
68 | |
---|
69 | //attempt to have minimum of 3 digits with at least 1 decimal |
---|
70 | return convertedSize <= 9.995f ? [NSString localizedStringWithFormat: @"%.2f %@", convertedSize, unit] |
---|
71 | : [NSString localizedStringWithFormat: @"%.1f %@", convertedSize, unit]; |
---|
72 | } |
---|
73 | |
---|
74 | + (NSString *) stringForSpeed: (CGFloat) speed |
---|
75 | { |
---|
76 | return [[self stringForSpeedAbbrev: speed] stringByAppendingString: NSLocalizedString(@"B/s", "Transfer speed (Bytes per second)")]; |
---|
77 | } |
---|
78 | |
---|
79 | + (NSString *) stringForSpeedAbbrev: (CGFloat) speed |
---|
80 | { |
---|
81 | if (speed <= 999.95f) //0.0 K to 999.9 K |
---|
82 | return [NSString localizedStringWithFormat: @"%.1f K", speed]; |
---|
83 | |
---|
84 | speed /= 1024.0f; |
---|
85 | |
---|
86 | if (speed <= 99.995f) //0.98 M to 99.99 M |
---|
87 | return [NSString localizedStringWithFormat: @"%.2f M", speed]; |
---|
88 | else if (speed <= 999.95f) //100.0 M to 999.9 M |
---|
89 | return [NSString localizedStringWithFormat: @"%.1f M", speed]; |
---|
90 | else //insane speeds |
---|
91 | return [NSString localizedStringWithFormat: @"%.2f G", (speed / 1024.0f)]; |
---|
92 | } |
---|
93 | |
---|
94 | + (NSString *) stringForRatio: (CGFloat) ratio |
---|
95 | { |
---|
96 | if (ratio == TR_RATIO_NA) |
---|
97 | return NSLocalizedString(@"N/A", "No Ratio"); |
---|
98 | else if (ratio == TR_RATIO_INF) |
---|
99 | return [NSString stringWithUTF8String: "\xE2\x88\x9E"]; |
---|
100 | else; |
---|
101 | |
---|
102 | if (ratio <= 9.995f) //0.00 to 9.99 |
---|
103 | return [NSString localizedStringWithFormat: @"%.2f", ratio]; |
---|
104 | else if (ratio <= 99.95f) //10.0 to 99.9 |
---|
105 | return [NSString localizedStringWithFormat: @"%.1f", ratio]; |
---|
106 | else //rest are single digit |
---|
107 | return [NSString localizedStringWithFormat: @"%.0f", ratio]; |
---|
108 | } |
---|
109 | |
---|
110 | + (NSString *) timeString: (uint64_t) seconds showSeconds: (BOOL) showSeconds |
---|
111 | { |
---|
112 | return [NSString timeString: seconds showSeconds: showSeconds maxFields: NSUIntegerMax]; |
---|
113 | } |
---|
114 | |
---|
115 | + (NSString *) timeString: (NSUInteger) seconds showSeconds: (BOOL) showSeconds maxFields: (NSUInteger) max |
---|
116 | { |
---|
117 | NSMutableArray * timeArray = [NSMutableArray arrayWithCapacity: MIN(max, 4)]; |
---|
118 | NSUInteger remaining = seconds; |
---|
119 | |
---|
120 | if (max > 0 && seconds >= (24 * 60 * 60)) |
---|
121 | { |
---|
122 | NSInteger days = remaining / (24 * 60 * 60); |
---|
123 | if (days == 1) |
---|
124 | [timeArray addObject: NSLocalizedString(@"1 day", "time string")]; |
---|
125 | else |
---|
126 | [timeArray addObject: [NSString stringWithFormat: NSLocalizedString(@"%u days", "time string"), days]]; |
---|
127 | remaining %= (24 * 60 * 60); |
---|
128 | max--; |
---|
129 | } |
---|
130 | if (max > 0 && seconds >= (60 * 60)) |
---|
131 | { |
---|
132 | [timeArray addObject: [NSString stringWithFormat: NSLocalizedString(@"%u hr", "time string"), remaining / (60 * 60)]]; |
---|
133 | remaining %= (60 * 60); |
---|
134 | max--; |
---|
135 | } |
---|
136 | if (max > 0 && (!showSeconds || seconds >= 60)) |
---|
137 | { |
---|
138 | [timeArray addObject: [NSString stringWithFormat: NSLocalizedString(@"%u min", "time string"), remaining / 60]]; |
---|
139 | remaining %= 60; |
---|
140 | max--; |
---|
141 | } |
---|
142 | if (max > 0 && showSeconds) |
---|
143 | [timeArray addObject: [NSString stringWithFormat: NSLocalizedString(@"%u sec", "time string"), remaining]]; |
---|
144 | |
---|
145 | return [timeArray componentsJoinedByString: @" "]; |
---|
146 | } |
---|
147 | |
---|
148 | - (NSComparisonResult) compareFinder: (NSString *) string |
---|
149 | { |
---|
150 | NSInteger comparisonOptions = [NSApp isOnLeopardOrBetter] ? (NSCaseInsensitiveSearch | NSNumericSearch |
---|
151 | | NSWidthInsensitiveSearch | NSForcedOrderingSearch) |
---|
152 | : (NSCaseInsensitiveSearch | NSNumericSearch); |
---|
153 | return [self compare: string options: comparisonOptions range: NSMakeRange(0, [self length]) locale: [NSLocale currentLocale]]; |
---|
154 | } |
---|
155 | |
---|
156 | - (NSComparisonResult) compareNumeric: (NSString *) string |
---|
157 | { |
---|
158 | NSInteger comparisonOptions = [NSApp isOnLeopardOrBetter] ? (NSNumericSearch | NSForcedOrderingSearch) : NSNumericSearch; |
---|
159 | return [self compare: string options: comparisonOptions range: NSMakeRange(0, [self length]) locale: [NSLocale currentLocale]]; |
---|
160 | } |
---|
161 | |
---|
162 | @end |
---|