Gecko [ v3.cesa.co.za ]

Name	Size	Permission	Date
Middleware	[ DIR ]	drwxr-sr-x	2026-03-12 21:22
Options	[ DIR ]	drwxr-sr-x	2026-03-12 21:22
ResourceTemplate	[ DIR ]	drwxr-sr-x	2026-03-12 21:22
Testing	[ DIR ]	drwxr-sr-x	2026-03-12 21:22
Transport	[ DIR ]	drwxr-sr-x	2026-03-12 21:22
AgentHeader.php	5.84 KB	-rw-r--r--	2026-03-12 21:22
ApiException.php	12.17 KB	-rw-r--r--	2026-03-12 21:22
ApiKeyHeaderCredentials.php	3.71 KB	-rw-r--r--	2026-03-12 21:22
ApiStatus.php	6.51 KB	-rw-r--r--	2026-03-12 21:22
ArrayTrait.php	4.57 KB	-rw-r--r--	2026-03-12 21:22
BidiStream.php	7.11 KB	-rw-r--r--	2026-03-12 21:22
Call.php	3.46 KB	-rw-r--r--	2026-03-12 21:22
ClientOptionsTrait.php	15.28 KB	-rw-r--r--	2026-03-12 21:22
ClientStream.php	4.72 KB	-rw-r--r--	2026-03-12 21:22
CredentialsWrapper.php	13.6 KB	-rw-r--r--	2026-03-12 21:22
FixedSizeCollection.php	6.26 KB	-rw-r--r--	2026-03-12 21:22
GPBLabel.php	1.82 KB	-rw-r--r--	2026-03-12 21:22
GPBType.php	2.19 KB	-rw-r--r--	2026-03-12 21:22
GapicClientTrait.php	38.24 KB	-rw-r--r--	2026-03-12 21:22
GrpcSupportTrait.php	2.24 KB	-rw-r--r--	2026-03-12 21:22
HeaderCredentialsInterface.php	2.1 KB	-rw-r--r--	2026-03-12 21:22
InsecureCredentialsWrapper.php	2.09 KB	-rw-r--r--	2026-03-12 21:22
InsecureRequestBuilder.php	649 B	-rw-r--r--	2026-03-12 21:22
KnownTypes.php	3.87 KB	-rw-r--r--	2026-03-12 21:22
OperationResponse.php	20.86 KB	-rw-r--r--	2026-03-12 21:22
Page.php	9.22 KB	-rw-r--r--	2026-03-12 21:22
PageStreamingDescriptor.php	6.18 KB	-rw-r--r--	2026-03-12 21:22
PagedListResponse.php	6.78 KB	-rw-r--r--	2026-03-12 21:22
PathTemplate.php	4.06 KB	-rw-r--r--	2026-03-12 21:22
PollingTrait.php	3.65 KB	-rw-r--r--	2026-03-12 21:22
RequestBuilder.php	9.77 KB	-rw-r--r--	2026-03-12 21:22
RequestParamsHeaderDescriptor.php	2.57 KB	-rw-r--r--	2026-03-12 21:22
ResourceHelperTrait.php	3.93 KB	-rw-r--r--	2026-03-12 21:22
RetrySettings.php	21.64 KB	-rw-r--r--	2026-03-12 21:22
Serializer.php	19.45 KB	-rw-r--r--	2026-03-12 21:22
ServerStream.php	4.49 KB	-rw-r--r--	2026-03-12 21:22
ServerStreamingCallInterface.php	2.94 KB	-rw-r--r--	2026-03-12 21:22
ServiceAddressTrait.php	2.48 KB	-rw-r--r--	2026-03-12 21:22
UriTrait.php	2.33 KB	-rw-r--r--	2026-03-12 21:22
ValidationException.php	1.7 KB	-rw-r--r--	2026-03-12 21:22
ValidationTrait.php	2.93 KB	-rw-r--r--	2026-03-12 21:22
Version.php	2.49 KB	-rw-r--r--	2026-03-12 21:22

Rename

