Files
sdk/pkg/dartdoc/utils.dart
T
dgrove@google.com 39889f6270 Move dartdoc from lib/ to pkg/ .
Reviewed at desk by rnystrom, since gcl upload fails when there
are binary images in the change.

TBR=rnystrom@google.com



git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@10776 260f80e4-7a28-3924-810f-c04153c831b5
2012-08-15 22:59:55 +00:00

78 lines
2.5 KiB
Dart

// Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file
// for details. All rights reserved. Use of this source code is governed by a
// BSD-style license that can be found in the LICENSE file.
// Generic utility functions.
/** Turns [name] into something that's safe to use as a file name. */
String sanitize(String name) => name.replaceAll(':', '_').replaceAll('/', '_');
/** Returns the number of times [search] occurs in [text]. */
int countOccurrences(String text, String search) {
int start = 0;
int count = 0;
while (true) {
start = text.indexOf(search, start);
if (start == -1) break;
count++;
// Offsetting by search length means overlapping results are not counted.
start += search.length;
}
return count;
}
/** Repeats [text] [count] times, separated by [separator] if given. */
String repeat(String text, int count, [String separator]) {
// TODO(rnystrom): Should be in corelib.
final buffer = new StringBuffer();
for (int i = 0; i < count; i++) {
buffer.add(text);
if ((i < count - 1) && (separator !== null)) buffer.add(separator);
}
return buffer.toString();
}
/** Removes up to [indentation] leading whitespace characters from [text]. */
String unindent(String text, int indentation) {
var start;
for (start = 0; start < Math.min(indentation, text.length); start++) {
// Stop if we hit a non-whitespace character.
if (text[start] != ' ') break;
}
return text.substring(start);
}
/** Sorts the map by the key, doing a case-insensitive comparison. */
List<Mirror> orderByName(Collection<Mirror> list) {
final elements = new List<Mirror>.from(list);
elements.sort((a,b) {
String aName = a.simpleName;
String bName = b.simpleName;
bool doma = aName.startsWith(@"$dom");
bool domb = bName.startsWith(@"$dom");
return doma == domb ? aName.compareTo(bName) : doma ? 1 : -1;
});
return elements;
}
/**
* Joins [items] into a single, comma-separated string using [conjunction].
* E.g. `['A', 'B', 'C']` becomes `"A, B, and C"`.
*/
String joinWithCommas(List<String> items, [String conjunction = 'and']) {
if (items.length == 1) return items[0];
if (items.length == 2) return "${items[0]} $conjunction ${items[1]}";
return '${Strings.join(items.getRange(0, items.length - 1), ', ')}'
', $conjunction ${items[items.length - 1]}';
}
void writeString(File file, String text) {
var randomAccessFile = file.openSync(FileMode.WRITE);
randomAccessFile.writeStringSync(text);
randomAccessFile.closeSync();
}