CPathT 클래스

이 클래스는 경로를 나타냅니다.

Important

이 클래스와 해당 멤버는 Windows 런타임에서 실행되는 애플리케이션에서 사용할 수 없습니다.

구문

template <typename StringType>
class CPathT

매개 변수

StringType
경로에 사용할 ATL/MFC 문자열 클래스입니다(CStringT 참조).

멤버

공용 Typedefs

속성	설명
CPathT::P CXSTR	상수 문자열 형식입니다.
CPathT::P XSTR	문자열 형식입니다.
CPathT::XCHAR	문자 형식입니다.

공용 생성자

속성	설명
CPatht::CPathT	경로의 생성자입니다.

공용 메서드

이름	설명
CPathT::AddBackslash	이 메서드를 호출하여 문자열 끝에 백슬래시를 추가하여 경로에 대한 올바른 구문을 만듭니다.
CPathT::AddExtension	경로에 파일 확장자를 추가하려면 이 메서드를 호출합니다.
CPathT::Append	현재 경로에 문자열을 추가하려면 이 메서드를 호출합니다.
CPathT::BuildRoot	지정된 드라이브 번호에서 루트 경로를 만들려면 이 메서드를 호출합니다.
CPathT::Canonicalize	경로를 정식 형식으로 변환하려면 이 메서드를 호출합니다.
CPathT::Combine	디렉터리 이름을 나타내는 문자열과 파일 경로 이름을 나타내는 문자열을 하나의 경로에 연결하려면 이 메서드를 호출합니다.
CPathT::CommonPrefix	지정된 경로가 현재 경로와 공통 접두사를 공유하는지 여부를 확인하려면 이 메서드를 호출합니다.
CPathT::CompactPath	경로 구성 요소를 줄임표로 바꿔 지정된 픽셀 너비 내에 맞게 파일 경로를 자르려면 이 메서드를 호출합니다.
CPathT::CompactPathEx	경로 구성 요소를 줄임표로 바꿔 지정된 수의 문자에 맞게 파일 경로를 자르려면 이 메서드를 호출합니다.
CPathT::FileExists	이 메서드를 호출하여 이 경로 이름의 파일이 있는지 확인합니다.
CPathT::FindExtension	이 메서드를 호출하여 경로 내에서 파일 확장자의 위치를 찾습니다.
CPathT::FindFileName	경로 내에서 파일 이름의 위치를 찾으려면 이 메서드를 호출합니다.
CPathT::GetDriveNumber	이 메서드를 호출하여 'A'에서 'Z' 범위 내의 드라이브 문자 경로를 검색하고 해당 드라이브 번호를 반환합니다.
CPathT::GetExtension	이 메서드를 호출하여 경로에서 파일 확장자를 가져옵니다.
CPathT::IsDirectory	경로가 유효한 디렉터리인지 확인하려면 이 메서드를 호출합니다.
CPathT::IsFileSpec	경로 구분 문자(예 : : 또는 \)에 대한 경로를 검색하려면 이 메서드를 호출합니다. 경로 구분 문자가 없는 경우 경로는 파일 사양 경로로 간주됩니다.
CPathT::IsPrefix	이 메서드를 호출하여 경로에 pszPrefix에서 전달한 형식의 유효한 접두사를 포함하는지 여부를 확인합니다.
CPathT::IsRelative	경로가 상대 경로인지 확인하려면 이 메서드를 호출합니다.
CPathT::IsRoot	이 메서드를 호출하여 경로가 디렉터리 루트인지 확인합니다.
CPathT::IsSameRoot	이 메서드를 호출하여 다른 경로에 현재 경로가 있는 공통 루트 구성 요소가 있는지 확인합니다.
CPathT::IsUNC	이 메서드를 호출하여 경로가 서버 및 공유에 대한 유효한 UNC(범용 명명 규칙) 경로인지 여부를 확인합니다.
CPathT::IsUNCServer	이 메서드를 호출하여 해당 경로가 서버에만 유효한 UNC(범용 명명 규칙) 경로인지 여부를 확인합니다.
CPathT::IsUNCServerShare	이 메서드를 호출하여 경로가 유효한 UNC(범용 명명 규칙) 공유 경로 \\server\share인지 여부를 확인합니다.
CPathT::MakePretty	경로를 모든 소문자로 변환하여 경로에 일관된 모양을 지정하려면 이 메서드를 호출합니다.
CPatht::MatchSpec	이 메서드를 호출하여 와일드카드 일치 형식이 포함된 문자열의 경로를 검색합니다.
CPathT::QuoteSpaces	공백이 있는 경우 이 메서드를 호출하여 경로를 따옴표로 묶습니다.
CPathT::RelativePathTo	이 메서드를 호출하여 한 파일 또는 폴더에서 다른 파일로의 상대 경로를 만듭니다.
CPathT::RemoveArgs	이 메서드를 호출하여 경로에서 명령줄 인수를 제거합니다.
CPathT::RemoveBackslash	경로에서 후행 백슬래시를 제거하려면 이 메서드를 호출합니다.
CPathT::RemoveBlanks	이 메서드를 호출하여 경로에서 모든 선행 및 후행 공백을 제거합니다.
CPathT::RemoveExtension	경로에서 파일 확장명(있는 경우)을 제거하려면 이 메서드를 호출합니다.
CPathT::RemoveFileSpec	이 메서드를 호출하여 경로에서 후행 파일 이름과 백슬래시를 제거합니다(있는 경우).
CPathT::RenameExtension	경로의 파일 이름 확장명을 새 확장명으로 바꾸려면 이 메서드를 호출합니다. 파일 이름에 확장명을 포함하지 않으면 확장명은 문자열의 끝에 연결됩니다.
CPathT::SkipRoot	드라이브 문자 또는 UNC 서버/공유 경로 부분을 무시하고 경로를 구문 분석하려면 이 메서드를 호출합니다.
CPathT::StripPath	정규화된 경로 및 파일 이름의 경로 부분을 제거하려면 이 메서드를 호출합니다.
CPathT::StripToRoot	루트 정보를 제외한 경로의 모든 부분을 제거하려면 이 메서드를 호출합니다.
CPathT::UnquoteSpaces	경로의 시작과 끝에서 따옴표를 제거하려면 이 메서드를 호출합니다.

Public 연산자

속성	설명
CPathT::operator const StringType &	이 연산자를 사용하면 개체를 문자열처럼 처리할 수 있습니다.
CPathT::operator CPathT::P CXSTR	이 연산자를 사용하면 개체를 문자열처럼 처리할 수 있습니다.
CPathT::operator StringType &	이 연산자를 사용하면 개체를 문자열처럼 처리할 수 있습니다.
CPathT::operator +=	이 연산자는 경로에 문자열을 추가합니다.

공용 데이터 멤버

속성	설명
CPathT::m_strPath	경로입니다.

설명

CPath, CPathA및 CPathW 다음과 같이 정의된 인스턴스화 CPathT 입니다.

typedef CPathT< CString > CPath;

typedef CPathT< CStringA > CPathA;

typedef CPathT< CStringW > CPathW;

요구 사항

헤더: atlpath.h

CPathT::AddBackslash

이 메서드를 호출하여 문자열 끝에 백슬래시를 추가하여 경로에 대한 올바른 구문을 만듭니다. 경로에 이미 후행 백슬래스가 있는 경우 백슬래시는 추가되지 않습니다.

void AddBackslash();

설명

자세한 내용은 PathAddBackSlash를 참조 하세요.

CPathT::AddExtension

경로에 파일 확장자를 추가하려면 이 메서드를 호출합니다.

BOOL AddExtension(PCXSTR pszExtension);

매개 변수

pszExtension
추가할 파일 확장명입니다.

Return Value

성공하면 TRUE를 반환하고 실패하면 FALSE를 반환합니다.

설명

자세한 내용은 PathAddExtension을 참조 하세요.

CPathT::Append

현재 경로에 문자열을 추가하려면 이 메서드를 호출합니다.

BOOL Append(PCXSTR pszMore);

매개 변수

pszMore
추가할 문자열입니다.

Return Value

성공하면 TRUE를 반환하고 실패하면 FALSE를 반환합니다.

설명

자세한 내용은 PathAppend를 참조 하세요.

CPathT::BuildRoot

지정된 드라이브 번호에서 루트 경로를 만들려면 이 메서드를 호출합니다.

void BuildRoot(int iDrive);

매개 변수

iDrive
드라이브 번호(0, 1, 등)입니다A:B:.

설명

자세한 내용은 PathBuildRoot를 참조하세요.

CPathT::Canonicalize

경로를 정식 형식으로 변환하려면 이 메서드를 호출합니다.

void Canonicalize();

설명

자세한 내용은 PathCanonicalize를 참조 하세요.

CPathT::Combine

디렉터리 이름을 나타내는 문자열과 파일 경로 이름을 나타내는 문자열을 하나의 경로에 연결하려면 이 메서드를 호출합니다.

void Combine(PCXSTR pszDir, PCXSTR  pszFile);

매개 변수

pszDir
디렉터리 경로입니다.

pszFile
파일 경로입니다.

설명

자세한 내용은 PathCombine을 참조 하세요.

CPathT::CommonPrefix

지정된 경로가 현재 경로와 공통 접두사를 공유하는지 여부를 확인하려면 이 메서드를 호출합니다.

CPathT<StringType> CommonPrefix(PCXSTR pszOther);

매개 변수

pszOther
현재 경로와 비교할 경로입니다.

Return Value

공통 접두사를 반환합니다.

설명

접두사는 "C:\\", ".", "..", ".. 형식 중 하나입니다. \\". 자세한 내용은 PathCommonPrefix를 참조 하세요.

CPathT::CompactPath

경로 구성 요소를 줄임표로 바꿔 지정된 픽셀 너비 내에 맞게 파일 경로를 자르려면 이 메서드를 호출합니다.

BOOL CompactPath(HDC hDC, UINT nWidth);

매개 변수

hDC
글꼴 메트릭에 사용되는 디바이스 컨텍스트입니다.

nWidth
문자열을 강제로 맞출 너비(픽셀)입니다.

Return Value

성공하면 TRUE를 반환하고 실패하면 FALSE를 반환합니다.

설명

자세한 내용은 PathCompactPath를 참조 하세요.

CPathT::CompactPathEx

경로 구성 요소를 줄임표로 바꿔 지정된 수의 문자에 맞게 파일 경로를 자르려면 이 메서드를 호출합니다.

BOOL CompactPathEx(UINT nMaxChars, DWORD dwFlags = 0);

매개 변수

nMaxChars
종결 NULL 문자를 포함하여 새 문자열에 포함할 최대 문자 수입니다.

dwFlags
예약되었습니다.

Return Value

성공하면 TRUE를 반환하고 실패하면 FALSE를 반환합니다.

설명

자세한 내용은 PathCompactPathEx를 참조하세요.

CPatht::CPathT

생성자입니다.

CPathT(PCXSTR pszPath);
CPathT(const CPathT<StringType>& path);
CPathT() throw();

매개 변수

pszPath
경로 문자열에 대한 포인터입니다.

path
경로 문자열입니다.

CPathT::FileExists

이 메서드를 호출하여 이 경로 이름의 파일이 있는지 확인합니다.

BOOL FileExists() const;

Return Value

파일이 있으면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.

설명

자세한 내용은 PathFileExists를 참조하세요.

CPathT::FindExtension

이 메서드를 호출하여 경로 내에서 파일 확장자의 위치를 찾습니다.

int FindExtension() const;

Return Value

확장 앞에 있는 "."의 위치를 반환합니다. 확장이 없으면 -1을 반환합니다.

설명

자세한 내용은 PathFindExtension을 참조 하세요.

