Function that will check wether a string is correctly formatted to be converted (casted) to a key.
// Check if a string is convertable to a key.
// Produced by Logic Scripted Products and Script Services
// Flennan Roffo
// (c) 2007 - Flennan Roffo, Logic Scripted Products and Script Services
integer IsValidKeyFormat(string str)
{
string keychars = "0123456789abcdef";
if (llStringLength(str) != 36)
return FALSE;
if ( (llGetSubString( str, 8, 8 ) != "-" ||
llGetSubString( str, 13, 13 ) != "-" ||
llGetSubString( str, 18, 18 ) != "-" ||
llGetSubString( str, 23, 23 ) != "-" ) )
return FALSE;
integer i;
for (i = 0; i < 8; ++i)
{
if (llSubStringIndex(keychars, llGetSubString(str,i,i)) == -1)
return FALSE;
}
for (i = 9; i < 13; ++i)
{
if (llSubStringIndex(keychars, llGetSubString(str,i,i)) == -1)
return FALSE;
}
for (i = 14; i < 18; ++i)
{
if (llSubStringIndex(keychars, llGetSubString(str,i,i)) == -1)
return FALSE;
}
for (i = 19; i < 23; ++i)
{
if (llSubStringIndex(keychars, llGetSubString(str,i,i)) == -1)
return FALSE;
}
for (i = 24; i < 36; ++i)
{
if (llSubStringIndex(keychars, llGetSubString(str,i,i)) == -1)
return FALSE;
}
return TRUE;
}
Actually any string is convertable to a key, even if it would result in an invalid key.
You can check if a string is in a valid key format in a faster and byte saving way like this :
integer IsValidKeyFormat(string str)
{
key str_key = (key)str;
if(str_key)
{
return TRUE;
}
else return FALSE; //will also return FALSE when NULL_KEY is passed (even the null key is valid formatted too) -one could think of a workaround tough-
}
Or this way to take in to account when NULL_KEY is passed:
string null_key = NULL_KEY;
integer isKey(key in)
{//by: Strife Onizuka
if(in) return 2; // key is valid AND not equal NULL_KEY; the distinction is important in some cases (return value of 2 is still evaluated as unary boolean TRUE)
return (in == null_key); // key is valid AND equal to NULL_KEY (return 1 or TRUE), or is not valid (return 0 or FALSE)
}
Examples