michael@0: /* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
michael@0: /* This Source Code Form is subject to the terms of the Mozilla Public
michael@0:  * License, v. 2.0. If a copy of the MPL was not distributed with this
michael@0:  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
michael@0: 
michael@0: #include "nsISupports.idl"
michael@0: 
michael@0: /**
michael@0:  * Version strings are dot-separated sequences of version-parts.
michael@0:  *
michael@0:  * A version-part consists of up to four parts, all of which are optional:
michael@0:  *
michael@0:  * <number-a><string-b><number-c><string-d (everything else)>
michael@0:  *
michael@0:  * A version-part may also consist of a single asterisk "*" which indicates
michael@0:  * "infinity".
michael@0:  *
michael@0:  * Numbers are base-10, and are zero if left out.
michael@0:  * Strings are compared bytewise.
michael@0:  *
michael@0:  * For additional backwards compatibility, if "string-b" is "+" then
michael@0:  * "number-a" is incremented by 1 and "string-b" becomes "pre".
michael@0:  *
michael@0:  * 1.0pre1
michael@0:  * < 1.0pre2  
michael@0:  *   < 1.0 == 1.0.0 == 1.0.0.0
michael@0:  *     < 1.1pre == 1.1pre0 == 1.0+
michael@0:  *       < 1.1pre1a
michael@0:  *         < 1.1pre1
michael@0:  *           < 1.1pre10a
michael@0:  *             < 1.1pre10
michael@0:  *
michael@0:  * Although not required by this interface, it is recommended that
michael@0:  * numbers remain within the limits of a signed char, i.e. -127 to 128.
michael@0:  */
michael@0: [scriptable, uuid(e6cd620a-edbb-41d2-9e42-9a2ffc8107f3)]
michael@0: interface nsIVersionComparator : nsISupports
michael@0: {
michael@0:   /**
michael@0:    * Compare two version strings
michael@0:    * @param   A   The first version
michael@0:    * @param   B   The second version
michael@0:    * @returns < 0 if A < B
michael@0:    *          = 0 if A == B
michael@0:    *          > 0 if A > B
michael@0:    */
michael@0:   long compare(in ACString A, in ACString B);
michael@0: };
michael@0: