Biber::Entry

Section: User Contributed Perl Documentation (3)
Updated: 2020-07-27
Page Index
 

NAME

Biber::Entry  

new

    Initialize a Biber::Entry object

    There are three types of field possible in an entry:

    * data    - These are fields which derive directly from or are themselves fields in the
                data source. Things like YEAR, MONTH, DAY etc. are such fields which are
                derived from, for example, the DATE field. They are part of the original
                data implicitly, derived from a field.
    * derived - These are fields, often meta-information like labelname, labelalpha etc.
                which are more removed from the data fields.

    The reason for this division is largely the entry cloning required for the related entry and
    inheritance features. When we clone an entry or copy some fields from one entry to another
    we generally don't want the "derived" category as such derived meta-fields will often need
    to be re-created or ignored so we need to know which are the actual "data" fields to
    copy/clone.

 

relclone

    Recursively create related entry clones starting with an entry

 

clone

    Clone a Biber::Entry object and return a copy
    Accepts optionally a key for the copy

 

notnull

    Test for an empty object

 

add_xdata_ref

  Add an XDATA reference to the entry
  Reference can be simply to an entire XDATA entry or a particular field+position in field
  Record reference and target positions so that the XDATA marker can be removed as otherwise
  it would break further parsing

 

get_xdata_refs

  Get the XDATA references

 

get_xdata_ref

  Get a specific XDATA reference

 

is_xdata_resolved

  Checks if an XDATA reference was resolved. Returns false also for
  "no such reference".

 

set_labelname_info

  Record the labelname information. This is special
  meta-information so we have a separate method for this
  Takes a hash ref with the information.

 

get_labelname_info

  Retrieve the labelname information. This is special
  meta-information so we have a separate method for this
  Returns a hash ref with the information.

 

set_labelnamefh_info

  Record the fullhash labelname information. This is special
  meta-information so we have a separate method for this
  Takes a hash ref with the information.

 

get_labelnamefh_info

  Retrieve the fullhash labelname information. This is special
  meta-information so we have a separate method for this
  Returns a hash ref with the information.

 

set_labeltitle_info

  Record the labeltitle information. This is special
  meta-information so we have a separate method for this
  Takes a hash ref with the information.

 

get_labeltitle_info

  Retrieve the labeltitle information. This is special
  meta-information so we have a separate method for this
  Returns a hash ref with the information.

 

set_labeldate_info

  Record the labeldate information. This is special
  meta-information so we have a separate method for this
  Takes a hash ref with the information.

 

get_labeldate_info

  Retrieve the labeldate information. This is special
  meta-information so we have a separate method for this
  Returns a hash ref with the information.

 

set_field

  Set a derived field for a Biber::Entry object, that is, a field
  which was not an actual bibliography field

 

get_field

    Get a field for a Biber::Entry object
    Uses // as fields can be null (end dates etc).

 

set_datafield

    Set a field which is in the .bib data file

 

get_datafield

    Get a field that was in the original data file

 

del_field

    Delete a field in a Biber::Entry object

 

del_datafield

    Delete an original data source data field in a Biber::Entry object

 

field_exists

    Check whether a field exists (even if null)

 

date_fields_exist

    Check whether any parts of a date field exist when passed a datepart field name

 

delete_date_fields

    Delete all parts of a date field when passed any datepart field name

 

datafields

    Returns a sorted array of the fields which came from the data source

 

count_datafields

    Returns the number of datafields

 

derivedfields

    Returns a sorted array of the fields which were added during processing

 

fields

    Returns a sorted array of all field names, including ones
    added during processing which are not necessarily fields
    which came from the data file

 

count_fields

    Returns the number of fields

 

has_keyword

    Check if a Biber::Entry object has a particular keyword in
    in the KEYWORDS field.

 

add_warning

    Append a warning to a Biber::Entry object

 

set_inherit_from

    Inherit fields from first child entry

    $entry->set_inherit_from($firstchild);

    Takes a second Biber::Entry object as argument

    The purpose here is to inherit fields so that sorting/labelling defaults
    can be generated for set parents from the first child set member data, unless
    the set parent itself already has some fields set that will do this. Set
    parents only have certain fields output in the .bbl and those that output but
    are not used in sorting/labelling data generation should not be inherited.

 

resolve_xdata

    Recursively resolve XDATA in an entry. Sets a flag in the XDATA metadata to
    say if the reference was successfully resolved.

    $entry->resolve_xdata($xdata);

 

inherit_from

    Inherit fields from parent entry (as indicated by the crossref field)

    $entry->inherit_from($parententry);

    Takes a second Biber::Entry object as argument
    Uses the crossref inheritance specifications from the .bcf

 

dump

    Dump Biber::Entry object

 

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 2009-2012 Francois Charette and Philip Kime, all rights reserved. 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.


 

Index

NAME
new
relclone
clone
notnull
add_xdata_ref
get_xdata_refs
get_xdata_ref
is_xdata_resolved
set_labelname_info
get_labelname_info
set_labelnamefh_info
get_labelnamefh_info
set_labeltitle_info
get_labeltitle_info
set_labeldate_info
get_labeldate_info
set_field
get_field
set_datafield
get_datafield
del_field
del_datafield
field_exists
date_fields_exist
delete_date_fields
datafields
count_datafields
derivedfields
fields
count_fields
has_keyword
add_warning
set_inherit_from
resolve_xdata
inherit_from
dump
AUTHORS
BUGS
COPYRIGHT & LICENSE