GeoGet

Complete geocaching solutions

User Tools

Site Tools

You are here: start » user » skript » structstring
Trace: • structstring
user:skript:structstring

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
user:skript:structstring [2010/09/23 13:23] – gorduser:skript:structstring [2021/05/02 19:01] (current) – [Stažení] mikrom
Line 1: Line 1:
 ====== StructString ====== ====== StructString ======
-Knihovna pro manipulaci se strukturovaným stringem. Umožňuje tak jednoduše ukládaá a vybírat podle klíčového slova hodnoty z jediného textového řetězu, který svým formátem tak trochu připomíná sled standardních XML tagů.+Knihovna pro manipulaci se strukturovaným řetězcem. Umožňuje jednoduše ukládat a vybírat podle klíčového slova hodnoty z jediného textového řetězce, který svým formátem tak trochu připomíná sled standardních XML tagů. 
 + 
 +===== Autor ===== 
 +|**[[http://www.geocaching.com/profile/?u=medwyn_cz|medwyn_cz]], [[mailto:medwyn@seznam.cz|medwyn_cz]]** | ~~PAYPAL business="kopecky@klfree.net" message="Prispevek na skript: StructString"~~ | 
 +Pokud se Vám knihovna líbí, kliknutím na tlačítko Donate můžete přispět na její vývoj. 
 + 
 +//Nekamarádíte se s PayPalem? Napište mi [[mailto:medwyn@seznam.cz|email]] a domluvíme se na jiném způsobu, třeba převodu na účet.// 
 + 
 +Na specifikaci požadovaných funkcí se podílel i **[[http://www.geocaching.com/profile/?u=gordici|Gord]]**  
 ===== Automatická instalace ===== ===== Automatická instalace =====
 ~~GEOGET_INSTALL~~ ~~GEOGET_INSTALL~~
  
-===== Autor ===== +===== Popis ===== 
-**[[http://www.geocaching.com/profile/?u=medwyn_cz|medwyn_cz]], elektronická(zavináč)adresa(tečka)cz** +Knihovna je určena pro vývojáře skriptů. Sama neposkytuje žádnou funkčnost pro GeoGet. 
-   +Pomocí knihovny můžete ukládat informace do řetězců podobným způsobem, jako byste je ukládali do databáze. S řetězci poté můžete pracovat pomocí připravených metod. 
-Spoluautor, který to sem nacpal: + 
 +Užití knihovny je vhodné, pokud potřebujete ukládat do tagu ke keši velké množství informací a informace dále upravovat, dotazovat se na jejich přítomnost a hodnotu a podobně.  
 + 
 +==== Reprezentace řetězce uvnitř knihovny ==== 
 +Knihovna se strukturovanými řetězci vnitřně pracuje jako se seznamem (TStrings). 
 + 
 +Pro zajištění správné funkčnosti takovéto implementace jsou při ukládání do seznamu některé hodnoty kódovány 
 +   * výskyty **"** jsou zakódovány jako **&quote&** 
 +   * výskyty **CRLF** jsou zakódovány jako **&CrLf&**    
 + 
 +Ve většině případů se o toto kódování postará knihovna sama. V určitých situacích (viz dokumentace jednotlivých procedur a funkcí) je však třeba, aby zakódování/dekódovaní zajistil sám její uživatel pomocí předpřipravených funkcí. 
 + 
 +=== Obecný příklad === 
 +Příklad strukturovaného řetězce a jeho reprezentace pomocí seznamu 
 +   * structString: <name1="value1"/><name2="value2"/><name3="value3"/>... 
 +   * structStringList: name1,value1,name2,value2,name3,value3... 
 + 
 +=== Konkrétní příklad === 
 +Příklad strukturovaného řetězce a jeho reprezentace pomocí seznamu 
 +   * structString: <owner="medwyn_cz"/><owner="gord"/><project="StructString"/> 
 +   * structStringList: owner,medwyn_cz,owner,gord,project,StructString 
 + 
 +==== Dostupné funkce ==== 
 +=== Obecné funkce === 
 +<code delphi>function StructStringGetList(structString: String): TStrings;</code> 
 +   * Function returns StringList of values name1,value1,name2,value2,name3,value3 ...
      
-**[[http://www.geocaching.com/profile/?u=gordici|Gord]], [[mailto:gord@atlas.cz|Gord]]**  +<code delphi>function StructStringDecode(str : String) : String;</code> 
- +   * Function decodes string from structString code
  
-===== Popis ===== +<code delphi>function StructStringEncode(str : String) : String;</code> 
-Knihovna poskytuje funkce pro práci se strukturovanými textovými řetězi ve tvaru+   * Function encodes string into structString code
  
-<code> +=== Nastavování hodnot === 
-<name1="value1"/><name2="value2"/><name3="value3"/>... +<code delphi>procedure StructStringListSetMultipleValues(name : String; value : TStrings ; var structStringList :TStrings; overwrite: boolean);</code> 
-</code>+   * Function sets values of given name in the given structStringList. If overwrite is true, all other values of given name will be deleted before
  
 +<code delphi>procedure StructStringListSetValue(name,value : String; var structStringList : TStrings; overwrite : boolean);</code>
 +   * Function sets value of given name in the given structStringList. If overwrite is true, all other values of given name will be deleted before
  
 +<code delphi>procedure StructStringSetMultipleValues(name : String; value :TStrings; var structString: String; overwrite: boolean);</code>
 +   * Function sets values of given name in the given structString. If overwrite is true, all other values of given name will be deleted before
  
-==== Ukázka ==== +<code delphi>procedure StructStringSetValue(name,value : String; var structString : String; overwrite: boolean);</code> 
-FIXME Pokud je to možné a vhodné, měl by popis obsahovat i snímky obrazovek - jak vypadají ovládací dialogy skriptu, jak vypadají výstupy exportu a podobně.+   * Function sets value of given name in the given structString. If overwrite is true, all other values of given name will be deleted before
  
-===== Instalace ===== +=== Test obsahu === 
-Knihovna se instaluje standardním postupem jako balíček pomocí Správce pluginů.+<code delphi>function StructStringContains(name,value,structString : String; regex : boolean) : boolean;</code> 
 +   * Does the structString contain the given value? If regex is true, value parameter is handled as regular expression 
 + 
 +<code delphi>function StructStringContainsName(name,structString: String) : boolean;</code> 
 +   * Does the structString contain value of the given name? 
 + 
 +<code delphi>function StructStringListContains(name,value : String; structStringList : TStrings; regex : boolean) : boolean;</code> 
 +   * Does the structStringList contain the given value? If regex is true, value parameter is handled as regular expression 
 + 
 +<code delphi>function StructStringListContainsName(name: String; structStringList : TStrings) : boolean;</code> 
 +   * Does the structStringList contain value of the given name?        
 + 
 +=== Získání uložených hodnot === 
 +<code delphi>function StructStringGetMultipleValues(name,structString : String): TStrings;</code> 
 +   * Function returns StringList of all values of given name in given structString. Values must be decoded using StructStringDecode before use 
 + 
 +<code delphi>function StructStringGetString(structStringList: TStrings) : String;</code> 
 +   * Function returns structString of values from structStringList 
 + 
 +<code delphi>function StructStringGetValue(name,structString : String) : String;</code> 
 +   * Function returns value of first occurence of value of given name in given structString 
 + 
 +<code delphi>function StructStringListGetMultipleValues(name : String;structStringList : TStrings): TStrings;</code> 
 +   * Function returns StringList of all values of given name in given structStringList. Values must be decoded using StructStringDecode before use 
 + 
 +<code delphi>function StructStringListGetValue(name : String;structStringList : TStrings) : String;</code> 
 +   * Function returns value of first occurence of value of given name in given structStringList 
 + 
 +=== Mazání hodnot === 
 +<code delphi>procedure StructStringDeleteMultipleValues(name : String; var structString : String);</code> 
 +   * Function deletes all values of given name in given structString 
 +       
 +<code delphi>procedure StructStringDeleteValue(name, value : String; var structString : String);</code> 
 +   * Function deletes all values of given name and value in given structString  
 +  
 +<code delphi>procedure StructStringListDeleteMultipleValues(name : String; var structStringList :TStrings);</code> 
 +   * Function deletes all values of given name in given structStringList  
 + 
 +<code delphi>procedure StructStringListDeleteValue(name, value : String; var structStringList : TStrings);</code> 
 +   * Function deletes all values of given name and value in given structStringList 
 + 
 +===== Seznam skriptů, které používají tuto knihovnu ===== 
 +{{topic>uses_structstring}} 
 + 
 +Pokud jste narazili na skript, který knihovnu používá, ale není zde uveden, kontaktujte, prosím, autory.
  
 ===== Stažení ===== ===== Stažení =====
-<box round 95% #DEE7EC> +<WRAP round download> 
-:!: Stáhnout aktuální verzi: ~~DOWNLOAD structstring-*.gip highest~~ +Stáhnout aktuální verzi: ~~DOWNLOAD structstring-*.gip highest~~ 
-</box>+</WRAP>
  
 ==== Seznam dostupných verzí ==== ==== Seznam dostupných verzí ====
-{{filelist>structstring:*.[gz]ip&style=table&tableheader=1&tableshowdate=1&sort=mtime}}+{{filelist>structstring:*.gip&style=table&tableheader=1&tableshowdate=1&sort=mtime}}
  
-==== Changelog ==== +===== Seznam změn =====       
-=== 1.0 (2010/09/07 23:00) === +=== 1.1.1 (2010/01/23 16:00) === 
-   * Úvodní verze           +   * Upravena instalace - do samostaneho adresare v lib\ 
-=== 1.1 (2010/09/07 23:00) === +   * doplněna možnost použití knihovny jako **unit**
-   * První verze dostupná jako **gip**          +
  
-<hidden onHidden=":!: **Zobrazit změny ve starších verzích**" onVisible="Skrýt změny ve starších verzích"> +=== 1.1 (2010/10/04 12:00) === 
-=== 0.9 (Datum) === +   * První verze dostupná jako instalační balíček **gip**           
-   * Případné dřívější verze. Pokud je seznam změn příliš dlouhý, je vhodné starší verze skrýt pomocí tagu hidden. Pro jejich zobrazení bude muset uživatel kliknout na tlačířko **Zobrazit změny ve starších verzích**  + 
-</hidden>+=== 1.0 (2010/09/07 23:00) === 
 +   * Úvodní verze
  
-{{tag>skript lib}}+{{tag>author_medwyn skript lib}}
user/skript/structstring.1285241004.txt.gz · Last modified: 2010/09/23 00:00 (external edit)