Method getDirectoryListing

src/SFML/Network/Sftp.cpp:931–1001

///////////////////////////////////////////////////////

////////////////////////////////////////////////////////////
Sftp::ListingResult Sftp::getDirectoryListing(const std::filesystem::path& path, const TimeoutWithPredicate& timeout)
{
    LIBSSH2_SFTP_HANDLE* handle{};

    {
        const auto pathString = pathToUtf8(path);
        const auto result     = m_impl->waitForOperationComplete(
            [&]
            {
                handle = libssh2_sftp_open_ex(m_impl->sftpSession.get(),
                                              pathString.data(),
                                              static_cast<unsigned int>(pathString.size()),
                                              0,
                                              0,
                                              LIBSSH2_SFTP_OPENDIR);

                if (handle)
                    return LIBSSH2_ERROR_NONE;

                return libssh2_session_last_errno(m_impl->ssh2Session.get());
            },
            timeout);

        if (result == LIBSSH2_ERROR_EAGAIN)
            return {Result(Result::Value::Timeout), {}};

        if (!handle)
            return {makeError(m_impl->ssh2Session.get(), m_impl->sftpSession.get()), {}};
    }

    std::vector<Attributes> listing;

    {
        std::array<char, 4096>  buffer{};
        LIBSSH2_SFTP_ATTRIBUTES attributes{};

        while (true)
        {
            const auto result = m_impl->waitForOperationComplete(
                [&] { return libssh2_sftp_readdir_ex(handle, buffer.data(), buffer.size(), nullptr, 0, &attributes); },
                timeout);

            if (result > 0)
            {
                // The filename from libssh2 is UTF-8 encoded, convert before constructing filesystem::path
                listing.emplace_back(
                    makeAttributes(path / pathFromUtf8({buffer.data(), static_cast<std::size_t>(result)}), attributes));

                continue;
            }

            if (result == LIBSSH2_ERROR_EAGAIN)
            {
                libssh2_sftp_close_handle(handle);
                return {Result(Result::Value::Timeout), {}};
            }

            if (result == 0)