CPathT::FindFileName

경로 내에서 파일 이름의 위치를 찾으려면 이 메서드를 호출합니다.

int FindFileName() const;

Return Value

파일 이름의 위치를 반환합니다. 파일 이름을 찾을 수 없으면 -1을 반환합니다.

설명

자세한 내용은 PathFindFileName을 참조 하세요.

CPathT::GetDriveNumber

이 메서드를 호출하여 'A'에서 'Z' 범위 내의 드라이브 문자 경로를 검색하고 해당 드라이브 번호를 반환합니다.

int GetDriveNumber() const;

Return Value

경로에 드라이브 문자가 있는 경우 0에서 25 사이의 정수('A'~'Z'에 해당)로 드라이브 번호를 반환하고, 그렇지 않으면 -1을 반환합니다.

설명

자세한 내용은 PathGetDriveNumber를 참조 하세요.

CPathT::GetExtension

이 메서드를 호출하여 경로에서 파일 확장자를 가져옵니다.

StringType GetExtension() const;

Return Value

파일 확장자를 반환합니다.

CPathT::IsDirectory

경로가 유효한 디렉터리인지 확인하려면 이 메서드를 호출합니다.

BOOL IsDirectory() const;

Return Value

경로가 디렉터리이면 0이 아닌 값(16)을 반환하고, 그렇지 않으면 FALSE를 반환합니다.

설명

자세한 내용은 PathIsDirectory를 참조 하세요.

CPathT::IsFileSpec

경로 구분 문자(예 : : 또는 \)에 대한 경로를 검색하려면 이 메서드를 호출합니다. 경로 구분 문자가 없는 경우 경로는 파일 사양 경로로 간주됩니다.

BOOL IsFileSpec() const;

Return Value

경로 내에 경로 구분 문자가 없으면 TRUE를 반환하고, 경로 구분 문자가 있으면 FALSE를 반환합니다.

설명

자세한 내용은 PathIsFileSpec을 참조하세요.

CPathT::IsPrefix

이 메서드를 호출하여 경로에 pszPrefix에서 전달한 형식의 유효한 접두사를 포함하는지 여부를 확인합니다.

BOOL IsPrefix(PCXSTR pszPrefix) const;

매개 변수

pszPrefix
검색할 접두사입니다. 접두사는 "C:\\", ".", "..", ".. 형식 중 하나입니다. \\".

Return Value

경로에 접두사를 포함하면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.

설명

자세한 내용은 PathIsPrefix를 참조 하세요.

CPathT::IsRelative

경로가 상대 경로인지 확인하려면 이 메서드를 호출합니다.

BOOL IsRelative() const;

Return Value

경로가 상대 경로이면 TRUE를 반환하고, 절대 경로인 경우 FALSE를 반환합니다.

설명

자세한 내용은 PathIsRelative을 참조하세요.

CPathT::IsRoot

이 메서드를 호출하여 경로가 디렉터리 루트인지 확인합니다.

BOOL IsRoot() const;

Return Value

경로가 루트이면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.

설명

자세한 내용은 PathIsRoot를 참조하세요.

CPathT::IsSameRoot

이 메서드를 호출하여 다른 경로에 현재 경로가 있는 공통 루트 구성 요소가 있는지 확인합니다.

BOOL IsSameRoot(PCXSTR pszOther) const;

매개 변수

pszOther
다른 경로입니다.

Return Value

두 문자열에 루트 구성 요소가 같으면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.

설명

자세한 내용은 PathIsSameRoot를 참조하세요.

CPathT::IsUNC

이 메서드를 호출하여 경로가 서버 및 공유에 대한 유효한 UNC(범용 명명 규칙) 경로인지 여부를 확인합니다.

BOOL IsUNC() const;

Return Value

경로가 유효한 UNC 경로이면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.

설명

자세한 내용은 PathIsUNC를 참조 하세요.

CPathT::IsUNCServer