<?php
/*
 * Copyright 2016 Google LLC
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are
 * met:
 *
 *     * Redistributions of source code must retain the above copyright
 * notice, this list of conditions and the following disclaimer.
 *     * Redistributions in binary form must reproduce the above
 * copyright notice, this list of conditions and the following disclaimer
 * in the documentation and/or other materials provided with the
 * distribution.
 *     * Neither the name of Google Inc. nor the names of its
 * contributors may be used to endorse or promote products derived from
 * this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
namespace Google\ApiCore;

use Generator;
use IteratorAggregate;

/**
 * Response object for paged results from a list API method
 *
 * The PagedListResponse object is returned by API methods that implement
 * pagination, and makes it easier to access multiple pages of results
 * without having to manually manipulate page tokens. Pages are retrieved
 * lazily, with additional API calls being made as additional results
 * are required.
 *
 * The list elements can be accessed in the following ways:
 *  - As a single iterable used in a foreach loop or via the getIterator method
 *  - As pages of elements, using the getPage and iteratePages methods
 *  - As fixed size collections of elements, using the
 *    getFixedSizeCollection and iterateFixedSizeCollections methods
 *
 * Example of using PagedListResponse as an iterator:
 * ```
 * $pagedListResponse = $client->getList(...);
 * foreach ($pagedListResponse as $element) {
 *     // doSomethingWith($element);
 * }
 * ```
 *
 * Example of iterating over each page of elements:
 * ```
 * $pagedListResponse = $client->getList(...);
 * foreach ($pagedListResponse->iteratePages() as $page) {
 *     foreach ($page as $element) {
 *         // doSomethingWith($element);
 *     }
 * }
 * ```
 *
 * Example of accessing the current page, and manually iterating
 * over pages:
 * ```
 * $pagedListResponse = $client->getList(...);
 * $page = $pagedListResponse->getPage();
 * // doSomethingWith($page);
 * while ($page->hasNextPage()) {
 *     $page = $page->getNextPage();
 *     // doSomethingWith($page);
 * }
 * ```
 */
class PagedListResponse implements IteratorAggregate
{
    private $firstPage;

/**
     * PagedListResponse constructor.
     *
     * @param Page $firstPage A page containing response details.
     */
    public function __construct(
        Page $firstPage
    ) {
        $this->firstPage = $firstPage;
    }

/**
     * Returns an iterator over the full list of elements. If the
     * API response contains a (non-empty) next page token, then
     * the PagedListResponse object will make calls to the underlying
     * API to retrieve additional elements as required.
     *
     * NOTE: The result of this method is the same as getIterator().
     * Prefer using getIterator(), or iterate directly on the
     * PagedListResponse object.
     *
     * @return Generator
     * @throws ValidationException
     */
    public function iterateAllElements()
    {
        return $this->getIterator();
    }

/**
     * Returns an iterator over the full list of elements. If the
     * API response contains a (non-empty) next page token, then
     * the PagedListResponse object will make calls to the underlying
     * API to retrieve additional elements as required.
     *
     * @return Generator
     * @throws ValidationException
     */
    #[\ReturnTypeWillChange]
    public function getIterator()
    {
        foreach ($this->iteratePages() as $page) {
            foreach ($page as $key => $element) {
                yield $key => $element;
            }
        }
    }

/**
     * Return the current page of results.
     *
     * @return Page
     */
    public function getPage()
    {
        return $this->firstPage;
    }

/**
     * Returns an iterator over pages of results. The pages are
     * retrieved lazily from the underlying API.
     *
     * @return Page[]
     * @throws ValidationException
     */
    public function iteratePages()
    {
        return $this->getPage()->iteratePages();
    }

/**
     * Returns a collection of elements with a fixed size set by
     * the collectionSize parameter. The collection will only contain
     * fewer than collectionSize elements if there are no more
     * pages to be retrieved from the server.
     *
     * NOTE: it is an error to call this method if an optional parameter
     * to set the page size is not supported or has not been set in the
     * original API call. It is also an error if the collectionSize parameter
     * is less than the page size that has been set.
     *
     * @param int $collectionSize
     * @throws ValidationException if a FixedSizeCollection of the specified size cannot be constructed
     * @return FixedSizeCollection
     */
    public function expandToFixedSizeCollection(int $collectionSize)
    {
        return $this->getPage()->expandToFixedSizeCollection($collectionSize);
    }

/**
     * Returns an iterator over fixed size collections of results.
     * The collections are retrieved lazily from the underlying API.
     *
     * Each collection will have collectionSize elements, with the
     * exception of the final collection which may contain fewer
     * elements.
     *
     * NOTE: it is an error to call this method if an optional parameter
     * to set the page size is not supported or has not been set in the
     * original API call. It is also an error if the collectionSize parameter
     * is less than the page size that has been set.
     *
     * @param int $collectionSize
     * @throws ValidationException if a FixedSizeCollection of the specified size cannot be constructed
     * @return Generator|FixedSizeCollection[]
     */
    public function iterateFixedSizeCollections(int $collectionSize)
    {
        return $this->expandToFixedSizeCollection($collectionSize)->iterateCollections();
    }
}