Biber::DataList

NAME

Biber::DataList

new
Initialize a Biber::DataList object

set_section
Sets the section of a data list

get_section
Gets the section of a data list

reset_state
Resets all state data. Used mainly in tests which call Biber::prepare()
multiple times without re−creating datalists

incr_seenpa
Increment the count of occurrences of a primary author family name

get_seenpa
Get the count of occurrences of a primary author family name

reset_entryfields
Resets all entryfield data in a list

get_entryfield
Retrieves per−list datafield information for an entry

set_entryfield
Records per−list datafield information for an entry

add_uniquenamecount
Add a name to the list of name contexts which have the name in it
(only called for visible names)

add_uniquenamecount_all
Add a name to the list of name contexts which have the name in it
(called for all names)

get_uniquelistcount
Get the number of uniquelist entries for a (possibly partial) list

add_uniquelistcount
Increment the count for a list part to the data for a name

add_uniquelistcount_final
Increment the count for a complete list to the data for a name

add_uniquelistcount_minyear
Increment the count for a list and year to the data for a name
Used to track uniquelist = minyear

get_uniquelistcount_minyear
Get the count for a list and year to the data for a name
Used to track uniquelist = minyear

get_uniquelistcount_final
Get the number of uniquelist entries for a full list

reset_uniquelistcount
Reset the count for list parts and complete lists

reset_uniquenamecount
Reset the list of names which have the name part in it

get_basenamestring
Get a basenamestring for a particular name

get_namestring
Get a namestring for a particular name

get_namestrings
Get namestrings for a particular name

set_namedis
Set name disambiguation metadata

is_unbasepart
Return boolean to say if a namepart is a base part according to
template which created the information

get_namehash
Get hash for a name

set_namehash
Set hash for a name

get_unmininfo
Get uniquename minimalness info for a name

set_unmininfo
Set uniquename minimalness info for a name

get_namedisschema
Get a name disambiguation schema for a name

get_unsummary
Get legacy uniquename summary for a name

get_unpart
Get uniquename summary part for a name

get_unparts
Get uniquename parts for a name

set_unparts
Set uniquename parts for a name

_get_uniquename
Get the list of name contexts which contain a name
Mainly for use in tests

get_uniquename
Get uniquename for a name

set_uniquename
Set uniquename for a name

reset_uniquename
Reset uniquename for a name

get_uniquename_all
Get uniquename for a name, regardless of visibility

set_uniquename_all
Set uniquename for a name, regardless of visibility

count_uniquelist
Count the names in a string used to determine uniquelist.

get_uniquelist
Gets a uniquelist setting for a namelist

set_uniquelist
Sets a uniquelist setting for a namelist

get_visible_cite
Gets citation name list visibility

set_visible_cite
Gets citation name list visibility

get_visible_bib
Gets bib name list visibility

set_visible_bib
Gets bib name list visibility

get_visible_sort
Gets sort name list visibility

set_visible_sort
Gets sort name list visibility

get_visible_alpha
Gets alpha name list visibility

set_visible_alpha
Gets alpha name list visibility

get_numofuniquenames
Get the number of uniquenames entries for a visible name

get_numofuniquenames_all
Get the number of uniquenames entries for a name

get_unul_done
Return a boolean saying whether uniquenename+uniquelist processing is finished

set_unul_changed
Set a boolean saying whether uniquename+uniquelist has changed

reset_seen_extra
Reset the counters for extra*

incr_seen_extradate
Increment and return the counter for extradate

incr_seen_extraname
Increment and return the counter for extraname

incr_seen_labelname
Increment and return a counter used to track extraname

incr_seen_extratitle
Increment and return the counter for extratitle

incr_seen_extratitleyear
Increment and return the counter for extratitleyear

incr_seen_extraalpha
Increment and return the counter for extraalpha

get_seen_namedateparts
Get the count of an labelname/dateparts combination for tracking
extradate. It uses labelyear plus name as we need to disambiguate
entries with different labelyear (like differentiating 1984−−1986 from
just 1984)

incr_seen_namedateparts
Increment the count of an labelname/dateparts combination for extradate
We pass in the name and date strings separately as we have to
be careful and only increment this counter beyond 1 if there is
a name component. Otherwise, extradate gets defined for all
entries with no name but the same year etc.

get_seen_labelname
Get the count of a labelname hash for tracking extraname

get_seen_nametitle
Get the count of an labelname/labeltitle combination for tracking
extratitle.

incr_seen_nametitle
Increment the count of an labelname/labeltitle combination for extratitle
We pass in the name and year strings separately as we have to
be careful and only increment this counter beyond 1 if there is
a title component. Otherwise, extratitle gets defined for all
entries with no title.

get_seen_titleyear
Get the count of an labeltitle/labelyear combination for tracking
extratitleyear

incr_seen_titleyear
Increment the count of an labeltitle/labelyear combination for extratitleyear
We pass in the title and year strings separately as we have to
be careful and only increment this counter beyond 1 if there is
a title component. Otherwise, extratitleyear gets defined for all
entries with no title.

