مسیر پرونده filepath
تابعهای مسیر پرونده بدون نیاز به سیستم پرونده؛ همان کارهای بستهی مسیر.
واردسازی مسیر پرونده
نام آرگومانها شناسهی خود کد است و معادل فارسی ندارد؛ گونهها، کلیدواژهها و نام بستهها با معادل فارسی نوشته میشوند.
بستهی مسیر پرونده رشتههای مسیر را از هم باز میکند و میسازد: پیوند، پوشه، نام پایه، پسوند، نام بدون پسوند، پاک سازی، مسیر مطلق، مسیر نسبی و بررسی مسیر امن است برای مسیرهایی که از کاربر میآیند. فقط با رشتهها کار میکند و به سیستم پرونده دست نمیزند، بهجز مسیر مطلق، مسیر نسبی و مسیر امن است که برای مسیر نسبی پوشهی جاری را میخوانند. جای کاربردش ابزارهای ساخت، سازندههای سایت ایستا، پردازش بارگذاریها و هر جایی است که مسیر حساب میشود نه تایپ. برای کار روی خود پروندهها آن را کنار سیستم پرونده، پوشه یا سیستم عامل بگذارید.
بستهی مسیر نامهای دیگری برای همین تابعهاست؛ هر کدام را که راحتترید به کار ببرید، ولی در هر برنامه فقط یکی را.
نامها در دو بسته کمی فرق دارند و این فرق گیجکننده است: نام پایه در این بسته نام پرونده با پسوند را میدهد (cv.pdf)، ولی نام پایه در بستهی مسیر پسوند را برمیدارد (cv). پوشه اینجا همان نام پوشه آنجاست. مسیرها همیشه با جداکنندهی / برمیگردند، در ویندوز هم، و ویندوز این را میپذیرد.
اشتباههای رایج:
- انتظار اینکه
پیوندنتیجه را ساده کند. فقط یک/میان دو بخش میگذارد:پیوند("a/b"، "../c")برابرa/b/../cاست و بخش دوم مطلق هم به انتها افزوده میشود، نه اینکه جایگزین شود. پس از آنپاک سازیرا صدا بزنید. - مقایسهی مسیرها مثل متن ساده. اول هر دو را ساده کنید و به یاد داشته باشید که مقایسه به بزرگی و کوچکی حرف حساس است.
- اعتماد به مسیر کاربر بدون
مسیر امن است. حتی پس ازپیوند،../../etc/passwdاز پوشهی شما بیرون میزند.
مسیرهای ویندوز
مسیری که کاربر ویندوز چسبانده یا از پروندهی تنظیمات ویندوزی خوانده شده \ دارد. همهی تابعهای این بسته اول نرمال سازی را صدا میزنند، پس پوشه، نام پایه و پیوند هر دو شکل را میپذیرند. مطلق است هم مسیری با حرف درایو مثل C:/ را مطلق میداند.
واردسازی مسیر پرونده
تابع ریشه:
خام := "C:\\Users\\Sara\\Documents\\cv.pdf"
پ := مسیر پرونده.نرمال سازی(خام)
سرچاپ پ
سرچاپ مسیر پرونده.مطلق است(پ)، مسیر پرونده.مطلق است("Documents\\cv.pdf")
سرچاپ مسیر پرونده.پوشه(پ)
سرچاپ مسیر پرونده.نام پایه(پ)، مسیر پرونده.نام بدون پسوند(پ)، مسیر پرونده.پسوند(پ)
سرچاپ مسیر پرونده.پیوند("C:\\Users\\Sara"، "Pictures\\cat.jpg")
سرچاپ مسیر پرونده.پاک سازی("D:/games/../music/./song.mp3")
پایاندر رشتهی سلام یک خط مورب وارونه به شکل \\ نوشته میشود. پاک سازی درایو را یک بخش معمولی میبیند، پس C:/../x به x تبدیل میشود؛ با .. از درایو بالاتر نروید.
حالتهای مرزی که باید بدانید
جدول زیر پوشه، نام پایه، پسوند و پاک سازی را روی ورودیهایی اجرا میکند که اغلب باعث اشکال میشوند: ریشه، رشتهی خالی، خط مورب پایانی، پروندهی نقطهدار و پسوند دوتایی.
واردسازی مسیر پرونده
واردسازی قالب بندی
تابع نمایش(پ: رشته):
چاپ قالب بندی.پرکردن راست("[" + پ + "]"، ۲۰)
چاپ قالب بندی.پرکردن راست(مسیر پرونده.پوشه(پ)، ۱۰)
چاپ قالب بندی.پرکردن راست(مسیر پرونده.نام پایه(پ)، ۱۶)
چاپ قالب بندی.پرکردن راست("[" + مسیر پرونده.پسوند(پ) + "]"، ۸)
سرچاپ مسیر پرونده.پاک سازی(پ)
پایان
تابع ریشه:
سرچاپ "path dir base ext clean"
هر پ در ["/"، ""، "docs/"، "/var/log/app.log"، ".bashrc"، "backup.tar.gz"، "../up/x.txt"، "a/./b/../c.txt"]:
نمایش(پ)
پایان
پایانقاعدههایی که نشان میدهد: خط مورب پایانی نادیده گرفته میشود؛ مسیر خالی همان . حساب میشود؛ نامی که با نقطه شروع شود، مثل .bashrc، پسوند ندارد؛ پسوند فقط پسوند آخر را میدهد، پس برای .tar.gz از رشته.پایان با کمک بگیرید. پوشه مسیر را ساده نمیکند؛ اگر ممکن است مسیر . یا .. داشته باشد، اول پاک سازی را صدا بزنید.
گروهبندی پروندهها بر اساس پسوند
پسوند همراه یک نگاشت پروندهها را بر اساس گونه میشمارد، برای یک گزارش یا برای انتخاب پردازندهی هر پرونده. یک وکتور دوم ترتیب نخستین دیده شدن پسوندها را نگه میدارد تا خروجی به ترتیب درونی نگاشت وابسته نباشد.
واردسازی مسیر پرونده
تابع ریشه:
پروندهها := ["src/main.salam"، "src/util.salam"، "README.md"، "docs/guide.md"، "logo.svg"، "Makefile"، "docs/intro.md"]
ترتیب := وکتور {} برگردان وکتور<رشته>
دیرکن ترتیب.آزادکن()
شمار := نگاشت {} برگردان نگاشت<رشته، صحیح>
هر پرونده در پروندهها:
ناپایا پس := مسیر پرونده.پسوند(پرونده)
اگر پس.طول() برابر ۰: پس = "(بیپسوند)" پایان
اگر شمار.دارد(پس):
شمار.درج(پس، شمار.بگیر(پس) + ۱)
وگرنه:
شمار.درج(پس، ۱)
ترتیب.بیفزا(پس)
پایان
پایان
هر پس در ترتیب:
سرچاپ پس، شمار.بگیر(پس)
پایان
پایانپسوند بزرگی و کوچکی حروف نام را نگه میدارد، پس photo.JPG مقدار .JPG میدهد. اگر پروندهها از دوربین یا ویندوز میآیند، پیش از مقایسه آن را از رشته.کوچک بگذرانید.
پایاها و متغیرها
جداکننده Separator
پایا جداکننده: رشته = "/"/، در ویندوز هم.واردسازی مسیر پرونده
تابع ریشه:
پ := مسیر پرونده.پیوند("projects"، "salam/main.salam")
سرچاپ پ، مسیر پرونده.جداکننده
سرچاپ مسیر پرونده.پوشه(پ)، مسیر پرونده.نام پایه(پ)، مسیر پرونده.پسوند(پ)، مسیر پرونده.نام بدون پسوند(پ)
سرچاپ مسیر پرونده.نرمال سازی("a//b/./c/")، مسیر پرونده.پاک سازی("a/b/../c")
سرچاپ مسیر پرونده.مطلق است("/usr/bin")، مسیر پرونده.مطلق است(پ)، مسیر پرونده.مطلق است(مسیر پرونده.مسیر مطلق(پ))
سرچاپ مسیر پرونده.مسیر نسبی("/a/b"، "/a/b/c/d")
سرچاپ مسیر پرونده.مسیر امن است("/srv"، "x/y")، مسیر پرونده.مسیر امن است("/srv"، "../etc")
سرچاپ مسیر پرونده.اعتبارسنجی مسیر("a/b")
پایانتابعها
تطبیق الگو Match
تابع تطبیق الگو(pattern: رشته، name: رشته): منطقیname با الگوی pattern میخواند یا نه: * هر دنبالهی نویسه بهجز /، ? یک نویسه، [a-c] یک مجموعه یا بازه، [!a-c] وارونهاش، \ برای گرفتن نویسهی بعدی بهصورت خودش و ** هر دنباله از جمله / (**/ هیچ پوشهای را هم میپذیرد، پس **/*.c با x.c میخواند). کل نام باید بخواند. الگویی که [ بستهنشده دارد با هیچ چیز نمیخواند و \ در آخر الگو با خود پشتخط میخواند. بازهای مثل [a-c] نویسهی کامل را مقایسه میکند، پس برای حروف فارسی هم کار میکند.واردسازی مسیر پرونده
تابع check(pattern: رشته، name: رشته):
سرچاپ pattern، name، مسیر پرونده.تطبیق الگو(pattern، name)
پایان
تابع ریشه:
check("*.salam"، "main.salam")
check("*.salam"، "std/main.salam")
check("**/*.salam"، "std/os/main.salam")
check("**/*.salam"، "main.salam")
check("v?.[0-9]"، "v1.5")
check("[!a-c]*"، "dog")
check("cache/**"، "cache/a/b")
سرچاپ مسیر پرونده.الگو دارد("src/main.salam")، مسیر پرونده.الگو دارد("src/*.salam")
پایانالگو دارد HasMeta
تابع الگو دارد(pattern: رشته): منطقی*، ?، [ یا \) دارد، یعنی فقط یک مسیر ساده نیست.نمونهی این مورد همراه با موارد بالاتر آمده است: filepath-Match.salam
نرمال سازی Normalize
تابع نرمال سازی(p: رشته): رشته\ را به / تبدیل میکند و چیز دیگری را تغییر نمیدهد؛ برای . و .. تابع پاک سازی را ببینید.نمونهی این مورد همراه با موارد بالاتر آمده است: filepath-Join.salam
مطلق است IsAbs
تابع مطلق است(p: رشته): منطقیC:/ هم مطلقاند.نمونهی این مورد همراه با موارد بالاتر آمده است: filepath-Join.salam
پیوند Join
تابع پیوند(a: رشته، b: رشته): رشته/ میانشان میپیوندد. بخش خالی بخش دیگر را میدهد. .. را حل نمیکند و نمیگذارد بخش دوم مطلق جای بخش اول را بگیرد.نمونهی این مورد همراه با موارد بالاتر آمده است: filepath-Join.salam
نام پایه Base
تابع نام پایه(p: رشته): رشته/ پایانی نادیده گرفته میشود، / همان / میماند و مسیر خالی . میدهد.نمونهی این مورد همراه با موارد بالاتر آمده است: filepath-Join.salam
پوشه Dir
تابع پوشه(p: رشته): رشته. و در ریشه /. .. را ساده نمیکند.نمونهی این مورد همراه با موارد بالاتر آمده است: filepath-Join.salam
پسوند Ext
تابع پسوند(p: رشته): رشته.bashrc خالی.نمونهی این مورد همراه با موارد بالاتر آمده است: filepath-Join.salam
نام بدون پسوند Stem
تابع نام بدون پسوند(p: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: filepath-Join.salam
پاک سازی Clean
تابع پاک سازی(p: رشته): رشته. و .. را حل میکند، اسلشهای تکراری و پایانی را برمیدارد و برای مسیر خالی . میدهد. حرف درایو مثل یک بخش معمولی دیده میشود.نمونهی این مورد همراه با موارد بالاتر آمده است: filepath-Join.salam
مسیر مطلق Abs
تابع مسیر مطلق(p: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: filepath-Join.salam
مسیر نسبی Rel
تابع مسیر نسبی(base: رشته، target: رشته): رشتهbase تا target، با .. وقتی مقصد بیرون از آن است؛ هر دو اول مطلق میشوند.نمونهی این مورد همراه با موارد بالاتر آمده است: filepath-Join.salam
اعتبارسنجی مسیر Validate
تابع اعتبارسنجی مسیر(p: رشته): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: filepath-Join.salam
مسیر امن است IsSafe
تابع مسیر امن است(base: رشته، p: رشته): منطقیp پس از پیوستن به base و ساده شدن خود base باشد یا درون آن، درست برمیگرداند؛ p خالی رد میشود. فقط روی متن کار میکند، پس پیوندهای نمادین دنبال نمیشوند.نمونهی این مورد همراه با موارد بالاتر آمده است: filepath-Join.salam