Python: Rozdíl mezi vrácením Dict a vrácením Tuple - výhody, nevýhody

Vrácení jako dict

def load_aff_rules(...) -> dict:
    rules = {'normal': [...], 'reversed': [...]}
    return rules
  

• Výhody
  • Čitelná pojmenovaná data: rules['normal'], rules['reversed'].
  • Snadno se rozšiřuje o další klíče.
• Nevýhody
  • Nutnost pamatovat si přesné názvy klíčů – hrozí KeyError.
  • Horší podpora statické kontroly typů (mypy, IDE).
  • O něco pomalejší přístup kvůli hash‑lookup v dictu.

---

Vrácení jako Tuple[List[AffRule], List[AffRule]]

from typing import Tuple, List

def load_aff_rules(self, ...) -> Tuple[List[AffRule], List[AffRule]]:
    normal, reversed = [...], [...]
    return normal, reversed
  

a skutečně:

return rules['normal'], rules['reversed']

• Výhody
  • Jasně daná struktura: vždy dva seznamy ve stanoveném pořadí.
  • Snadné rozbalení do proměnných:

    normal_rules, reversed_rules = self.load_aff_rules(...)

  • Lepší podpora statické kontroly typů díky Tuple[...].
  • Rychlejší přístup (není potřeba dict‑lookup).
• Nevýhody
  • Méně samo‑dokumentující – musíte znát pořadí výstupů.
  • Obtížnější rozšíření – přidání dalšího výstupu změní definici tuple i všech volání.

---

Použití čárek

V definici typu:

-> Tuple[List[AffRule], List[AffRule]]

čárka odděluje první a druhý seznam.

V návratové hodnotě:

return rules['normal'], rules['reversed']

čárka tu znamená, že Python vrátí 2‑prvkový tuple.

Dodatek: Chyba AttributeError při rozbalování dict

Chyba:

AttributeError: 'str' object has no attribute 'matches'

 Tato chyba vzniká při nesprávném rozbalení návratové hodnoty z funkce, která vrací dict. Pokud máš následující kód:

aff_rules["normal"], aff_rules["reversed"] = self.load_aff_rules(...)

a funkce load_aff_rules vrací dict, dochází k tomu, že Python se snaží rozbalit klíče slovníku, ne jeho hodnoty. Výsledkem je:

• aff_rules["normal"] == "normal"
• aff_rules["reversed"] == "reversed"

což následně vede k chybě:

AttributeError: 'str' object has no attribute 'matches'

Řešení

Varianta A – Nechat návratový typ jako dict

Vrácený dict zachováš beze změny, ale rozbalíš ho ručně:

aff_rules = self.load_aff_rules(...)
normal_rules   = aff_rules["normal"]
reversed_rules = aff_rules["reversed"]

for w in dic_entries["normal"]:
    for r in normal_rules:
        if r.matches(w):
            dics_out["normal"].append(r.apply(w))

Varianta B – Vrátit Tuple místo dict

Pokud změníš návratovou hodnotu funkce na:

def load_aff_rules(...) -> Tuple[List[AffRule], List[AffRule]]:
    return rules["normal"], rules["reversed"]

pak volání funkce bude:

normal_rules, reversed_rules = self.load_aff_rules(...)

a zbytek kódu funguje stejně, ale s jistotou, že máš dva seznamy objektů typu AffRule.

Výhodou této varianty je lepší podpora typové kontroly (mypy, IDE), rychlejší přístup (není potřeba hash-lookup jako u dict) a menší riziko chyb typu KeyError. 

* * *

 

 

def parse_aff_input(self, aff_path: str) -> list[dict]:

Vysvětlení deklarace výstupního typu

Funkce skutečně vrací seznam slovníků, kde každý slovník má přesně tyto klíče a hodnoty:

• 'regex': str
• 'substring': str
• 'replacement': str
• 'ext': str
• 'tags': List[str]

Původní podpis

def parse_aff_input(self, aff_path: str) -> list[dict]:

Toto je sice validní, ale statický typ dict neříká nic o tom, jaké klíče či hodnoty slovníky obsahují.

Konkrétní typová anotace

Můžeme si nejprve vytvořit TypedDict, aby bylo jasné, co v dictu očekáváme:

from typing import TypedDict, List

class AffRecord(TypedDict):
regex: str
substring: str
replacement: str
ext: str
tags: List[str]

A pak upravit deklaraci:

def parse_aff_input(self, aff_path: str) -> List[AffRecord]: ...

Alternativa bez TypedDict

Pokud nechcete zavádět TypedDict, můžete alespoň upřesnit hodnoty pomocí Union:

from typing import List, Dict, Union

def parse_aff_input(self, aff_path: str) -> List[Dict[str, Union[str, List[str]]]]:
...

Tím dáváte najevo, že každá položka seznamu je slovník s řetězcovými klíči a hodnotami buď str nebo List[str].

Bash: Bash funkce remount na dočasné odpojení a připojení některých oddílů

# Funkce remount umožní na krátko odpojit zařízení disku
# Použití:
# remount sda 180 FILMY
# 180 - čas pro připojení disků sda, FILMY je text který tam musí být nalezen aspoň v jednom oddílu
declare -f remount
remount() {
    local device="/dev/$1"
    local remount_time="$2"
    local verify_value="$3" # Popis nebo label pro kontrolu jednoho oddílu
    local mount_points=()

    # Ověření existence oddílu obsahujícího verify_value
    if ! blkid | grep "$device" | grep -q "$verify_value"; then
        echo "Žádný oddíl na $device neobsahuje $verify_value. Proces byl ukončen."
        return 1
    fi

    echo "Byl nalezen oddíl obsahující $verify_value. Zahajuji odpojování všech oddílů na $device..."

    # Odpoutání všech oddílů zařízení
    while IFS= read -r line; do
        # Získejte název oddílu
        local partition=$(echo "$line" | awk '{print $1}' | sed 's|:||')
        # Získej aktuální přípojný bod ze stromu připojených zařízení
        local mount_point=$(findmnt -no TARGET "$partition")
        if [ -z "$mount_point" ]; then
            echo "Skipping $partition, probably not mounted."
        fi
        if [ -n "$mount_point" ]; then
            # Přidejte mount point do pole a odpojte oddíl
            mount_points+=("$mount_point")
            sudo umount -v "$partition"
            echo "Odpojeno: $partition z $mount_point"
        fi
    done < <(blkid | grep "$device")

    # Vyčkejte na remount
    sleep "$remount_time"

    echo "Čas vypršel, připojuji zpět oddíly..."

    # Připojte zpět oddíly na jejich původní mount pointy
    for mount_point in "${mount_points[@]}"; do
        sudo mount "$mount_point"
        echo "Připojeno zpět: $mount_point"
    done
}

phpBB3: inklidované funkce: content, display, mpc, posting, messenger, privmsgs, functions, convert, user

Adresář includes

 

pokračování

functions_content.php (includes)