reset_workuniqueness
Reset various work uniqueness counters

get_seenname
Get the count of occurrences of a labelname or labeltitle

incr_seenname
Increment the count of occurrences of a labelname or labeltitle

get_seentitle
Get the count of occurrences of a labeltitle

incr_seentitle
Increment the count of occurrences of a labeltitle

get_seenbaretitle
Get the count of occurrences of a labeltitle when there is
no labelname

incr_seenbaretitle
Increment the count of occurrences of a labeltitle
when there is no labelname

get_seenwork
Get the count of occurrences of a labelname and labeltitle

incr_seenwork
Increment the count of occurrences of a labelname and labeltitle

incr_la_disambiguation
Increment a counter to say we have seen this labelalpha

get_la_disambiguation
Get the disambiguation counter for this labelalpha.
Return a 0 for undefs to avoid spurious errors.

set_sortingtemplatename
Sets the sortingtemplate name of a data list

get_attrs
Gets the attributes of a data list

get_sortingtemplatename
Gets the sortingtemplatename of a data list

set_sortingnamekeytemplatename
Sets the sortingnamekeytemplate name of a data list

get_sortingnamekeytemplatename
Gets the sortingnamekeytemplatename of a data list

set_uniquenametemplatename
Sets the uniquenametemplate name of a data list

get_uniquenametemplatename
Gets the uniquenametemplate name of a data list

set_labelalphanametemplatename
Sets the labelalphanametemplate name of a data list

get_labelalphanametemplatename
Gets the labelalphanametemplate name of a data list

set_sortinit_collator
Sets the sortinit collator for this list

get_sortinit_collator
Gets the sortinit collator for this list

get_labelprefix
Gets the labelprefix setting of a data list

set_labelprefix
Sets the labelprefix setting of a data list

set_name
Sets the name of a data list

get_name
Gets the name of a data list

set_type
Sets the type of a data list

get_type
Gets the type of a section list

set_keys
Sets the keys for the list

get_keys
Gets the keys for the list

count_keys
Count the keys for the list

get_namelistdata
Gets name list data

set_namelistdata
Saves name list data

get_labelalphadata
Gets labelalpha field data

set_labelalphadata
Saves labelalpha data

get_labelalphadata_for_key
Gets labelalpha field data for a key

set_labelalphadata_for_key
Saves labelalpha field data for a key

set_extradatedata_for_key
Saves extradate field data for a key

set_extranamedata_for_key
Saves extraname field data for a key

get_extranamedata_for_key
Gets the extraname field data for a key

set_extradatedata
Saves extradate field data for all keys

get_extradatedata_for_key
Gets the extradate field data for a key

set_extratitledata_for_key
Saves extratitle field data for a key

set_extratitledata
Saves extratitle field data for all keys

get_extratitledata
Gets the extratitle field data for a key

set_extratitleyeardata_for_key
Saves extratitleyear field data for a key

set_extratitleyeardata
Saves extratitleyear field data for all keys

get_extratitleyeardata
Gets the extratitleyear field data for a key

set_extraalphadata_for_key
Saves extraalpha field data for a key

set_extraalphadata
Saves extraalpha field data for all keys

get_extraalphadata
Gets the extraalpha field data for a key

get_sortdataschema
Gets the sortdata schema for a sortlist

set_sortdataschema
Saves the sortdata schema for a sortlist

set_sortdata
Saves sorting data in a list for a key

get_sortdata_for_key
Gets the sorting data in a list for a key

set_sortinitdata_for_key
Saves sortinit data for a specific key

set_sortinitdata
Saves sortinit data for all keys

get_sortinit_for_key
Gets the sortinit in a list for a key

set_sortingtemplate
Sets the sortingtemplate of a list

get_sortingtemplate
Gets the sortingtemplate of a list

add_filter
Adds a filter to a list object

get_filters
Gets all filters for a list object

instantiate_entry
Do any dynamic information replacement for information
which varies in an entry between lists. This is information which
needs to be output to the .bbl for an entry but which is a property
of the reference context and not the entry per se so it cannot be stored
statically in the entry and must be retrieved from the specific datalist
when outputting the entry.

namelist_differs_index
Returns the index where the name list begins to differ from any other list
Assuming these lists
[a, b]
[a, b, d, e, f, g, h, i, j]
[a, b, d, e, f]
[a, b, e, z, z, y]
namelist_differs_index([a, b, c, d, e]) −> 2
namelist_differs_index([a]) −> 1

namelist_differs_nth
Returns true if some other name list differs at passed nth place
and is at least as long
namelist_differs_nth([a, b, c, d, e], 3) = 1
if there is another name list like any of these:
[a, b, d, e, f]
[a, b, e, z, z, y]

AUTHORS

Philip Kime "<philip at kime.org.uk>"

BUGS

Please report any bugs or feature requests on our Github tracker at <https://github.com/plk/biber/issues>.

COPYRIGHT & LICENSE

Copyright 2012−2019 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.