Main Page | Modules | Namespace List | Alphabetical List | Data Structures | Directories | File List | Data Fields | Globals | Related Pages | Examples

Status Value Tests
[Error Codes]

Collaboration diagram for Status Value Tests:


Defines

#define APR_STATUS_IS_ENOSTAT(s)   ((s) == APR_ENOSTAT)
#define APR_STATUS_IS_ENOPOOL(s)   ((s) == APR_ENOPOOL)
#define APR_STATUS_IS_EBADDATE(s)   ((s) == APR_EBADDATE)
#define APR_STATUS_IS_EINVALSOCK(s)   ((s) == APR_EINVALSOCK)
#define APR_STATUS_IS_ENOPROC(s)   ((s) == APR_ENOPROC)
#define APR_STATUS_IS_ENOTIME(s)   ((s) == APR_ENOTIME)
#define APR_STATUS_IS_ENODIR(s)   ((s) == APR_ENODIR)
#define APR_STATUS_IS_ENOLOCK(s)   ((s) == APR_ENOLOCK)
#define APR_STATUS_IS_ENOPOLL(s)   ((s) == APR_ENOPOLL)
#define APR_STATUS_IS_ENOSOCKET(s)   ((s) == APR_ENOSOCKET)
#define APR_STATUS_IS_ENOTHREAD(s)   ((s) == APR_ENOTHREAD)
#define APR_STATUS_IS_ENOTHDKEY(s)   ((s) == APR_ENOTHDKEY)
#define APR_STATUS_IS_EGENERAL(s)   ((s) == APR_EGENERAL)
#define APR_STATUS_IS_ENOSHMAVAIL(s)   ((s) == APR_ENOSHMAVAIL)
#define APR_STATUS_IS_EBADIP(s)   ((s) == APR_EBADIP)
#define APR_STATUS_IS_EBADMASK(s)   ((s) == APR_EBADMASK)
#define APR_STATUS_IS_EDSOOPEN(s)   ((s) == APR_EDSOOPEN)
#define APR_STATUS_IS_EABSOLUTE(s)   ((s) == APR_EABSOLUTE)
#define APR_STATUS_IS_ERELATIVE(s)   ((s) == APR_ERELATIVE)
#define APR_STATUS_IS_EINCOMPLETE(s)   ((s) == APR_EINCOMPLETE)
#define APR_STATUS_IS_EABOVEROOT(s)   ((s) == APR_EABOVEROOT)
#define APR_STATUS_IS_EBADPATH(s)   ((s) == APR_EBADPATH)
#define APR_STATUS_IS_EPATHWILD(s)   ((s) == APR_EPATHWILD)
#define APR_STATUS_IS_ESYMNOTFOUND(s)   ((s) == APR_ESYMNOTFOUND)
#define APR_STATUS_IS_EPROC_UNKNOWN(s)   ((s) == APR_EPROC_UNKNOWN)
#define APR_STATUS_IS_INCHILD(s)   ((s) == APR_INCHILD)
#define APR_STATUS_IS_INPARENT(s)   ((s) == APR_INPARENT)
#define APR_STATUS_IS_DETACH(s)   ((s) == APR_DETACH)
#define APR_STATUS_IS_NOTDETACH(s)   ((s) == APR_NOTDETACH)
#define APR_STATUS_IS_CHILD_DONE(s)   ((s) == APR_CHILD_DONE)
#define APR_STATUS_IS_CHILD_NOTDONE(s)   ((s) == APR_CHILD_NOTDONE)
#define APR_STATUS_IS_TIMEUP(s)   ((s) == APR_TIMEUP)
#define APR_STATUS_IS_INCOMPLETE(s)   ((s) == APR_INCOMPLETE)
#define APR_STATUS_IS_BADCH(s)   ((s) == APR_BADCH)
#define APR_STATUS_IS_BADARG(s)   ((s) == APR_BADARG)
#define APR_STATUS_IS_EOF(s)   ((s) == APR_EOF)
#define APR_STATUS_IS_NOTFOUND(s)   ((s) == APR_NOTFOUND)
#define APR_STATUS_IS_ANONYMOUS(s)   ((s) == APR_ANONYMOUS)
#define APR_STATUS_IS_FILEBASED(s)   ((s) == APR_FILEBASED)
#define APR_STATUS_IS_KEYBASED(s)   ((s) == APR_KEYBASED)
#define APR_STATUS_IS_EINIT(s)   ((s) == APR_EINIT)
#define APR_STATUS_IS_ENOTIMPL(s)   ((s) == APR_ENOTIMPL)
#define APR_STATUS_IS_EMISMATCH(s)   ((s) == APR_EMISMATCH)
#define APR_STATUS_IS_EBUSY(s)   ((s) == APR_EBUSY)
#define APR_STATUS_IS_SUCCESS(s)   ((s) == APR_SUCCESS)
#define APR_STATUS_IS_EACCES(s)   ((s) == APR_EACCES)
#define APR_STATUS_IS_EEXIST(s)   ((s) == APR_EEXIST)
#define APR_STATUS_IS_ENAMETOOLONG(s)   ((s) == APR_ENAMETOOLONG)
#define APR_STATUS_IS_ENOENT(s)   ((s) == APR_ENOENT)
#define APR_STATUS_IS_ENOTDIR(s)   ((s) == APR_ENOTDIR)
#define APR_STATUS_IS_ENOSPC(s)   ((s) == APR_ENOSPC)
#define APR_STATUS_IS_ENOMEM(s)   ((s) == APR_ENOMEM)
#define APR_STATUS_IS_EMFILE(s)   ((s) == APR_EMFILE)
#define APR_STATUS_IS_ENFILE(s)   ((s) == APR_ENFILE)
#define APR_STATUS_IS_EBADF(s)   ((s) == APR_EBADF)
#define APR_STATUS_IS_EINVAL(s)   ((s) == APR_EINVAL)
#define APR_STATUS_IS_ESPIPE(s)   ((s) == APR_ESPIPE)
#define APR_STATUS_IS_EAGAIN(s)   ((s) == APR_EAGAIN)
#define APR_STATUS_IS_EINTR(s)   ((s) == APR_EINTR)
#define APR_STATUS_IS_ENOTSOCK(s)   ((s) == APR_ENOTSOCK)
#define APR_STATUS_IS_ECONNREFUSED(s)   ((s) == APR_ECONNREFUSED)
#define APR_STATUS_IS_EINPROGRESS(s)   ((s) == APR_EINPROGRESS)
#define APR_STATUS_IS_ECONNABORTED(s)   ((s) == APR_ECONNABORTED)
#define APR_STATUS_IS_ECONNRESET(s)   ((s) == APR_ECONNRESET)
#define APR_STATUS_IS_ETIMEDOUT(s)   ((s) == APR_ETIMEDOUT)
#define APR_STATUS_IS_EHOSTUNREACH(s)   ((s) == APR_EHOSTUNREACH)
#define APR_STATUS_IS_ENETUNREACH(s)   ((s) == APR_ENETUNREACH)
#define APR_STATUS_IS_EFTYPE(s)   ((s) == APR_EFTYPE)
#define APR_STATUS_IS_EPIPE(s)   ((s) == APR_EPIPE)
#define APR_STATUS_IS_EXDEV(s)   ((s) == APR_EXDEV)
#define APR_STATUS_IS_ENOTEMPTY(s)

