Spec-Zone.ru › Perl 5.34

POSIX

СОДЕРЖАНИЕ

  • НАЗВАНИЕ
  • СИНТАКСИС
  • ОПИСАНИЕ
  • ЗАМЕЧАНИЯ
  • ФУНКЦИИ
  • КЛАССЫ
    • POSIX::SigAction
    • POSIX::SigRt
    • POSIX::SigSet
    • POSIX::Termios
  • КОНСТАНТЫ ИМЕНЬ ПУТЕЙ
  • КОНСТАНТЫ POSIX
  • КОНСТАНТЫ РЕСУРСОВ
  • КОНФИГУРАЦИЯ СИСТЕМЫ
  • ERRNO
  • FCNTL
  • FLOAT
  • СРЕДА ПЛАВАЮЩЕЙ ТОЧКИ
  • ПРЕДЕЛЫ
  • ЛОКАЛЬ
  • МАТЕМАТИКА
  • СИГНАЛ
  • STAT
  • STDLIB
  • STDIO
  • ВРЕМЯ
  • UNISTD
  • WAIT
  • WINSOCK

НАЗВАНИЕ

POSIX - Perl-интерфейс к IEEE Std 1003.1

СИНТАКСИС

use POSIX ();
use POSIX qw(setsid);
use POSIX qw(:errno_h :fcntl_h);

printf "EINTR is %d\n", EINTR;

$sess_id = POSIX::setsid();

$fd = POSIX::open($path, O_CREAT|O_EXCL|O_WRONLY, 0644);
    # note: that's a filedescriptor, *NOT* a filehandle

ОПИСАНИЕ

Модуль POSIX позволяет вам получить доступ ко всем (или почти всем) стандартным идентификаторам POSIX 1003.1. Многие из этих идентификаторов получили Perl-подобные интерфейсы.

Этот документ содержит свёрнутый список функций, доступных в модуле POSIX. Обратитесь к руководству вашей операционной системы для получения общей информации о большинстве функций. Обратитесь к perlfunc для функций, которые являются идентичными или почти идентичными встроенным функциям Perl.

В первом разделе описаны функции POSIX из спецификации 1003.1. Во втором разделе описаны некоторые классы для объектов сигналов, объектов TTY и других различных объектов. Остальные разделы перечисляют различные константы и макросы в структуре, которая примерно соответствует IEEE Std 1003.1b-1993.

Обозначение [C99] указывает функции, которые были добавлены в стандарт ISO/IEC 9899:1999 языка C. Некоторые из них могут быть недоступны на вашей системе, если она соответствует более раннему стандарту. Попытка использовать любую отсутствующую функцию приведет к сообщению об ошибке во время выполнения.

ЗАМЕЧАНИЯ

Все по умолчанию экспортируется (с несколькими исключениями). Это нежелательная функция обратной совместимости, и её использование настоятельно не рекомендуется. Вы должны либо предотвратить экспорт (сказав use POSIX ();, как обычно), а затем использовать полные имена (например, POSIX::SEEK_END), либо указать явный список импорта. Если вы не сделаете ни того, ни другого и выберете значение по умолчанию (как в use POSIX;), вы импортируете сотни и сотни символов в своё пространство имен.

Некоторые функции не реализованы, потому что они специфичны для языка C. Если вы попытаетесь вызвать эти функции, будет выведено сообщение, информирующее вас о том, что они не реализованы, и предложен аналог на Perl, если таковой существует. Например, попытка доступа к вызову setjmp() вызовет сообщение "setjmp() is C-specific: use eval {} instead".

Кроме того, некоторые поставщики могут утверждать соответствие стандарту 1003.1, но на самом деле не соответствуют ему: они не пройдут PCTS (тесты соответствия POSIX). Например, поставщик может не определять EDEADLK, или семантика значений errno, установленных функцией open(2), может быть не совсем правильной. Perl не пытается проверить соответствие POSIX. Это означает, что вы можете успешно написать "use POSIX", а затем в вашей программе обнаружите, что ваш поставщик был недостаточно внимателен, и макрос ICANON всё же не существует. Это можно рассматривать как ошибку.

ФУНКЦИИ

_exit

Это идентично функции C _exit(). Она немедленно завершает программу, что означает, среди прочего, что буферизованный ввод-вывод не сбрасывается.

Обратите внимание, что при использовании потоков и в Linux это не лучший способ завершения потока, потому что в Linux процессы и потоки чем-то похожи (Примечание: хотя это так в начале 2003 года, в Linux ведутся проекты по обеспечению потокам более POSIX-совместимых семантик). Если вы не хотите возвращаться из потока, отсоедините поток.

abort

Это идентично функции C abort(). Она завершает процесс с сигналом SIGABRT, если он не перехвачен обработчиком сигналов или если обработчик не возвращается нормально (например, он выполняет longjmp).

abs

