GeoGet

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== StringFuncLib ======
Knihovna obsahuje funkce pro manipulaci s textovými řetězci, které mohou být užitečné, ale nejsou součástí script API GeoGetu.

===== Autor =====
|**[[http://www.geocaching.com/profile/?u=gordici|Gord]]**, **[[mailto:gord@atlas.cz|Gord]]**| ~~PAYPAL business="gord@atlas.cz" message="Prispevek na skript: StringFuncLib"~~|

Pokud se Vám doplněk líbí, kliknutím na tlačítko **Donate** můžete přispět na jeho vývoj.

//Nekamarádíte se s PayPalem? Napište mi [[mailto:gord@atlas.cz|email]] a domluvíme se na jiném způsobu, třeba převodu na účet.//

===== Automatická instalace =====
~~GEOGET_INSTALL~~

/*
===== Diskuze =====
Diskuze o tomto skriptu se nachází na stránkách [[http://www.geocaching.cz/forum/viewthread.php?forum_id=20&thread_id=17224|Geocaching.cz]].
*/

===== Uživatelská dokumentace =====
Tato část textu je určena především pro uživatele GeoGetu. Respektive pro uživatele těch skriptů GeoGetu, které využívají funkcí knihovny StringFuncLib. Odstavce jsou však povinnou četbou i pro programátory skriptů.

<WRAP round info>
Protože se jedná o knihovnu, není možné ji použít samostatně. Jako každá jiná knihovna, i tato slouží programátorům (v tomto případě programátorům skriptů pro GeoGet) k tomu, aby zjednodušila jejich práci. Programátor začleněním knihovny do svého skriptu použije její funkce a tím si usnadní práci se psaním a laděním části kódu se stejnou funkčností.
</WRAP>

===== Programátorská dokumentace =====

==== Veřejné funkce knihovny ====
Použití knihovny spočívá ve volání některé z knihovních funkcí. 

<code delphi>StringCompress(str:string):string;</code>
  * odstraní mezery, převede na malá písmena a první znak slova vždy velké písmeno
  * jde ekvivalent ''FilenameFromText'' z knihovny [[user:skript:reltoabspath|RelToAbsPath]]

<code delphi>RemoveInvalidPathChars(str:string):string;</code>
  * odstraní znaky, které mohou dělat potíže ve jménech souborů

<code delphi>IntToStrLength(iNum,len:integer):string;</code>
  * převod Integer na string se zadaným minimálním počtem znaků (kratší čísla jsou doplněna levostrannými nulami)

<code delphi>Base64ToBitmap(str:string):TBitMap;</code>
  * vytvoření bitové mapy z Base64 stringu (uvolnit bitmapu musí volající)

<code delphi>GetCurrentPluginVersion:string;</code>
  * vrací číslo verze pluginu, které je nastavené v ''*.meta.ini'' právě spuštěného pluginu <sup>(1.1.0)</sup>

<code delphi>StringsToStr(a:sTStrings; separator:string):string;</code>
  * převede ''TStrings'' na string oddělený ''separatorem'' <sup>(1.1.0)</sup>

<code delphi>StrToStrings(str,separator:string):TStrings;</code>
  * rozdělí ''str'' podle ''separator'' a převede do vraceného ''TStrings'' <sup>(1.1.0)</sup>

<code delphi>DecToHex(iNum,len:integer):string;</code>
  * převede integer na hexadecimální string <sup>(1.2.0)</sup>

<code delphi>HexToDec(sHex: String): Integer;</code>
  * převede string s číslem v hexadecimální tvaru na integer <sup>(1.2.0)</sup>

<code delphi>HtmlEntityDecDecode(str: String): String;</code>
  * dekódování HTML entit dekadickým číslem (napr. &#225 je á), které standardní funkce ''HtmlEntityDecode()'' nedekóduje <sup>(1.5.3)</sup>

==== Knihovna jako Include nebo Unit ====
Knihovna je připravena ve dvou verzích. Je možné prostě includovat soubor 

<code delphi>
{$include StringFunc.lib.pas}
</code>

nebo je možné knihovnu použít jako unit příkazem

<code delphi>
uses StringFuncUnit;
</code>

na prvním řádku klientského skriptu.

Výhodou unit je bezproblémová práce s formuláři, je tedy doporučeno používat tuto cestu.

==== Nastavení a konfigurace ====
Knihovna neobsahuje žádné konfigurační parametry, které by měly být uživatelsky přístupné.

===== Seznam skriptů, které používají tuto knihovnu =====
{{topic>uses_stringfunclib}}

Pokud jste narazili na skript, který knihovnu používá, ale není zde uveden, kontaktujte, prosím, autory.

===== Stažení =====
<WRAP round download>
Stáhnout aktuální verzi: ~~DOWNLOAD stringfunclib-*.gip highest~~
</WRAP>

==== Seznam dostupných verzí ====
{{filelist>stringfunclib:*.gip&style=table&tableheader=1&tableshowdate=1&sort=mtime}}

===== Seznam změn =====
** 1.5.3 (9.10.2021) **
  * doplněna funkce HtmlEntityDecDecode()

** 1.4.1 (22.12.2015) **
  * podpora pro CSV soubory
  * 
<hidden onHidden=":?: **Zobrazit změny ve starších verzích**" onVisible="Skrýt změny ve starších verzích">
** 1.3.1 (4.2.2014, staženo 3407 x) **
  * ''DecToHex'' - oprava pro některá záporná čísla
  * oprava odinstalace v meta.ini

** 1.2.0 (2.11.2012, počet stažení: 662) **
   * nová funkce ''DecToHex''
   * nová funkce ''HexToDec''

** 1.1.0 (21.9.2012, staženo 136 x) **
   * nová funkce ''GetCurrentPluginVersion''
   * nová funkce ''StringsToStr''
   * nová funkce ''StrToStrings''

** 1.0.0 (8.8.2012, staženo 103 x) **
   * úvodní veřejná verze knihovny
</hidden>

{{tag>author_Gord skript lib}}