Detailed Description

Warning:
For any particular error condition, more than one of these tests may match. This is because platform-specific error codes may not always match the semantics of the POSIX codes these tests (and the correcponding APR error codes) are named after. A notable example are the APR_STATUS_IS_ENOENT and APR_STATUS_IS_ENOTDIR tests on Win32 platforms. The programmer should always be aware of this and adjust the order of the tests accordingly.

Define Documentation

#define APR_STATUS_IS_ANONYMOUS (  s   )     ((s) == APR_ANONYMOUS)
 

APR is using anonymous shared memory

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 513 of file apr_errno.h.

#define APR_STATUS_IS_BADARG (  s   )     ((s) == APR_BADARG)
 

Getopt found an option not in the option string and an argument was specified in the option string

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 489 of file apr_errno.h.

#define APR_STATUS_IS_BADCH (  s   )     ((s) == APR_BADCH)
 

Getopt found an option not in the option string

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 481 of file apr_errno.h.

#define APR_STATUS_IS_CHILD_DONE (  s   )     ((s) == APR_CHILD_DONE)
 

The child has finished executing

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 449 of file apr_errno.h.

#define APR_STATUS_IS_CHILD_NOTDONE (  s   )     ((s) == APR_CHILD_NOTDONE)
 

The child has not finished executing

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 456 of file apr_errno.h.

