This is the legacy 4D documentation web site. Documentations are progressively being moved to developer.4d.com
- 4D Language Reference
-
- Collections
-
-
About collections
-
Type conversions between collections and 4D arrays
-
collection.length
-
collection.average( )
-
collection.clear( )
-
collection.combine( )
-
collection.concat( )
-
collection.copy( )
-
collection.count( )
-
collection.countValues( )
-
collection.distinct( )
-
collection.equal( )
-
collection.every( )
-
collection.extract( )
-
collection.fill( )
-
collection.filter( )
-
collection.find( )
-
collection.findIndex( )
-
collection.indexOf( )
-
collection.indices( )
-
collection.insert( )
-
collection.join( )
-
collection.lastIndexOf( )
-
collection.map( )
-
collection.max( )
-
collection.min( )
-
collection.orderBy( )
-
collection.orderByMethod( )
-
collection.pop( )
-
collection.push( )
-
collection.query( )
-
collection.reduce( )
-
collection.remove( )
-
collection.resize( )
-
collection.reverse( )
-
collection.shift( )
-
collection.slice( )
-
collection.some( )
-
collection.sort( )
-
collection.sum( )
-
collection.unshift( )
-
ARRAY TO COLLECTION
-
COLLECTION TO ARRAY
-
New collection
-
New shared collection
-
collection.some( )
| collection.some ( {startFrom ;} methodName {; param {; param2 ; ... ; paramN}} ) -> Function result | ||||||||
| Parameter | Type | Description | ||||||
| startFrom | Longint |
|
Index to start the test at | |||||
| methodName | Text |
|
Name of the method to call for the test | |||||
| param | Expression |
|
Parameter(s) to pass to methodName | |||||
| Function result | Boolean |
|
True if at least one element successfully passed the test | |||||
The collection.some( ) method returns true if at least one element in the collection successfully passed a test implemented in the provided methodName method.
By default, collection.some( ) tests the whole collection. Optionally, you can pass the index of element from which to start the test in startFrom.
- If startFrom >= the collection's length, False is returned, which means the collection is not tested.
- If startFrom < 0, it is considered as the offset from the end of the collection.
- If startFrom = 0, the whole collection is searched (default).
In methodName, pass the name of the method to use to evaluate collection elements, along with its parameter(s) in param (optional). methodName can perform any test, with or without the parameter(s). This method receives an Object parameter in $1 and must set $1.result to true for every element fulfilling the test.
methodName receives the following parameters:
- in $1.value: element value to be evaluated
- in $2: param
- in $N...: param2...paramN
methodName sets the following parameter(s):
- $1.result (boolean): true if the element value evaluation is successful, false otherwise.
- $1.stop (boolean, optional): true to stop the method callback. The returned value is the last calculated.
In any case, at the point where collection.some( ) method encounters the first collection element returning true in $1.result, it stops calling methodName and returns true.
C_COLLECTION($c)
C_BOOLEAN($b)
$c:=New collection
$c.push(-5;-3;-1;-4;-6;-2)
$b:=$c.some("NumberGreaterThan0") // returns false
$c.push(1)
$b:=$c.some("NumberGreaterThan0") // returns true
$c:=New collection
$c.push(1;-5;-3;-1;-4;-6;-2)
$b:=$c.some("NumberGreaterThan0") //$b=true
$b:=$c.some(1;"NumberGreaterThan0") //$b=falseWith the following NumberGreaterThan0 method:
$1.result:=$1.value>0
Product: 4D
Theme: Collections
Number:
705245
Created: 4D v16 R6
4D Language Reference ( 4D v19)
4D Language Reference ( 4D v19.1)
4D Language Reference ( 4D v19.4)
4D Language Reference ( 4D v19.5)
4D Language Reference ( 4D v19.6)
4D Language Reference ( 4D v19.7)
4D Language Reference ( 4D v19.8)
