C# 클래스 com.ximpleware.VTDNav

Duplicate the VTDNav instance with shared XML, VTD and LC buffers This method may be useful for parallel XPath evaluation The node Position is copied over.

New in 2.0 Compare the string against the token at the given index value. When a token is an attribute name or starting tag, qualified name is what gets compared against This method has to take care of the underlying encoding conversion but it doesn't resolve entity reference in the underlying document The behavior is the same as calling toRawString on index, then compare to s

New in 2.0 Compare the string against the token at the given index value. When a token is an attribute name or starting tag, qualified name is what gets matched against This method has to take care of the underlying encoding conversion as well as entity reference comparison

New in 2.0 This method compares two VTD tokens of VTDNav objects The behavior of this method is like compare the strings corresponds to i1 and i2

Test whether a given token contains s. notie that this function directly operates on the byte content of the token to avoid string creation

This method print out the current state info of the navigation object. It is for debugging purpose.

new in v2.12, dump the element fragment into a file of a given name

New in v2.12 Dump an element fragment of xml into an XML file whose name is specified as fileName

New in v2.12 Dump an element fragment of xml into an output stream

New in v2.12 Dump a fragement as specified by a long into an output stream

Dump the XML text into a file with the given fileName

dump the XML text into a stream

Duplicate the VTDNav instance with shared XML, VTD and LC buffers This method may be useful for parallel XPath evaluation The node Position is at root element

Test the end of token content at index i matches the content of s, notice that this is to save the string allocation cost of using String's built-in endsWidth

New in v2.12 This method will take a segment descriptor and return a new descriptor that includes all the leading and trailing white spaces around the input segment It has no effect on CDATA A typical usage would be 'expandWhiteSpaces(getElementFragment())'

Get the number of attributes of a cursor element

Get the token index of the attribute value given an attribute name.

Get the token index of the attribute value of given URL and local name. If ns is not enabled, the lookup will return -1, indicating a no-found. Also namespace nodes are invisible using this method. One can't use * to indicate any name space because * is ambiguous!!

Get content fragment returns a long encoding the offset and length of the byte segment of the content of current element, which is the byte segment between the starting tag and ending tag, -1 is returned if the current element is an empty element

get the depth of context node

Get the index value of the current element. Creation date: (11/16/03 6:40:25 PM)

Get the starting offset and length of an element encoded in a long, upper 32 bit is length; lower 32 bit is offset Unit is in byte. Creation date: (3/15/04 1:47:55 PM)

Get the encoding of the XML document.

Precompute the size of VTD+XML index without actully generating it

Get the maximum nesting depth of the XML document (>0). max depth is nestingLevel -1

Get the string length of a token as if it is converted into a normalized UCS string

Return the prefix of a token as a string if the token is of the type of starting tag, attribute name, if the the prefix doesn't exist, a null string is returned; otherwise a null string is returned

Get the string length as if the token is converted into a UCS string (entity not resolved)

Get root index value , which is the index val of document element

Return the byte offset and length of up to i sibling fragments. If there is a i+1 sibling element, the cursor element would move to it; otherwise, there is no cursor movement. If the cursor isn't positioned at an element (due to XPath evaluation), then -1 will be returned @param i number of silbing elements including the cursor element @return a long encoding byte offset (bit 31 to bit 0), length (bit 62 to bit 32) of those fragments @throws NavException

getStringLength return the string length of a token as if the token is converted into a string (entity resolved)

This method returns of the token index of the type character data or CDATA. Notice that it is intended to support data orient XML (not mixed-content XML). return the index of the text token, or -1 if none exists.

Get total number of VTD tokens for the current XML document.

Get the depth value of a token (>=0).

Get the token length at the given index value please refer to VTD spec for more details Length is in terms of the UTF char unit For prefixed tokens, it is the qualified name length. When ns is not enabled, return the full name length for attribute name and element name When ns is enabled, return an int with upper 16 bit for prefix length, lower 16 bit for qname length

Get the starting offset of the token at the given index.

Get the token type of the token at the given index value. Creation date: (11/16/03 6:41:51 PM)

Get the XML document

Test whether current element has an attribute with the matching name. "*" will match any attribute name, therefore is a test whether there is any attribute at all if namespace is disabled, this function will not distinguish between ns declaration and attribute otherwise, ns tokens are invisible Creation date: (11/16/03 5:50:26 PM)

Test whether the current element has an attribute with matching namespace URL and localname. If ns is false, return false immediately

Test if the current element matches the given name. Creation date: (11/26/03 2:09:43 PM)

