diff --git a/core/lib/Drupal/Core/Entity/Query/QueryInterface.php b/core/lib/Drupal/Core/Entity/Query/QueryInterface.php index 3f7e390..3e77914 100644 --- a/core/lib/Drupal/Core/Entity/Query/QueryInterface.php +++ b/core/lib/Drupal/Core/Entity/Query/QueryInterface.php @@ -47,16 +47,27 @@ public function getEntityTypeId(); * If two or more conditions have the same field names they apply to the * same delta within that field. * It is also possible to add the numeric delta value between the field - * name and the column name, for example tags.5.value. - * Finally, it's possible to create a condition on delta itself by using a - * * as a wildcard. For example, ->condition('tags.*', 5) will find only - * entities which have at least six tags. Also, tags.* within a condition - * group means a specific delta so + * name and the column name. This will require condition to be satisfied on + * a specific delta of the field. + * @code + * ->condition('tags.5.value', 'news') + * @endcode + * Condition above will require exactly 6th value of the field to match the + * provided value. + * Further, it's possible to create a condition on delta itself by using a + * * as a wildcard. For example, + * @code + * ->condition('tags.*', 5) + * @endcode + * will find only entities which have at least six tags. + * Finally, wildcard condition on delta accompanied with a condition on the + * value itself will require the value to appear in the specific delta + * range. For example, * @code * ->condition('tags.*', 0, '>')) - * ->condition('tags.*.value', 'foo')) + * ->condition('tags.*.value', 'news')) * @endcode - * will only find the "foo" tag if it is not the first tag. + * will only find the "news" tag if it is not the first value. * @param $value * The value for $field. In most cases, this is a scalar and it's treated as * case-insensitive. For more complex operators, it is an array. The meaning