Это идентично встроенной функции Perl abs(), возвращающей абсолютное значение её числового аргумента (кроме того, что POSIX::abs() должно быть предоставлено явное значение (вместо полагания на неявное $_):

$absolute_value = POSIX::abs(42);   # good

$absolute_value = POSIX::abs();     # throws exception
access

Определяет доступность файла.

if( POSIX::access( "/", &POSIX::R_OK ) ){
        print "have read permission\n";
}

Возвращает undef при ошибке. Обратите внимание: не используйте access() для целей безопасности. Между вызовом access() и операцией, к которой вы готовитесь, разрешения могут измениться: классическая гонка условий.

acos

Это идентично функции C acos(), возвращающей арккосинус её числового аргумента. См. также Math::Trig.

acosh

Это идентично функции C acosh(), возвращающей гиперболический арккосинус её числового аргумента [C99]. См. также Math::Trig. Добавлено в Perl v5.22.

alarm

Это идентично встроенной функции Perl alarm(), либо для включения, либо для отключения таймера SIGARLM, за исключением того, что POSIX::alarm() должно быть предоставлено явное значение (вместо полагания на неявное $_):

POSIX::alarm(3)     # good

POSIX::alarm()      # throws exception
asctime

Это идентично функции C asctime(). Она возвращает строку вида

"Fri Jun  2 18:22:13 2000\n\0"

и вызывается таким образом

$asctime = asctime($sec, $min, $hour, $mday, $mon,
                   $year, $wday, $yday, $isdst);

Значение $mon нулевое: январь равен 0. Значение $year 1900-базовое: 2001 равен 101. $wday и $yday по умолчанию равны нулю (и обычно игнорируются), а $isdst по умолчанию равен -1.

Обратите внимание, что результат всегда на английском языке. Используйте "strftime" вместо этого, чтобы получить результат, подходящий для текущей локали. Формат функции %c задаёт предпочитаемое представление локали.

asin

Это идентично функции C asin(), возвращающей арксинус её числового аргумента. См. также Math::Trig.

asinh

Это идентично функции C asinh(), возвращающей гиперболический арксинус её числового аргумента [C99]. См. также Math::Trig. Добавлено в Perl v5.22.

assert

Не реализовано, но вы можете использовать "die" в perlfunc и модуль Carp для достижения похожих результатов.

atan

Это идентично функции C atan(), возвращающей арктангенс её числового аргумента. См. также Math::Trig.

atanh

Это идентично функции C atanh(), возвращающей гиперболический арктангенс её числового аргумента [C99]. См. также Math::Trig. Добавлено в Perl v5.22.

atan2

Это идентично встроенной функции Perl atan2(), возвращающей арктангенс, определённый её двумя числовыми аргументами, координатами y и x. См. также Math::Trig.

atexit

Не реализовано. atexit() специфично для C: используйте END {} вместо этого, см. perlmod.

atof

Не реализовано. atof() специфично для C. Perl прозрачно преобразует строки в числа. Если вам нужно принудительно преобразовать скаляр в число, добавьте к нему ноль.

atoi

Не реализовано. atoi() специфично для C. Perl прозрачно преобразует строки в числа. Если вам нужно принудительно преобразовать скаляр в число, добавьте к нему ноль. Если вам нужно только целая часть, см. "int" в perlfunc.

atol

Не реализовано. atol() специфично для C. Perl прозрачно преобразует строки в числа. Если вам нужно принудительно преобразовать скаляр в число, добавьте к нему ноль. Если вам нужно только целая часть, см. "int" в perlfunc.

bsearch

bsearch() не предоставлено. Для выполнения двоичного поиска в словарях см. Search::Dict.

calloc

Не реализовано. calloc() специфично для C. Perl прозрачно управляет памятью.

cbrt

Кубический корень [C99]. Добавлено в Perl v5.22.

ceil

Это идентично функции C ceil(), возвращающей наименьшее целое значение, большее или равное заданному числовому аргументу.

chdir

Это идентично встроенной функции Perl chdir(), позволяющей изменить рабочий (по умолчанию) каталог - см. "chdir" в perlfunc - за исключением того, что POSIX::chdir() должно быть предоставлено явное значение (вместо полагания на неявное $_):

$rv = POSIX::chdir('path/to/dir');      # good

$rv = POSIX::chdir();                   # throws exception
chmod

Это идентично встроенной функции Perl chmod(), позволяющей изменить разрешения файлов и каталогов - см. "chmod" в perlfunc - за исключением того, что POSIX::chmod() может изменить только один файл за раз (вместо списка файлов):

$c = chmod 0664, $file1, $file2;          # good

$c = POSIX::chmod 0664, $file1;           # throws exception

$c = POSIX::chmod 0664, $file1, $file2;   # throws exception

Как и в случае со встроенной функцией chmod(), $file может быть именем файла или дескриптором файла.

chown

Это идентично встроенной функции Perl chown(), позволяющей изменить владельцев и группы файлов и каталогов, см. "chown" в perlfunc.

clearerr

Не реализовано. Используйте метод IO::Handle::clearerr() вместо этого, чтобы сбросить состояние ошибки (если оно есть) и состояние EOF (если оно есть) данного потока.

clock

Это идентично функции C clock(), возвращающей количество потраченного процессорного времени в микросекундах.

close

Закрыть файл. Это использует дескрипторы файлов, такие как те, которые получены при вызове POSIX::open.

$fd = POSIX::open( "foo", &POSIX::O_RDONLY );
POSIX::close( $fd );

Возвращает undef при ошибке.

См. также "close" в perlfunc.

closedir

Это идентично встроенной функции Perl closedir() для закрытия дескриптора каталога, см. "closedir" в perlfunc.

cos

Это идентично встроенной функции Perl cos(), для возвращения косинуса её числового аргумента, см. "cos" в perlfunc. См. также Math::Trig.

cosh

Это идентично функции C cosh(), для возвращения гиперболического косинуса её числового аргумента. См. также Math::Trig.

copysign

Возвращает x, но со знаком y [C99]. Добавлено в Perl v5.22.

$x_with_sign_of_y = POSIX::copysign($x, $y);

См. также "signbit".

creat

Создать новый файл. Это возвращает дескриптор файла, как и те, что возвращаются POSIX::open. Используйте POSIX::close для закрытия файла.

$fd = POSIX::creat( "foo", 0611 );
POSIX::close( $fd );

См. также "sysopen" в perlfunc и его флаг O_CREAT.

ctermid

Генерирует имя пути к управляющему терминалу.

$path = POSIX::ctermid();
ctime

Это идентично функции C ctime() и эквивалентно asctime(localtime(...)), см. "asctime" и "localtime".

cuserid [POSIX.1-1988]

Получить имя пользователя владельца текущего процесса.

$name = POSIX::cuserid();

Примечание: эта функция не была специфицирована POSIX с 1990 года и включена только для обратной совместимости. Новый код должен использовать getlogin() вместо этого.

difftime

Это идентично функции C difftime(), для возвращения разницы во времени (в секундах) между двумя моментами (как возвращает time()), см. "time".

div

Не реализовано. div() специфично для C, используйте "int" в perlfunc для обычного / деления и остатка %.

dup

Это похоже на функцию C dup(), для дублирования дескриптора файла.

Это использует дескрипторы файлов, такие как те, которые получены при вызове POSIX::open.

Возвращает undef при ошибке.

dup2

Это похоже на функцию C dup2(), для дублирования дескриптора файла в другой известный дескриптор файла.

Это использует дескрипторы файлов, такие как те, которые получены при вызове POSIX::open.

Возвращает undef при ошибке.

erf

Функция ошибки [C99]. Добавлено в Perl v5.22.

erfc
END_OF_DOCUMENT_MARKER

Дополнительная функция ошибок [C99]. Добавлена в Perl v5.22.

errno

Возвращает значение errno.

$errno = POSIX::errno();

Это идентично числовым значениям $!, см. "$ERRNO" в perlvar.

execl

Не реализовано. execl() — специфично для C, см. "exec" в perlfunc.

execle

Не реализовано. execle() — специфично для C, см. "exec" в perlfunc.

execlp

Не реализовано. execlp() — специфично для C, см. "exec" в perlfunc.

execv

Не реализовано. execv() — специфично для C, см. "exec" в perlfunc.

execve

Не реализовано. execve() — специфично для C, см. "exec" в perlfunc.

execvp

Не реализовано. execvp() — специфично для C, см. "exec" в perlfunc.

exit

Это идентично встроенной в Perl функции exit() для выхода из программы, см. "exit" в perlfunc.

exp

Это идентично встроенной в Perl функции exp() для возвращения показателя степени (по основанию e) числового аргумента, см. "exp" в perlfunc.

expm1

Эквивалентно exp(x) - 1, но точнее для малых значений аргумента [C99]. Добавлена в Perl v5.22.

См. также "log1p".

fabs

Это идентично встроенной в Perl функции abs() для возвращения абсолютного значения числового аргумента, см. "abs" в perlfunc.

fclose

Не реализовано. Используйте метод IO::Handle::close() вместо этого, или см. "close" в perlfunc.

fcntl

Это идентично встроенной в Perl функции fcntl() , см. "fcntl" в perlfunc.

fdopen

Не реализовано. Используйте метод IO::Handle::new_from_fd() вместо этого, или см. "open" в perlfunc.

feof

Не реализовано. Используйте метод IO::Handle::eof() вместо этого, или см. "eof" в perlfunc.

ferror

Не реализовано. Используйте метод IO::Handle::error() вместо этого.

fflush

Не реализовано. Используйте метод IO::Handle::flush() вместо этого. См. также "$OUTPUT_AUTOFLUSH" in perlvar.

fgetc

Не реализовано. Используйте метод IO::Handle::getc() вместо этого, или см. "read" в perlfunc.

fgetpos

Не реализовано. Используйте метод IO::Seekable::getpos() вместо этого, или см. "seek" в perlfunc.

fgets

Не реализовано. Используйте метод IO::Handle::gets() вместо этого. Аналогично <>, также известный как "readline" в perlfunc.

fileno

Не реализовано. Используйте метод IO::Handle::fileno() вместо этого, или см. "fileno" в perlfunc.

floor

Это идентично функции C floor(), возвращающей наибольшее целое значение, меньшее или равное числовому аргументу.

fdim

"Положительная разность", x - y если x > y, ноль в противном случае [C99]. Добавлена в Perl v5.22.

fegetround

Возвращает текущий режим округления чисел с плавающей точкой, один из

FE_TONEAREST FE_TOWARDZERO FE_UPWARD FE_DOWNWARD

FE_TONEAREST подобен "round", FE_TOWARDZERO подобен "trunc" [C99]. Добавлена в Perl v5.22.

fesetround

Устанавливает режим округления чисел с плавающей точкой, см. "fegetround" [C99]. Добавлена в Perl v5.22.

fma

"Объединённое умножение-сложение", x * y + z, возможно, быстрее (и менее потерпевающее потерь) чем явное выполнение двух операций [C99]. Добавлена в Perl v5.22.

my $fused = POSIX::fma($x, $y, $z);
fmax

Максимум из x и y, за исключением случаев, когда один из них NaN, возвращает другой [C99]. Добавлена в Perl v5.22.

my $min = POSIX::fmax($x, $y);
fmin

Минимум из x и y, за исключением случаев, когда один из них NaN, возвращает другой [C99]. Добавлена в Perl v5.22.

my $min = POSIX::fmin($x, $y);
fmod

Это идентично функции C fmod().

$r = fmod($x, $y);

Возвращает остаток $r = $x - $n*$y, где $n = trunc($x/$y). Остаток имеет тот же знак, что и $x, и величину (абсолютное значение) меньше величины $y.

fopen

Не реализовано. Используйте метод IO::File::open() вместо этого, или см. "open" в perlfunc.

fork

Это идентично встроенной в Perl функции fork() для дублирования текущего процесса, см. "fork" в perlfunc и perlfork, если вы работаете в Windows.

fpathconf

Возвращает значение конфигурируемого ограничения файла или каталога. Используются дескрипторы файлов, такие как полученные при вызове POSIX::open.

Следующее определит максимальную длину самого длинного допустимого пути в файловой системе, которая содержит /var/foo.

$fd = POSIX::open( "/var/foo", &POSIX::O_RDONLY );
$path_max = POSIX::fpathconf($fd, &POSIX::_PC_PATH_MAX);

Возвращает undef при ошибке.

fpclassify

Возвращает одно из

FP_NORMAL FP_ZERO FP_SUBNORMAL FP_INFINITE FP_NAN

указывающее на класс аргумента [C99]. FP_INFINITE — положительная или отрицательная бесконечность, FP_NAN — не число. FP_SUBNORMAL означает субнормальные числа (также известные как денормали), очень маленькие числа с низкой точностью. FP_ZERO — ноль. FP_NORMAL — всё остальное. Добавлена в Perl v5.22.

fprintf

Не реализовано. fprintf() — специфично для C, см. "printf" в perlfunc вместо этого.

fputc

Не реализовано. fputc() — специфично для C, см. "print" в perlfunc вместо этого.

fputs

Не реализовано. fputs() — специфично для C, см. "print" в perlfunc вместо этого.

fread

Не реализовано. fread() — специфично для C, см. "read" в perlfunc вместо этого.

free

Не реализовано. free() — специфично для C. Perl управляет памятью прозрачно.

freopen

Не реализовано. freopen() — специфично для C, см. "open" в perlfunc вместо этого.

frexp

Возвращает мантиссу и показатель степени числа с плавающей точкой.

($mantissa, $exponent) = POSIX::frexp( 1.234e56 );
fscanf

Не реализовано. fscanf() — специфично для C, используйте <> и регулярные выражения вместо этого.

fseek

Не реализовано. Используйте метод IO::Seekable::seek() вместо этого, или см. "seek" в perlfunc.

fsetpos

Не реализовано. Используйте метод IO::Seekable::setpos() вместо этого, или см. "seek" в perlfunc.

fstat

Получить состояние файла. Используются дескрипторы файлов, такие как полученные при вызове POSIX::open. Возвращаемые данные идентичны данным из встроенной в Perl функции stat.

$fd = POSIX::open( "foo", &POSIX::O_RDONLY );
@stats = POSIX::fstat( $fd );
fsync

Не реализовано. Используйте метод IO::Handle::sync() вместо этого.

ftell

Не реализовано. Используйте метод IO::Seekable::tell() вместо этого, или см. "tell" в perlfunc.

fwrite

Не реализовано. fwrite() — специфично для C, см. "print" в perlfunc вместо этого.

getc

Это идентично встроенной в Perl функции getc() , см. "getc" в perlfunc.

getchar

Возвращает один символ из STDIN. Идентично Perl'овскому getc(), см. "getc" в perlfunc.

getcwd

Возвращает имя текущего каталога. См. также Cwd.

getegid

Возвращает эффективный идентификатор группы. Аналогично встроенной переменной Perl $(, см. "$EGID" в perlvar.

getenv

Возвращает значение указанной переменной среды. Та же информация доступна через массив %ENV.

geteuid

Возвращает эффективный идентификатор пользователя. Идентично встроенной переменной Perl $>, см. "$EUID" в perlvar.

getgid

Возвращает реальный идентификатор группы пользователя. Аналогично встроенной переменной Perl $), см. "$GID" в perlvar.

getgrgid

Это идентично встроенной в Perl функции getgrgid() для возвращения записей групп по идентификаторам групп, см. "getgrgid" в perlfunc.

getgrnam

Это идентично встроенной в Perl функции getgrnam() для возвращения записей групп по именам групп, см. "getgrnam" в perlfunc.

getgroups

Возвращает идентификаторы дополнительных групп пользователя. Аналогично встроенной переменной Perl $), см. "$GID" в perlvar.

getlogin

Это идентично встроенной в Perl функции getlogin() для возвращения имени пользователя, связанного с текущим сеансом, см. "getlogin" в perlfunc.

getpayload
use POSIX ':nan_payload';
getpayload($var)

Возвращает NaN полезную нагрузку. Добавлено в Perl v5.24.

Обратите внимание на предупреждение об API-нестабильности в "setpayload".

См. "nan" для получения дополнительной информации об NaN.

getpgrp

Это идентично встроенной в Perl функции getpgrp() для возвращения идентификатора группы процессов текущего процесса, см. "getpgrp" в perlfunc.

getpid

Возвращает идентификатор процесса. Идентично встроенной переменной Perl $$, см. "$PID" в perlvar.

getppid

Это идентично встроенной в Perl функции getppid() для возвращения идентификатора процесса родительского процесса текущего процесса, см. "getppid" в perlfunc.

getpwnam

Это идентично встроенной в Perl функции getpwnam() для возвращения записей пользователей по именам пользователей, см. "getpwnam" в perlfunc.

getpwuid

Это идентично встроенной в Perl функции getpwuid() для возвращения записей пользователей по идентификаторам пользователей, см. "getpwuid" в perlfunc.

gets

Возвращает одну строку из STDIN, аналогично <>, также известная как функция readline(), см. "readline" в perlfunc.

ПРИМЕЧАНИЕ: если у вас есть программы на C, которые все еще используют gets(), будьте очень осторожны. Функция gets() является источником бесконечных проблем, потому что в ней нет проверок переполнения буфера. Ее никогда не следует использовать. Вместо нее следует предпочесть функцию fgets().

getuid

Возвращает идентификатор пользователя. Идентично встроенной переменной Perl $<, см. "$UID" в perlvar.

