1
0
mirror of https://github.com/php/doc-es.git synced 2026-03-23 23:12:09 +01:00
Files
archived-doc-es/reference/ctype/book.xml
Philippe DELENTE 9a3cc94a9d clean up not EN tree + move/rename file PDO (#166)
* clean up not EN tree + move/rename file PDO

* Review and translation

---------

Co-authored-by: Marcos Porto Mariño <php@marcospor.to>
2025-03-18 01:25:23 +01:00

81 lines
2.8 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 46a9cdd2dbef4ec89bf65fad9930e2feb78bbb98 Maintainer: Marqitos Status: ready -->
<!-- Reviewed: no -->
<book xml:id="book.ctype" xmlns="http://docbook.org/ns/docbook">
<?phpdoc extension-membership="bundled" ?>
<title>Comprobación del tipo de carácter</title>
<titleabbrev>Ctype</titleabbrev>
<preface xml:id="intro.ctype">
&reftitle.intro;
<para>
Las funciones proporcionadas con esta extensión comprueban si un carácter
o string caen dentro de una cierta clase de caracteres según la
configuración regional en uso (véase también <function>setlocale</function>).
</para>
<para>
Cuando estas funciones se invocan con un argumento de tipo integer,
se comportan exactamente como sus homólogas en C de
<filename>ctype.h</filename>.
Esto significa que si se pasa un valor de tipo integer menor que 256 se usará el
valor ASCII del mismo para ver si encaja en el rango especificado (los dígitos están en
el rango 0x30-0x39). Si el número está entre -128 y -1 inclusive, se añadirá 256
y la comprobación se hará sobre el resultado.
</para>
<para>
Cuando se invocan con un argumento de tipo string, comprobarán
cada carácter de la cadena y sólo devolverá
&true; si cada carácter de la cadena coincide con el
criterio solicitado. &ctype.result.empty-string;
</para>
<para>
Pasar cualquier cosa que no sea un valor de tipo string o integer
devolverá inmediatamente &false;.
</para>
<para>
Se debería observar que siempre son preferibles las funciones de ctype a las
expresiones regulares, e incluso a algunas funciones <literal>str_*</literal> y <literal>is_*</literal> equivalentes.
Esto es así por el hecho de que ctype usa una biblioteca nativa de C y
por lo tanto procesa significativamente más rápido.
</para>
<note>
<para>
Estas funciones no están relacionadas con la biblioteca "ctypes" de Python de ningún modo.
El nombre de la extensión proviene del fichero de cabecera <filename>ctype.h</filename>
de C donde están definidas sus equivalentes.
</para>
<para>
Esta extensión también es anterior a 'ctypes' de Python, por lo que cualquier confusión
causada por este nombre difícilmente es culpa de PHP
</para>
</note>
</preface>
&reference.ctype.setup;
&reference.ctype.reference;
</book>
<!-- 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
-->