Sdílet prostřednictvím

CPathT – třída

  • Článek

Tato třída představuje cestu.

Důležité

Tuto třídu a její členy nelze použít v aplikacích, které se spouští v prostředí Windows Runtime.

Syntaxe

template <typename StringType>
class CPathT

Parametry

StringType
Třída řetězců ATL/MFC, která se má použít pro cestu (viz CStringT).

Členové

Veřejné definice typedef

Název Popis
CPathT::P CXSTR Typ konstantního řetězce.
CPathT::P XSTR Typ řetězce.
CPathT::XCHAR Typ znaku.

Veřejné konstruktory

Název Popis
CPathT::CPathT Konstruktor pro cestu.

Veřejné metody

Název Popis
CPathT::AddBackslash Voláním této metody přidáte zpětné lomítko na konec řetězce a vytvoříte správnou syntaxi cesty.
CPathT::AddExtension Voláním této metody přidáte příponu souboru do cesty.
CPathT::Append Voláním této metody připojíte řetězec k aktuální cestě.
CPathT::BuildRoot Voláním této metody vytvoříte kořenovou cestu z daného čísla jednotky.
CPathT::Canonicalize Voláním této metody převedete cestu na kanonický formulář.
CPathT::Combine Voláním této metody zřetězení řetězce představujícího název adresáře a řetězec představující název cesty k souboru do jedné cesty.
CPathT::CommonPrefix Voláním této metody určíte, zda zadaná cesta sdílí společnou předponu s aktuální cestou.
CPathT::CompactPath Voláním této metody zkrátíte cestu k souboru tak, aby odpovídala dané šířce pixelů nahrazením komponent cesty třemi tečkami.
CPathT::CompactPathEx Voláním této metody zkrátíte cestu k souboru tak, aby odpovídala danému počtu znaků nahrazením komponent cesty třemi tečkami.
CPathT::FileExists Voláním této metody zkontrolujte, zda soubor v této cestě existuje.
CPathT::FindExtension Voláním této metody vyhledejte pozici přípony souboru v cestě.
CPathT::FindFileName Voláním této metody vyhledejte pozici názvu souboru v cestě.
CPathT::GetDriveNumber Voláním této metody vyhledejte cestu písmena jednotky v rozsahu "A" až "Z" a vrátí odpovídající číslo jednotky.
CPathT::GetExtension Voláním této metody získáte příponu souboru z cesty.
CPathT::IsDirectory Voláním této metody zkontrolujte, zda je cesta platným adresářem.
CPathT::IsFileSpec Voláním této metody vyhledejte cestu pro všechny znaky s oddělovači cest (například : ).\ Pokud neexistují žádné znaky s oddělovači cest, cesta se považuje za cestu specifikace souboru.
CPathT::IsPrefix Voláním této metody určíte, zda cesta obsahuje platnou předponu typu předaného pszPrefix.
CPathT::IsRelative Voláním této metody určíte, zda je cesta relativní.
CPathT::IsRoot Voláním této metody určíte, jestli je cesta kořenem adresáře.
CPathT::IsSameRoot Voláním této metody určíte, zda má jiná cesta společnou kořenovou komponentu s aktuální cestou.
CPathT::IsUNC Voláním této metody určíte, jestli je cesta platnou cestou UNC (universal naming convention) pro server a sdílenou složku.
CPathT::IsUNCServer Voláním této metody určíte, zda je cesta platnou cestou UNC (universal naming convention) pouze pro server.
CPathT::IsUNCServerShare Voláním této metody určíte, zda cesta je platná cesta UNC (universal pojmenování konvence) sdílené cesty, \\server\share.
CPathT::MakePretty Voláním této metody převedete cestu na všechna malá písmena, aby cesta byla konzistentní.
CPathT::MatchSpec Voláním této metody vyhledejte cestu pro řetězec obsahující typ shody se zástupnými znaky.
CPathT::QuoteSpaces Voláním této metody uzavřete cestu do uvozovek, pokud obsahuje nějaké mezery.
CPathT::RelativePathTo Voláním této metody vytvoříte relativní cestu z jednoho souboru nebo složky do jiné.
CPathT::RemoveArgs Voláním této metody odeberete z cesty všechny argumenty příkazového řádku.
CPathT::RemoveBackslash Voláním této metody odeberete koncové zpětné lomítko z cesty.
CPathT::RemoveBlanks Voláním této metody odeberete všechny úvodní a koncové mezery z cesty.
CPathT::RemoveExtension Voláním této metody odeberete příponu souboru z cesty, pokud existuje.
CPathT::RemoveFileSpec Voláním této metody odeberete koncový název souboru a zpětné lomítko z cesty, pokud je obsahuje.
CPathT::RenameExtension Voláním této metody nahraďte příponu názvu souboru v cestě novou příponou. Pokud název souboru neobsahuje příponu, bude přípona připojena ke konci řetězce.
CPathT::SkipRoot Voláním této metody parsujte cestu a ignorujete písmeno jednotky nebo části cesty UNC serveru nebo sdílené složky.
CPathT::StripPath Voláním této metody odeberete část cesty plně kvalifikované cesty a názvu souboru.
CPathT::StripToRoot Voláním této metody odeberete všechny části cesty s výjimkou kořenových informací.
CPathT::UnquoteSpaces Voláním této metody odeberete uvozovky od začátku a konce cesty.

Veřejné operátory

Název Popis
CPathT::operator const StringType & Tento operátor umožňuje, aby objekt byl považován za řetězec.
CPathT::operator CPathT::P CXSTR Tento operátor umožňuje, aby objekt byl považován za řetězec.
CPathT::operator StringType & Tento operátor umožňuje, aby objekt byl považován za řetězec.
CPathT::operator += Tento operátor připojí řetězec k cestě.

Veřejné datové členy

Název Popis
CPathT::m_strPath Cesta.

Poznámky

CPath, CPathAa CPathW jedná se o vytváření instancí definovaných CPathT takto:

typedef CPathT< CString > CPath;

typedef CPathT< CStringA > CPathA;

typedef CPathT< CStringW > CPathW;

Požadavky

Hlavička: atlpath.h

CPathT::AddBackslash

Voláním této metody přidáte zpětné lomítko na konec řetězce a vytvoříte správnou syntaxi cesty. Pokud už cesta obsahuje koncové zpětné lomítko, nepřidá se žádné zpětné lomítko.

void AddBackslash();

Poznámky

Další informace naleznete v tématu PathAddBackSlash.

CPathT::AddExtension

Voláním této metody přidáte příponu souboru do cesty.

BOOL AddExtension(PCXSTR pszExtension);

Parametry

pszExtension
Přípona souboru, který chcete přidat.

Vrácená hodnota

Vrátí hodnotu PRAVDA při úspěchu, NEPRAVDA při selhání.

Poznámky

Další informace naleznete v tématu PathAddExtension.

CPathT::Append

Voláním této metody připojíte řetězec k aktuální cestě.

BOOL Append(PCXSTR pszMore);

Parametry

pszMore
Řetězec, který se má připojit.

Vrácená hodnota

Vrátí hodnotu PRAVDA při úspěchu, NEPRAVDA při selhání.

Poznámky

Další informace najdete v tématu PathAppend.

CPathT::BuildRoot

Voláním této metody vytvoříte kořenovou cestu z daného čísla jednotky.

void BuildRoot(int iDrive);

Parametry

Idrive
Číslo jednotky (0 je A:, 1 je B:atd.).

Poznámky

Další informace naleznete v tématu PathBuildRoot.

CPathT::Canonicalize

Voláním této metody převedete cestu na kanonický formulář.

void Canonicalize();

Poznámky

Další informace naleznete v tématu PathCanonicalize.

CPathT::Combine

Voláním této metody zřetězení řetězce představujícího název adresáře a řetězec představující název cesty k souboru do jedné cesty.

void Combine(PCXSTR pszDir, PCXSTR  pszFile);

Parametry

pszDir
Cesta k adresáři.

pszFile
Cesta k souboru.

Poznámky

Další informace naleznete v tématu PathCombine.

CPathT::CommonPrefix

Voláním této metody určíte, zda zadaná cesta sdílí společnou předponu s aktuální cestou.

CPathT<StringType> CommonPrefix(PCXSTR pszOther);

Parametry

pszOther
Cesta, která se má porovnat s aktuální.

Vrácená hodnota

Vrátí společnou předponu.

Poznámky

Předpona je jedním z těchto typů: "C:\\", ".", ".", "." \\". Další informace naleznete v tématu PathCommonPrefix.

CPathT::CompactPath

Voláním této metody zkrátíte cestu k souboru tak, aby odpovídala dané šířce pixelů nahrazením komponent cesty třemi tečkami.

BOOL CompactPath(HDC hDC, UINT nWidth);

Parametry

Hdc
Kontext zařízení používaný pro metriky písem.

nWidth
Šířka v pixelech, do které se řetězec bude muset vejít.

Vrácená hodnota

Vrátí hodnotu PRAVDA při úspěchu, NEPRAVDA při selhání.

Poznámky

Další informace naleznete v tématu PathCompactPath.

CPathT::CompactPathEx

Voláním této metody zkrátíte cestu k souboru tak, aby odpovídala danému počtu znaků nahrazením komponent cesty třemi tečkami.

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

Parametry

nMaxChars
Maximální počet znaků obsažených v novém řetězci, včetně ukončujícího znaku NULL.

dwFlags
Vyhrazeno.

Vrácená hodnota

Vrátí hodnotu PRAVDA při úspěchu, NEPRAVDA při selhání.

Poznámky

Další informace naleznete v tématu PathCompactPathEx.

CPathT::CPathT

Konstruktor

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

Parametry

pszPath
Ukazatel na řetězec cesty.

path
Řetězec cesty.

CPathT::FileExists

Voláním této metody zkontrolujte, zda soubor v této cestě existuje.

BOOL FileExists() const;

Vrácená hodnota

Vrátí hodnotu TRUE, pokud soubor existuje, jinak nepravda.

Poznámky

Další informace naleznete v tématu PathFileExists.

CPathT::FindExtension

Voláním této metody vyhledejte pozici přípony souboru v cestě.

int FindExtension() const;

Vrácená hodnota

Vrátí pozici znaku "." předcházející přípony. Pokud se nenajde žádné rozšíření, vrátí hodnotu -1.

Poznámky

Další informace naleznete v tématu PathFindExtension.

CPathT::FindFileName

Voláním této metody vyhledejte pozici názvu souboru v cestě.

int FindFileName() const;

Vrácená hodnota

Vrátí pozici názvu souboru. Pokud nebyl nalezen žádný název souboru, vrátí hodnotu -1.

Poznámky

Další informace naleznete v tématu PathFindFileName.

CPathT::GetDriveNumber

Voláním této metody vyhledejte cestu písmena jednotky v rozsahu "A" až "Z" a vrátí odpovídající číslo jednotky.

int GetDriveNumber() const;

Vrácená hodnota

Vrátí číslo jednotky jako celé číslo od 0 do 25 (odpovídající "A" až 'Z'), pokud cesta obsahuje písmeno jednotky, nebo -1 jinak.

Poznámky

Další informace naleznete v tématu PathGetDriveNumber.

CPathT::GetExtension

Voláním této metody získáte příponu souboru z cesty.

StringType GetExtension() const;

Vrácená hodnota

Vrátí příponu souboru.

CPathT::IsDirectory

Voláním této metody zkontrolujte, zda je cesta platným adresářem.

BOOL IsDirectory() const;

Vrácená hodnota

Vrátí nenulovou hodnotu (16), pokud je cesta adresář, jinak NEPRAVDA.

Poznámky

Další informace naleznete v tématu PathIsDirectory.

CPathT::IsFileSpec

Voláním této metody vyhledejte cestu pro všechny znaky s oddělovači cest (například : ).\ Pokud neexistují žádné znaky s oddělovači cest, cesta se považuje za cestu specifikace souboru.

BOOL IsFileSpec() const;

Vrácená hodnota

Vrátí hodnotu TRUE, pokud v cestě nejsou žádné znaky s oddělovači cest nebo NEPRAVDA, pokud existují znaky s oddělovači cest.

Poznámky

Další informace naleznete v tématu PathIsFileSpec.

CPathT::IsPrefix

Voláním této metody určíte, zda cesta obsahuje platnou předponu typu předaného pszPrefix.

BOOL IsPrefix(PCXSTR pszPrefix) const;

Parametry

pszPrefix
Předpona, pro kterou se má hledat. Předpona je jedním z těchto typů: "C:\\", ".", ".", "." \\".

Vrácená hodnota

Vrátí hodnotu PRAVDA, pokud cesta obsahuje předponu nebo hodnotu FALSE.

Poznámky

Další informace naleznete v tématu PathIsPrefix.

CPathT::IsRelative

Voláním této metody určíte, zda je cesta relativní.

BOOL IsRelative() const;

Vrácená hodnota

Vrátí hodnotu TRUE, pokud je cesta relativní, nebo NEPRAVDA, pokud je absolutní.

Poznámky

