CommonLength (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

String management functions

Strings, Buffer and UNICODE

Constants for managing character strings

Functions for managing character strings

HTMLToRTF

HTMLToText

Handling Unicode in character strings

Handling character strings

MatchRegularExpression

NumToFinancialWritingChinese

Serialization constants

SystemIntegerToInteger

Strings, Buffer and UNICODE

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

CommonLength (Function)

In french: TailleCommune

Returns the number of characters common to two characters strings (from the beginning or from the end).

Versions 15 and later

This function is now available for Android applications.

This function is now available for Java applications.

New in version 15

This function is now available for Android applications.

This function is now available for Java applications.

This function is now available for Android applications.

This function is now available for Java applications.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available in Android Widget mode.

New in version 18

This function is now available in Android Widget mode.

Versions 21 and later

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

Versions 25 and later

This function is now available in browser code.

New in version 25

This function is now available in browser code.

Example

// Compare from the beginning
CommonLength("ABCDE", "ABXYZ") // returns 2
// Compare from the end
CommonLength("VWXYZ", "ABXYZ", FromEnd) // returns 3

// Compare character by character
CommonLength("New York", "New Yorker") // returns 8
// Compare by entire word
CommonLength("New York", "New York City", WholeWord) // returns 8

// Compare while taking the case into account
CommonLength("ABCDE", "ABCdE") // returns 3
// Compare while ignoring the case
CommonLength("ABCDE", "ABCdE", IgnoreCase) // returns 5

Syntax

<Result> = CommonLength(<String1> , <String2> [, <Options>])

<Result>: Integer

Length of the part common to the two strings.

<String1>: Character string (with quotes)

String to compare.

<String2>: Character string (with quotes)

String to compare.

<Options>: Optional integer constant

Indicates the options for comparison:
FromBeginning Compare from the beginning of the strings
FromEnd Compare from the end of the strings
WholeWord Compare by entire word
IgnoreCase Compare while ignoring the case

These constants can be combined.
By default, the comparison is performed from the beginning of the string, character by character, by taking the case into account.

Remarks

Strings, Buffer and UNICODE

CommonLength applies to the buffers, the strings and the UNICODE strings.

Caution: The IgnoreCase and WholeWord constants do not apply to buffers.

You have the ability to use ANSI strings, Unicode strings and buffers in the different parameters of the function.

The following conversion rule is used for the Ansi systems (Windows or Linux):

If at least one of the strings is a buffer, all the strings are converted to buffers and the operation is performed with buffers.
If the first condition is not met and there is at least one Unicode string, all the strings are converted to Unicode and the operation is performed in Unicode (the conversion is performed with the current character set, if necessary).
Otherwise, the operation is performed in Ansi.

The following conversion rule is used for the Unicode systems (Windows CE):

If at least one of the strings is a buffer, all the strings are converted to buffers and the operation is performed with buffers.
Otherwise, the operation is performed in Unicode.

For more details on UNICODE, see Managing UNICODE.

Reminder: The linguistic parameters used are defined during the call to ChangeCharset.

Business / UI classification: Neutral code

Component: wd260vm.dll