K wobsahej skočić

Wikipedija:Lua/Module/URLutil/hsb

Wotkazy přidać
Z Wikipedije, swobodneje encyklopedije
Programowanje předłohi Diskusije Lua Testy Podstrony
Modul Hornjoserbsce English Deutsch

Modul: Dokumentacija

URLutil – Modul z funkcijemi za rjady znamješkow, kotrež so na internetowe adresy poćahnu (URL; IP-adresy – tež IPv4 a IPv6 – ale tež e-mejlka). Tež internacionalizěrowane adresy (IRI) su móžne.

Mamy za to zo je wužitk za Wikijowy projekt; tuž zmysłapołne adresy we wotewrjenym interneće. Sćěhowace specialne pady njejsu programowane, ale tež lědma relewantne:

  • IPv4-adresa nic w normalnej notaciji (z dypkami rozdźělene, decimalne)
  • URL z IPv6-Host (spinkowane; njekongruěruje derje z Wikijoweju syntaksu)
  • Authority z username

Funkcije za předłohi

[žórłowy tekst wobdźěłać]

Wšě funkcije maja eksaktnje jedyn njemjenowany parameter (zmysłapołnje so dyrbi daty). Tutón je tolerantny přećiwo prózdnym znamješkam před abo po wobsahu.

Hódnota wróćenja je prózdna rjad znamješkow („nic“), jeli hódnota parametra njedospołni wotčakowanja. Jeli rezultat je wobstejacy abo prašenske wuměnjenje je prawne, rezultuje minimalnje jedne znamjo. Rezultat njezapočina abo so kónči z prózdnym znamješkom.

getAuthority
Ekstrahuje z ressource URL zaměranje serwera (rezultat pisany w małkich pismikach)
  • nic – jeli njedowoleny
getHost
Ekstrahuje z ressource-URL domainom abo IP-adresu (rezultat pisany w małkich pismikach)
  • nic – jeli njedowoleny
getPort
Ekstraruje z ressource-URL informaciju wo portu (rezultat ličba)
  • nic – jeli wobstejacy
getScheme
Ekstrahuje z ressource-URL šemu (rezultat pisany w małkich pismikach; inkluziwnje dwójnych nakósnych smužkow)
  • // – relatiwny protokol
  • https:// – protokol
  • nic – jeli spočatk URL njedowoleny
getTLD
Ekstrahuje z ressource-URL Top-Level-Domain (rezultat z małkimi pismikami pisany)
  • ničo – jeli njedowoleny
getTop2domain
Ekstrahuje z ressource-URL najbóle hornjej wobaj niwowaj domaina (rezultat z małkimi pismikami pisany)
  • ničo – jeli njedowoleny
isAuthority
Wón je adresa serwera (tež IP) ressource, inkluziwnje porta?
  • 1 – haj
isDomain
Wón je mjenowany domain, inkluziwnje subdomainow?
  • 1 – haj
isHost
Wón je adresa serwera bjez porta (tež IP)?
  • 1 – haj
isIP
Wón je IP-adresa?
  • 4 jeli IPv4 (w normalnej notaciji)
  • 6 jeli IPv6
  • nic – hewak
isIPv4
Wón je IPv4-adresa w normalnej notaciji (z dypkami rozdźělena, decimalna)?
  • 1 – haj
isIPv6
Wón je IPv6-adresa?
  • 1 – haj
isMailAddress
Wón je adresa e-mejlki?
  • 1 – haj
isMailLink
Wón je wotkaz na e-mejlku (mailto:)?
  • 1 – haj
isProtocolDialog
Wón je URL / mjeno šemy, kotrež móže we Wikiju dialog započinać?
mailto, irc, ircs, ssh, telnet
  • 1 – haj
isProtocolWiki
Wón je URL / mjeno šemy, z kotrymž so móže referencěrować we Wikiju na ressource?
Relatiwny protokol ale tež ftp ftps git http https mms nntp sftp svn worldwind
Njepřate su tu: gopher, wais ale tež mailto, irc, ircs, ssh, telnet.
  • 1 – haj
isResourceURL
Wón je URL, při kotrejž powšitkownje so móže přistup měć k ressource? To rěka: relatiwny protokol, http, https, ftp a nimo toho płaćiwy hósćinarski kompjuter (jendźelsce Host). Druhe URL by k předstajenju na projektowych a funkcijskich stronach, ale nic w encyklopediskim terenje.
  • 1 – haj
isSuspiciousURL
Wón je syntaktiski „podhladny“ URL, přećiwo kotrejž so by dyrbi warnować?
  • 1 – haj
isUnescapedURL
Wón je URL, při kotrejž hišće Wikisyntaksa [ | ] so dyrbi wotpadnyć?
  • 1 – haj
isWebURL
Wón je płaćiwa adresa za ressource (Protokol někajki)?
  • 1 – haj
wikiEscapeURL
K wikisyntaksej zawěšće [ | ] escapować.
  • Identisce z parametrom, jeli žadne problematiske znamješka wustupuja.
  • Narunanje wot [ | ] přez k webserwerej wěste HTML-Entities, jeli wobstejace. Pipe je w syntaksy předłoha nic chroble móžne.

Přikłady (testowy bok)

[žórłowy tekst wobdźěłać]

Testowy bok ilustruje praktiske přikłady.

Funkcije za Lua-module

[žórłowy tekst wobdźěłać]

Wšě horjeka dokumentowane funkcije so tež móžeja zawjazować z require() do druhich modulow: 

local lucky, URLutil = pcall( require, "Modul:URLutil" )
if type( URLutil ) == "table" then
    URLutil = URLutil.URLutil()
else
    -- zmylkowu pad; URLutil wobsahuje powěsć zmylka
    return "<span class='error'>" .. URLutil .. "</span>"
end

Po tym su k dispoziciji:

  • URLutil.getAuthority()
  • URLutil.getHost()
  • URLutil.getPort()
    numeriska hódnota, abo false
  • URLutil.getScheme()
  • URLutil.getTLD()
  • URLutil.getTop2domain()
  • URLutil.isAuthority()
  • URLutil.isDomain()
  • URLutil.isHost()
  • URLutil.isIP()
    numeriski 4, 6, abo false
  • URLutil.isIPv4()
  • URLutil.isIPv6()
  • URLutil.isMailAddress()
  • URLutil.isMailLink()
  • URLutil.isProtocolDialog
  • URLutil.isProtocolWiki()
  • URLutil.isResourceURL()
  • URLutil.isSuspiciousURL()
  • URLutil.isUnescapedURL()
  • URLutil.isWebURL()
  • URLutil.wikiEscapeURL()

W padźe wuspěcha URLutil.get*() wróći rjad znamješkow, URLutil.is*() hódnotu true (jeli nic hewak daty); při njewuspěchu kóždy raz false.

Wužiće

[žórłowy tekst wobdźěłać]

Powšykna biblioteka; njewobmjezowana.

Wotwisnosć

[žórłowy tekst wobdźěłać]

Žadna.

Hlej tež

[žórłowy tekst wobdźěłać]
  • mw: Uri library – druhe funkcionalnosće na powšitkownym URI; ale specielnje za Wikijowe URL pomocne.

Model

[žórłowy tekst wobdźěłać]
Z Wikipedije, swobodneje encyklopedije