gmtime

Это идентично встроенной в Perl функции gmtime() для преобразования секунд с эпохи в дату в Гринвичском среднем времени, см. "gmtime" в perlfunc.

hypot

Эквивалентно sqrt(x * x + y * y), но более стабильно при очень больших или очень малых аргументах [C99]. Добавлено в Perl v5.22.

ilogb

Целочисленный двоичный логарифм [C99]. Добавлено в Perl v5.22.

Например, ilogb(20) равно 4, как целое число.

См. также "logb".

Inf

Бесконечность как константа:

use POSIX qw(Inf);
my $pos_inf = +Inf;  # Or just Inf.
my $neg_inf = -Inf;

См. также "isinf" и "fpclassify".

isalnum

Эта функция удалена начиная с Perl v5.24. Она была очень похожа на сопоставление с qr/ ^ [[:alnum:]]+ $ /x, которую следует использовать вместо нее. См. "POSIX Character Classes" в perlrecharclass.

isalpha

Эта функция удалена начиная с Perl v5.24. Она была очень похожа на сопоставление с qr/ ^ [[:alpha:]]+ $ /x, которую следует использовать вместо нее. См. "POSIX Character Classes" в perlrecharclass.

isatty

Возвращает булево значение, указывающее, подключен ли указанный дескриптор файла к tty. Аналогично оператору -t, см. "-X" в perlfunc.

iscntrl

Эта функция удалена начиная с Perl v5.24. Она была очень похожа на сопоставление с qr/ ^ [[:cntrl:]]+ $ /x, которую следует использовать вместо нее. См. "POSIX Character Classes" в perlrecharclass.

isdigit

Эта функция удалена начиная с Perl v5.24. Она была очень похожа на сопоставление с qr/ ^ [[:digit:]]+ $ /x, которую следует использовать вместо нее. См. "POSIX Character Classes" в perlrecharclass.

isfinite

Возвращает true, если аргумент является конечным числом (то есть не бесконечность и не число не является числом) [C99]. Добавлено в Perl v5.22.

См. также "isinf", "isnan" и "fpclassify".

isgraph

Эта функция удалена начиная с Perl v5.24. Она была очень похожа на сопоставление с qr/ ^ [[:graph:]]+ $ /x, которую следует использовать вместо нее. См. "POSIX Character Classes" в perlrecharclass.

isgreater

(Также isgreaterequal, isless, islessequal, islessgreater, isunordered)

Сравнения с плавающей точкой, которые обрабатывают NaN [C99]. Добавлено в Perl v5.22.

isinf

Возвращает true, если аргумент является бесконечностью (положительной или отрицательной) [C99]. Добавлено в Perl v5.22.

См. также "Inf", "isnan", "isfinite" и "fpclassify".

islower

Эта функция удалена начиная с Perl v5.24. Она была очень похожа на сопоставление с qr/ ^ [[:lower:]]+ $ /x, которую следует использовать вместо нее. См. "POSIX Character Classes" в perlrecharclass.

isnan

Возвращает true, если аргумент является NaN (числом, не являющимся числом) [C99]. Добавлено в Perl v5.22.

Обратите внимание, что вы не можете проверить "NaN-ность" с

$x == $x

так как NaN не эквивалентно ничему, включая себя.

См. также "nan", "NaN", "isinf" и "fpclassify".

isnormal

Возвращает true, если аргумент является нормальным (то есть не является субнормальным/денормализованным, не является бесконечностью и не является числом, не являющимся числом) [C99]. Добавлено в Perl v5.22.

См. также "isfinite" и "fpclassify".

isprint

Эта функция удалена начиная с Perl v5.24. Она была очень похожа на сопоставление с qr/ ^ [[:print:]]+ $ /x, которую следует использовать вместо нее. См. "POSIX Character Classes" в perlrecharclass.

ispunct

Эта функция удалена начиная с Perl v5.24. Она была очень похожа на сопоставление с qr/ ^ [[:punct:]]+ $ /x, которую следует использовать вместо нее. См. "POSIX Character Classes" в perlrecharclass.

issignaling
use POSIX ':nan_payload';
issignaling($var, $payload)

Возвращает true, если аргумент является сигнализирующим NaN. Добавлено в Perl v5.24.

Обратите внимание на предупреждение об API-нестабильности в "setpayload".

См. "nan" для получения дополнительной информации об NaN.

isspace

Эта функция удалена начиная с Perl v5.24. Она была очень похожа на сопоставление с qr/ ^ [[:space:]]+ $ /x, которую следует использовать вместо нее. См. "POSIX Character Classes" в perlrecharclass.

isupper

Эта функция удалена начиная с Perl v5.24. Она была очень похожа на сопоставление с qr/ ^ [[:upper:]]+ $ /x, которую следует использовать вместо нее. См. "POSIX Character Classes" в perlrecharclass.

isxdigit

Эта функция удалена начиная с Perl v5.24. Она была очень похожа на сопоставление с qr/ ^ [[:xdigit:]]+ $ /x, которую следует использовать вместо нее. См. "POSIX Character Classes" в perlrecharclass.

j0
j1
jn
y0
y1
yn

Функция Бесселя первого рода нулевого порядка.

kill

Это идентично встроенной в Perl функции kill() для отправки сигналов процессам (часто для их завершения), см. "kill" в perlfunc.

labs

Не реализовано. (Для возвращения абсолютных значений целых чисел типа long.) labs() — это специфично для C, см. "abs" в perlfunc вместо этого.

lchown

Это идентично функции C, за исключением порядка аргументов, который согласуется со встроенной функцией Perl chown() с добавлением ограничения на один путь, а не список путей. Выполняет ту же операцию, что и функция chown(), но изменяет владельца символической ссылки вместо файла, на который она указывает.

POSIX::lchown($uid, $gid, $file_path);
ldexp

Это идентично функции C ldexp() для умножения чисел с плавающей точкой на степени двойки.

$x_quadrupled = POSIX::ldexp($x, 2);
ldiv

Не реализовано. (Для вычисления частных от деления целых чисел типа long.) ldiv() специфична для C, используйте / и int() вместо неё.

lgamma

Логарифм гамма-функции [C99]. Добавлено в Perl v5.22.

См. также "tgamma".

log1p

Эквивалентно log(1 + x), но обеспечивает более стабильные результаты для малых значений аргумента [C99]. Добавлено в Perl v5.22.

log2

Логарифм по основанию два [C99]. Добавлено в Perl v5.22.

См. также "expm1".

logb

Целочисленный двоичный логарифм [C99]. Добавлено в Perl v5.22.

Например, logb(20) равно 4, как число с плавающей точкой.

См. также "ilogb".

link

Это идентично встроенной в Perl функции link() для создания жёстких ссылок на файлы, см. "link" в perlfunc.

localeconv

Получение информации о числовом формате. Возвращает ссылку на хеш, содержащий значения форматирования локали, которая в настоящее время используется программой, независимо от того, вызвана ли она в области видимости use locale. Пользователи этой функции также должны прочитать perllocale, в котором содержится подробное обсуждение обработки локали в Perl, включая раздел, посвящённый этой функции. До Perl 5.28 или при работе в не-потокобезопасной среде её не следует использовать в потоковой приложении, если не известно, что основная локаль — C или POSIX. Это связано с тем, что в противном случае она изменяет локаль, что глобально влияет на все потоки одновременно. Платформы Windows, начиная с Visual Studio 2005, в основном потокобезопасны, но использование этой функции до Visual Studio 2015 может привести к гонке с потоком, который вызвал "switch_to_global_locale" в perlapi.

Вот как запросить базу данных для локали de (Deutsch или немецкая).

my $loc = POSIX::setlocale( &POSIX::LC_ALL, "de" );
print "Locale: \"$loc\"\n";
my $lconv = POSIX::localeconv();
foreach my $property (qw(
        decimal_point
        thousands_sep
        grouping
        int_curr_symbol
        currency_symbol
        mon_decimal_point
        mon_thousands_sep
        mon_grouping
        positive_sign
        negative_sign
        int_frac_digits
        frac_digits
        p_cs_precedes
        p_sep_by_space
        n_cs_precedes
        n_sep_by_space
        p_sign_posn
        n_sign_posn
        int_p_cs_precedes
        int_p_sep_by_space
        int_n_cs_precedes
        int_n_sep_by_space
        int_p_sign_posn
        int_n_sign_posn
))
{
        printf qq(%s: "%s",\n),
                $property, $lconv->{$property};
}

Члены, имена которых начинаются с int_p_ и int_n_, были добавлены POSIX.1-2008 и доступны только на системах, которые их поддерживают.

localtime

Это идентично встроенной в Perl функции localtime() для преобразования секунд с начала эпохи в дату, см. "localtime" в perlfunc, за исключением того, что POSIX::localtime() необходимо предоставить явное значение (вместо полагания на неявное $_):

@localtime = POSIX::localtime(time);    # good

@localtime = localtime();               # good

@localtime = POSIX::localtime();        # throws exception
log

Это идентично встроенной в Perl функции log(), возвращающей натуральный (e-основанный) логарифм числового аргумента, см. "log" в perlfunc.

log10

Это идентично функции C log10(), возвращающей логарифм по основанию 10 числового аргумента. Вы также можете использовать

sub log10 { log($_[0]) / log(10) }

или

sub log10 { log($_[0]) / 2.30258509299405 }

или

sub log10 { log($_[0]) * 0.434294481903252 }
longjmp

Не реализовано. longjmp() специфична для C: используйте "die" в perlfunc вместо неё.

lseek

Перемещение позиции чтения/записи файла. Используются дескрипторы файлов, такие как полученные путём вызова POSIX::open.

$fd = POSIX::open( "foo", &POSIX::O_RDONLY );
$off_t = POSIX::lseek( $fd, 0, &POSIX::SEEK_SET );

Возвращает undef при ошибке.

lrint

В зависимости от текущего режима округления чисел с плавающей точкой, округляет аргумент либо до ближайшего значения (как "round"), либо к нулю (как "trunc"), вниз (к отрицательной бесконечности) или вверх (к положительной бесконечности) [C99]. Добавлено в Perl v5.22.

Для режима округления см. "fegetround".

lround

Подобно "round", но как целое число, а не число с плавающей точкой [C99]. Добавлено в Perl v5.22.

См. также "ceil", "floor", "trunc".

Вследствие упущения, в настоящее время он не экспортируется по умолчанию или в рамках тега экспорта :math_h_c99; поэтому его импорт необходимо выполнить явно.

malloc

Не реализовано. malloc() специфична для C. Perl прозрачно управляет памятью.

mblen

Это то же самое, что функция C mblen() в не-потоковых Perl. В потоковых Perl она прозрачно (почти) заменяет более потокобезопасную mbrlen(3), если она доступна, вместо mblen.

Основной Perl не поддерживает широкие и многобайтовые локали, за исключением локали Unicode UTF-8. Эта функция в сочетании с "mbtowc" и "wctomb" может быть использована для самостоятельного декодирования/кодирования других типов многобайтовых локали.

