finished Row
[mdref/mdref-pq-gateway] / pq-gateway / pq / Gateway / Row / allOf.md
1 # mixed pq\Gateway\Row::allOf(mixed $foreign[, string $ref = NULL[, string $order = NULL[, int $limit = 0[, int $offset = 0]]]])
2
3 Find the child rows by foreign key.
4 See pq\Gateway\Table::of().
5
6 ## Params:
7
8 * mixed $foreign
9 The foreign table (name).
10 * Optional string $ref = NULL
11 A specific relation name if there are more than one foreign keys on the same table.
12 * Optional string $order = NULL
13 Sorting clause.
14 * Optional int $limit = 0
15 Row count limit.
16 * Optional int $offset = 0
17 Row count offset.
18
19 ## Returns:
20
21 * a [deferred promise of React/Promise](https://github.com/reactphp/promise#deferred-1), when using pq\Query\AsyncExecutor, the asynchronous executor.
22 Else:
23 * pq\Result, if pq\Result::$status != pq\Result::TUPLES_OK.
24 * pq\Result, if the rowset prototype pq\Gateway\Table::$rowset is empty.
25 * pq\Gateway\Rowset, an instance of the rowset prototype.