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