src/xmlkit/XMLKit.java

2  * Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
5  * This code is free software; you can redistribute it and/or modify it
12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
22  * or visit www.oracle.com if you need additional information or have any
56  * Many useful XML operations (or Lisp-like calls) can be accomplished
67  * <li>There are no parent or sibling pointers in the tree.</li>
69  * <li>There is no internal support for schemas or validation.</li>
76  * a bar "|". Arguments or return values for which a null is
264  * XMLKit.or(Filter&amp;Filter | Filter[])
1013          *  either before or after the change.
1042          *  or new String may be created to join the last old and first
1062          *  if the input string was null, or was successfully
1176         /** Add one or more subelements at the given position.
1180          *  Otherwise, add is called, adding a single subelement or string.
1181          *  The net effect is to add zero or more tokens.
1531         // Finding or removing elements w/o regard to their type or content.
1548         // Finding or removing by element tag or selected attribute,
1549         // as if by elementFilter(name) or attrFilter(name, value).
2149         or all space.
2270          *  name or attributes.)
2348          *  StringBuffer, or use it in other data structures.
2426          *  name or sub-elements.)
2553          * Trim excess capacity to zero, or do nothing if frozen.
2555          * at the expense of a reallocation if sub-elements or attributes
2636         // Open or expand at the given position, as appropriate.
2888     /** Used to find, filter, or transform sub-elements.
2893      *  or an anonymous Element (meaning multiple results).
3111      *  Returns either the first null or the last non-null value.
3145      *  Returns either the first non-null or the last null value.
3147     public static Filter or(final Filter f0, final Filter f1) {
3148         return or(new Filter[]{f0, f1});
3151     public static Filter or(final Filter... fs) {
3181      *  Returns either the first null or the last non-null value.
3314      *  (or else the first argument type, if the method is static),
3457      *  resulting filter value e, or its parts.
3459      *  If e is a TokenList or an anonymous Element, add e's parts
3474      *  Element.EMPTY or TokenList.EMPTY.
3476      *  use the expression: <code>or(f, emptyFilter())</code>.
3513      *  If e is a TokenList or an anonymous Element, add e's parts
3719             // If buffer was empty, or had only ignorable blanks, do nothing.
4158     /** If str is null, empty, or blank, returns null.
4159      *  Otherwise, return a Double if str spells a double value and contains '.' or 'e'.