CPathT – třída
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.
Návratová 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.
Návratová 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í.
Návratová 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.
Návratová 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.
Návratová 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;
Návratová 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;
Návratová 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;
Návratová 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;
Návratová 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;
Návratová 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;
Návratová 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;
Návratová 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:\\", ".", ".", "." \\".
Návratová 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;
Návratová 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;
Návratová 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.
Návratová 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;
Návratová 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;
Návratová 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;
Návratová 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();
Návratová 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.
Návratová 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.
Návratová 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();
Návratová 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();
Návratová 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();
Návratová 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.
Návratová 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();
Návratová 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 ".
Návratová 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;
Návratová 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();
Návratová 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.