blob: 72cb7dc400dae4aa8c4b82ca18065ae6b9dc31da (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
package Biber::Entry::Names;
#use feature 'unicode_strings';
use Data::Dump;
=encoding utf-8
=head1 NAME
Biber::Entry::Names
=head2 new
Initialize a Biber::Entry::Names object
=cut
sub new {
my $class = shift;
return bless [], $class;
}
=head2 notnull
Test for an empty object
=cut
sub notnull {
my $self = shift;
my @arr = @$self;
return $#arr > -1 ? 1 : 0;
}
=head2 names
Return ref to array of all Biber::Entry::Name objects
in object
=cut
sub names {
my $self = shift;
return $self;
}
=head2 add_element
Add a Biber::Entry::Name object to the Biber::Entry::Names
object
=cut
sub add_element {
my $self = shift;
my $name_obj = shift;
push @$self, $name_obj;
return;
}
=head2 count_elements
Returns the number of Biber::Entry::Name objects in the object
=cut
sub count_elements {
my $self = shift;
return scalar @$self;
}
=head2 nth_element
Returns the nth Biber::Entry::Name object in the object
=cut
sub nth_element {
my $self = shift;
my $n = shift;
return @$self[$n-1];
}
=head2 first_n_elements
Returns a new Biber::Entry::Names object containing only
the first n entries of $self
=cut
sub first_n_elements {
my $self = shift;
my $n = shift;
return bless [ splice(@$self, 0, $n) ], Biber::Entry::Names;
}
=head2 del_last_element
Deletes the last Biber::Entry::Name object in the object
=cut
sub del_last_element {
my $self = shift;
pop(@$self); # Don't want the return value of this!
return;
}
=head2 last_element
Returns the last Biber::Entry::Name object in the object
=cut
sub last_element {
my $self = shift;
return @$self[-1];
}
=head2 dump
Dump a Biber::Entry::Name object for debugging purposes
=cut
sub dump {
my $self = shift;
dd($self);
return;
}
=head1 AUTHORS
François Charette, C<< <firmicus at gmx.net> >>
Philip Kime C<< <philip at kime.org.uk> >>
=head1 BUGS
Please report any bugs or feature requests on our sourceforge tracker at
L<https://sourceforge.net/tracker2/?func=browse&group_id=228270>.
=head1 COPYRIGHT & LICENSE
Copyright 2009-2011 François Charette and Philip Kime, all rights reserved.
This module is free software. You can redistribute it and/or
modify it under the terms of the Artistic License 2.0.
This program is distributed in the hope that it will be useful,
but without any warranty; without even the implied warranty of
merchantability or fitness for a particular purpose.
=cut
1;
# vim: set tabstop=2 shiftwidth=2 expandtab:
|
