JCL Help:AnsiCompareNaturalStr

From Project JEDI Wiki
Jump to navigationJump to search


Summary

Compares strings based on the current locale with case sensitivity and using a 'natural order' algorithm.


Pascal

 function AnsiCompareNaturalStr(const S1: AnsiString; const S2: AnsiString): SizeInt;


Parameters

Parameters Description
const S1: AnsiString First string to compare.
const S2: AnsiString Second string to compare.


Return Value

0if S1 is identical to S2  - or -
a negative valueif S1 is less than S2  - or -
a positive valueif S1 is greater than S2


Description

AnsiCompareNaturalStr implements a case-sensitive, 'natural' comparison between the two supplied strings. It performs identical to the AnsiCompareStr function but compares number components numerically, instead of alphabetically.
Leading spaces are ignored when comparing numbers, but leading zeroes aren't. This gives more sensible order when comparing and sorting fractional numbers.
The table below shows the behaviour of both AnsiCompareNaturalStr and AnsiCompareStr:

S1 S2 AnsiCompareNaturalStr AnsiCompareStr
Delphi 5 Delphi 2005 negative positive
Delphi 5 Delphi 2005 negative negative
Delphi 5 Delphi 6 negative negative
Delphi 5 Delphi 6 negative positive
Delphi Highlander Delphi 2005 positive positive
Delphi Highlander Delphi Highlander positive positive
Foobar v0.9.4 Foobar v0.10.3 negative positive
Foobar v0.9.4 Foobar V0.9.4 negative negative
 
0002 1 negative negative
1.5 1.06 positive negative
 
0 -5 positive positive
-5 +2 negative positive


About

Unit

JclAnsiStrings


Donator

Marcel Bestebroer


Contribute to this help topic

This documentation wiki is based on the collaborative effort of Project JEDI users. Your edits are welcome in order to improve documentation quality: edit this page