Skip to main content

evaluateHandStrengthFast

Same encoded strength number as evaluateHandStrength, using the in-house forge stack evaluator (poker-calculations-forge) on Monte Carlo and exact-equity hot paths.

evaluateHandStrengthFast(holeCards: CardInput, board: CardInput): number

CardInput is string[] or Uint8Array of deck ids 0..51. See Card notation.

Import

const poker = require('poker-calculations');

When to use

Use when you need the same sortable strength scalar as evaluateHandStrength but want the faster evaluator (for example high-volume sims or batch ranking). Compare paths with benchmarkEvaluatorThroughput on your hardware.

Combined hole and board must be at most 7 cards (standard Hold'em). With more than seven cards total, evaluateHandStrength still picks the best five from the full list; the fast path uses only the first seven (all hole cards, then board cards in order).

How to use

const fast = poker.evaluateHandStrengthFast(['Ah', 'Kh'], ['Qh', 'Jh', 'Th']);
const legacy = poker.evaluateHandStrength(['Ah', 'Kh'], ['Qh', 'Jh', 'Th']);
// fast === legacy for the same spot (same encoding)

See also

evaluateHandStrength · benchmarkEvaluatorThroughput · evaluateHandCategory · Card notation