کتابخانه‌ی استاندارد · سیستم و ابزار

مسیر پرونده filepath

تابع‌های مسیر پرونده بدون نیاز به سیستم پرونده؛ همان کارهای بسته‌ی مسیر.

واردسازی مسیر پرونده

نام آرگومان‌ها شناسه‌ی خود کد است و معادل فارسی ندارد؛ گونه‌ها، کلیدواژه‌ها و نام بسته‌ها با معادل فارسی نوشته می‌شوند.

بسته‌ی مسیر پرونده رشته‌های مسیر را از هم باز می‌کند و می‌سازد: پیوند، پوشه، نام پایه، پسوند، نام بدون پسوند، پاک سازی، مسیر مطلق، مسیر نسبی و بررسی مسیر امن است برای مسیرهایی که از کاربر می‌آیند. فقط با رشته‌ها کار می‌کند و به سیستم پرونده دست نمی‌زند، به‌جز مسیر مطلق، مسیر نسبی و مسیر امن است که برای مسیر نسبی پوشه‌ی جاری را می‌خوانند. جای کاربردش ابزارهای ساخت، سازنده‌های سایت ایستا، پردازش بارگذاری‌ها و هر جایی است که مسیر حساب می‌شود نه تایپ. برای کار روی خود پرونده‌ها آن را کنار سیستم پرونده، پوشه یا سیستم عامل بگذارید.

بسته‌ی مسیر نام‌های دیگری برای همین تابع‌هاست؛ هر کدام را که راحت‌ترید به کار ببرید، ولی در هر برنامه فقط یکی را.

نام‌ها در دو بسته کمی فرق دارند و این فرق گیج‌کننده است: نام پایه در این بسته نام پرونده با پسوند را می‌دهد (cv.pdf)، ولی نام پایه در بسته‌ی مسیر پسوند را برمی‌دارد (cv). پوشه این‌جا همان نام پوشه آن‌جاست. مسیرها همیشه با جداکننده‌ی / برمی‌گردند، در ویندوز هم، و ویندوز این را می‌پذیرد.

اشتباه‌های رایج:

  • انتظار این‌که پیوند نتیجه را ساده کند. فقط یک / میان دو بخش می‌گذارد: پیوند("a/b"، "../c") برابر a/b/../c است و بخش دوم مطلق هم به انتها افزوده می‌شود، نه این‌که جایگزین شود. پس از آن پاک سازی را صدا بزنید.
  • مقایسه‌ی مسیرها مثل متن ساده. اول هر دو را ساده کنید و به یاد داشته باشید که مقایسه به بزرگی و کوچکی حرف حساس است.
  • اعتماد به مسیر کاربر بدون مسیر امن است. حتی پس از پیوند، ../../etc/passwd از پوشه‌ی شما بیرون می‌زند.

مسیرهای ویندوز

مسیری که کاربر ویندوز چسبانده یا از پرونده‌ی تنظیمات ویندوزی خوانده شده \ دارد. همه‌ی تابع‌های این بسته اول نرمال سازی را صدا می‌زنند، پس پوشه، نام پایه و پیوند هر دو شکل را می‌پذیرند. مطلق است هم مسیری با حرف درایو مثل C:/ را مطلق می‌داند.

filepath-guide-windows.salam
واردسازی مسیر پرونده

تابع ریشه:
    خام := "C:\\Users\\Sara\\Documents\\cv.pdf"
    پ := مسیر پرونده.نرمال سازی(خام)
    سرچاپ پ
    سرچاپ مسیر پرونده.مطلق است(پ)، مسیر پرونده.مطلق است("Documents\\cv.pdf")
    سرچاپ مسیر پرونده.پوشه(پ)
    سرچاپ مسیر پرونده.نام پایه(پ)، مسیر پرونده.نام بدون پسوند(پ)، مسیر پرونده.پسوند(پ)
    سرچاپ مسیر پرونده.پیوند("C:\\Users\\Sara"، "Pictures\\cat.jpg")
    سرچاپ مسیر پرونده.پاک سازی("D:/games/../music/./song.mp3")
پایان
خروجیC:/Users/Sara/Documents/cv.pdf true false C:/Users/Sara/Documents cv.pdf cv .pdf C:/Users/Sara/Pictures/cat.jpg D:/music/song.mp3

در رشته‌ی سلام یک خط مورب وارونه به شکل \\ نوشته می‌شود. پاک سازی درایو را یک بخش معمولی می‌بیند، پس C:/../x به x تبدیل می‌شود؛ با .. از درایو بالاتر نروید.

حالت‌های مرزی که باید بدانید

جدول زیر پوشه، نام پایه، پسوند و پاک سازی را روی ورودی‌هایی اجرا می‌کند که اغلب باعث اشکال می‌شوند: ریشه، رشته‌ی خالی، خط مورب پایانی، پرونده‌ی نقطه‌دار و پسوند دوتایی.

filepath-guide-edges.salam
واردسازی مسیر پرونده
واردسازی قالب بندی

