* Returns the element at the specified position in this fluent iterable.
   *
   * <p><b>{@code Stream} equivalent:</b> {@code stream.skip(position).findFirst().get()} (but note
   * that this throws different exception types, and throws an exception if {@code null} would be
   * returned).
   *
   * @param position position of the element to return
   * @return the element at the specified position in this fluent iterable

        clientMap.put(Pattern.compile(regex), client);
    }

    /**
     * Adds a client with a regular expression pattern at a specific position.
     * @param regex The regular expression to match URLs.
     * @param client The CrawlerClient instance.
     * @param pos The position to add the client.
     */
    public void addClient(final String regex, final CrawlerClient client, final int pos) {

            bb.putShort((short) 3); // rflags
            // v1 node string follows
            bb.put("\\server1\0".getBytes(StandardCharsets.UTF_16LE));

            // Position for second referral
            bb.position(28); // 8 header + 20 first referral

            // Second Referral v1
            bb.putShort((short) 1); // version
            bb.putShort((short) 22); // size

        }

        @Test
        @DisplayName("Should write at different buffer positions")
        void testWriteAtDifferentPositions() {
            request.setReadLength(2048);
            request.setOffset(4096L);

            byte[] buffer = new byte[512];

            // Test at position 0
            int bytesWritten = request.writeBytesWireFormat(buffer, 0);

                // Validate sufficient buffer space for context header
                if (ncpos + 8 > buffer.length) {
                    throw new SMBProtocolDecodingException("Buffer too small for negotiate context header at position " + i);
                }

                final int type = SMBUtil.readInt2(buffer, ncpos);
                final int dataLen = SMBUtil.readInt2(buffer, ncpos + 2);

                // Validate context data length

        factory.addClient(regex, client);
    }

    /**
     * Adds a client to the wrapped factory at a specific position.
     * @param regex The regular expression for the client.
     * @param client The CrawlerClient instance.
     * @param pos The position to add the client.
     */
    @Override
    public void addClient(final String regex, final CrawlerClient client, final int pos) {

    }

    /**
     * Aligns the stream position to the specified boundary.
     * @param mask the alignment mask (typically 2, 4, or 8)
     * @throws IOException if an I/O error occurs
     */
    public void align(final int mask) throws IOException {
        final int position = this.size - this.dis.available();
        final int shift = position & mask - 1;
        if (mask != 0 && shift != 0) {

        assertEquals((byte) (value & 0xFF), dst[1]);
    }

    @Test
    @DisplayName("writeInt2 with offset should write at correct position")
    void testWriteInt2WithOffset() {
        byte[] dst = new byte[10];
        dst[2] = (byte) 0xFF; // Mark position
        dst[3] = (byte) 0xFF;

        SessionServicePacket.writeInt2(0xABCD, dst, 4);

        assertEquals((byte) 0xFF, dst[2]); // Should be unchanged

      long oldPosition = sourceChannel.position();
      long position = oldPosition;
      long copied;
      do {
        copied = sourceChannel.transferTo(position, ZERO_COPY_CHUNK_SIZE, to);
        position += copied;
        sourceChannel.position(position);
      } while (copied > 0 || position < sourceChannel.size());
      return position - oldPosition;
    }

   * Ensures that {@code start} and {@code end} specify valid <i>positions</i> in an array, list or
   * string of size {@code size}, and are in order. A position index may range from zero to {@code
   * size}, inclusive.
   *
   * @param start a user-supplied index identifying a starting position in an array, list or string
   * @param end a user-supplied index identifying an ending position in an array, list or string