Используйте undef в качестве первого параметра, чтобы получить эффект передачи NULL в качестве первого параметра функции mblen. Это сбрасывает любой сдвиг состояния до его начального значения. Возвращаемое значение неопределено, если mbrlen была заменена, поэтому на нём никогда не следует полагаться.

Когда первый параметр — скаляр, содержащий строку PV или её можно преобразовать в PV строку, возвращаемое значение — количество байтов, занимаемых первым символом этой строки; или 0, если этот первый символ — широкий символ NUL; или отрицательное значение, если произошла ошибка. Это основано на локали, которая в настоящее время используется программой, независимо от того, вызвана ли функция из Perl-кода в области видимости use locale. Perl не пытается скрыть от вашего кода любые различия в настройке errno между mblen и mbrlen . Он устанавливает errno в 0 перед их вызовом.

Необязательный второй параметр игнорируется, если он больше фактической длины строки первого параметра.

mbtowc

Это то же самое, что функция C mbtowc() в не-потоковых Perl. В потоковых Perl она прозрачно (почти) заменяет более потокобезопасную mbrtowc(3), если она доступна, вместо mbtowc.

Основной Perl не поддерживает широкие и многобайтовые локали, за исключением локали Unicode UTF-8. Эта функция в сочетании с "mblen" и "wctomb" может быть использована для самостоятельного декодирования/кодирования других типов многобайтовых локали.

Первый параметр — скаляр, в который при успехе сохраняется широкий символ, представленный многобайтовой строкой, содержащейся во втором параметре. Необязательный третий параметр игнорируется, если он больше фактической длины строки второго параметра.

Используйте undef в качестве второго параметра, чтобы получить эффект передачи NULL в качестве второго параметра функции mbtowc. Это сбрасывает любой сдвиг состояния до его начального значения. Возвращаемое значение неопределено, если mbrtowc была заменена, поэтому на нём никогда не следует полагаться.

Когда второй параметр — скаляр, содержащий строку PV или её можно преобразовать в PV строку, возвращаемое значение — количество байтов, занимаемых первым символом этой строки; или 0, если этот первый символ — широкий символ NUL; или отрицательное значение, если произошла ошибка. Это основано на локали, которая в настоящее время используется программой, независимо от того, вызвана ли функция из Perl-кода в области видимости use locale. Perl не пытается скрыть от вашего кода любые различия в настройке errno между mbtowc и mbrtowc . Он устанавливает errno в 0 перед их вызовом.

memchr

Не реализовано. memchr() специфична для C, см. "index" в perlfunc вместо неё.

memcmp

Не реализовано. memcmp() специфична для C, используйте eq вместо неё, см. perlop.

memcpy

Не реализовано. memcpy() специфична для C, используйте =, см. perlop, или см. "substr" в perlfunc.

memmove

Не реализовано. memmove() специфична для C, используйте =, см. perlop, или см. "substr" в perlfunc.

memset

Не реализовано. memset() специфична для C, используйте x вместо неё, см. perlop.

mkdir

Это идентично встроенной в Perl функции mkdir() для создания каталогов, см. "mkdir" в perlfunc.

mkfifo

Это аналогично функции C mkfifo() для создания специальных файлов FIFO.

if (mkfifo($path, $mode)) { ....

Возвращает undef при ошибке. $mode аналогична режиму mkdir(), см. "mkdir" в perlfunc, хотя для mkfifo вы обязательно должны указать $mode.

mktime

Преобразование информации о дате/времени в календарное время.

Синтаксис:

mktime(sec, min, hour, mday, mon, year, wday = 0,
       yday = 0, isdst = -1)

Месяц (mon), день недели (wday), и день года (yday) начинаются с нуля, т.е., январь — 0, а не 1; воскресенье — 0, а не 1; 1 января — 0, а не 1. Год (year ) задаётся в годах с 1900 года; т.е., год 1995 — 95; год 2001 — 101. Обратитесь к руководству вашей системы mktime() для получения подробностей об этих и других аргументах.

Календарное время для 12 декабря 1995 года в 10:30 утра.

$time_t = POSIX::mktime( 0, 30, 10, 12, 11, 95 );
print "Date = ", POSIX::ctime($time_t);

Возвращает undef при ошибке.

modf

Возвращение целой и дробной части числа с плавающей точкой.

($fractional, $integral) = POSIX::modf( 3.14 );

См. также "round".

NaN

Число, не являющееся числом (NaN) как константа:

use POSIX qw(NaN);
my $nan = NaN;

См. также "nan", /isnan, и "fpclassify".

nan
my $nan = nan();

Возвращает NaN, число, не являющееся числом [C99]. Добавлено в Perl v5.22.

Возвращаемое NaN всегда является тихим NaN, в отличие от сигнализирующего.

С аргументом можно сгенерировать NaN с нагрузкой. Аргумент сначала интерпретируется как число с плавающей точкой, но затем дробные части усекаются (к нулю), и значение интерпретируется как целое без знака. Биты этого целого числа хранятся в неиспользуемых битах NaN.

Результат имеет двойственную природу: это NaN, но он также несёт целое число внутри. Целое число можно получить с помощью "getpayload". Однако следует учесть, что нагрузка не передаётся, даже при копировании, и определённо не в арифметических операциях.

Количество битов, умещающихся в NaN, зависит от типа используемых чисел с плавающей точкой, но на наиболее распространённых платформах (64-битный IEEE 754 или 80-битные long double x86) доступно соответственно 51 и 61 бит. (Было бы 52 и 62, но бит quiet/signaling NaN занимает один.) Однако из-за преобразований из чисел с плавающей точкой в целые и обратно, пожалуйста, тщательно протестируйте, получаете ли вы обратно то, что ввели. Если ваши целые числа имеют только 32 бита, вы, вероятно, не должны полагаться на больше, чем 32 бита нагрузки.

Различается ли "сигнализирующее" NaN от "тихого" NaN каким-либо образом, зависит от платформы. Также обратите внимание, что нагрузка по умолчанию NaN (без аргумента в nan()) не обязательно равна нулю, используйте setpayload для явного задания нагрузки. На некоторых платформах, таких как 32-битный x86 (если не используются 80-битные long double), бит сигнализации вообще не поддерживается.

См. также "isnan", "NaN", "setpayload" и "issignaling".

nearbyint

Возвращает ближайшее целое число к аргументу в соответствии с текущим режимом округления (см. "fegetround") [C99]. Добавлено в Perl v5.22.

nextafter

Возвращает следующее представимое число с плавающей точкой после x в направлении y [C99]. Добавлено в Perl v5.22.

my $nextafter = POSIX::nextafter($x, $y);

Аналогично "nexttoward", но потенциально менее точным.

nexttoward

Возвращает следующее представимое число с плавающей точкой после x в направлении y [C99]. Добавлено в Perl v5.22.

my $nexttoward = POSIX::nexttoward($x, $y);

Аналогично "nextafter", но потенциально более точным.

nice

Это аналогично функции C nice(), для изменения приоритета планирования текущего процесса. Положительные аргументы означают более вежливый процесс, отрицательные значения — более нуждающийся процесс. Обычные (не root) пользовательские процессы могут изменить только в сторону большей вежливости.

Возвращает undef при ошибке.

offsetof

Не реализовано. offsetof() — это специфично для C, вы, вероятно, хотите посмотреть "pack" в perlfunc вместо этого.

open

Открыть файл для чтения или записи. Это возвращает дескрипторы файлов, а не дескрипторы файлов Perl. Используйте POSIX::close для закрытия файла.

Открыть файл только для чтения с режимом 0666.

$fd = POSIX::open( "foo" );

Открыть файл для чтения и записи.

$fd = POSIX::open( "foo", &POSIX::O_RDWR );

Открыть файл для записи с усечением.

$fd = POSIX::open(
        "foo", &POSIX::O_WRONLY | &POSIX::O_TRUNC
);

Создать новый файл с режимом 0640. Подготовить файл для записи.

$fd = POSIX::open(
        "foo", &POSIX::O_CREAT | &POSIX::O_WRONLY, 0640
);

Возвращает undef при ошибке.

См. также "sysopen" в perlfunc.

opendir

Открыть директорию для чтения.

$dir = POSIX::opendir( "/var" );
@files = POSIX::readdir( $dir );
POSIX::closedir( $dir );

Возвращает undef при ошибке.

pathconf

Извлекает значение конфигурируемого ограничения для файла или директории.

Следующее определит максимальную длину самого длинного допустимого пути в файловой системе, которая содержит /var.

$path_max = POSIX::pathconf( "/var",
                              &POSIX::_PC_PATH_MAX );

Возвращает undef при ошибке.

pause

Это аналогично функции C pause(), которая приостанавливает выполнение текущего процесса до получения сигнала.

Возвращает undef при ошибке.

perror

Это идентично функции C perror(), которая выводит в поток стандартной ошибки указанное сообщение, за которым следует ": " и текущую строку ошибки. Используйте функцию warn() и переменную $!, см. "warn" в perlfunc и "$ERRNO" в perlvar.

pipe

Создать межпроцессный канал. Это возвращает дескрипторы файлов, такие же, как те, которые возвращает POSIX::open.

my ($read, $write) = POSIX::pipe();
POSIX::write( $write, "hello", 5 );
POSIX::read( $read, $buf, 5 );

См. также "pipe" в perlfunc.

pow

Вычисляет $x в степени $exponent.

$ret = POSIX::pow( $x, $exponent );

Вы также можете использовать оператор **, см. perlop.

printf

Форматирует и выводит указанные аргументы в STDOUT. См. также "printf" в perlfunc.

putc

Не реализовано. putc() — это специфично для C, см. "print" в perlfunc вместо этого.

putchar

Не реализовано. putchar() — это специфично для C, см. "print" в perlfunc вместо этого.

puts

Не реализовано. puts() — это специфично для C, см. "print" в perlfunc вместо этого.

qsort

Не реализовано. qsort() — это специфично для C, см. "sort" в perlfunc вместо этого.

raise

Отправляет указанный сигнал текущему процессу. См. также "kill" в perlfunc и $$ в "$PID" в perlvar.

rand

Не реализовано. rand() не переносимо, см. "rand" в perlfunc вместо этого.

read

Читать из файла. Это использует дескрипторы файлов, такие как те, что получены вызовом POSIX::open. Если буфер $buf недостаточно велик для чтения, Perl расширит его, чтобы освободить место для запроса.

$fd = POSIX::open( "foo", &POSIX::O_RDONLY );
$bytes = POSIX::read( $fd, $buf, 3 );

Возвращает undef при ошибке.

См. также "sysread" в perlfunc.

readdir

Это идентично встроенной функции Perl readdir() для чтения записей каталога, см. "readdir" в perlfunc.

realloc

Не реализовано. realloc() — это специфично для C. Perl прозрачно управляет памятью.

remainder

Даны x и y, возвращает значение x - n*y, где n — это целое число, наиболее близкое к x/y [C99]. Добавлено в Perl v5.22.

my $remainder = POSIX::remainder($x, $y)

См. также "remquo".

remove

Удаляет имя из файловой системы. Вызывает "unlink" в perlfunc для файлов и "rmdir" в perlfunc для каталогов.

remquo

Подобно "remainder", но также возвращает младшие биты частного (n) [C99]. Добавлено в Perl v5.22.

(Это довольно экзотический интерфейс, в основном используется для реализации численных алгоритмов.)

rename

Это идентично встроенной функции Perl rename() для переименования файлов, см. "rename" в perlfunc.

rewind

Перемещает указатель в начало файла.

rewinddir

Это идентично встроенной функции Perl rewinddir() для перемотки потоков записей каталога, см. "rewinddir" в perlfunc.

rint

Идентично "lrint".

rmdir

Это идентично встроенной функции Perl rmdir() для удаления (пустых) каталогов, см. "rmdir" в perlfunc.

round

Возвращает целое число (но всё ещё с плавающей точкой), ближайшее к аргументу [C99]. Добавлено в Perl v5.22.

См. также "ceil", "floor", "lround", "modf" и "trunc".

scalbn

Возвращает x * 2**y [C99]. Добавлено в Perl v5.22.

См. также "frexp" и "ldexp".

scanf

Не реализовано. scanf() — это специфично для C, используйте <> и регулярные выражения вместо этого, см. perlre.

setgid

Устанавливает действительный и эффективный идентификатор группы для данного процесса. Аналогично присвоению значения встроенной переменной Perl $), см. "$EGID" в perlvar, за исключением того, что последний изменит только действительный идентификатор пользователя, а setgid() использует только один числовой аргумент, а не список чисел, разделённых пробелом.