Další informace naleznete v tématu PathIsRelative.

CPathT::IsRoot

Voláním této metody určíte, jestli je cesta kořenem adresáře.

BOOL IsRoot() const;

Vrácená hodnota

Vrátí hodnotu TRUE, pokud je cesta kořenem nebo nepravda jinak.

Poznámky

Další informace naleznete v tématu PathIsRoot.

CPathT::IsSameRoot

Voláním této metody určíte, zda má jiná cesta společnou kořenovou komponentu s aktuální cestou.

BOOL IsSameRoot(PCXSTR pszOther) const;

Parametry

pszOther
Druhá cesta.

Vrácená hodnota

Vrátí hodnotu TRUE, pokud oba řetězce mají stejnou kořenovou komponentu nebo hodnotu FALSE.

Poznámky

Další informace naleznete v tématu PathIsSameRoot.

CPathT::IsUNC

Voláním této metody určíte, jestli je cesta platnou cestou UNC (universal naming convention) pro server a sdílenou složku.

BOOL IsUNC() const;

Vrácená hodnota

Vrátí hodnotu TRUE, pokud je cesta platnou cestou UNC nebo nepravda jinak.

Poznámky

Další informace naleznete v tématu PathIsUNC.

CPathT::IsUNCServer

Voláním této metody určíte, zda je cesta platnou cestou UNC (universal naming convention) pouze pro server.

BOOL IsUNCServer() const;

Vrácená hodnota

Vrátí hodnotu TRUE, pokud je řetězec platnou cestou UNC pouze pro server (bez názvu sdílené složky) nebo NEPRAVDA jinak.

Poznámky

Další informace naleznete v tématu PathIsUNCServer.

CPathT::IsUNCServerShare

Voláním této metody určíte, zda je cesta platná cesta UNC (universal naming convention) cesta ke sdílené složce, \\ sdílená složka serveru\ .

BOOL IsUNCServerShare() const;

Vrácená hodnota

Vrátí hodnotu TRUE, pokud je cesta ve formátu \\ sdílená složka serveru\ nebo NEPRAVDA jinak.

Poznámky

Další informace naleznete v tématu PathIsUNCServerShare.

CPathT::m_strPath

Cesta.

StringType m_strPath;

Poznámky

StringType je parametr šablony pro CPathT.

CPathT::MakePretty

Voláním této metody převedete cestu na všechna malá písmena, aby cesta byla konzistentní.

BOOL MakePretty();

Vrácená hodnota

Vrátí hodnotu PRAVDA, pokud byla cesta převedena, nebo nePRAVDA jinak.

Poznámky

Další informace naleznete v tématu PathMakePretty.

CPathT::MatchSpec

Voláním této metody vyhledejte cestu pro řetězec obsahující typ shody se zástupnými znaky.

BOOL MatchSpec(PCXSTR pszSpec) const;

Parametry

pszSpec
Ukazatel na řetězec ukončený hodnotou null s typem souboru, pro který se má hledat. Pokud chcete například otestovat, jestli je soubor na aktuální cestě soubor DOC, měl by být soubor pszSpec nastavený na *.doc.

Vrácená hodnota

Vrátí hodnotu PRAVDA, pokud se řetězec shoduje nebo jinak NEPRAVDA.

Poznámky

Další informace naleznete v tématu PathMatchSpec.

CPathT::operator +=

Tento operátor připojí řetězec k cestě.

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

Parametry

pszMore
Řetězec, který se má připojit.

Vrácená hodnota

Vrátí aktualizovanou cestu.

CPathT::operator const StringType &

Tento operátor umožňuje, aby objekt byl považován za řetězec.

operator const StringType&() const throw();

Vrácená hodnota

Vrátí řetězec představující aktuální cestu spravovanou tímto objektem.

CPathT::operator CPathT::P CXSTR

Tento operátor umožňuje, aby objekt byl považován za řetězec.

operator PCXSTR() const throw();

Vrácená hodnota

Vrátí řetězec představující aktuální cestu spravovanou tímto objektem.

CPathT::operator StringType &

Tento operátor umožňuje, aby objekt byl považován za řetězec.

operator StringType&() throw();

Vrácená hodnota

Vrátí řetězec představující aktuální cestu spravovanou tímto objektem.

CPathT::P CXSTR

Typ konstantního řetězce.

typedef StringType::PCXSTR PCXSTR;

Poznámky

StringType je parametr šablony pro CPathT.