1. gen_sort_selects(&$limit_days, &$sort_by_text, &$sort_days, &$sort_key, &$sort_dir, &$s_limit_days, &$s_sort_key, &$s_sort_dir, &$u_sort_param, $def_st = false, $def_sk = false, $def_sd = false): Tato funkce generuje výběrové seznamy pro řazení obsahu na stránce. Argumenty $limit_days, $sort_by_text, $sort_days, $sort_key, $sort_dir, $s_limit_days, $s_sort_key, $s_sort_dir a $u_sort_param jsou reference na proměnné, které uchovávají různé hodnoty pro řazení. Argumenty $def_st, $def_sk a $def_sd jsou výchozí hodnoty pro výběrové seznamy.

2. make_jumpbox($action, $forum_id = false, $select_all = false, $acl_list = false, $force_display = false): Tato funkce vytváří výběrový seznam pro skoky mezi fóry. Argument $action určuje akci, která se má provést. Další argumenty jsou volitelné a určují, zda zahrnout všechny fóra, seznam práv přístupu a zda vynutit zobrazení.

3. bump_topic_allowed($forum_id, $topic_bumped, $last_post_time, $topic_poster, $last_topic_poster): Tato funkce kontroluje, zda je povoleno "bumpování" tématu. Argumenty $forum_id, $topic_bumped, $last_post_time, $topic_poster a $last_topic_poster obsahují informace o tématu a posledním příspěvku.

4. get_context($text, $words, $length = 400): Tato funkce získává kontext textu. Argument $text je zpráva nebo text, $words je počet slov, které se mají zobrazit, a $length je maximální délka kontextu.

5. phpbb_clean_search_string($search_string): Tato funkce čistí řetězec pro vyhledávání.

6. decode_message(&$message, $bbcode_uid = ''): Tato funkce dekóduje zprávu obsahující BBCode. Argument $message je zpráva k dekódování a $bbcode_uid je identifikátor BBCode.

7. strip_bbcode(&$text, $uid = ''): Tato funkce odstraňuje BBCode z textu. Argument $text je text k odstranění BBCode a $uid je identifikátor BBCode.

8. generate_text_for_display($text, $uid, $bitfield, $flags, $censor_text = true): Tato funkce generuje text pro zobrazení na stránce. Argument $text je text k zobrazení, $uid je identifikátor BBCode, $bitfield je bitový pole obsahující informace o BBCode, $flags jsou příznaky zprávy a $censor_text určuje, zda má být text cenzurován.

Rozepíšeme nápovědu k funkcím v souboru /includes/functions_content.php:

1. gen_sort_selects(&$limit_days, &$sort_by_text, &$sort_days, &$sort_key, &$sort_dir, &$s_limit_days, &$s_sort_key, &$s_sort_dir, &$u_sort_param, $def_st = false, $def_sk = false, $def_sd = false): Tato funkce generuje výběrové seznamy pro řazení obsahu na základě zadaných argumentů. Argumenty $limit_days, $sort_by_text, $sort_days, $sort_key, $sort_dir a další slouží k předání dat a parametrů pro vytvoření výběrových seznamů. Argumenty $def_st, $def_sk a $def_sd určují výchozí hodnoty pro určité parametry, pokud nejsou zadány explicitně.

2. make_jumpbox($action, $forum_id = false, $select_all = false, $acl_list = false, $force_display = false): Tato funkce vytváří výběrový seznam (skokové pole) pro navigaci mezi fóry. Parametr $action určuje akci, která se má provést po výběru, zatímco ostatní parametry jsou volitelné a slouží k určení dalších vlastností výběrového seznamu.

3. bump_topic_allowed($forum_id, $topic_bumped, $last_post_time, $topic_poster, $last_topic_poster): Tato funkce kontroluje, zda je povoleno "bumpování" tématu v závislosti na různých parametrech, jako je ID fóra, čas posledního příspěvku a další.

4. get_context($text, $words, $length = 400): Funkce získává kontext textu. Parametry $text a $words obsahují text a klíčová slova, podle kterých se má kontext získat. Volitelný parametr $length určuje délku kontextu.

5. phpbb_clean_search_string($search_string): Tato funkce čistí řetězec pro vyhledávání, odstraňuje z něj nežádoucí znaky nebo formátování.

6. decode_message(&$message, $bbcode_uid = ''): Funkce dekóduje zprávu, odstraňuje kód BBCode a provede další úpravy pro zobrazení.

7. strip_bbcode(&$text, $uid = ''): Tato funkce odstraňuje z textu všechny značky BBCode.

8. generate_text_for_display($text, $uid, $bitfield, $flags, $censor_text = true): Funkce generuje text pro zobrazení na základě poskytnutých dat a příznaků.

9. generate_text_for_storage(&$text, &$uid, &$bitfield, &$flags, $allow_bbcode = false, $allow_urls = false, $allow_smilies = false, $allow_img_bbcode = true, $allow_flash_bbcode = true, $allow_quote_bbcode = true, $allow_url_bbcode = true, $mode = 'post'): Tato funkce generuje text pro uložení do databáze na základě poskytnutých dat a dalších parametrů.

10. generate_text_for_edit($text, $uid, $flags): Funkce generuje text pro úpravu.

11. make_clickable_callback($type, $whitespace, $url, $relative_url, $class): Tato funkce generuje odkazy na základě zadaných parametrů. Parametr $type určuje typ odkazu, $whitespace určuje, zda je odkaz vložen do textu s mezerami, $url a $relative_url určují cílovou adresu odkazu a $class určuje třídu použitou pro formátování odkazu.

12. make_clickable($text, $server_url = false, string $class = 'postlink'): Funkce automaticky zpřístupňuje všechny odkazy v textu. Parametr $text obsahuje text, ve kterém mají být odkazy zpřístupněny. Parametr $server_url určuje, zda má být zahrnut serverový URL do relativních odkazů, a $class určuje třídu použitou pro formátování odkazů.

13. censor_text($text): Tato funkce provádí cenzuru textu podle definovaných cenzurovacích pravidel.

14. bbcode_nl2br($text): Funkce nahrazuje nové řádky v textu značkami pro přechod na nový řádek v BBCode.

15. smiley_text($text, $force_option = false): Tato funkce nahrazuje emotikony v textu jejich odpovídajícími obrázky.

16. parse_attachments($forum_id, &$message, &$attachments, &$update_count_ary, $preview = false): Funkce analyzuje přílohy v textu a provádí odpovídající akce, jako je připojení příloh k příspěvku.

17. extension_allowed($forum_id, $extension, &$extensions): Tato funkce kontroluje, zda je určené rozšíření povoleno pro přílohy v daném fóru.

18. truncate_string($string, $max_length = 60, $max_store_length = 255, $allow_reply = false, $append = ''): Funkce zkracuje řetězec na zadanou délku a přidává koncovku, pokud je řetězec zkrácen.

19. get_username_string($mode, $user_id, $username, $username_colour = '', $guest_username = false, $custom_profile_url = false): Tato funkce generuje textový řetězec obsahující jméno uživatele na základě zadaných parametrů.

20. phpbb_add_quickmod_option($url, $option, $lang_string): Funkce přidává možnost rychlého modifikování na základě zadaných parametrů.