Test whether the current element matches the given namespace URL and localname. URL, when set to "*", matches any namespace (including null), when set to null, defines a "always-no-match" ln is the localname that, when set to *, matches any localname

Match the string against the token at the given index value. When a token is an attribute name or starting tag, qualified name is what gets matched against This method has to take care of the underlying encoding conversion but it doesn't resolve entity reference in the underlying document

Match the string against the token at the given index value. When a token is an attribute name or starting tag, qualified name is what gets matched against This method has to take care of the underlying encoding conversion as well as entity reference comparison

This method compares two VTD tokens of VTDNav objects

overWrite is introduced in version 2.0 that allows you to directly overwrite the XML content if the token is long enough If the operation is successful, white spaces will be used to fill the available token space, and there will be no need to regenerate the VTD and LCs The current version (2.0) only allows overwrites on attribute value, character data, and CDATA Consider the XML below: good After overwriting the token "good" with "bad," the new XML looks like: bad as you can see, "goo" is replaced with "bad" character-by-character, and the remaining "d" is replace with a white space

overWrite is introduced in version 2.0 that allows you to directly overwrite the XML content if the token is long enough If the operation is successful, white spaces will be used to fill the available token space, and there will be no need to regenerate the VTD and LCs The current version (2.0) only allows overwrites on attribute value, character data, and CDATA Consider the XML below: good After overwriting the token "good" with "bad," the new XML looks like: bad as you can see, "goo" is replaced with "bad" character-by-character, and the remaining "d" is replace with a white space

Convert a vtd token into a double. Creation date: (12/8/03 2:28:31 PM)

Convert a vtd token into a float. we assume token type to be attr val or character data Creation date: (12/8/03 2:28:18 PM)

Convert a vtd token into an int. This method will automatically strip off the leading and trailing we assume token type to be attr val or character data zero, unlike Integer.parseInt(int index) Creation date: (12/8/03 2:32:22 PM)

Convert a vtd token into a long. we assume token type to be attr val or character data Creation date: (12/8/03 2:32:59 PM)

Load the context info from ContextBuffer. Info saved including LC and current state of the context Creation date: (11/16/03 6:59:20 PM)

Insert the method's description here. Creation date: (3/11/04 1:46:06 PM)

printLC for debugging purpose. Creation date: (3/12/04 6:07:40 PM)

Store the context info into the ContextBuffer. Info saved including LC and current state of the context Creation date: (11/16/03 7:00:27 PM)

This method takes a vtd index, and recover its correspondin node position, the index can only be of node type element, document, attribute name, attribute value or character data, or CDATA

This is for debugging purpose

Test the start of token content at index i matches the content of s, notice that this is to save the string allocation cost of using String's built-in startsWidth

A generic navigation method. Move the current to the element according to the direction constants If no such element, no position change and return false. Creation date: (12/2/03 1:43:50 PM) Legal direction constants are

   			ROOT               0 

 		    PARENT  		   1 

       	    FIRST_CHILD		   2 

 		    LAST_CHILD 		   3 

    	  	    NEXT_SIBLING       4 

      	    PREV_SIBLING       5 

A generic navigation method. Move the current to the element according to the direction constants and the element name If no such element, no position change and return false. "*" matches any element Creation date: (12/2/03 1:43:50 PM) Legal direction constants are

		ROOT            0  

		PARENT          1  

		FIRST_CHILD     2  

		LAST_CHILD      3  

		NEXT_SIBLING    4  

		PREV_SIBLING    5  

A generic navigation method with namespace support. Move the current to the element according to the direction constants and the prefix and local names If no such element, no position change and return false. URL * matches any namespace, including undefined namespaces a null URL means hte namespace prefix is undefined for the element ln * matches any localname Creation date: (12/2/03 1:43:50 PM) Legal direction constants are

		ROOT            0  

		PARENT          1  

		FIRST_CHILD     2  

		LAST_CHILD      3  

		NEXT_SIBLING    4  

		PREV_SIBLING    5  

This method normalizes a token into a string in a way that resembles DOM. The leading and trailing white space characters will be stripped. The entity and character references will be resolved Multiple whitespaces char will be collapsed into one. Whitespaces via entities will nonetheless be preserved. Creation date: (12/8/03 1:57:10 PM)

(New since version 2.9) Shallow Normalization follows the rules below to normalize a token into a string *#xD#xA gets converted to #xA *For a character reference, append the referenced character to the normalized value. *For an entity reference, recursively apply step 3 of this algorithm to the replacement text of the entity. *For a white space character (#x20, #xD, #xA, #x9), append a space character (#x20) to the normalized value. *For another character, append the character to the normalized value. @param index @return @throws NavException

