TheAlgorithms Go Save

Algorithms implemented in Go for beginners, following best practices.

Project README

The Algorithms - Go

Gitpod Ready-to-Code  golangci-lintgodocmd  update_directory_mdDiscord chat 

Algorithms implemented in Go (for education)

The repository is a collection of open-source implementation of a variety of algorithms implemented in Go and licensed under MIT License.

Read our Contribution Guidelines before you contribute.

List of Algorithms


  1. Advanced: Advanced Function performing the Advanced Aho-Corasick algorithm. Finds and prints occurrences of each pattern.
  2. AhoCorasick: AhoCorasick Function performing the Basic Aho-Corasick algorithm. Finds and prints occurrences of each pattern.
  3. ArrayUnion: ArrayUnion Concats two arrays of int's into one.
  4. BoolArrayCapUp: BoolArrayCapUp Dynamically increases an array size of bool's by 1.
  5. BuildAc: Functions that builds Aho Corasick automaton.
  6. BuildExtendedAc: BuildExtendedAc Functions that builds extended Aho Corasick automaton.
  7. ComputeAlphabet: ComputeAlphabet Function that returns string of all the possible characters in given patterns.
  8. ConstructTrie: ConstructTrie Function that constructs Trie as an automaton for a set of reversed & trimmed strings.
  9. Contains: Contains Returns 'true' if array of int's 's' contains int 'e', 'false' otherwise.
  10. CreateNewState: CreateNewState Automaton function for creating a new state 'state'.
  11. CreateTransition: CreateTransition Creates a transition for function σ(state,letter) = end.
  12. GetParent: GetParent Function that finds the first previous state of a state and returns it. Used for trie where there is only one parent.
  13. GetTransition: GetTransition Returns ending state for transition σ(fromState,overChar), '-1' if there is none.
  14. GetWord: GetWord Function that returns word found in text 't' at position range 'begin' to 'end'.
  15. IntArrayCapUp: IntArrayCapUp Dynamically increases an array size of int's by 1.
  16. StateExists: StateExists Checks if state 'state' exists. Returns 'true' if it does, 'false' otherwise.

  1. Result: No description provided.

  1. IsArmstrong: No description provided.

Package avl is a Adelson-Velskii and Landis tree implemnation avl is self-balancing tree, i.e for all node in a tree, height difference between its left and right child will not exceed 1 more information :

  1. Delete: Delete : remove given key from the tree
  2. Get: Get : return node with given key
  3. Insert: Insert a new item
  4. NewTree: NewTree create a new AVL tree

  1. Node: No description provided.

Package binary describes algorithms that use binary operations for different calculations.

  1. Abs: Abs returns absolute value using binary operation Principle of operation: 1) Get the mask by right shift by the base 2) Base is the size of an integer variable in bits, for example, for int32 it will be 32, for int64 it will be 64 3) For negative numbers, above step sets mask as 1 1 1 1 1 1 1 1 and 0 0 0 0 0 0 0 0 for positive numbers. 4) Add the mask to the given number. 5) XOR of mask + n and mask gives the absolute value.
  2. BitCounter: BitCounter - The function returns the number of set bits for an unsigned integer number
  3. IsPowerOfTwo: IsPowerOfTwo This function uses the fact that powers of 2 are represented like 10...0 in binary, and numbers one less than the power of 2 are represented like 11...1. Therefore, using the and function: 10...0 & 01...1 00...0 -> 0 This is also true for 0, which is not a power of 2, for which we have to add and extra condition.
  4. IsPowerOfTwoLeftShift: IsPowerOfTwoLeftShift This function takes advantage of the fact that left shifting a number by 1 is equivalent to multiplying by 2. For example, binary 00000001 when shifted by 3 becomes 00001000, which in decimal system is 8 or = 2 * 2 * 2
  5. LogBase2: LogBase2 Finding the exponent of n = 2**x using bitwise operations (logarithm in base 2 of n) See more
  6. MeanUsingAndXor: MeanUsingAndXor This function finds arithmetic mean using "AND" and "XOR" operations
  7. MeanUsingRightShift: MeanUsingRightShift This function finds arithmetic mean using right shift
  8. ReverseBits: ReverseBits This function initialized the result by 0 (all bits 0) and process the given number starting from its least significant bit. If the current bit is 1, set the corresponding most significant bit in the result and finally move on to the next bit in the input number. Repeat this till all its bits are processed.
  9. SequenceGrayCode: SequenceGrayCode The function generates an "Gray code" sequence of length n
  10. Sqrt: No description provided.
  11. XorSearchMissingNumber: XorSearchMissingNumber This function finds a missing number in a sequence

  1. AccessNodesByLayer: AccessNodesByLayer Function that access nodes layer by layer instead of printing the results as one line.
  2. BstDelete: BstDelete removes the node
  3. InOrder: Travers the tree in the following order left --> root --> right
  4. InOrderSuccessor: InOrderSuccessor Goes to the left
  5. Insert: Insert a value in the BSTree
  6. LevelOrder: No description provided.
  7. Max: Max Function that returns max of two numbers - possibly already declared.
  8. NewNode: NewNode Returns a new pointer to an empty Node
  9. PostOrder: Travers the tree in the following order left --> right --> root
  10. PreOrder: Travers the tree in the following order root --> left --> right

  1. BSTree: No description provided.

  2. Node: No description provided.