21. phpbb_generate_string_list($items, $user): Tato funkce generuje seznam řetězců na základě zadaných položek a uživatelů.

22. phpbb_format_quote($language, $message_parser, $text_formatter_utils, $bbcode_status, $quote_attributes, $message_link = ''): Funkce formátuje citáty v textu podle zadaných parametrů.

functions_display.php (includes)

1. display_forums($root_data = '', $display_moderators = true, $return_moderators = false): Tato funkce zobrazuje seznam fór na základě poskytnutých dat. Parametr $root_data obsahuje data o fórech, $display_moderators určuje, zda mají být zobrazeni moderátoři, a $return_moderators určuje, zda mají být moderátoři vráceni.

2. generate_forum_rules(&$forum_data): Tato funkce generuje pravidla fóra na základě poskytnutých dat o fórech.

3. generate_forum_nav(&$forum_data_ary): Funkce generuje navigační odkazy na základě poskytnutých dat o fórech.

4. get_forum_parents(&$forum_data): Tato funkce získává rodičovská fóra na základě poskytnutých dat o fórech.

5. get_moderators(&$forum_moderators, $forum_id = false): Funkce získává seznam moderátorů fóra na základě poskytnutých dat.

6. gen_forum_auth_level($mode, $forum_id, $forum_status): Tato funkce generuje úroveň oprávnění pro fórum na základě zadaných parametrů.

7. topic_status(&$topic_row, $replies, $unread_topic, &$folder_img, &$folder_alt, &$topic_type): Funkce určuje stav tématu na základě zadaných parametrů.

8. display_custom_bbcodes(): Tato funkce zobrazuje vlastní BB kódy.

9. display_user_activity(&$userdata_ary): Funkce zobrazuje aktivitu uživatele na základě poskytnutých dat o uživatelích.

10. watch_topic_forum($mode, &$s_watching, $user_id, $forum_id, $topic_id, $notify_status = 'unset', $start = 0, $item_title = ''): Tato funkce umožňuje sledovat témata ve fórech a upozornit uživatele na změny.

11. phpbb_get_user_rank($user_data, $user_posts): Funkce získává hodnost uživatele na základě poskytnutých dat o uživatelích a jejich příspěvcích.

12. phpbb_show_profile($data, $user_notes_enabled = false, $warn_user_enabled = false, $check_can_receive_pm = true): Tato funkce zobrazuje uživatelský profil na základě poskytnutých dat.

13. phpbb_sort_last_active($first, $second): Funkce provádí třídění podle poslední aktivity.

functions_mpc.php (includes)

1. phpbb_module__url($mode, $module_row): Tato funkce generuje URL pro různé režimy modulu zpráv pro řízení obsahu fóra. Argumenty:

   • $mode: Určuje režim modulu.
   • $module_row: Obsahuje data o modulu.

2. phpbb_module_notes_url($mode, $module_row): Generuje URL pro režim poznámek modulu zpráv pro řízení obsahu fóra. Argumenty stejné jako v předchozí funkci.

3. phpbb_module_warn_url($mode, $module_row): Generuje URL pro režim varování modulu zpráv pro řízení obsahu fóra. Argumenty stejné jako v předchozí funkci.

4. phpbb_module_main_url($mode, $module_row): Generuje URL pro hlavní režim modulu zpráv pro řízení obsahu fóra. Argumenty stejné jako v předchozí funkci.

5. phpbb_module_logs_url($mode, $module_row): Generuje URL pro režim protokolů modulu zpráv pro řízení obsahu fóra. Argumenty stejné jako v předchozí funkci.

6. phpbb_module_ban_url($mode, $module_row): Generuje URL pro režim zákazů modulu zpráv pro řízení obsahu fóra. Argumenty stejné jako v předchozí funkci.

7. phpbb_module_queue_url($mode, $module_row): Generuje URL pro režim fronty modulu zpráv pro řízení obsahu fóra. Argumenty stejné jako v předchozí funkci.

8. phpbb_module_reports_url($mode, $module_row): Generuje URL pro režim hlášení modulu zpráv pro řízení obsahu fóra. Argumenty stejné jako v předchozí funkci.

9. phpbb_extra_url($additional_parameters = []): Generuje dodatečné URL parametry. Argument $additional_parameters je volitelný a obsahuje dodatečné parametry.

10. phpbb_get_topic_data($topic_ids, $acl_list = false, $read_tracking = false): Získává data témata na základě zadaných identifikátorů témat. Argumenty:

    • $topic_ids: Pole identifikátorů témat.
    • $acl_list: Seznam oprávnění omezujících přístup k datům.
    • $read_tracking: Určuje, zda se mají získat i informace o sledování čtení.

11. phpbb_get_post_data($post_ids, $acl_list = false, $read_tracking = false): Získává data příspěvků na základě zadaných identifikátorů příspěvků. Argumenty stejné jako v předchozí funkci.

12. phpbb_get_forum_data($forum_id, $acl_list = 'f_list', $read_tracking = false): Získává data fóra na základě zadaného identifikátoru fóra. Argumenty:

    • $forum_id: Identifikátor fóra.
    • $acl_list: Seznam oprávnění omezujících přístup k datům.
    • $read_tracking: Určuje, zda se mají získat i informace o sledování čtení.

13. phpbb_get_pm_data($pm_ids): Získává data soukromých zpráv na základě zadaných identifikátorů zpráv. Argument $pm_ids obsahuje pole identifikátorů zpráv.

14. phpbb_mcp_sorting($mode, &$sort_days_val, &$sort_key_val, &$sort_dir_val, &$sort_by_sql_ary, &$sort_order_sql, &$total_val, $forum_id = 0, $topic_id = 0, $where_sql = 'WHERE'): Tato funkce slouží k řazení v panelu řízení obsahu fóra. Argumenty:

    • $mode: Určuje režim řazení.
    • $sort_days_val, $sort_key_val, $sort_dir_val: Reference na proměnné pro uchování hodnot řazení.
    • $sort_by_sql_ary: Pole pro nastavení SQL dotazu pro řazení.
    • $sort_order_sql: Řetězec pro SQL dotaz na řazení.
    • $total_val: Reference na proměnnou pro uchování celkového počtu výsledků.
    • $forum_id: ID fóra pro filtrování.
    • $topic_id: ID tématu pro filtrování.
    • $where_sql: Řetězec pro další SQL podmínky.

15. phpbb_check_ids(&$ids, $table, $sql_id, $acl_list = false, $single_forum = false): Tato funkce kontroluje platnost identifikátorů záznamů. Argumenty:

    • $ids: Pole identifikátorů.
    • $table: Název tabulky v databázi.
    • $sql_id: Název sloupce s identifikátorem v tabulce.
    • $acl_list: Seznam oprávnění omezujících přístup.
    • $single_forum: Určuje, zda se kontrola provádí pouze pro jedno fórum.

functions_posting (includes)

1. generate_smilies($mode, $forum_id)

   • $mode: Režim.
   • $forum_id: ID fóra.

