kernel_utility.php File Reference

Core utility functions that do not require a complete session. More...

Namespaces
namespace	Lwt

Functions
	get_version ()
	get_version_number ()
	tohtml ($s)
	showRequest ()
	get_execution_time ()
	get_setting_data ()
	remove_spaces ($s, $remove)
	get_mecab_path ($mecab_args='')
	find_latin_sentence_end ($matches, $noSentenceEnd)
	my_die ($text)
	quickMenu ()
	pageend ()
	echodebug ($var, $text)
	get_statuses ()
	str_replace_first ($needle, $replace, $haystack)
	annotation_to_json ($ann)
	getreq ($s)
	getsess ($s)
	url_base ()
	make_score_random_insert_update ($type)
	getsqlscoreformula ($method)

Detailed Description

Core utility functions that do not require a complete session.

Function Documentation

annotation_to_json()

annotation_to_json

(

$ann

)

Convert annotations in a JSON format.

Parameters

string

$ann

Annotations.

Returns

string A JSON-encoded version of the annotations

echodebug()

echodebug	(		$var,
			$text
	)

Debug function only.

Parameters

mixed	$var	A printable variable to debug
string	$text	Echoed text in HTML page

@global bool $debug This functions doesn't do anything is $debug is false.

find_latin_sentence_end()

find_latin_sentence_end	(		$matches,
			$noSentenceEnd
	)

Find end-of-sentence characters in a sentence using latin alphabet.

Parameters

string[]	$matches	All the matches from a capturing regex
string	$noSentenceEnd	If different from '', can declare that a string a not the end of a sentence.

Returns

string $matches[0] with ends of sentences marked with \t and \r.

get_execution_time()

get_execution_time

(

)

Get the time since the last call

Returns

float Time sonce last call

get_mecab_path()

get_mecab_path

(

$mecab_args = ''

)

Returns path to the MeCab application. MeCab can split Japanese text word by word

Parameters

string

$mecab_args

Arguments to add

Returns

null|string OS-compatible command

Since

2.3.1-fork Much more verifications added

get_setting_data()

get_setting_data

(

)

Reload $setting_data if necessary

Returns

array $setting_data

get_statuses()

get_statuses

(

)

Return an associative array of all possible statuses

Returns

array<int<1, 5>|98|99, array<string, string>> Statues, keys are 1, 2, 3, 4, 5, 98, 99. Values are associative arrays of keys abbr and name

get_version()

get_version

(

)

Return LWT version for humans

Version is hardcoded in this function. For instance 1.6.31 (October 03 2016)

@global bool $debug If true adds a red "DEBUG"

Returns

string Version number HTML-formatted

get_version_number()

get_version_number

(

)

Return a machine readable version number.

Returns

string Machine-readable version, for instance v001.006.031

getreq()

getreq

(

$s

)

Get a request when possible. Otherwise, return an empty string.

Parameters

string

$s

Request key

Returns

string Trimmed request or empty string

getsess()

getsess

(

$s

)

Get a session variable when possible. Otherwise, return an empty string.

Parameters

string

$s

Session variable key

Returns

string Trimmed sesseion variable or empty string

getsqlscoreformula()

getsqlscoreformula

(

$method

)

SQL formula for computing score.

Parameters

int

$method

Score for tomorrow (2), the day after it (3) or never (any value).

Returns

string SQL score coputation string

@psalm-return ' GREATEST(-125, CASE WHEN WoStatus > 5 THEN 100 WHEN WoStatus = 1 THEN ROUND(-7 * DATEDIFF(NOW(),WoStatusChanged)) WHEN WoStatus = 2 THEN ROUND(6.9 - 3.5 * DATEDIFF(NOW(),WoStatusChanged)) WHEN WoStatus = 3 THEN ROUND(20 - 2.3 * DATEDIFF(NOW(),WoStatusChanged)) WHEN WoStatus = 4 THEN ROUND(46.4 - 1.75 * DATEDIFF(NOW(),WoStatusChanged)) WHEN WoStatus = 5 THEN ROUND(100 - 1.4 * DATEDIFF(NOW(),WoStatusChanged)) END)'|' GREATEST(-125, CASE WHEN WoStatus > 5 THEN 100 WHEN WoStatus = 1 THEN ROUND(-7 -7 * DATEDIFF(NOW(),WoStatusChanged)) WHEN WoStatus = 2 THEN ROUND(3.4 - 3.5 * DATEDIFF(NOW(),WoStatusChanged)) WHEN WoStatus = 3 THEN ROUND(17.7 - 2.3 * DATEDIFF(NOW(),WoStatusChanged)) WHEN WoStatus = 4 THEN ROUND(44.65 - 1.75 * DATEDIFF(NOW(),WoStatusChanged)) WHEN WoStatus = 5 THEN ROUND(98.6 - 1.4 * DATEDIFF(NOW(),WoStatusChanged)) END)'|'0'

make_score_random_insert_update()

make_score_random_insert_update

(

$type

)

Make a random score for a new word.

Parameters

'iv'|'id'|'u'|string

$type Type of insertion

Returns

string SQL code to use

my_die()

my_die

(

$text

)

Make the script crash and prints an error message

Parameters

string

$text

Error text to output

Returns

never

pageend()

pageend

(

)

Add a closing body tag.

@global bool $debug Show the requests if true @global float $dspltime Total execution time since the PHP session started

quickMenu()

quickMenu

(

)

Display the main menu of navigation as a dropdown

remove_spaces()

remove_spaces	(		$s,
			$remove
	)

Remove all spaces from a string.

Parameters

string	$s	Input string
string	$remove	Do not do anything if empty

Returns

string String without spaces if requested.

showRequest()

showRequest

(

)

Echo debugging informations.

str_replace_first()

str_replace_first	(		$needle,
			$replace,
			$haystack
	)

Replace the first occurence of $needle in $haystack by $replace

Parameters

string	$needle	Text to replace
string	$replace	Text to replace by
string	$haystack	Input string

Returns

string String with replaced text

tohtml()

tohtml

(

$s

)

Escape special HTML characters.

Parameters

string

$s

String to escape.

Returns

string htmlspecialchars($s, ENT_COMPAT, "UTF-8");

url_base()

url_base

(

)

Get the base URL of the application

Returns

string base URL