setjmp

Не реализовано. setjmp() — это специфично для C: используйте eval {} вместо этого, см. "eval" в perlfunc.

setlocale

ВНИМАНИЕ! До Perl 5.28 или на системах, не поддерживающих многопоточные операции с языком локализации, НЕ используйте эту функцию в потоке. Язык локализации изменится во всех потоках одновременно, и если ваш поток будет приостановлен операционной системой, а другой запущен, этот поток не получит ожидаемый язык локализации. На некоторых платформах может возникнуть проблема гонки, приводящая к сбоям, если две нити почти одновременно вызовут эту функцию. Это предупреждение не относится к не многопоточным сборкам или к версиям Perl, где ${^SAFE_LOCALES} существует и отлично от нуля; а именно Perl 5.28 и более поздние версии, скомпилированные с многопоточной безопасностью локализации.

Эта функция изменяет и запрашивает базовый язык локализации программы. Пользователи этой функции должны прочитать perllocale, в котором подробно обсуждается обработка локализации в Perl, знание которой необходимо для правильного использования этой функции. Он содержит раздел, посвящённый этой функции. Здесь приведён лишь краткий справочник по setlocale(). Обратите внимание, что сам Perl практически не зависит от локализации, кроме как в рамках "use locale". (Исключения перечислены в "Не в рамках области действия "use locale"" в perllocale, и функции, зависящие от локализации, в модуле POSIX, ВСЕГДА зависят от текущей локализации.)

Следующие примеры предполагают

use POSIX qw(setlocale LC_ALL LC_CTYPE);

была выполнена.

Следующее действие задаст традиционное поведение локали UNIX-систем (второй аргумент "C").

$loc = setlocale( LC_ALL, "C" );

Следующее действие запросит текущую LC_CTYPE категорию. (Отсутствие второго аргумента означает 'запрос'.)

$loc = setlocale( LC_CTYPE );

Следующее действие задаст поведение LC_CTYPE в соответствии с переменными окружения локали (второй аргумент ""). Обратитесь к документации вашей системы setlocale(3) для значения переменных окружения локали или обратитесь к perllocale.

$loc = setlocale( LC_CTYPE, "" );

Следующее действие задаст поведение LC_COLLATE для аргентинского испанского языка. ПРИМЕЧАНИЕ: Название и доступность языковых локалей зависят от вашей операционной системы. Обратитесь к perllocale для получения информации о доступных локалях в вашей системе.

$loc = setlocale( LC_COLLATE, "es_AR.ISO8859-1" );
setpayload
use POSIX ':nan_payload';
setpayload($var, $payload);

Устанавливает NaN payload переменной var. Добавлено в Perl v5.24.

ПРИМЕЧАНИЕ: API для payload NaN основаны на последних (по состоянию на июнь 2015 года) предложенных интерфейсах ISO C, но они ещё не являются стандартом. Возможно, что-то изменится.

См. "nan" для более подробного обсуждения NaN.

См. также "setpayloadsig", "isnan", "getpayload" и "issignaling".

setpayloadsig
use POSIX ':nan_payload';
setpayloadsig($var, $payload);

Как "setpayload", но также делает NaN сигнализирующим. Добавлено в Perl v5.24.

В зависимости от платформы NaN может вести себя по-разному.

Обратите внимание на предупреждение о нестабильности API в "setpayload".

Обратите внимание, что из-за того, как работают форматы чисел с плавающей точкой, на наиболее распространённых платформах следует избегать сигнализирующего payload нулевой величины, поскольку он может оказаться идентичным +Inf.

См. также "nan", "isnan", "getpayload" и "issignaling".

setpgid

Это аналогично C-функции setpgid() для установки идентификатора группы процессов текущего процесса.

Возвращает undef при ошибке.

setsid

Это идентично C-функции setsid() для установки идентификатора сеанса текущего процесса.

setuid

Устанавливает реальный идентификатор пользователя и эффективный идентификатор пользователя для данного процесса. Аналогично присваиванию значения встроенной переменной Perl $<, см. "$UID" в perlvar, за исключением того, что последний изменит только реальный идентификатор пользователя.

sigaction

Детальное управление сигналами. Использует объекты POSIX::SigAction для аргументов action и oldaction (oldaction также может быть просто ссылкой на хэш). Для подробностей обратитесь к странице man вашей системы sigaction, см. также POSIX::SigRt.

Синтаксис:

sigaction(signal, action, oldaction = 0)

Возвращает undef при ошибке. signal должно быть числом (например, SIGHUP), а не строкой (например, "SIGHUP"), хотя Perl старается понять вас.

Если вы используете флаг SA_SIGINFO, обработчик сигналов, помимо первого аргумента (имя сигнала), также получит второй аргумент — ссылку на хэш, в котором находятся следующие ключи со следующими семантиками, как определено POSIX/SUSv3:

signo       the signal number
errno       the error number
code        if this is zero or less, the signal was sent by
            a user process and the uid and pid make sense,
            otherwise the signal was sent by the kernel

Константы для конкретных значений code можно импортировать индивидуально или с помощью тега :signal_h_si_code, начиная с Perl v5.24.

Ниже также определены POSIX/SUSv3, но, к сожалению, не очень широко реализованы:

pid         the process id generating the signal
uid         the uid of the process id generating the signal
status      exit value or signal for SIGCHLD
band        band event for SIGPOLL
addr        address of faulting instruction or memory
            reference for SIGILL, SIGFPE, SIGSEGV or SIGBUS

Третий аргумент также передается обработчику, который содержит копию исходных двоичных данных структуры siginfo: если система имеет некоторые не-POSIX поля, этот третий аргумент используется для unpack() их.

Обратите внимание, что не все значения siginfo имеют смысл одновременно (некоторые допустимы только для определённых сигналов, например), и не все значения имеют смысл с точки зрения Perl. Вам следует обратиться к документации вашей системы sigaction и, возможно, также к документации siginfo.

siglongjmp

Не реализовано. siglongjmp() — специфично для C: используйте "die" в perlfunc вместо этого.

signbit

Возвращает ноль для положительных аргументов и ненулевое значение для отрицательных аргументов [C99]. Добавлено в Perl v5.22.

sigpending

Просмотр заблокированных и ожидающих сигналов. Использует объекты POSIX::SigSet для аргумента sigset. Обратитесь к странице man вашей системы sigpending для подробностей.

Синтаксис:

sigpending(sigset)

Возвращает undef при ошибке.

sigprocmask

Изменение и/или проверка маски сигналов вызывающего процесса. Использует объекты POSIX::SigSet для аргументов sigset и oldsigset. Обратитесь к странице man вашей системы sigprocmask для подробностей.

Синтаксис:

sigprocmask(how, sigset, oldsigset = 0)

Возвращает undef при ошибке.

Обратите внимание, что вы не можете надёжно блокировать или разблокировать сигнал из своего собственного обработчика сигналов, если используете безопасные сигналы. Другие сигналы могут быть надёжно заблокированы или разблокированы.

sigsetjmp

Не реализовано. sigsetjmp() — специфично для C: используйте eval {} вместо этого, см. "eval" в perlfunc.

sigsuspend

Установка маски сигналов и приостановка процесса до получения сигнала. Использует объекты POSIX::SigSet для аргумента signal_mask. Обратитесь к странице man вашей системы sigsuspend для подробностей.

Синтаксис:

sigsuspend(signal_mask)

Возвращает undef при ошибке.

sin

Это идентично встроенной функции Perl sin() для возвращения синуса числового аргумента, см. "sin" в perlfunc. См. также Math::Trig.

sinh

Это идентично C-функции sinh() для возвращения гиперболического синуса числового аргумента. См. также Math::Trig.

sleep

Функционально идентично встроенной функции Perl sleep() для приостановки выполнения текущего процесса на определённое количество секунд, см. "sleep" в perlfunc. Однако есть одно важное различие: POSIX::sleep() возвращает количество непроспанных секунд, в то время как CORE::sleep() возвращает количество проспанных секунд.

sprintf

Аналогично встроенной функции Perl sprintf() для возвращения строки с отформатированными аргументами, см. "sprintf" в perlfunc.

sqrt

Идентично встроенной функции Perl sqrt() для возвращения квадратного корня числового аргумента, см. "sqrt" в perlfunc.

srand

Задаёт начальное значение для генератора псевдослучайных чисел, см. "srand" в perlfunc.

sscanf

Не реализовано. sscanf() — специфично для C, используйте вместо этого регулярные выражения, см. perlre.

stat

Идентично встроенной функции Perl stat() для получения информации о файлах и каталогах.

strcat

Не реализовано. strcat() — специфично для C, используйте .= вместо этого, см. perlop.

strchr

Не реализовано. strchr() — специфично для C, см. "index" в perlfunc вместо этого.

strcmp

Не реализовано. strcmp() — специфично для C, используйте eq или cmp вместо этого, см. perlop.

strcoll

Идентично C-функции strcoll() для сортировки (сравнения) строк, преобразованных с использованием функции strxfrm(). Не обязательно, так как Perl может делать это прозрачно, см. perllocale.

Обратите внимание, что в UTF-8 локали всё, что вы передаёте в эту функцию, должно быть в UTF-8; а когда не в UTF-8 локали, всё, что передаётся, не должно быть закодировано в UTF-8.

Также обратите внимание, что нет смысла кодировать строку в одной локали (скажем, ISO-8859-6, арабский) и сортировать её по другой (например, ISO-8859-7, греческий). Результаты будут в значительной степени бессмысленными.

strcpy

Не реализовано. strcpy() — специфично для C, используйте = вместо него, см. perlop.

strcspn

Не реализовано. strcspn() — специфично для C, используйте регулярные выражения вместо него, см. perlre.

strerror

