Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

Visual C++ 프로젝트 디버깅 시에 Step-Into(F11) 동작이 원치 않는 함수로 진입하는 것을 막는 방법

말로 설명하는 것보다 직접 한번 실습을 해볼까요? ^^

예를 들어 다음과 같은 코드에서,

#include "stdafx.h"

#include <string>
using namespace std;

void Output(wstring txt)
{
}

int _tmain(int argc, _TCHAR* argv[])
{
    wstring txt = L"TEST";

    Output(txt);

    return 0;
}

Output 함수 실행 부분에 BP(Breakpoint)를 잡고는,

vcpp_breakpoint_0.png

F11(Step-into)키를 눌러 진행하면 어떻게 될까요? 원래 우리가 원하는 동작은 Output 함수로 디버거가 진입하는 것이지만, STL 클래스인 wstring 타입의 생성자로 인해 xstring 파일이 열리면서 basic_string 생성자로 진입하게 됩니다.

vcpp_breakpoint_1.png

함수에 여러 개의 STL 타입이 전달되는 경우면 이것이 여간 짜증나는 일이 아닐 수 없는데요. ^^; 바로 이럴 때 NatStepFilter 파일을 사용하시면 됩니다.

How to Not Step Into Functions using the Visual C++ Debugger
; https://learn.microsoft.com/en-us/archive/blogs/andypennell/how-to-not-step-into-functions-using-the-visual-c-debugger

위의 글에 따라, 다음의 경로에 있는 파일을

C:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\Packages\Debugger\Visualizers\default.natstepfilter 

[Visual Studio 2015]
C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\Packages\Debugger\Visualizers\default.natstepfilter

[Visual Studio 2017 - Enterprise]
C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\Packages\Debugger\Visualizers\default.natstepfilter

[Visual Studio 2019 - Enterprise]
C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\Packages\Debugger\Visualizers\default.natstepfilter 

[Visual Studio 2022 - Enterprise]
C:\Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\Packages\Debugger\Visualizers\default.natstepfilter

"관리자 권한으로 실행시킨 notepad.exe"에 불러와서 다음과 같이 std 네임스페이스로 시작하는 모든 클래스 정의에 대해 디버거로 하여금 진입을 하지 않도록 설정할 수 있습니다.

<?xml version="1.0" encoding="utf-8"?>
<StepFilter xmlns="http://schemas.microsoft.com/vstudio/debugger/natstepfilter/2010">

  <Function><Name>std::.*</Name><Action>NoStepInto</Action></Function>


  <Function><Name>__security_check_cookie</Name><Action>NoStepInto</Action></Function>
  ...[생략: 기본적으로 포함된 내용]...
  <Function><Name>operator new</Name><Action>NoStepInto</Action></Function>
</StepFilter>

혹시나, ATL 관련 코드를 자주 만드는 분들이라면 다음의 항목도 추가해 주는 것도 편리할 것입니다.

<?xml version="1.0" encoding="utf-8"?>
<StepFilter xmlns="http://schemas.microsoft.com/vstudio/debugger/natstepfilter/2010">

  <Function><Name>std::.*</Name><Action>NoStepInto</Action></Function>
  <Function><Name>ATL::.*</Name><Action>NoStepInto</Action></Function>


  <Function><Name>__security_check_cookie</Name><Action>NoStepInto</Action></Function>
  ...[생략: 기본적으로 포함된 내용]...
  <Function><Name>operator new</Name><Action>NoStepInto</Action></Function>
</StepFilter>

물론, std/ATL 내부의 코드를 디버깅하고 싶은 코어 개발자라면 위의 설정을 하지 않는 것이 좋습니다.




참고로, Navis 같은 파일은 프로젝트 레벨로 지원이 내려왔는데,

Project Support for Natvis 
; https://devblogs.microsoft.com/cppblog/project-support-for-natvis/

아쉽게도 natstepfilter 파일은 여전히 'Program Files' 폴더 하위에서만 지원합니다.




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]







[최초 등록일: ]
[최종 수정일: 1/26/2023]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 



2015-10-23 02시14분
정성태
2023-06-09 02시18분
Leverage native step filter files in your C++ project with Visual Studio 17.6!

