util.js

来自「在线编辑器」· JavaScript 代码 · 共 131 行

/* ***** BEGIN LICENSE BLOCK *****
 * Version: MPL 1.1
 *
 * The contents of this file are subject to the Mozilla Public License
 * Version 1.1 (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.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS"
 * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied.
 * See the License for the specific language governing rights and
 * limitations under the License.
 *
 * The Original Code is Bespin.
 *
 * The Initial Developer of the Original Code is Mozilla.
 * Portions created by the Initial Developer are Copyright (C) 2009
 * the Initial Developer. All Rights Reserved.
 *
 * Contributor(s):
 *   Bespin Team ([e-mail])
 *
 * ***** END LICENSE BLOCK ***** */

dojo.provide("bespin.util.util");

// === Helpful Utilities ===
//
// We gotta keep some of the Prototype spirit around :)

// = queryToObject =
//
// While dojo.queryToObject() is mainly for URL query strings,
// this version allows to specify a seperator character

bespin.util.queryToObject = function(str, seperator) {
    var ret = {};
    var qp = str.split(seperator);
    var dec = decodeURIComponent;
    dojo.forEach(qp, function(item) {
    	if (item.length){
    		var parts = item.split("=");
    		var name = dec(parts.shift());
    		var val = dec(parts.join("="));
    		if (dojo.isString(ret[name])){
    			ret[name] = [ret[name]];
    		}
    		if (dojo.isArray(ret[name])){
    			ret[name].push(val);
    		} else {
    			ret[name] = val;
    		}
    	}
    });
    return ret;
}

// = endsWith =
//
// A la Prototype endsWith(). Takes a regex exclusing the '$' end marker
bespin.util.endsWith = function(str, end) {
    return str.match(new RegExp(end + "$"));
}

// = include =
//
// A la Prototype include().
bespin.util.include = function(array, item) {
    return dojo.indexOf(array, item) > -1;
}

// = include =
//
// A la Prototype last().
bespin.util.last = function(array) {
    if (dojo.isArray(array)) return array[array.length - 1];
}

// = shrinkArray =
//
// Knock off any undefined items from the end of an array
bespin.util.shrinkArray = function(array) {
    var newArray = [];
    
    var stillAtBeginning = true;
    dojo.forEach(array.reverse(), function(item) {
        if (stillAtBeginning && item == undefined) {
            return;
        }

        stillAtBeginning = false;
        
        newArray.push(item);
    });
    
    return newArray.reverse();
}

// = makeArray =
//
// {{number}} - The size of the new array to create
// {{character}} - The item to put in the array, defaults to ' '
bespin.util.makeArray = function(number, character) {
    if (number < 1) return []; // give us a normal number please!
    if (!character) character = ' ';
    
    var newArray = [];
    for (var i = 0; i < number; i++) {
        newArray.push(character);
    }
    return newArray;
}

// = leadingSpaces =
//
// Given a row, find the number of leading spaces.
// E.g. an array with the string "  aposjd" would return 2
//
// {{row}} - The row to hunt through
bespin.util.leadingSpaces = function(row) {
    var numspaces = 0;
    for (var i = 0; i < row.length; i++) {
        if (row[i] == ' ' || row[i] == '' || row[i] == undefined) {
            numspaces++;
        } else {
            return numspaces;
        }
    }
    return numspaces;
}