کتابخانه‌ی استاندارد · کدگذاری و داده

نشانی وب encoding/url

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

واردسازی کدگذاری.نشانی وب
در این صفحه
  1. گونه‌ها
  2. روال‌ها

تجزیه نشانی یک نشانی کامل مثل https://[email protected]:8443/path?page=2#top را به بخش‌هایش می‌شکند. بخش‌ها همان‌طور که در متن آمده‌اند نگه داشته می‌شوند؛ برای شکل کدگشایی‌شده، روال‌هایی مثل مسیر کدگشایی‌شده را به کار ببرید.

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

گونه‌ها

نشانی وب URL

ساختار نشانی وب
یک نشانی وب تجزیه‌شده.
نامانگلیسیگونهتوضیح
schemeschemeرشته = ""طرح، مثل https.
userinfouserinfoرشته = ""نام کاربر و گذرواژه پیش از @، کدگذاری‌شده.
hosthostرشته = ""نام میزبان یا نشانی عددی.
portportصحیح = 0درگاه؛ صفر اگر نیامده باشد.
pathpathرشته = ""مسیر، کدگذاری‌شده.
raw_queryraw_queryرشته = ""پرس‌وجو بعد از ?، کدگذاری‌شده.
fragmentfragmentرشته = ""بخش بعد از #.
encoding-url-Parse.salam
واردسازی کدگذاری.نشانی وب
واردسازی کدگذاری.پرس‌وجو

روال ریشه:
    ناپایا ن := نشانی وب.تجزیه نشانی("https://user%20a:[email protected]:8443/کتاب/%D8%B3%D9%84%D8%A7%D9%85?page=2&sort=new#top")
    سرچاپ ن.scheme، ن.host، ن.port، ن.path، ن.raw_query، ن.fragment
    سرچاپ نشانی وب.نام میزبان(ن)، نشانی وب.میزبان با درگاه(ن)، نشانی وب.نشانی عددی است(ن)
    سرچاپ نشانی وب.برچسب‌های میزبان(ن)، نشانی وب.پسوند عمومی(ن)، نشانی وب.دامنه(ن)، نشانی وب.زیردامنه(ن)
    سرچاپ نشانی وب.مسیر کدگشایی‌شده(ن)، نشانی وب.اطلاعات کاربر کدگشایی‌شده(ن)
    سرچاپ نشانی وب.نام پارامترها(ن)، پرس‌وجو.اندازه(نشانی وب.پرس‌وجو(ن))
    نشانی وب.تنظیم پارامتر(ن، "page"، "3")
    سرچاپ نشانی وب.حذف پارامتر(ن، "sort")، نشانی وب.متن(ن)
    ناپایا نگه := وکتور {} برگردان وکتور<رشته>
    نگه.بیفزا("page")
    نشانی وب.نگه داشتن پارامترها(ن، نگه)
    ناپایا پ := پرس‌وجو.نگاشت پرس‌وجو جدید()
    پرس‌وجو.افزودن(پ، "q"، "سلام دنیا")
    نشانی وب.تنظیم پرس‌وجو(ن، پ)
    سرچاپ نشانی وب.متن(ن)
    نشانی وب.پاک کردن پرس‌وجو(ن)
    سرچاپ نشانی وب.متن(ن)
    سرچاپ نشانی وب.متن(نشانی وب.پیوستن نشانی(ن، "../img/a.png"))، نشانی وب.کدگذاری بخش مسیر("a b/c")
    سرچاپ نشانی وب.نشانی عددی است(نشانی وب.تجزیه نشانی("http://127.0.0.1/"))
پایان
خروجیhttps shop.example.co.uk 8443 /کتاب/%D8%B3%D9%84%D8%A7%D9%85 page=2&sort=new top shop.example.co.uk shop.example.co.uk:8443 false ["shop", "example", "co", "uk"] co.uk example.co.uk shop /کتاب/سلام user a:pw ["page", "sort"] 2 true https://user%20a:[email protected]:8443/کتاب/%D8%B3%D9%84%D8%A7%D9%85?page=3#top https://user%20a:[email protected]:8443/کتاب/%D8%B3%D9%84%D8%A7%D9%85?q=%D8%B3%D9%84%D8%A7%D9%85+%D8%AF%D9%86%DB%8C%D8%A7#top https://user%20a:[email protected]:8443/کتاب/%D8%B3%D9%84%D8%A7%D9%85#top https://user%20a:[email protected]:8443/img/a.png a%20b%2Fc true

