Perl Cd Bookshelf [Electronic resources]

نسخه متنی -صفحه : 875/ 225
نمايش فراداده

8.177. POSIX

Provides access to standard POSIX 1003.1 identifiers: functions, classes, and constants. Can be use d to import one or multiple symbols:

use POSIX; # Import all symbols use POSIX qw(setsid); # Import one symbol use POSIX qw(:errno_h :fcntl_h); # Import sets of symbols

Functions listed as C-specific are not implemented.

Function

Description

_exit

Identical to C function _exit(2)

abort

Identical to C function abort(3)

abs

Identical to Perl's abs function

access

Determines accessibility of a file; returns undef on failure

acos

Identical to C function acos(3)

alarm

Identical to Perl's alarm function

asctime

Identical to C function asctime(3)

asin

Identical to C function asin(3)

assert

Similar to C macro assert(3)

atan

Identical to C function atan(3)

atan2

Identical to Perl's atan2 function

atexit

C-specific; use END {}

atof

C-specific

atoi

C-specific

atol

C-specific

bsearch

Not supplied

calloc

C-specific

ceil

Identical to C function ceil(3)

chdir

Identical to Perl's chdir function

chmod

Identical to Perl's chmod function

chown

Identical to Perl's chown function

clearerr

Uses method FileHandle::clearerr

clock

Identical to C function clock(3)

close

Closes a file; returns undef on failure

closedir

Identical to Perl's closedir function

cos

Identical to Perl's cos function

cosh

Identical to C function cosh(3)

creat

Creates a new file

ctermid

Generates pathname for the controlling terminal

ctime

Identical to C function ctime(3)

cuserid

Gets user's login name

difftime

Identical to C function difftime(3)

div

C-specific

dup

Similar to C function dup(2); returns undef on failure

dup2

Similar to C function dup2(2); returns undef on failure

errno

Returns the value of errno

execl

C-specific; use Perl's exec

execle

C-specific; use Perl's exec

execlp

C-specific; use Perl's exec

execv

C-specific; use Perl's exec

execve

C-specific; use Perl's exec

execvp

C-specific; use Perl's exec

exit

Identical to Perl's exit function

exp

Identical to Perl's exp function

fabs

Identical to Perl's abs function

fclose

Uses method FileHandle::close

fcntl

Identical to Perl's fcntl function

fdopen

Uses method FileHandle::new_from_fd

feof

Uses method FileHandle::eof

ferror

Uses method FileHandle::error

fflush

Uses method FileHandle::flush

fgetc

Uses method FileHandle::getc

fgetpos

Uses method FileHandle::getpos

fgets

Uses method FileHandle::gets

fileno

Uses method FileHandle::fileno

floor

Identical to C function floor(3)

fmod

Identical to C function fmod(3)

fopen

Uses method FileHandle::open

fork

Identical to Perl's fork function

fpathconf

Returns value of a configurable limit on a file or directory, or undef on failure

fprintf

C-specific; use Perl's printf function

fputc

C-specific; use Perl's print function

fputs

C-specific; use Perl's print function

fread

C-specific; use Perl's read function

free

C-specific

freopen

C-specific; use Perl's open function

frexp

Returns mantissa and exponent of a floating-point number

fscanf

C-specific; use <> and regular expressions

fseek

Uses method FileHandle::seek

fsetpos

Uses method FileHandle::setpos

fstat

Gets file status

ftell

Uses method FileHandle::tell

fwrite

C-specific; use Perl's print function

getc

Identical to Perl's etc function

getchar

Returns one character from STDIN

getcwd

Returns name of current working directory

getegid

Returns effective group ID (gid)

getenv

Returns value of the specified environment variable

geteuid

Returns the effective user ID (uid)

getgid

Returns the user's real group ID (gid)

getgrgid

Identical to Perl's getgrgid function

getgrnam

Identical to Perl's getgrnam function

getgroups

Returns IDs of the user's supplementary groups

getlogin

Identical to Perl's getlogin function

getpgrp

Identical to Perl's getpgrp function

getpid

Returns ID of the process (pid)

getppid

Identical to Perl's getppid function

getpwnam

Identical to Perl's getpwnam function

