Package Torello.HTML.NodeSearch
Class TagNodeCount
- java.lang.Object
-
- Torello.HTML.NodeSearch.TagNodeCount
-
public class TagNodeCount extends java.lang.Object
TagNodeCount 🠞
TagNode:
This implies that only HTMLTagNode's
will be used for searching. The fieldTagNode.tok
field is used as a search criteria. Thispublic, final String
field contains the name of the HTML Element - for instance,'div', 'p', 'span', 'img'
, etc...
InnerTag's - (a.k.a. 'attributes') - are not part of the search.
Count:
This implies that the method will count the number of matches that are found, and return that count/number as a integer.
Counts the number HTML-Tags inside of Vectorized-HTML which match a user-provided search based on the Tag's Name and whether the Tag is an Opening or Closing Tag.
Methods Available
Method Explanation all (...) Returns a count of all HTMLNode
elements in the HTML Vector that meet the criteria.allExcept (...) Returns a count of all HTMLNode
elements in the HTML Vector that do not meet the criteria.Method Parameters
Parameter Explanation Vector<? extends HTMLNode> html
This represents any vectorized HTML page, sub-page, or list of partial-elements. int nth
This represents the 'nth'
match of a comparisonfor-loop
. When the method-signature used includes the parameter'nth'
, the firstn-1
matches that are found - will be skipped, and the'nth'
match is, instead, returned.
EXCEPTIONS: AnNException
shall throw if the value of parameter'nth'
is zero, negative, or larger than the size of the input html-Vector
.int sPos, int ePos
When these parameters are present, only HTMLNode's
that are found between the specifiedVector
indices will be considered for matching with the search criteria.
NOTE: In every situation where the parametersint sPos, int ePos
are used, parameter'ePos'
will accept a negative value, but parameter'sPos'
will not. When'ePos'
is passed a negative-value, the internalLV
('Loop Variable Counter') will have itspublic final int end;
field set to the length of the vectorized-html page that was passed. (html.size()
of parameterVector<HTMLNode> html
).
EXCEPTIONS: AnIndexOutOfBoundsException
will be thrown if:- If
sPos
is negative, or ifsPos
is greater-than or equal-to the size of the inputVector
- If
ePos
is zero, or greater than the size of the inputVector
. - If
sPos
is a larger integer thanePos
TC tagCriteria
The three values of enumeration TC
are:TC.OpeningTags, TC.ClosingTags
andTC.Both
. These values specify a search-criteria result set for an HTMLTagNode
. There are two types of HTML Elements:- "opening versions" of the HTML-tag such as:
<A HREF="...">
- "closing versions" of the element such as:
</A>
.
NOTE: If parameter'tagCriteria'
is passed a value ofTC.Both
, then (and this is hopefully obvious), that both 'opening' and 'closing' versions of the tag will be considered to meet / match the search criteria.String... htmlTags
When this parameter is present, only HTMLNode's
which are both instances ofclass TagNode
*and* whoseTagNode.tok
fieldString
-value matches (is equal to) at least one of the elements in thisVarArgs String
parameter-set will be considered for a match.
COMMON EXAMPLES: Some common examples of valid htmlTags are:a, div, img, table, tr, meta
as well as all other valid HTML element-tokens.
NOTE: This comparison is performed using a case-insensitive compare-method
EXCEPTIONS: If even one of the elements in this parameter-set is an invalid HTML token, anHTMLTokException
will be thrown.Return Values:
int
returns a count of how many TagNode's were identified on the vectorized-page parameter'html'
that whose HTML Element Tag's matched specified criteria
Hi-Lited Source-Code:This File's Source Code:
- View Here: Torello/HTML/NodeSearch/TagNodeCount.java
- Open New Browser-Tab: Torello/HTML/NodeSearch/TagNodeCount.java
File Size: 1,506 Bytes Line Count: 34 '\n' Characters Found
Actual Search Loop Class:
- View Here: SearchLoops/TagNodes/TNCount.java
- Open New Browser-Tab: SearchLoops/TagNodes/TNCount.java
File Size: 972 Bytes Line Count: 40 '\n' Characters Found
Argument Checker Class:
- View Here: ARGCHECK.java
- Open New Browser-Tab: ARGCHECK.java
File Size: 17,862 Bytes Line Count: 425 '\n' Characters Found
Stateless Class:This class neither contains any program-state, nor can it be instantiated. The@StaticFunctional
Annotation may also be called 'The Spaghetti Report'.Static-Functional
classes are, essentially, C-Styled Files, without any constructors or non-static member fields. It is a concept very similar to the Java-Bean's@Stateless
Annotation.
- 1 Constructor(s), 1 declared private, zero-argument constructor
- 4 Method(s), 4 declared static
- 0 Field(s)
-
-
Method Summary
All Matches Modifier and Type Method static int
all(Vector<? extends HTMLNode> html, TC tagCriteria, String... htmlTags)
All Matches, Range Limited Modifier and Type Method static int
all(Vector<? extends HTMLNode> html, int sPos, int ePos, TC tagCriteria, String... htmlTags)
All Non-Matches Modifier and Type Method static int
allExcept(Vector<? extends HTMLNode> html, TC tagCriteria, String... htmlTags)
All Non-Matches, Range Limited Modifier and Type Method static int
allExcept(Vector<? extends HTMLNode> html, int sPos, int ePos, TC tagCriteria, String... htmlTags)
-