We now provide added project-level support for .natstepfilter and .natjmc files, on top of the existing support for .natvis.

https://twitter.com/VS_Debugger/status/1666105167022833664?s=20
정성태

[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
14001정성태8/19/2025132닷넷: 2356. .NET SDK 10 - 단일 소스 코드 파일을 빌드/실행하는 기능을 "dotnet" 명령어에 추가
14000정성태8/18/2025532오류 유형: 979. ERROR: failed to solve: failed to read dockerfile: open Dockerfile: no such file or directory
13999정성태8/15/20251054닷넷: 2355. C# 14 - (8) null 조건부 연산자 개선 - 대입문에도 사용 가능파일 다운로드1
13998정성태8/14/20251005닷넷: 2354. C# 14 - (7) 확장 메서드에 정적 메서드와 속성 지원을 위한 전용 구문 추가파일 다운로드1
13997정성태8/14/20251147Linux: 120. docker 컨테이너로 매핑된 볼륨에 컨테이너 측의 사용자 ID를 유지하면서 복사하는 방법
13996정성태8/13/2025694오류 유형: 978. Unable to find the requested .Net Framework Data Provider.
13995정성태8/13/2025725개발 환경 구성: 754. Visual C++ - 리눅스 빌드를 위한 Ubuntu 18 docker 컨테이너 설정
13994정성태8/12/2025709오류 유형: 977. SQL Server - User, group, or role '...' already exists in the current database. (Microsoft SQL Server, Error: 15023)
13993정성태8/11/20251058오류 유형: 976. Microsoft.ML.OnnxRuntimeGenAI 패키지 사용 시 "cublasLt64_12.dll" which is missing. (Error 126: "The specified module could not be found.") 오류
13992정성태8/11/20251268닷넷: 2353. C# - Foundry Local을 이용한 gpt-oss-20b 모델 사용파일 다운로드1
13991정성태8/9/20251202오류 유형: 975. winget - Foundry Local 패키지 업데이트가 안 되는 문제
13990정성태8/8/2025898Windows: 283. Time zone 설정이 없는 Windows Server 2025
13989정성태8/8/20251312닷넷: 2352. C# - Windows S-mode 환경인지 체크하는 방법파일 다운로드1
13988정성태8/8/20251447오류 유형: 974. 비주얼 스튜디오 업데이트 시 잠김 파일 경고 - Visual Studio Standard Collector Service 150 (VSStandardCollectorService150)
13987정성태8/7/20251098닷넷: 2351. C# 14 - (6) event와 생성자에도 partial 메서드 적용파일 다운로드1
13986정성태8/6/20251198닷넷: 2350. C# 14 - (5) 람다 매개 변수에 접근자가 있는 경우에도 타입 생략 가능파일 다운로드1
13985정성태8/6/20251604오류 유형: 973. "wsl --install" 명령어 수행 시 "The server name or address could not be resolved"
13984정성태8/6/20251338Windows: 282. 윈도우 운영체제에 추가된 ssh 서버(Win32-OpenSSH)
13983정성태8/4/20251426오류 유형: 972. Microsoft.Data.SqlClient 6.1.0 버전부터 .NET 8 이상만 지원
13982정성태8/2/20251857개발 환경 구성: 753. CentOS 7 컨테이너 내에서 openssh 서버 호스팅
13981정성태8/1/20251507오류 유형: 971. CentOS 7에서 yum 사용 시 "Could not resolve host: mirrorlist.centos.org; Unknown error"
13980정성태7/31/20251641Linux: 119. eBPF - BPF_PROG_TYPE_CGROUP_SOCK 유형에서 정상 동작하지 않는 BPF_CORE_READ (2)
13979정성태7/30/20251985Linux: 118. eBPF - BPF_PROG_TYPE_CGROUP_SOCK 유형에서 정상 동작하지 않는 BPF_CORE_READ
13978정성태7/29/20251742오류 유형: 970. 파일 복사 시 "Data error (cyclic redundancy check). (0x80070017)" 에러
13977정성태7/28/20252074닷넷: 2349. C# 14 - (4) 문자열 리터럴을 utf-8 인코딩으로 저장파일 다운로드1
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...