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