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