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