Convert a token at the given index to a String, (built-in entity and char references not resolved) (entities and char references not expanded). Creation date: (11/16/03 7:28:49 PM)

Convert a segment of xml document into string entities not resolved

Convert a token at the given index to a String, upper case chars get converted into lower case (entities and char references not expanded).

Convert a token at the given index to a String, lower case chars get converted into upper case (entities and char references not expanded).

Convert a token at the given index to a String, (entities and char references resolved). An attribute name or an element name will get the UCS2 string of qualified name Creation date: (11/16/03 7:27:19 PM)

convert the document segment to String, entities resolved

Convert a token at the given index to a String and any upper case character will be converted to lower case, (entities and char references resolved). An attribute name or an element name will get the UCS2 string of qualified name

Convert a token at the given index to a String and any lower case character will be converted to upper case, (entities and char references resolved). An attribute name or an element name will get the UCS2 string of qualified name

New in v2.12 This method will take a segment descriptor and return a new descriptor that removes all the leading and trailing white spaces around the input segment It has no effect on CDATA

This method writes the VTD+XML into an output streams

Write VTDNav's internal structure into an OutputStream (XML not written out)

Write VTDNav's VTD and LCs into an OutputStream (XML not written out)

Return the attribute count of the element at the cursor position. when ns is false, ns tokens are considered attributes; otherwise, ns tokens are not considered attributes

Initialize the VTD navigation object.

Convert the string val of an element of document node into a double without first creating teh string object

This method is called by ends-with in FuncExpression, it is to perform ends-with on concatnation of text value of an element or document without actually creating the string object.

clear the contextStack2 after XPath evaluation

compareNormalizedTokenString2

Test the token type, to see if it is a starting tag.

Test the token type, to see if it is a starting tag or document token (introduced in 1.0).

This method is similar to getElementByName in DOM except it doesn't return the nodeset, instead it iterates over those nodes. Notice that this method is called by the "iterate" method in the Autopilot class. "*" will match any element Creation date: (12/2/03 2:31:20 PM)

This method is similar to getElementByName in DOM except it doesn't return the nodeset, instead it iterates over those nodes . When URL is "*" it will match any namespace if ns is false, return false immediately

This function is called by selectElement_F in autoPilot

This function is called by selectElementNS_F in autoPilot

This function is called by selectElement_P in autoPilot

This function is called by selectElementNS_P in autoPilot

Test whether the URL is defined in the scope. Null is allowed to indicate the name space is undefined. Creation date: (11/16/03 7:54:01 PM)

Convert a vtd token into an int, with the given radix. we assume token type to be attr val or character data the first char can be either '+' or '-' Creation date: (12/16/03 1:21:20 PM)

Convert a vtd token into a long, with the given radix. the first char can be either '+' or '-', leading and trailing will be stripped we assume token type to be attr val or character data Creation date: (12/17/03 1:51:06 PM)

Load the context info from contextStack2. This method is dedicated for XPath evaluation.

Store the context info into the contextStack2. This method is reserved for XPath Evaluation

Sync up the current context with location cache. This operation includes finding out l1index, l2index, l3index and restores upper and lower bound info To improve efficieny this method employs some heuristic search algorithm. The result is that it is quite close to direct access. Creation date: (11/16/03 7:44:53 PM)

Convert the byte content segment (in terms of offset and length) to String, upper case characters are converted to lower case Notice this is more efficient than call toString, then can toLowerCase

Convert the byte content segment (in terms of offset and length) to String, lower case characters are converted to upper case

Evaluate the namespace indicator in bit 31 and bit 30. Creation date: (11/27/03 5:38:51 PM)

This method decodes the underlying byte array into corresponding UCS2 char representation . It doesn't resolves built-in entity and character references. Length will never be zero Creation date: (11/21/03 6:26:17 PM)

This method decodes the underlying byte array into corresponding UCS2 char representation . Also it resolves built-in entity and character references.

Get the next char unit which gets decoded automatically

Test whether ch is a white space character or not.

Match a string against a token with given offset and len, entities doesn't get resolved.

Match a string with a token represented by a long (upper 32 len, lower 32 offset).

Match a string against a token with given offset and len, entities get resolved properly. Creation date: (11/24/03 1:37:42 PM)

Match a string against a "non-extractive" token represented by a long (upper 32 len, lower 32 offset).

Test whether the URL is defined in the document. Null is allowed to indicate the name space should be undefined. Creation date: (11/16/03 7:54:01 PM)