Возвращает строку ошибки для указанного errno. Идентично строковой форме $!, см. "$ERRNO" в perlvar.

strftime

Преобразует информацию о дате и времени в строку. Возвращает строку.

Синтаксис:

strftime(fmt, sec, min, hour, mday, mon, year,
         wday = -1, yday = -1, isdst = -1)

Месяц (mon), день недели (wday) и день года (yday) начинаются с нуля, т.е., январь — 0, а не 1; воскресенье — 0, а не 1; 1 января — 0, а не 1. Год (year) задаётся в годах с 1900 года, т.е., 1995 год — 95; 2001 год — 101. Обратитесь к странице справки вашей системы strftime() для получения подробной информации об этих и других аргументах.

Если вы хотите, чтобы ваш код был переносимым, ваш аргумент формата (fmt) должен использовать только спецификаторы преобразования, определённые стандартом ANSI C (C89, для большей безопасности). Это aAbBcdHIjmMpSUwWxXyYZ%. Но даже в этом случае результаты некоторых спецификаторов преобразования не переносимы. Например, спецификаторы aAbBcpZ меняются в зависимости от настроек локали пользователя, и как настроить локали (имена локалей), так и ожидаемый результат не являются стандартными. Спецификатор c изменяется в зависимости от настроек часового пояса пользователя и правил расчёта часовых поясов операционной системы. Спецификатор Z печально известен своей непереносимостью, так как имена часовых поясов не стандартны. Придерживаться числовых спецификаторов — самый безопасный путь.

Приведённые аргументы делаются согласованными как будто вы вызываете mktime() перед вызовом функции strftime() вашей системы, за исключением того, что значение isdst не затрагивается.

Строка для вторника, 12 декабря 1995 года.

$str = POSIX::strftime( "%A, %B %d, %Y",
                         0, 0, 0, 12, 11, 95, 2 );
print "$str\n";
strlen

Не реализовано. strlen() — специфично для C, используйте length() вместо него, см. "length" в perlfunc.

strncat

Не реализовано. strncat() — специфично для C, используйте .= вместо него, см. perlop.

strncmp

Не реализовано. strncmp() — специфично для C, используйте eq вместо него, см. perlop.

strncpy

Не реализовано. strncpy() — специфично для C, используйте = вместо него, см. perlop.

strpbrk

Не реализовано. strpbrk() — специфично для C, используйте регулярные выражения вместо него, см. perlre.

strrchr

Не реализовано. strrchr() — специфично для C, см. "rindex" в perlfunc вместо него.

strspn

Не реализовано. strspn() — специфично для C, используйте регулярные выражения вместо него, см. perlre.

strstr

Это идентично встроенной в Perl функции index(), см. "index" в perlfunc.

strtod

Преобразование строки в двойное число. Возвращает разобранное число и количество символов в необработанной части строки. Настоящие системы, совместимые с POSIX, устанавливают $! ($ERRNO) для указания ошибки преобразования, поэтому очистите $! перед вызовом strtod. Однако системы, не совместимые с POSIX, могут не проверять переполнение, и поэтому никогда не устанавливают $!.

strtod учитывает любые настройки POSIX setlocale() LC_NUMERIC независимо от того, вызывается ли он из кода Perl, находящегося в рамках use locale. До Perl 5.28 или при работе в не потокобезопасной среде его не следует использовать в многопоточных приложениях, если не известно наверняка, что базовой локалью является C или POSIX. Это происходит потому, что в противном случае он изменяет локаль, которая глобально влияет на все потоки одновременно.

Для разбора строки $str в виде числа с плавающей запятой используйте

$! = 0;
($num, $n_unparsed) = POSIX::strtod($str);

Возвращаемое второе значение и $! могут использоваться для проверки корректности ввода:

if (($str eq '') || ($n_unparsed != 0) || $!) {
    die "Non-numeric input $str" . ($! ? ": $!\n" : "\n");
}

При вызове в скалярном контексте strtod возвращает разобранное число.

strtok

Не реализовано. strtok() — специфично для C, используйте регулярные выражения вместо него, см. perlre или "split" в perlfunc.

strtol

Преобразование строки в (длинное) целое число. Возвращает разобранное число и количество символов в необработанной части строки. Настоящие системы, совместимые с POSIX, устанавливают $! ($ERRNO) для указания ошибки преобразования, поэтому очистите $! перед вызовом strtol. Однако системы, не совместимые с POSIX, могут не проверять переполнение, и поэтому никогда не устанавливают $!.

strtol должен учитывать любые настройки POSIX setlocale().

Для разбора строки $str как числа в определённой системе счисления $base используйте

$! = 0;
($num, $n_unparsed) = POSIX::strtol($str, $base);

Система счисления должна быть равна нулю или находиться в диапазоне от 2 до 36 включительно. Если система счисления равна нулю или опущена, strtol будет использовать саму строку для определения системы счисления: "0x" или "0X" означает шестнадцатеричную систему; "0" означает восьмеричную систему; все другие ведущие символы означают десятичную систему. Таким образом, "1234" разбирается как десятичное число, "01234" как восьмеричное число и "0x1234" как шестнадцатеричное число.

Возвращаемое второе значение и $! могут использоваться для проверки корректности ввода:

if (($str eq '') || ($n_unparsed != 0) || !$!) {
    die "Non-numeric input $str" . $! ? ": $!\n" : "\n";
}

При вызове в скалярном контексте strtol возвращает разобранное число.

strtold

Как "strtod", но для длинных двойных чисел. Определено только если система поддерживает длинные двойные числа.

strtoul

Преобразование строки в целое беззнаковое (длинное) число. strtoul() идентично strtol() за исключением того, что strtoul() парсит только беззнаковые целые числа. См. "strtol" для подробностей.

Примечание: Некоторые поставщики предоставляют strtod() и strtol(), но не strtoul(). Другие поставщики, которые предоставляют strtoul(), парсят "-1" как допустимое значение.

strxfrm

Преобразование строки. Возвращает преобразованную строку.

$dst = POSIX::strxfrm( $src );

Используется с eq или cmp как альтернатива "strcoll".

В действительности не требуется, так как Perl может сделать это прозрачно, см. perllocale.

Обратите внимание, что в локали UTF-8 всё, что вы передаёте этой функции, должно быть в UTF-8; а когда локали не UTF-8, передаваемая информация не должна быть закодирована в UTF-8.

sysconf

Извлекает значения системных конфигурационных переменных.

Следующее получит тактовую частоту процессора машины.

$clock_ticks = POSIX::sysconf( &POSIX::_SC_CLK_TCK );

Возвращает undef при ошибке.

system

Это идентично встроенной в Perl функции system(), см. "system" в perlfunc.

tan

Это идентично функции C tan(), возвращающей тангенс числового аргумента. См. также Math::Trig.

tanh

Это идентично функции C tanh(), возвращающей гиперболический тангенс числового аргумента. См. также Math::Trig.

tcdrain

Это аналогично функции C tcdrain() для слива очереди вывода её потока.

Возвращает undef при ошибке.

tcflow

Это аналогично функции C tcflow() для управления потоком её потока.

Возвращает undef при ошибке.

tcflush

Это аналогично функции C tcflush() для сброса буферов ввода/вывода её потока.

Возвращает undef при ошибке.

tcgetpgrp

Это идентично функции C tcgetpgrp() для возвращения идентификатора группы процессов фоновой группы процесса управляющего терминала.

tcsendbreak

Это аналогично функции C tcsendbreak() для отправки прерывания на её поток.

Возвращает undef при ошибке.

tcsetpgrp

Это аналогично функции C tcsetpgrp() для установки идентификатора группы процессов фоновой группы процесса управляющего терминала.

Возвращает undef при ошибке.

tgamma

Функция Гамма [C99]. Добавлена в Perl v5.22.

См. также "lgamma".

time

Это идентично встроенной в Perl функции time() для возвращения количества секунд с эпохи (какая она есть для системы), см. "time" в perlfunc.

times

Функция times() возвращает прошедшее реальное время с момента в прошлом (такого как запуск системы), время пользователя и системы для данного процесса, а также время пользователя и системы, используемое дочерними процессами. Все времена возвращаются в тактах процессора.

($realtime, $user, $system, $cuser, $csystem)
    = POSIX::times();

Примечание: Встроенная в Perl функция times() возвращает четыре значения, измеренные в секундах.

tmpfile

Не реализовано. Используйте метод IO::File::new_tmpfile() вместо него или см. File::Temp.

tmpnam

По соображениям безопасности, которые, вероятно, подробно описаны в документации вашей системы для функции C-библиотеки tmpnam(), этот интерфейс больше недоступен с Perl v5.26; вместо этого используйте File::Temp.

tolower

Эта функция удалена начиная с Perl v5.26. Она идентична C-функции, за исключением того, что может применяться к одному символу или к целой строке, и в настоящее время работает так, как если бы локаль всегда была «C». Рассмотрите использование функции lc(), см. "lc" в perlfunc, см. "lc" в perlfunc, или эквивалентный оператор \L внутри строк в двойных кавычках.

toupper

Эта функция удалена начиная с Perl v5.26. Она похожа на C-функцию, за исключением того, что может применяться к одному символу или к целой строке, и в настоящее время работает так, как если бы локаль всегда была «C». Рассмотрите использование функции uc(), см. "uc" в perlfunc, или эквивалентный оператор \U внутри строк в двойных кавычках.

trunc

Возвращает целое число, приближённое к нулю от аргумента [C99]. Добавлена в Perl v5.22.

См. также "ceil", "floor" и "round".

ttyname

Идентична C-функции ttyname() для возвращения имени текущего терминала.

tzname

Извлекает информацию о преобразовании времени из переменной tzname. 

POSIX::tzset();
($std, $dst) = POSIX::tzname();
tzset

Идентична C-функции tzset() для установки текущей временной зоны на основе переменной среды TZ, которая используется функциями ctime(), localtime(), mktime() и strftime().

umask

Идентична встроенной Perl-функции umask() для установки (и запроса) маски разрешений создания файлов, см. "umask" в perlfunc.

uname

Получить имя текущей операционной системы.

($sysname, $nodename, $release, $version, $machine)
        = POSIX::uname();

Обратите внимание, что фактическое значение различных полей не очень стандартизировано, не ожидайте высокой портативности. $sysname может быть именем операционной системы, $nodename может быть именем хоста, $release может быть номером (главной) версии операционной системы, $version может быть номером (дополнительной) версии операционной системы, а $machine может быть идентификатором аппаратного обеспечения. Возможно.

ungetc

Не реализовано. Используйте метод IO::Handle::ungetc() вместо этого.

unlink

Идентична встроенной Perl-функции unlink() для удаления файлов, см. "unlink" в perlfunc.

utime

Идентична встроенной Perl-функции utime() для изменения временных меток файлов и каталогов, см. "utime" в perlfunc.

vfprintf

Не реализовано. vfprintf() специфично для C, используйте "printf" в perlfunc вместо этого.

vprintf

Не реализовано. vprintf() специфично для C, используйте "printf" в perlfunc вместо этого.

vsprintf

Не реализовано. vsprintf() специфично для C, используйте "sprintf" в perlfunc вместо этого.

wait

