INFO BUILDIN

From SemanticLab

SET DEFINE OFF;

 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('40', 'top$', 'Pops and prints the top of the stack on the terminal and log file', 'DEBUGG', 'no', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13842', 'width$', 'Pops the top (string) literal and pushes the integer that represents its width in some relative units (currently, hundredths of a point, as specified by the June 1987 version of the cmr10 font; the only white-space character with nonzero width is the space). This function takes the literal literally; that is, it assumes each character in the string is to be printed as is, regardless of whether the character has a special meaning to TeX, except that "special characters' (even without their right braces) are handled specially. This is meant to be used for comparing widths of label strings', 'NUMBER', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13820', 'crossref', 'Is an entry variable, an additional field that BibTeX automatically declares, used for cross referencing', 'ENTRY_VAR', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13830', 'num.names$', 'Pops the top (string) literal and pushes the number of names the string represents - one plus the number of occurrences of the substring "and' (ignoring case differences) surrounded by nonnull white-space at the top brace level', 'NUMBER', 'plain', 
     NULL, '[entry]', 'number', 'nvl((length("[entry]")-length(replace("[entry]", and )))/5+1,0)', 'num_names_[editor]', 
     'wird für die Einträge "author" und "editor" im Basisselect als eigene spalte generiert, in allen functionen wo der Stack als parameter übergeben wird ignoriert');
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13823', 'entry.max$', 'automatically-declared integer constant = 250', 'GlobCONST', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13814', '<', 'Pops the top two (integer) literals, compares them, and pushes the integer 1 if the first is greater than the second, 0 otherwise', 'LOGOP', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13810', '*', 'Pops the top two (string) literals, concatenates them (in reverse order, that is, the order in which pushed), and pushes the resulting string', 'STROP', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13811', '+', 'Pops the top two (integer) literals and pushes their sum', 'INTOP', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13812', '-', 'Pops the top two (integer) literals and pushes their difference (the first subtracted from the second)', 'INTOP', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13813', ':=', 'Pops the top two literals and assigns to the first (which must be a global or entry variable) the value of the second', 'ASOP', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13815', '=', 'Pops the top two (both integer or both string) literals, compares them, and pushes the integer 1 if theyre equal, 0 otherwise', 'LOGOP', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13816', '>', 'Pops the top two (integer) literals, compares them, and pushes the integer 1 if the second is greater than the first, 0 otherwise', 'LOGOP', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13817', 'add.period$', 'Pops the top (string) literal, adds a . to it if the last non} character isnt a ., ?, or !, and pushes this resulting string', 'STRINGM', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13818', 'change.case$', 'Pops the top two (string) literals; it changes the case of the second according to the specifications of the first, as follows. 
 If the first literal is the string t, it converts to lower case all letters except the very first character in the string, 
 which it leaves alone, and except the first character following any colon and then nonnull white space, which it also leaves alone;
 if its the string l, it converts all letters to lower case; and if its the string u, it converts all letters to upper case. It then pushes this resulting string.
 If either type is incorrect, it complains and pushes the null string; however, if both types are correct but the specification string (i.e., the first string) isnt one of the legal ones,
 it merely pushes the second back onto the stack, after complaining. (Another note: It ignores case differences in the specification string;
 for example, the strings t and T are equivalent for the purposes of this built-in function) ', 'STRINGM', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13819', 'cite$', 'Pushes the string that was the \cite-command argument for this entry', 'ENTRY_VAR', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13821', 'duplicate$', 'Pops the top literal from the stack and pushes two copies of it', 'STACK', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13822', 'empty$', 'Pops the top literal and pushes the integer 1 if its a missing field or a string having no non-white-space characters, 0 otherwise', 'LOGOP', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13824', 'format.name$', 'Pops the top three literals (they are a string, an integer, and a string literal). The last string literal represents a name list (each name corresponding to a person), the integer literal specifies which name to pick from this list, and the first string literal specifies how to format this name. Finally, this function pushes the formatted name', 'FORMATNAME', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13825', 'global.max$', 'automatically-declared integer constant = 5000', 'GlobCONST', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13826', 'if$', 'Pops the top three literals (they are two function literals and an integer literal, in that order); if the integer is greater than 0, it executes the second literal, else it executes the first', 'CONTROL', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13827', 'int.to.str$', 'Pops the top (integer) literal, converts it to its (unique) string equivalent, and pushes this string', 'CONV', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13828', 'missing$', 'Pops the top literal and pushes the integer 1 if its a missing field, 0 otherwise', 'LOGOP', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13829', 'newline$', 'Writes onto the bbl file whats accumulated in the output buffer. It writes a blank line if and only if the output buffer is empty. Since write$ does reasonable line breaking, you should use this function only when you want a blank line or an explicit line break', 'BBL', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13831', 'pop$', 'Pops the top of the stack but doesnt print it; this gets rid of an unwanted stack literal', 'STACK', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13832', 'preamble$', 'Pushes onto the stack the concatenation of all the @PREAMBLE strings read from the database files', 'PREAMBLE', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13833', 'purify$', 'Pops the top (string) literal, removes nonalphanumeric characters except for white-space characters and hyphens and ties (these all get converted to a space), removes certain alphabetic characters contained in the control sequences associated with a "special character', and pushes the resulting string', 'TEXT', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13834', 'skip$', 'Is a no-op', 'NONOP', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13835', 'sort.key$', 'Is a string entry variable automatically declared, used by the SORT command', 'ENTRY_VAR', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13836', 'substring$', 'Pops the top three literals (they are the two integers literals len and start, and a string literal, in that order). It pushes the substring of the (at most) len consecutive characters starting at the startth character (assuming 1-based indexing) if start is positive, and ending at the -startth character from the end if start is negative (where the first character from the end is the last character)', 'TEXT', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13837', 'swap$', 'Swaps the top two literals on the stack', 'STACK', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13838', 'text.length$', 'Pops the top (string) literal, and pushes the number of text characters it contains, where an accented character (more precisely, a "special character') counts as a single text character, even if its missing its matching right brace, and where braces dont count as text characters', 'NUMBER', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13839', 'type$', 'Pushes the current entrys type (book, article, etc.), but pushes the null string if the type is either unknown or undefined', 'ENTRY_VAR', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13840', 'warning$', 'Pops the top (string) literal and prints it following a warning message. This also increments a count of the number of warning messages issued', 'BLG', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13841', 'while$', 'Pops the top two (function) literals, and keeps executing the second as long as the (integer) literal left on the stack by executing the first is greater than 0', 'CONTROL', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('13843', 'write$', 'Pops the top (string) literal and writes it on the output buffer (which will result in stuff being written onto the bbl file when the buffer fills up)', 'BBL', 'plain', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('20', 'quoute$', 'Pushes the string consisting of the double-quote character', 'TEXT', 'no', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('14849', 'chr.to.int$', 'Pops the top (string) literal, makes sure its a single character, converts it to the corresponding ASCII integer, and pushes this integer', 'CONV', 'alpha', 
     1, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('14850', 'int.to.chr$', 'Pops the top (integer) literal, interpreted as the ASCII integer value of a single character, converts it to the corresponding single-character string, and pushes this string', 'CONV', 'alpha', 
     2, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('14851', 'text.prefix$', 'Pops the top two literals (the integer literal len and a string literal, in that order). It pushes the substring of the (at most) len consecutive text characters starting from the beginning of the string. This function is similar to substring$, but this one considers a "special character', even if its missing its matching right brace, to be a single text character (rather than however many ASCII characters it actually comprises), and this function doesnt consider braces to be text characters; furthermore, this function appends any needed matching right braces', 'TEXT', 'alpha', 
     3, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('10', 'call.type$', 'Executes the function whose name is the entry type of an entry. For example if an entry is of type book, this function executes the book function. When given as an argument to the ITERATE command, call.type$ actually produces the output for the entries. For an entry with an unknown type, it executes the function default.type. Thus you should define (before the READ command) one function for each standard entry type as well as a default.type function', 'ITERATE ARG', 'plain', 
     0, NULL, NULL, NULL, NULL, 
     NULL);
 Insert into INFO_BUILDIN
    (ID, NAME, FUNCTION, FUNCTION_TYPE, BST_NAME, 
     SORT_ORD, STACK_IN, STACK_OUT, SQL_FUNCTION, COLUMN_NAME, 
     COMMENT_GER)
  Values
    ('100', 'stack$', 'Pops and prints the whole stack', 'DEBUGG', 'no', 
     NULL, NULL, NULL, NULL, NULL, 
     NULL);
 COMMIT;