{"id":2463,"date":"2013-10-07T14:10:00","date_gmt":"2013-10-07T14:10:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/visualstudioalm\/2013\/10\/07\/hit-count-breakpoints\/"},"modified":"2022-07-19T00:18:54","modified_gmt":"2022-07-19T08:18:54","slug":"hit-count-breakpoints","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/devops\/hit-count-breakpoints\/","title":{"rendered":"Hit Count Breakpoints"},"content":{"rendered":"

This blog post is part of a series on <\/span>breakpoints<\/span><\/a><\/span> in the Visual Studio debugger and has been updated to reflect the experience of using Visual Studio 2015. If you are interested in details about setting hit count breakpoints using earlier versions of Visual Studio please see the <\/span>MSDN documentation<\/span><\/a><\/span>.<\/span><\/span><\/p>\n

As mentioned in <\/span>an earlier post<\/span><\/a><\/span>, we will be writing about all of the different breakpoint functionality available in Visual Studio.\u00a0In this first part, we discuss the hit count breakpoint.\u00a0 If you wish to follow along, the code samples below are <\/span>available for download<\/span><\/a><\/span>.<\/span><\/span><\/p>\n

Sample Problem<\/h2>\n

Consider the following method that applies a basic shift cipher to a string. A <\/span>shift cipher (or Caesar cipher)<\/span><\/a><\/span> simply shift the letters of a message by a fixed amount.<\/span><\/span><\/p>\n

\u00a0\"\"<\/p>\n

We have a breakpoint set on the return <\/span>statement of the method. Now let\u2019s see what happens when we run the following <\/span>code:<\/span><\/p>\n

\u00a0\"\"<\/p>\n

When we are stopped at the breakpoint, we inspect shiftArray and see that we have a problem.<\/p>\n

\"clip_image003\"<\/p>\n

While the rest of the encoded message does not make it obvious that there is a problem, we can see that we have \u2018{\u2018 in the 35th <\/sup>position, which is obviously wrong. We suspect that the problem is in the loop that is encoding each letter, but we really want to examine the 36th <\/sup>iteration of the loop. If we just set a breakpoint in the loop, we would have to sit there and continue it 35 times before we can really get down to debugging. This is where using hit count breakpoints comes in handy. <\/span>Creating the Hit Count Breakpoint. To create the hit count breakpoint, first start by simply creating a regular breakpoint in the loop you want to examine.<\/p>\n

\"\"<\/p>\n

Then hover over the breakpoint to bring up the breakpoint\u2019s toolbar and click the \u201cSettings\u2026\u201d icon.<\/p>\n

\"\"<\/p>\n

You can also right click on the breakpoint to bring up the context menu and click on \u201cConditions\u2026\u201d, or press Alt+F9, C to use the keyboard shortcut.<\/p>\n

\"\"<\/p>\n

This will bring up the Breakpoint Settings peek window.\u00a0 (Tip: Using the context menu or shortcut key will open the window with the Conditions box already checked.)<\/p>\n

\"\"<\/p>\n

Select\u00a0\u201cConditions\u201d\u00a0 by checking the box and change the type of condition in the first dropdown from \u201cConditional Expression\u201d to \u201cHit Count\u201d. <\/span><\/p>\n

Then enter 36 as the hit value and press the \u201cEnter\u201d key. Notice that after you enter a value, the condition is saved automatically when you hit \u201cEnter\u201d or click outside of the edit space.<\/span><\/p>\n

\"\"<\/a><\/span><\/p>\n

You\u2019ll also notice that the breakpoint now has a \u2018+\u2019 inside indicating that this is an advanced breakpoint. <\/span><\/span><\/p>\n

\"\"<\/a><\/span><\/span><\/p>\n

Now when I start the application under the debugger, I stop right where the code is changing the value of shiftArray[35].<\/p>\n

\"\"<\/p>\n

And as I step through, I can see the problem. First the letter is shifted off the end of the alphabet.<\/p>\n

\"\"<\/p>\n

But then when I step again, I can see that it skips the code that is supposed to push the letter back into the alphabet range.<\/p>\n

\"\"<\/p>\n

Now I have found my problem. The condition should be shiftArray[i] >= 123 instead of shiftArray[i] > 123. And I found this more quickly by using a hit count breakpoint than I would otherwise.<\/span><\/p>\n

Skipping Ahead<\/h2>\n

Hit Count breakpoints can also be used when you need to skip ahead in the execution of your code, but you don\u2019t quite know exactly how far ahead you want to go.<\/p>\n

Consider the following recursive function that calculated the greatest common divisor (GCD) of two numbers.<\/p>\n

\"\"<\/p>\n

\u00a0<\/p>\n

As a developer, you may want to debug through this function in order to see the intermediate values during the GCD calculation. Given two large numbers, you know that this function is likely to run for a long time, but you don\u2019t know quite how long. In this case you can use hit count breakpoints to save you some time.<\/p>\n

As before, you can bring up the Breakpoint Settings peek window by clicking the \u201cSettings\u2026\u201d icon on the breakpoint\u2019s toolbar, by using the keyboard shortcut Alt+F9, C, or by right-clicking on the breakpoint and selecting \u201cSettings\u2026\u201d This time still select Hit Count as the condition, but select the \u201c>=\u201d option and enter a value of 10.<\/p>\n

\"\"<\/p>\n

This will allow you to skip through the first 10 calls to the function to get closer. Now consider calling the function with the following two integers,<\/p>\n

\"clip_image014\"<\/p>\n

Running to the breakpoint gets me down to small numbers for x and y so that I can follow the rest of the calculation.<\/p>\n

\"\"<\/p>\n

And if I continue the application, the application will continue to stop at the breakpoint each subsequent time it hits it.<\/p>\n

\"\"<\/p>\n

To view the current hit count, I can hover over the breakpoint and read the tooltip.<\/p>\n

\"\"<\/p>\n

If I open the Breakpoint Settings peek window, I can also view the current hit count for the breakpoint, and click the reset button to avoid stopping on the breakpoint for another 10 iterations.<\/p>\n

\"\"<\/p>\n

Counting Iterations<\/h2>\n

Finally, hit count breakpoints can also be used simply to count the number of times the breakpoint is hit. Let\u2019s say we wanted to count the number of iterations in our GCD example. As a before, you want to create a hit count breakpoint and select the option \u201c>=\u201d. This time, instead of choosing a number to break on, instead choose an arbitrarily large number like 99999.<\/p>\n

\"\"<\/p>\n

With a number this large, the breakpoint will never be hit. Now set another breakpoint somewhere after all of the iterations of GCD will already be complete. When you stop at this breakpoint, you can see the hit count in the tooltip for the breakpoint, as well as the Breakpoint Settings peek window.<\/p>\n

\"\"<\/p>\n

You can always see current hit count information for all of your breakpoints in the Breakpoints Window (available from the Debug -> Windows menu).<\/p>\n

\"\"<\/p>\n

So you know that the program went through the GCD function 14 times.<\/p>\n","protected":false},"excerpt":{"rendered":"

This blog post is part of a series on breakpoints in the Visual Studio debugger and has been updated to reflect the experience of using Visual Studio 2015. If you are interested in details about setting hit count breakpoints using earlier versions of Visual Studio please see the MSDN documentation. As mentioned in an earlier […]<\/p>\n","protected":false},"author":75,"featured_media":45953,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1,225],"tags":[],"class_list":["post-2463","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-devops","category-git"],"acf":[],"blog_post_summary":"

This blog post is part of a series on breakpoints in the Visual Studio debugger and has been updated to reflect the experience of using Visual Studio 2015. If you are interested in details about setting hit count breakpoints using earlier versions of Visual Studio please see the MSDN documentation. As mentioned in an earlier […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/2463","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/users\/75"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/comments?post=2463"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/2463\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media\/45953"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media?parent=2463"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/categories?post=2463"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/tags?post=2463"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}