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

example
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

example
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ě

example
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

example
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ě

example
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ě

example
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ě

example
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ě

example
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ě

example
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ě

example
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

example
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

example
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ě

example
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

example
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

example
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

example
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

example
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

example
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

example
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

example
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

example
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

example
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

example
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

example
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

example
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

example
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ě

example
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ě

example
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ě

example
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

example
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

example
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

example
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

example
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ě

example
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ě

example
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

example
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

example
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ě

example
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

example
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ě

example
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

example
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

example
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

example
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

example
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

example
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

example
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

example
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ů

example
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ě

example
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

example
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ě

example
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ě

example
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 )


Vlastnosti v COMEXFunkce v COMEXMetody v COMEXTřídy v COMEXVnořené prostory v COMEXGlobální funkce