StringEndsWith (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

String management functions

Characters taken into account for punctuation and spaces

StringEndsWith and UNICODE

See also

StringEndsWith (Function)

In french: ChaîneFinitPar

Checks whether a character string ends:

with a specific character string.
with one of the character strings in an array.

Versions 16 and later

This function is now available for PHP sites.

New in version 16

This function is now available for PHP sites.

This function is now available for PHP sites.

Versions 17 and later

This function is now available for Android applications.

This function is now available for Java applications.

New in version 17

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 18 and later

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

This function is now available for iPhone/iPad applications.

New in version 18

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

This function is now available for iPhone/iPad applications.

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

This function is now available for iPhone/iPad applications.

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

String1 is string
String2 is string
String1 = "Specify the action of the procedure"
String2 = "Procedure"
IF StringEndsWith(String1, String2, ccIgnoreCase) <> 9 THEN
Trace("The Procedure word is not found at the end of the string")
END

Syntax

Checking whether a character string ends with a specified string Hide the details

<Result> = StringEndsWith(<Initial string> , <Search string> [, <Search options>])

<Result>: Integer

Size of the corresponding element in the initial string,
0 if <Initial string> does not end with <Search string>.

<Initial string>: Character string (with quotes)

String to compare.

<Search string>: Character string (with quotes)

String to be compared at the end of <Initial string>.

<Search options>: Optional Integer constant (combination of constants)

Comparison options used to search for the <Search string> in the <Initial string>:
ccNormal
(Default value) Searches by performing a standard comparison between strings, similar to the '=' operator.
ccIgnoreAccent Searches by comparing strings, ignoring accents.
ccIgnoreCase Searches by comparing strings, ignoring the case (uppercase/lowercase characters).
ccIgnoreSpace Compares strings ignoring spaces before and after the strings.
Versions 20 and later
ccIgnoreInsideSpace
New in version 20
ccIgnoreInsideSpace
ccIgnoreInsideSpace Searches by comparing strings, ignoring spaces within the strings.
This constant is not available.
ccIgnorePunctuationAndSpace Searches by comparing strings, ignoring punctuation and spaces (see Notes for more details).

Checking whether a character string ends with one of the strings in an array Hide the details

<Result> = StringEndsWith(<Initial string> , <Search strings> [, <Search options>])

<Result>: Integer

Size of the corresponding element,
0 if <Initial string> does not end with one of the elements in <Search strings>.

<Initial string>: Character string (with quotes)

String to compare.

<Search strings>: Array

Elements to compare at the end of <Initial string>. This parameter can correspond to:
an array of character strings (in the following format: ["string1", "string2", "string3"]
an "array of character strings" variable.

<Search options>: Optional Integer constant (combination of constants)

Comparison options used to search for the <Search string> in the <Initial string>:
ccNormal
(Default value) Searches by performing a standard comparison between strings, similar to the '=' operator.
ccIgnoreAccent Searches by comparing strings, ignoring accents.
ccIgnoreCase Searches by comparing strings, ignoring the case (uppercase/lowercase characters).
ccIgnoreSpace Compares strings ignoring spaces before and after the strings.
Versions 20 and later
ccIgnoreInsideSpace
New in version 20
ccIgnoreInsideSpace
ccIgnoreInsideSpace Searches by comparing strings, ignoring spaces within the strings.
This constant is not available.
ccIgnorePunctuationAndSpace Searches by comparing strings, ignoring punctuation and spaces (see Notes for more details).

Remarks

Characters taken into account for punctuation and spaces

The characters taken into account for punctuation and spaces are provided by the system. To get the list of these characters, write the following WLanguage code:

s is string
FOR i = 0 TO 255
IF Charact(i) <> StringFormat(Charact(i), ccIgnorePunctuationAndSpace) THEN
s += Charact(i)
END
END
Info(s)
ToClipboard(s)

StringEndsWith and UNICODE

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