1
0
mirror of https://github.com/php/doc-ru.git synced 2026-03-26 00:32:15 +01:00
Files
archived-doc-ru/reference/ctype/book.xml

80 lines
3.9 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 46a9cdd2dbef4ec89bf65fad9930e2feb78bbb98 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<book xml:id="book.ctype" xmlns="http://docbook.org/ns/docbook">
<?phpdoc extension-membership="bundled" ?>
<title>Функции проверки типа символов</title>
<titleabbrev>Ctype</titleabbrev>
<preface xml:id="intro.ctype">
&reftitle.intro;
<para>
Функции модуля проверяют
принадлежность символа или строки конкретному классу символов
с учётом региональных настроек (смотрите также
описание функции <function>setlocale</function>).
</para>
<para>
При вызове с целочисленным аргументом функции ведут себя точно так же,
как их эквиваленты в языке C (из файла <filename>ctype.h</filename>).
Это означает, что если передаётся целое значение меньше 256, функции
проверяют, соответствует ли это ASCII-значение заданному классу символов
(цифры лежат в диапазоне 0x30-0x39). Если число находится в пределах
от -128 до -1 включительно, то к значению числа прибавится 256 и сравнение
будет проводиться с результатом сложения.
</para>
&note.ctype.parameter.non-string;
<para>
Если аргументом выступает строка, функции будут проверять каждый символ
в этой строке и вернут &true;, только если каждый символ удовлетворяет
требуемому условию. &ctype.result.empty-string;
</para>
<para>
При передаче данных других типов (кроме целого числа или строки) функции
сразу же возвращают &false;.
</para>
<para>
Следует отметить, что лучше предпочесть функции модуля ctype регулярным выражениям
и даже некоторым эквивалентным функциям семейств <literal>str_*</literal> и <literal>is_*</literal>.
Это связано с тем, что модуль ctype использует собственную библиотеку языка C и поэтому
работает значительно быстрее.
</para>
<note>
<para>
Эти функции никак не связаны с Python-библиотекой ctypes.
Название модуля происходит от имени заголовочного файла языка C — <filename>ctype.h</filename>,
который содержит эквивалентные определения C-функций.
</para>
<para>
Модуль создали раньше библиотеки ctypes языка Python, поэтому любая
путаница с названиями вряд ли представляет собой ошибку со стороны
разработчиков модуля.
</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
-->