Recently, I had to create a PostgreSQL equivalent of the Java `hashCode()`

function. In order to do this, I needed a way to make sure that numbers that exceed the INTEGER representation (ranging from -2^31 to 2^31-1) will be wrapped. In JavaScript, this is as simple as using the logical shift left operator on the number. On the other hand, I was unable to find a simple way to do this in PostgreSQL. Therefore, I started using JavaScript to figure out a way to create a function which would allow me to simulate what is natively available in JavaScript. I came up with the following JavaScript function:

```
function wrapNumber(num, bits, unsigned) {
var most = Math.pow(2, bits), ret = num + (unsigned ? 0 : most / 2);
return (ret<0 ? Math.ceil(-ret/most) : -Math.floor(ret/most)) * most + num;
}
```

After testing the above function, I created the following PostgreSQL function:

```
CREATE OR REPLACE FUNCTION wrap_signed_bigint(
IN in_number BIGINT,
IN in_bits SMALLINT
)
RETURNS BIGINT AS $$
DECLARE
most BIGINT;
ret BIGINT;
BEGIN
most := 2 ^ in_bits;
ret := in_number + most / 2;
IF ret >= 0 OR (ret / most) * most = ret THEN
ret := -ret / most;
ELSE
ret := -ret / most + 1;
END IF;
RETURN ret * most + in_number;
END;
$$ LANGUAGE plpgsql;
```

Now if a number outside of the 32-bit range is passed in, a corresponding number that is in that range will be returned:

```
SELECT num,
msg,
wrap_signed_bigint(CAST(num AS BIGINT), CAST(32 AS SMALLINT))
FROM (
SELECT 'lowest negative number' AS msg, 2^31 AS num
UNION SELECT 'back to zero' AS msg, 2^32 AS num
UNION SELECT 'highest positive number' AS msg, -2^31 - 1 AS num
) t
```

By the way, if you want a signed version of the wrap function, you may use this code:

```
CREATE OR REPLACE FUNCTION wrap_unsigned_bigint(
IN in_number BIGINT,
IN in_bits SMALLINT
)
RETURNS BIGINT AS $$
DECLARE
most BIGINT;
ret BIGINT;
BEGIN
most := 2 ^ in_bits;
ret := in_number;
IF ret >= 0 OR (ret / most) * most = ret THEN
ret := -ret / most;
ELSE
ret := -ret / most + 1;
END IF;
RETURN ret * most + in_number;
END;
$$ LANGUAGE plpgsql;
```