1Biber::Input::file::bibUtseexr(3Cpomn)tributed Perl DocuBmiebnetra:t:iIonnput::file::bibtex(3pm)
2
3
4
5   init_cache
6           Invalidate the T::B object cache. Used only in tests when e.g. we change the encoding
7           settings and therefore must force a re-read of the data
8
9   TBSIG
10            Signal handler to catch fatal Text::BibTex SEGFAULTS. It has bugs
11            and we want to say at least something if it coredumps
12
13   extract_entries
14          Main data extraction routine.
15          Accepts a data source identifier, preprocesses the file and then
16          looks for the passed keys, creating entries when it finds them and
17          passes out an array of keys it didn't find.
18
19   create_entry
20          Create a Biber::Entry object from a Text::BibTeX object
21          Be careful in here, all T::B set methods are UTF-8/NFC boundaries
22          so be careful to encode(NFC()) on calls. Windows won't handle UTF-8
23          in T::B btparse gracefully and will die.
24
25   cache_data
26          Caches file data into T::B objects indexed by the original
27          datasource key, decoded into UTF8
28
29   preprocess_file
30          Convert file to UTF-8 and potentially decode LaTeX macros to UTF-8
31
32   parse_decode
33         Partially parse the .bib datasource and latex_decode the data contents.
34         We do this because latex_decoding the entire buffer is difficult since
35         such decoding is regexp based and since braces are used to protect data in
36         .bib files, it makes it hard to do some parsing.
37
38   parsename
39           Given a name string, this function returns a Biber::Entry::Name object
40           with all parts of the name resolved according to the BibTeX conventions.
41
42           parsename('John Doe', 'author', 'key')
43           returns an object which internally looks a bit like this:
44
45           { given          => {string => 'John', initial => ['J']},
46             family         => {string => 'Doe', initial => ['D']},
47             prefix         => {string => undef, initial => undef},
48             suffix         => {string => undef, initial => undef},
49             id             => 32RS0Wuj0P,
50             strip          => {'given'  => 0,
51                                'family' => 0,
52                                'prefix' => 0,
53                                'suffix' => 0}
54             }
55
56   parsename_x
57           Given a name string in extended format, this function returns a Biber::Entry::Name object
58           with all parts of the name resolved according to the BibTeX conventions.
59
60           parsename_x('given=John, family=Doe')
61           returns an object which internally looks a bit like this:
62
63           { given          => {string => 'John', initial => ['J']},
64             family         => {string => 'Doe', initial => ['D']},
65             prefix         => {string => undef, initial => undef},
66             suffix         => {string => undef, initial => undef},
67             id             => 32RS0Wuj0P,
68             sortingnamekeytemplatename => 'template name',
69           }
70

NAME

72       Biber::Input::file::bibtex - look in a BibTeX file for an entry and
73       create it if found
74

DESCRIPTION

76       Provides the extract_entries() method to get entries from a BibTeX data
77       source and instantiate Biber::Entry objects for what it finds
78

AUTHOR

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

BUGS

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

87       Copyright 2009-2012 François Charette and Philip Kime, all rights
88       reserved.  Copyright 2012-2023 Philip Kime, all rights reserved.
89
90       This module is free software.  You can redistribute it and/or modify it
91       under the terms of the Artistic License 2.0.
92
93       This program is distributed in the hope that it will be useful, but
94       without any warranty; without even the implied warranty of
95       merchantability or fitness for a particular purpose.
96
97
98
99perl v5.38.0                      2023-07-19   Biber::Input::file::bibtex(3pm)
Impressum