이 메서드를 호출하여 해당 경로가 서버에만 유효한 UNC(범용 명명 규칙) 경로인지 여부를 확인합니다.

BOOL IsUNCServer() const;

Return Value

문자열이 서버에만 유효한 UNC 경로(공유 이름 없음)이면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.

설명

자세한 내용은 PathIsUNCServer를 참조 하세요.

CPathT::IsUNCServerShare

이 메서드를 호출하여 경로가 유효한 UNC(범용 명명 규칙) 공유 경로인 \\ 서버\ 공유인지 여부를 확인합니다.

BOOL IsUNCServerShare() const;

Return Value

경로가 \\ 서버\ 공유 형식이면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.

설명

자세한 내용은 PathIsUNCServerShare를 참조 하세요.

CPathT::m_strPath

경로입니다.

StringType m_strPath;

설명

StringType 는 .에 대한 템플릿 매개 변수입니다 CPathT.

CPathT::MakePretty

경로를 모든 소문자로 변환하여 경로에 일관된 모양을 지정하려면 이 메서드를 호출합니다.

BOOL MakePretty();

Return Value

경로가 변환된 경우 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.

설명

자세한 내용은 PathMakePretty를 참조 하세요.

CPatht::MatchSpec

이 메서드를 호출하여 와일드카드 일치 형식이 포함된 문자열의 경로를 검색합니다.

BOOL MatchSpec(PCXSTR pszSpec) const;

매개 변수

pszSpec
검색할 파일 형식이 있는 null로 끝나는 문자열에 대한 포인터입니다. 예를 들어 현재 경로의 파일이 DOC 파일 인지 테스트하려면 pszSpec 을 "*.doc"로 설정해야 합니다.

Return Value

문자열이 일치하면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.

설명

자세한 내용은 PathMatchSpec을 참조하세요.

CPathT::operator +=

이 연산자는 경로에 문자열을 추가합니다.

CPathT<StringType>& operator+=(PCXSTR pszMore);

매개 변수

pszMore
추가할 문자열입니다.

Return Value

업데이트된 경로를 반환합니다.

CPathT::operator const StringType &

이 연산자를 사용하면 개체를 문자열처럼 처리할 수 있습니다.

operator const StringType&() const throw();

Return Value

이 개체에서 관리하는 현재 경로를 나타내는 문자열을 반환합니다.

CPathT::operator CPathT::P CXSTR

이 연산자를 사용하면 개체를 문자열처럼 처리할 수 있습니다.

operator PCXSTR() const throw();

Return Value

이 개체에서 관리하는 현재 경로를 나타내는 문자열을 반환합니다.

CPathT::operator StringType &

이 연산자를 사용하면 개체를 문자열처럼 처리할 수 있습니다.

operator StringType&() throw();

Return Value

이 개체에서 관리하는 현재 경로를 나타내는 문자열을 반환합니다.

CPathT::P CXSTR

상수 문자열 형식입니다.

typedef StringType::PCXSTR PCXSTR;

설명

StringType 는 .에 대한 템플릿 매개 변수입니다 CPathT.

CPathT::P XSTR

문자열 형식입니다.

typedef StringType::PXSTR PXSTR;

설명

StringType 는 .에 대한 템플릿 매개 변수입니다 CPathT.

CPathT::QuoteSpaces

공백이 있는 경우 이 메서드를 호출하여 경로를 따옴표로 묶습니다.

void QuoteSpaces();

설명

자세한 내용은 PathQuoteSpaces를 참조 하세요.

CPathT::RelativePathTo

이 메서드를 호출하여 한 파일 또는 폴더에서 다른 파일로의 상대 경로를 만듭니다.

BOOL RelativePathTo(
    PCXSTR pszFrom,
    DWORD dwAttrFrom,
    PCXSTR pszTo,
    DWORD dwAttrTo);

매개 변수

pszFrom
상대 경로의 시작입니다.

