mirror of
https://github.com/shaka-project/shaka-player.git
synced 2026-06-15 16:06:41 +03:00
Joey Parrish
fff5dd7ee7
This changes namespace exports to the more targetted exportDoc, adds exports where they are needed and removes them where they are not. Exporting of Uint8Array and String utils should be re-evaluated later. Change-Id: I9298e73a0a5ef026b6f2b1854488d2c359be10c1
134 lines
3.2 KiB
JavaScript
134 lines
3.2 KiB
JavaScript
/**
|
|
* @license
|
|
* Copyright 2015 Google Inc.
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
goog.provide('shaka.util.Uint8ArrayUtils');
|
|
|
|
goog.require('shaka.util.StringUtils');
|
|
|
|
|
|
// TODO: re-evaluate exporting these once Player 2.0 is complete
|
|
/**
|
|
* @namespace shaka.util.Uint8ArrayUtils
|
|
* @exportDoc
|
|
* @summary A set of Uint8Array utility functions.
|
|
*/
|
|
|
|
|
|
/**
|
|
* Convert a Uint8Array to a raw string.
|
|
* @param {!Uint8Array} arr
|
|
* @return {string}
|
|
* @export
|
|
*/
|
|
shaka.util.Uint8ArrayUtils.toString = function(arr) {
|
|
return String.fromCharCode.apply(null, arr);
|
|
};
|
|
|
|
|
|
/**
|
|
* Convert a raw string to a Uint8Array.
|
|
* @param {string} str
|
|
* @return {!Uint8Array}
|
|
* @export
|
|
*/
|
|
shaka.util.Uint8ArrayUtils.fromString = function(str) {
|
|
var result = new Uint8Array(str.length);
|
|
for (var i = 0; i < str.length; ++i) {
|
|
result[i] = str.charCodeAt(i);
|
|
}
|
|
return result;
|
|
};
|
|
|
|
|
|
/**
|
|
* Convert a Uint8Array to a base64 string. The output will always use the
|
|
* alternate encoding/alphabet also known as "base64url".
|
|
* @param {!Uint8Array} arr
|
|
* @param {boolean=} opt_padding If true, pad the output with equals signs.
|
|
* Defaults to true.
|
|
* @return {string}
|
|
* @export
|
|
*/
|
|
shaka.util.Uint8ArrayUtils.toBase64 = function(arr, opt_padding) {
|
|
return shaka.util.StringUtils.toBase64(
|
|
shaka.util.Uint8ArrayUtils.toString(arr), opt_padding);
|
|
};
|
|
|
|
|
|
/**
|
|
* Convert a base64 string to a Uint8Array. Accepts either the standard
|
|
* alphabet or the alternate "base64url" alphabet.
|
|
* @param {string} str
|
|
* @return {!Uint8Array}
|
|
* @export
|
|
*/
|
|
shaka.util.Uint8ArrayUtils.fromBase64 = function(str) {
|
|
return shaka.util.Uint8ArrayUtils.fromString(
|
|
shaka.util.StringUtils.fromBase64(str));
|
|
};
|
|
|
|
|
|
/**
|
|
* Convert a hex string to a Uint8Array.
|
|
* @param {string} str
|
|
* @return {!Uint8Array}
|
|
* @export
|
|
*/
|
|
shaka.util.Uint8ArrayUtils.fromHex = function(str) {
|
|
var arr = new Uint8Array(str.length / 2);
|
|
for (var i = 0; i < str.length; i += 2) {
|
|
arr[i / 2] = window.parseInt(str.substr(i, 2), 16);
|
|
}
|
|
return arr;
|
|
};
|
|
|
|
|
|
/**
|
|
* Convert a Uint8Array to a hex string.
|
|
* @param {!Uint8Array} arr
|
|
* @return {string}
|
|
* @export
|
|
*/
|
|
shaka.util.Uint8ArrayUtils.toHex = function(arr) {
|
|
var hex = '';
|
|
for (var i = 0; i < arr.length; ++i) {
|
|
var value = arr[i].toString(16);
|
|
if (value.length == 1) value = '0' + value;
|
|
hex += value;
|
|
}
|
|
return hex;
|
|
};
|
|
|
|
|
|
/**
|
|
* Compare two Uint8Arrays for equality.
|
|
* @param {Uint8Array} arr1
|
|
* @param {Uint8Array} arr2
|
|
* @return {boolean}
|
|
* @export
|
|
*/
|
|
shaka.util.Uint8ArrayUtils.equal = function(arr1, arr2) {
|
|
if (!arr1 && !arr2) return true;
|
|
if (!arr1 || !arr2) return false;
|
|
if (arr1.length != arr2.length) return false;
|
|
for (var i = 0; i < arr1.length; ++i) {
|
|
if (arr1[i] != arr2[i]) return false;
|
|
}
|
|
return true;
|
|
};
|
|
|