GITBOOK-10: No subject

Author: hatamiarash7

docs/.gitbook/assets/ipcalc-sc.png

@@ -21,6 +21,11 @@
   * [Get Tranco Rank](functions/tranco/get-tranco-rank.md)
   * [Download / Update Tranco](functions/tranco/download-update-tranco.md)
 
+***
+
+* [IP Address](ip-address/README.md)
+  * [IP Calculator](ip-address/ip-calculator.md)
+
 ## Collaboration
 
 * [Roadmap](collaboration/roadmap.md)

docs/SUMMARY.md

@@ -0,0 +1,17 @@
+---
+layout:
+  title:
+    visible: true
+  description:
+    visible: false
+  tableOfContents:
+    visible: true
+  outline:
+    visible: true
+  pagination:
+    visible: true
+---
+
+# IP Address
+
+This extension provides various functions for manipulating and analyzing IP addresses, including calculating networks, hosts, and subnet masks.

docs/ip-address/README.md

@@ -0,0 +1,50 @@
+---
+layout:
+  title:
+    visible: true
+  description:
+    visible: false
+  tableOfContents:
+    visible: true
+  outline:
+    visible: true
+  pagination:
+    visible: true
+---
+
+# IP Calculator
+
+The `ipcalc` function takes an IP address and netmask and calculates the resulting broadcast, network, wildcard mask, and host range.
+
+<figure><img src="../.gitbook/assets/ipcalc-sc.png" alt=""><figcaption><p>The result of <code>ipcalc</code>function</p></figcaption></figure>
+
+It's a table function that provides various details about IP addresses including:
+
+* Address
+* Netmask
+* Wildcard
+* Network / Hostroute
+* HostMin
+* HostMax
+* Broadcast
+* Hosts count
+
+You can use this table function with your data easily:
+
+```sql
+D CREATE OR REPLACE TABLE ips AS SELECT '127.0.0.1' AS ip UNION ALL SELECT '192.168.1.0/22';
+
+D SELECT i.IP,
+      (
+          SELECT hostsPerNet
+          FROM ipcalc(i.IP)
+      ) AS hosts
+  FROM ips AS i;
+┌────────────────┬───────┐
+│       ip       │ hosts │
+│    varchar     │ int64 │
+├────────────────┼───────┤
+│ 127.0.0.1      │   254 │
+│ 192.168.1.0/22 │  1022 │
+└────────────────┴───────┘
+```