PHP setlocale()-funktio

Esimerkki

Aseta alue US Englishksi ja aseta sitten takaisin järjestelmän oletusarvoon:

<?php
echo setlocale(LC_ALL, "US");
echo "<br>";
echo setlocale(LC_ALL, NULL);
?>

Suoritusesimerkki

Määrittely ja käyttö

setlocale()-funktio asettaa alueen tiedot (aluetiedot).

Alueen tiedot ovat kieliä, valuuttoja, aikaa ja muita tietoja, jotka liittyvät tiettyyn maantieteelliseen alueeseen.

Kommentti:setlocale()-funktio muuttaa vain nykyisen skriptin alueen tiedot.

Vinkki:Voit asettaa alueen tiedot järjestelmän oletusarvoiksi setlocale(LC_ALL, NULL)-kutsulla.

Vinkki:Jos haluat saada numeroformaatitiedot, katso: localeconv() Funktio.

Syntaksi

setlocale(vakio,sijainti)
Parametrit Kuvaus
vakio

Välttämätön. Määrittää, minkä alueen tiedot tulisi asettaa.

Käytettävissä olevat muuttujat:

  • LC_ALL - Sisältää kaikki seuraavat vaihtoehdot
  • LC_COLLATE - Järjestysjärjestys
  • LC_CTYPE - merkkiyhteys ja muunnos (esim. kaikki kirjaimet isolla kirjaimella tai pienellä kirjaimella)
  • LC_MESSAGES - järjestelmäviestien muotoilu
  • LC_MONETARY - valuutan muotoilu
  • LC_NUMERIC - luku muotoilu
  • LC_TIME - päivämäärän ja ajan muotoilu
sijainti

Välttämätön. Määrittää, mihin maahan/alueeseen alueasetukset asetetaan. Voivat olla merkkijonoja tai taulukoita. voidaan lähettää useita sijainteja.

Jos sijainti parametri on NULL tai tyhjä merkkijono "", sijaintinimi asetetaan yllä olevien vakioiden nimisiin ympäristömuuttujiin tai "LANG" perusteella.

Jos sijainti parametri on "0", sijaintiasetukset eivät vaikuta, palautetaan vain nykyiset asetukset.

Jos sijainti Parametri on taulukko, setlocale() yrittää jokaisen taulukon elementin, kunnes löytää laillisen kielen tai aluekoodin. Jos jokin alue on eri nimiä eri järjestelmissä, tämä on hyödyllistä.

Kommentti:Jos haluat tarkastella kaikkia saatavilla olevia kielikoodia, vieraileKielikoodien viittaus.

Tekninen yksityiskohta

Paluuarvo: Palauttaa nykyiset alueasetukset, jos epäonnistuu, palauttaa FALSE. Paluuarvo riippuu PHP:n suorittavasta järjestelmästä.
PHP versio: 4+
Päivitysloki:

PHP 4.2.0:ssa on vanhentunut merkkijonona toimittaminen vakiona, käytä sen sijaan saatavilla olevia vakioita. Vakion merkkijonona toimittaminen aiheuttaa varoitusviestin.

PHP 4.3.0:ssa voidaan lähettää useita sijainteja.

PHP 5.3.0 alkaen, jos vakio Parametri on merkkijono, ei LC_-vakioista yksi, ja funktio heittää E_DREPRECATED-ilmoituksen.