2. update_post_information($type, $ids, $return_update_sql = false)

   • $type: Typ aktualizace.
   • $ids: ID příspěvků.
   • $return_update_sql: Volitelný argument indikující, zda vrátit aktualizační SQL.

3. posting_gen_topic_icons($mode, $icon_id)

   • $mode: Režim.
   • $icon_id: ID ikony.

4. posting_gen_topic_types($forum_id, $cur_topic_type = POST_NORMAL)

   • $forum_id: ID fóra.
   • $cur_topic_type: Aktuální typ tématu.

5. get_img_size_format($width, $height)

   • $width: Šířka obrázku.
   • $height: Výška obrázku.

6. get_supported_image_types($type = false)

   • $type: Typ obrázku (volitelný).

7. create_thumbnail($source, $destination, $mimetype)

   • $source: Zdrojový soubor.
   • $destination: Cílový soubor.
   • $mimetype: MIME typ.

8. posting_gen_inline_attachments(&$attachment_data)

   • $attachment_data: Data přílohy.

9. posting_gen_attachment_entry($attachment_data, &$filename_data, $show_attach_box = true, $forum_id = false)

   • $attachment_data: Data přílohy.
   • $filename_data: Data názvu souboru.
   • $show_attach_box: Indikátor zobrazení přílohového okna (volitelný).
   • $forum_id: ID fóra (volitelný).

10. load_drafts($topic_id = 0, $forum_id = 0, $id = 0, $pm_action = '', $msg_id = 0)

    • $topic_id: ID tématu (volitelný).
    • $forum_id: ID fóra (volitelný).
    • $id: ID (volitelný).
    • $pm_action: Akce zprávy (volitelný).
    • $msg_id: ID zprávy (volitelný).

11. topic_review($topic_id, $forum_id, $mode = 'topic_review', $cur_post_id = 0, $show_quote_button = true)

    • $topic_id: ID tématu.
    • $forum_id: ID fóra.
    • $mode: Režim (volitelný).
    • $cur_post_id: ID aktuálního příspěvku (volitelný).
    • $show_quote_button: Indikátor zobrazení tlačítka pro citaci (volitelný).

12. delete_post($forum_id, $topic_id, $post_id, &$data, $is_soft = false, $softdelete_reason = '')

    • $forum_id: ID fóra.
    • $topic_id: ID tématu.
    • $post_id: ID příspěvku.
    • &$data: Reference na data.
    • $is_soft: Indikátor soft-delete (volitelný).
    • $softdelete_reason: Důvod soft-delete (volitelný).

13. submit_post($mode, $subject, $username, $topic_type, &$poll_ary, &$data_ary, $update_message = true, $update_search_index = true)

    • $mode: Režim.
    • $subject: Předmět.
    • $username: Uživatelské jméno.
    • $topic_type: Typ tématu.
    • &$poll_ary: Reference na pole hlasování.
    • &$data_ary: Reference na pole dat.
    • $update_message: Indikátor aktualizace zprávy (volitelný).
    • $update_search_index: Indikátor aktualizace indexu vyhledávání (volitelný).

14. phpbb_bump_topic($forum_id, $topic_id, $post_data, $bump_time = false)

    • $forum_id: ID fóra.
    • $topic_id: ID tématu.
    • $post_data: Data příspěvku.
    • $bump_time: Čas bumpu (volitelný).

15. phpbb_upload_popup($forum_style = 0)

    • $forum_style: Styl fóra (volitelný).

16. phpbb_handle_post_delete($forum_id, $topic_id, $post_id, &$post_data, $is_soft = false, $delete_reason = '')
    • $forum_id: ID fóra.
    • $topic_id: ID tématu.
    • $post_id: ID příspěvku.
    • &$post_data: Reference na data příspěvku.
    • $is_soft: Indikátor soft-delete (volitelný).
    • $delete_reason: Důvod smazání (volitelný).

functions_messenger.php (includes)

1. __construct($use_queue = true): Konstruktor třídy phpbb_messenger inicializuje novou instanci objektu. Parametr $use_queue určuje, zda se má použít fronta pro odesílání zpráv (výchozí hodnota je true).

2. reset(): Resetuje stav objektu messenger.

3. set_addresses($user): Nastavuje adresy příjemců.

4. to($address, $realname = ''): Nastavuje adresu příjemce.

5. cc($address, $realname = ''): Nastavuje adresu kopie.

6. bcc($address, $realname = ''): Nastavuje adresu skryté kopie.

7. im($address, $realname = ''): Nastavuje adresu pro okamžité zprávy.

8. replyto($address): Nastavuje adresu pro odpověď.

9. from($address): Nastavuje adresu odesílatele.

10. subject($subject = ''): Nastavuje předmět zprávy.

11. headers($headers): Nastavuje hlavičky zprávy.

12. anti_abuse_headers($config, $user): Nastavuje anti-zneužitelné hlavičky.

13. set_mail_priority($priority = MAIL_NORMAL_PRIORITY): Nastavuje prioritu e-mailu.

14. template($template_file, $template_lang = '', $template_path = '', $template_dir_prefix = ''): Nastavuje šablonu zprávy.

15. assign_vars($vars): Přiřazuje proměnné do šablony.

16. assign_block_vars($blockname, $vars): Přiřazuje proměnné bloku v šabloně.

17. send($method = NOTIFY_EMAIL, $break = false): Odesílá zprávu. Parametr $method určuje způsob odeslání (výchozí je e-mail), $break indikuje, zda se má zpráva pouze formátovat.

18. error($type, $msg): Zaznamenává chybu v odesílání.

19. save_queue(): Ukládá frontu odesílaných zpráv.

20. generate_message_id(): Generuje ID zprávy.

21. build_header($to, $cc, $bcc): Sestavuje hlavičku zprávy s ohledem na příjemce, kopie a skryté kopie.

22. msg_email(): Metoda pro odeslání e-mailové zprávy. Obsahuje parametr $break, který indikuje, zda se má funkce vrátit po provedení hooku.

23. msg_jabber(): Metoda pro odeslání zprávy přes protokol Jabber.

24. setup_template(): Chráněná metoda pro nastavení šablony.

25. set_template_paths($path_name, $paths): Chráněná metoda pro nastavení cest k šablonám.

26. __construct(): Konstruktor třídy phpbb_network nebo phpbb_smtp nebo phpbb_mail inicializuje novou instanci objektu.

27. init($object, $package_size): Inicializuje spojení.

28. put($object, $scope): Přidá objekt do fronty odesílání.

29. process(): Zpracovává frontu odesílání.

30. save(): Ukládá zprávu.

31. smtpmail($addresses, $subject, $message, &$err_msg, $headers = false): Funkce pro odeslání e-mailu přes SMTP server. Obsahuje parametry pro adresy, předmět, obsah zprávy, zprávu o chybě a volitelné hlavičky.

32. add_backtrace($message): Přidá do zprávy stopu (backtrace).

33. server_send($command, $private_info = false): Odesílá příkaz na server.

34. server_parse($response, $line): Parsuje odpověď serveru.