CPathT::P XSTR

Typ řetězce.

typedef StringType::PXSTR PXSTR;

Poznámky

StringType je parametr šablony pro CPathT.

CPathT::QuoteSpaces

Voláním této metody uzavřete cestu do uvozovek, pokud obsahuje nějaké mezery.

void QuoteSpaces();

Poznámky

Další informace naleznete v tématu PathQuoteSpaces.

CPathT::RelativePathTo

Voláním této metody vytvoříte relativní cestu z jednoho souboru nebo složky do jiné.

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

Parametry

pszFrom
Začátek relativní cesty.

dwAttrFrom
Atributy File pszFrom. Pokud tato hodnota obsahuje FILE_ATTRIBUTE_DIRECTORY, předpokládá se, že pszFrom je adresář; jinak se předpokládá, že pszFrom je soubor.

pszTo
Koncový bod relativní cesty.

dwAttrTo
Atributy Souboru pszTo. Pokud tato hodnota obsahuje FILE_ATTRIBUTE_DIRECTORY, předpokládá se, že pszTo je adresář; jinak se předpokládá, že pszTo je soubor.

Vrácená hodnota

Vrátí hodnotu PRAVDA při úspěchu, NEPRAVDA při selhání.

Poznámky

Další informace naleznete v tématu PathRelativePathTo.

CPathT::RemoveArgs

Voláním této metody odeberete z cesty všechny argumenty příkazového řádku.

void RemoveArgs();

Poznámky

Další informace naleznete v tématu PathRemoveArgs.

CPathT::RemoveBackslash

Voláním této metody odeberete koncové zpětné lomítko z cesty.

void RemoveBackslash();

Poznámky

Další informace naleznete v tématu PathRemoveBackslash.

CPathT::RemoveBlanks

Voláním této metody odeberete všechny úvodní a koncové mezery z cesty.

void RemoveBlanks();

Poznámky

Další informace naleznete v tématu PathRemoveBlanks.

CPathT::RemoveExtension

Voláním této metody odeberete příponu souboru z cesty, pokud existuje.

void RemoveExtension();

Poznámky

Další informace naleznete v tématu PathRemoveExtension.

CPathT::RemoveFileSpec

Voláním této metody odeberete koncový název souboru a zpětné lomítko z cesty, pokud je obsahuje.

BOOL RemoveFileSpec();

Vrácená hodnota

Vrátí hodnotu PRAVDA při úspěchu, NEPRAVDA při selhání.

Poznámky

Další informace naleznete v tématu PathRemoveFileSpec.

CPathT::RenameExtension

Voláním této metody nahraďte příponu názvu souboru v cestě novou příponou. Pokud název souboru neobsahuje příponu, bude přípona připojena ke konci cesty.

BOOL RenameExtension(PCXSTR pszExtension);

Parametry

pszExtension
Nová přípona názvu souboru, která předchází znaku ".

Vrácená hodnota

Vrátí hodnotu PRAVDA při úspěchu, NEPRAVDA při selhání.

Poznámky

Další informace naleznete v tématu PathRenameExtension.

CPathT::SkipRoot

Voláním této metody parsujte cestu a ignorujete písmeno jednotky nebo části cesty UNC (universal naming convention).

int SkipRoot() const;

Vrácená hodnota

Vrátí pozici začátku dílčí cesty, která následuje za kořenem (písmeno jednotky nebo server/sdílená složka UNC).

Poznámky

Další informace naleznete v tématu PathSkipRoot.

CPathT::StripPath

Voláním této metody odeberete část cesty plně kvalifikované cesty a názvu souboru.

void StripPath();

Poznámky

Další informace naleznete v tématu PathStripPath.

CPathT::StripToRoot

Voláním této metody odeberete všechny části cesty s výjimkou kořenových informací.

BOOL StripToRoot();

Vrácená hodnota

Vrátí hodnotu TRUE, pokud bylo v cestě nalezeno platné písmeno jednotky nebo nepravda jinak.

Poznámky

Další informace naleznete v tématu PathStripToRoot.

CPathT::UnquoteSpaces

Voláním této metody odeberete uvozovky od začátku a konce cesty.

void UnquoteSpaces();

Poznámky

Další informace naleznete v tématu PathUnquoteSpaces.

CPathT::XCHAR

Typ znaku.

typedef StringType::XCHAR XCHAR;

Poznámky

StringType je parametr šablony pro CPathT.

Viz také

Třídy
CStringT – třída