Funkce v COMEX
Funkce umístěné ve jmenném prostoru COMEX.
Funkce apply
Provede pro všechny prvky pole / vlastnosti objektu definovanou funkcionalitu.
typ: function; celé jméno: COMEX.apply;
Parametry:
$collection
● hodnota typu Object
kolekce (pole nebo objekt)
● hodnota typu mixed[ mixed ]
$function
● hodnota typu function
funkcionalita, která má být provedena
Vrací:
bez návratové hodnoty
( umístěno v souboru /comex/scripts/comex.js )
Funkce capsFirst
Převede první písmeno řetězce na velké.
typ: function; celé jméno: COMEX.capsFirst;
Parametry:
$string
● hodnota typu String
řetězec
Vrací:
převedený řetězec
var $rslt = COMEX.capsFirst( "capitalize first letter in string" );
( umístěno v souboru /comex/scripts/comex.js )
Funkce capsFrom
Převede první písmena slov (od určené délky) na velká.
typ: function; celé jméno: COMEX.capsFrom;
Možné výjimky:
COMEX.Exceptions.MismatchException
COMEX.Exceptions.RangeException
Parametry:
$string
● hodnota typu String
řetězec
$length
● hodnota typu Integer (výchozí: 4)
minimální délka slova, které se má převádět (minimálně 1)
Vrací:
převedený řetězec
var $rslt = COMEX.capsFrom( "capitalize all words longer than specified length", 5 );
( umístěno v souboru /comex/scripts/comex.js )
Funkce ceil
Zaokrouhlí číslo směrem nahoru na požadovaný počet desetinných míst.
Záporné číslo zaokrouhluje na celé desítky, stovky, ...
typ: function; celé jméno: COMEX.ceil;
Možné výjimky:
COMEX.Exceptions.MismatchException
COMEX.Exceptions.RangeException
Parametry:
$number
● hodnota typu Number
zaokrouhlované číslo
$precision
● hodnota typu Integer (výchozí: 0)
počet desetinných míst (rozsah od -16 do 16)
Vrací:
zaokrouhlené číslo
null při chybě
var $rslt = COMEX.ceil( 1234.51, 1 );
( umístěno v souboru /comex/scripts/comex.js )
Funkce coalesce
Vrátí hodnotu prvního argumentu, který není null nebo undefined.
typ: function; celé jméno: COMEX.coalesce;
Parametry:
$var1
● hodnota typu mixed
proměnná 1
$var2
● hodnota typu mixed (výchozí: null)
proměnná 2
$var3
● hodnota typu mixed (výchozí: null)
proměnná 3
$var4
● hodnota typu mixed (výchozí: null)
proměnná 4
$var5
● hodnota typu mixed (výchozí: null)
proměnná 5
$var6
● hodnota typu mixed (výchozí: null)
proměnná 6
$var7
● hodnota typu mixed (výchozí: null)
proměnná 7
$var8
● hodnota typu mixed (výchozí: null)
proměnná 8
Vrací:
hodnota argumentu, který není null nebo undefined
null, pokud nebyla nalezena žádná hodnota, která není null nebo undefined
var $rslt = COMEX.coalesce(null, COMEX.undefinedProperty, COMEX.version);
( umístěno v souboru /comex/scripts/comex.js )
Funkce combine
Zkombinuje pole klíčů a pole hodnot.
typ: function; celé jméno: COMEX.combine;
Možné výjimky:
COMEX.Exceptions.MismatchException
Parametry:
$keys
● hodnota typu mixed[ mixed ]
pole klíčů
$values
● hodnota typu mixed[ mixed ]
pole hodnot
Vrací:
zkombinované pole
null při chybě
var $keys = ( "KEYS" ).split("");
var $values = [ 1, 22, 333, 4444 ];
var $rslt = COMEX.combine( $keys, $values );
( umístěno v souboru /comex/scripts/comex.js )
Funkce cut
Vrátí podřetězec požadované délky.
typ: function; celé jméno: COMEX.cut;
Možné výjimky:
COMEX.Exceptions.MismatchException
COMEX.Exceptions.RangeException
Parametry:
$string
● hodnota typu String
řetězec
$from
● hodnota typu Integer
počátek podřetězce (je-li použito záporné číslo, počítá se počátek podřetězce od konce)
$length
● hodnota typu Integer (výchozí: $string.length)
délka podřetězce (je-li použito záporné číslo, počítá se konec podřetězce od konce řetězce)
Vrací:
podřetězec
null při chybě
var $rslt = [];
$rslt.push( COMEX.cut( "SUBSTR", 0, -1 ) );
$rslt.push( COMEX.cut( "SUBSTR", 2 ) );
$rslt.push( COMEX.cut( "SUBSTR", -4 ) );
$rslt.push( COMEX.cut( "SUBSTR", -4, -1 ) );
( umístěno v souboru /comex/scripts/comex.js )
Funkce decHex
Převede číslo z decimálního do hexadecimálního tvaru.
typ: function; celé jméno: COMEX.decHex;
Možné výjimky:
COMEX.Exceptions.MismatchException
Parametry:
$dec
● hodnota typu Integer
převáděné číslo
Vrací:
převedené číslo
null při chybě
var $rslt = COMEX.decHex( 255 );
( umístěno v souboru /comex/scripts/comex.js )
Funkce dump
Vrátí dump proměnné.
Viz metoda COMEX.Debugger.dump.
typ: function; celé jméno: COMEX.dump;
Parametry:
$var
● hodnota typu mixed
proměnná
Vrací:
dump proměnné
( umístěno v souboru /comex/scripts/comex.js )
Funkce flip
Prohodí klíče a hodnoty prvků pole.
typ: function; celé jméno: COMEX.flip;
Možné výjimky:
COMEX.Exceptions.MismatchException
Parametry:
$array
● hodnota typu mixed[ mixed ]
pole
Vrací:
upravené pole
null při chybě
var $rslt = COMEX.flip( [ 1, 22, 333, 4444, 55555 ] );
( umístěno v souboru /comex/scripts/comex.js )
Funkce floor
Zaokrouhlí číslo směrem dolů na požadovaný počet desetinných míst.
Záporné číslo zaokrouhluje na celé desítky, stovky, ...
typ: function; celé jméno: COMEX.floor;
Možné výjimky:
COMEX.Exceptions.MismatchException
COMEX.Exceptions.RangeException
Parametry:
$number
● hodnota typu Number
zaokrouhlované číslo
$precision
● hodnota typu Integer (výchozí: 0)
počet desetinných míst (rozsah od -16 do 16)
Vrací:
zaokrouhlené číslo
null při chybě
var $rslt = COMEX.floor( 1234.59, 1 );
( umístěno v souboru /comex/scripts/comex.js )
Funkce format
Naformátuje číslo.
typ: function; celé jméno: COMEX.format;
Možné výjimky:
COMEX.Exceptions.MismatchException
COMEX.Exceptions.RangeException
Parametry:
$number
● hodnota typu Number
formátované číslo
$precision
● hodnota typu Integer (výchozí: 0)
počet desetinných míst (rozsah od 0 do 16)
$tsep
● hodnota typu String (výchozí: mezera)
oddělovač tisíců
$dsep
● hodnota typu String (výchozí: ',')
oddělovač destinné části
Vrací:
naformátované číslo
null při chybě
var $rslt = COMEX.format( 1234567.89, 3, "_" );
( umístěno v souboru /comex/scripts/comex.js )
Funkce fromBase64
Převede řetězec z Base64.
typ: function; celé jméno: COMEX.fromBase64;
Parametry:
$string
● hodnota typu String
převáděný řetězec
Vrací:
převedený řetězec
var $rslt = COMEX.fromBase64( "QkFTRTY0" );
( umístěno v souboru /comex/scripts/comex.js )
Funkce fromUTF8
Převede řetězec z UTF-8.
typ: function; celé jméno: COMEX.fromUTF8;
Parametry:
$string
● hodnota typu String
převáděný řetězec
Vrací:
převedený řetězec
var $rslt = [];
$rslt.push( COMEX.toUTF8( "ěščřžýáíé" ) );
$rslt.push( COMEX.fromUTF8( $rslt[0] ) );
( umístěno v souboru /comex/scripts/comex.js )
Funkce hexDec
Převede číslo z hexadecimálního do decimálního tvaru.
typ: function; celé jméno: COMEX.hexDec;
Možné výjimky:
COMEX.Exceptions.MismatchException
Parametry:
$hex
● hodnota typu String
převáděné číslo
Vrací:
převedené číslo
null při chybě
var $rslt = COMEX.hexDec( "FF" );
( umístěno v souboru /comex/scripts/comex.js )
Funkce is
Vrátí datový typ proměnné.
typ: function; celé jméno: COMEX.is;
Parametry:
$var
● hodnota typu mixed
testovaná proměnná
Vrací:
datový typ proměnné
● undefined - nedefinovaná proměnná
● null - null
● boolean - true / false
● number - číslo (zahrnuje NaN a Infinite)
● string - řetězec
● array - pole hodnot
● function - funkce / metoda objektu
● object - objekt
var $rslt = [];
$rslt.push( COMEX.is( COMEX.demo ) );
$rslt.push( COMEX.is( null ) );
$rslt.push( COMEX.is( true ) );
$rslt.push( COMEX.is( 123.45 ) );
$rslt.push( COMEX.is( "STRING" ) );
$rslt.push( COMEX.is( [1, 3, 5, 7] ) );
$rslt.push( COMEX.is( COMEX.is ) );
$rslt.push( COMEX.is( COMEX ) );
( umístěno v souboru /comex/scripts/comex.js )
Funkce isArr
Ověří, zda je proměnná pole.
typ: function; celé jméno: COMEX.isArr;
Parametry:
$var
● hodnota typu mixed
testovaná proměnná
Vrací:
true, pokud je proměnná pole, jinak false
var $rslt = [];
$rslt.push( COMEX.isArr( new Array( 6, 7, 8 ) ) );
$rslt.push( COMEX.isArr( [ 6, 7, 8 ] ) );
$rslt.push( COMEX.isArr( { a: 6, b: 7, c: 8 } ) );
( umístěno v souboru /comex/scripts/comex.js )
Funkce isBool
Ověří, zda je proměnná booleanovského typu.
typ: function; celé jméno: COMEX.isBool;
Parametry:
$var
● hodnota typu mixed
testovaná proměnná
Vrací:
true, pokud je proměnná booleanovského typu, jinak false
var $rslt = [];
$rslt.push( COMEX.isBool( COMEX.lang ) );
$rslt.push( COMEX.isBool( true ) );
( umístěno v souboru /comex/scripts/comex.js )
Funkce isDbl
Ověří, zda je proměnná desetinné číslo (vylučuje NaN a Infinity).
Z hlediska JavaScriptu není za desetinné číslo považováno číslo s nulovou hodnotou v desetinné části čísla.
typ: function; celé jméno: COMEX.isDbl;
Parametry:
$var
● hodnota typu mixed
testovaná proměnná
Vrací:
true, pokud je proměnná desetinné číslo, jinak false
var $rslt = [];
$rslt.push( COMEX.isDbl( 1234.56 ) );
$rslt.push( COMEX.isDbl( 1234.0 ) );
( umístěno v souboru /comex/scripts/comex.js )
Funkce isDef
Ověří, zda je proměnná definovaná.
typ: function; celé jméno: COMEX.isDef;
Parametry:
$var
● hodnota typu mixed
testovaná proměnná
Vrací:
true, pokud je proměnná definovaná, jinak false
var $rslt = [];
$rslt.push( COMEX.isDef( COMEX.demo ) );
$rslt.push( COMEX.isDef( COMEX.lang ) );
( umístěno v souboru /comex/scripts/comex.js )
Funkce isEmpty
Ověří, zda je proměnná prázdná, je tedy null, prázdný řetězec nebo undefined.
typ: function; celé jméno: COMEX.isEmpty;
Parametry:
$var
● hodnota typu mixed
testovaná proměnná
Vrací:
true, pokud je proměnná prázdná, jinak false
var $rslt = [];
$rslt.push( COMEX.isEmpty( COMEX.demo ) );
$rslt.push( COMEX.isEmpty( COMEX.lang ) );
( umístěno v souboru /comex/scripts/comex.js )
Funkce isFilled
Ověří, zda má proměnná hodnotu a není null, prázdný řetězec nebo undefined.
typ: function; celé jméno: COMEX.isFilled;
Parametry:
$var
● hodnota typu mixed
testovaná proměnná
Vrací:
true, pokud má proměnná hodnotu, jinak false
var $rslt = [];
$rslt.push( COMEX.isFilled( COMEX.demo ) );
$rslt.push( COMEX.isFilled( COMEX.lang ) );
( umístěno v souboru /comex/scripts/comex.js )
Funkce isFunc
Ověří, zda je proměnná funkce.
typ: function; celé jméno: COMEX.isFunc;
Parametry:
$var
● hodnota typu mixed
testovaná proměnná
Vrací:
true, pokud je proměnná funkce, jinak false
var $rslt = [];
$rslt.push( COMEX.isFunc( COMEX.isFunc ) );
$rslt.push( COMEX.isFunc( COMEX.lang ) );
( umístěno v souboru /comex/scripts/comex.js )
Funkce isInst
Ověří, zda je proměnná instancí konkrétní třídy.
typ: function; celé jméno: COMEX.isInst;
Parametry:
$var
● hodnota typu mixed
testovaná proměnná
$class
● hodnota typu Object
testovaná třída
Vrací:
true, pokud je proměnná instancí třídy, jinak false
var $rslt = COMEX.isInst( COMEX, Object );
( umístěno v souboru /comex/scripts/comex.js )
Funkce isInt
Ověří, zda je proměnná celé číslo (vylučuje NaN a Infinity).
Z hlediska JavaScriptu je za celé číslo považováno i desetinné číslo s nulovou hodnotou v desetinné části čísla.
typ: function; celé jméno: COMEX.isInt;
Parametry:
$var
● hodnota typu mixed
testovaná proměnná
Vrací:
true, pokud je proměnná celé číslo, jinak false
var $rslt = [];
$rslt.push( COMEX.isInt( 1234.56 ) );
$rslt.push( COMEX.isInt( 1234.0 ) );
( umístěno v souboru /comex/scripts/comex.js )
Funkce isNum
Ověří, zda je proměnná číslo (vylučuje NaN a Infinity).
typ: function; celé jméno: COMEX.isNum;
Parametry:
$var
● hodnota typu mixed
testovaná proměnná
Vrací:
true, pokud je proměnná číslo, jinak false
var $rslt = [];
$rslt.push( COMEX.isNum( 1234.56 ) );
$rslt.push( COMEX.isNum( 1234.56 * "x") ); // NaN
$rslt.push( COMEX.isNum( 1234.56 / 0 ) ); // Infinity
( umístěno v souboru /comex/scripts/comex.js )
Funkce isObj
Ověří, zda je proměnná objekt.
typ: function; celé jméno: COMEX.isObj;
Parametry:
$var
● hodnota typu mixed
testovaná proměnná
Vrací:
true, pokud je proměnná objekt, jinak false
var $rslt = COMEX.isObj( COMEX );
( umístěno v souboru /comex/scripts/comex.js )
Funkce isStr
Ověří, zda je proměnná řetězec.
typ: function; celé jméno: COMEX.isStr;
Parametry:
$var
● hodnota typu mixed
testovaná proměnná
Vrací:
true, pokud je proměnná řetězec, jinak false
var $rslt = COMEX.isStr( "STRING" );
( umístěno v souboru /comex/scripts/comex.js )
Funkce join
Vrátí řetězec sloučený dle oddělovače.
typ: function; celé jméno: COMEX.join;
Možné výjimky:
COMEX.Exceptions.MismatchException
Parametry:
$parts
● hodnota typu String[ mixed ]
pole částí řetězce
$glue
● hodnota typu String
oddělovač
Vrací:
sloučený řetězec
null při chybě
var $rslt = COMEX.join( COMEX.split( "JOIN", "" ), "-" );
( umístěno v souboru /comex/scripts/comex.js )
Funkce keys
Vrátí pole klíčů.
typ: function; celé jméno: COMEX.keys;
Možné výjimky:
COMEX.Exceptions.MismatchException
Parametry:
$array
● hodnota typu mixed[ mixed ]
pole
Vrací:
pole klíčů
null při chybě
var $array = [];
$array[ "K" ] = 0;
$array[ "E" ] = 1;
$array[ "Y" ] = 2;
$array[ "S" ] = 3;
var $rslt = COMEX.keys( $array );
( umístěno v souboru /comex/scripts/comex.js )
Funkce keySort
Seřadí pole vzestupně podle klíčů.
typ: function; celé jméno: COMEX.keySort;
Možné výjimky:
COMEX.Exceptions.MismatchException
Parametry:
$array
● hodnota typu mixed[ mixed ]
pole
$sortFuncHandler
● hodnota typu function (výchozí: undefined)
funkce pro seřazení klíčů
Vrací:
seřazené pole
null při chybě
var $keys = ( "KEYS" ).split("");
var $values = [ 1, 22, 333, 4444 ];
var $array = COMEX.combine( $keys, $values );
var $rslt = COMEX.keySort( $array );
( umístěno v souboru /comex/scripts/comex.js )
Funkce lower
Převede řetězec na malá písmena.
typ: function; celé jméno: COMEX.lower;
Parametry:
$string
● hodnota typu String
řetězec
Vrací:
převedený řetězec
var $rslt = COMEX.lower( "LOWER" );
( umístěno v souboru /comex/scripts/comex.js )
Funkce match
Vyhodnotí řetězcově výskyt výrazu/ů.
typ: function; celé jméno: COMEX.match;
Parametry:
$string
● hodnota typu String
prohledávaný řetězec
$search
● hodnota typu String
hledaný výraz
● hodnota typu String[ mixed ]
pole hledaných výrazů
Vrací:
true, pokud je nalezen alespoň jeden výskyt výrazu (u pole výrazů musí být nalezen alespoň jeden výskyt každého výrazu), jinak false
var $rslt = [];
$rslt.push( COMEX.match( "MATCH", "ma" ) );
$rslt.push( COMEX.match( "MATCH", "MA" ) );
$rslt.push( COMEX.match( "MATCH", [ "MA", "TC" ] ) );
$rslt.push( COMEX.match( "MATCH", [ "MA", "CT" ] ) );
( umístěno v souboru /comex/scripts/comex.js )
Funkce matchR
Vyhodnotí regulárně výskyt výrazu.
typ: function; celé jméno: COMEX.matchR;
Parametry:
$string
● hodnota typu String
prohledávaný řetězec
$search
● hodnota typu RegExp
hledaný regulární výraz
● hodnota typu String
textová reprezentace hledaného regulárního výrazu
$sensitive
● hodnota typu Boolean (výchozí: false)
true, pokud má být rozlišovaná velikost písmen, jinak false
Vrací:
true, pokud je nalezen alespoň jeden výskyt výrazu, jinak false
var $rslt = [];
$rslt.push( COMEX.matchR( "MATCH", /ma/ ) );
$rslt.push( COMEX.matchR( "MATCH", "M" + "A" ) );
$rslt.push( COMEX.matchR( "MATCH", /ma/, true ) );
( umístěno v souboru /comex/scripts/comex.js )
Funkce md5
Vytvoří MD5 hash řetězce.
typ: function; celé jméno: COMEX.md5;
Parametry:
$string
● hodnota typu String
řetězec
Vrací:
MD5 hash
var $rslt = COMEX.md5( "MD5" );
( umístěno v souboru /comex/scripts/comex.js )
Funkce power
Umocní číslo.
typ: function; celé jméno: COMEX.power;
Možné výjimky:
COMEX.Exceptions.MismatchException
Parametry:
$base
● hodnota typu Number
mocněnec
$exponent
● hodnota typu Number
mocnitel
Vrací:
mocnina čísla
null při chybě
var $rslt = COMEX.power( 2, 8 );
( umístěno v souboru /comex/scripts/comex.js )
Funkce rand
Vrátí náhodně vygenerované číslo.
typ: function; celé jméno: COMEX.rand;
Možné výjimky:
COMEX.Exceptions.MismatchException
Parametry:
$min
● hodnota typu Integer (výchozí: 0)
minimum
$max
● hodnota typu Integer (výchozí: 2147483647)
maximum
Vrací:
náhodně vygenerované číslo
null při chybě
var $rslt = COMEX.rand( 0, 9999 );
( umístěno v souboru /comex/scripts/comex.js )
Funkce remCtrl
Odstraní z hodnoty kontrolní znaky kromě CRLF, CRLF nahradí pouze LF.
typ: function; celé jméno: COMEX.remCtrl;
Parametry:
$string
● hodnota typu String
řetězec
Vrací:
upravený řetězec
var $rslt = COMEX.remCtrl( "CONTROL\t\b\r\nCHARS" );
( umístěno v souboru /comex/scripts/comex.js )
Funkce replace
Nahradí řetězcově hledaný výraz/y.
typ: function; celé jméno: COMEX.replace;
Parametry:
$string
● hodnota typu String
prohledávaný řetězec
$search
● hodnota typu String
nahrazovaný výraz
● hodnota typu String[ mixed ]
pole nahrazovaných výrazů
$replace
● hodnota typu String
náhrada
● hodnota typu String[ mixed ]
pole náhrad
$global
● hodnota typu Boolean (výchozí: true)
true, pokud mají být nahrazeny všechny výskyty, jinak false
Vrací:
upravený řetězec
var $rslt = [];
$rslt.push( COMEX.replace( "REPLACE", "e", "*" ) );
$rslt.push( COMEX.replace( "REPLACE", "E", "e" ) );
$rslt.push( COMEX.replace( "REPLACE", [ "RE", "LA" ], " * " ) );
$rslt.push( COMEX.replace( "REPLACE.REPLACE", [ "RE", "LA" ], [ "re", "la" ] ) );
$rslt.push( COMEX.replace( "REPLACE.REPLACE", [ "RE", "LA" ], [ "re", "la" ] , false) );
( umístěno v souboru /comex/scripts/comex.js )
Funkce replaceR
Nahradí regulárně hledaný výraz.
typ: function; celé jméno: COMEX.replaceR;
Možné výjimky:
COMEX.Exceptions.MismatchException
Parametry:
$string
● hodnota typu String
prohledávaný řetězec
$search
● hodnota typu RegExp
nahrazovaný regulární výraz
● hodnota typu String
textová reprezentace nahrazovaného regulárního výrazu
$replace
● hodnota typu String
náhrada
$sensitive
● hodnota typu Boolean (výchozí: false)
true, pokud má být rozlišovaná velikost písmen, jinak false
$global
● hodnota typu Boolean (výchozí: true)
true, pokud mají být nahrazeny všechny výskyty, jinak false
Vrací:
upravený řetězec
null při chybě
var $rslt = [];
$rslt.push( COMEX.replaceR( "REPLACE", "ep", "*" ) );
$rslt.push( COMEX.replaceR( "REPLACE", /[a-z]/, "*" ) );
$rslt.push( COMEX.replaceR( "REPLACE", /ep/, "*", true ) );
$rslt.push( COMEX.replaceR( "REPLACE.REPLACE", /.e/, "_e", false ) );
$rslt.push( COMEX.replaceR( "REPLACE.REPLACE", /.e/, "_e", false, false ) );
( umístěno v souboru /comex/scripts/comex.js )
Funkce reverse
Otočí pořadí prvků pole při zachování vazeb mezi klíči a hodnotami, nebo otočí pořadí znaků v řetězci.
typ: function; celé jméno: COMEX.reverse;
Parametry:
$value
● hodnota typu mixed[ mixed ]
pole
● hodnota typu String
řetězec
Vrací:
otočené pole
otočený řetězec
var $array = [];
$array["R"] = 12;
$array["E"] = 34;
$array["V"] = 56;
$array["S"] = 78;
var $rslt = COMEX.reverse( $array );
$rslt["str"] = COMEX.reverse( "REVERSE" );
( umístěno v souboru /comex/scripts/comex.js )
Funkce round
Zaokrouhlí číslo na požadovaný počet desetinných míst (záporné číslo zaokrouhluje na celé desítky, stovky, ...).
typ: function; celé jméno: COMEX.round;
Možné výjimky:
COMEX.Exceptions.MismatchException
COMEX.Exceptions.RangeException
Parametry:
$number
● hodnota typu Number
zaokrouhlované číslo
$precision
● hodnota typu Integer (výchozí: 0)
počet desetinných míst (rozsah od -16 do 16)
Vrací:
zaokrouhlené číslo
null při chybě
var $rslt = COMEX.round( 1234.56, 1 );
( umístěno v souboru /comex/scripts/comex.js )
Funkce search
Najde prvek s odpovídající hodnotou a vrátí jeho klíč.
typ: function; celé jméno: COMEX.search;
Možné výjimky:
COMEX.Exceptions.MismatchException
Parametry:
$array
● hodnota typu mixed[ mixed ]
pole
$value
● hodnota typu mixed
hledaná hodnota
Vrací:
klíč odpovídajícího prvku
null, pokud neodpovídá žádný prvek
var $array = [ "12", "34", "56", "78", "90" ];
var $rslt = [];
$rslt.push( COMEX.search( $array, 56 ) );
$rslt.push( COMEX.search( $array, "56" ) );
( umístěno v souboru /comex/scripts/comex.js )
Funkce size
Vrátí počet znaků u řetězce, počet prvků u pole, počet veřejných členských proměnných u objektu.
typ: function; celé jméno: COMEX.size;
Parametry:
$value
● hodnota typu Object
hodnota
● hodnota typu mixed[ mixed ]
● hodnota typu String
Vrací:
počet znaků / prvků / proměnných
var $rslt = [];
$rslt.push( COMEX.size( "SIZE-SIZE" ) );
$rslt.push( COMEX.size( COMEX ) );
$rslt.push( COMEX.size( ( "SIZE" ).split("") ) );
( umístěno v souboru /comex/scripts/comex.js )
Funkce split
Vrátí řetězec rozdělený dle oddělovače.
typ: function; celé jméno: COMEX.split;
Parametry:
$string
● hodnota typu String
řetězec
$separator
● hodnota typu String
oddělovač
Vrací:
pole částí řetězce
var $rslt = COMEX.split( "SPLIT", "" );
( umístěno v souboru /comex/scripts/comex.js )
Funkce sum
Vrátí sumu hodnot prvků pole.
typ: function; celé jméno: COMEX.sum;
Možné výjimky:
COMEX.Exceptions.MismatchException
Parametry:
$array
● hodnota typu Number[ mixed ]
pole
Vrací:
suma hodnot prvků pole
null, pokud není suma číslo
var $rslt = COMEX.sum( [12.3,34.5,56.7] );
( umístěno v souboru /comex/scripts/comex.js )
Funkce toBase64
typ: function; celé jméno: COMEX.toBase64;
Parametry:
$string
● hodnota typu String
převáděný řetězec
Vrací:
převedený řetězec
var $rslt = COMEX.toBase64( "BASE64" );
( umístěno v souboru /comex/scripts/comex.js )
Funkce toUTF8
Převede řetězec na UTF-8.
typ: function; celé jméno: COMEX.toUTF8;
Parametry:
$string
● hodnota typu String
převáděný řetězec
Vrací:
převedený řetězec
var $rslt = [];
$rslt.push( COMEX.toUTF8( "ěščřžýáíé" ) );
$rslt.push( COMEX.fromUTF8( $rslt[0] ) );
( umístěno v souboru /comex/scripts/comex.js )
Funkce trim
Ořízne oboustranně řetězec o bílé znaky.
typ: function; celé jméno: COMEX.trim;
Parametry:
$string
● hodnota typu String
řetězec
Vrací:
oříznutý řetězec
var $rslt = COMEX.trim( " \t TRIM \n " );
( umístěno v souboru /comex/scripts/comex.js )
Funkce unify
Převede řetězec na unifikovaný tvar (pouze malá písmenena bez diakritiky a čísla oddělená pomlčkami).
typ: function; celé jméno: COMEX.unify;
Parametry:
$unified
● hodnota typu String
převáděný řetězec
● hodnota typu String[ mixed ]
pole převáděných řetězců
Vrací:
převedený řetězec
pole převedených řetězců
var $rslt = COMEX.unify( " - UNI~$^&fied*()string---ěščřžýáíé / " );
( umístěno v souboru /comex/scripts/comex.js )
Funkce unique
Vytvoří pole s unikátními hodnotami při zachování vazeb klíčů.
typ: function; celé jméno: COMEX.unique;
Možné výjimky:
COMEX.Exceptions.MismatchException
Parametry:
$array
● hodnota typu mixed[ mixed ]
pole
Vrací:
pole unikátních hodnot
null při chybě
var $array = [];
$array["U"] = 22;
$array["N"] = 1;
$array["I"] = 333;
$array["Q"] = 1;
$array["U"] = 55555;
$array["E"] = 333;
$array["u"] = 22;
$array["n"] = 333;
$array["i"] = 1;
$array["q"] = 4444;
var $rslt = COMEX.unique( $array );
( umístěno v souboru /comex/scripts/comex.js )
Funkce upper
Převede řetězec na velká písmena.
typ: function; celé jméno: COMEX.upper;
Parametry:
$string
● hodnota typu String
řetězec
Vrací:
převedený řetězec
var $rslt = COMEX.upper( "upper" );
( umístěno v souboru /comex/scripts/comex.js )
Funkce vals
Vrátí pole hodnot.
typ: function; celé jméno: COMEX.vals;
Možné výjimky:
COMEX.Exceptions.MismatchException
Parametry:
$array
● hodnota typu mixed[ mixed ]
pole
Vrací:
pole hodnot
null při chybě
var $rslt = COMEX.vals( ( "VALUES" ).split( "" ) );
( umístěno v souboru /comex/scripts/comex.js )
Funkce valSort
Seřadí prvky vzestupně podle hodnot při zachování vazeb klíčů.
typ: function; celé jméno: COMEX.valSort;
Možné výjimky:
COMEX.Exceptions.MismatchException
Parametry:
$array
● hodnota typu mixed[ mixed ]
pole
$sortFuncHandler
● hodnota typu function (výchozí: undefined)
funkce pro seřazení hodnot
Vrací:
seřazené pole
null při chybě
var $keys = ( "KEYS" ).split("");
var $values = [ 11111, 2222, 3, 444 ];
var $array = COMEX.combine( $keys, $values );
var $rslt = COMEX.valSort( $array );
( umístěno v souboru /comex/scripts/comex.js )