35. close_session(&$err_msg): Uzavírá spojení se serverem.

36. log_into_server($hostname, $username, $password, $default_auth_method): Přihlašuje se do serveru.

37. hello($hostname): Metoda pro pozdravení se serverem.

38. starttls(): Zahajuje TLS spojení.

39. pop_before_smtp($hostname, $username, $password): Metoda pro autentizaci POP3 před SMTP.

40. plain($username, $password): Metoda pro autentizaci pomocí mechanismu PLAIN.

41. login($username, $password): Metoda pro autentizaci pomocí mechanismu LOGIN.

42. cram_md5($username, $password): Metoda pro autentizaci pomocí mechanismu CRAM-MD5.

43. digest_md5($username, $password): Metoda pro autentizaci pomocí mechanismu DIGEST-MD5.

44. mail_encode($str, $eol = "\r\n"): Zakóduje text zprávy pro e-mailový formát.

45. phpbb_mail($to, $subject, $msg, $headers, $eol, &$err_msg): Funkce pro odeslání e-mailu přes PHP mail. Obsahuje parametry pro adresy, předmět, obsah zprávy, hlavičky, znak konce řádku a zprávu o chybě.

 

functions_privmsgs.php (includes)

1. get_folder($user_id, $folder_id = false)

   • $user_id: ID uživatele.
   • $folder_id: ID složky (volitelné).

2. clean_sentbox($num_sentbox_messages)

   • $num_sentbox_messages: Počet zpráv v odeslané složce.

3. check_rule(&$rules, &$rule_row, &$message_row, $user_id)

   • &$rules: Reference na pravidla.
   • &$rule_row: Reference na řádek pravidla.
   • &$message_row: Reference na řádek zprávy.
   • $user_id: ID uživatele.

4. update_pm_counts()

5. place_pm_into_folder(&$global_privmsgs_rules, $release = false)

   • &$global_privmsgs_rules: Reference na pravidla globálních soukromých zpráv.
   • $release: Uvolnění (volitelné).

6. move_pm($user_id, $message_limit, $move_msg_ids, $dest_folder, $cur_folder_id)

   • $user_id: ID uživatele.
   • $message_limit: Limit zpráv.
   • $move_msg_ids: ID zpráv k přesunu.
   • $dest_folder: Cílová složka.
   • $cur_folder_id: ID aktuální složky.

7. update_unread_status($unread, $msg_id, $user_id, $folder_id)

   • $unread: Nepřečtené.
   • $msg_id: ID zprávy.
   • $user_id: ID uživatele.
   • $folder_id: ID složky.

8. mark_folder_read($user_id, $folder_id)

   • $user_id: ID uživatele.
   • $folder_id: ID složky.

9. handle_mark_actions($user_id, $mark_action)

   • $user_id: ID uživatele.
   • $mark_action: Akce označení.

10. delete_pm($user_id, $msg_ids, $folder_id)

    • $user_id: ID uživatele.
    • $msg_ids: ID zpráv k odstranění.
    • $folder_id: ID složky.

11. phpbb_delete_users_pms($user_ids)

    • $user_ids: ID uživatelů.

12. rebuild_header($check_ary)

    • $check_ary: Pole ke kontrole.

13. write_pm_addresses($check_ary, $author_id, $plaintext = false)

    • $check_ary: Pole k ověření.
    • $author_id: ID autora.
    • $plaintext: Čistý text (volitelné).

14. get_folder_status($folder_id, $folder)

    • $folder_id: ID složky.
    • $folder: Složka.

15. submit_pm($mode, $subject, &$data_ary, $put_in_outbox = true)

    • $mode: Režim.
    • $subject: Předmět zprávy.
    • &$data_ary: Reference na pole dat.
    • $put_in_outbox: Umístit do odeslané složky (volitelné).

16. message_history($msg_id, $user_id, $message_row, $folder, $in_post_mode = false)

    • $msg_id: ID zprávy.
    • $user_id: ID uživatele.
    • $message_row: Řádek zprávy.
    • $folder: Složka.
    • $in_post_mode: Režim příspěvku (volitelné).

17. set_user_message_limit()

18. phpbb_get_max_setting_from_group(\phpbb\db\driver\driver_interface $db, $user_id, $setting)

    • $db: Rozhraní databáze.
    • $user_id: ID uživatele.
    • $setting: Nastavení.

19. get_recipient_strings($pm_by_id)

    • $pm_by_id: Soukromé zprávy podle ID.

Rozdíl mezi funkcemi v souborech functions_privmsgs.php a functions_messenger

Rozdíl mezi funkcemi v souborech functions_privmsgs.php a functions_messenger.php spočívá převážně v jejich zaměření a účelu.

1. functions_privmsgs.php:

   • Obsahuje funkce související se správou soukromých zpráv (PM) v diskuzním fóru.
   • Zahrnuje funkce pro načítání, ukládání, mazání a manipulaci se soukromými zprávami.
   • Obsahuje také funkce pro správu složek, označování zpráv jako přečtené nebo nepřečtené a provádění akcí souvisejících se správou soukromých zpráv.

2. functions_messenger.php:

   • Obsahuje funkce související s odesíláním a manipulací s různými typy zpráv v rámci platformy.
   • Zahrnuje funkce pro konstrukci, formátování, odesílání a zpracování zpráv, jako jsou e-maily, zprávy v Jabberu (XMPP) a další.
   • Může obsahovat také funkce pro nastavení priorit zpráv, práci s frontou zpráv a dalšími úkoly souvisejícími s doručováním zpráv.

Základní rozdíl spočívá tedy v tom, že functions_privmsgs.php se zaměřuje na správu soukromých zpráv uživatelů v rámci diskuzního fóra, zatímco functions_messenger.php se zaměřuje na obecnější funkce spojené s odesíláním a manipulací s různými typy zpráv na platformě.

functions.php (includes)

Následuje seznam funkcí ze souboru includes/functions.php spolu s jejich argumenty:

