The operators <<, <<=, >>, and >>= test for subnet inclusion. They consider only the network parts of the two addresses (ignoring any host part) and determine whether one network is identical to or a subnet of the other.
For example:
1 2 3 4 5 | SELECT inet '192.168.1.5' < inet '192.168.1.6' AS RESULT; result -------- t (1 row) |
Description: Is less than or equals
For example:
1 2 3 4 5 | SELECT inet '192.168.1.5' <= inet '192.168.1.5' AS RESULT; result -------- t (1 row) |
For example:
1 2 3 4 5 | SELECT inet '192.168.1.5' = inet '192.168.1.5' AS RESULT; result -------- t (1 row) |
Description: Is greater than or equals
For example:
1 2 3 4 5 | SELECT inet '192.168.1.5' >= inet '192.168.1.5' AS RESULT; result -------- t (1 row) |
For example:
1 2 3 4 5 | SELECT inet '192.168.1.5' > inet '192.168.1.4' AS RESULT; result -------- t (1 row) |
Description: Does not equal to
For example:
1 2 3 4 5 | SELECT inet '192.168.1.5' <> inet '192.168.1.4' AS RESULT; result -------- t (1 row) |
For example:
1 2 3 4 5 | SELECT inet '192.168.1.5' << inet '192.168.1/24' AS RESULT; result -------- t (1 row) |
Description: Is contained in or equals
For example:
1 2 3 4 5 | SELECT inet '192.168.1/24' <<= inet '192.168.1/24' AS RESULT; result -------- t (1 row) |
For example:
1 2 3 4 5 | SELECT inet '192.168.1/24' >> inet '192.168.1.5' AS RESULT; result -------- t (1 row) |
Description: Contains or equals
For example:
1 2 3 4 5 | SELECT inet '192.168.1/24' >>= inet '192.168.1/24' AS RESULT; result -------- t (1 row) |
For example:
1 2 3 4 5 | SELECT ~ inet '192.168.1.6' AS RESULT; result --------------- 63.87.254.249 (1 row) |
Description: The AND operation is performed on each bit of the two network addresses.
For example:
1 2 3 4 5 | SELECT inet '192.168.1.6' & inet '10.0.0.0' AS RESULT; result --------- 0.0.0.0 (1 row) |
Description: The OR operation is performed on each bit of the two network addresses.
For example:
1 2 3 4 5 | SELECT inet '192.168.1.6' | inet '10.0.0.0' AS RESULT; result ------------- 202.168.1.6 (1 row) |
For example:
1 2 3 4 5 | SELECT inet '192.168.1.6' + 25 AS RESULT; result -------------- 192.168.1.31 (1 row) |
For example:
1 2 3 4 5 | SELECT inet '192.168.1.43' - 36 AS RESULT; result ------------- 192.168.1.7 (1 row) |
For example:
1 2 3 4 5 | SELECT inet '192.168.1.43' - inet '192.168.1.19' AS RESULT; result -------- 24 (1 row) |
The abbrev, host, and text functions are primarily intended to offer alternative display formats.
Description: Abbreviated display format as text
Return type: text
For example:
1 2 3 4 5 | SELECT abbrev(inet '10.1.0.0/16') AS RESULT; result ------------- 10.1.0.0/16 (1 row) |
Description: Abbreviated display format as text
Return type: text
For example:
1 2 3 4 5 | SELECT abbrev(cidr '10.1.0.0/16') AS RESULT; result --------- 10.1/16 (1 row) |
Description: Broadcast address for network
Return type: inet
For example:
1 2 3 4 5 | SELECT broadcast('192.168.1.5/24') AS RESULT; result ------------------ 192.168.1.255/24 (1 row) |
Description: Extracts family of address; 4 for IPv4, 6 for IPv6
Return type: int
For example:
1 2 3 4 5 | SELECT family('::1') AS RESULT; result -------- 6 (1 row) |
Description: Extracts IP address as text.
Return type: text
For example:
1 2 3 4 5 | SELECT host('192.168.1.5/24') AS RESULT; result ------------- 192.168.1.5 (1 row) |
Description: Constructs host mask for network.
Return type: inet
For example:
1 2 3 4 5 | SELECT hostmask('192.168.23.20/30') AS RESULT; result --------- 0.0.0.3 (1 row) |
Description: Extracts subnet mask length.
Return type: int
For example:
1 2 3 4 5 | SELECT masklen('192.168.1.5/24') AS RESULT; result -------- 24 (1 row) |
Description: Constructs a subnet mask for the network.
Return type: inet
For example:
1 2 3 4 5 | SELECT netmask('192.168.1.5/24') AS RESULT; result --------------- 255.255.255.0 (1 row) |
Description: Extracts network part of address.
Return type: cidr
For example:
1 2 3 4 5 | SELECT network('192.168.1.5/24') AS RESULT; result ---------------- 192.168.1.0/24 (1 row) |
Description: Sets subnet mask length for inet value.
Return type: inet
For example:
1 2 3 4 5 | SELECT set_masklen('192.168.1.5/24', 16) AS RESULT; result ---------------- 192.168.1.5/16 (1 row) |
Description: Sets subnet mask length for cidr value.
Return type: cidr
For example:
1 2 3 4 5 | SELECT set_masklen('192.168.1.0/24'::cidr, 16) AS RESULT; result ---------------- 192.168.0.0/16 (1 row) |
Description: Extracts IP address and subnet mask length as text.
Return type: text
For example:
1 2 3 4 5 | SELECT text(inet '192.168.1.5') AS RESULT; result ---------------- 192.168.1.5/32 (1 row) |
Any cidr value can be cast to inet implicitly or explicitly; therefore, the functions shown above as operating on inet also work on cidr values. An inet value can be cast to cidr. After the conversion, any bits to the right of the subnet mask are silently zeroed to create a valid cidr value. In addition, you can cast a text string to inet or cidr using normal casting syntax. For example, inet(expression) or colname::cidr.
The function trunc(macaddr) returns a MAC address with the last 3 bytes set to zero.
trunc(macaddr)
Description: Sets last 3 bytes to zero.
Return type: macaddr
For example:
1 2 3 4 5 | SELECT trunc(macaddr '12:34:56:78:90:ab') AS RESULT; result ------------------- 12:34:56:00:00:00 (1 row) |
The macaddr type also supports the standard relational operators (such as > and <=) for lexicographical ordering, and the bitwise arithmetic operators (~, & and |) for NOT, AND and OR.