#define APR_STATUS_IS_DETACH (  s   )     ((s) == APR_DETACH)
 

The thread is detached

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 435 of file apr_errno.h.

#define APR_STATUS_IS_EABOVEROOT (  s   )     ((s) == APR_EABOVEROOT)
 

The given path was above the root path.

Definition at line 343 of file apr_errno.h.

Referenced by merge_aboveroot().

#define APR_STATUS_IS_EABSOLUTE (  s   )     ((s) == APR_EABSOLUTE)
 

The given path was absolute.

Definition at line 337 of file apr_errno.h.

Referenced by merge_notabsfail().

#define APR_STATUS_IS_EACCES (  s   )     ((s) == APR_EACCES)
 

permission denied

Definition at line 1121 of file apr_errno.h.

Referenced by resolve_ident(), and test_open_noreadwrite().

#define APR_STATUS_IS_EAGAIN (  s   )     ((s) == APR_EAGAIN)
 

operation would block

Definition at line 1147 of file apr_errno.h.

Referenced by AP_CORE_DECLARE_NONSTD(), APR_OPTIONAL_FN_TYPE(), bio_filter_in_read(), check_pipe_of_death(), core_input_filter(), do_read(), drain_available_output(), ef_output_filter(), pass_data_to_filter(), read_connection(), send_parsed_content(), ssl_io_filter_output(), ssl_io_input_read(), worker_main(), and write_request().

#define APR_STATUS_IS_EBADDATE (  s   )     ((s) == APR_EBADDATE)
 

APR was given an invalid date

Definition at line 298 of file apr_errno.h.

#define APR_STATUS_IS_EBADF (  s   )     ((s) == APR_EBADF)
 

bad file #

Definition at line 1139 of file apr_errno.h.

Referenced by close_pipe(), and test_fileclose().

#define APR_STATUS_IS_EBADIP (  s   )     ((s) == APR_EBADIP)
 

The specified IP address is invalid

Definition at line 322 of file apr_errno.h.

#define APR_STATUS_IS_EBADMASK (  s   )     ((s) == APR_EBADMASK)
 

The specified netmask is invalid

Definition at line 324 of file apr_errno.h.

#define APR_STATUS_IS_EBADPATH (  s   )     ((s) == APR_EBADPATH)
 

The given path was bad.

Definition at line 345 of file apr_errno.h.

#define APR_STATUS_IS_EBUSY (  s   )     ((s) == APR_EBUSY)
 

The given lock was busy

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 557 of file apr_errno.h.

#define APR_STATUS_IS_ECONNABORTED (  s   )     ((s) == APR_ECONNABORTED)
 

Software caused connection abort

Remarks:
EPROTO on certain older kernels really means ECONNABORTED, so we need to ignore it for them. See discussion in new-httpd archives nh.9701 & nh.9603
There is potentially a bug in Solaris 2.x x<6, and other boxes that implement tcp sockets in userland (i.e. on top of STREAMS). On these systems, EPROTO can actually result in a fatal loop. See PR#981 for example. It's hard to handle both uses of EPROTO.

Definition at line 1179 of file apr_errno.h.

#define APR_STATUS_IS_ECONNREFUSED (  s   )     ((s) == APR_ECONNREFUSED)
 

Connection Refused

Definition at line 1160 of file apr_errno.h.

