Determines whether the declarer won and by how much, given the declarer's card points, whether they took every trick, the complete scoring value, and the game type.
Usage
sk_score_game(
declarer_points,
game_type,
game_value,
declarer_won_all = FALSE,
declarer_lost_all = FALSE,
call = rlang::caller_env(),
schneider_announced = FALSE,
schwarz_announced = FALSE,
ouvert = FALSE
)Arguments
- declarer_points
Card points (0-120) the declarer collected in tricks, including the skat, even in a hand game.
- game_type
A single game-type string, one of
sk_game_types().- game_value
The complete value including achieved/announced levels (see
sk_game_value()). It is not a bid; overbidding is resolved externally.- declarer_won_all
Logical;
TRUEif the declarer took every trick (relevant for schwarz). Defaults toFALSE.- declarer_lost_all
Logical;
TRUEif the declarer took no trick at all. Defaults toFALSE. For null games this determines the outcome directly.- call
The calling environment, used for error reporting.
- schneider_announced, schwarz_announced
Logical; contract requirements. Schwarz announced implies schneider announced. Defaults to
FALSE.- ouvert
Logical; suit/grand ouvert requires every trick. Null ouvert retains the no-trick objective. Defaults to
FALSE.
Value
A list of class sk_result with elements:
won: logical, did the declarer win;schneider: logical, was schneider reached (declarer to 90 or defence held to 30);schwarz: logical, was schwarz reached (one side took every trick);game_value: integer, the complete scoring value;score: integer, points credited to the declarer – the game value if won, twice the negated game value if lost.
Details
The declarer needs 61 of the 120 card points to win a suit or grand game. Reaching 90 (or holding the defence to 30) is schneider; taking every trick is schwarz. Null games invert the goal: the declarer wins only by taking no trick at all, and neither schneider nor schwarz applies. A lost game costs twice the game value.
See also
sk_game_value() computes the scoring value; sk_play_game()
calls this on a played-out deal.
Examples
sk_score_game(72, "hearts", game_value = 20)
#> <sk_result>: declarer won
#> • Game value: 20
#> • Score: 20
#> • Schneider: no
#> • Schwarz: no
sk_score_game(59, "hearts", game_value = 20) # lost, did not reach 61
#> <sk_result>: declarer lost
#> • Game value: 20
#> • Score: -40
#> • Schneider: no
#> • Schwarz: no
sk_score_game(0, "null", game_value = 23, declarer_lost_all = TRUE)
#> <sk_result>: declarer won
#> • Game value: 23
#> • Score: 23
#> • Schneider: no
#> • Schwarz: no