getpwuid

Identical to Perl's getpwuid function

gets

Returns one line from STDIN

getuid

Returns user's ID (uid)

gmtime

Identical to Perl's gmtime function

isalnum

Identical to C function, but can apply to one character or a whole string

isalpha

Identical to C function, but can apply to one character or a whole string

isatty

Returns Boolean indicating whether the specified filehandle is connected to a TTY

iscntrl

Identical to C function, but can apply to one character or a whole string

isdigit

Identical to C function, but can apply to one character or a whole string

isgraph

Identical to C function, but can apply to one character or a whole string

islower

Identical to C function, but can apply to one character or a whole string

isprint

Identical to C function, but can apply to one character or a whole string

ispunct

Identical to C function, but can apply to one character or a whole string

isspace

Identical to C function, but can apply to one character or a whole string

isupper

Identical to C function, but can apply to one character or a whole string

isxdigit

Identical to C function, but can apply to one character or a whole string

kill

Identical to Perl's kill function

labs

C-specific; use Perl's abs function

ldexp

Identical to C function ldexp(3)

ldiv

C-specific; use division operator (/) and Perl's int function

link

Identical to Perl's link function

localeconv

Gets numeric formatting information; returns reference to a hash containing the current locale formatting values

localtime

Identical to Perl's localtime function

log

Identical to Perl's log function

log10

Identical to C function log10(3)

longjmp

C-specific; use Perl's die function

lseek

Moves the read/write file pointer; returns undef on failure

malloc

C-specific

mblen

Identical to C function mblen(3)

mbstowcs

Identical to C function mbstowcs(3)

mbtowc

Identical to C function mbtowc(3)

memchr

C-specific; use Perl's index

memcmp

C-specific; use eq

memcpy

C-specific; use =

memmove

C-specific; use =

memset

C-specific; use x

mkdir

Identical to Perl's mkdir function

mkfifo

Similar to C function mkfifo(2); returns undef on failure

mktime

Converts date/time information to a calendar time; returns undef on failure

modf

Returns integral and fractional parts of a floating-point number

nice

Similar to C function nice(3); returns undef on failure

offsetof

C-specific

open

Opens file for reading or writing; returns undef on failure

opendir

Opens directory for reading; returns undef on failure

pathconf

Retrieves value of a configurable limit on a file or directory; returns undef on failure

pause

Similar to C function pause(3); returns undef on failure

perror

Identical to C function perror(3)

pipe

Creates an interprocess channel

pow

Computes $x raised to the power $exponent

printf

Prints specified arguments to STDOUT

putc

C-specific; use Perl's print function

putchar

C-specific; use Perl's print function

puts

C-specific; use Perl's print function

qsort

C-specific; use Perl's sort function

raise

Sends specified signal to current process

rand

Nonportable; use Perl's rand function

read

Reads from a file; returns undef on failure

readdir

Identical to Perl's readdir function

realloc

C-specific

remove

Identical to Perl's unlink function

rename

Identical to Perl's rename function

rewind

Seeks to beginning of file

rewinddir

Identical to Perl's rewinddir function

rmdir

Identical to Perl's rmdir function

scanf

C-specific; use <> and regular expressions

setgid

Sets real group ID for this process

setjmp

C-specific; use eval {}

setlocale

Modifies and queries program's locale

setpgid

Similar to C function setpgid(2); returns undef on failure

setsid

Identical to C function setsid(8)

setuid

Sets real user ID for this process

sigaction

Detailed signal management; returns undef on failure

siglongjmp

C-specific; use Perl's die function

sigpending

Examines blocked, pending signals; returns undef on failure

sigprocmask

Changes and/or examines this process's signal mask; returns undef on failure

sigsetjmp

C-specific; use eval {}

sigsuspend

Installs signal mask and suspends process until signal arrives; returns undef on failure

sin

Identical to Perl's sin function

sinh

Identical to C function sinh(3)

sleep

Identical to Perl's sleep function

sprintf

Identical to Perl's sprintf function

sqrt

Identical to Perl's sqrt function

srand

Identical to Perl's srand function

sscanf

C-specific; use regular expressions

stat

Identical to Perl's stat function

strcat