#define APR_STATUS_IS_ECONNRESET (  s   )     ((s) == APR_ECONNRESET)
 

Connection Reset by peer

Definition at line 1183 of file apr_errno.h.

Referenced by worker_main().

#define APR_STATUS_IS_EDSOOPEN (  s   )     ((s) == APR_EDSOOPEN)
 

APR was unable to open the dso object. For more information call apr_dso_error().

Definition at line 334 of file apr_errno.h.

Referenced by test_load_notthere().

#define APR_STATUS_IS_EEXIST (  s   )     ((s) == APR_EEXIST)
 

file exists

Definition at line 1123 of file apr_errno.h.

Referenced by dav_fs_copymove_state(), mkdir_structure(), test_mkdir_twice(), and test_open_excl().

#define APR_STATUS_IS_EFTYPE (  s   )     ((s) == APR_EFTYPE)
 

inappropiate file type or format

Definition at line 1191 of file apr_errno.h.

#define APR_STATUS_IS_EGENERAL (  s   )     ((s) == APR_EGENERAL)
 

Generic Error which can not be put into another spot

Definition at line 318 of file apr_errno.h.

#define APR_STATUS_IS_EHOSTUNREACH (  s   )     ((s) == APR_EHOSTUNREACH)
 

no route to host

Definition at line 1187 of file apr_errno.h.

Referenced by worker_main().

#define APR_STATUS_IS_EINCOMPLETE (  s   )     ((s) == APR_EINCOMPLETE)
 

The given path was neither relative nor absolute.

Definition at line 341 of file apr_errno.h.

#define APR_STATUS_IS_EINIT (  s   )     ((s) == APR_EINIT)
 

Ininitalizer value. If no option has been found, but the status variable requires a value, this should be used

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 535 of file apr_errno.h.

#define APR_STATUS_IS_EINPROGRESS (  s   )     ((s) == APR_EINPROGRESS)
 

operation now in progress

Definition at line 1162 of file apr_errno.h.

Referenced by start_connect().

#define APR_STATUS_IS_EINTR (  s   )     ((s) == APR_EINTR)
 

interrupted system call

Definition at line 1156 of file apr_errno.h.

Referenced by AP_DECLARE(), ap_mpm_child_main(), ap_mpm_run(), apr_wait_for_io_or_timeout(), bio_filter_in_read(), child_main(), do_emit_plain(), listener_thread(), pass_data_to_filter(), pod_signal_internal(), ssl_io_input_read(), and worker_thread().

#define APR_STATUS_IS_EINVAL (  s   )     ((s) == APR_EINVAL)
 

invalid argument

Definition at line 1141 of file apr_errno.h.

Referenced by allow_cmd().

#define APR_STATUS_IS_EINVALSOCK (  s   )     ((s) == APR_EINVALSOCK)
 

APR was given an invalid socket

Definition at line 300 of file apr_errno.h.

#define APR_STATUS_IS_EMFILE (  s   )     ((s) == APR_EMFILE)
 

too many open files

Definition at line 1135 of file apr_errno.h.

#define APR_STATUS_IS_EMISMATCH (  s   )     ((s) == APR_EMISMATCH)
 

Two passwords do not match.

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 551 of file apr_errno.h.

#define APR_STATUS_IS_ENAMETOOLONG (  s   )     ((s) == APR_ENAMETOOLONG)
 

path name is too long

Definition at line 1125 of file apr_errno.h.

#define APR_STATUS_IS_ENETUNREACH (  s   )     ((s) == APR_ENETUNREACH)
 

network is unreachable

Definition at line 1189 of file apr_errno.h.

Referenced by worker_main().

#define APR_STATUS_IS_ENFILE (  s   )     ((s) == APR_ENFILE)
 

file table overflow

Definition at line 1137 of file apr_errno.h.

#define APR_STATUS_IS_ENODIR (  s   )     ((s) == APR_ENODIR)
 

APR was not given a directory structure

Definition at line 306 of file apr_errno.h.

#define APR_STATUS_IS_ENOENT (  s   )     ((s) == APR_ENOENT)
 

