Sophie

Sophie

distrib > Mandriva > 2008.1 > i586 > by-pkgid > 703d980c580707c382b4e43e25965bc5 > files > 9582

php-manual-pt_BR-5.2.4-1mdv2008.1.noarch.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>setlocale</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="Manual do PHP"
HREF="index.html"><LINK
REL="UP"
TITLE="String"
HREF="ref.strings.html"><LINK
REL="PREVIOUS"
TITLE="rtrim"
HREF="function.rtrim.html"><LINK
REL="NEXT"
TITLE="sha1_file"
HREF="function.sha1-file.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="refentry"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Manual do PHP</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.rtrim.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.sha1-file.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.setlocale"
></A
>setlocale</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN220352"
></A
><P
>    (PHP 3, PHP 4, PHP 5)</P
>setlocale&nbsp;--&nbsp;Define informações locais</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN220355"
></A
><H2
>Descrição</H2
>string <B
CLASS="methodname"
>setlocale</B
> ( mixed category, string locale [, string ...] )<BR
></BR
>string <B
CLASS="methodname"
>setlocale</B
> ( mixed category, array locale )<BR
></BR
><P
>&#13;     <CODE
CLASS="parameter"
>Category</CODE
> é uma constante (ou string)
     especificando a categoria de funções afetadas pela definição local:
     setting:
     <P
></P
><UL
><LI
><P
>&#13;        LC_ALL para tudo abaixo
       </P
></LI
><LI
><P
>&#13;        LC_COLLATE para comparação de strings, veja
        <A
HREF="function.strcoll.html"
><B
CLASS="function"
>strcoll()</B
></A
>
       </P
></LI
><LI
><P
>&#13;        LC_CTYPE para classificação de caracteres e conversão, 
        por exemplo <A
HREF="function.strtoupper.html"
><B
CLASS="function"
>strtoupper()</B
></A
>
       </P
></LI
><LI
><P
>&#13;        LC_MONETARY para <A
HREF="function.localeconv.html"
><B
CLASS="function"
>localeconv()</B
></A
>
       </P
></LI
><LI
><P
> LC_NUMERIC para o separador decimal (Veja também
       <A
HREF="function.localeconv.html"
><B
CLASS="function"
>localeconv()</B
></A
>)
       </P
></LI
><LI
><P
>&#13;        LC_TIME para formatação de data e hora com
        <A
HREF="function.strftime.html"
><B
CLASS="function"
>strftime()</B
></A
>
       </P
></LI
></UL
>
    </P
><P
>&#13;     Se <CODE
CLASS="parameter"
>locale</CODE
> for uma string vazia
     <TT
CLASS="literal"
>""</TT
>, o nome do local será obtido apartir de variaveis de 
     ambiente com os mesmos nomes das categorias acima ou apartir de "LANG".
    </P
><P
>&#13;     Se <CODE
CLASS="parameter"
>locale</CODE
> for <TT
CLASS="constant"
><B
>NULL</B
></TT
> ou <TT
CLASS="literal"
>"0"</TT
>,
     a definição de local não é modificada, apenas retorna a definição atual.
    </P
><P
>&#13;     Se <CODE
CLASS="parameter"
>locale</CODE
> for uma matriz ou conter parâmetros adicionais,
     então cada elemento da matriz é tentado como um local até obter sucesso.
     Isto é útil se um lugar é conhecido por nomes diferentes em sistemas
     diferentes ou para prover um outro local se um estiver indisponível.
    </P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
      Passar varios lugares não esta disponível antes do PHP 4.3.0
     </P
></BLOCKQUOTE
></DIV
><P
>&#13;     <B
CLASS="function"
>setlocale()</B
> retorna o novo local ou <TT
CLASS="constant"
><B
>FALSE</B
></TT
> se a
     funcionalidade de locais não estiver implementada em sua plataforma,
     o local não existir ou a categoria for invalida.
     Uma categoria invalida também gera uma mensagem de aviso.
     Nomes de categoria/local podem ser encontrados em
     <A
HREF="http://www.faqs.org/rfcs/rfc1766"
TARGET="_top"
>RFC 1766</A
>
     e <A
HREF="http://www.w3.org/WAI/ER/IG/ert/iso639.htm"
TARGET="_top"
>ISO 639</A
>.
    </P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
      O valor de retorno de <B
CLASS="function"
>setlocale()</B
> depende
      do sistema no qual o PHP esta sendo executado. Ele retorna
      exatamente o que a função setlocale do sistema retorna.
     </P
></BLOCKQUOTE
></DIV
><DIV
CLASS="tip"
><BLOCKQUOTE
CLASS="tip"
><P
><B
>Dica: </B
>
      Usuários do windows encontraram informações úteis sobre as strings de
      <CODE