1. gen_rand_string($num_chars = 8): Generuje náhodný řetězec o zadané délce.
2. gen_rand_string_friendly($num_chars = 8): Generuje náhodný přátelský řetězec o zadané délce.
3. unique_id(): Generuje unikátní identifikátor.
4. phpbb_mt_rand($min, $max): Generuje náhodné číslo v určeném rozsahu.
5. phpbb_gmgetdate($time = false): Vrací pole s časovými údaji z Unixového timestampu.
6. get_formatted_filesize($value, $string_only = true, $allowed_units = false): Formátuje velikost souboru.
7. still_on_time($extra_time = 15): Kontroluje, zda je stále v čase.
8. phpbb_version_compare($version1, $version2, $operator = null): Porovnává verze PHPBB.
9. language_select($default = '', array $langdata = []): Vytváří rozbalovací seznam jazyků.
10. style_select($default = '', $all = false, array $styledata = []): Vytváří rozbalovací seznam stylů.
11. phpbb_format_timezone_offset($tz_offset, $show_null = false): Formátuje posun časového pásma.
12. phpbb_tz_select_compare($a, $b): Porovnává hodnoty časových pásem.
13. phpbb_get_timezone_identifiers($selected_timezone): Získává identifikátory časových pásem.
14. phpbb_timezone_select($template, $user, $default = '', $truncate = false): Vytváří rozbalovací seznam časových pásem.
15. markread($mode, $forum_id = false, $topic_id = false, $post_time = 0, $user_id = 0): Označuje přečtené položky.
16. get_topic_tracking($forum_id, $topic_ids, &$rowset, $forum_mark_time, $global_announce_list = false): Získává informace o sledování témat.
17. get_complete_topic_tracking($forum_id, $topic_ids, $global_announce_list = false): Získává kompletní informace o sledování témat.
18. get_unread_topics($user_id = false, $sql_extra = '', $sql_sort = '', $sql_limit = 1001, $sql_limit_offset = 0): Získává nepřečtená témata.
19. update_forum_tracking_info($forum_id, $forum_last_post_time, $f_mark_time = false, $mark_time_forum = false): Aktualizuje informace o sledování fóra.
20. tracking_serialize($input): Serializuje sledovací data.
21. tracking_unserialize($string, $max_depth = 3): Deserializuje sledovací data.
22. append_sid($url, $params = false, $is_amp = true, $session_id = false, $is_route = false): Přidává session ID k URL.
23. generate_board_url($without_script_path = false): Generuje URL pro diskuzní fórum.
24. redirect($url, $return = false, $disable_cd_check = false): Přesměruje na jinou stránku.
25. reapply_sid($url, $is_route = false): Aplikuje session ID na URL.
26. build_url($strip_vars = false): Vytváří URL.
27. meta_refresh($time, $url, $disable_cd_check = false): Generuje meta refresh hlavičku.
28. send_status_line($code, $message): Odesílá statusovou hlášku.
29. phpbb_request_http_version(): Získává verzi HTTP protokolu.
30. generate_link_hash($link_name): Generuje hash odkazu.
31. check_link_hash($token, $link_name): Kontroluje platnost hash odkazu.
32. add_form_key($form_name, $template_variable_suffix = ''): Přidává klíč formuláře.
33. check_form_key($form_name, $timespan = false): Kontroluje platnost klíče formuláře.
34. confirm_box($check, $title = '', $hidden = '', $html_body = 'confirm_body.html', $u_action = ''): Generuje potvrzovací dialog.
35. login_box($redirect = '', $l_explain = '', $l_success = '', $admin = false, $s_display = true): Generuje přihlašovací formulář.
36. login_forum_box($forum_data): Generuje přihlašovací formulář pro fórum.
37. _build_hidden_fields($key, $value, $specialchar, $stripslashes): Vytváří skrytá pole formuláře.
38. build_hidden_fields($field_ary, $specialchar = false, $stripslashes = false): Vytváří skrytá pole formuláře z asociativního pole.

39. parse_cfg_file($filename, $lines = false): Parzuje konfigurační soubor a vrací jeho obsah.
40. get_backtrace(): Získává zásobník volání funkcí.
41. get_preg_expression($mode): Vrací regulární výraz podle zadaného režimu.
42. get_censor_preg_expression($word): Vrací regulární výraz pro cenzuru založený na zadaném slově.
43. short_ipv6($ip, $length): Zkracuje IPv6 adresu na zadanou délku.
44. phpbb_ip_normalise(string $address): Normalizuje IPv4 nebo IPv6 adresu.
45. msg_handler($errno, $msg_text, $errfile, $errline): Zpracovává zprávy o chybách.
46. phpbb_filter_root_path($errfile): Filtruje kořenovou cestu ze zadaného souboru.
47. obtain_guest_count($item_id = 0, $item = 'forum'): Získává počet hostů online.
48. obtain_users_online($item_id = 0, $item = 'forum'): Získává seznam uživatelů online.
49. obtain_users_online_string($online_users, $item_id = 0, $item = 'forum'): Vytváří řetězec uživatelů online.
50. phpbb_optionget($bit, $data): Získává hodnotu bitu z dat.
51. phpbb_optionset($bit, $set, $data): Nastavuje hodnotu bitu v datech.
52. phpbb_quoteattr($data, $entities = null): Zapisuje řetězec jako atribut HTML tagu.
53. phpbb_get_user_avatar($user_row, $alt = 'USER_AVATAR', $ignore_config = false, $lazy = false): Získává URL uživatelského avataru.
54. phpbb_get_group_avatar($group_row, $alt = 'GROUP_AVATAR', $ignore_config = false, $lazy = false): Získává URL avataru skupiny.
55. phpbb_get_avatar($row, $alt, $ignore_config = false, $lazy = false): Získává URL avataru.
56. page_header($page_title = '', $display_online_list = false, $item_id = 0, $item = 'forum', $send_headers = true): Generuje hlavičku stránky.
57. phpbb_check_and_display_sql_report(\phpbb\request\request_interface $request, \phpbb\auth\auth $auth, \phpbb\db\driver\driver_interface $db): Kontroluje a zobrazuje zprávu o SQL reportu.
58. phpbb_generate_debug_output(\phpbb\db\driver\driver_interface $db, \phpbb\config\config $config, \phpbb\auth\auth $auth, \phpbb\user $user, \phpbb\event\dispatcher_interface $phpbb_dispatcher): Generuje výstup debugovacích informací.
59. page_footer($run_cron = true, $display_template = true, $exit_handler = true): Generuje patičku stránky.
60. garbage_collection(): Provede úklid.
61. exit_handler(): Handler pro ukončení provádění.
62. phpbb_user_session_handler(): Handler pro uživatelské relace.
63. phpbb_to_numeric($input): Konvertuje vstup na numerickou hodnotu.
64. phpbb_get_board_contact(\phpbb\config\config $config, $phpEx): Získává kontaktní informace o diskuzním fóru.
65. phpbb_get_board_contact_link(\phpbb\config\config $config, $phpbb_root_path, $phpEx): Získává odkaz na kontaktní informace o diskuzním fóru.

functions_convert.php (includes)

