Hashids, ported for Swift (http://www.hashids.org)
Switch branches/tags
Nothing to show
Clone or download
malczak . update to Swift 4.1
. fix rte when `salt` is empty string
. update version to 0.3.2, set ios 11 as minimal version
. create branch for Swift 3/4
Latest commit c27a29f Apr 5, 2018



A Swift class to generate YouTube-like ids from numbers.

Ported from Hashids.php by ivanakimov

Read documentation at http://hashids.org/php

Example Usage

var hashids = Hashids(salt:"this is my salt");
var hash = hashids.encode(1, 2, 3); // hash:"laHquq"
var values = hashids.decode(hash!); // values:[1,2,3]

Example with custom alphabet and minimum hash length

var hashids = Hashids(salt:"this is my salt", minHashLength:8, alphabet:"abcdefghij1234567890");
var hash = hashids.encode(1, 2, 3); // hash:"514cdi42"
var values = hashids.decode(s!); // values:[1,2,3]

Example with UTF8 alphabet

var hashids = Hashids(salt:"this is my salt", minHashLength:0, alphabet:"▁▂▃▄▅▆▇█");
var hash = hashids.encode(1, 2, 3); // hash:"▅▅▂▄▃▆"
var values = hashids.decode(hash!); // values:[1,2,3]


Internally Hashids is using integer array rather than strings. By default Hashids class is just a type alias for Hashids_<UInt32> and is using unicode scalars for all string manipulations. This makes it possible to use unicode alphabets eq. '🐥🐷🐱🐶🐭'.

Generic version Hashids_<T> can be used for both ASCII and UTF alphabets. Based on how characters are interpreted in Swift there are possible 3 scenarios

  • Hashids_<UInt8> ASCII, uses String.UTF8View
  • Hashids_<UInt16> UTF16, uses String.UTF16View
  • Hashids_<UInt32> Unicode, uses String.UnicodeScalarView
Swift 2.3

For Swift 2.3 (2) version checkout branch swift-2.3


MIT License. See the LICENSE file.