CLASS="parameter"
>locale</CODE
> no site
      <ACRONYM
CLASS="acronym"
>MSDN</ACRONYM
> da Microsoft. Strings das línguas suportadas podem ser encontradas
      <A
HREF="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vclib/html/_crt_language_strings.asp"
TARGET="_top"
>aqui</A
> as strings de
      pais/região suportados <A
HREF="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vclib/html/_crt_country_strings.asp"
TARGET="_top"
>&#13;      aqui</A
>. Sistemas windows suportam códigos de três letras para pais/região
      especificados por <TT
CLASS="literal"
>ISO 3166-Alpha-3</TT
>, que
      pode ser encontrada em <A
HREF="http://www.unicode.org/onlinedat/countries.html"
TARGET="_top"
>Unicode website
      </A
>.
     </P
></BLOCKQUOTE
></DIV
><P
>&#13;     <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN220426"
></A
><P
><B
>Exemplo 1. Exemplos <B
CLASS="function"
>setlocale()</B
></B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br /></font><font color="#FF8000">/* Define o local para Holandês(usar pt_BR para o Português(Brasil) ) */<br /></font><font color="#0000BB">setlocale </font><font color="#007700">(</font><font color="#0000BB">LC_ALL</font><font color="#007700">, </font><font color="#DD0000">'nl_NL'</font><font color="#007700">);<br /><br /></font><font color="#FF8000">/* Mostra: vrijdag 22 december 1978 */<br /></font><font color="#007700">echo </font><font color="#0000BB">strftime </font><font color="#007700">(</font><font color="#DD0000">"%A %e %B %Y"</font><font color="#007700">, </font><font color="#0000BB">mktime </font><font color="#007700">(</font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">12</font><font color="#007700">, </font><font color="#0000BB">22</font><font color="#007700">, </font><font color="#0000BB">1978</font><font color="#007700">));<br /><br /></font><font color="#FF8000">/* Tenta diferentes nomes de local para o Alemão apartir do PHP 4.3.0 */<br /></font><font color="#0000BB">$loc_de </font><font color="#007700">= </font><font color="#0000BB">setlocale </font><font color="#007700">(</font><font color="#0000BB">LC_ALL</font><font color="#007700">, </font><font color="#DD0000">'de_DE@euro'</font><font color="#007700">, </font><font color="#DD0000">'de_DE'</font><font color="#007700">, </font><font color="#DD0000">'de'</font><font color="#007700">, </font><font color="#DD0000">'ge'</font><font color="#007700">);<br />echo </font><font color="#DD0000">"Preferred locale for german on this system is '$loc_de'"</font><font color="#007700">;<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
    </P
><P
>&#13;     <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN220431"
></A
><P
><B
>Exemplo 2. Exemplos para windows de<B
CLASS="function"
>setlocale()</B
></B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br /></font><font color="#FF8000">/* Define o local para Holandês(usar ptb para o Português(Brasil) ) */<br /></font><font color="#0000BB">setlocale </font><font color="#007700">(</font><font color="#0000BB">LC_ALL</font><font color="#007700">, </font><font color="#DD0000">'nld_nld'</font><font color="#007700">);<br /><br /></font><font color="#FF8000">/* Mostra: vrijdag 22 december 1978 */<br /></font><font color="#007700">echo </font><font color="#0000BB">strftime </font><font color="#007700">(</font><font color="#DD0000">"%A %d %B %Y"</font><font color="#007700">, </font><font color="#0000BB">mktime </font><font color="#007700">(</font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">12</font><font color="#007700">, </font><font color="#0000BB">22</font><font color="#007700">, </font><font color="#0000BB">1978</font><font color="#007700">));<br /><br /></font><font color="#FF8000">/* Tenta diferentes nomes de local para o Alemão apartir do PHP 4.3.0 */<br /></font><font color="#0000BB">$loc_de </font><font color="#007700">= </font><font color="#0000BB">setlocale </font><font color="#007700">(</font><font color="#0000BB">LC_ALL</font><font color="#007700">, </font><font color="#DD0000">'de_DE@euro'</font><font color="#007700">, </font><font color="#DD0000">'de_DE'</font><font color="#007700">, </font><font color="#DD0000">'deu_deu'</font><font color="#007700">);<br />echo </font><font color="#DD0000">"Preferred locale for german on this system is '$loc_de'"</font><font color="#007700">;<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
    </P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="function.rtrim.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Principal</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.sha1-file.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>rtrim</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.strings.html"
ACCESSKEY="U"
>Acima</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>sha1_file</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>