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