الفئة System::IO::Path

Path class

يوفر طرقًا لمعالجة المسارات. هذا نوع ثابت دون خدمات مثيل. لا يجب عليك أبدًا إنشاء مثيلات له بأي طريقة.

class Path

الطرق

طريقةالوصف
static ChangeExtension(const String&, const String&)يغيّر الامتداد في مسار الملف المحدد.
static CheckPath(const String&, const String&, bool)يحدد ما إذا كان المسار المحدد صالحًا عن طريق التحقق مما إذا كان يحتوي على أحرف غير صالحة. تُرمى استثناء إذا كان المسار يحتوي على أحرف غير صالحة.
static Combine(const ArrayPtr<String>&)يجمع أجزاء المسار المحددة في مسار واحد مع إدراج فواصل الأدلة بين الأجزاء إذا لزم الأمر.
static Combine(const String&, const String&)يجمع جزئين محددين من المسار في مسار واحد مع إدراج فاصل دليل بين الجزأين إذا لزم الأمر.
static Combine(const String&, const String&, const String&)يجمع ثلاثة أجزاء محددة من المسار في مسار واحد مع إدراج فواصل الأدلة بين الأجزاء إذا لزم الأمر.
static Combine(const String&, const String&, const String&, const String&)يجمع أربعة أجزاء محددة من المسار في مسار واحد مع إدراج فواصل الأدلة بين الأجزاء إذا لزم الأمر.
static GetDirectoryName(const String&)يعيد اسم الدليل المشار إليه بالمسار المحدد.
static GetExtension(const String&)يعيد امتداد الملف المشار إليه بالمسار المحدد.
static GetFileName(const String&)يعيد اسم الملف المشار إليه بالمسار المحدد.
static GetFileNameWithoutExtension(const String&)يعيد اسم الملف بدون امتداد للملف المشار إليه بالمسار المحدد.
static GetFullPath(const String&)يحوّل المسار المحدد إلى مسار مطلق.
static GetInvalidFileNameChars()يعيد مصفوفة تحتوي على أحرف غير مسموح بها في أسماء الملفات.
static GetInvalidPathChars()يعيد مصفوفة تحتوي على أحرف غير مسموح بها في أسماء المسارات.
static GetPathRoot(const String&)يعيد الدليل الجذر للمسار المحدد.
static GetRandomFileName()يعيد اسم ملف تم إنشاؤه عشوائيًا.
static GetTempFileName_()ينشئ ملفًا جديدًا باسم فريد ويعيد مسارًا كاملاً إليه.
static GetTempFileNameSafe()ينشئ ملفًا جديدًا باسم فريد ويعيد مسارًا كاملاً إليه. وهو مرادف لطريقة GetTempFileName_().
static GetTempPath()يعيد مسار دليل المؤقت للمستخدم الحالي.
static HasExtension(const String&)يحدد ما إذا كان المسار المحدد يشير إلى ملف بامتداد.
static IsPathRooted(const String&)يحدد ما إذا كان المسار المحدد يحتوي على جذر.
static NormalizePath(const String&)يقوم بتطبيع المسار المحدد.
static ToBoost(const String&)يعيد مثالًا من الفئة boost::filesystem::path التي تمثل المسار المحدد.
static ToString(const boost::filesystem::path&)يعيد تمثيلًا نصيًا لكائن المسار الخاص بـ Boost المحدد.

الحقول

حقلالوصف
static AltDirectorySeparatorCharحرف بديل يُستخدم لفصل مستويات الدليل في المسار.
static DirectorySeparatorCharحرف يُستخدم لفصل مستويات الدليل في المسار.
static PathSeparatorحرف فاصل يُستخدم لفصل سلاسل المسارات في متغيرات البيئة.
static VolumeSeparatorCharحرف فاصل للقرص.

ملاحظات

#include "system/io/path.h"
#include <iostream>

int main()
{
  using namespace System::IO;

  // إنشاء اسم ملف عشوائي.
  auto filename = Path::GetRandomFileName();

  // طباعة معلومات حول اسم الملف.
  std::cout <<
    "Filename: " << Path::GetFileName(filename) << std::endl <<
    "Filename w/o an extension: " << Path::GetFileNameWithoutExtension(filename) << std::endl <<
    "Extension: " << Path::GetExtension(filename) << std::endl;

  return 0;
}
/*
This code example produces the following output:
Filename: qhuzkyqv.y6p
Filename w/o an extension: qhuzkyqv
Extension: .y6p
*/

انظر أيضًا