[{"data":1,"prerenderedAt":1733},["ShallowReactive",2],{"doc-\u002Freference\u002Fpython-tuple-function-explained":3},{"id":4,"title":5,"body":6,"description":1726,"extension":1727,"meta":1728,"navigation":122,"path":1729,"seo":1730,"stem":1731,"__hash__":1732},"content\u002Freference\u002Fpython-tuple-function-explained.md","Python tuple() Function Explained",{"type":7,"value":8,"toc":1696},"minimark",[9,13,22,25,40,46,51,155,158,202,208,212,217,220,231,245,249,252,275,278,303,306,310,316,361,363,386,389,403,407,412,415,471,473,494,501,505,508,558,560,595,610,614,623,662,664,696,700,703,760,762,783,790,794,800,877,880,905,909,912,918,997,999,1061,1064,1077,1084,1088,1093,1107,1110,1149,1151,1168,1171,1184,1188,1194,1205,1211,1226,1229,1232,1236,1239,1243,1246,1260,1263,1294,1301,1305,1308,1328,1331,1384,1390,1408,1411,1444,1448,1450,1504,1507,1532,1535,1558,1562,1568,1571,1608,1611,1617,1621,1625,1628,1632,1638,1642,1645,1649,1652,1656,1661,1665,1692],[10,11,5],"h1",{"id":12},"python-tuple-function-explained",[14,15,16,17,21],"p",{},"The built-in ",[18,19,20],"code",{},"tuple()"," function creates a tuple in Python.",[14,23,24],{},"You can use it in two main ways:",[26,27,28,34],"ul",{},[29,30,31,33],"li",{},[18,32,20],{}," creates an empty tuple",[29,35,36,39],{},[18,37,38],{},"tuple(iterable)"," converts an iterable into a tuple",[14,41,42,43,45],{},"This is useful when you want a fixed, immutable sequence of values. Beginners often use ",[18,44,20],{}," to convert a list, string, range, or other iterable into a tuple.",[47,48,50],"h2",{"id":49},"quick-example","Quick example",[52,53,58],"pre",{"className":54,"code":55,"language":56,"meta":57,"style":57},"language-python shiki shiki-themes material-theme-lighter github-light github-dark","numbers = [1, 2, 3]\nresult = tuple(numbers)\n\nprint(result)\nprint(type(result))\n","python","",[18,59,60,95,117,124,138],{"__ignoreMap":57},[61,62,65,69,73,77,81,84,87,89,92],"span",{"class":63,"line":64},"line",1,[61,66,68],{"class":67},"su5hD","numbers ",[61,70,72],{"class":71},"smGrS","=",[61,74,76],{"class":75},"sP7_E"," [",[61,78,80],{"class":79},"srdBf","1",[61,82,83],{"class":75},",",[61,85,86],{"class":79}," 2",[61,88,83],{"class":75},[61,90,91],{"class":79}," 3",[61,93,94],{"class":75},"]\n",[61,96,98,101,103,107,110,114],{"class":63,"line":97},2,[61,99,100],{"class":67},"result ",[61,102,72],{"class":71},[61,104,106],{"class":105},"sZMiF"," tuple",[61,108,109],{"class":75},"(",[61,111,113],{"class":112},"slqww","numbers",[61,115,116],{"class":75},")\n",[61,118,120],{"class":63,"line":119},3,[61,121,123],{"emptyLinePlaceholder":122},true,"\n",[61,125,127,131,133,136],{"class":63,"line":126},4,[61,128,130],{"class":129},"sptTA","print",[61,132,109],{"class":75},[61,134,135],{"class":112},"result",[61,137,116],{"class":75},[61,139,141,143,145,148,150,152],{"class":63,"line":140},5,[61,142,130],{"class":129},[61,144,109],{"class":75},[61,146,147],{"class":105},"type",[61,149,109],{"class":75},[61,151,135],{"class":112},[61,153,154],{"class":75},"))\n",[14,156,157],{},"Output:",[52,159,161],{"className":54,"code":160,"language":56,"meta":57,"style":57},"(1, 2, 3)\n\u003Cclass 'tuple'>\n",[18,162,163,179],{"__ignoreMap":57},[61,164,165,167,169,171,173,175,177],{"class":63,"line":64},[61,166,109],{"class":75},[61,168,80],{"class":79},[61,170,83],{"class":75},[61,172,86],{"class":79},[61,174,83],{"class":75},[61,176,91],{"class":79},[61,178,116],{"class":75},[61,180,181,184,188,192,196,199],{"class":63,"line":97},[61,182,183],{"class":71},"\u003C",[61,185,187],{"class":186},"sbsja","class",[61,189,191],{"class":190},"sjJ54"," '",[61,193,195],{"class":194},"s_sjI","tuple",[61,197,198],{"class":190},"'",[61,200,201],{"class":71},">\n",[14,203,204,205,207],{},"Use ",[18,206,38],{}," to convert an iterable like a list, string, or range into a tuple.",[47,209,211],{"id":210},"what-tuple-does","What tuple() does",[14,213,214,216],{},[18,215,20],{}," is a built-in Python function.",[14,218,219],{},"It:",[26,221,222,225,228],{},[29,223,224],{},"creates a tuple object",[29,226,227],{},"can make an empty tuple with no arguments",[29,229,230],{},"can convert another iterable into a tuple",[14,232,233,234,239,240,244],{},"If you are new to tuples, see ",[235,236,238],"a",{"href":237},"\u002Fglossary\u002Fwhat-is-a-tuple-in-python\u002F","what is a tuple in Python"," or the full guide to ",[235,241,243],{"href":242},"\u002Flearn\u002Fpython-tuples-explained\u002F","Python tuples explained",".",[47,246,248],{"id":247},"basic-syntax","Basic syntax",[14,250,251],{},"There are two common forms:",[52,253,255],{"className":54,"code":254,"language":56,"meta":57,"style":57},"tuple()\ntuple(iterable)\n",[18,256,257,264],{"__ignoreMap":57},[61,258,259,261],{"class":63,"line":64},[61,260,195],{"class":105},[61,262,263],{"class":75},"()\n",[61,265,266,268,270,273],{"class":63,"line":97},[61,267,195],{"class":105},[61,269,109],{"class":75},[61,271,272],{"class":112},"iterable",[61,274,116],{"class":75},[14,276,277],{},"Important points:",[26,279,280,283],{},[29,281,282],{},"The argument must be an iterable",[29,284,285,286],{},"Common iterables include:\n",[26,287,288,291,294,297,300],{},[29,289,290],{},"lists",[29,292,293],{},"strings",[29,295,296],{},"ranges",[29,298,299],{},"sets",[29,301,302],{},"dictionaries",[14,304,305],{},"An iterable is a value Python can go through one item at a time.",[47,307,309],{"id":308},"create-an-empty-tuple","Create an empty tuple",[14,311,312,313,315],{},"Calling ",[18,314,20],{}," with no argument returns an empty tuple.",[52,317,319],{"className":54,"code":318,"language":56,"meta":57,"style":57},"empty = tuple()\n\nprint(empty)\nprint(type(empty))\n",[18,320,321,332,336,347],{"__ignoreMap":57},[61,322,323,326,328,330],{"class":63,"line":64},[61,324,325],{"class":67},"empty ",[61,327,72],{"class":71},[61,329,106],{"class":105},[61,331,263],{"class":75},[61,333,334],{"class":63,"line":97},[61,335,123],{"emptyLinePlaceholder":122},[61,337,338,340,342,345],{"class":63,"line":119},[61,339,130],{"class":129},[61,341,109],{"class":75},[61,343,344],{"class":112},"empty",[61,346,116],{"class":75},[61,348,349,351,353,355,357,359],{"class":63,"line":126},[61,350,130],{"class":129},[61,352,109],{"class":75},[61,354,147],{"class":105},[61,356,109],{"class":75},[61,358,344],{"class":112},[61,360,154],{"class":75},[14,362,157],{},[52,364,366],{"className":54,"code":365,"language":56,"meta":57,"style":57},"()\n\u003Cclass 'tuple'>\n",[18,367,368,372],{"__ignoreMap":57},[61,369,370],{"class":63,"line":64},[61,371,263],{"class":75},[61,373,374,376,378,380,382,384],{"class":63,"line":97},[61,375,183],{"class":71},[61,377,187],{"class":186},[61,379,191],{"class":190},[61,381,195],{"class":194},[61,383,198],{"class":190},[61,385,201],{"class":71},[14,387,388],{},"This is equivalent to:",[52,390,392],{"className":54,"code":391,"language":56,"meta":57,"style":57},"empty = ()\n",[18,393,394],{"__ignoreMap":57},[61,395,396,398,400],{"class":63,"line":64},[61,397,325],{"class":67},[61,399,72],{"class":71},[61,401,402],{"class":75}," ()\n",[47,404,406],{"id":405},"convert-common-iterables-to-a-tuple","Convert common iterables to a tuple",[408,409,411],"h3",{"id":410},"list-to-tuple","List to tuple",[14,413,414],{},"A list keeps its item order when converted to a tuple.",[52,416,418],{"className":54,"code":417,"language":56,"meta":57,"style":57},"numbers = [10, 20, 30]\nresult = tuple(numbers)\n\nprint(result)\n",[18,419,420,443,457,461],{"__ignoreMap":57},[61,421,422,424,426,428,431,433,436,438,441],{"class":63,"line":64},[61,423,68],{"class":67},[61,425,72],{"class":71},[61,427,76],{"class":75},[61,429,430],{"class":79},"10",[61,432,83],{"class":75},[61,434,435],{"class":79}," 20",[61,437,83],{"class":75},[61,439,440],{"class":79}," 30",[61,442,94],{"class":75},[61,444,445,447,449,451,453,455],{"class":63,"line":97},[61,446,100],{"class":67},[61,448,72],{"class":71},[61,450,106],{"class":105},[61,452,109],{"class":75},[61,454,113],{"class":112},[61,456,116],{"class":75},[61,458,459],{"class":63,"line":119},[61,460,123],{"emptyLinePlaceholder":122},[61,462,463,465,467,469],{"class":63,"line":126},[61,464,130],{"class":129},[61,466,109],{"class":75},[61,468,135],{"class":112},[61,470,116],{"class":75},[14,472,157],{},[52,474,476],{"className":54,"code":475,"language":56,"meta":57,"style":57},"(10, 20, 30)\n",[18,477,478],{"__ignoreMap":57},[61,479,480,482,484,486,488,490,492],{"class":63,"line":64},[61,481,109],{"class":75},[61,483,430],{"class":79},[61,485,83],{"class":75},[61,487,435],{"class":79},[61,489,83],{"class":75},[61,491,440],{"class":79},[61,493,116],{"class":75},[14,495,496,497,244],{},"If you need a changeable sequence instead, see the ",[235,498,500],{"href":499},"\u002Freference\u002Fpython-list-function-explained\u002F","Python list() function explained",[408,502,504],{"id":503},"string-to-tuple","String to tuple",[14,506,507],{},"A string is iterable, so each character becomes a separate item.",[52,509,511],{"className":54,"code":510,"language":56,"meta":57,"style":57},"text = \"cat\"\nresult = tuple(text)\n\nprint(result)\n",[18,512,513,529,544,548],{"__ignoreMap":57},[61,514,515,518,520,523,526],{"class":63,"line":64},[61,516,517],{"class":67},"text ",[61,519,72],{"class":71},[61,521,522],{"class":190}," \"",[61,524,525],{"class":194},"cat",[61,527,528],{"class":190},"\"\n",[61,530,531,533,535,537,539,542],{"class":63,"line":97},[61,532,100],{"class":67},[61,534,72],{"class":71},[61,536,106],{"class":105},[61,538,109],{"class":75},[61,540,541],{"class":112},"text",[61,543,116],{"class":75},[61,545,546],{"class":63,"line":119},[61,547,123],{"emptyLinePlaceholder":122},[61,549,550,552,554,556],{"class":63,"line":126},[61,551,130],{"class":129},[61,553,109],{"class":75},[61,555,135],{"class":112},[61,557,116],{"class":75},[14,559,157],{},[52,561,563],{"className":54,"code":562,"language":56,"meta":57,"style":57},"('c', 'a', 't')\n",[18,564,565],{"__ignoreMap":57},[61,566,567,569,571,574,576,578,580,582,584,586,588,591,593],{"class":63,"line":64},[61,568,109],{"class":75},[61,570,198],{"class":190},[61,572,573],{"class":194},"c",[61,575,198],{"class":190},[61,577,83],{"class":75},[61,579,191],{"class":190},[61,581,235],{"class":194},[61,583,198],{"class":190},[61,585,83],{"class":75},[61,587,191],{"class":190},[61,589,590],{"class":194},"t",[61,592,198],{"class":190},[61,594,116],{"class":75},[14,596,597,598,601,602,606,607,244],{},"This often surprises beginners. ",[18,599,600],{},"tuple(\"cat\")"," does ",[603,604,605],"strong",{},"not"," create ",[18,608,609],{},"('cat',)",[408,611,613],{"id":612},"range-to-tuple","Range to tuple",[14,615,616,619,620,622],{},[18,617,618],{},"range()"," produces values one at a time, and ",[18,621,20],{}," collects them all.",[52,624,626],{"className":54,"code":625,"language":56,"meta":57,"style":57},"result = tuple(range(5))\n\nprint(result)\n",[18,627,628,648,652],{"__ignoreMap":57},[61,629,630,632,634,636,638,641,643,646],{"class":63,"line":64},[61,631,100],{"class":67},[61,633,72],{"class":71},[61,635,106],{"class":105},[61,637,109],{"class":75},[61,639,640],{"class":129},"range",[61,642,109],{"class":75},[61,644,645],{"class":79},"5",[61,647,154],{"class":75},[61,649,650],{"class":63,"line":97},[61,651,123],{"emptyLinePlaceholder":122},[61,653,654,656,658,660],{"class":63,"line":119},[61,655,130],{"class":129},[61,657,109],{"class":75},[61,659,135],{"class":112},[61,661,116],{"class":75},[14,663,157],{},[52,665,667],{"className":54,"code":666,"language":56,"meta":57,"style":57},"(0, 1, 2, 3, 4)\n",[18,668,669],{"__ignoreMap":57},[61,670,671,673,676,678,681,683,685,687,689,691,694],{"class":63,"line":64},[61,672,109],{"class":75},[61,674,675],{"class":79},"0",[61,677,83],{"class":75},[61,679,680],{"class":79}," 1",[61,682,83],{"class":75},[61,684,86],{"class":79},[61,686,83],{"class":75},[61,688,91],{"class":79},[61,690,83],{"class":75},[61,692,693],{"class":79}," 4",[61,695,116],{"class":75},[408,697,699],{"id":698},"set-to-tuple","Set to tuple",[14,701,702],{},"A set can also be converted to a tuple.",[52,704,706],{"className":54,"code":705,"language":56,"meta":57,"style":57},"values = {1, 2, 3}\nresult = tuple(values)\n\nprint(result)\n",[18,707,708,731,746,750],{"__ignoreMap":57},[61,709,710,713,715,718,720,722,724,726,728],{"class":63,"line":64},[61,711,712],{"class":67},"values ",[61,714,72],{"class":71},[61,716,717],{"class":75}," {",[61,719,80],{"class":79},[61,721,83],{"class":75},[61,723,86],{"class":79},[61,725,83],{"class":75},[61,727,91],{"class":79},[61,729,730],{"class":75},"}\n",[61,732,733,735,737,739,741,744],{"class":63,"line":97},[61,734,100],{"class":67},[61,736,72],{"class":71},[61,738,106],{"class":105},[61,740,109],{"class":75},[61,742,743],{"class":112},"values",[61,745,116],{"class":75},[61,747,748],{"class":63,"line":119},[61,749,123],{"emptyLinePlaceholder":122},[61,751,752,754,756,758],{"class":63,"line":126},[61,753,130],{"class":129},[61,755,109],{"class":75},[61,757,135],{"class":112},[61,759,116],{"class":75},[14,761,157],{},[52,763,765],{"className":54,"code":764,"language":56,"meta":57,"style":57},"(1, 2, 3)\n",[18,766,767],{"__ignoreMap":57},[61,768,769,771,773,775,777,779,781],{"class":63,"line":64},[61,770,109],{"class":75},[61,772,80],{"class":79},[61,774,83],{"class":75},[61,776,86],{"class":79},[61,778,83],{"class":75},[61,780,91],{"class":79},[61,782,116],{"class":75},[14,784,785,786,244],{},"The order may not be predictable, because sets do not store items in a fixed order. If you want to understand sets better, see the ",[235,787,789],{"href":788},"\u002Freference\u002Fpython-set-function-explained\u002F","Python set() function explained",[408,791,793],{"id":792},"dictionary-to-tuple","Dictionary to tuple",[14,795,796,797,799],{},"When you pass a dictionary to ",[18,798,20],{},", Python uses the dictionary's keys.",[52,801,803],{"className":54,"code":802,"language":56,"meta":57,"style":57},"person = {\"name\": \"Ana\", \"age\": 25}\nresult = tuple(person)\n\nprint(result)\n",[18,804,805,848,863,867],{"__ignoreMap":57},[61,806,807,810,812,814,817,820,822,825,827,830,832,834,836,839,841,843,846],{"class":63,"line":64},[61,808,809],{"class":67},"person ",[61,811,72],{"class":71},[61,813,717],{"class":75},[61,815,816],{"class":190},"\"",[61,818,819],{"class":194},"name",[61,821,816],{"class":190},[61,823,824],{"class":75},":",[61,826,522],{"class":190},[61,828,829],{"class":194},"Ana",[61,831,816],{"class":190},[61,833,83],{"class":75},[61,835,522],{"class":190},[61,837,838],{"class":194},"age",[61,840,816],{"class":190},[61,842,824],{"class":75},[61,844,845],{"class":79}," 25",[61,847,730],{"class":75},[61,849,850,852,854,856,858,861],{"class":63,"line":97},[61,851,100],{"class":67},[61,853,72],{"class":71},[61,855,106],{"class":105},[61,857,109],{"class":75},[61,859,860],{"class":112},"person",[61,862,116],{"class":75},[61,864,865],{"class":63,"line":119},[61,866,123],{"emptyLinePlaceholder":122},[61,868,869,871,873,875],{"class":63,"line":126},[61,870,130],{"class":129},[61,872,109],{"class":75},[61,874,135],{"class":112},[61,876,116],{"class":75},[14,878,879],{},"Possible output:",[52,881,883],{"className":54,"code":882,"language":56,"meta":57,"style":57},"('name', 'age')\n",[18,884,885],{"__ignoreMap":57},[61,886,887,889,891,893,895,897,899,901,903],{"class":63,"line":64},[61,888,109],{"class":75},[61,890,198],{"class":190},[61,892,819],{"class":194},[61,894,198],{"class":190},[61,896,83],{"class":75},[61,898,191],{"class":190},[61,900,838],{"class":194},[61,902,198],{"class":190},[61,904,116],{"class":75},[47,906,908],{"id":907},"what-happens-with-dictionaries","What happens with dictionaries",[14,910,911],{},"This is a common beginner surprise.",[14,913,914,917],{},[18,915,916],{},"tuple(my_dict)"," returns a tuple of dictionary keys, not key-value pairs.",[52,919,921],{"className":54,"code":920,"language":56,"meta":57,"style":57},"person = {\"name\": \"Ana\", \"age\": 25}\n\nprint(tuple(person))\nprint(tuple(person.items()))\n",[18,922,923,959,963,977],{"__ignoreMap":57},[61,924,925,927,929,931,933,935,937,939,941,943,945,947,949,951,953,955,957],{"class":63,"line":64},[61,926,809],{"class":67},[61,928,72],{"class":71},[61,930,717],{"class":75},[61,932,816],{"class":190},[61,934,819],{"class":194},[61,936,816],{"class":190},[61,938,824],{"class":75},[61,940,522],{"class":190},[61,942,829],{"class":194},[61,944,816],{"class":190},[61,946,83],{"class":75},[61,948,522],{"class":190},[61,950,838],{"class":194},[61,952,816],{"class":190},[61,954,824],{"class":75},[61,956,845],{"class":79},[61,958,730],{"class":75},[61,960,961],{"class":63,"line":97},[61,962,123],{"emptyLinePlaceholder":122},[61,964,965,967,969,971,973,975],{"class":63,"line":119},[61,966,130],{"class":129},[61,968,109],{"class":75},[61,970,195],{"class":105},[61,972,109],{"class":75},[61,974,860],{"class":112},[61,976,154],{"class":75},[61,978,979,981,983,985,987,989,991,994],{"class":63,"line":126},[61,980,130],{"class":129},[61,982,109],{"class":75},[61,984,195],{"class":105},[61,986,109],{"class":75},[61,988,860],{"class":112},[61,990,244],{"class":75},[61,992,993],{"class":112},"items",[61,995,996],{"class":75},"()))\n",[14,998,157],{},[52,1000,1002],{"className":54,"code":1001,"language":56,"meta":57,"style":57},"('name', 'age')\n(('name', 'Ana'), ('age', 25))\n",[18,1003,1004,1024],{"__ignoreMap":57},[61,1005,1006,1008,1010,1012,1014,1016,1018,1020,1022],{"class":63,"line":64},[61,1007,109],{"class":75},[61,1009,198],{"class":190},[61,1011,819],{"class":194},[61,1013,198],{"class":190},[61,1015,83],{"class":75},[61,1017,191],{"class":190},[61,1019,838],{"class":194},[61,1021,198],{"class":190},[61,1023,116],{"class":75},[61,1025,1026,1029,1031,1033,1035,1037,1039,1041,1043,1046,1049,1051,1053,1055,1057,1059],{"class":63,"line":97},[61,1027,1028],{"class":75},"((",[61,1030,198],{"class":190},[61,1032,819],{"class":194},[61,1034,198],{"class":190},[61,1036,83],{"class":75},[61,1038,191],{"class":190},[61,1040,829],{"class":194},[61,1042,198],{"class":190},[61,1044,1045],{"class":75},"),",[61,1047,1048],{"class":75}," (",[61,1050,198],{"class":190},[61,1052,838],{"class":194},[61,1054,198],{"class":190},[61,1056,83],{"class":75},[61,1058,845],{"class":79},[61,1060,154],{"class":75},[14,1062,1063],{},"Use:",[26,1065,1066,1071],{},[29,1067,1068,1070],{},[18,1069,916],{}," for keys",[29,1072,1073,1076],{},[18,1074,1075],{},"tuple(my_dict.items())"," for key-value pairs",[14,1078,1079,1080,244],{},"This happens because iterating over a dictionary gives its keys by default. You can learn more in the ",[235,1081,1083],{"href":1082},"\u002Freference\u002Fpython-dict-function-explained\u002F","Python dict() function explained",[47,1085,1087],{"id":1086},"when-to-use-tuple","When to use tuple()",[14,1089,1090,1092],{},[18,1091,20],{}," is a good choice when:",[26,1094,1095,1098,1101,1104],{},[29,1096,1097],{},"you need an immutable sequence",[29,1099,1100],{},"you want to convert a list into a tuple",[29,1102,1103],{},"you want to store a fixed group of values",[29,1105,1106],{},"you have data that should not be changed later",[14,1108,1109],{},"Example:",[52,1111,1113],{"className":54,"code":1112,"language":56,"meta":57,"style":57},"coordinates = tuple([4, 7])\nprint(coordinates)\n",[18,1114,1115,1138],{"__ignoreMap":57},[61,1116,1117,1120,1122,1124,1127,1130,1132,1135],{"class":63,"line":64},[61,1118,1119],{"class":67},"coordinates ",[61,1121,72],{"class":71},[61,1123,106],{"class":105},[61,1125,1126],{"class":75},"([",[61,1128,1129],{"class":79},"4",[61,1131,83],{"class":75},[61,1133,1134],{"class":79}," 7",[61,1136,1137],{"class":75},"])\n",[61,1139,1140,1142,1144,1147],{"class":63,"line":97},[61,1141,130],{"class":129},[61,1143,109],{"class":75},[61,1145,1146],{"class":112},"coordinates",[61,1148,116],{"class":75},[14,1150,157],{},[52,1152,1154],{"className":54,"code":1153,"language":56,"meta":57,"style":57},"(4, 7)\n",[18,1155,1156],{"__ignoreMap":57},[61,1157,1158,1160,1162,1164,1166],{"class":63,"line":64},[61,1159,109],{"class":75},[61,1161,1129],{"class":79},[61,1163,83],{"class":75},[61,1165,1134],{"class":79},[61,1167,116],{"class":75},[14,1169,1170],{},"Tuples are often used for values like:",[26,1172,1173,1175,1178,1181],{},[29,1174,1146],{},[29,1176,1177],{},"RGB colors",[29,1179,1180],{},"dates",[29,1182,1183],{},"settings that should stay fixed",[47,1185,1187],{"id":1186},"when-not-to-use-tuple","When not to use tuple()",[14,1189,1190,1191,1193],{},"Do not use ",[18,1192,20],{}," when:",[26,1195,1196,1199,1202],{},[29,1197,1198],{},"you need to add, remove, or update items later",[29,1200,1201],{},"a list would be easier to work with",[29,1203,1204],{},"you are passing a non-iterable value",[14,1206,1207,1208,1210],{},"For example, this does ",[603,1209,605],{}," work:",[52,1212,1214],{"className":54,"code":1213,"language":56,"meta":57,"style":57},"tuple(5)\n",[18,1215,1216],{"__ignoreMap":57},[61,1217,1218,1220,1222,1224],{"class":63,"line":64},[61,1219,195],{"class":105},[61,1221,109],{"class":75},[61,1223,645],{"class":79},[61,1225,116],{"class":75},[14,1227,1228],{},"An integer is not iterable, so Python raises an error.",[14,1230,1231],{},"If you need a flexible sequence, use a list instead of a tuple.",[47,1233,1235],{"id":1234},"common-errors-and-confusion","Common errors and confusion",[14,1237,1238],{},"Here are some common problems beginners run into.",[408,1240,1242],{"id":1241},"passing-a-non-iterable-value","Passing a non-iterable value",[14,1244,1245],{},"This causes an error:",[52,1247,1248],{"className":54,"code":1213,"language":56,"meta":57,"style":57},[18,1249,1250],{"__ignoreMap":57},[61,1251,1252,1254,1256,1258],{"class":63,"line":64},[61,1253,195],{"class":105},[61,1255,109],{"class":75},[61,1257,645],{"class":79},[61,1259,116],{"class":75},[14,1261,1262],{},"Error:",[52,1264,1266],{"className":54,"code":1265,"language":56,"meta":57,"style":57},"TypeError: 'int' object is not iterable\n",[18,1267,1268],{"__ignoreMap":57},[61,1269,1270,1273,1275,1277,1280,1282,1285,1288,1291],{"class":63,"line":64},[61,1271,1272],{"class":105},"TypeError",[61,1274,824],{"class":75},[61,1276,191],{"class":190},[61,1278,1279],{"class":194},"int",[61,1281,198],{"class":190},[61,1283,1284],{"class":105}," object",[61,1286,1287],{"class":71}," is",[61,1289,1290],{"class":71}," not",[61,1292,1293],{"class":67}," iterable\n",[14,1295,1296,1297,244],{},"If you see this, read ",[235,1298,1300],{"href":1299},"\u002Ferrors\u002Ftypeerror-int-object-is-not-iterable-fix\u002F","TypeError: int object is not iterable",[408,1302,1304],{"id":1303},"expecting-one-whole-string-item","Expecting one whole string item",[14,1306,1307],{},"This code:",[52,1309,1311],{"className":54,"code":1310,"language":56,"meta":57,"style":57},"tuple(\"hello\")\n",[18,1312,1313],{"__ignoreMap":57},[61,1314,1315,1317,1319,1321,1324,1326],{"class":63,"line":64},[61,1316,195],{"class":105},[61,1318,109],{"class":75},[61,1320,816],{"class":190},[61,1322,1323],{"class":194},"hello",[61,1325,816],{"class":190},[61,1327,116],{"class":75},[14,1329,1330],{},"returns:",[52,1332,1334],{"className":54,"code":1333,"language":56,"meta":57,"style":57},"('h', 'e', 'l', 'l', 'o')\n",[18,1335,1336],{"__ignoreMap":57},[61,1337,1338,1340,1342,1345,1347,1349,1351,1354,1356,1358,1360,1363,1365,1367,1369,1371,1373,1375,1377,1380,1382],{"class":63,"line":64},[61,1339,109],{"class":75},[61,1341,198],{"class":190},[61,1343,1344],{"class":194},"h",[61,1346,198],{"class":190},[61,1348,83],{"class":75},[61,1350,191],{"class":190},[61,1352,1353],{"class":194},"e",[61,1355,198],{"class":190},[61,1357,83],{"class":75},[61,1359,191],{"class":190},[61,1361,1362],{"class":194},"l",[61,1364,198],{"class":190},[61,1366,83],{"class":75},[61,1368,191],{"class":190},[61,1370,1362],{"class":194},[61,1372,198],{"class":190},[61,1374,83],{"class":75},[61,1376,191],{"class":190},[61,1378,1379],{"class":194},"o",[61,1381,198],{"class":190},[61,1383,116],{"class":75},[14,1385,1386,1387,1389],{},"It does ",[603,1388,605],{}," return:",[52,1391,1393],{"className":54,"code":1392,"language":56,"meta":57,"style":57},"('hello',)\n",[18,1394,1395],{"__ignoreMap":57},[61,1396,1397,1399,1401,1403,1405],{"class":63,"line":64},[61,1398,109],{"class":75},[61,1400,198],{"class":190},[61,1402,1323],{"class":194},[61,1404,198],{"class":190},[61,1406,1407],{"class":75},",)\n",[14,1409,1410],{},"If you want a one-item tuple, write:",[52,1412,1414],{"className":54,"code":1413,"language":56,"meta":57,"style":57},"single = (\"hello\",)\nprint(single)\n",[18,1415,1416,1433],{"__ignoreMap":57},[61,1417,1418,1421,1423,1425,1427,1429,1431],{"class":63,"line":64},[61,1419,1420],{"class":67},"single ",[61,1422,72],{"class":71},[61,1424,1048],{"class":75},[61,1426,816],{"class":190},[61,1428,1323],{"class":194},[61,1430,816],{"class":190},[61,1432,1407],{"class":75},[61,1434,1435,1437,1439,1442],{"class":63,"line":97},[61,1436,130],{"class":129},[61,1438,109],{"class":75},[61,1440,1441],{"class":112},"single",[61,1443,116],{"class":75},[408,1445,1447],{"id":1446},"expecting-dictionary-values-too","Expecting dictionary values too",[14,1449,1307],{},[52,1451,1453],{"className":54,"code":1452,"language":56,"meta":57,"style":57},"data = {\"a\": 1, \"b\": 2}\nprint(tuple(data))\n",[18,1454,1455,1489],{"__ignoreMap":57},[61,1456,1457,1460,1462,1464,1466,1468,1470,1472,1474,1476,1478,1481,1483,1485,1487],{"class":63,"line":64},[61,1458,1459],{"class":67},"data ",[61,1461,72],{"class":71},[61,1463,717],{"class":75},[61,1465,816],{"class":190},[61,1467,235],{"class":194},[61,1469,816],{"class":190},[61,1471,824],{"class":75},[61,1473,680],{"class":79},[61,1475,83],{"class":75},[61,1477,522],{"class":190},[61,1479,1480],{"class":194},"b",[61,1482,816],{"class":190},[61,1484,824],{"class":75},[61,1486,86],{"class":79},[61,1488,730],{"class":75},[61,1490,1491,1493,1495,1497,1499,1502],{"class":63,"line":97},[61,1492,130],{"class":129},[61,1494,109],{"class":75},[61,1496,195],{"class":105},[61,1498,109],{"class":75},[61,1500,1501],{"class":112},"data",[61,1503,154],{"class":75},[14,1505,1506],{},"returns only the keys:",[52,1508,1510],{"className":54,"code":1509,"language":56,"meta":57,"style":57},"('a', 'b')\n",[18,1511,1512],{"__ignoreMap":57},[61,1513,1514,1516,1518,1520,1522,1524,1526,1528,1530],{"class":63,"line":64},[61,1515,109],{"class":75},[61,1517,198],{"class":190},[61,1519,235],{"class":194},[61,1521,198],{"class":190},[61,1523,83],{"class":75},[61,1525,191],{"class":190},[61,1527,1480],{"class":194},[61,1529,198],{"class":190},[61,1531,116],{"class":75},[14,1533,1534],{},"To get key-value pairs, use:",[52,1536,1538],{"className":54,"code":1537,"language":56,"meta":57,"style":57},"print(tuple(data.items()))\n",[18,1539,1540],{"__ignoreMap":57},[61,1541,1542,1544,1546,1548,1550,1552,1554,1556],{"class":63,"line":64},[61,1543,130],{"class":129},[61,1545,109],{"class":75},[61,1547,195],{"class":105},[61,1549,109],{"class":75},[61,1551,1501],{"class":112},[61,1553,244],{"class":75},[61,1555,993],{"class":112},[61,1557,996],{"class":75},[408,1559,1561],{"id":1560},"thinking-parentheses-always-convert-to-a-tuple","Thinking parentheses always convert to a tuple",[14,1563,1564,1565,1567],{},"Parentheses can create tuples in many cases, but they do not behave the same as ",[18,1566,20],{}," conversion.",[14,1569,1570],{},"For example:",[52,1572,1574],{"className":54,"code":1573,"language":56,"meta":57,"style":57},"value = (1, 2, 3)\nprint(value)\n",[18,1575,1576,1597],{"__ignoreMap":57},[61,1577,1578,1581,1583,1585,1587,1589,1591,1593,1595],{"class":63,"line":64},[61,1579,1580],{"class":67},"value ",[61,1582,72],{"class":71},[61,1584,1048],{"class":75},[61,1586,80],{"class":79},[61,1588,83],{"class":75},[61,1590,86],{"class":79},[61,1592,83],{"class":75},[61,1594,91],{"class":79},[61,1596,116],{"class":75},[61,1598,1599,1601,1603,1606],{"class":63,"line":97},[61,1600,130],{"class":129},[61,1602,109],{"class":75},[61,1604,1605],{"class":112},"value",[61,1607,116],{"class":75},[14,1609,1610],{},"This creates a tuple directly.",[14,1612,1613,1614,1616],{},"But ",[18,1615,20],{}," is specifically used to create an empty tuple or convert an iterable into a tuple.",[47,1618,1620],{"id":1619},"faq","FAQ",[408,1622,1624],{"id":1623},"what-does-tuple-do-in-python","What does tuple() do in Python?",[14,1626,1627],{},"It creates a tuple. With an iterable argument, it converts that iterable into a tuple.",[408,1629,1631],{"id":1630},"what-does-tuple-return-with-no-argument","What does tuple() return with no argument?",[14,1633,1634,1635,244],{},"It returns an empty tuple: ",[18,1636,1637],{},"()",[408,1639,1641],{"id":1640},"can-tuple-convert-a-string","Can tuple() convert a string?",[14,1643,1644],{},"Yes. Each character becomes a separate item in the tuple.",[408,1646,1648],{"id":1647},"why-does-tuplemy_dict-only-return-keys","Why does tuple(my_dict) only return keys?",[14,1650,1651],{},"Iterating over a dictionary gives its keys by default.",[408,1653,1655],{"id":1654},"can-i-use-tuple-on-an-integer","Can I use tuple() on an integer?",[14,1657,1658,1659,244],{},"No. An integer is not iterable, so Python raises a ",[18,1660,1272],{},[47,1662,1664],{"id":1663},"see-also","See also",[26,1666,1667,1671,1676,1680,1684,1688],{},[29,1668,1669],{},[235,1670,243],{"href":242},[29,1672,1673],{},[235,1674,1675],{"href":237},"What is a tuple in Python?",[29,1677,1678],{},[235,1679,500],{"href":499},[29,1681,1682],{},[235,1683,789],{"href":788},[29,1685,1686],{},[235,1687,1083],{"href":1082},[29,1689,1690],{},[235,1691,1300],{"href":1299},[1693,1694,1695],"style",{},"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 .srdBf, html code.shiki .srdBf{--shiki-light:#F76D47;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZMiF, html code.shiki .sZMiF{--shiki-light:#E2931D;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .slqww, html code.shiki .slqww{--shiki-light:#6182B8;--shiki-default:#24292E;--shiki-dark:#E1E4E8}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 .sbsja, html code.shiki .sbsja{--shiki-light:#9C3EDA;--shiki-default:#D73A49;--shiki-dark:#F97583}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":57,"searchDepth":97,"depth":97,"links":1697},[1698,1699,1700,1701,1702,1709,1710,1711,1712,1718,1725],{"id":49,"depth":97,"text":50},{"id":210,"depth":97,"text":211},{"id":247,"depth":97,"text":248},{"id":308,"depth":97,"text":309},{"id":405,"depth":97,"text":406,"children":1703},[1704,1705,1706,1707,1708],{"id":410,"depth":119,"text":411},{"id":503,"depth":119,"text":504},{"id":612,"depth":119,"text":613},{"id":698,"depth":119,"text":699},{"id":792,"depth":119,"text":793},{"id":907,"depth":97,"text":908},{"id":1086,"depth":97,"text":1087},{"id":1186,"depth":97,"text":1187},{"id":1234,"depth":97,"text":1235,"children":1713},[1714,1715,1716,1717],{"id":1241,"depth":119,"text":1242},{"id":1303,"depth":119,"text":1304},{"id":1446,"depth":119,"text":1447},{"id":1560,"depth":119,"text":1561},{"id":1619,"depth":97,"text":1620,"children":1719},[1720,1721,1722,1723,1724],{"id":1623,"depth":119,"text":1624},{"id":1630,"depth":119,"text":1631},{"id":1640,"depth":119,"text":1641},{"id":1647,"depth":119,"text":1648},{"id":1654,"depth":119,"text":1655},{"id":1663,"depth":97,"text":1664},"Master python tuple function explained in our comprehensive Python beginner guide.","md",{},"\u002Freference\u002Fpython-tuple-function-explained",{"title":5,"description":1726},"reference\u002Fpython-tuple-function-explained","pFeq5hNHdIKuIzk8wtloZhtsgtV1EfCv8EepPUEVHYk",1777585514902]