Package caesar is the shift cipher ref:

  1. Decrypt: Decrypt decrypts by left shift of "key" each character of "input"
  2. Encrypt: Encrypt encrypts by right shift of "key" each character of "input"

  1. CatalanNumber: CatalanNumber This function returns the nth Catalan number

Package checksum describes algorithms for finding various checksums

  1. CRC8: CRC8 calculates CRC8 checksum of the given data.
  2. Luhn: Luhn validates the provided data using the Luhn algorithm.

  1. CRCModel: No description provided.

Package coloring provides implementation of different graph coloring algorithms, e.g. coloring using BFS, using Backtracking, using greedy approach. Author(s): Shivam

  1. BipartiteCheck: basically tries to color the graph in two colors if each edge connects 2 differently colored nodes the graph can be considered bipartite

  1. Graph: No description provided.

Package combination ...

  1. Start: Start ...

  1. Combinations: No description provided.

Package conversion is a package of implementations which converts one data structure to another.

  1. Base64Decode: Base64Decode decodes the received input base64 string into a byte slice. The implementation follows the RFC4648 standard, which is documented at
  2. Base64Encode: Base64Encode encodes the received input bytes slice into a base64 string. The implementation follows the RFC4648 standard, which is documented at
  3. BinaryToDecimal: BinaryToDecimal() function that will take Binary number as string, and return it's Decimal equivalent as integer.
  4. DecimalToBinary: DecimalToBinary() function that will take Decimal number as int, and return it's Binary equivalent as string.
  5. FuzzBase64Encode: No description provided.
  6. HEXToRGB: HEXToRGB splits an RGB input (e.g. a color in hex format; 0x) into the individual components: red, green and blue
  7. IntToRoman: IntToRoman converts an integer value to a roman numeral string. An error is returned if the integer is not between 1 and 3999.
  8. RGBToHEX: RGBToHEX does exactly the opposite of HEXToRGB: it combines the three components red, green and blue to an RGB value, which can be converted to e.g. Hex
  9. Reverse: Reverse() function that will take string, and returns the reverse of that string.
  10. RomanToInteger: RomanToInteger converts a roman numeral string to an integer. Roman numerals for numbers outside the range 1 to 3,999 will return an error. Nil or empty string return 0 with no error thrown.

Package diffiehellman implements Deffie Hellman Key Exchange Algorithm for more information watch :

  1. GenerateMutualKey: GenerateMutualKey : generates a mutual key that can be used by only alice and bob mutualKey = (shareKey^prvKey)%primeNumber
  2. GenerateShareKey: GenerateShareKey : generates a key using client private key , generator and primeNumber this key can be made public shareKey = (g^key)%primeNumber

