<Looper>.Seek (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Use conditions
Sensitivity to the case

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Looper>.Seek (Function)

In french: <Zone répétée>.Cherche

Seeks a value in an attribute of a Looper control.

Versions 21 and later
Remark: To perform a search in all the attributes of a Looper control, use <Looper>.SeekAnywhere.

New in version 21
Remark: To perform a search in all the attributes of a Looper control, use <Looper>.SeekAnywhere.

Remark: To perform a search in all the attributes of a Looper control, use <Looper>.SeekAnywhere.

Versions 15 and later

This function is now available for Android applications.

New in version 15

This function is now available for Android applications.

Versions 16 and later

This function is now available for WINDEV applications in Linux.

This function is now available for Windows Phone applications.

New in version 16

This function is now available for WINDEV applications in Linux.

This function is now available for Windows Phone applications.

This function is now available for WINDEV applications in Linux.

This function is now available for Windows Phone applications.

Versions 17 and later

This function is now available for iPhone/iPad applications.

This function is now available in Browser code.

New in version 17

This function is now available for iPhone/iPad applications.

This function is now available in Browser code.

This function is now available for iPhone/iPad applications.

This function is now available in Browser code.

Versions 18 and later

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Windows Store apps mode.

Versions 21 and later

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

New in version 21

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

Example

// Count the name starting with "SMI"
// The first one
Subscript is int = ATT_NAME.Seek("SMI", False)
Cnt is int = 0
WHILE Subscript <> -1
Cnt++
// Next one
Subscript = ATT_NAME.Seek("SMI", False, Subscript + 1)
END
Info("There are " + Cnt + " names starting with 'SMI'")

// Finds the position of customer #1234
Subscript is int = ATT_IDCUSTOMER.Seek("1234")
// If this customer was found
IF Subscript <> -1 THEN
// Positions the Looper control on the found customer
LOOP_LOOPER1 = Subscript
// Retrieves the name of the customer (ATT_NAME is an "attribute" of LOOP_LOOPER1)
// and assigns it to a Static control
STC_CAPTION1 = " Information about " + ATT_NAME
END

Syntax

<Result> = <Attribute>.Seek(<Sought value> [, <Type of search> [, <Start>]])

<Result>: Integer

Subscript of element found,
-1 if the search failed.

<Attribute>: Control name

Attribute of the Looper control on which the search must be performed.

<Sought value>: Character string (with quotes)

Value sought in the specified attribute.

<Type of search>: Optional Integer constant

Type of search to perform:
True (default value): Exact-match search ("Equals to"): Only the subscript of the elements whose value is strictly equal to <Sought value> is returned.
False: Generic search ("Starts with"): The subscript of the elements whose value starts with <Sought value> is returned.
Type of search to perform:
Versions 21 and later
searchStartsWith
New in version 21
searchStartsWith
searchStartsWith (or False for compatibility) Generic search whose type is "Starts with"
The subscript of the elements whose value starts with <Sought value> is returned.
Versions 21 and later
searchContains
New in version 21
searchContains
searchContains Generic search whose type is "Contains"
The subscript of the elements containing <Sought value> is returned.
This constant is not available.
Versions 21 and later
searchExactMatch
New in version 21
searchExactMatch
searchExactMatch (or True for compatibility)
(Default value) Exact-match search ("Equals to")
The subscript of the elements whose value is strictly equal to <Sought value> is returned.

<Start>: Optional integer

Start subscript for the search (1 by default).

Remarks

Use conditions

<Looper>.Seek can be used on a browsing or memory Looper control.

This function is not available for Linear Looper controls. This function is available for Looper controls in browser mode only.

This function is available for Looper controls in Ajax mode, Looper controls in classic mode and Linear Looper controls.

Sensitivity to the case

The search is not case sensitive, even if the search is an exact-match search.

Component: wd260obj.dll