}

    /**
     * Returns a new array with the specified object appended to the end.
     *
     * @param <T>
     *            the type of the array elements
     * @param array
     *            the array. Must not be {@literal null}
     * @param obj
     *            the object to add
     * @return a new array with the object appended
     */
    public static <T> T[] add(final T[] array, final T obj) {

        // Then
        assertEquals(appendedReferral, initialReferral.next,
                "The 'next' property of the initial referral should point to the appended referral.");
        assertEquals(initialReferral, appendedReferral.next,
                "The 'next' property of the appended referral should point back to the initial referral, closing the loop.");
    }

    /**
     * Tests the toString method of the DfsReferral class.

    }

    /**
     * Gets the additional query string that is appended to all search queries.
     *
     * @return the additionalQuery
     */
    public String getAdditionalQuery() {
        return additionalQuery;
    }

    /**
     * Sets the additional query string that is appended to all search queries.
     *
     * @param additionalQuery the additionalQuery to set
     */

    /**
     * Appends a filter to an existing filter chain.
     *
     * @param filter the filter to append
     * @param chain the existing filter chain to append to
     * @return a new filter chain that includes the appended filter
     */
    protected FilterChain appendFilterChain(final Filter filter, final FilterChain chain) {
        return (context, query, boost) -> filter.execute(context, query, boost, chain);
    }

    /**

    /**
     * Appends a filter to the existing filter chain.
     *
     * @param filter the filter to append
     * @param chain the existing filter chain
     * @return a new filter chain with the filter appended
     */
    protected FilterChain appendFilterChain(final Filter filter, final FilterChain chain) {
        return query -> filter.parse(query, chain);
    }

    /**

     * per line (similar to {@code maven.conf}) and {@code '#'} (hash) marked comment lines are allowed. Goals, if
     * present, are appended, to those specified on CLI input, if any.
     */
    Optional<String> atFile();

    /**
     * Returns the list of goals and phases to execute.
     *

        addrEntryField.setAccessible(true);
        addrEntryField.set(nameQueryResponse, null);

        // The toString method appends to super.toString(). We'll check the appended part.
        String expectedEnd = ",addrEntry=]";
        String actual = nameQueryResponse.toString();
        assertTrue(actual.endsWith(expectedEnd), "toString should end with ',addrEntry=]' when addrEntry is null");

      return delegate.add(object);
    }
    int[] entries = requireEntries();
    @Nullable Object[] elements = requireElements();

    int newEntryIndex = this.size; // current size, and pointer to the entry to be appended
    int newSize = newEntryIndex + 1;
    int hash = smearedHash(object);
    int mask = hashTableMask();
    int tableIndex = hash & mask;
    int next = CompactHashing.tableGet(requireTable(), tableIndex);

                SmbConstants.O_CREAT | SmbConstants.O_WRONLY | SmbConstants.O_APPEND, SmbConstants.FILE_WRITE_DATA,
                SmbConstants.DEFAULT_SHARING);

        byte[] data = "Appended".getBytes();

        // When
        outputStream.write(data);

        // Then - verify write request was sent
        verify(mockTreeHandle, atLeastOnce()).send(any(Smb2WriteRequest.class), any());
    }

        void testRelativeConstructorWithSid() throws Exception {
            // Arrange
            SID dom = new SID("S-1-5-21");
            SID rel = new SID("S-1-2-200-300"); // two subauthorities appended

            // Act
            SID combined = new SID(dom, rel);

            // Assert
            assertEquals("S-1-5-21-200-300", combined.toString());
        }

        @Test