تابع نمایش(پ: رشته):
    چاپ قالب بندی.پرکردن راست("[" + پ + "]"، ۲۰)
    چاپ قالب بندی.پرکردن راست(مسیر پرونده.پوشه(پ)، ۱۰)
    چاپ قالب بندی.پرکردن راست(مسیر پرونده.نام پایه(پ)، ۱۶)
    چاپ قالب بندی.پرکردن راست("[" + مسیر پرونده.پسوند(پ) + "]"، ۸)
    سرچاپ مسیر پرونده.پاک سازی(پ)
پایان

تابع ریشه:
    سرچاپ "path                dir       base            ext     clean"
    هر پ در ["/"، ""، "docs/"، "/var/log/app.log"، ".bashrc"، "backup.tar.gz"، "../up/x.txt"، "a/./b/../c.txt"]:
        نمایش(پ)
    پایان
پایان
خروجیpath dir base ext clean [/] / / [] / [] . . [] . [docs/] . docs [] docs [/var/log/app.log] /var/log app.log [.log] /var/log/app.log [.bashrc] . .bashrc [] .bashrc [backup.tar.gz] . backup.tar.gz [.gz] backup.tar.gz [../up/x.txt] ../up x.txt [.txt] ../up/x.txt [a/./b/../c.txt] a/./b/.. c.txt [.txt] a/c.txt

قاعده‌هایی که نشان می‌دهد: خط مورب پایانی نادیده گرفته می‌شود؛ مسیر خالی همان . حساب می‌شود؛ نامی که با نقطه شروع شود، مثل .bashrc، پسوند ندارد؛ پسوند فقط پسوند آخر را می‌دهد، پس برای .tar.gz از رشته.پایان با کمک بگیرید. پوشه مسیر را ساده نمی‌کند؛ اگر ممکن است مسیر . یا .. داشته باشد، اول پاک سازی را صدا بزنید.

گروه‌بندی پرونده‌ها بر اساس پسوند

پسوند همراه یک نگاشت پرونده‌ها را بر اساس گونه می‌شمارد، برای یک گزارش یا برای انتخاب پردازنده‌ی هر پرونده. یک وکتور دوم ترتیب نخستین دیده شدن پسوندها را نگه می‌دارد تا خروجی به ترتیب درونی نگاشت وابسته نباشد.

filepath-guide-group.salam
واردسازی مسیر پرونده

تابع ریشه:
    پرونده‌ها := ["src/main.salam"، "src/util.salam"، "README.md"، "docs/guide.md"، "logo.svg"، "Makefile"، "docs/intro.md"]
    ترتیب := وکتور {} برگردان وکتور<رشته>
    دیرکن ترتیب.آزادکن()
    شمار := نگاشت {} برگردان نگاشت<رشته، صحیح>
    هر پرونده در پرونده‌ها:
        ناپایا پس := مسیر پرونده.پسوند(پرونده)
        اگر پس.طول() برابر ۰: پس = "(بی‌پسوند)" پایان
        اگر شمار.دارد(پس):
            شمار.درج(پس، شمار.بگیر(پس) + ۱)
        وگرنه:
            شمار.درج(پس، ۱)
            ترتیب.بیفزا(پس)
        پایان
    پایان
    هر پس در ترتیب:
        سرچاپ پس، شمار.بگیر(پس)
    پایان
پایان
خروجی.salam 2 .md 3 .svg 1 (بی‌پسوند) 1

پسوند بزرگی و کوچکی حروف نام را نگه می‌دارد، پس photo.JPG مقدار .JPG می‌دهد. اگر پرونده‌ها از دوربین یا ویندوز می‌آیند، پیش از مقایسه آن را از رشته.کوچک بگذرانید.

پایاها و متغیرها

جداکننده Separator

پایا جداکننده: رشته = "/"
جداکننده‌ی بخش‌های مسیر: همیشه /، در ویندوز هم.
filepath-Join.salam
واردسازی مسیر پرونده

تابع ریشه:
    پ := مسیر پرونده.پیوند("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")
پایان
خروجیprojects/salam/main.salam / projects/salam main.salam .salam main a//b/./c/ a/c true false true c/d true false true

تابع‌ها

تطبیق الگو Match

تابع تطبیق الگو(pattern: رشته، name: رشته): منطقی
بررسی می‌کند name با الگوی pattern می‌خواند یا نه: * هر دنباله‌ی نویسه به‌جز /، ? یک نویسه، [a-c] یک مجموعه یا بازه، [!a-c] وارونه‌اش، \ برای گرفتن نویسه‌ی بعدی به‌صورت خودش و ** هر دنباله از جمله / (**/ هیچ پوشه‌ای را هم می‌پذیرد، پس **/*.c با x.c می‌خواند). کل نام باید بخواند. الگویی که [ بسته‌نشده دارد با هیچ چیز نمی‌خواند و \ در آخر الگو با خود پشت‌خط می‌خواند. بازه‌ای مثل [a-c] نویسه‌ی کامل را مقایسه می‌کند، پس برای حروف فارسی هم کار می‌کند.
filepath-Match.salam
واردسازی مسیر پرونده

تابع 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")
پایان
خروجی*.salam main.salam true *.salam std/main.salam false **/*.salam std/os/main.salam true **/*.salam main.salam true v?.[0-9] v1.5 true [!a-c]* dog true cache/** cache/a/b true false true

الگو دارد 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