update all libraries

vendor/mlocati/ip-lib/src/Range/RangeInterface.php

@@ -38,9 +38,26 @@ interface RangeInterface
      * Get the type of range of the IP address.
      *
      * @return int One of the \IPLib\Range\Type::T_... constants
+     *
+     * @since 1.5.0
      */
     public function getRangeType();
 
+    /**
+     * Get the address at a certain offset of this range.
+     *
+     * @param int $n the offset of the address (support negative offset)
+     *
+     * @return \IPLib\Address\AddressInterface|null return NULL if $n is not an integer or if the offset out of range
+     *
+     * @since 1.15.0
+     *
+     * @example passing 256 to the range 127.0.0.0/16 will result in 127.0.1.0
+     * @example passing -1 to the range 127.0.1.0/16 will result in 127.0.255.255
+     * @example passing 256 to the range 127.0.0.0/24 will result in NULL
+     */
+    public function getAddressAtOffset($n);
+
     /**
      * Check if this range contains an IP address.
      *
@@ -56,6 +73,8 @@ interface RangeInterface
      * @param \IPLib\Range\RangeInterface $range
      *
      * @return bool
+     *
+     * @since 1.5.0
      */
     public function containsRange(RangeInterface $range);
 
@@ -63,6 +82,8 @@ interface RangeInterface
      * Get the initial address contained in this range.
      *
      * @return \IPLib\Address\AddressInterface
+     *
+     * @since 1.4.0
      */
     public function getStartAddress();
 
@@ -70,6 +91,8 @@ interface RangeInterface
      * Get the final address contained in this range.
      *
      * @return \IPLib\Address\AddressInterface
+     *
+     * @since 1.4.0
      */
     public function getEndAddress();
 
@@ -91,6 +114,8 @@ interface RangeInterface
      * Get the subnet mask representing this range (only for IPv4 ranges).
      *
      * @return \IPLib\Address\IPv4|null return NULL if the range is an IPv6 range, the subnet mask otherwise
+     *
+     * @since 1.8.0
      */
     public function getSubnetMask();
 
@@ -98,6 +123,8 @@ interface RangeInterface
      * Get the subnet/CIDR representation of this range.
      *
      * @return \IPLib\Range\Subnet
+     *
+     * @since 1.13.0
      */
     public function asSubnet();
 
@@ -105,6 +132,8 @@ interface RangeInterface
      * Get the pattern/asterisk representation (if applicable) of this range.
      *
      * @return \IPLib\Range\Pattern|null return NULL if this range can't be represented by a pattern notation
+     *
+     * @since 1.13.0
      */
     public function asPattern();
 
@@ -113,8 +142,19 @@ interface RangeInterface
      *
      * @return string[]
      *
+     * @since 1.13.0
+     *
      * @example for IPv4 it returns something like array('x.x.x.x.in-addr.arpa', 'x.x.x.x.in-addr.arpa') (where the number of 'x.' ranges from 1 to 4)
      * @example for IPv6 it returns something like array('x.x.x.x..x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.ip6.arpa', 'x.x.x.x..x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.ip6.arpa') (where the number of 'x.' ranges from 1 to 32)
      */
     public function getReverseDNSLookupName();
+
+    /**
+     * Get the count of addresses this IP range contains.
+     *
+     * @return int|float Return float as for huge IPv6 networks, int is not enough
+     *
+     * @since 1.16.0
+     */
+    public function getSize();
 }