C-specific; use .=

strchr

C-specific; use index

strcmp

C-specific; use eq

strcoll

Identical to C function strcoll(3)

strcpy

C-specific; use =

strcspn

C-specific; use regular expressions

strerror

Returns error string for the specified errno

strftime

Converts date and time to string and returns the string

strlen

C-specific; use length

strncat

C-specific; use .= and/or substr

strncmp

C-specific; use eq and/or substr

strncpy

C-specific; use = and/or substr

stroul

C-specific

strpbrk

C-specific

strrchr

C-specific; use rindex and/or substr

strspn

C-specific

strstr

Identical to Perl's index function

strtod

C-specific

strtok

C-specific

strtol

C-specific

strtoul

C-specific

strxfrm

String transformation; returns the transformed string

sysconf

Retrieves values of system configurable variables; returns undef on failure

system

Identical to Perl's system function

tan

Identical to C function tan(3)

tanh

Identical to C function tanh(3)

tcdrain

Similar to C function tcdrain(3); returns undef on failure

tcflow

Similar to C function tcflow(3); returns undef on failure

tcflush

Similar to C function tcflush(3); returns undef on failure

tcgetpgrp

Identical to C function tcgetpgrp(3)

tcsendbreak

Similar to C function tcsendbreak(3); returns undef on failure

tcsetpgrp

Similar to C function tcsetpgrp(3); returns undef on failure

time

Identical to Perl's time function

times

Returns, in clock ticks, elapsed realtime since a point in the past, user and system times for this process, and user and system times for child processes

tmpfile

Uses method FileHandle::new_tmpfile

tmpnam

Returns a name for a temporary file

tolower

Identical to Perl's lc function

toupper

Identical to Perl's uc function

ttyname

Identical to C function ttyname(3)

tzname

Retrieves time conversion information from the tzname variable

tzset

Identical to C function tzset(3)

umask

Identical to Perl's umask function

uname

Gets name of current operating system

ungetc

Uses method FileHandle::ungetc

unlink

Identical to Perl's unlink function

utime

Identical to Perl's utime function

vfprintf

C-specific

vprintf

C-specific

vsprintf

C-specific

wait

Identical to Perl's wait function

waitpid

Waits for child process to change state; identical to Perl's waitpid function

wcstombs

Identical to C function wcstombs(3)

wctomb

Identical to C function wctomb(3)

write

Writes to file; returns undef on failure

The following sections show the classes that are defined and their methods.

8.177.1. POSIX::SigAction

new

$sigaction = POSIX::SigAction->new(sigsub, sigset, flags)

Constructor. Creates a new POSIX::SigAction object. Takes the following arguments:

sigsub The fully qualified name of a signal-handler subroutine

sigset A POSIX::SigSet object

flags The sa_flags

8.177.2. POSIX::SigSet

new

$sigset = POSIX::SigSet->new[( )]

Constructor. Creates new SigSet object. Optional arguments are used to initialize the set.

addset

$sigset->addset(sig)

Adds signal sig to SigSet object; returns undef on failure.

delset

$sigset->delset(sig)

Removes signal sig from SigSet object; returns undef on failure.

emptyset

$sigset->emptyset( )

Initializes SigSet object to empty; returns undef on failure.

fillset

$sigset->fillset( )

Initializes SigSet object to include all signals; returns undef on failure.

ismember

$sigset->ismember(sig)

Tests SigSet object for a specific signal sig.

8.177.3. POSIX::Termios

new

$termios = POSIX::Termios->new

Constructor. Creates new Termios object.

getattr

$termios->getattr([fd])

Gets terminal control attributes for a given fd (default is 0 for STDIN); returns undef on failure.

getcc

$c_cc[ind] = $termios->getcc(ind)

Retrieves value from the c_cc field of a Termios object. Takes index ind since @c_cc is an array.

getcflag

$c_cflag = $termios->getcflag

Retrieves c_cflag field of a Termios object.

getiflag

$c_iflag = $termios->getiflag

Retrieves c_iflag field of a Termios object.

getispeed

$ispeed = $termios->getispeed

Retrieves input baud rate.

getlflag

getlflag $c_lflag = $termios->getlflag