no such file or directory

Definition at line 1127 of file apr_errno.h.

Referenced by add_cern_meta_data(), AP_DECLARE(), dav_fs_create_collection(), dav_fs_deleteset(), dir_make_parent(), test_file_dup(), test_file_readwrite(), test_file_remove(), test_open_write(), test_opendir_notthere(), test_remove(), test_remove_notthere(), and test_uncleared_errno().

#define APR_STATUS_IS_ENOLOCK (  s   )     ((s) == APR_ENOLOCK)
 

APR was not given a lock structure

Definition at line 308 of file apr_errno.h.

#define APR_STATUS_IS_ENOMEM (  s   )     ((s) == APR_ENOMEM)
 

not enough memory

Definition at line 1133 of file apr_errno.h.

#define APR_STATUS_IS_ENOPOLL (  s   )     ((s) == APR_ENOPOLL)
 

APR was not given a poll structure

Definition at line 310 of file apr_errno.h.

#define APR_STATUS_IS_ENOPOOL (  s   )     ((s) == APR_ENOPOOL)
 

APR was not provided a pool with which to allocate memory

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 296 of file apr_errno.h.

#define APR_STATUS_IS_ENOPROC (  s   )     ((s) == APR_ENOPROC)
 

APR was not given a process structure

Definition at line 302 of file apr_errno.h.

#define APR_STATUS_IS_ENOSHMAVAIL (  s   )     ((s) == APR_ENOSHMAVAIL)
 

There is no more shared memory available

Definition at line 320 of file apr_errno.h.

#define APR_STATUS_IS_ENOSOCKET (  s   )     ((s) == APR_ENOSOCKET)
 

APR was not given a socket

Definition at line 312 of file apr_errno.h.

#define APR_STATUS_IS_ENOSPC (  s   )     ((s) == APR_ENOSPC)
 

no space left on device

Definition at line 1131 of file apr_errno.h.

Referenced by dav_fs_create_collection(), and dav_fs_write_stream().

#define APR_STATUS_IS_ENOSTAT (  s   )     ((s) == APR_ENOSTAT)
 

APR was unable to perform a stat on the file

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 290 of file apr_errno.h.

#define APR_STATUS_IS_ENOTDIR (  s   )     ((s) == APR_ENOTDIR)
 

not a directory

Definition at line 1129 of file apr_errno.h.

Referenced by AP_DECLARE().

#define APR_STATUS_IS_ENOTEMPTY (  s   ) 
 

Value:

((s) == APR_ENOTEMPTY || \
                                          (s) == APR_EEXIST)
Directory Not Empty

Definition at line 1197 of file apr_errno.h.

Referenced by test_removeall_fail(), and test_uncleared_errno().

#define APR_STATUS_IS_ENOTHDKEY (  s   )     ((s) == APR_ENOTHDKEY)
 

APR was not given a thread key structure

Definition at line 316 of file apr_errno.h.

#define APR_STATUS_IS_ENOTHREAD (  s   )     ((s) == APR_ENOTHREAD)
 

APR was not given a thread structure

Definition at line 314 of file apr_errno.h.

#define APR_STATUS_IS_ENOTIME (  s   )     ((s) == APR_ENOTIME)
 

APR was not given a time structure

Definition at line 304 of file apr_errno.h.

#define APR_STATUS_IS_ENOTIMPL (  s   )     ((s) == APR_ENOTIMPL)
 

The APR function has not been implemented on this platform, either because nobody has gotten to it yet, or the function is impossible on this platform.

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 544 of file apr_errno.h.

Referenced by ssl_scache_shmcb_init().

#define APR_STATUS_IS_ENOTSOCK (  s   )     ((s) == APR_ENOTSOCK)
 

socket operation on a non-socket

Definition at line 1158 of file apr_errno.h.

#define APR_STATUS_IS_EOF (  s   )     ((s) == APR_EOF)
 

APR has encountered the end of the file

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 496 of file apr_errno.h.