روال‌ها

تجزیه نشانی Parse

روال تجزیه نشانی(raw: رشته): نشانی وب
نشانی را به بخش‌هایش تجزیه می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-url-Parse.salam

میزبان با درگاه HostPort

روال میزبان با درگاه(u: نشانی وب): رشته
میزبان و درگاه با هم، مثل shop.example.co.uk:8443.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-url-Parse.salam

متن String

روال متن(u: نشانی وب): رشته
نشانی را دوباره به متن تبدیل می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-url-Parse.salam

مسیر کدگشایی‌شده DecodedPath

روال مسیر کدگشایی‌شده(u: نشانی وب): رشته
مسیر، با کدگذاری درصدی برگردانده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-url-Parse.salam

اطلاعات کاربر کدگشایی‌شده DecodedUserinfo

روال اطلاعات کاربر کدگشایی‌شده(u: نشانی وب): رشته
اطلاعات کاربر، کدگشایی‌شده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-url-Parse.salam

کدگذاری بخش مسیر EncodePathSegment

روال کدگذاری بخش مسیر(s: رشته): رشته
یک بخش مسیر را کدگذاری می‌کند؛ / هم کدگذاری می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-url-Parse.salam

پرس‌وجو Query

روال پرس‌وجو(u: نشانی وب): query.QueryMap
پرس‌وجوی نشانی را به یک نگاشت پرس‌وجو تبدیل می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-url-Parse.salam

تنظیم پرس‌وجو SetQuery

روال تنظیم پرس‌وجو(u &: نشانی وب، q: query.QueryMap)
پرس‌وجوی نشانی را با نگاشت داده‌شده جایگزین می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-url-Parse.salam

پیوستن نشانی Join

روال پیوستن نشانی(base: نشانی وب، ref: رشته): نشانی وب
نشانی نسبی را روی نشانی پایه می‌سازد، مثل مرورگر؛ .. و . در مسیر حل می‌شوند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-url-Parse.salam

نام میزبان Hostname

روال نام میزبان(u: نشانی وب): رشته
نام میزبان بدون درگاه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-url-Parse.salam

نشانی عددی است IsIP

روال نشانی عددی است(u: نشانی وب): منطقی
اگر میزبان نشانی عددی IP باشد، درست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-url-Parse.salam

برچسب‌های میزبان Labels

روال برچسب‌های میزبان(u: نشانی وب): وکتور<رشته>
بخش‌های نام میزبان، جداشده با نقطه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-url-Parse.salam

پسوند عمومی PublicSuffix

روال پسوند عمومی(u: نشانی وب): رشته
پسوند عمومی دامنه، مثل co.uk یا ir.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-url-Parse.salam

دامنه Domain

روال دامنه(u: نشانی وب): رشته
دامنه‌ی ثبت‌شده: یک بخش پیش از پسوند عمومی، مثل example.co.uk.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-url-Parse.salam

زیردامنه Subdomain

روال زیردامنه(u: نشانی وب): رشته
هر چه پیش از دامنه‌ی ثبت‌شده می‌آید، مثل shop.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-url-Parse.salam

حذف پارامتر RemoveParam

روال حذف پارامتر(u &: نشانی وب، key: رشته): منطقی
همه‌ی مقدارهای یک پارامتر را برمی‌دارد و می‌گوید پارامتر وجود داشت یا نه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-url-Parse.salam

تنظیم پارامتر SetParam

روال تنظیم پارامتر(u &: نشانی وب، key: رشته، val: رشته)
مقدار یک پارامتر را تنظیم می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-url-Parse.salam

نگه داشتن پارامترها KeepParams

روال نگه داشتن پارامترها(u &: نشانی وب، keep: وکتور<رشته>)
فقط پارامترهای داده‌شده را نگه می‌دارد؛ برای پاک کردن پارامترهای ردیابی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-url-Parse.salam

پاک کردن پرس‌وجو ClearQuery

روال پاک کردن پرس‌وجو(u &: نشانی وب)
همه‌ی پرس‌وجو را برمی‌دارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-url-Parse.salam

نام پارامترها ParamNames

روال نام پارامترها(u: نشانی وب): وکتور<رشته>
نام پارامترها، به ترتیب.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: encoding-url-Parse.salam