Package dynamic is a package of certain implementations of dynamically run algorithms.

  1. Abbreviation: Returns true if it is possible to make a equals b (if b is an abbreviation of a), returns false otherwise
  2. Bin2: Bin2 function
  3. CoinChange: CoinChange finds the number of possible combinations of coins of different values which can get to the target amount.
  4. CutRodDp: CutRodDp solve the same problem using dynamic programming
  5. CutRodRec: CutRodRec solve the problem recursively: initial approach
  6. EditDistanceDP: EditDistanceDP is an optimised implementation which builds on the ideas of the recursive implementation. We use dynamic programming to compute the DP table where dp[i][j] denotes the edit distance value of first[0..i-1] and second[0..j-1]. Time complexity is O(m * n) where m and n are lengths of the strings, first and second respectively.
  7. EditDistanceRecursive: EditDistanceRecursive is a naive implementation with exponential time complexity.
  8. IsSubsetSum: No description provided.
  9. Knapsack: Knapsack solves knapsack problem return maxProfit
  10. LongestCommonSubsequence: LongestCommonSubsequence function
  11. LongestIncreasingSubsequence: LongestIncreasingSubsequence returns the longest increasing subsequence where all elements of the subsequence are sorted in increasing order
  12. LongestIncreasingSubsequenceGreedy: LongestIncreasingSubsequenceGreedy is a function to find the longest increasing subsequence in a given array using a greedy approach. The dynamic programming approach is implemented alongside this one. Worst Case Time Complexity: O(nlogn) Auxiliary Space: O(n), where n is the length of the array(slice). Reference:
  13. LpsDp: LpsDp function
  14. LpsRec: LpsRec function
  15. MatrixChainDp: MatrixChainDp function
  16. MatrixChainRec: MatrixChainRec function
  17. Max: Max function - possible duplicate
  18. NthCatalanNumber: NthCatalan returns the n-th Catalan Number Complexity: O(n²)
  19. NthFibonacci: NthFibonacci returns the nth Fibonacci Number

Package dynamicarray A dynamic array is quite similar to a regular array, but its Size is modifiable during program runtime, very similar to how a slice in Go works. The implementation is for educational purposes and explains how one might go about implementing their own version of slices. For more details check out those links below here: GeeksForGeeks article : Go blog: Go blog: authors Wesllhey Holanda, Milad see dynamicarray.go, dynamicarray_test.go

  1. DynamicArray: No description provided.

Package factorial describes algorithms Factorials calculations.

  1. Iterative: Iterative returns the iteratively brute forced factorial of n
  2. Recursive: Recursive This function recursively computes the factorial of a number
  3. UsingTree: UsingTree This function finds the factorial of a number using a binary tree

  1. Formula: Formula This function calculates the n-th fibonacci number using the formula Attention! Tests for large values fall due to rounding error of floating point numbers, works well, only on small numbers
  2. Matrix: Matrix This function calculates the n-th fibonacci number using the matrix method. See

  1. Extended: Extended simple extended gcd
  2. ExtendedIterative: ExtendedIterative finds and returns gcd(a, b), x, y satisfying ax + by = gcd(a, b).
  3. ExtendedRecursive: ExtendedRecursive finds and returns gcd(a, b), x, y satisfying ax + by = gcd(a, b).
  4. Iterative: Iterative Faster iterative version of GcdRecursive without holding up too much of the stack
  5. Recursive: Recursive finds and returns the greatest common divisor of a given integer.
  6. TemplateBenchmarkExtendedGCD: No description provided.
  7. TemplateBenchmarkGCD: No description provided.
  8. TemplateTestExtendedGCD: No description provided.
  9. TemplateTestGCD: No description provided.

  1. GenerateParenthesis: No description provided.

Package genetic provides functions to work with strings using genetic algorithm. Author: D4rkia

  1. GeneticString: GeneticString generates PopultaionItem based on the imputed target string, and a set of possible runes to build a string with. In order to optimise string generation additional configurations can be provided with Conf instance. Empty instance of Conf (&Conf{}) can be provided, then default values would be set. Link to the same algorithm implemented in python:

  1. Conf: No description provided.

  2. PopulationItem: No description provided.

  3. Result: No description provided.

Package geometry contains geometric algorithms

  1. Distance: Distance calculates the shortest distance between two points.
  2. IsParallel: IsParallel checks if two lines are parallel or not.
  3. IsPerpendicular: IsPerpendicular checks if two lines are perpendicular or not.
  4. PointDistance: PointDistance calculates the distance of a given Point from a given line. The slice should contain the coefficiet of x, the coefficient of y and the constant in the respective order.
  5. Section: Section calculates the Point that divides a line in specific ratio. DO NOT specify the ratio in the form m:n, specify it as r, where r = m / n.
  6. Slope: Slope calculates the slope (gradient) of a line.
  7. YIntercept: YIntercept calculates the Y-Intercept of a line from a specific Point.

  1. Line: No description provided.

  2. Point: No description provided.

