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