NAME

SVN::Dumpfile::Node::Properties - Represents the properties of a node in a Subversion dumpfile.

SYNOPSIS

Objects of this class are used in SVN::Dumpfile::Node objects, but can also be used independently for manipulating Subversion revision property files.

    use SVN::Dumpfile::Node:Properties;
    my $prop = new SVN::Dumpfile::Node::Properties;
    $prop->load('filename');
    ...
    $prop->save('filename');

DESCRIPTION, SEE ALSO, AUTHOR, COPYRIGHT

See SVN::Dumpfile.

METHODS

new(): Returns a new SVN::Dumpfile::Node::Properties object. Properties can be given as hash reference, array reference or as a list. Array or list must be even an hold key/value pairs and must be used if the order of the given properties should be maintained.
number(): Returns the number of properties.
add('property', $value)
add('property', $value, $position): Adds the property with the given value at given position or at the end. Order of properties is maintained to support the creation of identical output files.
del('property'): Deletes a property from the instance. Note if the properties are written in differential form the property will retrain its value from the last changed revision when not written. Use mark_deleted() to mark the property as deleted in this case.
mark_deleted('property'): Marks a property as deleted. This is for differential property blocks which are only supported in dumpfile version 3 or later. It automatically calls del() on the property.
unmark_deleted('property'): Unmarks a property as deleted. This is for differential property blocks which are only supported in dumpfile version 3 or later. The property is not added to the node, use add() to do this.
is_deleted('property'): Returns if a property is marked as deleted. See also mark_deleted().
list_deleted(): Returns an array of all properties currently marked as deleted. See also mark_deleted.
parse($stringref): Internal method to parse single property format element from string. The element is removed from the string and returned as (ID, value) pair.
from_string('string'): Reads the properties from string by repeatly calling parse().
read($filehandle, $length): Reads <length> bytes from filehandle and parses them as properties by calling from_string().
write($filehandle): Writes the properties in subversion dumpfile format to the given filehandle.
load($filename)
load($filehandle): Loads the properties from a subversion revision property file.
save($filename)
save($filehandle): Saves the properties to a subversion revision property file.
length(): Returns the length of the string returned by as_string().
as_string()
as_string(1)
to_string()
to_string(1): Returns all properties as one string formatted in the format needed for subversion dumpfiles. If a true value is given as argument the format is that of subversion revision property files is used ('END' instead of 'PROPS-END').