How many authors would be emitted for entry, considering style and entry.getIsFirstAppearanceOfSource()

If entry is unresolved, return 0.

Note:

• The "AuASBuASCu" (or the "Au") part may be empty (maxAuthors==0 or nAuthors==0).
• OXFORD_COMMA is only emitted if nAuthors is at least 3.
• andString is only emitted if nAuthors is at least 2.

Parameters

authorList:@NonNull AuthorList

Parsed list of authors.

maxAuthors:int

The maximum number of authors to write out. If there are more authors, then ET_AL_STRING is emitted to mark their omission. Set to -1 to write out all authors. maxAuthors=0 is pointless, now throws IllegalArgumentException. (Earlier it behaved as maxAuthors=1). maxAuthors less than -1 : throw IllegalArgumentException

andString:String

For "A, BandC"

Returns:String

"AuASBuASCuOXFORD_COMMADuyearSep" or "AuetAlString", where AS = AUTHOR_SEPARATOR, Au, Bu, Cu, Du are last names of authors.

Look up the nth author and return the "proper" last name for citation markers.

Parameters

authorList:AuthorList

The author list.

number:int

The number of the author to return.

Returns:String

The author name, or an empty String if inapplicable.

Produce (Author, year) or "Author (year)" style citation strings.

Here we do not check for duplicate entries: those are handled by getCitationMarker by omitting them from the list.

Unresolved citations recognized by entry.getBibEntry() and/or entry.getDatabase() returning empty, and emitted as "Unresolved${citationKey}".

Neither uniqueLetter nor pageInfo are emitted for unresolved citations.

Parameters

purpose:JStyleGetCitationMarker.AuthorYearMarkerPurpose

IN_PARENTHESIS and NORMALIZED puts parentheses around the whole, IN_TEXT around each (year,uniqueLetter,pageInfo) part. NORMALIZED omits uniqueLetter and pageInfo, ignores isFirstAppearanceOfSource (always style.getMaxAuthors, not getMaxAuthorsFirst)

entries:List<CitationMarkerEntry>

The list of CitationMarkerEntry values to process.

startsNewGroup:boolean[]

Should have the same length as entries, and contain true for entries starting a new group, false for those that only add a uniqueLetter tothe grouped presentation.

maxAuthorsOverride:Optional<Integer>

If not empty, always show this number of authors. Added to allow NORMALIZED to use maxAuthors value that differs from style.getMaxAuthors()

Returns:OOText

The formatted citation.

This method looks up a field for an entry in a database.

Any number of backup fields can be used if the primary field is empty.

Parameters

fields:OrFields

A list of fields, to look up, using first nonempty hit. If backup fields are needed, separate field names by /. E.g. to use "author" with "editor" as backup, specify FieldFactory.serializeOrFields(StandardField.AUTHOR, StandardField.EDITOR)

Returns:String

The resolved field content, or an empty string if the field(s) were empty.

Returns:Optional<JStyleGetCitationMarker.FieldAndContent>

the field and the content of the first nonempty (after trimming) field (or alias) from fields found in entry. Return Optional.empty() if found nothing.