Skip to content
New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

#

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

tradução de arquivos em reference/mbstring/functions #500

Merged
merged 8 commits into from
Jan 20, 2024
Merged

tradução de arquivos em reference/mbstring/functions #500

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
39df6da
tradução de arquivos em reference/mbstring/functions
fernandowobeto Jan 16, 2024
f146c84
traduzindo arquivos em functions de mbstring
fernandowobeto Jan 16, 2024
a701b30
traduzindo functions em mbstring
fernandowobeto Jan 17, 2024
b0cde36
traduzindo functions em mbstring
fernandowobeto Jan 18, 2024
d216a85
novas traduções em functions de mbstring
fernandowobeto Jan 19, 2024
3756f2b
traduções e ajustes em functions de mbstring
fernandowobeto Jan 20, 2024
5585a3a
finalizada traduções das functions em mbstring
fernandowobeto Jan 20, 2024
d863433
fix qa issues
leonardolara Jan 20, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
119 changes: 119 additions & 0 deletions reference/mbstring/functions/mb-check-encoding.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,119 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d2ff0abe1650703e8974acaa7674c678e587a696 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<refentry xml:id="function.mb-check-encoding" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>mb_check_encoding</refname>
<refpurpose>Verifica se as strings são válidas para a codificação especificada</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>mb_check_encoding</methodname>
<methodparam choice="opt"><type class="union"><type>array</type><type>string</type><type>null</type></type><parameter>value</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Verifica se o fluxo de bytes especificado é válido para a codificação especificada.
Se <parameter>value</parameter> for do tipo &array;, todas as chaves e valores são
validados recursivamente.
É útil para prevenir ataques chamados "Invalid Encoding Attack".
</para>
<para>
</para>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
O fluxo de bytes ou &array; a ser verificado. Se omitido, esta função verifica
toda a entrada desde o início da requisição.
</para>

<warning>
<para>
A partir do PHP 8.1.0, omitir este parâmetro ou passar &null; está descontinuado.
</para>
</warning>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>encoding</parameter></term>
<listitem>
<para>
A codificação esperada.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.1.0</entry>
<entry>
Chamar esta função com &null; como <parameter>value</parameter> ou sem argumento está descontinuado.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>value</parameter> e <parameter>encoding</parameter> são anuláveis agora.
</entry>
</row>
<row>
<entry>7.2.0</entry>
<entry>
Esta função agora aceita também um &array; como <parameter>value</parameter>.
Anteriormente, apenas &string;s eram suportadas.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
133 changes: 133 additions & 0 deletions reference/mbstring/functions/mb-chr.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,133 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 30c25e7d490278bb31b9d5df6107a3b300d7e10a Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<refentry xml:id="function.mb-chr" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>mb_chr</refname>
<refpurpose>Retorna um caractere pelo valor do ponto de código Unicode</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>string</type><type>false</type></type><methodname>mb_chr</methodname>
<methodparam><type>int</type><parameter>codepoint</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Retorna uma string contendo o caractere especificado pelo valor do ponto de código Unicode,
codificado na codificação especificada.
</para>
<para>
Esta função complementa <function>mb_ord</function>.
</para>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>codepoint</parameter></term>
<listitem>
<para>
Um valor de ponto de código Unicode, por exemplo, <literal>128024</literal> para <emphasis>U+1F418 ELEPHANT</emphasis>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>encoding</parameter></term>
<listitem>
&mbstring.encoding.parameter;
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Uma string contendo o caractere solicitado, se puder ser representado na codificação especificada
&return.falseforfailure;.
</para>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&mbstring.changelog.encoding-nullable;
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example>
<title>&intl.codepoint.example;</title>
<programlisting role="php">
<![CDATA[
<?php
$values = [65, 63, 0x20AC, 128024];
foreach ($values as $value) {
var_dump(mb_chr($value, 'UTF-8'));
var_dump(mb_chr($value, 'ISO-8859-1'));
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
string(1) "A"
string(1) "A"
string(1) "?"
string(1) "?"
string(3) "€"
bool(false)
string(4) "🐘"
bool(false)
]]>
</screen>
</example>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mb_internal_encoding</function></member>
<member><function>mb_ord</function></member>
<member><function>IntlChar::ord</function></member>
<member><function>chr</function></member>
</simplelist>
</para>
</refsect1>

</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Loading