| Index: third_party/document_image_extractor/third_party/closure-library/closure/goog/string/string.js
|
| diff --git a/third_party/document_image_extractor/third_party/closure-library/closure/goog/string/string.js b/third_party/document_image_extractor/third_party/closure-library/closure/goog/string/string.js
|
| deleted file mode 100644
|
| index 065a1a8409b4e453833be736d94409b00394c699..0000000000000000000000000000000000000000
|
| --- a/third_party/document_image_extractor/third_party/closure-library/closure/goog/string/string.js
|
| +++ /dev/null
|
| @@ -1,1565 +0,0 @@
|
| -// Copyright 2006 The Closure Library Authors. All Rights Reserved.
|
| -//
|
| -// Licensed under the Apache License, Version 2.0 (the "License");
|
| -// you may not use this file except in compliance with the License.
|
| -// You may obtain a copy of the License at
|
| -//
|
| -// http://www.apache.org/licenses/LICENSE-2.0
|
| -//
|
| -// Unless required by applicable law or agreed to in writing, software
|
| -// distributed under the License is distributed on an "AS-IS" BASIS,
|
| -// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
| -// See the License for the specific language governing permissions and
|
| -// limitations under the License.
|
| -
|
| -/**
|
| - * @fileoverview Utilities for string manipulation.
|
| - * @author arv@google.com (Erik Arvidsson)
|
| - */
|
| -
|
| -
|
| -/**
|
| - * Namespace for string utilities
|
| - */
|
| -goog.provide('goog.string');
|
| -goog.provide('goog.string.Unicode');
|
| -
|
| -
|
| -/**
|
| - * @define {boolean} Enables HTML escaping of lowercase letter "e" which helps
|
| - * with detection of double-escaping as this letter is frequently used.
|
| - */
|
| -goog.define('goog.string.DETECT_DOUBLE_ESCAPING', false);
|
| -
|
| -
|
| -/**
|
| - * @define {boolean} Whether to force non-dom html unescaping.
|
| - */
|
| -goog.define('goog.string.FORCE_NON_DOM_HTML_UNESCAPING', false);
|
| -
|
| -
|
| -/**
|
| - * Common Unicode string characters.
|
| - * @enum {string}
|
| - */
|
| -goog.string.Unicode = {
|
| - NBSP: '\xa0'
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Fast prefix-checker.
|
| - * @param {string} str The string to check.
|
| - * @param {string} prefix A string to look for at the start of {@code str}.
|
| - * @return {boolean} True if {@code str} begins with {@code prefix}.
|
| - */
|
| -goog.string.startsWith = function(str, prefix) {
|
| - return str.lastIndexOf(prefix, 0) == 0;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Fast suffix-checker.
|
| - * @param {string} str The string to check.
|
| - * @param {string} suffix A string to look for at the end of {@code str}.
|
| - * @return {boolean} True if {@code str} ends with {@code suffix}.
|
| - */
|
| -goog.string.endsWith = function(str, suffix) {
|
| - var l = str.length - suffix.length;
|
| - return l >= 0 && str.indexOf(suffix, l) == l;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Case-insensitive prefix-checker.
|
| - * @param {string} str The string to check.
|
| - * @param {string} prefix A string to look for at the end of {@code str}.
|
| - * @return {boolean} True if {@code str} begins with {@code prefix} (ignoring
|
| - * case).
|
| - */
|
| -goog.string.caseInsensitiveStartsWith = function(str, prefix) {
|
| - return goog.string.caseInsensitiveCompare(
|
| - prefix, str.substr(0, prefix.length)) == 0;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Case-insensitive suffix-checker.
|
| - * @param {string} str The string to check.
|
| - * @param {string} suffix A string to look for at the end of {@code str}.
|
| - * @return {boolean} True if {@code str} ends with {@code suffix} (ignoring
|
| - * case).
|
| - */
|
| -goog.string.caseInsensitiveEndsWith = function(str, suffix) {
|
| - return goog.string.caseInsensitiveCompare(
|
| - suffix, str.substr(str.length - suffix.length, suffix.length)) == 0;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Case-insensitive equality checker.
|
| - * @param {string} str1 First string to check.
|
| - * @param {string} str2 Second string to check.
|
| - * @return {boolean} True if {@code str1} and {@code str2} are the same string,
|
| - * ignoring case.
|
| - */
|
| -goog.string.caseInsensitiveEquals = function(str1, str2) {
|
| - return str1.toLowerCase() == str2.toLowerCase();
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Does simple python-style string substitution.
|
| - * subs("foo%s hot%s", "bar", "dog") becomes "foobar hotdog".
|
| - * @param {string} str The string containing the pattern.
|
| - * @param {...*} var_args The items to substitute into the pattern.
|
| - * @return {string} A copy of {@code str} in which each occurrence of
|
| - * {@code %s} has been replaced an argument from {@code var_args}.
|
| - */
|
| -goog.string.subs = function(str, var_args) {
|
| - var splitParts = str.split('%s');
|
| - var returnString = '';
|
| -
|
| - var subsArguments = Array.prototype.slice.call(arguments, 1);
|
| - while (subsArguments.length &&
|
| - // Replace up to the last split part. We are inserting in the
|
| - // positions between split parts.
|
| - splitParts.length > 1) {
|
| - returnString += splitParts.shift() + subsArguments.shift();
|
| - }
|
| -
|
| - return returnString + splitParts.join('%s'); // Join unused '%s'
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Converts multiple whitespace chars (spaces, non-breaking-spaces, new lines
|
| - * and tabs) to a single space, and strips leading and trailing whitespace.
|
| - * @param {string} str Input string.
|
| - * @return {string} A copy of {@code str} with collapsed whitespace.
|
| - */
|
| -goog.string.collapseWhitespace = function(str) {
|
| - // Since IE doesn't include non-breaking-space (0xa0) in their \s character
|
| - // class (as required by section 7.2 of the ECMAScript spec), we explicitly
|
| - // include it in the regexp to enforce consistent cross-browser behavior.
|
| - return str.replace(/[\s\xa0]+/g, ' ').replace(/^\s+|\s+$/g, '');
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Checks if a string is empty or contains only whitespaces.
|
| - * @param {string} str The string to check.
|
| - * @return {boolean} Whether {@code str} is empty or whitespace only.
|
| - */
|
| -goog.string.isEmptyOrWhitespace = function(str) {
|
| - // testing length == 0 first is actually slower in all browsers (about the
|
| - // same in Opera).
|
| - // Since IE doesn't include non-breaking-space (0xa0) in their \s character
|
| - // class (as required by section 7.2 of the ECMAScript spec), we explicitly
|
| - // include it in the regexp to enforce consistent cross-browser behavior.
|
| - return /^[\s\xa0]*$/.test(str);
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Checks if a string is empty.
|
| - * @param {string} str The string to check.
|
| - * @return {boolean} Whether {@code str} is empty.
|
| - */
|
| -goog.string.isEmptyString = function(str) {
|
| - return str.length == 0;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Checks if a string is empty or contains only whitespaces.
|
| - *
|
| - * TODO(user): Deprecate this when clients have been switched over to
|
| - * goog.string.isEmptyOrWhitespace.
|
| - *
|
| - * @param {string} str The string to check.
|
| - * @return {boolean} Whether {@code str} is empty or whitespace only.
|
| - */
|
| -goog.string.isEmpty = goog.string.isEmptyOrWhitespace;
|
| -
|
| -
|
| -/**
|
| - * Checks if a string is null, undefined, empty or contains only whitespaces.
|
| - * @param {*} str The string to check.
|
| - * @return {boolean} Whether {@code str} is null, undefined, empty, or
|
| - * whitespace only.
|
| - * @deprecated Use goog.string.isEmptyOrWhitespace(goog.string.makeSafe(str))
|
| - * instead.
|
| - */
|
| -goog.string.isEmptyOrWhitespaceSafe = function(str) {
|
| - return goog.string.isEmptyOrWhitespace(goog.string.makeSafe(str));
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Checks if a string is null, undefined, empty or contains only whitespaces.
|
| - *
|
| - * TODO(user): Deprecate this when clients have been switched over to
|
| - * goog.string.isEmptyOrWhitespaceSafe.
|
| - *
|
| - * @param {*} str The string to check.
|
| - * @return {boolean} Whether {@code str} is null, undefined, empty, or
|
| - * whitespace only.
|
| - */
|
| -goog.string.isEmptySafe = goog.string.isEmptyOrWhitespaceSafe;
|
| -
|
| -
|
| -/**
|
| - * Checks if a string is all breaking whitespace.
|
| - * @param {string} str The string to check.
|
| - * @return {boolean} Whether the string is all breaking whitespace.
|
| - */
|
| -goog.string.isBreakingWhitespace = function(str) {
|
| - return !/[^\t\n\r ]/.test(str);
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Checks if a string contains all letters.
|
| - * @param {string} str string to check.
|
| - * @return {boolean} True if {@code str} consists entirely of letters.
|
| - */
|
| -goog.string.isAlpha = function(str) {
|
| - return !/[^a-zA-Z]/.test(str);
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Checks if a string contains only numbers.
|
| - * @param {*} str string to check. If not a string, it will be
|
| - * casted to one.
|
| - * @return {boolean} True if {@code str} is numeric.
|
| - */
|
| -goog.string.isNumeric = function(str) {
|
| - return !/[^0-9]/.test(str);
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Checks if a string contains only numbers or letters.
|
| - * @param {string} str string to check.
|
| - * @return {boolean} True if {@code str} is alphanumeric.
|
| - */
|
| -goog.string.isAlphaNumeric = function(str) {
|
| - return !/[^a-zA-Z0-9]/.test(str);
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Checks if a character is a space character.
|
| - * @param {string} ch Character to check.
|
| - * @return {boolean} True if {@code ch} is a space.
|
| - */
|
| -goog.string.isSpace = function(ch) {
|
| - return ch == ' ';
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Checks if a character is a valid unicode character.
|
| - * @param {string} ch Character to check.
|
| - * @return {boolean} True if {@code ch} is a valid unicode character.
|
| - */
|
| -goog.string.isUnicodeChar = function(ch) {
|
| - return ch.length == 1 && ch >= ' ' && ch <= '~' ||
|
| - ch >= '\u0080' && ch <= '\uFFFD';
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Takes a string and replaces newlines with a space. Multiple lines are
|
| - * replaced with a single space.
|
| - * @param {string} str The string from which to strip newlines.
|
| - * @return {string} A copy of {@code str} stripped of newlines.
|
| - */
|
| -goog.string.stripNewlines = function(str) {
|
| - return str.replace(/(\r\n|\r|\n)+/g, ' ');
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Replaces Windows and Mac new lines with unix style: \r or \r\n with \n.
|
| - * @param {string} str The string to in which to canonicalize newlines.
|
| - * @return {string} {@code str} A copy of {@code} with canonicalized newlines.
|
| - */
|
| -goog.string.canonicalizeNewlines = function(str) {
|
| - return str.replace(/(\r\n|\r|\n)/g, '\n');
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Normalizes whitespace in a string, replacing all whitespace chars with
|
| - * a space.
|
| - * @param {string} str The string in which to normalize whitespace.
|
| - * @return {string} A copy of {@code str} with all whitespace normalized.
|
| - */
|
| -goog.string.normalizeWhitespace = function(str) {
|
| - return str.replace(/\xa0|\s/g, ' ');
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Normalizes spaces in a string, replacing all consecutive spaces and tabs
|
| - * with a single space. Replaces non-breaking space with a space.
|
| - * @param {string} str The string in which to normalize spaces.
|
| - * @return {string} A copy of {@code str} with all consecutive spaces and tabs
|
| - * replaced with a single space.
|
| - */
|
| -goog.string.normalizeSpaces = function(str) {
|
| - return str.replace(/\xa0|[ \t]+/g, ' ');
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Removes the breaking spaces from the left and right of the string and
|
| - * collapses the sequences of breaking spaces in the middle into single spaces.
|
| - * The original and the result strings render the same way in HTML.
|
| - * @param {string} str A string in which to collapse spaces.
|
| - * @return {string} Copy of the string with normalized breaking spaces.
|
| - */
|
| -goog.string.collapseBreakingSpaces = function(str) {
|
| - return str.replace(/[\t\r\n ]+/g, ' ').replace(
|
| - /^[\t\r\n ]+|[\t\r\n ]+$/g, '');
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Trims white spaces to the left and right of a string.
|
| - * @param {string} str The string to trim.
|
| - * @return {string} A trimmed copy of {@code str}.
|
| - */
|
| -goog.string.trim = (goog.TRUSTED_SITE && String.prototype.trim) ?
|
| - function(str) {
|
| - return str.trim();
|
| - } :
|
| - function(str) {
|
| - // Since IE doesn't include non-breaking-space (0xa0) in their \s
|
| - // character class (as required by section 7.2 of the ECMAScript spec),
|
| - // we explicitly include it in the regexp to enforce consistent
|
| - // cross-browser behavior.
|
| - return str.replace(/^[\s\xa0]+|[\s\xa0]+$/g, '');
|
| - };
|
| -
|
| -
|
| -/**
|
| - * Trims whitespaces at the left end of a string.
|
| - * @param {string} str The string to left trim.
|
| - * @return {string} A trimmed copy of {@code str}.
|
| - */
|
| -goog.string.trimLeft = function(str) {
|
| - // Since IE doesn't include non-breaking-space (0xa0) in their \s character
|
| - // class (as required by section 7.2 of the ECMAScript spec), we explicitly
|
| - // include it in the regexp to enforce consistent cross-browser behavior.
|
| - return str.replace(/^[\s\xa0]+/, '');
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Trims whitespaces at the right end of a string.
|
| - * @param {string} str The string to right trim.
|
| - * @return {string} A trimmed copy of {@code str}.
|
| - */
|
| -goog.string.trimRight = function(str) {
|
| - // Since IE doesn't include non-breaking-space (0xa0) in their \s character
|
| - // class (as required by section 7.2 of the ECMAScript spec), we explicitly
|
| - // include it in the regexp to enforce consistent cross-browser behavior.
|
| - return str.replace(/[\s\xa0]+$/, '');
|
| -};
|
| -
|
| -
|
| -/**
|
| - * A string comparator that ignores case.
|
| - * -1 = str1 less than str2
|
| - * 0 = str1 equals str2
|
| - * 1 = str1 greater than str2
|
| - *
|
| - * @param {string} str1 The string to compare.
|
| - * @param {string} str2 The string to compare {@code str1} to.
|
| - * @return {number} The comparator result, as described above.
|
| - */
|
| -goog.string.caseInsensitiveCompare = function(str1, str2) {
|
| - var test1 = String(str1).toLowerCase();
|
| - var test2 = String(str2).toLowerCase();
|
| -
|
| - if (test1 < test2) {
|
| - return -1;
|
| - } else if (test1 == test2) {
|
| - return 0;
|
| - } else {
|
| - return 1;
|
| - }
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Regular expression used for splitting a string into substrings of fractional
|
| - * numbers, integers, and non-numeric characters.
|
| - * @type {RegExp}
|
| - * @private
|
| - */
|
| -goog.string.numerateCompareRegExp_ = /(\.\d+)|(\d+)|(\D+)/g;
|
| -
|
| -
|
| -/**
|
| - * String comparison function that handles numbers in a way humans might expect.
|
| - * Using this function, the string "File 2.jpg" sorts before "File 10.jpg". The
|
| - * comparison is mostly case-insensitive, though strings that are identical
|
| - * except for case are sorted with the upper-case strings before lower-case.
|
| - *
|
| - * This comparison function is significantly slower (about 500x) than either
|
| - * the default or the case-insensitive compare. It should not be used in
|
| - * time-critical code, but should be fast enough to sort several hundred short
|
| - * strings (like filenames) with a reasonable delay.
|
| - *
|
| - * @param {string} str1 The string to compare in a numerically sensitive way.
|
| - * @param {string} str2 The string to compare {@code str1} to.
|
| - * @return {number} less than 0 if str1 < str2, 0 if str1 == str2, greater than
|
| - * 0 if str1 > str2.
|
| - */
|
| -goog.string.numerateCompare = function(str1, str2) {
|
| - if (str1 == str2) {
|
| - return 0;
|
| - }
|
| - if (!str1) {
|
| - return -1;
|
| - }
|
| - if (!str2) {
|
| - return 1;
|
| - }
|
| -
|
| - // Using match to split the entire string ahead of time turns out to be faster
|
| - // for most inputs than using RegExp.exec or iterating over each character.
|
| - var tokens1 = str1.toLowerCase().match(goog.string.numerateCompareRegExp_);
|
| - var tokens2 = str2.toLowerCase().match(goog.string.numerateCompareRegExp_);
|
| -
|
| - var count = Math.min(tokens1.length, tokens2.length);
|
| -
|
| - for (var i = 0; i < count; i++) {
|
| - var a = tokens1[i];
|
| - var b = tokens2[i];
|
| -
|
| - // Compare pairs of tokens, returning if one token sorts before the other.
|
| - if (a != b) {
|
| -
|
| - // Only if both tokens are integers is a special comparison required.
|
| - // Decimal numbers are sorted as strings (e.g., '.09' < '.1').
|
| - var num1 = parseInt(a, 10);
|
| - if (!isNaN(num1)) {
|
| - var num2 = parseInt(b, 10);
|
| - if (!isNaN(num2) && num1 - num2) {
|
| - return num1 - num2;
|
| - }
|
| - }
|
| - return a < b ? -1 : 1;
|
| - }
|
| - }
|
| -
|
| - // If one string is a substring of the other, the shorter string sorts first.
|
| - if (tokens1.length != tokens2.length) {
|
| - return tokens1.length - tokens2.length;
|
| - }
|
| -
|
| - // The two strings must be equivalent except for case (perfect equality is
|
| - // tested at the head of the function.) Revert to default ASCII-betical string
|
| - // comparison to stablize the sort.
|
| - return str1 < str2 ? -1 : 1;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * URL-encodes a string
|
| - * @param {*} str The string to url-encode.
|
| - * @return {string} An encoded copy of {@code str} that is safe for urls.
|
| - * Note that '#', ':', and other characters used to delimit portions
|
| - * of URLs *will* be encoded.
|
| - */
|
| -goog.string.urlEncode = function(str) {
|
| - return encodeURIComponent(String(str));
|
| -};
|
| -
|
| -
|
| -/**
|
| - * URL-decodes the string. We need to specially handle '+'s because
|
| - * the javascript library doesn't convert them to spaces.
|
| - * @param {string} str The string to url decode.
|
| - * @return {string} The decoded {@code str}.
|
| - */
|
| -goog.string.urlDecode = function(str) {
|
| - return decodeURIComponent(str.replace(/\+/g, ' '));
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Converts \n to <br>s or <br />s.
|
| - * @param {string} str The string in which to convert newlines.
|
| - * @param {boolean=} opt_xml Whether to use XML compatible tags.
|
| - * @return {string} A copy of {@code str} with converted newlines.
|
| - */
|
| -goog.string.newLineToBr = function(str, opt_xml) {
|
| - return str.replace(/(\r\n|\r|\n)/g, opt_xml ? '<br />' : '<br>');
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Escapes double quote '"' and single quote '\'' characters in addition to
|
| - * '&', '<', and '>' so that a string can be included in an HTML tag attribute
|
| - * value within double or single quotes.
|
| - *
|
| - * It should be noted that > doesn't need to be escaped for the HTML or XML to
|
| - * be valid, but it has been decided to escape it for consistency with other
|
| - * implementations.
|
| - *
|
| - * With goog.string.DETECT_DOUBLE_ESCAPING, this function escapes also the
|
| - * lowercase letter "e".
|
| - *
|
| - * NOTE(user):
|
| - * HtmlEscape is often called during the generation of large blocks of HTML.
|
| - * Using statics for the regular expressions and strings is an optimization
|
| - * that can more than half the amount of time IE spends in this function for
|
| - * large apps, since strings and regexes both contribute to GC allocations.
|
| - *
|
| - * Testing for the presence of a character before escaping increases the number
|
| - * of function calls, but actually provides a speed increase for the average
|
| - * case -- since the average case often doesn't require the escaping of all 4
|
| - * characters and indexOf() is much cheaper than replace().
|
| - * The worst case does suffer slightly from the additional calls, therefore the
|
| - * opt_isLikelyToContainHtmlChars option has been included for situations
|
| - * where all 4 HTML entities are very likely to be present and need escaping.
|
| - *
|
| - * Some benchmarks (times tended to fluctuate +-0.05ms):
|
| - * FireFox IE6
|
| - * (no chars / average (mix of cases) / all 4 chars)
|
| - * no checks 0.13 / 0.22 / 0.22 0.23 / 0.53 / 0.80
|
| - * indexOf 0.08 / 0.17 / 0.26 0.22 / 0.54 / 0.84
|
| - * indexOf + re test 0.07 / 0.17 / 0.28 0.19 / 0.50 / 0.85
|
| - *
|
| - * An additional advantage of checking if replace actually needs to be called
|
| - * is a reduction in the number of object allocations, so as the size of the
|
| - * application grows the difference between the various methods would increase.
|
| - *
|
| - * @param {string} str string to be escaped.
|
| - * @param {boolean=} opt_isLikelyToContainHtmlChars Don't perform a check to see
|
| - * if the character needs replacing - use this option if you expect each of
|
| - * the characters to appear often. Leave false if you expect few html
|
| - * characters to occur in your strings, such as if you are escaping HTML.
|
| - * @return {string} An escaped copy of {@code str}.
|
| - */
|
| -goog.string.htmlEscape = function(str, opt_isLikelyToContainHtmlChars) {
|
| -
|
| - if (opt_isLikelyToContainHtmlChars) {
|
| - str = str.replace(goog.string.AMP_RE_, '&')
|
| - .replace(goog.string.LT_RE_, '<')
|
| - .replace(goog.string.GT_RE_, '>')
|
| - .replace(goog.string.QUOT_RE_, '"')
|
| - .replace(goog.string.SINGLE_QUOTE_RE_, ''')
|
| - .replace(goog.string.NULL_RE_, '�');
|
| - if (goog.string.DETECT_DOUBLE_ESCAPING) {
|
| - str = str.replace(goog.string.E_RE_, 'e');
|
| - }
|
| - return str;
|
| -
|
| - } else {
|
| - // quick test helps in the case when there are no chars to replace, in
|
| - // worst case this makes barely a difference to the time taken
|
| - if (!goog.string.ALL_RE_.test(str)) return str;
|
| -
|
| - // str.indexOf is faster than regex.test in this case
|
| - if (str.indexOf('&') != -1) {
|
| - str = str.replace(goog.string.AMP_RE_, '&');
|
| - }
|
| - if (str.indexOf('<') != -1) {
|
| - str = str.replace(goog.string.LT_RE_, '<');
|
| - }
|
| - if (str.indexOf('>') != -1) {
|
| - str = str.replace(goog.string.GT_RE_, '>');
|
| - }
|
| - if (str.indexOf('"') != -1) {
|
| - str = str.replace(goog.string.QUOT_RE_, '"');
|
| - }
|
| - if (str.indexOf('\'') != -1) {
|
| - str = str.replace(goog.string.SINGLE_QUOTE_RE_, ''');
|
| - }
|
| - if (str.indexOf('\x00') != -1) {
|
| - str = str.replace(goog.string.NULL_RE_, '�');
|
| - }
|
| - if (goog.string.DETECT_DOUBLE_ESCAPING && str.indexOf('e') != -1) {
|
| - str = str.replace(goog.string.E_RE_, 'e');
|
| - }
|
| - return str;
|
| - }
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Regular expression that matches an ampersand, for use in escaping.
|
| - * @const {!RegExp}
|
| - * @private
|
| - */
|
| -goog.string.AMP_RE_ = /&/g;
|
| -
|
| -
|
| -/**
|
| - * Regular expression that matches a less than sign, for use in escaping.
|
| - * @const {!RegExp}
|
| - * @private
|
| - */
|
| -goog.string.LT_RE_ = /</g;
|
| -
|
| -
|
| -/**
|
| - * Regular expression that matches a greater than sign, for use in escaping.
|
| - * @const {!RegExp}
|
| - * @private
|
| - */
|
| -goog.string.GT_RE_ = />/g;
|
| -
|
| -
|
| -/**
|
| - * Regular expression that matches a double quote, for use in escaping.
|
| - * @const {!RegExp}
|
| - * @private
|
| - */
|
| -goog.string.QUOT_RE_ = /"/g;
|
| -
|
| -
|
| -/**
|
| - * Regular expression that matches a single quote, for use in escaping.
|
| - * @const {!RegExp}
|
| - * @private
|
| - */
|
| -goog.string.SINGLE_QUOTE_RE_ = /'/g;
|
| -
|
| -
|
| -/**
|
| - * Regular expression that matches null character, for use in escaping.
|
| - * @const {!RegExp}
|
| - * @private
|
| - */
|
| -goog.string.NULL_RE_ = /\x00/g;
|
| -
|
| -
|
| -/**
|
| - * Regular expression that matches a lowercase letter "e", for use in escaping.
|
| - * @const {!RegExp}
|
| - * @private
|
| - */
|
| -goog.string.E_RE_ = /e/g;
|
| -
|
| -
|
| -/**
|
| - * Regular expression that matches any character that needs to be escaped.
|
| - * @const {!RegExp}
|
| - * @private
|
| - */
|
| -goog.string.ALL_RE_ = (goog.string.DETECT_DOUBLE_ESCAPING ?
|
| - /[\x00&<>"'e]/ :
|
| - /[\x00&<>"']/);
|
| -
|
| -
|
| -/**
|
| - * Unescapes an HTML string.
|
| - *
|
| - * @param {string} str The string to unescape.
|
| - * @return {string} An unescaped copy of {@code str}.
|
| - */
|
| -goog.string.unescapeEntities = function(str) {
|
| - if (goog.string.contains(str, '&')) {
|
| - // We are careful not to use a DOM if we do not have one or we explicitly
|
| - // requested non-DOM html unescaping.
|
| - if (!goog.string.FORCE_NON_DOM_HTML_UNESCAPING &&
|
| - 'document' in goog.global) {
|
| - return goog.string.unescapeEntitiesUsingDom_(str);
|
| - } else {
|
| - // Fall back on pure XML entities
|
| - return goog.string.unescapePureXmlEntities_(str);
|
| - }
|
| - }
|
| - return str;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Unescapes a HTML string using the provided document.
|
| - *
|
| - * @param {string} str The string to unescape.
|
| - * @param {!Document} document A document to use in escaping the string.
|
| - * @return {string} An unescaped copy of {@code str}.
|
| - */
|
| -goog.string.unescapeEntitiesWithDocument = function(str, document) {
|
| - if (goog.string.contains(str, '&')) {
|
| - return goog.string.unescapeEntitiesUsingDom_(str, document);
|
| - }
|
| - return str;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Unescapes an HTML string using a DOM to resolve non-XML, non-numeric
|
| - * entities. This function is XSS-safe and whitespace-preserving.
|
| - * @private
|
| - * @param {string} str The string to unescape.
|
| - * @param {Document=} opt_document An optional document to use for creating
|
| - * elements. If this is not specified then the default window.document
|
| - * will be used.
|
| - * @return {string} The unescaped {@code str} string.
|
| - */
|
| -goog.string.unescapeEntitiesUsingDom_ = function(str, opt_document) {
|
| - /** @type {!Object<string, string>} */
|
| - var seen = {'&': '&', '<': '<', '>': '>', '"': '"'};
|
| - var div;
|
| - if (opt_document) {
|
| - div = opt_document.createElement('div');
|
| - } else {
|
| - div = goog.global.document.createElement('div');
|
| - }
|
| - // Match as many valid entity characters as possible. If the actual entity
|
| - // happens to be shorter, it will still work as innerHTML will return the
|
| - // trailing characters unchanged. Since the entity characters do not include
|
| - // open angle bracket, there is no chance of XSS from the innerHTML use.
|
| - // Since no whitespace is passed to innerHTML, whitespace is preserved.
|
| - return str.replace(goog.string.HTML_ENTITY_PATTERN_, function(s, entity) {
|
| - // Check for cached entity.
|
| - var value = seen[s];
|
| - if (value) {
|
| - return value;
|
| - }
|
| - // Check for numeric entity.
|
| - if (entity.charAt(0) == '#') {
|
| - // Prefix with 0 so that hex entities (e.g. ) parse as hex numbers.
|
| - var n = Number('0' + entity.substr(1));
|
| - if (!isNaN(n)) {
|
| - value = String.fromCharCode(n);
|
| - }
|
| - }
|
| - // Fall back to innerHTML otherwise.
|
| - if (!value) {
|
| - // Append a non-entity character to avoid a bug in Webkit that parses
|
| - // an invalid entity at the end of innerHTML text as the empty string.
|
| - div.innerHTML = s + ' ';
|
| - // Then remove the trailing character from the result.
|
| - value = div.firstChild.nodeValue.slice(0, -1);
|
| - }
|
| - // Cache and return.
|
| - return seen[s] = value;
|
| - });
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Unescapes XML entities.
|
| - * @private
|
| - * @param {string} str The string to unescape.
|
| - * @return {string} An unescaped copy of {@code str}.
|
| - */
|
| -goog.string.unescapePureXmlEntities_ = function(str) {
|
| - return str.replace(/&([^;]+);/g, function(s, entity) {
|
| - switch (entity) {
|
| - case 'amp':
|
| - return '&';
|
| - case 'lt':
|
| - return '<';
|
| - case 'gt':
|
| - return '>';
|
| - case 'quot':
|
| - return '"';
|
| - default:
|
| - if (entity.charAt(0) == '#') {
|
| - // Prefix with 0 so that hex entities (e.g. ) parse as hex.
|
| - var n = Number('0' + entity.substr(1));
|
| - if (!isNaN(n)) {
|
| - return String.fromCharCode(n);
|
| - }
|
| - }
|
| - // For invalid entities we just return the entity
|
| - return s;
|
| - }
|
| - });
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Regular expression that matches an HTML entity.
|
| - * See also HTML5: Tokenization / Tokenizing character references.
|
| - * @private
|
| - * @type {!RegExp}
|
| - */
|
| -goog.string.HTML_ENTITY_PATTERN_ = /&([^;\s<&]+);?/g;
|
| -
|
| -
|
| -/**
|
| - * Do escaping of whitespace to preserve spatial formatting. We use character
|
| - * entity #160 to make it safer for xml.
|
| - * @param {string} str The string in which to escape whitespace.
|
| - * @param {boolean=} opt_xml Whether to use XML compatible tags.
|
| - * @return {string} An escaped copy of {@code str}.
|
| - */
|
| -goog.string.whitespaceEscape = function(str, opt_xml) {
|
| - // This doesn't use goog.string.preserveSpaces for backwards compatibility.
|
| - return goog.string.newLineToBr(str.replace(/ /g, '  '), opt_xml);
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Preserve spaces that would be otherwise collapsed in HTML by replacing them
|
| - * with non-breaking space Unicode characters.
|
| - * @param {string} str The string in which to preserve whitespace.
|
| - * @return {string} A copy of {@code str} with preserved whitespace.
|
| - */
|
| -goog.string.preserveSpaces = function(str) {
|
| - return str.replace(/(^|[\n ]) /g, '$1' + goog.string.Unicode.NBSP);
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Strip quote characters around a string. The second argument is a string of
|
| - * characters to treat as quotes. This can be a single character or a string of
|
| - * multiple character and in that case each of those are treated as possible
|
| - * quote characters. For example:
|
| - *
|
| - * <pre>
|
| - * goog.string.stripQuotes('"abc"', '"`') --> 'abc'
|
| - * goog.string.stripQuotes('`abc`', '"`') --> 'abc'
|
| - * </pre>
|
| - *
|
| - * @param {string} str The string to strip.
|
| - * @param {string} quoteChars The quote characters to strip.
|
| - * @return {string} A copy of {@code str} without the quotes.
|
| - */
|
| -goog.string.stripQuotes = function(str, quoteChars) {
|
| - var length = quoteChars.length;
|
| - for (var i = 0; i < length; i++) {
|
| - var quoteChar = length == 1 ? quoteChars : quoteChars.charAt(i);
|
| - if (str.charAt(0) == quoteChar && str.charAt(str.length - 1) == quoteChar) {
|
| - return str.substring(1, str.length - 1);
|
| - }
|
| - }
|
| - return str;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Truncates a string to a certain length and adds '...' if necessary. The
|
| - * length also accounts for the ellipsis, so a maximum length of 10 and a string
|
| - * 'Hello World!' produces 'Hello W...'.
|
| - * @param {string} str The string to truncate.
|
| - * @param {number} chars Max number of characters.
|
| - * @param {boolean=} opt_protectEscapedCharacters Whether to protect escaped
|
| - * characters from being cut off in the middle.
|
| - * @return {string} The truncated {@code str} string.
|
| - */
|
| -goog.string.truncate = function(str, chars, opt_protectEscapedCharacters) {
|
| - if (opt_protectEscapedCharacters) {
|
| - str = goog.string.unescapeEntities(str);
|
| - }
|
| -
|
| - if (str.length > chars) {
|
| - str = str.substring(0, chars - 3) + '...';
|
| - }
|
| -
|
| - if (opt_protectEscapedCharacters) {
|
| - str = goog.string.htmlEscape(str);
|
| - }
|
| -
|
| - return str;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Truncate a string in the middle, adding "..." if necessary,
|
| - * and favoring the beginning of the string.
|
| - * @param {string} str The string to truncate the middle of.
|
| - * @param {number} chars Max number of characters.
|
| - * @param {boolean=} opt_protectEscapedCharacters Whether to protect escaped
|
| - * characters from being cutoff in the middle.
|
| - * @param {number=} opt_trailingChars Optional number of trailing characters to
|
| - * leave at the end of the string, instead of truncating as close to the
|
| - * middle as possible.
|
| - * @return {string} A truncated copy of {@code str}.
|
| - */
|
| -goog.string.truncateMiddle = function(str, chars,
|
| - opt_protectEscapedCharacters, opt_trailingChars) {
|
| - if (opt_protectEscapedCharacters) {
|
| - str = goog.string.unescapeEntities(str);
|
| - }
|
| -
|
| - if (opt_trailingChars && str.length > chars) {
|
| - if (opt_trailingChars > chars) {
|
| - opt_trailingChars = chars;
|
| - }
|
| - var endPoint = str.length - opt_trailingChars;
|
| - var startPoint = chars - opt_trailingChars;
|
| - str = str.substring(0, startPoint) + '...' + str.substring(endPoint);
|
| - } else if (str.length > chars) {
|
| - // Favor the beginning of the string:
|
| - var half = Math.floor(chars / 2);
|
| - var endPos = str.length - half;
|
| - half += chars % 2;
|
| - str = str.substring(0, half) + '...' + str.substring(endPos);
|
| - }
|
| -
|
| - if (opt_protectEscapedCharacters) {
|
| - str = goog.string.htmlEscape(str);
|
| - }
|
| -
|
| - return str;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Special chars that need to be escaped for goog.string.quote.
|
| - * @private {!Object<string, string>}
|
| - */
|
| -goog.string.specialEscapeChars_ = {
|
| - '\0': '\\0',
|
| - '\b': '\\b',
|
| - '\f': '\\f',
|
| - '\n': '\\n',
|
| - '\r': '\\r',
|
| - '\t': '\\t',
|
| - '\x0B': '\\x0B', // '\v' is not supported in JScript
|
| - '"': '\\"',
|
| - '\\': '\\\\'
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Character mappings used internally for goog.string.escapeChar.
|
| - * @private {!Object<string, string>}
|
| - */
|
| -goog.string.jsEscapeCache_ = {
|
| - '\'': '\\\''
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Encloses a string in double quotes and escapes characters so that the
|
| - * string is a valid JS string.
|
| - * @param {string} s The string to quote.
|
| - * @return {string} A copy of {@code s} surrounded by double quotes.
|
| - */
|
| -goog.string.quote = function(s) {
|
| - s = String(s);
|
| - if (s.quote) {
|
| - return s.quote();
|
| - } else {
|
| - var sb = ['"'];
|
| - for (var i = 0; i < s.length; i++) {
|
| - var ch = s.charAt(i);
|
| - var cc = ch.charCodeAt(0);
|
| - sb[i + 1] = goog.string.specialEscapeChars_[ch] ||
|
| - ((cc > 31 && cc < 127) ? ch : goog.string.escapeChar(ch));
|
| - }
|
| - sb.push('"');
|
| - return sb.join('');
|
| - }
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Takes a string and returns the escaped string for that character.
|
| - * @param {string} str The string to escape.
|
| - * @return {string} An escaped string representing {@code str}.
|
| - */
|
| -goog.string.escapeString = function(str) {
|
| - var sb = [];
|
| - for (var i = 0; i < str.length; i++) {
|
| - sb[i] = goog.string.escapeChar(str.charAt(i));
|
| - }
|
| - return sb.join('');
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Takes a character and returns the escaped string for that character. For
|
| - * example escapeChar(String.fromCharCode(15)) -> "\\x0E".
|
| - * @param {string} c The character to escape.
|
| - * @return {string} An escaped string representing {@code c}.
|
| - */
|
| -goog.string.escapeChar = function(c) {
|
| - if (c in goog.string.jsEscapeCache_) {
|
| - return goog.string.jsEscapeCache_[c];
|
| - }
|
| -
|
| - if (c in goog.string.specialEscapeChars_) {
|
| - return goog.string.jsEscapeCache_[c] = goog.string.specialEscapeChars_[c];
|
| - }
|
| -
|
| - var rv = c;
|
| - var cc = c.charCodeAt(0);
|
| - if (cc > 31 && cc < 127) {
|
| - rv = c;
|
| - } else {
|
| - // tab is 9 but handled above
|
| - if (cc < 256) {
|
| - rv = '\\x';
|
| - if (cc < 16 || cc > 256) {
|
| - rv += '0';
|
| - }
|
| - } else {
|
| - rv = '\\u';
|
| - if (cc < 4096) { // \u1000
|
| - rv += '0';
|
| - }
|
| - }
|
| - rv += cc.toString(16).toUpperCase();
|
| - }
|
| -
|
| - return goog.string.jsEscapeCache_[c] = rv;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Determines whether a string contains a substring.
|
| - * @param {string} str The string to search.
|
| - * @param {string} subString The substring to search for.
|
| - * @return {boolean} Whether {@code str} contains {@code subString}.
|
| - */
|
| -goog.string.contains = function(str, subString) {
|
| - return str.indexOf(subString) != -1;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Determines whether a string contains a substring, ignoring case.
|
| - * @param {string} str The string to search.
|
| - * @param {string} subString The substring to search for.
|
| - * @return {boolean} Whether {@code str} contains {@code subString}.
|
| - */
|
| -goog.string.caseInsensitiveContains = function(str, subString) {
|
| - return goog.string.contains(str.toLowerCase(), subString.toLowerCase());
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Returns the non-overlapping occurrences of ss in s.
|
| - * If either s or ss evalutes to false, then returns zero.
|
| - * @param {string} s The string to look in.
|
| - * @param {string} ss The string to look for.
|
| - * @return {number} Number of occurrences of ss in s.
|
| - */
|
| -goog.string.countOf = function(s, ss) {
|
| - return s && ss ? s.split(ss).length - 1 : 0;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Removes a substring of a specified length at a specific
|
| - * index in a string.
|
| - * @param {string} s The base string from which to remove.
|
| - * @param {number} index The index at which to remove the substring.
|
| - * @param {number} stringLength The length of the substring to remove.
|
| - * @return {string} A copy of {@code s} with the substring removed or the full
|
| - * string if nothing is removed or the input is invalid.
|
| - */
|
| -goog.string.removeAt = function(s, index, stringLength) {
|
| - var resultStr = s;
|
| - // If the index is greater or equal to 0 then remove substring
|
| - if (index >= 0 && index < s.length && stringLength > 0) {
|
| - resultStr = s.substr(0, index) +
|
| - s.substr(index + stringLength, s.length - index - stringLength);
|
| - }
|
| - return resultStr;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Removes the first occurrence of a substring from a string.
|
| - * @param {string} s The base string from which to remove.
|
| - * @param {string} ss The string to remove.
|
| - * @return {string} A copy of {@code s} with {@code ss} removed or the full
|
| - * string if nothing is removed.
|
| - */
|
| -goog.string.remove = function(s, ss) {
|
| - var re = new RegExp(goog.string.regExpEscape(ss), '');
|
| - return s.replace(re, '');
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Removes all occurrences of a substring from a string.
|
| - * @param {string} s The base string from which to remove.
|
| - * @param {string} ss The string to remove.
|
| - * @return {string} A copy of {@code s} with {@code ss} removed or the full
|
| - * string if nothing is removed.
|
| - */
|
| -goog.string.removeAll = function(s, ss) {
|
| - var re = new RegExp(goog.string.regExpEscape(ss), 'g');
|
| - return s.replace(re, '');
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Escapes characters in the string that are not safe to use in a RegExp.
|
| - * @param {*} s The string to escape. If not a string, it will be casted
|
| - * to one.
|
| - * @return {string} A RegExp safe, escaped copy of {@code s}.
|
| - */
|
| -goog.string.regExpEscape = function(s) {
|
| - return String(s).replace(/([-()\[\]{}+?*.$\^|,:#<!\\])/g, '\\$1').
|
| - replace(/\x08/g, '\\x08');
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Repeats a string n times.
|
| - * @param {string} string The string to repeat.
|
| - * @param {number} length The number of times to repeat.
|
| - * @return {string} A string containing {@code length} repetitions of
|
| - * {@code string}.
|
| - */
|
| -goog.string.repeat = function(string, length) {
|
| - return new Array(length + 1).join(string);
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Pads number to given length and optionally rounds it to a given precision.
|
| - * For example:
|
| - * <pre>padNumber(1.25, 2, 3) -> '01.250'
|
| - * padNumber(1.25, 2) -> '01.25'
|
| - * padNumber(1.25, 2, 1) -> '01.3'
|
| - * padNumber(1.25, 0) -> '1.25'</pre>
|
| - *
|
| - * @param {number} num The number to pad.
|
| - * @param {number} length The desired length.
|
| - * @param {number=} opt_precision The desired precision.
|
| - * @return {string} {@code num} as a string with the given options.
|
| - */
|
| -goog.string.padNumber = function(num, length, opt_precision) {
|
| - var s = goog.isDef(opt_precision) ? num.toFixed(opt_precision) : String(num);
|
| - var index = s.indexOf('.');
|
| - if (index == -1) {
|
| - index = s.length;
|
| - }
|
| - return goog.string.repeat('0', Math.max(0, length - index)) + s;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Returns a string representation of the given object, with
|
| - * null and undefined being returned as the empty string.
|
| - *
|
| - * @param {*} obj The object to convert.
|
| - * @return {string} A string representation of the {@code obj}.
|
| - */
|
| -goog.string.makeSafe = function(obj) {
|
| - return obj == null ? '' : String(obj);
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Concatenates string expressions. This is useful
|
| - * since some browsers are very inefficient when it comes to using plus to
|
| - * concat strings. Be careful when using null and undefined here since
|
| - * these will not be included in the result. If you need to represent these
|
| - * be sure to cast the argument to a String first.
|
| - * For example:
|
| - * <pre>buildString('a', 'b', 'c', 'd') -> 'abcd'
|
| - * buildString(null, undefined) -> ''
|
| - * </pre>
|
| - * @param {...*} var_args A list of strings to concatenate. If not a string,
|
| - * it will be casted to one.
|
| - * @return {string} The concatenation of {@code var_args}.
|
| - */
|
| -goog.string.buildString = function(var_args) {
|
| - return Array.prototype.join.call(arguments, '');
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Returns a string with at least 64-bits of randomness.
|
| - *
|
| - * Doesn't trust Javascript's random function entirely. Uses a combination of
|
| - * random and current timestamp, and then encodes the string in base-36 to
|
| - * make it shorter.
|
| - *
|
| - * @return {string} A random string, e.g. sn1s7vb4gcic.
|
| - */
|
| -goog.string.getRandomString = function() {
|
| - var x = 2147483648;
|
| - return Math.floor(Math.random() * x).toString(36) +
|
| - Math.abs(Math.floor(Math.random() * x) ^ goog.now()).toString(36);
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Compares two version numbers.
|
| - *
|
| - * @param {string|number} version1 Version of first item.
|
| - * @param {string|number} version2 Version of second item.
|
| - *
|
| - * @return {number} 1 if {@code version1} is higher.
|
| - * 0 if arguments are equal.
|
| - * -1 if {@code version2} is higher.
|
| - */
|
| -goog.string.compareVersions = function(version1, version2) {
|
| - var order = 0;
|
| - // Trim leading and trailing whitespace and split the versions into
|
| - // subversions.
|
| - var v1Subs = goog.string.trim(String(version1)).split('.');
|
| - var v2Subs = goog.string.trim(String(version2)).split('.');
|
| - var subCount = Math.max(v1Subs.length, v2Subs.length);
|
| -
|
| - // Iterate over the subversions, as long as they appear to be equivalent.
|
| - for (var subIdx = 0; order == 0 && subIdx < subCount; subIdx++) {
|
| - var v1Sub = v1Subs[subIdx] || '';
|
| - var v2Sub = v2Subs[subIdx] || '';
|
| -
|
| - // Split the subversions into pairs of numbers and qualifiers (like 'b').
|
| - // Two different RegExp objects are needed because they are both using
|
| - // the 'g' flag.
|
| - var v1CompParser = new RegExp('(\\d*)(\\D*)', 'g');
|
| - var v2CompParser = new RegExp('(\\d*)(\\D*)', 'g');
|
| - do {
|
| - var v1Comp = v1CompParser.exec(v1Sub) || ['', '', ''];
|
| - var v2Comp = v2CompParser.exec(v2Sub) || ['', '', ''];
|
| - // Break if there are no more matches.
|
| - if (v1Comp[0].length == 0 && v2Comp[0].length == 0) {
|
| - break;
|
| - }
|
| -
|
| - // Parse the numeric part of the subversion. A missing number is
|
| - // equivalent to 0.
|
| - var v1CompNum = v1Comp[1].length == 0 ? 0 : parseInt(v1Comp[1], 10);
|
| - var v2CompNum = v2Comp[1].length == 0 ? 0 : parseInt(v2Comp[1], 10);
|
| -
|
| - // Compare the subversion components. The number has the highest
|
| - // precedence. Next, if the numbers are equal, a subversion without any
|
| - // qualifier is always higher than a subversion with any qualifier. Next,
|
| - // the qualifiers are compared as strings.
|
| - order = goog.string.compareElements_(v1CompNum, v2CompNum) ||
|
| - goog.string.compareElements_(v1Comp[2].length == 0,
|
| - v2Comp[2].length == 0) ||
|
| - goog.string.compareElements_(v1Comp[2], v2Comp[2]);
|
| - // Stop as soon as an inequality is discovered.
|
| - } while (order == 0);
|
| - }
|
| -
|
| - return order;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Compares elements of a version number.
|
| - *
|
| - * @param {string|number|boolean} left An element from a version number.
|
| - * @param {string|number|boolean} right An element from a version number.
|
| - *
|
| - * @return {number} 1 if {@code left} is higher.
|
| - * 0 if arguments are equal.
|
| - * -1 if {@code right} is higher.
|
| - * @private
|
| - */
|
| -goog.string.compareElements_ = function(left, right) {
|
| - if (left < right) {
|
| - return -1;
|
| - } else if (left > right) {
|
| - return 1;
|
| - }
|
| - return 0;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Maximum value of #goog.string.hashCode, exclusive. 2^32.
|
| - * @type {number}
|
| - * @private
|
| - */
|
| -goog.string.HASHCODE_MAX_ = 0x100000000;
|
| -
|
| -
|
| -/**
|
| - * String hash function similar to java.lang.String.hashCode().
|
| - * The hash code for a string is computed as
|
| - * s[0] * 31 ^ (n - 1) + s[1] * 31 ^ (n - 2) + ... + s[n - 1],
|
| - * where s[i] is the ith character of the string and n is the length of
|
| - * the string. We mod the result to make it between 0 (inclusive) and 2^32
|
| - * (exclusive).
|
| - * @param {string} str A string.
|
| - * @return {number} Hash value for {@code str}, between 0 (inclusive) and 2^32
|
| - * (exclusive). The empty string returns 0.
|
| - */
|
| -goog.string.hashCode = function(str) {
|
| - var result = 0;
|
| - for (var i = 0; i < str.length; ++i) {
|
| - result = 31 * result + str.charCodeAt(i);
|
| - // Normalize to 4 byte range, 0 ... 2^32.
|
| - result %= goog.string.HASHCODE_MAX_;
|
| - }
|
| - return result;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * The most recent unique ID. |0 is equivalent to Math.floor in this case.
|
| - * @type {number}
|
| - * @private
|
| - */
|
| -goog.string.uniqueStringCounter_ = Math.random() * 0x80000000 | 0;
|
| -
|
| -
|
| -/**
|
| - * Generates and returns a string which is unique in the current document.
|
| - * This is useful, for example, to create unique IDs for DOM elements.
|
| - * @return {string} A unique id.
|
| - */
|
| -goog.string.createUniqueString = function() {
|
| - return 'goog_' + goog.string.uniqueStringCounter_++;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Converts the supplied string to a number, which may be Infinity or NaN.
|
| - * This function strips whitespace: (toNumber(' 123') === 123)
|
| - * This function accepts scientific notation: (toNumber('1e1') === 10)
|
| - *
|
| - * This is better than Javascript's built-in conversions because, sadly:
|
| - * (Number(' ') === 0) and (parseFloat('123a') === 123)
|
| - *
|
| - * @param {string} str The string to convert.
|
| - * @return {number} The number the supplied string represents, or NaN.
|
| - */
|
| -goog.string.toNumber = function(str) {
|
| - var num = Number(str);
|
| - if (num == 0 && goog.string.isEmptyOrWhitespace(str)) {
|
| - return NaN;
|
| - }
|
| - return num;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Returns whether the given string is lower camel case (e.g. "isFooBar").
|
| - *
|
| - * Note that this assumes the string is entirely letters.
|
| - * @see http://en.wikipedia.org/wiki/CamelCase#Variations_and_synonyms
|
| - *
|
| - * @param {string} str String to test.
|
| - * @return {boolean} Whether the string is lower camel case.
|
| - */
|
| -goog.string.isLowerCamelCase = function(str) {
|
| - return /^[a-z]+([A-Z][a-z]*)*$/.test(str);
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Returns whether the given string is upper camel case (e.g. "FooBarBaz").
|
| - *
|
| - * Note that this assumes the string is entirely letters.
|
| - * @see http://en.wikipedia.org/wiki/CamelCase#Variations_and_synonyms
|
| - *
|
| - * @param {string} str String to test.
|
| - * @return {boolean} Whether the string is upper camel case.
|
| - */
|
| -goog.string.isUpperCamelCase = function(str) {
|
| - return /^([A-Z][a-z]*)+$/.test(str);
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Converts a string from selector-case to camelCase (e.g. from
|
| - * "multi-part-string" to "multiPartString"), useful for converting
|
| - * CSS selectors and HTML dataset keys to their equivalent JS properties.
|
| - * @param {string} str The string in selector-case form.
|
| - * @return {string} The string in camelCase form.
|
| - */
|
| -goog.string.toCamelCase = function(str) {
|
| - return String(str).replace(/\-([a-z])/g, function(all, match) {
|
| - return match.toUpperCase();
|
| - });
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Converts a string from camelCase to selector-case (e.g. from
|
| - * "multiPartString" to "multi-part-string"), useful for converting JS
|
| - * style and dataset properties to equivalent CSS selectors and HTML keys.
|
| - * @param {string} str The string in camelCase form.
|
| - * @return {string} The string in selector-case form.
|
| - */
|
| -goog.string.toSelectorCase = function(str) {
|
| - return String(str).replace(/([A-Z])/g, '-$1').toLowerCase();
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Converts a string into TitleCase. First character of the string is always
|
| - * capitalized in addition to the first letter of every subsequent word.
|
| - * Words are delimited by one or more whitespaces by default. Custom delimiters
|
| - * can optionally be specified to replace the default, which doesn't preserve
|
| - * whitespace delimiters and instead must be explicitly included if needed.
|
| - *
|
| - * Default delimiter => " ":
|
| - * goog.string.toTitleCase('oneTwoThree') => 'OneTwoThree'
|
| - * goog.string.toTitleCase('one two three') => 'One Two Three'
|
| - * goog.string.toTitleCase(' one two ') => ' One Two '
|
| - * goog.string.toTitleCase('one_two_three') => 'One_two_three'
|
| - * goog.string.toTitleCase('one-two-three') => 'One-two-three'
|
| - *
|
| - * Custom delimiter => "_-.":
|
| - * goog.string.toTitleCase('oneTwoThree', '_-.') => 'OneTwoThree'
|
| - * goog.string.toTitleCase('one two three', '_-.') => 'One two three'
|
| - * goog.string.toTitleCase(' one two ', '_-.') => ' one two '
|
| - * goog.string.toTitleCase('one_two_three', '_-.') => 'One_Two_Three'
|
| - * goog.string.toTitleCase('one-two-three', '_-.') => 'One-Two-Three'
|
| - * goog.string.toTitleCase('one...two...three', '_-.') => 'One...Two...Three'
|
| - * goog.string.toTitleCase('one. two. three', '_-.') => 'One. two. three'
|
| - * goog.string.toTitleCase('one-two.three', '_-.') => 'One-Two.Three'
|
| - *
|
| - * @param {string} str String value in camelCase form.
|
| - * @param {string=} opt_delimiters Custom delimiter character set used to
|
| - * distinguish words in the string value. Each character represents a
|
| - * single delimiter. When provided, default whitespace delimiter is
|
| - * overridden and must be explicitly included if needed.
|
| - * @return {string} String value in TitleCase form.
|
| - */
|
| -goog.string.toTitleCase = function(str, opt_delimiters) {
|
| - var delimiters = goog.isString(opt_delimiters) ?
|
| - goog.string.regExpEscape(opt_delimiters) : '\\s';
|
| -
|
| - // For IE8, we need to prevent using an empty character set. Otherwise,
|
| - // incorrect matching will occur.
|
| - delimiters = delimiters ? '|[' + delimiters + ']+' : '';
|
| -
|
| - var regexp = new RegExp('(^' + delimiters + ')([a-z])', 'g');
|
| - return str.replace(regexp, function(all, p1, p2) {
|
| - return p1 + p2.toUpperCase();
|
| - });
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Capitalizes a string, i.e. converts the first letter to uppercase
|
| - * and all other letters to lowercase, e.g.:
|
| - *
|
| - * goog.string.capitalize('one') => 'One'
|
| - * goog.string.capitalize('ONE') => 'One'
|
| - * goog.string.capitalize('one two') => 'One two'
|
| - *
|
| - * Note that this function does not trim initial whitespace.
|
| - *
|
| - * @param {string} str String value to capitalize.
|
| - * @return {string} String value with first letter in uppercase.
|
| - */
|
| -goog.string.capitalize = function(str) {
|
| - return String(str.charAt(0)).toUpperCase() +
|
| - String(str.substr(1)).toLowerCase();
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Parse a string in decimal or hexidecimal ('0xFFFF') form.
|
| - *
|
| - * To parse a particular radix, please use parseInt(string, radix) directly. See
|
| - * https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/parseInt
|
| - *
|
| - * This is a wrapper for the built-in parseInt function that will only parse
|
| - * numbers as base 10 or base 16. Some JS implementations assume strings
|
| - * starting with "0" are intended to be octal. ES3 allowed but discouraged
|
| - * this behavior. ES5 forbids it. This function emulates the ES5 behavior.
|
| - *
|
| - * For more information, see Mozilla JS Reference: http://goo.gl/8RiFj
|
| - *
|
| - * @param {string|number|null|undefined} value The value to be parsed.
|
| - * @return {number} The number, parsed. If the string failed to parse, this
|
| - * will be NaN.
|
| - */
|
| -goog.string.parseInt = function(value) {
|
| - // Force finite numbers to strings.
|
| - if (isFinite(value)) {
|
| - value = String(value);
|
| - }
|
| -
|
| - if (goog.isString(value)) {
|
| - // If the string starts with '0x' or '-0x', parse as hex.
|
| - return /^\s*-?0x/i.test(value) ?
|
| - parseInt(value, 16) : parseInt(value, 10);
|
| - }
|
| -
|
| - return NaN;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Splits a string on a separator a limited number of times.
|
| - *
|
| - * This implementation is more similar to Python or Java, where the limit
|
| - * parameter specifies the maximum number of splits rather than truncating
|
| - * the number of results.
|
| - *
|
| - * See http://docs.python.org/2/library/stdtypes.html#str.split
|
| - * See JavaDoc: http://goo.gl/F2AsY
|
| - * See Mozilla reference: http://goo.gl/dZdZs
|
| - *
|
| - * @param {string} str String to split.
|
| - * @param {string} separator The separator.
|
| - * @param {number} limit The limit to the number of splits. The resulting array
|
| - * will have a maximum length of limit+1. Negative numbers are the same
|
| - * as zero.
|
| - * @return {!Array<string>} The string, split.
|
| - */
|
| -
|
| -goog.string.splitLimit = function(str, separator, limit) {
|
| - var parts = str.split(separator);
|
| - var returnVal = [];
|
| -
|
| - // Only continue doing this while we haven't hit the limit and we have
|
| - // parts left.
|
| - while (limit > 0 && parts.length) {
|
| - returnVal.push(parts.shift());
|
| - limit--;
|
| - }
|
| -
|
| - // If there are remaining parts, append them to the end.
|
| - if (parts.length) {
|
| - returnVal.push(parts.join(separator));
|
| - }
|
| -
|
| - return returnVal;
|
| -};
|
| -
|
| -
|
| -/**
|
| - * Computes the Levenshtein edit distance between two strings.
|
| - * @param {string} a
|
| - * @param {string} b
|
| - * @return {number} The edit distance between the two strings.
|
| - */
|
| -goog.string.editDistance = function(a, b) {
|
| - var v0 = [];
|
| - var v1 = [];
|
| -
|
| - if (a == b) {
|
| - return 0;
|
| - }
|
| -
|
| - if (!a.length || !b.length) {
|
| - return Math.max(a.length, b.length);
|
| - }
|
| -
|
| - for (var i = 0; i < b.length + 1; i++) {
|
| - v0[i] = i;
|
| - }
|
| -
|
| - for (var i = 0; i < a.length; i++) {
|
| - v1[0] = i + 1;
|
| -
|
| - for (var j = 0; j < b.length; j++) {
|
| - var cost = a[i] != b[j];
|
| - // Cost for the substring is the minimum of adding one character, removing
|
| - // one character, or a swap.
|
| - v1[j + 1] = Math.min(v1[j] + 1, v0[j + 1] + 1, v0[j] + cost);
|
| - }
|
| -
|
| - for (var j = 0; j < v0.length; j++) {
|
| - v0[j] = v1[j];
|
| - }
|
| - }
|
| -
|
| - return v1[b.length];
|
| -};
|
|
|