Package graph demonstrates Graph search algorithms reference:

  1. ArticulationPoint: ArticulationPoint is a function to identify articulation points in a graph. The function takes the graph as an argument and returns a boolean slice which indicates whether a vertex is an articulation point or not. Worst Case Time Complexity: O(|V| + |E|) Auxiliary Space: O(|V|) reference: and
  2. BreadthFirstSearch: BreadthFirstSearch is an algorithm for traversing and searching graph data structures. It starts at an arbitrary node of a graph, and explores all of the neighbor nodes at the present depth prior to moving on to the nodes at the next depth level. Worst-case performance O(|V|+|E|)=O(b^{d})}O(|V|+|E|)=O(b^{d}) Worst-case space complexity O(|V|)=O(b^{d})}O(|V|)=O(b^{d}) reference:
  3. DepthFirstSearch: No description provided.
  4. DepthFirstSearchHelper: No description provided.
  5. FloydWarshall: FloydWarshall Returns all pair's shortest path using Floyd Warshall algorithm
  6. GetIdx: No description provided.
  7. KruskalMST: KruskalMST will return a minimum spanning tree along with its total cost to using Kruskal's algorithm. Time complexity is O(m * log (n)) where m is the number of edges in the graph and n is number of nodes in it.
  8. LowestCommonAncestor: For each node, we will precompute its ancestor above him, its ancestor two nodes above, its ancestor four nodes above, etc. Let's call jump[j][u] is the 2^j-th ancestor above the node u with u in range [0, numbersVertex), j in range [0,MAXLOG). These information allow us to jump from any node to any ancestor above it in O(MAXLOG) time.
  9. New: Constructor functions for graphs (undirected by default)
  10. NewDSU: NewDSU will return an initialised DSU using the value of n which will be treated as the number of elements out of which the DSU is being made
  11. NewTree: No description provided.
  12. NotExist: No description provided.
  13. Topological: Assumes that graph given is valid and possible to get a topo ordering. constraints are array of []int{a, b}, representing an edge going from a to b

  1. DisjointSetUnion: No description provided.

  2. DisjointSetUnionElement: No description provided.

  3. Edge: No description provided.

  4. Graph: No description provided.

  5. Item: No description provided.

  6. Query: No description provided.

  7. Tree: No description provided.

  8. TreeEdge: No description provided.

  9. WeightedGraph: No description provided.

  1. Make: Make creates a new HashMap instance with input size and capacity
  2. New: New return new HashMap instance

  1. HashMap: No description provided.

  1. Kmp: Kmp Function kmp performing the Knuth-Morris-Pratt algorithm. Prints whether the word/pattern was found and on what position in the text or not. m - current match in text, i - current character in w, c - amount of comparisons.

  1. Result: No description provided.

  1. Lcm: Lcm returns the lcm of two numbers using the fact that lcm(a,b) * gcd(a,b) = | a * b |

  1. Distance: Distance Function that gives Levenshtein Distance

Package linkedlist demonstates different implementations on linkedlists.

  1. JosephusProblem: This is a struct-based solution for Josephus problem.
  2. NewCyclic: Create new list.
  3. NewDoubly: No description provided.
  4. NewNode: Create new node.
  5. NewSingly: NewSingly returns a new instance of a linked list

  1. Cyclic: No description provided.

  2. Doubly: No description provided.

  3. Node: No description provided.

  4. Singly: No description provided.

  5. testCase: No description provided.

  1. LongestPalindrome: No description provided.

