X-Git-Url: https://git.korewanetadesu.com/?p=python-collate.git;a=blobdiff_plain;f=collate%2F_abcollator.py;h=9dce32bee99f5a7d9b746310fa7b3e4a90281af7;hp=094a5debbbd7e155d09efe8fca6db85b3435e3b3;hb=f1717db91d1ab7b37937cbe5ab17965cb8b7b592;hpb=29f1f7e12a4ca6100b00dc0d32e84f82f530bcb4 diff --git a/collate/_abcollator.py b/collate/_abcollator.py index 094a5de..9dce32b 100644 --- a/collate/_abcollator.py +++ b/collate/_abcollator.py @@ -1,5 +1,28 @@ +import collate.strings + class Collator(object): def cmp(self, string1, string2): + """Return negative if a < b, zero if a == b, positive if a > b.""" return cmp(self.key(string1), self.key(string2)) - + def words(self, string): + """Split the string along word boundries.""" + if isinstance(string, str): + string = string.decode(self.encoding, 'replace') + return string.split() + + def sortemekey(self, string, invalid=float('inf')): + """Return a key based on sortemes of a string. + + If the string is a str instance, it is decoded to a unicode + instance according to the 'encoding' attribute of the + Collator. + """ + if isinstance(string, str): + string = string.decode(self.encoding, 'replace') + + # Shove the sortkeyed original string on the end to resolve + # ties intelligently. + return (collate.strings.sortemes(string, self.key), + self.key(string)) +