Идентична встроенной Perl-функции wait(), см. "wait" в perlfunc.

waitpid

Ожидание завершения процесса-потомка. Идентична встроенной Perl-функции waitpid(), см. "waitpid" в perlfunc.

$pid = POSIX::waitpid( -1, POSIX::WNOHANG );
print "status = ", ($? / 256), "\n";

См. "mblen".

wctomb

То же самое, что и C-функция wctomb() в однопоточных Perl. В многопоточных Perl она прозрачно (почти) заменяет более безопасную для многопоточности функцию wcrtomb(3), если доступна, вместо wctomb.

Основной Perl не поддерживает локальные настройки широких и многобайтовых символов, кроме локалей Unicode UTF-8. Эта функция в сочетании с "mblen" и "mbtowc" может использоваться для разработки собственной декодирования/кодирования других типов многобайтовых локалей.

Используйте undef в качестве первого параметра этой функции, чтобы получить эффект передачи NULL в качестве первого параметра функции wctomb. Это сбросит любое состояние сдвига до его начального значения. Возвращаемое значение неопределено, если была заменена функция wcrtomb, поэтому на него никогда не следует полагаться.

Когда первый параметр является скаляром, код символа, содержащийся во втором параметре-скаляре, преобразуется в многобайтовую строку и сохраняется в первом параметре-скаляре. Это основано на локали, которая в настоящее время используется программой, независимо от того, вызывается ли функция из кода Perl, который находится в области действия use locale. Возвращаемое значение — количество сохранённых байтов; или отрицательное значение, если код символа не может быть представлен в текущей локали. Perl не пытается скрыть от вашего кода какие-либо различия в настройке errno между wctomb и wcrtomb. Он устанавливает errno в 0 перед их вызовом.

write

Запись в файл. Использует дескрипторы файлов, такие как полученные при вызове POSIX::open. 

$fd = POSIX::open( "foo", &POSIX::O_WRONLY );
$buf = "hello";
$bytes = POSIX::write( $fd, $buf, 5 );

Возвращает undef при ошибке.

См. также "syswrite" в perlfunc.

КЛАССЫ

POSIX::SigAction

new

Создаёт новый объект POSIX::SigAction, который соответствует C-функции struct sigaction. Этот объект будет уничтожен автоматически, когда он больше не нужен. Первый параметр — обработчик, ссылка на подпрограмму. Второй параметр — объект POSIX::SigSet, по умолчанию — пустое множество. Третий параметр содержит sa_flags, по умолчанию — 0.

$sigset = POSIX::SigSet->new(SIGINT, SIGQUIT);
$sigaction = POSIX::SigAction->new(
                \&handler, $sigset, &POSIX::SA_NOCLDSTOP
             );

Этот объект POSIX::SigAction предназначен для использования с функцией POSIX::sigaction().

handler
mask
flags

Функции доступа для получения/установки значений объекта SigAction.

$sigset = $sigaction->mask;
$sigaction->flags(&POSIX::SA_RESTART);
safe

Функция доступа к флагу «безопасных сигналов» объекта SigAction; см. perlipc для общей информации о безопасных (также называемых «отложенными») сигналах. Если вы хотите обработать сигнал безопасно, используйте этот аксессор для установки флага «безопасный» в объекте POSIX::SigAction:

$sigaction->safe(1);

Вы также можете проверить флаг «безопасный» в выходном объекте действия, который заполняется, когда он передаётся в качестве третьего параметра функции POSIX::sigaction():

sigaction(SIGINT, $new_action, $old_action);
if ($old_action->safe) {
    # previous SIGINT handler used safe signals
}

POSIX::SigRt

%SIGRT

Хэш обработчиков сигналов реального времени POSIX. Это расширение стандартного %SIG, $POSIX::SIGRT{SIGRTMIN} примерно эквивалентно $SIG{SIGRTMIN}, но правильные действия POSIX (см. ниже) выполняются с помощью POSIX::SigSet и POSIX::sigaction вместо доступа к %SIG.

Вы можете установить элементы %POSIX::SIGRT для установки обработчиков сигналов реального времени POSIX, использовать delete и exists для элементов и использовать scalar для %POSIX::SIGRT для определения количества доступных сигналов реального времени POSIX (SIGRTMAX - SIGRTMIN + 1, SIGRTMAX — это действительный сигнал реального времени POSIX.

Установка элементов %SIGRT эквивалентна вызову этого:

sub new {
  my ($rtsig, $handler, $flags) = @_;
  my $sigset = POSIX::SigSet($rtsig);
  my $sigact = POSIX::SigAction->new($handler,$sigset,$flags);
  sigaction($rtsig, $sigact);
}

Флаги по умолчанию равны нулю. Если вам нужно что-то другое, вы можете либо использовать local на $POSIX::SigRt::SIGACTION_FLAGS, либо вы можете унаследовать от POSIX::SigRt и определить свой собственный new() (метод STORE связанного хэша %SIGRT вызывает new($rtsig, $handler, $SIGACTION_FLAGS), где $rtsig находится в диапазоне от нуля до SIGRTMAX - SIGRTMIN + 1)).

Точно так же, как и с любым сигналом, вы можете использовать sigaction($rtsig, undef, $oa) для получения установленного обработчика сигнала (или, скорее, действия сигнала).

ПРИМЕЧАНИЕ: работает ли POSIX сигналы реального времени в вашей системе или Perl был скомпилирован для работы с ними, выходит за рамки этой темы.

SIGRTMIN

Возвращает минимальное значение номера сигнала реального времени POSIX, доступное, или undef, если сигналы реального времени POSIX недоступны.

SIGRTMAX

Возвращает максимальное значение номера сигнала реального времени POSIX, доступное, или undef, если сигналы реального времени POSIX недоступны.

POSIX::SigSet

new

Создаёт новый объект SigSet. Этот объект будет уничтожен автоматически, когда он больше не нужен. Аргументы могут быть переданы для инициализации множества.

Создаёт пустое множество.

$sigset = POSIX::SigSet->new;

Создаёт множество с SIGUSR1.

$sigset = POSIX::SigSet->new( &POSIX::SIGUSR1 );

Выбрасывает ошибку, если любой из предоставленных сигналов не может быть добавлен в множество.

addset

Добавляет сигнал в объект SigSet.

$sigset->addset( &POSIX::SIGUSR2 );

Возвращает undef при ошибке.

delset

Удаляет сигнал из объекта SigSet.

$sigset->delset( &POSIX::SIGUSR2 );

Возвращает undef при ошибке.

emptyset

Инициализирует объект SigSet как пустой.

$sigset->emptyset();

Возвращает undef при ошибке.

fillset

Инициализирует объект SigSet, включив все сигналы.

$sigset->fillset();

Возвращает undef при ошибке.

ismember

Проверяет объект SigSet на наличие указанного сигнала.

if( $sigset->ismember( &POSIX::SIGUSR1 ) ){
        print "contains SIGUSR1\n";
}

POSIX::Termios

new

Создайте новый объект Termios. Этот объект будет автоматически уничтожен, когда он больше не нужен. Объект Termios соответствует структуре C termios. new() выделяет новую, getattr() заполняет её данными из дескриптора файла, и setattr() устанавливает параметры дескриптора файла, чтобы они соответствовали содержимому Termios.

$termios = POSIX::Termios->new;
getattr

Получить атрибуты управления терминалом.

Получить атрибуты для stdin.

$termios->getattr( 0 ) # Recommended for clarity.
$termios->getattr()

Получить атрибуты для stdout.

$termios->getattr( 1 )

Возвращает undef при ошибке.

getcc

Получить значение из поля c_cc объекта termios. Поле c_cc представляет собой массив, поэтому необходимо указать индекс.

$c_cc[1] = $termios->getcc(1);
getcflag

Получить поле c_cflag объекта termios.

$c_cflag = $termios->getcflag;
getiflag

Получить поле c_iflag объекта termios.

$c_iflag = $termios->getiflag;
getispeed

Получить скорость передачи данных на вход.

$ispeed = $termios->getispeed;
getlflag

Получить поле c_lflag объекта termios.

$c_lflag = $termios->getlflag;
getoflag

Получить поле c_oflag объекта termios.

$c_oflag = $termios->getoflag;
getospeed

Получить скорость передачи данных на выход.

$ospeed = $termios->getospeed;
setattr

Установить атрибуты управления терминалом.

Немедленно установить атрибуты для stdout.

$termios->setattr( 1, &POSIX::TCSANOW );

Возвращает undef при ошибке.

setcc

Установить значение в поле c_cc объекта termios . Поле c_cc представляет собой массив, поэтому необходимо указать индекс.

$termios->setcc( &POSIX::VEOF, 1 );
setcflag

Установить поле c_cflag объекта termios.

$termios->setcflag( $c_cflag | &POSIX::CLOCAL );
setiflag

Установить поле c_iflag объекта termios.

$termios->setiflag( $c_iflag | &POSIX::BRKINT );
setispeed

Установить скорость передачи данных на вход.

$termios->setispeed( &POSIX::B9600 );

Возвращает undef при ошибке.

setlflag

Установить поле c_lflag объекта termios.

$termios->setlflag( $c_lflag | &POSIX::ECHO );
setoflag

Установить поле c_oflag объекта termios.

$termios->setoflag( $c_oflag | &POSIX::OPOST );
setospeed

Установить скорость передачи данных на выход.

$termios->setospeed( &POSIX::B9600 );

Возвращает undef при ошибке.

Значения скорости передачи данных

B38400 B75 B200 B134 B300 B1800 B150 B0 B19200 B1200 B9600 B600 B4800 B50 B2400 B110

Значения параметров интерфейса терминала

TCSADRAIN TCSANOW TCOON TCIOFLUSH TCOFLUSH TCION TCIFLUSH TCSAFLUSH TCIOFF TCOOFF

Значения поля c_cc

VEOF VEOL VERASE VINTR VKILL VQUIT VSUSP VSTART VSTOP VMIN VTIME NCCS

Значения поля c_cflag

CLOCAL CREAD CSIZE CS5 CS6 CS7 CS8 CSTOPB HUPCL PARENB PARODD

Значения поля c_iflag

BRKINT ICRNL IGNBRK IGNCR IGNPAR INLCR INPCK ISTRIP IXOFF IXON PARMRK

Значения поля c_lflag

ECHO ECHOE ECHOK ECHONL ICANON IEXTEN ISIG NOFLSH TOSTOP

Значения поля c_oflag

OPOST

ПОСТОЯННЫЕ ЗНАЧЕНИЯ ИМЁН ПУТЕЙ

Постоянные

_PC_CHOWN_RESTRICTED _PC_LINK_MAX _PC_MAX_CANON _PC_MAX_INPUT _PC_NAME_MAX _PC_NO_TRUNC _PC_PATH_MAX _PC_PIPE_BUF _PC_VDISABLE

ПОСТОЯННЫЕ ЗНАЧЕНИЯ POSIX

Постоянные

