OS2::ExtAttr
Section: Perl Programmers Reference Guide
(3)
Updated: perl 5.004, patch 55
Index
Return to Main Contents
NAME
OS2::ExtAttr - Perl access to extended attributes.
SYNOPSIS
use OS2::ExtAttr;
tie %ea, 'OS2::ExtAttr', 'my.file';
print $ea{eaname};
$ea{myfield} = 'value';
untie %ea;
DESCRIPTION
The package provides low-level and high-level interface to Extended
Attributes under OS/2.
High-level interface: tie
The only argument of tie() is a file name, or an open file handle.
Note that all the changes of the tied hash happen in core, to
propagate it to disk the tied hash should be untie()ed or should go
out of scope. Alternatively, one may use the low-level update
method on the corresponding object. Example:
tied(%hash)->update;
Note also that setting/getting EA flag is not supported by the
high-level interface, one should use the low-level interface
instead. To use it on a tied hash one needs undocumented way to find
eas give the tied hash.
Low-level interface
Two low-level methods are supported by the objects: copy() and
update(). The copy() takes one argument: the name of a file to copy
the attributes to, or an opened file handle. update() takes no
arguments, and is discussed above.
Three convenience functions are provided:
value($eas, $key)
add($eas, $key, $value [, $flag])
replace($eas, $key, $value [, $flag])
The default value for flag is 0.
In addition, all the _ea_* and _ead_* functions defined in EMX
library are supported, with leading _ea/_ead stripped.
AUTHOR
Ilya Zakharevich, ilya@math.ohio-state.edu
SEE ALSO
perl(1).
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- High-level interface: tie
-
- Low-level interface
-
- AUTHOR
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 23:58:16 GMT, February 15, 2023