Retrieves c_lflag field of a Termios object.

getoflag

$c_oflag = $termios->getoflag

Retrieves c_oflag field of a Termios object.

getospeed

$ospeed = $termios->getospeed

Retrieves output baud rate.

setattr

$termios->setattr(fd, option)

Sets terminal control attributes for a given fd; returns undef on failure. option tells when to set the attributes and is one of TCSADRAIN, TCSAFLUSH, or TCSANOW.

setcc

$termios->setcc(ind, value)

Sets value in the c_cc field, indexed by ind, of a Termios object.

setcflag

$termios->setcflag(flag)

Sets flag in the c_cflag field of a Termios object.

setiflag

$termios->setiflag(flag)

Sets flag in the c_iflag field of a Termios object.

setispeed

$termios->setispeed(value)

Sets input baud rate to value; returns undef on failure.

setlflag

$termios->setlflag(flag)

Sets flag in the c_lflag field of a Termios object.

setoflag

$termios->setoflag(flag)

Sets flag in the c_oflag field of a Termios object.

setospeed

$termios->setospeed(value)

Sets the output baud rate to value; returns undef on failure.

8.177.4. Constants

The following constants are associated with the Termios class:

Baud rate values B0 B75 B134 B200 B600 B1800 B4800 B19200 B50 B110 B150 B300 B1200 B2400 B9600 B38400 c_cc index values VEOF VERASE VKILL VSUSP VSTOP VTIME VEOL VINTR VQUIT VSTART VMIN NCCS c_cflag field values CLOCAL CSIZE CS6 CS8 HUPCL PARODD CREAD CS5 CS7 CSTOPS PARENB c_iflag field values BRKINT IGNBRK IGNPAR INPCK IXOFF PARMRK ICRNL IGNCR INLCR ISTRIP IXON c_lflag field values ECHO ECHONL ISIG ECHOE ICANON NOFLSH ECHOK IEXTEN TOSTOP c_oflag field values OPOST Terminal interface values TCSADRAIN TCIOFLUSH TCIFLUSH TCSANOW TCOFLUSH TCSAFLUSH TCOON TCION TCIOFF

The following are other constants defined in the POSIX module:

Pathname constants _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 constants _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 System configuration _SC_ARG_MAX _SC_CHILD_MAX _SC_CLK_TCK _SC_JOB_CONTROL _SC_NGROUPS_MAX _SC_OPEN_MAX _SC_SAVED_IDS _SC_STREAM_MAX _SC_TZNAME_MAX _SC_VERSION Error constants E2BIG EACCES EAGAIN EBADF EBUSY ECHILD EDEADLK EDOM EEXIST EFAUL EFBIG EINTR EINVAL EIO EISDIR EMFILE EMLINK ENAMETOOLONG ENFILE ENODE ENOENT ENOEXEC ENOLCK ENOMEM ENOSPC ENOSYS ENOTDIR ENOTEMPTY ENOTTY ENXIO EPERM EPIPE ERANGE EROFS ESPIPE ESRCH EXDEV File control constants 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 Floating-point constants 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 Limit constants 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 Locale constants LC_ALL LC_COLLATE LC_CTYPE LC_MONETARY LC_NUMERIC LC_TIME Math constants HUGE_VAL Signal constants SA_NOCLDSTOP 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 Stat constants 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 Stat macros S_ISBLK S_ISCHR S_ISDIR S_ISFIFO S_ISREG Stdlib constants EXIT_FAILURE EXIT_SUCCESS MB_CUR_MAX RAND_MAX Stdio constants BUFSIZ EOF FILENAME_MAX L_ctermid L_cuserid L_tmpname TMP_MAX Time constants CLK_TCK CLOCKS_PER_SEC Unistd constants R_OK SEEK_CUR SEEK_END SEEK_SET STDIN_FILENO STDOUT_FILENO STRERR_FILENO W_OK X_OK Wait constants WNOHANG WUNTRACED Wait macros WIFEXITED WEXITSTATUS WIFSIGNALED WTERMSIG WIFSTOPPED WSTOPSIG


8.176. Pod::Text8.178. re


Copyright © 2002 O'Reilly & Associates. All rights reserved.