diff options
Diffstat (limited to 'source/zh-TW/helpcontent2/source/text/sbasic/shared/03.po')
| -rw-r--r-- | source/zh-TW/helpcontent2/source/text/sbasic/shared/03.po | 2630 |
1 files changed, 2629 insertions, 1 deletions
diff --git a/source/zh-TW/helpcontent2/source/text/sbasic/shared/03.po b/source/zh-TW/helpcontent2/source/text/sbasic/shared/03.po index bb5bad2cc4e..4d060800008 100644 --- a/source/zh-TW/helpcontent2/source/text/sbasic/shared/03.po +++ b/source/zh-TW/helpcontent2/source/text/sbasic/shared/03.po @@ -3,7 +3,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n" -"POT-Creation-Date: 2020-10-27 12:31+0100\n" +"POT-Creation-Date: 2021-01-14 18:09+0100\n" "PO-Revision-Date: 2018-07-12 14:38+0000\n" "Last-Translator: Anonymous Pootle User\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -16,6 +16,105 @@ msgstr "" "X-Generator: LibreOffice\n" "X-POOTLE-MTIME: 1531406281.000000\n" +#. QCGe5 +#: lib_ScriptForge.xhp +msgctxt "" +"lib_ScriptForge.xhp\n" +"tit\n" +"help.text" +msgid "ScriptForge Library" +msgstr "" + +#. NXPBo +#: lib_ScriptForge.xhp +msgctxt "" +"lib_ScriptForge.xhp\n" +"hd_id31529004750471\n" +"help.text" +msgid "<variable id=\"ScriptForge_lib\"><link href=\"text/sbasic/shared/03/lib_ScriptForge.xhp\" name=\"ScriptForge library\">The <item type=\"literal\">ScriptForge</item> Library</link></variable>" +msgstr "" + +#. nMjDG +#: lib_ScriptForge.xhp +msgctxt "" +"lib_ScriptForge.xhp\n" +"bm_id491529070339774\n" +"help.text" +msgid "<bookmark_value>BASIC ScriptForge library</bookmark_value>" +msgstr "" + +#. MHX92 +#: lib_ScriptForge.xhp +msgctxt "" +"lib_ScriptForge.xhp\n" +"par_id901528999850603\n" +"help.text" +msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#basiclibrarynote\" markup=\"keep\"/><br/> <item type=\"literal\">GlobalScope.BasicLibraries.LoadLibrary(\"ScriptForge\")</item>" +msgstr "" + +#. WLejn +#: lib_ScriptForge.xhp +msgctxt "" +"lib_ScriptForge.xhp\n" +"par_id781606153472028\n" +"help.text" +msgid "The described modules and classes are invoked from user scripts as \"Services\". A generic constructor of those services has been designed for that purpose:" +msgstr "" + +#. gDUck +#: lib_ScriptForge.xhp +msgctxt "" +"lib_ScriptForge.xhp\n" +"bas_id201606153529501\n" +"help.text" +msgid "[ScriptForge.][Services.]CreateScriptService(\"servicename\"[, arg0, Arg1, ...])" +msgstr "" + +#. dUu2P +#: lib_ScriptForge.xhp +msgctxt "" +"lib_ScriptForge.xhp\n" +"par_id891606153700196\n" +"help.text" +msgid "Services from external libraries can be registered with the <literal>RegisterScriptServices(...)</literal> method in order to extend the set of available services." +msgstr "" + +#. em6cF +#: lib_ScriptForge.xhp +msgctxt "" +"lib_ScriptForge.xhp\n" +"par_id851605659675843\n" +"help.text" +msgid "<literal>ScriptForge</literal> Basic library is available from %PRODUCTNAME 7.1 onwards." +msgstr "" + +#. BKpy6 +#: lib_ScriptForge.xhp +msgctxt "" +"lib_ScriptForge.xhp\n" +"par_id1001606151139039\n" +"help.text" +msgid "FileSystem Service" +msgstr "" + +#. 6gvZc +#: lib_ScriptForge.xhp +msgctxt "" +"lib_ScriptForge.xhp\n" +"par_id331608220104798\n" +"help.text" +msgid "<emph>Note:</emph> Other <literal>ScriptForge</literal> undescribed modules are reserved for internal use. Their content is subject to change without notice." +msgstr "" + +#. grNoF +#: lib_ScriptForge.xhp +msgctxt "" +"lib_ScriptForge.xhp\n" +"par_id851506659675843\n" +"help.text" +msgid "All <literal>ScriptForge</literal> Basic routines or identifiers that are prefixed with an underscore character \"_\" are reserved for internal use. They are not meant be used in Basic macros." +msgstr "" + #. p9BFG #: lib_depot.xhp msgctxt "" @@ -169,6 +268,69 @@ msgctxt "" msgid "<bookmark_value>BASIC Gimmicks library</bookmark_value>" msgstr "" +#. D3BJr +#: lib_gimmicks.xhp +msgctxt "" +"lib_gimmicks.xhp\n" +"hd_id841593518085848\n" +"help.text" +msgid "Description" +msgstr "" + +#. kN4F6 +#: lib_gimmicks.xhp +msgctxt "" +"lib_gimmicks.xhp\n" +"par_id921593518140986\n" +"help.text" +msgid "The <emph>Gimmicks</emph> library is used by the <emph>AutoText...</emph> wizard." +msgstr "" + +#. kHzUe +#: lib_gimmicks.xhp +msgctxt "" +"lib_gimmicks.xhp\n" +"par_id481593518247400\n" +"help.text" +msgid "Its entry points are:" +msgstr "" + +#. FCBXE +#: lib_gimmicks.xhp +msgctxt "" +"lib_gimmicks.xhp\n" +"par_id381593519742529\n" +"help.text" +msgid "Selecting <menuitem>Tools</menuitem> - <menuitem>AutoText</menuitem> loads the following library in memory:" +msgstr "" + +#. hn8Dw +#: lib_gimmicks.xhp +msgctxt "" +"lib_gimmicks.xhp\n" +"par_id691593519646426\n" +"help.text" +msgid "Basic routine name conflicts may exist when multiple Basic libraries are loaded in memory." +msgstr "" + +#. FGEdL +#: lib_gimmicks.xhp +msgctxt "" +"lib_gimmicks.xhp\n" +"par_id1001593520257636\n" +"help.text" +msgid "<link href=\"text/sbasic/shared/03/lib_tools.xhp\" name=\"Tools library\">Tools</link> Basic library" +msgstr "" + +#. 9DVHn +#: lib_gimmicks.xhp +msgctxt "" +"lib_gimmicks.xhp\n" +"par_id251593518523704\n" +"help.text" +msgid "<link href=\"text/swriter/guide/autotext.xhp\" name=\"Using AutoText\">Using AutoText</link> explains what the <emph>Gimmicks</emph> library does." +msgstr "" + #. EwqqW #: lib_importwiz.xhp msgctxt "" @@ -708,3 +870,2469 @@ msgctxt "" "help.text" msgid "This library is not used by %PRODUCTNAME Basic." msgstr "" + +#. Ns4rA +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"tit\n" +"help.text" +msgid "ScriptForge.Array service (SF_Array)" +msgstr "" + +#. GRQ79 +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"bm_id781582391760253\n" +"help.text" +msgid "<link href=\"text/sbasic/shared/03/sf_array.xhp\" name=\"ScriptForge.Array Service\"><literal>ScriptForge</literal>.<literal>Array</literal> service</link>" +msgstr "" + +#. SyLSL +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id991582454416549\n" +"help.text" +msgid "Provides a collection of methods for manipulating and transforming arrays of one dimension (vectors) and arrays of two dimensions (matrices). This includes set operations, sorting, importing to and exporting from text files." +msgstr "" + +#. WjgHr +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id681609955015503\n" +"help.text" +msgid "Arrays with more than two dimensions cannot be used with the methods in this service, the only exception being the <literal>CountDims</literal> method that accepts Arrays with any number of dimensions." +msgstr "" + +#. CL5tT +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id651582454426538\n" +"help.text" +msgid "Array items may contain any type of value, including (sub)arrays." +msgstr "" + +#. hdC3J +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"hd_id981586595097630\n" +"help.text" +msgid "Service invocation" +msgstr "" + +#. CPbHQ +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id141609955500101\n" +"help.text" +msgid "Before using the <literal>Array</literal> service the <literal>ScriptForge</literal> library needs to be loaded using:" +msgstr "" + +#. FDqCD +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id461609955633383\n" +"help.text" +msgid "Loading the library will create the <literal>SF_Array</literal> object that can be used to call the methods in the <literal>Array</literal> service." +msgstr "" + +#. AAdGG +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id63158659509728\n" +"help.text" +msgid "The following code snippets show the various ways to call methods in the <literal>Array</literal> service (the <literal>Append</literal> method is used as an example):" +msgstr "" + +#. qfbfm +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id571609956486468\n" +"help.text" +msgid "The <literal>CreateScriptService</literal> method is only available after you have loaded the <literal>ScriptForge</literal> library." +msgstr "" + +#. yDQWY +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id651606319520519\n" +"help.text" +msgid "Methods" +msgstr "" + +#. qDYGe +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id191582454485250\n" +"help.text" +msgid "The first argument of most methods is the array object to be considered. It is always passed by reference and left unchanged. Methods such as Append, Prepend, etc return a new array object after their execution." +msgstr "" + +#. n84zh +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id931582548992953\n" +"help.text" +msgid "Appends the items listed as arguments to the end of the input array." +msgstr "" + +#. EGFyc +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id471582548992953\n" +"help.text" +msgid "<emph>Array_1D</emph> : the pre-existing array, may be empty." +msgstr "" + +#. FfdqS +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id531582548992953\n" +"help.text" +msgid "<emph>arg0, ...</emph> : a list of items to append to Array_1D." +msgstr "" + +#. SkBjv +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id241582549679173\n" +"help.text" +msgid "Appends a new column to the right side of a two dimensional array. The resulting array has the same lower bounds as the initial two dimensional array." +msgstr "" + +#. iGG8W +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id461582549679175\n" +"help.text" +msgid "<emph>Array_2D</emph> : the pre-existing array, may be empty. If that array has only one dimension, it is considered as the first column of the resulting two-dimensional array." +msgstr "" + +#. sBuFx +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id991582549679175\n" +"help.text" +msgid "<emph>New_Column</emph> : a 1-dimensional array with as many items as there are rows in <literal>Array_2D</literal>." +msgstr "" + +#. KDB9L +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id941582551396374\n" +"help.text" +msgid "Append to the bottom of a two dimension array a new row. The resulting array has the same lower bounds as the initial two dimension array." +msgstr "" + +#. uKD5Q +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id631582551461984\n" +"help.text" +msgid "<emph>Array_2D</emph> : the pre-existing array, may be empty. If that array has 1 dimension, it is considered as the first row of the resulting 2 dimension array." +msgstr "" + +#. ZmnBs +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id101582551483685\n" +"help.text" +msgid "<emph>Row</emph> : a 1D array with as many items as there are columns in Array_2D." +msgstr "" + +#. aM65P +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id391582552517870\n" +"help.text" +msgid "Check if a one dimension array contains a certain number, text or date. Text comparison can be case-sensitive or not. <br/>Sorted input arrays must be filled homogeneously, meaning all items must be scalars of the same type (<literal>Empty</literal> and <literal>Null</literal> items are forbidden). <br/>The result of the method is unpredictable when the array is announced as sorted and is in reality not. <br/>A binary search is done when the array is sorted, otherwise, it is simply scanned from top to bottom and <literal>Empty</literal> and <literal>Null</literal> items are ignored." +msgstr "" + +#. ho7Rr +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id451582552517871\n" +"help.text" +msgid "<emph>Array_1D</emph> : the array to scan." +msgstr "" + +#. ADj73 +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id221582552517872\n" +"help.text" +msgid "<emph>ToFind</emph> : a number, a date or a string to find." +msgstr "" + +#. 3iQDC +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id981582552517872\n" +"help.text" +msgid "<emph>CaseSensitive</emph> : Only for string comparisons, default = <literal>False</literal>." +msgstr "" + +#. NBAGy +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id641582553128490\n" +"help.text" +msgid "<emph>SortOrder</emph> : \"ASC\", \"DESC\" or \"\" (= not sorted, default)" +msgstr "" + +#. pG3HD +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id71582557214489\n" +"help.text" +msgid "Store the content of a 2-columns array into a <literal>ScriptForge</literal> <link href=\"text/sbasic/shared/03/sf_dictionary.xhp\" name=\"dictionary\">Dictionary</link> object. <br/>The key will be extracted from the first column, the item from the second." +msgstr "" + +#. CMssn +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id561582557214489\n" +"help.text" +msgid "<emph>Array_1D</emph> : the first column must contain exclusively strings with a length > 0, in any order." +msgstr "" + +#. fngum +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id671582558126025\n" +"help.text" +msgid "Count the number of dimensions of an array. The result can be greater than two. <br/>If the argument is not an array, returns -1 <br/>If the array is not initialized, returns 0." +msgstr "" + +#. tGdVE +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id771582558126027\n" +"help.text" +msgid "<emph>Array_ND</emph> : the array to examine." +msgstr "" + +#. n2AxD +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id91582558644287\n" +"help.text" +msgid "Build a set, as a zero-based array, by applying the difference operator on the two input arrays. Resulting items originate from the first array and not from the second. <br/>The resulting array is sorted in ascending order. <br/>Both input arrays must be filled homogeneously, their items must be scalars of the same type. <literal>Empty</literal> and <literal>Null</literal> items are forbidden. <br/>Text comparison can be case sensitive or not." +msgstr "" + +#. NGKHH +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id271582558644287\n" +"help.text" +msgid "<emph>Array1_1D</emph> : A 1 dimension reference array, whose items are examined for removal." +msgstr "" + +#. gPEJE +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id141582558644287\n" +"help.text" +msgid "<emph>Array2_1D</emph> : A 1 dimension array, whose items are subtracted from the first input array." +msgstr "" + +#. z2QT8 +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id291582559651473\n" +"help.text" +msgid "<emph>CaseSensitive</emph> : Only if the arrays are populated with strings, default = <literal>False</literal>." +msgstr "" + +#. mzRus +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id941586179707156\n" +"help.text" +msgid "Write all items of the array sequentially to a text file. If the file exists already, it will be overwritten without warning." +msgstr "" + +#. igBEo +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id100158617970719\n" +"help.text" +msgid "<emph>Array_1D</emph> : The array to export. It must contain only strings." +msgstr "" + +#. gXh53 +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id101586179707232\n" +"help.text" +msgid "<emph>FileName</emph> : the name of the text file containing the data. The name is expressed as given by the current <literal>FileNaming</literal> property of the <literal>SF_FileSystem</literal> service. Default = any (both the URL format and the native operating system format are admitted)." +msgstr "" + +#. wqGeq +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id70158617970791\n" +"help.text" +msgid "<emph>Encoding</emph> : The character set that should be used. Use one of the names listed in <link href=\"https://www.iana.org/assignments/character-sets/character-sets.xhtml\" name=\"IANA character sets\">IANA character sets</link>. Note that %PRODUCTNAME may not implement all existing character sets. Default is \"UTF-8\"." +msgstr "" + +#. TtHbe +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id171582560281082\n" +"help.text" +msgid "Extract from a two dimension array a specific column as a new array. <br/>Its lower <literal>LBound</literal> and upper <literal>UBound</literal> boundaries are identical to that of the first dimension of the input array." +msgstr "" + +#. EnMKp +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id301582560281083\n" +"help.text" +msgid "<emph>Array_2D</emph> : The array from which to extract." +msgstr "" + +#. z3M4K +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id421582560281084\n" +"help.text" +msgid "<emph>ColumnIndex</emph> : The column number to extract - must be in the interval <literal>[LBound, UBound]</literal>." +msgstr "" + +#. is3Zq +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id211582561467219\n" +"help.text" +msgid "Extract from a two dimension array a specific row as a new array. <br/>Its lower <literal>LBound</literal> and upper <literal>UBound</literal> boundaries are identical to that of the second dimension of the input array." +msgstr "" + +#. BY5S6 +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id911582561542889\n" +"help.text" +msgid "<emph>Array_2D</emph> : The array from which to extract." +msgstr "" + +#. bdCja +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id441582561551202\n" +"help.text" +msgid "<emph>RowIndex</emph> : The row number to extract - must be in the interval <literal>[LBound, UBound]</literal>." +msgstr "" + +#. nGy3S +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id431585757822181\n" +"help.text" +msgid "Stack all single items of an array and all items in its subarrays into one new array without subarrays. Empty subarrays are ignored and subarrays with a number of dimensions greater than one are not flattened." +msgstr "" + +#. j2LdZ +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id431585757822869\n" +"help.text" +msgid "<emph>Array_1D</emph> : the pre-existing array, may be empty." +msgstr "" + +#. DDwn4 +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id291610040786530\n" +"help.text" +msgid "You can use the <literal>Flatten</literal> method along with other methods such as <literal>Append</literal> or <literal>Prepend</literal> to concatenate a set of 1D arrays into a single 1D array." +msgstr "" + +#. 6aPDG +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"hd_id361610040935558\n" +"help.text" +msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functexample\"/>" +msgstr "" + +#. XE4hJ +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id941610040961148\n" +"help.text" +msgid "Next is an example of how the methods <literal>Flatten</literal> and <literal>Append</literal> can be combined to concatenate three arrays." +msgstr "" + +#. 3Gm5m +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id611585561482373\n" +"help.text" +msgid "Import the data contained in a comma-separated values (CSV) file. The comma may be replaced by any character." +msgstr "" + +#. Fft9z +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id41585562158392\n" +"help.text" +msgid "The applicable CSV format is described in <link href=\"https://tools.ietf.org/html/rfc4180\" name=\"CSV formats\">IETF Common Format and MIME Type for CSV Files</link>." +msgstr "" + +#. PT3Pq +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id641585562341028\n" +"help.text" +msgid "Each line in the file contains a full record (line splitting is not allowed). <br/>However sequences like <literal>\\n</literal>, <literal>\\t</literal>, ... are left unchanged. Use <literal>SF_String</literal>.Unescape() method to manage them." +msgstr "" + +#. dCYB3 +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id231585562475026\n" +"help.text" +msgid "The method returns a two dimension array whose rows correspond to a single record read in the file and whose columns correspond to a field of the record. No check is made about the coherence of the field types across columns. A best guess will be made to identify numeric and date types." +msgstr "" + +#. FMKSo +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id101585562548245\n" +"help.text" +msgid "If a line contains less or more fields than the first line in the file, an exception will be raised. Empty lines however are simply ignored. If the size of the file exceeds the number of items limit (see inside the code), a warning is raised and the array is truncated." +msgstr "" + +#. zbUFJ +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id441585561482121\n" +"help.text" +msgid "<emph>FileName</emph> : the name of the text file containing the data. The name is expressed as given by the current <literal>FileNaming</literal> property of the <literal>SF_FileSystem</literal> service. Default = any (both the URL format and the native operating system format are admitted)." +msgstr "" + +#. eQNz4 +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id251585561482929\n" +"help.text" +msgid "<emph>Delimiter</emph> : A single character, usually, a comma, a semicolon or a TAB character. Default = <literal>\",\"</literal>." +msgstr "" + +#. xZgEn +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id631585563491559\n" +"help.text" +msgid "<emph>DateFormat</emph> : A special mechanism handles dates when <literal>DateFormat</literal> is either \"YYYY-MM-DD\", \"DD-MM-YYYY\" or \"MM-DD-YYYY\". The dash (-) may be replaced by a dot (.), a slash (/) or a space. Other date formats will be ignored. Dates defaulting to \"\" are considered as normal text." +msgstr "" + +#. MVUwS +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id61585564516409\n" +"help.text" +msgid "Given this CSV file:" +msgstr "" + +#. H6QdF +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"bas_id891585564144231\n" +"help.text" +msgid "Name,DateOfBirth,Address,City" +msgstr "" + +#. KTHbd +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"bas_id621585561482783\n" +"help.text" +msgid "MsgBox a(0, 3) ' City" +msgstr "" + +#. xCx7D +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id211582562721860\n" +"help.text" +msgid "Look in a one dimension array for a number, a string or a date. Text comparison can be case-sensitive or not. <br/>If the array is sorted it must be filled homogeneously, which means that all items must be scalars of the same type (<literal>Empty</literal> and <literal>Null</literal> items are forbidden). <br/>The result of the method is unpredictable when the array is announced as sorted and actually is not. <br/>A binary search is performed on sorted arrays. Otherwise, arrays are simply scanned from top to bottom and <literal>Empty</literal> and <literal>Null</literal> items are ignored. <br/> <br/>The method returns <literal>LBound(input array) - 1</literal> if the search was not successful." +msgstr "" + +#. mg7DA +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id315825627687760\n" +"help.text" +msgid "<emph>Array_1D</emph> : the array to scan." +msgstr "" + +#. 4CuFE +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id511582562775516\n" +"help.text" +msgid "<emph>ToFind</emph> : a number, a date or a string to find." +msgstr "" + +#. 4YGrJ +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id311582562787187\n" +"help.text" +msgid "<emph>CaseSensitive</emph> : Only for string comparisons, default = <literal>False</literal>." +msgstr "" + +#. KHzrp +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id421582562794501\n" +"help.text" +msgid "<emph>SortOrder</emph> : <literal>\"ASC\"</literal>, <literal>\"DESC\"</literal> or <literal>\"\"</literal> (= not sorted, default)" +msgstr "" + +#. AWJHj +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id911582626951109\n" +"help.text" +msgid "Insert before a given index of the input array the items listed as arguments. <br/>Arguments are inserted blindly. Each of them might be either a scalar of any type or a subarray." +msgstr "" + +#. 32Nui +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id251582626951111\n" +"help.text" +msgid "<emph>Array_1D</emph> : the pre-existing array, may be empty." +msgstr "" + +#. BYjmR +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id361582626951111\n" +"help.text" +msgid "<emph>Before</emph> : the index before which to insert; must be in the interval <literal>[LBound, UBound + 1]</literal>." +msgstr "" + +#. uEZky +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id41582626951111\n" +"help.text" +msgid "<emph>arg0, ...</emph> : a list of items to insert inside <literal>Array_1D</literal>." +msgstr "" + +#. RLTGT +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id441582627664147\n" +"help.text" +msgid "Insert in a sorted array a new item on its place. <br/>The array must be filled homogeneously, meaning that all items must be scalars of the same type. <br/><literal>Empty</literal> and <literal>Null</literal> items are forbidden." +msgstr "" + +#. 7q2JZ +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id121582627664147\n" +"help.text" +msgid "<emph>Array_1D</emph> : The array to sort." +msgstr "" + +#. GygFp +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id315826276641480\n" +"help.text" +msgid "<emph>Item</emph> : The scalar value to insert, of the same type as the existing array items." +msgstr "" + +#. LFGs8 +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id415826279771170\n" +"help.text" +msgid "<emph>SortOrder</emph> : <literal>\"ASC\"</literal> (default) or <literal>\"DESC\"</literal>." +msgstr "" + +#. CwMCp +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id701582627970037\n" +"help.text" +msgid "<emph>CaseSensitive</emph> : Only for string comparisons, default = <literal>False</literal>." +msgstr "" + +#. t9UFn +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id71582629177169\n" +"help.text" +msgid "Build a set, as a zero-based array, by applying the intersection set operator on the two input arrays. Resulting items are contained in both arrays. <br/>The resulting array is sorted in ascending order. <br/>Both input arrays must be filled homogeneously, in other words all items must be scalars of the same type. <literal>Empty</literal> and <literal>Null</literal> items are forbidden. <br/>Text comparison can be case sensitive or not." +msgstr "" + +#. NxFNB +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id881582629216169\n" +"help.text" +msgid "<emph>Array1_1D</emph> : The first input array." +msgstr "" + +#. UPgfZ +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id191582629223038\n" +"help.text" +msgid "<emph>Array2_1D</emph> : The second input array." +msgstr "" + +#. xHAQT +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id71582629230275\n" +"help.text" +msgid "<emph>CaseSensitive</emph> : Applies to arrays populated with text items, default = <literal>False</literal>." +msgstr "" + +#. cirZm +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id431583064481679\n" +"help.text" +msgid "Join a two-dimensional array with two delimiters, one for the columns, one for the rows." +msgstr "" + +#. 6Cm9k +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id821583064481534\n" +"help.text" +msgid "<emph>Array_2D</emph> : Each item must be either text, a number, a date or a boolean. <br/>Dates are transformed into the YYYY-MM-DD hh:mm:ss format. <br/>Invalid items are replaced by a zero-length string." +msgstr "" + +#. QxLvV +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id171583066989446\n" +"help.text" +msgid "<emph>ColumnDelimiter</emph> : Delimits each column (default = Tab/Chr(9))." +msgstr "" + +#. f9DAW +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id431583067008842\n" +"help.text" +msgid "<emph>RowDelimiter</emph>: delimits each row (default = LineFeed/Chr(10))" +msgstr "" + +#. bB9bB +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id541583067456273\n" +"help.text" +msgid "<emph>Quote</emph> : if <literal>True</literal>, protect strings with double quotes. The default is <literal>False</literal>." +msgstr "" + +#. CEE7o +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id731582630075045\n" +"help.text" +msgid "Prepend at the beginning of the input array the items listed as arguments." +msgstr "" + +#. j5HX9 +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id321582630107068\n" +"help.text" +msgid "<emph>Array_1D</emph> : the pre-existing array, may be empty." +msgstr "" + +#. tMmfH +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id915826301138550\n" +"help.text" +msgid "<emph>arg0, ...</emph> : a list of items to prepend to <literal>Array_1D</literal>." +msgstr "" + +#. BokfB +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id91582643223166\n" +"help.text" +msgid "Prepend to the left side of a two dimension array a new column. The resulting array has the same lower boundaries as the initial two dimension array." +msgstr "" + +#. iBZMy +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id621582643223545\n" +"help.text" +msgid "<emph>Array_2D</emph> : the pre-existing array, may be empty. If that array has 1 dimension, it is considered as the last column of the resulting 2 dimension array." +msgstr "" + +#. pferZ +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id381582643223870\n" +"help.text" +msgid "<emph>Column</emph> : a 1 dimension array with as many items as there are rows in <literal>Array_2D</literal>." +msgstr "" + +#. xAruD +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id851582643611291\n" +"help.text" +msgid "Prepend at the beginning of a two dimension array a new row. The resulting array has the same lower boundaries as the initial two dimension array." +msgstr "" + +#. gN2hG +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id991582643611645\n" +"help.text" +msgid "<emph>Array_2D</emph> : the pre-existing array, may be empty. If that array has 1 dimension, it is considered as the last row of the resulting 2 dimension array." +msgstr "" + +#. mZ2uk +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id321582643611415\n" +"help.text" +msgid "<emph>Row</emph> : a 1 dimension array containing as many items as there are rows in <literal>Array_2D</literal>." +msgstr "" + +#. WmxAd +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id441582648204012\n" +"help.text" +msgid "Initialize a new zero-based array with numeric values." +msgstr "" + +#. ArYNC +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id591582648204013\n" +"help.text" +msgid "<emph>From</emph> : value of the first item." +msgstr "" + +#. DFUaf +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id31582648204013\n" +"help.text" +msgid "<emph>UpTo</emph> : The last item should not exceed <literal>UpTo</literal>." +msgstr "" + +#. AJLMR +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id581582648204014\n" +"help.text" +msgid "<emph>ByStep</emph> : The difference between two successive items (default = 1)." +msgstr "" + +#. SbVGG +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id451582648806764\n" +"help.text" +msgid "Return the reversed one dimension input array." +msgstr "" + +#. zvyHb +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id31582648806765\n" +"help.text" +msgid "<emph>Array_1D</emph> : The array to reverse." +msgstr "" + +#. FGBiV +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id151582649200088\n" +"help.text" +msgid "Return a random permutation of a one dimension array." +msgstr "" + +#. 3NPAi +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id11582649200088\n" +"help.text" +msgid "<emph>Array_1D</emph> : The array to shuffle." +msgstr "" + +#. ATiL8 +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"bas_id611582649200089\n" +"help.text" +msgid "' Unpredictable" +msgstr "" + +#. 9Xgaq +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id111586184185502\n" +"help.text" +msgid "Return a subset of a one dimension array." +msgstr "" + +#. QavhQ +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id201586184185438\n" +"help.text" +msgid "<emph>Array_1D</emph> : The array to slice." +msgstr "" + +#. hVu6E +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id921586184482370\n" +"help.text" +msgid "<emph>From</emph> : The lower index in <literal>Array_1D</literal> of the subarray to extract (<literal>From</literal> included)" +msgstr "" + +#. 968pV +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id211586184471488\n" +"help.text" +msgid "<emph>UpTo</emph> : The upper index in <literal>Array_1D</literal> of the subarray to extract (<literal>UpTo</literal> included). Default = upper bound of <literal>Array_1D</literal>. If <literal>UpTo</literal> < <literal>From</literal> then the returned array is empty." +msgstr "" + +#. oBwcF +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id171582649483675\n" +"help.text" +msgid "Sort a one dimension array in ascending or descending order. Text comparisons can be case-sensitive or not. <br/>The array must be filled homogeneously, which means that items must be scalars of the same type. <br/><literal>Empty</literal> and <literal>Null</literal> items are allowed. Conventionally <literal>Empty</literal> < <literal>Null</literal> < any other scalar value." +msgstr "" + +#. ABuRp +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id71158264948346\n" +"help.text" +msgid "<emph>Array_1D</emph> : The array to sort." +msgstr "" + +#. zSoB2 +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id21582649483175\n" +"help.text" +msgid "<emph>SortOrder</emph> : <literal>\"ASC\"</literal> (default) or <literal>\"DESC\"</literal>." +msgstr "" + +#. cYvQY +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id301582649483187\n" +"help.text" +msgid "<emph>CaseSensitive</emph> : Only for string comparisons, default = <literal>False</literal>." +msgstr "" + +#. 6CkrZ +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id801582650186957\n" +"help.text" +msgid "Return a permutation of the columns of a two dimension array, sorted on the values of a given row. <br/>The row must be filled homogeneously, which means that all items must be scalars of the same type. <br/><literal>Empty</literal> and <literal>Null</literal> items are allowed. Conventionally <literal>Empty</literal> < <literal>Null</literal> < any other scalar value." +msgstr "" + +#. EGBcR +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id921582650186869\n" +"help.text" +msgid "<emph>Array_1D</emph> : The array to sort." +msgstr "" + +#. cBvze +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id311582650186221\n" +"help.text" +msgid "<emph>RowIndex</emph> : The index of the row to sort the columns on." +msgstr "" + +#. hJKGY +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id34158265018698\n" +"help.text" +msgid "<emph>SortOrder</emph> : <literal>\"ASC\"</literal> (default) or <literal>\"DESC\"</literal>." +msgstr "" + +#. UdJPV +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id91158265018699\n" +"help.text" +msgid "<emph>CaseSensitive</emph> : Only for string comparisons, default = <literal>False</literal>." +msgstr "" + +#. 7GkBx +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id751582650954576\n" +"help.text" +msgid "Return a permutation of the rows of a two dimension array, sorted on the values of a given column. <br/>The column must be filled homogeneously, therefore all items must be scalars of the same type. <br/><literal>Empty</literal> and <literal>Null</literal> items are allowed. Conventionally <literal>Empty</literal> < <literal>Null</literal> < any other scalar value." +msgstr "" + +#. MCFqq +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id621582650954370\n" +"help.text" +msgid "<emph>Array_1D</emph> : The array to sort." +msgstr "" + +#. FeVrv +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id361582650954796\n" +"help.text" +msgid "<emph>RowIndex</emph> : The index of the column to sort the rows on." +msgstr "" + +#. rxXiT +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id471582650954416\n" +"help.text" +msgid "<emph>SortOrder</emph> : <literal>\"ASC\"</literal> (default) or <literal>\"DESC\"</literal>." +msgstr "" + +#. u4SYA +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id111582650954690\n" +"help.text" +msgid "<emph>CaseSensitive</emph> : Only for string comparisons, default = <literal>False</literal>." +msgstr "" + +#. R8mAZ +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id611582651575637\n" +"help.text" +msgid "Swap rows and columns in a two dimension array." +msgstr "" + +#. bAzjH +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id61582651575188\n" +"help.text" +msgid "<emph>Array_2D</emph> : The array to transpose." +msgstr "" + +#. dwAVQ +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id181582652996483\n" +"help.text" +msgid "Remove from a one dimension array all <literal>Null</literal>, <literal>Empty</literal> and zero-length entries. <br/>String items are trimmed with %PRODUCTNAME Basic <literal>Trim()</literal> function." +msgstr "" + +#. pgrAD +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id111582652996147\n" +"help.text" +msgid "<emph>Array_1D</emph> : The array to scan." +msgstr "" + +#. W6HBB +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id461582653148663\n" +"help.text" +msgid "Build a set, as a zero-based array, by applying the union operator on the two input arrays. Resulting items originate from both arrays. <br/>The resulting array is sorted in ascending order. <br/>Both input arrays must be filled homogeneously, their items must be scalars of the same type. <literal>Empty</literal> and <literal>Null</literal> items are forbidden. <br/>Text comparison can be case sensitive or not." +msgstr "" + +#. ZSpA9 +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id4715826531488\n" +"help.text" +msgid "<emph>Array1_1D</emph> : The first input array." +msgstr "" + +#. bD9nv +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id51158265314898\n" +"help.text" +msgid "<emph>Array2_1D</emph> : The second input array." +msgstr "" + +#. k5Xve +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id821582653148126\n" +"help.text" +msgid "<emph>CaseSensitive</emph> : Only if the arrays are populated with strings, default = <literal>False</literal>." +msgstr "" + +#. CGMRq +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id221582653464565\n" +"help.text" +msgid "Build a set of unique values derived from the input array. <br/>The input array must be filled homogeneously, its items must be scalars of the same type. <literal>Empty</literal> and <literal>Null</literal> items are forbidden. <br/>Text comparison can be case sensitive or not." +msgstr "" + +#. g5SkL +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id521582653464553\n" +"help.text" +msgid "<emph>Array_1D</emph> : The input array." +msgstr "" + +#. V4F4E +#: sf_array.xhp +msgctxt "" +"sf_array.xhp\n" +"par_id41158265346441\n" +"help.text" +msgid "<emph>CaseSensitive</emph> : Only if the array is populated with texts, default = <literal>False</literal>." +msgstr "" + +#. opNus +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"tit\n" +"help.text" +msgid "ScriptForge.Dictionary service" +msgstr "" + +#. iiRuo +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"hd_id731582733781114\n" +"help.text" +msgid "<link href=\"text/sbasic/shared/03/sf_dictionary.xhp\" name=\"ScriptForge.Dictionary service\"><literal>ScriptForge</literal>.<literal>Dictionary</literal> service</link>" +msgstr "" + +#. LJG3Z +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id891582884466217\n" +"help.text" +msgid "A dictionary is a collection of key-item pairs" +msgstr "" + +#. fZDre +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id861582884516571\n" +"help.text" +msgid "The key is a case-insensitive string" +msgstr "" + +#. 2AdDG +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id531582884549542\n" +"help.text" +msgid "Items may be of any type" +msgstr "" + +#. Bqyf3 +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id891582884593057\n" +"help.text" +msgid "Keys and items can be retrieved, counted, updated, and much more." +msgstr "" + +#. HnBYG +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id971582884636922\n" +"help.text" +msgid "%PRODUCTNAME Basic <literal>Collection</literal> object does not support the retrieval of the keys. <br/>Additionally its items contain only primitive Basic data types such as dates, text, numbers, and the like." +msgstr "" + +#. RkMHR +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"hd_id581582885621841\n" +"help.text" +msgid "Service invocation" +msgstr "" + +#. Qp3A4 +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id821610388789467\n" +"help.text" +msgid "The following example creates <literal>myDict</literal> as an empty dictionary." +msgstr "" + +#. BghTS +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id71158288562139\n" +"help.text" +msgid "It is recommended to free resources after use:" +msgstr "" + +#. Dd4Pp +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"hd_id351582885195476\n" +"help.text" +msgid "Properties" +msgstr "" + +#. hYF2s +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id41582885195836\n" +"help.text" +msgid "Name" +msgstr "" + +#. Yay3o +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id31582885195372\n" +"help.text" +msgid "Readonly" +msgstr "" + +#. pHem5 +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id31582885195238\n" +"help.text" +msgid "Type" +msgstr "" + +#. NnCGT +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id931582885195131\n" +"help.text" +msgid "Description" +msgstr "" + +#. B8ZfD +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id221582885195686\n" +"help.text" +msgid "Yes" +msgstr "" + +#. JnMbF +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id881582885195976\n" +"help.text" +msgid "The number of entries in the dictionary" +msgstr "" + +#. TZ37p +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id441582886030118\n" +"help.text" +msgid "Yes" +msgstr "" + +#. G6fcd +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id131582886030297\n" +"help.text" +msgid "Array of Variants" +msgstr "" + +#. EykBP +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id471582886030489\n" +"help.text" +msgid "The list of items as a one dimensional array" +msgstr "" + +#. HTnKu +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id971582886791838\n" +"help.text" +msgid "Yes" +msgstr "" + +#. mXmC9 +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id271582886791111\n" +"help.text" +msgid "Array of Strings" +msgstr "" + +#. MxjyM +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id16158288679167\n" +"help.text" +msgid "The list of keys as a one dimensional array" +msgstr "" + +#. EvjDj +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id461582886731495\n" +"help.text" +msgid "The <literal>Keys</literal> and <literal>Items</literal> properties return their respective contents, using an identical ordering. The order is unrelated to the creation sequence." +msgstr "" + +#. suQ9E +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id931610389113917\n" +"help.text" +msgid "The following example uses the <literal>Keys</literal> property to iterate over all keys in the dictionary <literal>myDict</literal>." +msgstr "" + +#. Thoy8 +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id921606472825856\n" +"help.text" +msgid "Methods" +msgstr "" + +#. dgSuT +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id381606472825856\n" +"help.text" +msgid "<link href=\"text/sbasic/shared/03/sf_dictionary.xhp#Add\" name=\"Add method\">Add</link><br/> <link href=\"text/sbasic/shared/03/sf_dictionary.xhp#ConvertToArray\" name=\"ConvertToArray method\">ConvertToArray</link><br/> <link href=\"text/sbasic/shared/03/sf_dictionary.xhp#ConvertToJson\" name=\"ConvertToJson method\">ConvertToJson</link><br/> <link href=\"text/sbasic/shared/03/sf_dictionary.xhp#ConvertToPropertyValues\" name=\"ConvertToPropertyValues method\">ConvertToPropertyValues</link>" +msgstr "" + +#. EZGQw +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id451606472825856\n" +"help.text" +msgid "<link href=\"text/sbasic/shared/03/sf_dictionary.xhp#Exists\" name=\"Exists method\">Exists</link><br/> <link href=\"text/sbasic/shared/03/sf_dictionary.xhp#ImportFromJson\" name=\"ImportFromJson method\">ImportFromJson</link><br/> <link href=\"text/sbasic/shared/03/sf_dictionary.xhp#ImportFromPropertyValues\" name=\"ImportFromPropertyValues method\">ImportFromPropertyValues</link><br/> <link href=\"text/sbasic/shared/03/sf_dictionary.xhp#Item\" name=\"Item method\">Item</link>" +msgstr "" + +#. nR9TD +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id161606472825856\n" +"help.text" +msgid "<link href=\"text/sbasic/shared/03/sf_dictionary.xhp#Remove\" name=\"Remove method\">Remove</link><br/> <link href=\"text/sbasic/shared/03/sf_dictionary.xhp#RemoveAll\" name=\"RemoveAll method\">RemoveAll</link><br/> <link href=\"text/sbasic/shared/03/sf_dictionary.xhp#ReplaceItem\" name=\"ReplaceItem method\">ReplaceItem</link><br/> <link href=\"text/sbasic/shared/03/sf_dictionary.xhp#ReplaceKey\" name=\"ReplaceKey method\">ReplaceKey</link>" +msgstr "" + +#. PqSBg +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id831582887670029\n" +"help.text" +msgid "Adds a new key-item pair into the dictionary. Returns <literal>True</literal> if successful." +msgstr "" + +#. 3MMGU +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id341582887670030\n" +"help.text" +msgid "<emph>Key</emph> : String value used to identify the Item. The key is not case-sensitive." +msgstr "" + +#. aGgh9 +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id401582887670030\n" +"help.text" +msgid "<emph>Item</emph> : Any value, including an array, a Basic object, a UNO object, a dictionary, etc." +msgstr "" + +#. aNDWv +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id1001610391308765\n" +"help.text" +msgid "Every key must be unique in the same dictionary. If the key already exists in the dictionary, a <literal>DUPLICATEKEYERROR</literal> will be raised. Keys that are made of space characters will raise a <literal>INVALIDKEYERROR</literal> error." +msgstr "" + +#. FDWkm +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id81582888424104\n" +"help.text" +msgid "Stores the contents of the dictionary in a two-columns zero-based array. The keys are stored in the first column and the items are stored in the second column." +msgstr "" + +#. FdwcF +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id341610391565678\n" +"help.text" +msgid "If the dictionary is empty, this method will return an empty <literal>Array</literal>." +msgstr "" + +#. MnEGs +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id831601296836981\n" +"help.text" +msgid "Converts the contents of a dictionary to <link href=\"https://en.wikipedia.org/wiki/JSON\" name=\"JSON text\">JSON (JavaScript Object Notation)</link> text." +msgstr "" + +#. nAZ9s +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"hd_id261601297024828\n" +"help.text" +msgid "Limitations" +msgstr "" + +#. DDmVt +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id401601297178073\n" +"help.text" +msgid "This method supports the following data types: <literal>String</literal>, <literal>Boolean</literal>, numbers, <literal>Null</literal> and <literal>Empty</literal>. Arrays containing items of those types are also allowed, whatever their dimensions. Dates are converted into strings, however they cannot be used inside Arrays. Other data types are converted to their string representation using the <literal>SF_String.Represent</literal> service." +msgstr "" + +#. Nmzcs +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id8816012968362\n" +"help.text" +msgid "<emph>Indent</emph> : When <literal>Indent</literal> is a positive number or a text, JSON array elements and object members are pretty-printed with that indentation level. A negative <literal>Indent</literal> value will add new lines with no indentation. <literal>Indent</literal> default value \"\" selects the most compact representation. Using a positive integer for <literal>Indent</literal> indents that many spaces per level. When <literal>Indent</literal> is a string, such as <literal>Chr(9)</literal> or <literal>Tab(1)</literal>, the Tab character is used to indent each level." +msgstr "" + +#. pipLz +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id151582889470596\n" +"help.text" +msgid "Store the content of the dictionary in an array of <literal>PropertyValues</literal>." +msgstr "" + +#. rTa2V +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id231610392665049\n" +"help.text" +msgid "Each entry in the array is a <literal>com.sun.star.beans.PropertyValue</literal>. The key is stored in <literal>Name</literal>, the item is stored in <literal>Value</literal>." +msgstr "" + +#. 5MnFS +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id341610392705367\n" +"help.text" +msgid "If one of the items has a type <literal>Date</literal>, it is converted to a <literal>com.sun.star.util.DateTime</literal> structure. If one of the items is an empty array, it is converted to <literal>Null</literal>. The resulting array is empty when the dictionary is empty." +msgstr "" + +#. wTUQt +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id421610393306916\n" +"help.text" +msgid "Many services and methods in the UNO library take in parameters represented using the <literal>PropertyValue</literal> struct, which is part of the LibreOffice API." +msgstr "" + +#. 3afLF +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id841582889812916\n" +"help.text" +msgid "Determines if a key exists in the dictionary." +msgstr "" + +#. 9akGN +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id971582889812917\n" +"help.text" +msgid "<emph>Key</emph> : The key to be looked up in the dictionary." +msgstr "" + +#. JBBVt +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id791601391980978\n" +"help.text" +msgid "Adds the content of a <link href=\"https://en.wikipedia.org/wiki/JSON\" name=\"JSON text\">JSON (JavaScript Object Notation)</link> string into the current dictionary. Returns <literal>True</literal> if successful." +msgstr "" + +#. NtQCD +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"hd_id961601392113644\n" +"help.text" +msgid "Limitations" +msgstr "" + +#. dGRph +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id481601392181131\n" +"help.text" +msgid "The JSON string may contain numbers, text, booleans, null values and arrays containing those types. It must not contain JSON objects namely sub-dictionaries." +msgstr "" + +#. LyxQD +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id511601392205908\n" +"help.text" +msgid "An attempt is made to convert text to date if the item matches one of these patterns: YYYY-MM-DD, HH:MM:SS or YYYY-MM-DD HH:MM:SS." +msgstr "" + +#. Ghov2 +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id69160139198061\n" +"help.text" +msgid "<emph>InputStr</emph> : The string to import." +msgstr "" + +#. LW97u +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id201601391980268\n" +"help.text" +msgid "<emph>Overwrite</emph> : When <literal>True</literal>, entries with same name may exist in the dictionary and their values are overwritten. When <literal>False</literal> (default), repeated keys will raise an error. Beware that dictionary keys are not case-sensitive while names are case-sensitive in JSON strings." +msgstr "" + +#. aBFC5 +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"bas_id521601393254694\n" +"help.text" +msgid "'The (sub)-dictionaries \"address\" and \"phoneNumbers\" (0) and (1) are imported as Empty values." +msgstr "" + +#. 9j5u2 +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id651588941968228\n" +"help.text" +msgid "Inserts the contents of an array of <literal>PropertyValue</literal> objects into the current dictionary. <literal>PropertyValue</literal> Names are used as Keys in the dictionary, whereas Values contain the corresponding values. Returns <literal>True</literal> if successful." +msgstr "" + +#. jYVUA +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id751588941968522\n" +"help.text" +msgid "<emph>PropertyValues</emph> : A zero-based 1 dimensional array containing <literal>com.sun.star.beans.PropertyValue</literal> objects. This parameter may also be a single <literal>PropertyValue</literal> object not contained in an Array." +msgstr "" + +#. TvJoT +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id21588941968131\n" +"help.text" +msgid "<emph>Overwrite</emph> : When <literal>True</literal>, entries with same name may exist in the dictionary and their values are overwritten. When <literal>False</literal> (default), repeated keys will raise an error. Note that dictionary keys are not case-sensitive, whereas names are case-sensitive in sets of property values." +msgstr "" + +#. 3rJRP +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id891582890366737\n" +"help.text" +msgid "Retrieves an existing dictionary entry based on its key. Returns the value of the item if successful, otherwise returns <literal>Empty</literal>." +msgstr "" + +#. UP6qF +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id551582890399669\n" +"help.text" +msgid "<emph>Key</emph> : Not case-sensitive. Must exist in the dictionary, otherwise a <literal>UNKNOWNKEYERROR</literal> error is raised." +msgstr "" + +#. rGqyT +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id181610395933967\n" +"help.text" +msgid "The following example iterates over all keys in the dictionary and uses the <literal>Item</literal> method to access their values." +msgstr "" + +#. QJTte +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id891582890388737\n" +"help.text" +msgid "Removes an existing dictionary entry based on its key. Returns <literal>True</literal> if successful." +msgstr "" + +#. eEKAA +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id551582890366999\n" +"help.text" +msgid "<emph>Key</emph> : Not case-sensitive. Must exist in the dictionary, otherwise an <literal>UNKNOWNKEYERROR</literal> error is raised." +msgstr "" + +#. GyK3j +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id921582896275624\n" +"help.text" +msgid "Removes all the entries from the dictionary. Returns <literal>True</literal> if successful." +msgstr "" + +#. GSzP5 +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id281582895615444\n" +"help.text" +msgid "Replaces an existing item value based on its key. Returns <literal>True</literal> if successful." +msgstr "" + +#. pSQCe +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id991582895615535\n" +"help.text" +msgid "<emph>Key</emph> : String value representing the key whose value will be replaced. Not case-sensitive. If the key does not exist in the dictionary, a <literal>UNKNOWNKEYERROR</literal> error is raised." +msgstr "" + +#. B9QCk +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id721582895615186\n" +"help.text" +msgid "<emph>Value</emph> : The new value of the item referred to with the Key parameter." +msgstr "" + +#. Y46D4 +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id571582896597766\n" +"help.text" +msgid "Replaces an existing key in the dictionary by a new key. The item value is left unchanged. Returns <literal>True</literal> if successful." +msgstr "" + +#. SxyfK +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id911582896597619\n" +"help.text" +msgid "<emph>Key</emph> : String value representing the key to be replaced. Not case-sensitive. If the key does not exist in the dictionary, a <literal>UNKNOWNKEYERROR</literal> error is raised." +msgstr "" + +#. Eu4DG +#: sf_dictionary.xhp +msgctxt "" +"sf_dictionary.xhp\n" +"par_id531582896597989\n" +"help.text" +msgid "<emph>Value</emph> : String value for the new key. Not case-sensitive. If the new key already exists in the dictionary, a <literal>DUPLICATEKEYERROR</literal> error is raised." +msgstr "" + +#. WCH7E +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"tit\n" +"help.text" +msgid "ScriptForge.Exception service (SF_Exception)" +msgstr "" + +#. ikEsF +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id521580038927003\n" +"help.text" +msgid "<variable id=\"ExceptionService\"><link href=\"text/sbasic/shared/03/sf_exception.xhp\" name=\"Exception service\"><literal>ScriptForge</literal>.<literal>Exception</literal> service</link></variable>" +msgstr "" + +#. m5HoF +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id181587139648008\n" +"help.text" +msgid "The <literal>Exception</literal> service is a collection of methods for Basic code debugging and error handling." +msgstr "" + +#. KiitV +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id141587140927573\n" +"help.text" +msgid "In the advent of a run-time error, the <literal>Exception</literal> service properties and methods help identify the error context and permit to handle it." +msgstr "" + +#. Kn3iF +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id461587140965192\n" +"help.text" +msgid "The <literal>SF_Exception</literal> service is similar to the <link href=\"text/sbasic/shared/ErrVBA.xhp\" name=\"VBA Err object\">VBA <literal>Err</literal> object</link>." +msgstr "" + +#. 6rquM +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id61587141015326\n" +"help.text" +msgid "The <literal>Number</literal> property identifies the error." +msgstr "" + +#. 9Gh4S +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id251608212974671\n" +"help.text" +msgid "Use <literal>Raise()</literal> method to interrupt processing, use <literal>RaiseWarning()</literal> method to trap an anomaly and continue processing." +msgstr "" + +#. PddYS +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id621587225732733\n" +"help.text" +msgid "Errors or warnings raised with the <literal>Exception</literal> service are stored in memory and can be retrieved using its <literal>Console()</literal> method." +msgstr "" + +#. i8z6N +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id411587141146677\n" +"help.text" +msgid "The <literal>Exception</literal> service console stores events, variable values and information about errors. Use the console when Basic IDE is not accessible, for example in <link href=\"text/scalc/guide/userdefined_function.xhp\" name=\"Calc user-defined function\">Calc user defined functions (UDF)</link> or during events processing. Use <literal>DebugPrint()</literal> method to aggregate additional user data. Console entries can be dumped to a text file or visualized in a dialogue." +msgstr "" + +#. 9AW2i +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id111587141158495\n" +"help.text" +msgid "When an error occurs, an application macro may:" +msgstr "" + +#. hxxxr +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id451587141202844\n" +"help.text" +msgid "Report the error in the <literal>Exception</literal> console" +msgstr "" + +#. SGmPy +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id751587141235313\n" +"help.text" +msgid "Inform the user about the error using either a standard message either a customized message" +msgstr "" + +#. C3NMD +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id931587141260777\n" +"help.text" +msgid "Optionally stop its execution" +msgstr "" + +#. yQzKr +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id201586594659135\n" +"help.text" +msgid "Service invocation" +msgstr "" + +#. Mh5QX +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id571586594672714\n" +"help.text" +msgid "Next code snippets are equivalent:" +msgstr "" + +#. zEj3B +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"bas_id731608211525532\n" +"help.text" +msgid "GlobalScope.BasicLibraries.LoadLibrary(\"ScriptForge\")" +msgstr "" + +#. HABsh +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id651584978211886\n" +"help.text" +msgid "Properties" +msgstr "" + +#. s3E9G +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id271584978211792\n" +"help.text" +msgid "Name" +msgstr "" + +#. qEhnn +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id241584978211550\n" +"help.text" +msgid "ReadOnly" +msgstr "" + +#. TkMLa +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id621584978211403\n" +"help.text" +msgid "Description" +msgstr "" + +#. tJZkJ +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id71584978715562\n" +"help.text" +msgid "No" +msgstr "" + +#. QFZYV +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id581584978715701\n" +"help.text" +msgid "The error message text.<br/>Default is \"\" or standard Basic run-time error message." +msgstr "" + +#. BT7GF +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id211584978211383\n" +"help.text" +msgid "No" +msgstr "" + +#. bVmN9 +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id691584978211774\n" +"help.text" +msgid "The code of the error. It can be a numeric value or text.<br/>Default is 0 or standard Basic run-time error code." +msgstr "" + +#. uLE2Q +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id671584978666689\n" +"help.text" +msgid "No" +msgstr "" + +#. jAkBs +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id951584978666296\n" +"help.text" +msgid "The location in the code where the error occurred. It can be a numeric value or text.<br/>Default is 0 or the code line number for a standard Basic run-time error." +msgstr "" + +#. mnFGS +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id461584978880380\n" +"help.text" +msgid "Raising or clearing an <literal>Exception</literal> resets its properties." +msgstr "" + +#. VCBrN +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id881608131596153\n" +"help.text" +msgid "Methods" +msgstr "" + +#. 9cDV8 +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id461608131596153\n" +"help.text" +msgid "<link href=\"text/sbasic/shared/03/sf_exception.xhp#Clear\" name=\"Clear method\">Clear</link><br/> <link href=\"text/sbasic/shared/03/sf_exception.xhp#Console\" name=\"Console method\">Console</link><br/> <link href=\"text/sbasic/shared/03/sf_exception.xhp#ConsoleClear\" name=\"ConsoleClear method\">ConsoleClear</link>" +msgstr "" + +#. a8jk5 +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id871608132025242\n" +"help.text" +msgid "<link href=\"text/sbasic/shared/03/sf_exception.xhp#ConsoleToFile\" name=\"ConsoleToFile method\">ConsoleToFile</link><br/><br/> <link href=\"text/sbasic/shared/03/sf_exception.xhp#DebugPrint\" name=\"DebugPrint method\">DebugPrint</link><br/>" +msgstr "" + +#. qGG7B +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id831608132069033\n" +"help.text" +msgid "<br/><link href=\"text/sbasic/shared/03/sf_exception.xhp#Raise\" name=\"Raise method\">Raise</link><br/> <link href=\"text/sbasic/shared/03/sf_exception.xhp#RaiseWarning\" name=\"RaiseWarning method\">RaiseWarning</link>" +msgstr "" + +#. maCHB +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id271579683706571\n" +"help.text" +msgid "Reset the current error status and clear the <literal>SF_Exception</literal> properties." +msgstr "" + +#. ZXJ9w +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id381579687079872\n" +"help.text" +msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functsyntax\"/>" +msgstr "" + +#. SBW8h +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"bas_id51587215508130\n" +"help.text" +msgid "' If division by zero, ignore the error" +msgstr "" + +#. kHCeG +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id651598718179382\n" +"help.text" +msgid "Display the console messages in a modal or non-modal dialog. In both modes, all the past messages issued by a <literal>DebugPrint()</literal> method or resulting from an exception are displayed. In non-modal mode, additionally, subsequent entries are added automatically." +msgstr "" + +#. KKgdp +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id161598718286205\n" +"help.text" +msgid "If the console is already open, when non-modal, it is brought to the front." +msgstr "" + +#. RC2Vf +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id801598718629151\n" +"help.text" +msgid "A modal console is closed by the user. A non-modal console is closed by the user or at macro termination." +msgstr "" + +#. ZeSUK +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id681598718179603\n" +"help.text" +msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functsyntax\"/>" +msgstr "" + +#. dsuNu +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id761598718179784\n" +"help.text" +msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functparameters\"/>" +msgstr "" + +#. FWBds +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id511598718179819\n" +"help.text" +msgid "<emph>Modal</emph>: Default = <literal>True</literal>." +msgstr "" + +#. oK5LP +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id60159871817984\n" +"help.text" +msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functexample\"/>" +msgstr "" + +#. V3yD8 +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id641587215098903\n" +"help.text" +msgid "Clear the console keeping an optional number of recent messages. If the console is activated in non-modal mode, it is refreshed." +msgstr "" + +#. hcFEA +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id491587215098807\n" +"help.text" +msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functsyntax\"/>" +msgstr "" + +#. gKRhZ +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id211587215098692\n" +"help.text" +msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functparameters\"/>" +msgstr "" + +#. f73g6 +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id351587215098527\n" +"help.text" +msgid "<emph>Keep</emph>: The number of recent messages to be kept, default is 0." +msgstr "" + +#. tKEBK +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id151587215098840\n" +"help.text" +msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functexample\"/>" +msgstr "" + +#. wG2ee +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id281587218077400\n" +"help.text" +msgid "Export the content of the console to a text file. If the file exists and the console is not empty, it is overwritten without warning. Returns <literal>True</literal> if successful." +msgstr "" + +#. xi59H +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id231587218077969\n" +"help.text" +msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functsyntax\"/>" +msgstr "" + +#. L4wqB +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id471587218077526\n" +"help.text" +msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functparameters\"/>" +msgstr "" + +#. jZfdb +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id851587218077862\n" +"help.text" +msgid "<emph>FileName</emph>: The name of the text file the console should be dumped into. The name is expressed as given by the current <literal>FileNaming</literal> property of the <literal>SF_FileSystem</literal> service. Default is any where both the <link href=\"text/sbasic/shared/00000002.xhp\" name=\"Url notation\">URL notation</link> and the native operating system format are admitted." +msgstr "" + +#. Zeyjx +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id361587218077347\n" +"help.text" +msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functexample\"/>" +msgstr "" + +#. N5AgU +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id281587218637490\n" +"help.text" +msgid "Assemble all the given arguments into a human-readable single string and add it as a new entry in the console." +msgstr "" + +#. xrNGg +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id341587218637198\n" +"help.text" +msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functsyntax\"/>" +msgstr "" + +#. 7dS9P +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id821587218637437\n" +"help.text" +msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functparameters\"/>" +msgstr "" + +#. BmmDA +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id481587218637988\n" +"help.text" +msgid "<emph>Arg0[, Arg1, ...]</emph>: Any number of arguments of any type." +msgstr "" + +#. GDSvh +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id501587218637514\n" +"help.text" +msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functexample\"/>" +msgstr "" + +#. dCuZ4 +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id541587219824771\n" +"help.text" +msgid "Generate a run-time error. An error message is displayed to the user and reported in the console. The execution is stopped. The <literal>Raise()</literal> method can be placed inside the normal script flow or in a dedicated error-handling routine." +msgstr "" + +#. JP5NR +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id10158721982478\n" +"help.text" +msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functsyntax\"/>" +msgstr "" + +#. FBXUy +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id921587220542454\n" +"help.text" +msgid "Next code snippets are equivalent. Keyword arguments are allowed.<literal>Source</literal> and <literal>Description</literal> arguments behave identically:" +msgstr "" + +#. uJVdb +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id711587219824373\n" +"help.text" +msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functparameters\"/>" +msgstr "" + +#. 6wEJq +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id851587219824597\n" +"help.text" +msgid "<emph>Number</emph>: The error code, as a number or as a string. Default value is that of <literal>Err</literal> Basic builtin function." +msgstr "" + +#. 7zRRT +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id461587220986452\n" +"help.text" +msgid "<emph>Source</emph>: The location of the error, as a number or as a string. Default value is that of <literal>Erl</literal> Basic builtin function." +msgstr "" + +#. fSwCd +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id721587221018162\n" +"help.text" +msgid "<emph>Description</emph>: The message to display to the user and to report in the console. Default value is that of <literal>Error$</literal> Basic builtin function." +msgstr "" + +#. LezTB +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id471587219824970\n" +"help.text" +msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functexample\"/>" +msgstr "" + +#. jmceA +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"bas_id211587222852310\n" +"help.text" +msgid "' Variants below ..." +msgstr "" + +#. TZL7z +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id111587222580987\n" +"help.text" +msgid "For a standard behaviour:" +msgstr "" + +#. 8DAGC +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id751587222598238\n" +"help.text" +msgid "To simulate another error:" +msgstr "" + +#. QXgCy +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id501587222607771\n" +"help.text" +msgid "To replace the usual message:" +msgstr "" + +#. gdvqM +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"bas_id431587222670849\n" +"help.text" +msgid "SF_Exception.Raise(, , \"It is not a good idea to divide by zero.\")" +msgstr "" + +#. TaFgn +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id611587222617174\n" +"help.text" +msgid "To raise an application error:" +msgstr "" + +#. ifrWg +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"bas_id71587222694657\n" +"help.text" +msgid "SF_Exception.Raise(\"MyAppError\", \"Example_Raise()\", \"Something wrong happened !\")" +msgstr "" + +#. 6Ut6S +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id1001587224839900\n" +"help.text" +msgid "This method has exactly the same syntax, arguments and behaviour as the <literal>Raise()</literal> method." +msgstr "" + +#. XEmqL +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"par_id761587224839624\n" +"help.text" +msgid "With the notable exception that <emph>the execution is not stopped</emph>." +msgstr "" + +#. dXDpv +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id10158729182478\n" +"help.text" +msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functsyntax\"/>" +msgstr "" + +#. DSbst +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"hd_id10158927182478\n" +"help.text" +msgid "<embedvar href=\"text/sbasic/shared/00000003.xhp#functexample\"/>" +msgstr "" + +#. dbgEP +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"bas_id841608217948025\n" +"help.text" +msgid "Description:=\"Something wrong happened !\", _" +msgstr "" + +#. FNQNy +#: sf_exception.xhp +msgctxt "" +"sf_exception.xhp\n" +"bas_id361608217956289\n" +"help.text" +msgid "Number:=\"MyAppError\")" +msgstr "" |