Referenced by ap_proxy_http_create_connection(), apr_file_transfer_contents(), bio_filter_in_read(), brigade_consume(), cfg_getstr(), ef_output_filter(), listener_thread(), read_connection(), ssl_io_filter_output(), and worker_thread().

#define APR_STATUS_IS_EPATHWILD (  s   )     ((s) == APR_EPATHWILD)
 

The given path contained wildcards.

Definition at line 347 of file apr_errno.h.

Referenced by AP_DECLARE().

#define APR_STATUS_IS_EPIPE (  s   )     ((s) == APR_EPIPE)
 

broken pipe

Definition at line 1193 of file apr_errno.h.

#define APR_STATUS_IS_EPROC_UNKNOWN (  s   )     ((s) == APR_EPROC_UNKNOWN)
 

The given process was not recognized by APR.

Definition at line 358 of file apr_errno.h.

#define APR_STATUS_IS_ERELATIVE (  s   )     ((s) == APR_ERELATIVE)
 

The given path was relative.

Definition at line 339 of file apr_errno.h.

Referenced by merge_notrelfail(), and root_relative().

#define APR_STATUS_IS_ESPIPE (  s   )     ((s) == APR_ESPIPE)
 

illegal seek

Definition at line 1143 of file apr_errno.h.

#define APR_STATUS_IS_ESYMNOTFOUND (  s   )     ((s) == APR_ESYMNOTFOUND)
 

Could not find the requested symbol. For more information call apr_dso_error().

Definition at line 355 of file apr_errno.h.

Referenced by test_unload_library(), and test_unload_module().

#define APR_STATUS_IS_ETIMEDOUT (  s   )     ((s) == APR_ETIMEDOUT)
 

Operation timed out

Definition at line 1185 of file apr_errno.h.

Referenced by worker_main().

#define APR_STATUS_IS_EXDEV (  s   )     ((s) == APR_EXDEV)
 

cross device link

Definition at line 1195 of file apr_errno.h.

#define APR_STATUS_IS_FILEBASED (  s   )     ((s) == APR_FILEBASED)
 

APR is using a file name as the key to the shared memory

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 520 of file apr_errno.h.

#define APR_STATUS_IS_INCHILD (  s   )     ((s) == APR_INCHILD)
 

Program is currently executing in the child

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 421 of file apr_errno.h.

#define APR_STATUS_IS_INCOMPLETE (  s   )     ((s) == APR_INCOMPLETE)
 

The character conversion stopped because of an incomplete character or shift sequence at the end of the input buffer.

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 471 of file apr_errno.h.

Referenced by index_directory(), and test_conversion().

#define APR_STATUS_IS_INPARENT (  s   )     ((s) == APR_INPARENT)
 

Program is currently executing in the parent

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 428 of file apr_errno.h.

#define APR_STATUS_IS_KEYBASED (  s   )     ((s) == APR_KEYBASED)
 

APR is using a shared key as the key to the shared memory

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 527 of file apr_errno.h.

#define APR_STATUS_IS_NOTDETACH (  s   )     ((s) == APR_NOTDETACH)
 

The thread is not detached

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 442 of file apr_errno.h.

#define APR_STATUS_IS_NOTFOUND (  s   )     ((s) == APR_NOTFOUND)
 

APR was unable to find the socket in the poll structure

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 503 of file apr_errno.h.

#define APR_STATUS_IS_SUCCESS (  s   )     ((s) == APR_SUCCESS)
 

no error

Definition at line 1118 of file apr_errno.h.

Referenced by cached_explode(), discard_script_output(), getsfunc_BRIGADE(), log_script(), send_parsed_content(), and set_debug().

#define APR_STATUS_IS_TIMEUP (  s   )     ((s) == APR_TIMEUP)
 

The operation did not finish before the timeout

Warning:
always use this test, as platform-specific variances may meet this more than one error code

Definition at line 463 of file apr_errno.h.

Referenced by clear_all_signalled(), clear_last_pollset(), clear_middle_pollset(), nomessage(), nomessage_pollset(), read_write(), recv0_pollset(), and recv_large_pollarray().