dwAttrFrom
pszFrom의 파일 특성입니다. 이 값에 FILE_ATTRIBUTE_DIRECTORY 포함된 경우 pszFrom 은 디렉터리로 간주됩니다. 그렇지 않으면 pszFrom 은 파일로 간주됩니다.

pszTo
상대 경로의 끝점입니다.

dwAttrTo
pszTo의 파일 특성입니다. 이 값에 FILE_ATTRIBUTE_DIRECTORY 포함된 경우 pszTo 는 디렉터리로 간주됩니다. 그렇지 않으면 pszTo 는 파일로 간주됩니다.

Return Value

성공하면 TRUE를 반환하고 실패하면 FALSE를 반환합니다.

설명

자세한 내용은 PathRelativePathTo를 참조 하세요.

CPathT::RemoveArgs

이 메서드를 호출하여 경로에서 명령줄 인수를 제거합니다.

void RemoveArgs();

설명

자세한 내용은 PathRemoveArgs를 참조 하세요.

CPathT::RemoveBackslash

경로에서 후행 백슬래시를 제거하려면 이 메서드를 호출합니다.

void RemoveBackslash();

설명

자세한 내용은 PathRemoveBackslash를 참조 하세요.

CPathT::RemoveBlanks

이 메서드를 호출하여 경로에서 모든 선행 및 후행 공백을 제거합니다.

void RemoveBlanks();

설명

자세한 내용은 PathRemoveBlanks를 참조 하세요.

CPathT::RemoveExtension

경로에서 파일 확장명(있는 경우)을 제거하려면 이 메서드를 호출합니다.

void RemoveExtension();

설명

자세한 내용은 PathRemoveExtension을 참조 하세요.

CPathT::RemoveFileSpec

이 메서드를 호출하여 경로에서 후행 파일 이름과 백슬래시를 제거합니다(있는 경우).

BOOL RemoveFileSpec();

Return Value

성공하면 TRUE를 반환하고 실패하면 FALSE를 반환합니다.

설명

자세한 내용은 PathRemoveFileSpec을 참조하세요.

CPathT::RenameExtension

경로의 파일 이름 확장명을 새 확장명으로 바꾸려면 이 메서드를 호출합니다. 파일 이름에 확장명을 포함하지 않으면 확장명은 경로 끝에 연결됩니다.

BOOL RenameExtension(PCXSTR pszExtension);

매개 변수

pszExtension
"." 문자 앞에 오는 새 파일 이름 확장명입니다.

Return Value

성공하면 TRUE를 반환하고 실패하면 FALSE를 반환합니다.

설명

자세한 내용은 PathRenameExtension을 참조 하세요.

CPathT::SkipRoot

드라이브 문자 또는 UNC(범용 명명 규칙) 서버/공유 경로 부분을 무시하고 경로를 구문 분석하려면 이 메서드를 호출합니다.

int SkipRoot() const;

Return Value

루트(드라이브 문자 또는 UNC 서버/공유)를 따르는 하위 경로의 시작 위치를 반환합니다.

설명

자세한 내용은 PathSkipRoot를 참조하세요.

CPathT::StripPath

정규화된 경로 및 파일 이름의 경로 부분을 제거하려면 이 메서드를 호출합니다.

void StripPath();

설명

자세한 내용은 PathStripPath를 참조 하세요.

CPathT::StripToRoot

루트 정보를 제외한 경로의 모든 부분을 제거하려면 이 메서드를 호출합니다.

BOOL StripToRoot();

Return Value

경로에 유효한 드라이브 문자가 있으면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.

설명

자세한 내용은 PathStripToRoot를 참조하세요.

CPathT::UnquoteSpaces

경로의 시작과 끝에서 따옴표를 제거하려면 이 메서드를 호출합니다.

void UnquoteSpaces();

설명

자세한 내용은 PathUnquoteSpaces를 참조 하세요.

CPathT::XCHAR

문자 형식입니다.

typedef StringType::XCHAR XCHAR;

설명

StringType 는 .에 대한 템플릿 매개 변수입니다 CPathT.

참고 항목

클래스
CStringT 클래스