Calculateur valeur bocal pièces

Ce calculateur de valeur de bocal de pièces accepte des comptages entiers non négatifs de pennies, nickels, dimes et quarters américains, de demi-dollars optionnels et de pièces d'un dollar optionnelles ; il multiplie chaque comptage par sa valeur faciale fixe en cents et renvoie un total précis en dollars plus une répartition des rouleaux bancaires afin que vous sachiez combien d'enveloppes standard vous pouvez remplir avant le dépôt. L'arithmétique en cents entiers évite la dérive en virgule flottante, les pièces restantes qui ne complètent pas un rouleau sont signalées à part, et les comptages négatifs ou fractionnaires invalides échouent avec invalid_input au lieu d'inventer de l'argent.

Comment sont définis la valeur faciale du bocal et les rouleaux bancaires

Les pièces en circulation des États-Unis ont des valeurs faciales fixes qui ne dépendent pas de l'année de frappe pour le calcul ordinaire de dépôt : un cent pour un penny, cinq pour un nickel, dix pour un dime, vingt-cinq pour un quarter, cinquante pour un demi-dollar et cent pour une pièce d'un dollar. Les banques et les credit unions préfèrent en général des pièces enveloppées dans des rouleaux de papier standard plutôt qu'un sac mélangé, et les tailles de rouleau de l'industrie sont également fixes : cinquante pennies par rouleau pour cinquante cents, quarante nickels pour deux dollars, cinquante dimes pour cinq dollars, quarante quarters pour dix dollars, vingt demi-dollars pour dix dollars et vingt-cinq pièces d'un dollar pour vingt-cinq dollars. En sommant sur les dénominations on obtient total_rolled_value et total_leftover_value pour décider si un autre passage au bocal ou à une machine à monnaies vaut le reste.

Contrat d'entrée, forme de la réponse et règles de validation

Les comptages au-dessus d'un milliard par dénomination sont rejetés comme hors plage pour un calculateur de bocal domestique. Associez le formulaire gratuit du navigateur pour un décompte en cuisine, puis appelez le même contrat depuis un script pour compter plusieurs bocaux ou générer des feuilles de dépôt. Envoyez un corps JSON avec quatre entiers non négatifs obligatoires—pennies, nickels, dimes et quarters—et optionnellement half_dollars et dollars, qui valent zéro s'ils sont omis. Chaque champ peut arriver comme entier JSON ou comme chaîne numérique entière ; des alias tels que penny, nickel, dime, quarter, half_dollar et dollar_coins sont acceptés par commodité. Comptages fractionnaires, négatifs, chaînes non numériques, NaN et Infinity échouent avec invalid_input en nommant le champ, car vous ne pouvez pas déposer une demi-pièce ni une pile négative. En cas de succès la réponse renvoie les six comptages, total_coins comme somme de toutes les pièces, total_cents comme total facial entier exact et total_value en dollars à deux décimales. Elle renvoie aussi full_rolls_total sur toutes les dénominations, total_rolled_value et total_leftover_value pour planifier le dépôt, un objet by_denom avec valeur et détail de rouleau par pièce, un résumé rolls indexé par dénomination, currency à USD, currency_decimals à deux, method à us_coin_jar_face_value_and_rolls et une courte chaîne formula qui réaffirme les identités de somme en cents et de plancher de rouleau. Exemple : cent pennies, quarante nickels, cinquante dimes et quarante quarters produisent un dollar plus deux plus cinq plus dix pour un total de dix-huit dollars, avec deux rouleaux de pennies plus un rouleau de nickels, dimes et quarters et aucune pièce restante. Les appels API réussis utilisent le solde prépayé KIT au prix de base publié de $0.002 par élément ; les échecs de validation ne sont pas facturés.

Où un calculateur de valeur de bocal de pièces est utile

Comme l'implémentation est un parse pur de tier A, chaque appel réussi coûte le prix de base publié de $0.002 sans jetons de modèle ni réseau sortant, et une validation échouée ne consomme pas le solde. Gardez des requêtes en comptages entiers simples, figez total_cents et total_value dans les tests, et vous obtenez une mathématique de dépôt reproductible sans tableurs qui dérivent quand quelqu'un multiplie des quarters par vingt-cinq cents dans la mauvaise cellule.