_POSIX_ARG_MAX _POSIX_CHILD_MAX _POSIX_CHOWN_RESTRICTED _POSIX_JOB_CONTROL _POSIX_LINK_MAX _POSIX_MAX_CANON _POSIX_MAX_INPUT _POSIX_NAME_MAX _POSIX_NGROUPS_MAX _POSIX_NO_TRUNC _POSIX_OPEN_MAX _POSIX_PATH_MAX _POSIX_PIPE_BUF _POSIX_SAVED_IDS _POSIX_SSIZE_MAX _POSIX_STREAM_MAX _POSIX_TZNAME_MAX _POSIX_VDISABLE _POSIX_VERSION

ПОСТОЯННЫЕ ЗНАЧЕНИЯ РЕСУРСОВ

Импортировано с помощью тега :sys_resource_h.

Постоянные

Добавлен в Perl v5.28:

PRIO_PROCESS PRIO_PGRP PRIO_USER

НАСТРОЙКА СИСТЕМЫ

Постоянные

_SC_ARG_MAX _SC_CHILD_MAX _SC_CLK_TCK _SC_JOB_CONTROL _SC_NGROUPS_MAX _SC_OPEN_MAX _SC_PAGESIZE _SC_SAVED_IDS _SC_STREAM_MAX _SC_TZNAME_MAX _SC_VERSION

ERRNO

Постоянные

E2BIG EACCES EADDRINUSE EADDRNOTAVAIL EAFNOSUPPORT EAGAIN EALREADY EBADF EBADMSG EBUSY ECANCELED ECHILD ECONNABORTED ECONNREFUSED ECONNRESET EDEADLK EDESTADDRREQ EDOM EDQUOT EEXIST EFAULT EFBIG EHOSTDOWN EHOSTUNREACH EIDRM EILSEQ EINPROGRESS EINTR EINVAL EIO EISCONN EISDIR ELOOP EMFILE EMLINK EMSGSIZE ENAMETOOLONG ENETDOWN ENETRESET ENETUNREACH ENFILE ENOBUFS ENODATA ENODEV ENOENT ENOEXEC ENOLCK ENOLINK ENOMEM ENOMSG ENOPROTOOPT ENOSPC ENOSR ENOSTR ENOSYS ENOTBLK ENOTCONN ENOTDIR ENOTEMPTY ENOTRECOVERABLE ENOTSOCK ENOTSUP ENOTTY ENXIO EOPNOTSUPP EOTHER EOVERFLOW EOWNERDEAD EPERM EPFNOSUPPORT EPIPE EPROCLIM EPROTO EPROTONOSUPPORT EPROTOTYPE ERANGE EREMOTE ERESTART EROFS ESHUTDOWN ESOCKTNOSUPPORT ESPIPE ESRCH ESTALE ETIME ETIMEDOUT ETOOMANYREFS ETXTBSY EUSERS EWOULDBLOCK EXDEV

FCNTL

Постоянные

FD_CLOEXEC F_DUPFD F_GETFD F_GETFL F_GETLK F_OK F_RDLCK F_SETFD F_SETFL F_SETLK F_SETLKW F_UNLCK F_WRLCK O_ACCMODE O_APPEND O_CREAT O_EXCL O_NOCTTY O_NONBLOCK O_RDONLY O_RDWR O_TRUNC O_WRONLY

FLOAT

Постоянные

DBL_DIG DBL_EPSILON DBL_MANT_DIG DBL_MAX DBL_MAX_10_EXP DBL_MAX_EXP DBL_MIN DBL_MIN_10_EXP DBL_MIN_EXP FLT_DIG FLT_EPSILON FLT_MANT_DIG FLT_MAX FLT_MAX_10_EXP FLT_MAX_EXP FLT_MIN FLT_MIN_10_EXP FLT_MIN_EXP FLT_RADIX FLT_ROUNDS LDBL_DIG LDBL_EPSILON LDBL_MANT_DIG LDBL_MAX LDBL_MAX_10_EXP LDBL_MAX_EXP LDBL_MIN LDBL_MIN_10_EXP LDBL_MIN_EXP

Окружение с плавающей точкой

Постоянные

FE_DOWNWARD FE_TONEAREST FE_TOWARDZERO FE_UPWARD на системах, которые их поддерживают.

Пределы

Постоянные

ARG_MAX CHAR_BIT CHAR_MAX CHAR_MIN CHILD_MAX INT_MAX INT_MIN LINK_MAX LONG_MAX LONG_MIN MAX_CANON MAX_INPUT MB_LEN_MAX NAME_MAX NGROUPS_MAX OPEN_MAX PATH_MAX PIPE_BUF SCHAR_MAX SCHAR_MIN SHRT_MAX SHRT_MIN SSIZE_MAX STREAM_MAX TZNAME_MAX UCHAR_MAX UINT_MAX ULONG_MAX USHRT_MAX

Локализация

Постоянные

LC_ALL LC_COLLATE LC_CTYPE LC_MONETARY LC_NUMERIC LC_TIME LC_MESSAGES на системах, которые их поддерживают.

МАТЕМАТИКА

Постоянные

HUGE_VAL

Добавлены в Perl v5.22:

FP_ILOGB0 FP_ILOGBNAN FP_INFINITE FP_NAN FP_NORMAL FP_SUBNORMAL FP_ZERO INFINITY NAN Inf NaN M_1_PI M_2_PI M_2_SQRTPI M_E M_LN10 M_LN2 M_LOG10E M_LOG2E M_PI M_PI_2 M_PI_4 M_SQRT1_2 M_SQRT2 на системах с поддержкой C99.

СИГНАЛ

Постоянные

SA_NOCLDSTOP SA_NOCLDWAIT SA_NODEFER SA_ONSTACK SA_RESETHAND SA_RESTART SA_SIGINFO SIGABRT SIGALRM SIGCHLD SIGCONT SIGFPE SIGHUP SIGILL SIGINT SIGKILL SIGPIPE SIGQUIT SIGSEGV SIGSTOP SIGTERM SIGTSTP SIGTTIN SIGTTOU SIGUSR1 SIGUSR2 SIG_BLOCK SIG_DFL SIG_ERR SIG_IGN SIG_SETMASK SIG_UNBLOCK

Добавлены в Perl v5.24:

ILL_ILLOPC ILL_ILLOPN ILL_ILLADR ILL_ILLTRP ILL_PRVOPC ILL_PRVREG ILL_COPROC ILL_BADSTK FPE_INTDIV FPE_INTOVF FPE_FLTDIV FPE_FLTOVF FPE_FLTUND FPE_FLTRES FPE_FLTINV FPE_FLTSUB SEGV_MAPERR SEGV_ACCERR BUS_ADRALN BUS_ADRERR BUS_OBJERR TRAP_BRKPT TRAP_TRACE CLD_EXITED CLD_KILLED CLD_DUMPED CLD_TRAPPED CLD_STOPPED CLD_CONTINUED POLL_IN POLL_OUT POLL_MSG POLL_ERR POLL_PRI POLL_HUP SI_USER SI_QUEUE SI_TIMER SI_ASYNCIO SI_MESGQ

СТАТИСТИКА

Постоянные

S_IRGRP S_IROTH S_IRUSR S_IRWXG S_IRWXO S_IRWXU S_ISGID S_ISUID S_IWGRP S_IWOTH S_IWUSR S_IXGRP S_IXOTH S_IXUSR

Макросы

S_ISBLK S_ISCHR S_ISDIR S_ISFIFO S_ISREG

STDLIB

Постоянные

EXIT_FAILURE EXIT_SUCCESS MB_CUR_MAX RAND_MAX

STDIO

Постоянные

BUFSIZ EOF FILENAME_MAX L_ctermid L_cuserid TMP_MAX

ВРЕМЯ

Постоянные

CLK_TCK CLOCKS_PER_SEC

UNISTD

Постоянные

R_OK SEEK_CUR SEEK_END SEEK_SET STDIN_FILENO STDOUT_FILENO STDERR_FILENO W_OK X_OK

ОЖИДАНИЕ

Постоянные

WNOHANG WUNTRACED

WNOHANG

Не приостанавливать вызывающий процесс, пока процесс-потомок не изменит состояние, а вместо этого возвращаться немедленно.

WUNTRACED

Перехватывать остановленные процессы-потомки.

Макросы

WIFEXITED WEXITSTATUS WIFSIGNALED WTERMSIG WIFSTOPPED WSTOPSIG

WIFEXITED

WIFEXITED(${^CHILD_ERROR_NATIVE}) возвращает true, если процесс-потомок завершился нормально (exit() или завершился по окончании main()).

WEXITSTATUS

WEXITSTATUS(${^CHILD_ERROR_NATIVE}) возвращает нормальный код завершения процесса-потомка (имеет смысл только если WIFEXITED(${^CHILD_ERROR_NATIVE}) равно true).

WIFSIGNALED

WIFSIGNALED(${^CHILD_ERROR_NATIVE}) возвращает true, если процесс-потомок завершился из-за сигнала.

WTERMSIG

WTERMSIG(${^CHILD_ERROR_NATIVE}) возвращает сигнал, из-за которого завершился процесс-потомок (имеет смысл только если WIFSIGNALED(${^CHILD_ERROR_NATIVE}) равно true).

WIFSTOPPED

WIFSTOPPED(${^CHILD_ERROR_NATIVE}) возвращает true, если процесс-потомок в настоящее время приостановлен (может произойти только если вы указали флаг WUNTRACED для waitpid()).

WSTOPSIG

WSTOPSIG(${^CHILD_ERROR_NATIVE}) возвращает сигнал, из-за которого был приостановлен процесс-потомок (имеет смысл только если WIFSTOPPED(${^CHILD_ERROR_NATIVE}) равно true).

WINSOCK

(Только для Windows.)

Постоянные

Добавлены в Perl v5.24:

WSAEINTR WSAEBADF WSAEACCES WSAEFAULT WSAEINVAL WSAEMFILE WSAEWOULDBLOCK WSAEINPROGRESS WSAEALREADY WSAENOTSOCK WSAEDESTADDRREQ WSAEMSGSIZE WSAEPROTOTYPE WSAENOPROTOOPT WSAEPROTONOSUPPORT WSAESOCKTNOSUPPORT WSAEOPNOTSUPP WSAEPFNOSUPPORT WSAEAFNOSUPPORT WSAEADDRINUSE WSAEADDRNOTAVAIL WSAENETDOWN WSAENETUNREACH WSAENETRESET WSAECONNABORTED WSAECONNRESET WSAENOBUFS WSAEISCONN WSAENOTCONN WSAESHUTDOWN WSAETOOMANYREFS WSAETIMEDOUT WSAECONNREFUSED WSAELOOP WSAENAMETOOLONG WSAEHOSTDOWN WSAEHOSTUNREACH WSAENOTEMPTY WSAEPROCLIM WSAEUSERS WSAEDQUOT WSAESTALE WSAEREMOTE WSAEDISCON WSAENOMORE WSAECANCELLED WSAEINVALIDPROCTABLE WSAEINVALIDPROVIDER WSAEPROVIDERFAILEDINIT WSAEREFUSED

© 1993–2021 Larry Wall and others
Licensed under the GNU General Public License version 1 or later, or the Artistic License.
The Perl logo is a trademark of the Perl Foundation.
https://perldoc.perl.org/5.34.0/POSIX

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API