Package math is a package that contains mathematical algorithms and its different implementations.

  1. Abs: Abs returns absolute value
  2. Cos: Cos returns the cosine of the radian argument x. See more Based on the idea of Bhaskara approximation of cos(x)
  3. FindKthMax: FindKthMax returns the kth large element given an integer slice with nil error if found and returns -1 with error search.ErrNotFound if not found. NOTE: The nums slice gets mutated in the process.
  4. FindKthMin: FindKthMin returns kth small element given an integer slice with nil error if found and returns -1 with error search.ErrNotFound if not found. NOTE: The nums slice gets mutated in the process.
  5. IsPowOfTwoUseLog: IsPowOfTwoUseLog This function checks if a number is a power of two using the logarithm. The limiting degree can be from 0 to 63. See alternatives in the binary package.
  6. Phi: Phi is the Euler totient function. This function computes the number of numbers less then n that are coprime with n.
  7. Sin: Sin returns the sine of the radian argument x. See more

  1. Bitwise: Bitwise computes using bitwise operator the maximum of all the integer input and returns it
  2. Int: Int is a function which returns the maximum of all the integers provided as arguments.

Package maxsubarraysum is a package containing a solution to a common problem of finding max contiguous sum within a array of ints.

  1. MaxSubarraySum: MaxSubarraySum returns the maximum subarray sum

  1. Bitwise: Bitwise This function returns the minimum integer using bit operations
  2. Int: Int is a function which returns the minimum of all the integers provided as arguments.

  1. Exponentiation: Exponentiation returns base^exponent % mod
  2. Inverse: Inverse Modular function
  3. Multiply64BitInt: Multiply64BitInt Checking if the integer multiplication overflows

  1. MoserDeBruijnSequence: No description provided.

Package nested provides functions for testing strings proper brackets nesting.

  1. IsBalanced: IsBalanced returns true if provided input string is properly nested. Input is a sequence of brackets: '(', ')', '[', ']', '{', '}'. A sequence of brackets s is considered properly nested if any of the following conditions are true: - s is empty; - s has the form (U) or [U] or {U} where U is a properly nested string; - s has the form VW where V and W are properly nested strings. For example, the string "()()[()]" is properly nested but "[(()]" is not. Note Providing characters other then brackets would return false, despite brackets sequence in the string. Make sure to filter input before usage.

  1. IsPalindrome: No description provided.
  2. IsPalindromeRecursive: No description provided.

  1. IsPangram: No description provided.

  1. Parenthesis: parcounter will be 0 if all open parenthesis are closed correctly

  1. GenerateTriangle: GenerateTriangle This function generates a Pascal's triangle of n lines

Package password contains functions to help generate random passwords

  1. Generate: Generate returns a newly generated password

  1. GenerateElementSet: No description provided.
  2. Heaps: Heap's Algorithm for generating all permutations of n objects

spigotpi_test.go description: Test for Spigot Algorithm for the Digits of Pi author(s) red_byte see spigotpi.go

  1. MonteCarloPi: No description provided.
  2. MonteCarloPiConcurrent: MonteCarloPiConcurrent approximates the value of pi using the Monte Carlo method. Unlike the MonteCarloPi function (first version), this implementation uses goroutines and channels to parallelize the computation. More details on the Monte Carlo method available at More details on goroutines parallelization available at
  3. Spigot: No description provided.

Package polybius is encrypting method with polybius square ref:

  1. NewPolybius: NewPolybius returns a pointer to object of Polybius. If the size of "chars" is longer than "size", "chars" are truncated to "size".

  1. Polybius: No description provided.

  1. IterativePower: IterativePower is iterative O(logn) function for pow(x, y)
  2. RecursivePower: RecursivePower is recursive O(logn) function for pow(x, y)
  3. RecursivePower1: RecursivePower1 is recursive O(n) function for pow(x, y)
  4. UsingLog: No description provided.

  1. Factorize: Factorize is a function that computes the exponents of each prime in the prime factorization of n
  2. Generate: Generate returns a int slice of prime numbers up to the limit
  3. GenerateChannel: Generate generates the sequence of integers starting at 2 and sends it to the channel ch
  4. MillerRabinDeterministic: MillerRabinDeterministic is a Deterministic version of the Miller-Rabin test, which returns correct results for all valid int64 numbers.
  5. MillerRabinProbabilistic: MillerRabinProbabilistic is a probabilistic test for primality of an integer based of the algorithm devised by Miller and Rabin.
  6. MillerRandomTest: MillerRandomTest This is the intermediate step that repeats within the miller rabin primality test for better probabilitic chances of receiving the correct result with random witnesses.
  7. MillerTest: MillerTest tests whether num is a strong probable prime to a witness. Formally: a^d ≡ 1 (mod n) or a^(2^r * d) ≡ -1 (mod n), 0 <= r <= s
  8. MillerTestMultiple: MillerTestMultiple is like MillerTest but runs the test for multiple witnesses.
  9. OptimizedTrialDivision: OptimizedTrialDivision checks primality of an integer using an optimized trial division method. The optimizations include not checking divisibility by the even numbers and only checking up to the square root of the given number.
  10. Sieve: Sieve Sieving the numbers that are not prime from the channel - basically removing them from the channels
  11. TrialDivision: TrialDivision tests whether a number is prime by trying to divide it by the numbers less than it.

  1. Distance: Distance calculates the distance between to vectors with the Pythagoras theorem

  1. Vector: No description provided.

  1. BackQueue: BackQueue return the Back value
  2. DeQueue: DeQueue it will be removed the first value that added into the list
  3. EnQueue: EnQueue it will be added new value into our list
  4. FrontQueue: FrontQueue return the Front value
  5. IsEmptyQueue: IsEmptyQueue check our list is empty or not
  6. LenQueue: LenQueue will return the length of the queue list

  1. LQueue: No description provided.

  2. Node: No description provided.

  3. Queue: No description provided.

