[{"data":1,"prerenderedAt":1583},["ShallowReactive",2],{"doc-\u002Fstandard-library\u002Frandom.randint-function-explained":3},{"id":4,"title":5,"body":6,"description":1576,"extension":1577,"meta":1578,"navigation":71,"path":1579,"seo":1580,"stem":1581,"__hash__":1582},"content\u002Fstandard-library\u002Frandom.randint-function-explained.md","random.randint() Function Explained",{"type":7,"value":8,"toc":1548},"minimark",[9,13,21,39,44,124,139,143,148,171,174,188,196,200,203,227,230,251,254,303,306,315,328,332,341,344,383,386,402,413,416,447,450,470,473,490,494,497,559,562,577,580,583,597,601,606,655,659,709,716,720,780,783,787,794,938,940,965,975,979,983,989,992,1029,1032,1078,1088,1092,1095,1118,1126,1133,1137,1142,1145,1194,1197,1200,1248,1252,1254,1301,1308,1311,1357,1361,1370,1373,1407,1416,1420,1424,1427,1431,1434,1436,1476,1480,1485,1489,1497,1501,1507,1511,1544],[10,11,5],"h1",{"id":12},"randomrandint-function-explained",[14,15,16,20],"p",{},[17,18,19],"code",{},"random.randint()"," gives you a random whole number between two values.",[14,22,23,24,27,28,30,31,33,34,38],{},"It is part of Python’s ",[17,25,26],{},"random"," module, so you must import ",[17,29,26],{}," before using it. A very important detail is that ",[17,32,19],{}," includes ",[35,36,37],"strong",{},"both"," the start and end values.",[40,41,43],"h2",{"id":42},"quick-answer","Quick answer",[45,46,51],"pre",{"className":47,"code":48,"language":49,"meta":50,"style":50},"language-python shiki shiki-themes material-theme-lighter github-light github-dark","import random\n\nnumber = random.randint(1, 10)\nprint(number)\n","python","",[17,52,53,66,73,110],{"__ignoreMap":50},[54,55,58,62],"span",{"class":56,"line":57},"line",1,[54,59,61],{"class":60},"sVHd0","import",[54,63,65],{"class":64},"su5hD"," random\n",[54,67,69],{"class":56,"line":68},2,[54,70,72],{"emptyLinePlaceholder":71},true,"\n",[54,74,76,79,83,86,90,94,97,101,104,107],{"class":56,"line":75},3,[54,77,78],{"class":64},"number ",[54,80,82],{"class":81},"smGrS","=",[54,84,85],{"class":64}," random",[54,87,89],{"class":88},"sP7_E",".",[54,91,93],{"class":92},"slqww","randint",[54,95,96],{"class":88},"(",[54,98,100],{"class":99},"srdBf","1",[54,102,103],{"class":88},",",[54,105,106],{"class":99}," 10",[54,108,109],{"class":88},")\n",[54,111,113,117,119,122],{"class":56,"line":112},4,[54,114,116],{"class":115},"sptTA","print",[54,118,96],{"class":88},[54,120,121],{"class":92},"number",[54,123,109],{"class":88},[14,125,126,127,130,131,134,135,138],{},"Use ",[17,128,129],{},"random.randint(start, end)"," to get a random integer between ",[17,132,133],{},"start"," and ",[17,136,137],{},"end",", including both values.",[40,140,142],{"id":141},"what-randomrandint-does","What random.randint() does",[14,144,145,147],{},[17,146,19],{},":",[149,150,151,155,161,168],"ul",{},[152,153,154],"li",{},"Returns a random integer",[152,156,157,158,160],{},"Belongs to Python’s ",[17,159,26],{}," module",[152,162,163,164,167],{},"Requires ",[17,165,166],{},"import random"," first",[152,169,170],{},"Includes both the starting and ending numbers",[14,172,173],{},"This makes it useful when you need a random whole number for things like:",[149,175,176,179,182,185],{},[152,177,178],{},"Dice rolls",[152,180,181],{},"Guessing games",[152,183,184],{},"Simple test values",[152,186,187],{},"Random positions or indexes",[14,189,190,191,89],{},"If you want a broader introduction to random tools in Python, see the ",[192,193,195],"a",{"href":194},"\u002Fstandard-library\u002Fpython-random-module-overview","Python random module overview",[40,197,199],{"id":198},"basic-syntax","Basic syntax",[14,201,202],{},"The basic syntax is:",[45,204,206],{"className":47,"code":205,"language":49,"meta":50,"style":50},"random.randint(a, b)\n",[17,207,208],{"__ignoreMap":50},[54,209,210,212,214,216,218,220,222,225],{"class":56,"line":57},[54,211,26],{"class":64},[54,213,89],{"class":88},[54,215,93],{"class":92},[54,217,96],{"class":88},[54,219,192],{"class":92},[54,221,103],{"class":88},[54,223,224],{"class":92}," b",[54,226,109],{"class":88},[14,228,229],{},"Here:",[149,231,232,237,243],{},[152,233,234,236],{},[17,235,192],{}," is the smallest possible integer",[152,238,239,242],{},[17,240,241],{},"b"," is the largest possible integer",[152,244,245,246,248,249],{},"The result can be any whole number from ",[17,247,192],{}," to ",[17,250,241],{},[14,252,253],{},"Example:",[45,255,257],{"className":47,"code":256,"language":49,"meta":50,"style":50},"import random\n\nnumber = random.randint(5, 8)\nprint(number)\n",[17,258,259,265,269,293],{"__ignoreMap":50},[54,260,261,263],{"class":56,"line":57},[54,262,61],{"class":60},[54,264,65],{"class":64},[54,266,267],{"class":56,"line":68},[54,268,72],{"emptyLinePlaceholder":71},[54,270,271,273,275,277,279,281,283,286,288,291],{"class":56,"line":75},[54,272,78],{"class":64},[54,274,82],{"class":81},[54,276,85],{"class":64},[54,278,89],{"class":88},[54,280,93],{"class":92},[54,282,96],{"class":88},[54,284,285],{"class":99},"5",[54,287,103],{"class":88},[54,289,290],{"class":99}," 8",[54,292,109],{"class":88},[54,294,295,297,299,301],{"class":56,"line":112},[54,296,116],{"class":115},[54,298,96],{"class":88},[54,300,121],{"class":92},[54,302,109],{"class":88},[14,304,305],{},"Possible output:",[45,307,309],{"className":47,"code":308,"language":49,"meta":50,"style":50},"7\n",[17,310,311],{"__ignoreMap":50},[54,312,313],{"class":56,"line":57},[54,314,308],{"class":99},[14,316,317,318,320,321,324,325,89],{},"It could also print ",[17,319,285],{},", ",[17,322,323],{},"6",", or ",[17,326,327],{},"8",[40,329,331],{"id":330},"how-the-range-works","How the range works",[14,333,334,335,337,338,89],{},"The range used by ",[17,336,19],{}," is ",[35,339,340],{},"inclusive",[14,342,343],{},"That means:",[45,345,347],{"className":47,"code":346,"language":49,"meta":50,"style":50},"import random\n\nprint(random.randint(1, 3))\n",[17,348,349,355,359],{"__ignoreMap":50},[54,350,351,353],{"class":56,"line":57},[54,352,61],{"class":60},[54,354,65],{"class":64},[54,356,357],{"class":56,"line":68},[54,358,72],{"emptyLinePlaceholder":71},[54,360,361,363,365,367,369,371,373,375,377,380],{"class":56,"line":75},[54,362,116],{"class":115},[54,364,96],{"class":88},[54,366,26],{"class":92},[54,368,89],{"class":88},[54,370,93],{"class":92},[54,372,96],{"class":88},[54,374,100],{"class":99},[54,376,103],{"class":88},[54,378,379],{"class":99}," 3",[54,381,382],{"class":88},"))\n",[14,384,385],{},"Can return:",[149,387,388,392,397],{},[152,389,390],{},[17,391,100],{},[152,393,394],{},[17,395,396],{},"2",[152,398,399],{},[17,400,401],{},"3",[14,403,404,405,412],{},"This is different from Python’s ",[192,406,408,411],{"href":407},"\u002Freference\u002Fpython-range-function-explained",[17,409,410],{},"range()"," function",", where the stop value is not included.",[14,414,415],{},"For example:",[45,417,419],{"className":47,"code":418,"language":49,"meta":50,"style":50},"print(list(range(1, 3)))\n",[17,420,421],{"__ignoreMap":50},[54,422,423,425,427,431,433,436,438,440,442,444],{"class":56,"line":57},[54,424,116],{"class":115},[54,426,96],{"class":88},[54,428,430],{"class":429},"sZMiF","list",[54,432,96],{"class":88},[54,434,435],{"class":115},"range",[54,437,96],{"class":88},[54,439,100],{"class":99},[54,441,103],{"class":88},[54,443,379],{"class":99},[54,445,446],{"class":88},")))\n",[14,448,449],{},"Output:",[45,451,453],{"className":47,"code":452,"language":49,"meta":50,"style":50},"[1, 2]\n",[17,454,455],{"__ignoreMap":50},[54,456,457,460,462,464,467],{"class":56,"line":57},[54,458,459],{"class":88},"[",[54,461,100],{"class":99},[54,463,103],{"class":88},[54,465,466],{"class":99}," 2",[54,468,469],{"class":88},"]\n",[14,471,472],{},"This difference causes a lot of beginner mistakes:",[149,474,475,482],{},[152,476,477,33,480],{},[17,478,479],{},"random.randint(1, 3)",[17,481,401],{},[152,483,484,487,488],{},[17,485,486],{},"range(1, 3)"," does not include ",[17,489,401],{},[40,491,493],{"id":492},"simple-example","Simple example",[14,495,496],{},"Here is a simple dice roll example:",[45,498,500],{"className":47,"code":499,"language":49,"meta":50,"style":50},"import random\n\nroll = random.randint(1, 6)\nprint(\"You rolled:\", roll)\n",[17,501,502,508,512,536],{"__ignoreMap":50},[54,503,504,506],{"class":56,"line":57},[54,505,61],{"class":60},[54,507,65],{"class":64},[54,509,510],{"class":56,"line":68},[54,511,72],{"emptyLinePlaceholder":71},[54,513,514,517,519,521,523,525,527,529,531,534],{"class":56,"line":75},[54,515,516],{"class":64},"roll ",[54,518,82],{"class":81},[54,520,85],{"class":64},[54,522,89],{"class":88},[54,524,93],{"class":92},[54,526,96],{"class":88},[54,528,100],{"class":99},[54,530,103],{"class":88},[54,532,533],{"class":99}," 6",[54,535,109],{"class":88},[54,537,538,540,542,546,550,552,554,557],{"class":56,"line":112},[54,539,116],{"class":115},[54,541,96],{"class":88},[54,543,545],{"class":544},"sjJ54","\"",[54,547,549],{"class":548},"s_sjI","You rolled:",[54,551,545],{"class":544},[54,553,103],{"class":88},[54,555,556],{"class":92}," roll",[54,558,109],{"class":88},[14,560,561],{},"Example output:",[45,563,565],{"className":47,"code":564,"language":49,"meta":50,"style":50},"You rolled: 4\n",[17,566,567],{"__ignoreMap":50},[54,568,569,572,574],{"class":56,"line":57},[54,570,571],{"class":64},"You rolled",[54,573,147],{"class":88},[54,575,576],{"class":99}," 4\n",[14,578,579],{},"The output changes each time you run the program.",[14,581,582],{},"This is a common beginner use case because it matches real-world rules:",[149,584,585,588,591],{},[152,586,587],{},"A die has values from 1 to 6",[152,589,590],{},"Both 1 and 6 should be possible",[152,592,593,596],{},[17,594,595],{},"randint(1, 6)"," fits perfectly",[40,598,600],{"id":599},"using-randomrandint-in-real-tasks","Using random.randint() in real tasks",[602,603,605],"h3",{"id":604},"pick-a-random-dice-roll","Pick a random dice roll",[45,607,609],{"className":47,"code":608,"language":49,"meta":50,"style":50},"import random\n\ndice = random.randint(1, 6)\nprint(dice)\n",[17,610,611,617,621,644],{"__ignoreMap":50},[54,612,613,615],{"class":56,"line":57},[54,614,61],{"class":60},[54,616,65],{"class":64},[54,618,619],{"class":56,"line":68},[54,620,72],{"emptyLinePlaceholder":71},[54,622,623,626,628,630,632,634,636,638,640,642],{"class":56,"line":75},[54,624,625],{"class":64},"dice ",[54,627,82],{"class":81},[54,629,85],{"class":64},[54,631,89],{"class":88},[54,633,93],{"class":92},[54,635,96],{"class":88},[54,637,100],{"class":99},[54,639,103],{"class":88},[54,641,533],{"class":99},[54,643,109],{"class":88},[54,645,646,648,650,653],{"class":56,"line":112},[54,647,116],{"class":115},[54,649,96],{"class":88},[54,651,652],{"class":92},"dice",[54,654,109],{"class":88},[602,656,658],{"id":657},"choose-a-random-number-for-a-guessing-game","Choose a random number for a guessing game",[45,660,662],{"className":47,"code":661,"language":49,"meta":50,"style":50},"import random\n\nsecret_number = random.randint(1, 20)\nprint(secret_number)\n",[17,663,664,670,674,698],{"__ignoreMap":50},[54,665,666,668],{"class":56,"line":57},[54,667,61],{"class":60},[54,669,65],{"class":64},[54,671,672],{"class":56,"line":68},[54,673,72],{"emptyLinePlaceholder":71},[54,675,676,679,681,683,685,687,689,691,693,696],{"class":56,"line":75},[54,677,678],{"class":64},"secret_number ",[54,680,82],{"class":81},[54,682,85],{"class":64},[54,684,89],{"class":88},[54,686,93],{"class":92},[54,688,96],{"class":88},[54,690,100],{"class":99},[54,692,103],{"class":88},[54,694,695],{"class":99}," 20",[54,697,109],{"class":88},[54,699,700,702,704,707],{"class":56,"line":112},[54,701,116],{"class":115},[54,703,96],{"class":88},[54,705,706],{"class":92},"secret_number",[54,708,109],{"class":88},[14,710,711,712,89],{},"You can see this idea in a full beginner project: ",[192,713,715],{"href":714},"\u002Fexamples\u002Fpython-number-guessing-game-example","Python number guessing game example",[602,717,719],{"id":718},"create-simple-test-data","Create simple test data",[45,721,723],{"className":47,"code":722,"language":49,"meta":50,"style":50},"import random\n\nscore = random.randint(0, 100)\nprint(\"Test score:\", score)\n",[17,724,725,731,735,760],{"__ignoreMap":50},[54,726,727,729],{"class":56,"line":57},[54,728,61],{"class":60},[54,730,65],{"class":64},[54,732,733],{"class":56,"line":68},[54,734,72],{"emptyLinePlaceholder":71},[54,736,737,740,742,744,746,748,750,753,755,758],{"class":56,"line":75},[54,738,739],{"class":64},"score ",[54,741,82],{"class":81},[54,743,85],{"class":64},[54,745,89],{"class":88},[54,747,93],{"class":92},[54,749,96],{"class":88},[54,751,752],{"class":99},"0",[54,754,103],{"class":88},[54,756,757],{"class":99}," 100",[54,759,109],{"class":88},[54,761,762,764,766,768,771,773,775,778],{"class":56,"line":112},[54,763,116],{"class":115},[54,765,96],{"class":88},[54,767,545],{"class":544},[54,769,770],{"class":548},"Test score:",[54,772,545],{"class":544},[54,774,103],{"class":88},[54,776,777],{"class":92}," score",[54,779,109],{"class":88},[14,781,782],{},"This is useful when you want sample numbers while practicing.",[602,784,786],{"id":785},"generate-a-random-index-carefully","Generate a random index carefully",[14,788,789,790,793],{},"You can use ",[17,791,792],{},"randint()"," to choose an index, but you must be careful to stay inside the valid range.",[45,795,797],{"className":47,"code":796,"language":49,"meta":50,"style":50},"import random\n\nnames = [\"Ana\", \"Ben\", \"Cara\"]\nindex = random.randint(0, len(names) - 1)\n\nprint(\"Index:\", index)\nprint(\"Chosen name:\", names[index])\n",[17,798,799,805,809,847,885,890,911],{"__ignoreMap":50},[54,800,801,803],{"class":56,"line":57},[54,802,61],{"class":60},[54,804,65],{"class":64},[54,806,807],{"class":56,"line":68},[54,808,72],{"emptyLinePlaceholder":71},[54,810,811,814,816,819,821,824,826,828,831,834,836,838,840,843,845],{"class":56,"line":75},[54,812,813],{"class":64},"names ",[54,815,82],{"class":81},[54,817,818],{"class":88}," [",[54,820,545],{"class":544},[54,822,823],{"class":548},"Ana",[54,825,545],{"class":544},[54,827,103],{"class":88},[54,829,830],{"class":544}," \"",[54,832,833],{"class":548},"Ben",[54,835,545],{"class":544},[54,837,103],{"class":88},[54,839,830],{"class":544},[54,841,842],{"class":548},"Cara",[54,844,545],{"class":544},[54,846,469],{"class":88},[54,848,849,852,854,856,858,860,862,864,866,869,871,874,877,880,883],{"class":56,"line":112},[54,850,851],{"class":64},"index ",[54,853,82],{"class":81},[54,855,85],{"class":64},[54,857,89],{"class":88},[54,859,93],{"class":92},[54,861,96],{"class":88},[54,863,752],{"class":99},[54,865,103],{"class":88},[54,867,868],{"class":115}," len",[54,870,96],{"class":88},[54,872,873],{"class":92},"names",[54,875,876],{"class":88},")",[54,878,879],{"class":81}," -",[54,881,882],{"class":99}," 1",[54,884,109],{"class":88},[54,886,888],{"class":56,"line":887},5,[54,889,72],{"emptyLinePlaceholder":71},[54,891,893,895,897,899,902,904,906,909],{"class":56,"line":892},6,[54,894,116],{"class":115},[54,896,96],{"class":88},[54,898,545],{"class":544},[54,900,901],{"class":548},"Index:",[54,903,545],{"class":544},[54,905,103],{"class":88},[54,907,908],{"class":92}," index",[54,910,109],{"class":88},[54,912,914,916,918,920,923,925,927,930,932,935],{"class":56,"line":913},7,[54,915,116],{"class":115},[54,917,96],{"class":88},[54,919,545],{"class":544},[54,921,922],{"class":548},"Chosen name:",[54,924,545],{"class":544},[54,926,103],{"class":88},[54,928,929],{"class":92}," names",[54,931,459],{"class":88},[54,933,934],{"class":92},"index",[54,936,937],{"class":88},"])\n",[14,939,561],{},[45,941,943],{"className":47,"code":942,"language":49,"meta":50,"style":50},"Index: 2\nChosen name: Cara\n",[17,944,945,955],{"__ignoreMap":50},[54,946,947,950,952],{"class":56,"line":57},[54,948,949],{"class":64},"Index",[54,951,147],{"class":88},[54,953,954],{"class":99}," 2\n",[54,956,957,960,962],{"class":56,"line":68},[54,958,959],{"class":64},"Chosen name",[54,961,147],{"class":88},[54,963,964],{"class":64}," Cara\n",[14,966,967,968,974],{},"If you want a random item from a list, ",[192,969,971],{"href":970},"\u002Fstandard-library\u002Frandom.choice-function-explained",[17,972,973],{},"random.choice()"," is often simpler than generating an index yourself.",[40,976,978],{"id":977},"common-mistakes","Common mistakes",[602,980,982],{"id":981},"forgetting-to-import-the-random-module","Forgetting to import the random module",[14,984,985,986,89],{},"This causes a ",[17,987,988],{},"NameError",[14,990,991],{},"Wrong:",[45,993,995],{"className":47,"code":994,"language":49,"meta":50,"style":50},"number = random.randint(1, 10)\nprint(number)\n",[17,996,997,1019],{"__ignoreMap":50},[54,998,999,1001,1003,1005,1007,1009,1011,1013,1015,1017],{"class":56,"line":57},[54,1000,78],{"class":64},[54,1002,82],{"class":81},[54,1004,85],{"class":64},[54,1006,89],{"class":88},[54,1008,93],{"class":92},[54,1010,96],{"class":88},[54,1012,100],{"class":99},[54,1014,103],{"class":88},[54,1016,106],{"class":99},[54,1018,109],{"class":88},[54,1020,1021,1023,1025,1027],{"class":56,"line":68},[54,1022,116],{"class":115},[54,1024,96],{"class":88},[54,1026,121],{"class":92},[54,1028,109],{"class":88},[14,1030,1031],{},"Fix:",[45,1033,1034],{"className":47,"code":48,"language":49,"meta":50,"style":50},[17,1035,1036,1042,1046,1068],{"__ignoreMap":50},[54,1037,1038,1040],{"class":56,"line":57},[54,1039,61],{"class":60},[54,1041,65],{"class":64},[54,1043,1044],{"class":56,"line":68},[54,1045,72],{"emptyLinePlaceholder":71},[54,1047,1048,1050,1052,1054,1056,1058,1060,1062,1064,1066],{"class":56,"line":75},[54,1049,78],{"class":64},[54,1051,82],{"class":81},[54,1053,85],{"class":64},[54,1055,89],{"class":88},[54,1057,93],{"class":92},[54,1059,96],{"class":88},[54,1061,100],{"class":99},[54,1063,103],{"class":88},[54,1065,106],{"class":99},[54,1067,109],{"class":88},[54,1069,1070,1072,1074,1076],{"class":56,"line":112},[54,1071,116],{"class":115},[54,1073,96],{"class":88},[54,1075,121],{"class":92},[54,1077,109],{"class":88},[14,1079,1080,1081,89],{},"If you run into this, see ",[192,1082,1084,1085],{"href":1083},"\u002Ferrors\u002Fnameerror-name-is-not-defined-fix","how to fix ",[17,1086,1087],{},"NameError: name is not defined",[602,1089,1091],{"id":1090},"assuming-the-end-value-is-excluded","Assuming the end value is excluded",[14,1093,1094],{},"Some beginners think this:",[45,1096,1098],{"className":47,"code":1097,"language":49,"meta":50,"style":50},"random.randint(1, 10)\n",[17,1099,1100],{"__ignoreMap":50},[54,1101,1102,1104,1106,1108,1110,1112,1114,1116],{"class":56,"line":57},[54,1103,26],{"class":64},[54,1105,89],{"class":88},[54,1107,93],{"class":92},[54,1109,96],{"class":88},[54,1111,100],{"class":99},[54,1113,103],{"class":88},[54,1115,106],{"class":99},[54,1117,109],{"class":88},[14,1119,1120,1121,248,1123,89],{},"returns numbers from ",[17,1122,100],{},[17,1124,1125],{},"9",[14,1127,1128,1129,1132],{},"That is incorrect. It can return ",[17,1130,1131],{},"10"," too.",[602,1134,1136],{"id":1135},"passing-non-integer-values","Passing non-integer values",[14,1138,1139,1141],{},[17,1140,792],{}," is meant for integers.",[14,1143,1144],{},"Problem example:",[45,1146,1148],{"className":47,"code":1147,"language":49,"meta":50,"style":50},"import random\n\nnumber = random.randint(1.5, 5.5)\nprint(number)\n",[17,1149,1150,1156,1160,1184],{"__ignoreMap":50},[54,1151,1152,1154],{"class":56,"line":57},[54,1153,61],{"class":60},[54,1155,65],{"class":64},[54,1157,1158],{"class":56,"line":68},[54,1159,72],{"emptyLinePlaceholder":71},[54,1161,1162,1164,1166,1168,1170,1172,1174,1177,1179,1182],{"class":56,"line":75},[54,1163,78],{"class":64},[54,1165,82],{"class":81},[54,1167,85],{"class":64},[54,1169,89],{"class":88},[54,1171,93],{"class":92},[54,1173,96],{"class":88},[54,1175,1176],{"class":99},"1.5",[54,1178,103],{"class":88},[54,1180,1181],{"class":99}," 5.5",[54,1183,109],{"class":88},[54,1185,1186,1188,1190,1192],{"class":56,"line":112},[54,1187,116],{"class":115},[54,1189,96],{"class":88},[54,1191,121],{"class":92},[54,1193,109],{"class":88},[14,1195,1196],{},"This can raise an error because the arguments should be whole numbers.",[14,1198,1199],{},"Use integers instead:",[45,1201,1203],{"className":47,"code":1202,"language":49,"meta":50,"style":50},"import random\n\nnumber = random.randint(1, 5)\nprint(number)\n",[17,1204,1205,1211,1215,1238],{"__ignoreMap":50},[54,1206,1207,1209],{"class":56,"line":57},[54,1208,61],{"class":60},[54,1210,65],{"class":64},[54,1212,1213],{"class":56,"line":68},[54,1214,72],{"emptyLinePlaceholder":71},[54,1216,1217,1219,1221,1223,1225,1227,1229,1231,1233,1236],{"class":56,"line":75},[54,1218,78],{"class":64},[54,1220,82],{"class":81},[54,1222,85],{"class":64},[54,1224,89],{"class":88},[54,1226,93],{"class":92},[54,1228,96],{"class":88},[54,1230,100],{"class":99},[54,1232,103],{"class":88},[54,1234,1235],{"class":99}," 5",[54,1237,109],{"class":88},[54,1239,1240,1242,1244,1246],{"class":56,"line":112},[54,1241,116],{"class":115},[54,1243,96],{"class":88},[54,1245,121],{"class":92},[54,1247,109],{"class":88},[602,1249,1251],{"id":1250},"using-a-start-value-larger-than-the-end-value","Using a start value larger than the end value",[14,1253,1144],{},[45,1255,1257],{"className":47,"code":1256,"language":49,"meta":50,"style":50},"import random\n\nnumber = random.randint(10, 1)\nprint(number)\n",[17,1258,1259,1265,1269,1291],{"__ignoreMap":50},[54,1260,1261,1263],{"class":56,"line":57},[54,1262,61],{"class":60},[54,1264,65],{"class":64},[54,1266,1267],{"class":56,"line":68},[54,1268,72],{"emptyLinePlaceholder":71},[54,1270,1271,1273,1275,1277,1279,1281,1283,1285,1287,1289],{"class":56,"line":75},[54,1272,78],{"class":64},[54,1274,82],{"class":81},[54,1276,85],{"class":64},[54,1278,89],{"class":88},[54,1280,93],{"class":92},[54,1282,96],{"class":88},[54,1284,1131],{"class":99},[54,1286,103],{"class":88},[54,1288,882],{"class":99},[54,1290,109],{"class":88},[54,1292,1293,1295,1297,1299],{"class":56,"line":112},[54,1294,116],{"class":115},[54,1296,96],{"class":88},[54,1298,121],{"class":92},[54,1300,109],{"class":88},[14,1302,1303,1304,1307],{},"This can raise a ",[17,1305,1306],{},"ValueError"," because the lower value must come first.",[14,1309,1310],{},"Correct version:",[45,1312,1313],{"className":47,"code":48,"language":49,"meta":50,"style":50},[17,1314,1315,1321,1325,1347],{"__ignoreMap":50},[54,1316,1317,1319],{"class":56,"line":57},[54,1318,61],{"class":60},[54,1320,65],{"class":64},[54,1322,1323],{"class":56,"line":68},[54,1324,72],{"emptyLinePlaceholder":71},[54,1326,1327,1329,1331,1333,1335,1337,1339,1341,1343,1345],{"class":56,"line":75},[54,1328,78],{"class":64},[54,1330,82],{"class":81},[54,1332,85],{"class":64},[54,1334,89],{"class":88},[54,1336,93],{"class":92},[54,1338,96],{"class":88},[54,1340,100],{"class":99},[54,1342,103],{"class":88},[54,1344,106],{"class":99},[54,1346,109],{"class":88},[54,1348,1349,1351,1353,1355],{"class":56,"line":112},[54,1350,116],{"class":115},[54,1352,96],{"class":88},[54,1354,121],{"class":92},[54,1356,109],{"class":88},[40,1358,1360],{"id":1359},"when-to-use-randint-vs-other-random-functions","When to use randint() vs other random functions",[14,1362,126,1363,1365,1366,1369],{},[17,1364,19],{}," when you need a random ",[35,1367,1368],{},"whole number"," in an inclusive range.",[14,1371,1372],{},"Choose other functions when the task is different:",[149,1374,1375,1384,1391,1401],{},[152,1376,126,1377,1379,1380,248,1382],{},[17,1378,792],{}," for a random integer like ",[17,1381,100],{},[17,1383,323],{},[152,1385,126,1386,1390],{},[192,1387,1388],{"href":970},[17,1389,973],{}," for a random item from a list",[152,1392,126,1393,1396,1397],{},[17,1394,1395],{},"random.randrange()"," when you want behavior more like ",[192,1398,1399],{"href":407},[17,1400,410],{},[152,1402,1403,1404,1406],{},"Do not use ",[17,1405,792],{}," for passwords, tokens, or other security-sensitive code",[14,1408,1409,1410,1413,1414,89],{},"For security-related randomness, use the ",[17,1411,1412],{},"secrets"," module instead of ",[17,1415,26],{},[40,1417,1419],{"id":1418},"faq","FAQ",[602,1421,1423],{"id":1422},"does-randomrandint-include-the-last-number","Does random.randint() include the last number?",[14,1425,1426],{},"Yes. Both the start and end numbers are included.",[602,1428,1430],{"id":1429},"can-randomrandint-return-negative-numbers","Can random.randint() return negative numbers?",[14,1432,1433],{},"Yes. It can return any integer in the given inclusive range, including negative values.",[14,1435,253],{},[45,1437,1439],{"className":47,"code":1438,"language":49,"meta":50,"style":50},"import random\n\nprint(random.randint(-5, 5))\n",[17,1440,1441,1447,1451],{"__ignoreMap":50},[54,1442,1443,1445],{"class":56,"line":57},[54,1444,61],{"class":60},[54,1446,65],{"class":64},[54,1448,1449],{"class":56,"line":68},[54,1450,72],{"emptyLinePlaceholder":71},[54,1452,1453,1455,1457,1459,1461,1463,1465,1468,1470,1472,1474],{"class":56,"line":75},[54,1454,116],{"class":115},[54,1456,96],{"class":88},[54,1458,26],{"class":92},[54,1460,89],{"class":88},[54,1462,93],{"class":92},[54,1464,96],{"class":88},[54,1466,1467],{"class":81},"-",[54,1469,285],{"class":99},[54,1471,103],{"class":88},[54,1473,1235],{"class":99},[54,1475,382],{"class":88},[602,1477,1479],{"id":1478},"what-happens-if-i-use-decimal-numbers-with-randint","What happens if I use decimal numbers with randint()?",[14,1481,1482,1484],{},[17,1483,792],{}," is for integers. Non-integer values can cause an error.",[602,1486,1488],{"id":1487},"do-i-need-to-import-random-first","Do I need to import random first?",[14,1490,1491,1492,1494,1495,89],{},"Yes. Use ",[17,1493,166],{}," before calling ",[17,1496,19],{},[602,1498,1500],{"id":1499},"should-i-use-randomrandint-for-passwords-or-security-tokens","Should I use random.randint() for passwords or security tokens?",[14,1502,1503,1504,1506],{},"No. For security-related randomness, use the ",[17,1505,1412],{}," module instead.",[40,1508,1510],{"id":1509},"see-also","See also",[149,1512,1513,1517,1522,1527,1531,1537],{},[152,1514,1515],{},[192,1516,195],{"href":194},[152,1518,1519],{},[192,1520,1521],{"href":970},"random.choice() function explained",[152,1523,1524],{},[192,1525,1526],{"href":407},"Python range() function explained",[152,1528,1529],{},[192,1530,715],{"href":714},[152,1532,1533],{},[192,1534,1536],{"href":1535},"\u002Fexamples\u002Fpython-random-name-picker-example","Python random name picker example",[152,1538,1539],{},[192,1540,1541,1542],{"href":1083},"How to fix ",[17,1543,1087],{},[1545,1546,1547],"style",{},"html pre.shiki code .sVHd0, html code.shiki .sVHd0{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#D73A49;--shiki-default-font-style:inherit;--shiki-dark:#F97583;--shiki-dark-font-style:inherit}html pre.shiki code .su5hD, html code.shiki .su5hD{--shiki-light:#90A4AE;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .smGrS, html code.shiki .smGrS{--shiki-light:#39ADB5;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sP7_E, html code.shiki .sP7_E{--shiki-light:#39ADB5;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .slqww, html code.shiki .slqww{--shiki-light:#6182B8;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .srdBf, html code.shiki .srdBf{--shiki-light:#F76D47;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sptTA, html code.shiki .sptTA{--shiki-light:#6182B8;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sZMiF, html code.shiki .sZMiF{--shiki-light:#E2931D;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sjJ54, html code.shiki .sjJ54{--shiki-light:#39ADB5;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .s_sjI, html code.shiki .s_sjI{--shiki-light:#91B859;--shiki-default:#032F62;--shiki-dark:#9ECBFF}",{"title":50,"searchDepth":68,"depth":68,"links":1549},[1550,1551,1552,1553,1554,1555,1561,1567,1568,1575],{"id":42,"depth":68,"text":43},{"id":141,"depth":68,"text":142},{"id":198,"depth":68,"text":199},{"id":330,"depth":68,"text":331},{"id":492,"depth":68,"text":493},{"id":599,"depth":68,"text":600,"children":1556},[1557,1558,1559,1560],{"id":604,"depth":75,"text":605},{"id":657,"depth":75,"text":658},{"id":718,"depth":75,"text":719},{"id":785,"depth":75,"text":786},{"id":977,"depth":68,"text":978,"children":1562},[1563,1564,1565,1566],{"id":981,"depth":75,"text":982},{"id":1090,"depth":75,"text":1091},{"id":1135,"depth":75,"text":1136},{"id":1250,"depth":75,"text":1251},{"id":1359,"depth":68,"text":1360},{"id":1418,"depth":68,"text":1419,"children":1569},[1570,1571,1572,1573,1574],{"id":1422,"depth":75,"text":1423},{"id":1429,"depth":75,"text":1430},{"id":1478,"depth":75,"text":1479},{"id":1487,"depth":75,"text":1488},{"id":1499,"depth":75,"text":1500},{"id":1509,"depth":68,"text":1510},"Master random.randint function explained in our comprehensive Python beginner guide.","md",{},"\u002Fstandard-library\u002Frandom.randint-function-explained",{"title":5,"description":1576},"standard-library\u002Frandom.randint-function-explained","yMcPIVi-8loKqZzeVQtm_2k3jxbnxNHwjZN-tJX8coQ",1777585471167]