Source: lib/util/text_parser.js

  1. /**
  2.  * @license
  3.  * Copyright 2016 Google Inc.
  4.  *
  5.  * Licensed under the Apache License, Version 2.0 (the "License");
  6.  * you may not use this file except in compliance with the License.
  7.  * You may obtain a copy of the License at
  8.  *
  9.  *     http://www.apache.org/licenses/LICENSE-2.0
  10.  *
  11.  * Unless required by applicable law or agreed to in writing, software
  12.  * distributed under the License is distributed on an "AS IS" BASIS,
  13.  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14.  * See the License for the specific language governing permissions and
  15.  * limitations under the License.
  16.  */
  18. goog.provide('shaka.util.TextParser');
  20. goog.require('goog.asserts');
  24. /**
  25.  * Reads elements from strings.
  26.  *
  27.  * @param {string} data
  28.  * @constructor
  29.  * @struct
  30.  */
  31. shaka.util.TextParser = function(data) {
  32.   /**
  33.    * @const
  34.    * @private {string}
  35.    */
  36.   this.data_ = data;
  38.   /** @private {number} */
  39.   this.position_ = 0;
  40. };
  43. /** @return {boolean} Whether it is at the end of the string. */
  44. shaka.util.TextParser.prototype.atEnd = function() {
  45.   return this.position_ == this.data_.length;
  46. };
  49. /**
  50.  * Reads a line from the parser.  This will read but not return the newline.
  51.  * Returns null at the end.
  52.  *
  53.  * @return {?string}
  54.  */
  55. shaka.util.TextParser.prototype.readLine = function() {
  56.   return this.readRegexReturnCapture_(/(.*?)(\n|$)/gm, 1);
  57. };
  60. /**
  61.  * Reads a word from the parser.  This will not read or return any whitespace
  62.  * before or after the word (including newlines).  Returns null at the end.
  63.  *
  64.  * @return {?string}
  65.  */
  66. shaka.util.TextParser.prototype.readWord = function() {
  67.   return this.readRegexReturnCapture_(/[^ \t\n]*/gm, 0);
  68. };
  71. /**
  72.  * Skips any continuous whitespace from the parser.  Returns null at the end.
  73.  */
  74. shaka.util.TextParser.prototype.skipWhitespace = function() {
  75.   this.readRegex(/[ \t]+/gm);
  76. };
  79. /**
  80.  * Reads the given regular expression from the parser.  This requires the match
  81.  * to be at the current position; there is no need to include a head anchor.
  82.  * This requires that the regex have the global flag to be set so that it can
  83.  * set lastIndex to start the search at the current position.  Returns null at
  84.  * the end or if the regex does not match the current position.
  85.  *
  86.  * @param {!RegExp} regex
  87.  * @return {Array.<string>}
  88.  */
  89. shaka.util.TextParser.prototype.readRegex = function(regex) {
  90.   var index = this.indexOf_(regex);
  91.   if (this.atEnd() || index == null || index.position != this.position_)
  92.     return null;
  94.   this.position_ += index.length;
  95.   return index.results;
  96. };
  99. /**
  100.  * Reads a regex from the parser and returns the given capture.
  101.  *
  102.  * @param {!RegExp} regex
  103.  * @param {number} index
  104.  * @return {?string}
  105.  * @private
  106.  */
  107. shaka.util.TextParser.prototype.readRegexReturnCapture_ =
  108.     function(regex, index) {
  109.   if (this.atEnd())
  110.     return null;
  112.   var ret = this.readRegex(regex);
  113.   if (!ret)
  114.     return null;
  115.   else
  116.     return ret[index];
  117. };
  120. /**
  121.  * Returns the index info about a regular expression match.
  122.  *
  123.  * @param {!RegExp} regex
  124.  * @return {?{position: number, length: number, results: !Array.<string>}}
  125.  * @private
  126.  */
  127. shaka.util.TextParser.prototype.indexOf_ = function(regex) {
  128.   // The global flag is required to use lastIndex.
  129.   goog.asserts.assert(regex.global, 'global flag should be set');
  131.   regex.lastIndex = this.position_;
  132.   var results = regex.exec(this.data_);
  133.   if (results == null)
  134.     return null;
  135.   else
  136.     return {
  137.       position: results.index,
  138.       length: results[0].length,
  139.       results: results
  140.     };
  141. };