/** * @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'); /** * @namespace shaka.util.Uint8ArrayUtils * @export * @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} */ 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; }; /** * Convert a Uint8Array to a string which can be used as a key in a dictionary. * @param {!Uint8Array} arr * @return {string} */ shaka.util.Uint8ArrayUtils.key = function(arr) { return Array.prototype.join.apply(arr); };