1. dec($var) - Sníží hodnotu proměnné o 1.
2. inc($var) - Zvýší hodnotu proměnné o 1.
3. is_positive($n) - Vrátí true, pokud je číslo kladné.
4. not($var) - Vrátí negaci zadaného výrazu.
5. str_to_bool($str) - Převede řetězec na boolean hodnotu.
6. is_empty($mixed) - Kontroluje, zda je proměnná prázdná.
7. str_to_primary_group($status) - Převede řetězec na primární skupinu.
8. is_item_locked($bool) - Vrátí true, pokud je položka uzamčená.
9. days_to_seconds($days) - Převede počet dnů na sekundy.
10. is_user_anonymous($user_id) - Vrátí true, pokud je uživatel anonymní.
11. auto_id($pad = 0) - Automaticky generuje ID s možností nastavení výchozího čísla.
12. set_user_type($user_active) - Nastavuje typ uživatele.
13. minutes_to_hours($minutes) - Převede počet minut na hodiny.
14. get_group_id($group_name) - Získává ID skupiny podle názvu.
15. is_topic_locked($bool) - Vrátí true, pokud je téma uzamčené.
16. make_uid($timestamp) - Vytvoří unikátní identifikátor.
17. validate_website($url) - Ověřuje platnost URL adresy.
18. null_to_zero($value) - Pokud je hodnota null, vrátí 0.
19. null_to_str($value) - Pokud je hodnota null, vrátí prázdný řetězec.
20. get_config_value($config_name) - Získává hodnotu konfiguračního klíče.
21. decode_ip($int_ip) - Dekóduje IP adresu.
22. decode_ban_ip($int_ip) - Dekóduje zabanovanou IP adresu.
23. mimetype($filename) - Získá MIME typ souboru.
24. remote_avatar_dims() - Získá rozměry vzdáleného avataru.
25. import_avatar_gallery($gallery_name = '', $subdirs_as_galleries = false) - Importuje galerii avatarů.
26. import_attachment_files($category_name = '') - Importuje soubory příloh.
27. attachment_forum_perms($forum_id) - Získá oprávnění pro fórum příloh.
28. base64_unpack($string) - Dekóduje Base64 řetězec.
29. _import_check($config_var, $source, $use_target) - Kontroluje importní proměnnou.
30. import_attachment($source, $use_target = false) - Importuje přílohu.
31. import_rank($source, $use_target = false) - Importuje hodnost.
32. import_smiley($source, $use_target = false) - Importuje smajlíka.
33. import_avatar($source, $use_target = false, $user_id = false) - Importuje avatar.
34. get_image_dim($source) - Získá rozměry obrázku.
35. get_smiley_width($src) - Získá šířku smajlíka.
36. get_smiley_height($src) - Získá výšku smajlíka.
37. get_smiley_dim($source, $axis) - Získá rozměry smajlíka na dané ose.
38. get_avatar_width($src, $func = false, $arg1 = false, $arg2 = false) - Získá šířku avataru.
39. get_avatar_height($src, $func = false, $arg1 = false, $arg2 = false) - Získá výšku avataru.
40. get_avatar_dim($src, $axis, $func = false, $arg1 = false, $arg2 = false) - Získá rozměry avataru na dané ose.
41. get_upload_avatar_dim($source, $axis) - Získá rozměry nahrávaného avataru.
42. get_gallery_avatar_dim($source, $axis) - Získá rozměry galerie avatarů.
43. get_remote_avatar_dim($src, $axis) - Získá rozměry vzdáleného avataru.
44. set_user_options() - Nastavuje možnosti uživatele.
45. search_indexing($message = '') - Indexuje pro vyhledávání.
46. make_unique_filename($filename) - Vytvoří unikátní název souboru.
47. words_unique(&$words) - Odstraní duplicitní slova.
48. add_user_group($group_id, $user_id, $group_leader = false) - Přidá uživateli skupinu.
49. user_group_auth($group, $select_query, $use_src_db) - Ověřuje oprávnění skupiny uživatele.
50. get_config() - Získává konfiguraci.
51. restore_config($schema) - Obnovuje konfiguraci.
52. update_folder_pm_count() - Aktualizuje počet soukromých zpráv ve složce.
53. path($path, $path_relative = true) - Vrátí cestu s ohledem na relativitu.
54. extract_variables_from_file($_filename) - Extrahuje proměnné ze souboru.
55. get_path($src_path, $src_url, $test_file) - Získá cestu pro zdrojový soubor.
56. compare_table($tables, $tablename, &$prefixes) - Porovnává tabulky.

57. mass_auth($ug_type, $forum_id, $ug_id, $acl_list, $setting = ACL_NO) - Hromadné nastavení oprávnění skupinám uživatelů ve fóru.
58. update_unread_count() - Aktualizuje počet nepřečtených zpráv.
59. add_default_groups() - Přidává výchozí skupiny.
60. add_groups_to_teampage() - Přidává skupiny na stránku týmu.
61. sync_post_count($offset, $limit) - Synchronizuje počet příspěvků.
62. add_bots() - Přidává boty.
63. update_dynamic_config() - Aktualizuje dynamickou konfiguraci.
64. update_topics_posted() - Aktualizuje témata, na která bylo odpovězeno.
65. fix_empty_primary_groups() - Opravuje prázdné primární skupiny.
66. remove_invalid_users() - Odebírá neplatné uživatele.
67. convert_bbcode($message, $convert_size = true, $extended_bbcodes = false) - Konvertuje BB kódy.
68. copy_file($src, $trg, $overwrite = false, $die_on_failure = true, $source_relative_path = true) - Kopíruje soubor.
69. copy_dir($src, $trg, $copy_subdirs = true, $overwrite = false, $die_on_failure = true, $source_relative_path = true) - Kopíruje adresář.
70. relative_base($path, $is_relative = true, $line = false, $file = false) - Vrátí relativní cestu.
71. get_smiley_display() - Získá zobrazení smajlíků.
72. fill_dateformat($user_dateformat) - Doplní formát datumu.

 

 

functions_user.php (includes)

1. user_get_id_name(&$user_id_ary, &$username_ary, $user_type = false, $update_references = false): Získává ID a jména uživatelů.
2. update_last_username(): Aktualizuje poslední uživatelské jméno.
3. user_update_name($old_name, $new_name): Aktualizuje uživatelské jméno.
4. user_add($user_row, $cp_data = false, $notifications_data = null): Přidává nového uživatele.
5. user_delete($mode, $user_ids, $retain_username = true): Mazání uživatelů.
6. user_active_flip($mode, $user_id_ary, $reason = INACTIVE_MANUAL): Aktivuje nebo deaktivuje uživatele.
7. user_ban($mode, $ban, $ban_len, $ban_len_other, $ban_exclude, $ban_reason, $ban_give_reason = ''): Zakazuje uživatele.
8. user_unban($mode, $ban): Zrušení zákazu uživatele.
9. user_ipwhois($ip): Provádí IP WHOIS pro uživatele.
10. validate_data($data, $val_ary): Validace dat.
11. validate_string($string, $optional = false, $min = 0, $max = 0): Validace řetězce.
12. validate_num($num, $optional = false, $min = 0, $max = 1E99): Validace čísla.
13. validate_date($date_string, $optional = false): Validace data.
14. validate_match($string, $optional = false, $match = ''): Validace shody.
15. validate_language_iso_name($lang_iso): Validace názvu jazyka.
16. phpbb_validate_timezone($timezone): Validace časového pásma.
17. validate_username($username, $allowed_username = false, $allow_all_names = false): Validace uživatelského jména.
18. validate_password($password): Validace hesla.
19. phpbb_validate_email($email, $config = null): Validace e-mailu.
20. validate_user_email($email, $allowed_email = false): Validace e-mailové adresy uživatele.
21. validate_jabber($jid): Validace Jabberu.
22. phpbb_validate_hex_colour($colour, $optional = false): Validace hexadecimální barvy.
23. phpbb_style_is_active($style_id): Zjištění, zda je styl aktivní.
24. avatar_delete($mode, $row, $clean_db = false): Mazání avataru.
25. get_avatar_filename($avatar_entry): Získává název souboru s avatarem.
26. phpbb_avatar_explanation_string(): Vrací vysvětlení k avatarmu.
27. group_create(&$group_id, $type, $name, $desc, $group_attributes, $allow_desc_bbcode = false, $allow_desc_urls = false, $allow_desc_smilies = false): Vytváří skupinu.
28. group_correct_avatar($group_id, $old_entry): Opravuje avatar skupiny.
29. avatar_remove_db($avatar_name): Odebírá avatar z databáze.
30. group_delete($group_id, $group_name = false): Mazání skupiny.
31. group_user_add($group_id, $user_id_ary = false, $username_ary = false, $group_name = false, $default = false, $leader = 0, $pending = 0, $group_attributes = false): Přidává uživatele do skupiny.
32. group_user_del($group_id, $user_id_ary = false, $username_ary = false, $group_name = false, $log_action = true): Odebírá uživatele ze skupiny.
33. remove_default_avatar($group_id, $user_ids): Odebírá výchozí avatar.
34. remove_default_rank($group_id, $user_ids): Odebírá výchozí hodnost.
35. group_user_attributes($action, $group_id, $user_id_ary = false, $username_ary = false, $group_name = false, $group_attributes = false): Nastavuje atributy uživatelů ve skupině.
36. group_validate_groupname($group_id, $group_name): Validuje název skupiny.
37. group_set_user_default($group_id, $user_id_ary, $group_attributes = false, $update_listing = false): Nastavuje výchozí skupinu pro uživatele.

