Skip to main content

evaluateHandStrength

Encoded strength as a JavaScript number (uint64 bit layout: rank in high bits + five kicker nibbles). Comparable across spots; exact integer in IEEE double for sort/compare loops.

evaluateHandStrength(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 a single sortable scalar for hero vs board—range ordering, fast filters, or bot heuristics when Monte Carlo count is zero. For high-volume paths, prefer evaluateHandStrengthFast or pack cards once with poker-calculations/encode.

How to use

const strength = poker.evaluateHandStrength(['Ah', 'Kh'], ['Qh', 'Jh', 'Th']);
// number — use >, <, sort((a, b) => a - b)

const { packCards } = require('poker-calculations/encode');
const hole = packCards(['Ah', 'Kh']);
const board = packCards(['Qh', 'Jh', 'Th']);
const packed = poker.evaluateHandStrength(hole, board);

See also

evaluateHandStrengthFast · benchmarkEvaluatorThroughput · evaluateHandCategory · Card notation