Package rsa shows a simple implementation of RSA algorithm

  1. Decrypt: Decrypt decrypts encrypted rune slice based on the RSA algorithm
  2. Encrypt: Encrypt encrypts based on the RSA algorithm - uses modular exponentitation in math directory

  1. BoyerMoore: Implementation of boyer moore string search O(l) where l=len(text)
  2. Naive: Implementation of naive string search O(n*m) where n=len(txt) and m=len(pattern)

  1. NewSegmentTree: No description provided.

  1. SegmentTree: No description provided.

package set implements a Set using a golang map. This implies that only the types that are accepted as valid map keys can be used as set elements. For instance, do not try to Add a slice, or the program will panic.

  1. New: New gives new set.

  1. Hash: Hash hashes the input message using the sha256 hashing function, and return a 32 byte array. The implementation follows the RGC6234 standard, which is documented at

Package sort a package for demonstrating sorting algorithms in Go

  1. Bubble: Bubble is a simple generic definition of Bubble sort algorithm.
  2. Comb: Comb is a simple sorting algorithm which is an improvement of the bubble sorting algorithm.
  3. Count: No description provided.
  4. Exchange: No description provided.
  5. HeapSort: No description provided.
  6. ImprovedSimple: ImprovedSimple is a improve SimpleSort by skipping an unnecessary comparison of the first and last. This improved version is more similar to implementation of insertion sort
  7. Insertion: No description provided.
  8. Merge: Merge Perform merge sort on a slice
  9. MergeIter: No description provided.
  10. Partition: No description provided.
  11. Pigeonhole: Pigeonhole sorts a slice using pigeonhole sorting algorithm.
  12. Quicksort: Quicksort Sorts the entire array
  13. QuicksortRange: QuicksortRange Sorts the specified range within the array
  14. RadixSort: No description provided.
  15. Selection: No description provided.
  16. Shell: No description provided.
  17. Simple: No description provided.

  1. Int:


    1. More: No description provided.
  2. MaxHeap: No description provided.

  1. Node: No description provided.

  2. SList: No description provided.

  3. Stack: No description provided.

  1. Decrypt: No description provided.
  2. Encrypt: No description provided.

  1. KeyMissingError: No description provided.

  2. NoTextToEncryptError: No description provided.

Package trie provides Trie data structures in golang. Wikipedia:

  1. NewNode: NewNode creates a new Trie node with initialized children map.

  1. Node: No description provided.

Package xor is an encryption algorithm that operates the exclusive disjunction(XOR) ref:

  1. Decrypt: Decrypt decrypts with Xor encryption
  2. Encrypt: Encrypt encrypts with Xor encryption after converting each character to byte The returned value might not be readable because there is no guarantee which is within the ASCII range If using other type such as string, []int, or some other types, add the statements for converting the type to []byte.

Open Source Agenda is not affiliated with "TheAlgorithms Go" Project. README Source: TheAlgorithms/Go

Open Source Agenda Badge

Open Source Agenda Rating