38. get_group_name($group_id): Tato funkce získává název skupiny na základě zadaného ID skupiny.

39. group_memberships($group_id_ary = false, $user_id_ary = false, $return_bool = false): Tato funkce zjišťuje, zda je zadaný uživatel členem zadané skupiny. Pokud je parametr $return_bool nastaven na true, funkce vrátí buď true (členství je potvrzeno) nebo false (členství není potvrzeno). Tato funkce nevrací členství, které ještě nebylo potvrzeno.

40. group_update_listings($group_id): Tato funkce aktualizuje seznamy skupin, zejména ve foru a v seznamu členů.

41. remove_newly_registered($user_id, $user_data = false): Tato funkce odstraňuje uživatele z nově registrovaných uživatelů. Je nutné volat group_user_del zde, protože tato funkce zajistí, že vše je správně změněno. Tato funkce není zaznamenána v protokolu při odstraňování uživatelů z nově registrovaných uživatelů.

42. phpbb_get_banned_user_ids($user_ids = array(), $ban_end = true): Tato funkce získává ID uživatelů, kteří jsou zakázáni. Pokud je parametr $ban_end nastaven na true, vrátí se pouze ID uživatelů, jejichž ban již skončil.

43. phpbb_module_zebra($mode, &$module_row): Tato funkce je určena pro modul Zebra, který slouží k implementaci různých modulů na webu. Funkce zpracovává provádění modulu Zebra s ohledem na zadaný režim a řádek modulu.

Nápověda - Bash skript: Funkce a pole na hledání velikosti oblečení pro ženy

Pole EU_dress_sizes

• Popis: Pole obsahující názvy EU velikostí oblečení.
• Použití: EU_dress_sizes[index]

Pole eu_us_dress_sizes

• Popis: Pole obsahující páry rozměrů EU a US/UK velikostí oblečení.
• Použití: eu_us_dress_sizes[index*2] (EU rozměr), eu_us_dress_sizes[index*2+1] (US/UK rozměr)

Pole eu_over_bust

• Popis: Pole obsahující názvy a minimální a maximální rozměry míru přes prsa pro jednotlivé velikosti podprsenek.
• Použití:
  • Název velikosti: eu_over_bust[i*25]
  • Minimální míra přes prsa: eu_over_bust[i*25 + j]
  • Maximální míra přes prsa: eu_over_bust[i*25 + j + 1]

Pole eu_hips_measures

• Popis: Pole obsahující minimální a maximální rozměry míru boků pro jednotlivé EU velikosti.
• Použití:
  • Minimální míra boků: eu_hips_measures[i*2]
  • Maximální míra boků: eu_hips_measures[i*2 + 1]

Pole eu_under_bust_measures

• Popis: Pole obsahující minimální a maximální rozměry míru pod prsy pro jednotlivé EU velikosti.
• Použití:
  • Minimální míra pod prsy: eu_under_bust_measures[i*2]
  • Maximální míra pod prsy: eu_under_bust_measures[i*2 + 1]

Toto jsou popisy jednotlivých polí a způsob, jakým můžete získávat informace z těchto polí. Můžete je využít pro další zpracování dat v rámci vašich funkcí.

Funkce

Funkce get_sizes

• Popis: Slouží k výpisu velikostí podle jména a rozměrů v EU, US/UK.
• Argumenty: size (velikost), unit (jednotka - cm nebo in), verbose (volitelný argument pro podrobný výpis)
• Použití: get_sizes "75" "cm" "verbose"

Funkce get_unit

• Popis: Zjišťuje jednotky zadaného rozměru nebo velikosti.
• Argumenty: input (vstupní hodnota)
• Použití: get_unit "65cm"

Funkce get_sizes_by_name

• Popis: Vypisuje velikosti podle zadaného písmene nebo slova.
• Argumenty: input (vstupní označení)
• Použití: get_sizes_by_name "XL"

Funkce get_all_sizes_for_under_bust_and_hips_by_name

• Popis: Vypisuje všechny rozměry pro zadané označení velikosti (podprsenky a boky).
• Argumenty: size_name (název velikosti), verbose (volitelný argument pro podrobný výpis)
• Použití: get_all_sizes_for_under_bust_and_hips_by_name "M" "verbose"

Funkce get_sizes_range_for_under_bust_and_hips_by_name

• Popis: Vypisuje rozsahy rozměrů pro zadané označení velikosti (podprsenky a boky).
• Argumenty: size_name (název velikosti), verbose (volitelný argument pro podrobný výpis)
• Použití: get_sizes_range_for_under_bust_and_hips_by_name "M"

Funkce eu_dress_find_bra_size

• Popis: Hledá velikost podprsenky podle obvodu prsou.
• Argumenty: bust_measurement (obvod prsou)
• Použití: eu_dress_find_bra_size 81

Funkce eu_dress_print_size_ranges

• Popis: Vypisuje rozsahy velikostí podprsenek podle jména.
• Argumenty: size (název velikosti)
• Použití: eu_dress_print_size_ranges "AA"

Funkce find_bust_size_by_measurement

• Popis: Hledá velikost podle obvodu prsou a obvodu pod prsy.
• Argumenty: bust_input (obvod prsou), under_bust_input (obvod pod prsy)
• Použití: find_bust_size_by_measurement 81 63

Upozornění

Toto není kompletní výpis funkcí, protože hlavním nástrojem jsou funkce pro práci s mírama a zjištění správné velikosti podprsenky. Nesmírně důležité pro získání realistických proporcí 3D modelu.