Core Function StrVersCmp - Revision history

UberFoX at 18:31, 19 September 2015

2015-09-19T18:31:44Z

← Older revision		Revision as of 18:31, 19 September 2015
Line 7:		Line 7:
	String comparison holding name and indices/version numbers.		String comparison holding name and indices/version numbers.

−	The strversmp() function shall compare two strings in a similar manner to strcmp(). If s1 and s2 contain no digits, strversmp() shall behave as strcmp().	+	The strversmp() function shall compare two strings in a similar manner to strcmp(). If str1 and str2 contain no digits, strversmp() shall behave as strcmp().

	The strings are compared by scanning from left to right. If a digit or sequence of digits is encountered in both strings at the same position, the digit sequence is specially compared, as described below. If the digit sequences compared equal, the string comparison resumes in both s1 and s2 after the digit sequence.		The strings are compared by scanning from left to right. If a digit or sequence of digits is encountered in both strings at the same position, the digit sequence is specially compared, as described below. If the digit sequences compared equal, the string comparison resumes in both s1 and s2 after the digit sequence.
Line 14:		Line 14:

	If two integral digit sequences are encountered, they shall be compared as integers for equality. A fractional digit sequence shall always compare less than an integral digit sequence. If two fractional digit sequences are being compared, then if the common prefix contains only leading zeroes, the longer part shall compare less than the shorter; otherwise the comparison shall be strictly numeric.		If two integral digit sequences are encountered, they shall be compared as integers for equality. A fractional digit sequence shall always compare less than an integral digit sequence. If two fractional digit sequences are being compared, then if the common prefix contains only leading zeroes, the longer part shall compare less than the shorter; otherwise the comparison shall be strictly numeric.
		+
		+	Thus, the task of strverscmp is to compare two strings and find the "right" order, while strcmp only finds the lexicographic order.
		+
		+	What this function does is the following. If both strings are equal, return 0. Otherwise find the position between two chars with the property that before it both strings are equal, while directly after it there is a difference. Find the largest consecutive digit strings containing (or starting at, or ending at) this position. If one or both of these is empty, then return what strcmp would have returned (numerical ordering of char values). Otherwise, compare both digit strings numerically, where digit strings with one or more leading zeroes are interpreted as if they have a decimal point in front (so that in particular digit strings with more leading zeroes come before digit strings with fewer leading zeroes). Thus, the ordering is 000, 00, 01, 010, 09, 0, 1, 9, 10.

	=== Parameters ===		=== Parameters ===

UberFoX: /* Return Value */

2015-09-19T18:30:05Z

Return Value

← Older revision		Revision as of 18:30, 19 September 2015
Line 35:		Line 35:
	=== Return Value ===		=== Return Value ===

−	~~Similar~~ to ~~other string comparison functions~~, ~~this one returns~~	+	Returns an integer less than, equal to, or greater than zero if str1 is found, respectively, to be earlier than, equal to, or later than str2.
−		+
−	~~-1 if str1 is less~~ than ~~str2~~	+
−		+
−	1 if str1 is ~~greater~~ than ~~str2~~	+
−		+
−	~~0 if they are~~ equal.	+

	=== Remarks ===		=== Remarks ===

UberFoX: 1 revision

2015-06-14T12:37:31Z

1 revision

← Older revision

Revision as of 12:37, 14 June 2015

UberFoX: 1 revision

2014-08-11T21:41:03Z

1 revision

← Older revision

Revision as of 21:41, 11 August 2014

UberFoX: Created page with "

 StrVersCmp( , ,  )

=== Description === String comparison holding name and indices/version numbers. The strversmp() function shall compare ..."

2013-09-03T09:16:03Z

Created page with "<pre> StrVersCmp( <str1>, <str2>, <ignoreCase> ) </pre> === Description === String comparison holding name and indices/version numbers. The strversmp() function shall compare ..."

New page

<pre>
StrVersCmp( <str1>, <str2>, <ignoreCase> )
</pre>

=== Description ===

String comparison holding name and indices/version numbers.

The strversmp() function shall compare two strings in a similar manner to strcmp(). If s1 and s2 contain no digits, strversmp() shall behave as strcmp().

The strings are compared by scanning from left to right. If a digit or sequence of digits is encountered in both strings at the same position, the digit sequence is specially compared, as described below. If the digit sequences compared equal, the string comparison resumes in both s1 and s2 after the digit sequence.

Digit sequences are classified as either "integral" or "fractional". A fractional digit sequence begins with a '0'; otherwise the digit sequence shall be treated as an integral digit sequence.

If two integral digit sequences are encountered, they shall be compared as integers for equality. A fractional digit sequence shall always compare less than an integral digit sequence. If two fractional digit sequences are being compared, then if the common prefix contains only leading zeroes, the longer part shall compare less than the shorter; otherwise the comparison shall be strictly numeric.

=== Parameters ===

==== str1 ====

The first string.

==== str2 ====

The second string.

==== ignoreCase ====

Optional; Do case insensitive match

true = Ignore case and match case insensitively

false = Case must be an exact match

=== Return Value ===

Similar to other string comparison functions, this one returns

-1 if str1 is less than str2

1 if str1 is greater than str2

0 if they are equal.

=== Remarks ===

None.

=== Example ===

<syntaxhighlight lang="sputnik">
say strverscmp( "no digit", "no digit"); // 0 /* same behavior as strcmp */
say strverscmp( "item#99", "item#100"); // < 0 /* same prefix, but 99 < 100 */
say strverscmp( "alpha1", "alpha001"); // > 0 /* fractional part inferior to integral */
say strverscmp( "part1_f012", "part1_f01"); // > 0 /* two fractional parts */
say strverscmp( "foo.009", "foo.0"); // < 0 /* two fractional parts but with leading zeroes only */
</syntaxhighlight>

[[Category:Core Function]]