yabasic.xml

Linux下VB解释器

    <sect1>
      <title>String processing</title>
      <para><application>yabasic</application> has the usual functions to extract parts from a string: <function><link linkend="ref_left">left$</link></function>, <function><link linkend="ref_mid">mid$</link></function> and <function><link linkend="ref_right">right$</link></function>. Note, that all of them can be assigned to, i.e. they may <emphasis>change</emphasis> part of a string.</para>
      <para>If you want to split a string into tokens you should use the functions <function><link linkend="ref_token">token</link></function> or <function><link linkend="ref_split">split</link></function>.</para>
      <para>There is quite a bunch of other string-processing functions like <function><link linkend="ref_upper">upper$</link></function> (converting to upper case), <function><link linkend="ref_instr">instr</link></function> (finding one string within the other), <function><link linkend="ref_chr">chr$</link></function> (converting an ascii-code into a character), <function><link linkend="ref_glob">glob</link></function> (testing a string against a pattern) and more. Just follow the links.</para>
    </sect1>

    <sect1>
      <title>Arithmetic</title>
      <para><application>Yabasic</application> handles numbers and arithmetic: You may calculate trigonometric functions like <function><link linkend="ref_sin">sin</link></function> or <function><link linkend="ref_atan">atan</link></function>, or logarithms (with <function><link linkend="ref_log">log</link></function>). Bitwise operations, like <function><link linkend="ref_arithmetic_and">and</link></function> or <function><link linkend="ref_arithmetic_or">or</link></function> are available as well <function><link linkend="ref_min">min</link></function> or <function><link linkend="ref_max">max</link></function> (calculate the minimum or maximum of its argument) or <function><link linkend="ref_mod">mod</link></function> or <function><link linkend="ref_int">int</link></function> (reminder of a division or integer part or a number).</para>
    </sect1>

    <sect1>
      <title>Data and such</title>
      <para>You may store data within your program within <function><link linkend="ref_data">data</link></function>-statements; during execution you will probably want to <function><link linkend="ref_read">read</link></function> it into <emphasis>arrays</emphasis>, which must have been <function><link linkend="ref_dim">dim</link></function>ed before.</para>
    </sect1>

    <sect1>
      <title>Other interesting commands.</title>
      <itemizedlist>
	<listitem>
	  <para><application>Yabasic</application> programs may start other programs with the commands <function><link linkend="ref_system">system</link></function> and <function><link linkend="ref_system2">system$</link></function>.</para>	
	</listitem>
	<listitem>
	  <para><function><link linkend="ref_peek">peek</link></function> and <function><link linkend="ref_poke">poke</link></function> allow to get and set internal information; either for the operating system (i.e. Unix or Windows) or <application>yabasic</application> itself.</para>
	</listitem>
	<listitem>
	  <para>The current time or date can be retrieved with (guess what !) <function><link linkend="ref_time">time$</link></function> and <function><link linkend="ref_date">date$</link></function>.</para>
	</listitem>
      </itemizedlist>
    </sect1>
  </chapter>



  <chapter id="chapter_topics_list">
    <title>All commands and functions of <application>yabasic</application> listed by topic</title>

    <sect1 renderas="sect2" id="top_numbers">
      <title>Number processing and conversion</title>
      <variablelist>

	<varlistentry>
	  <term><link linkend="ref_abs">abs()</link></term>
	  <listitem>
	    returns the absolute value of its numeric argument
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_acos">acos()</link></term>
	  <listitem>
	    returns the arcus cosine of its numeric argument
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_arithmetic_and">and()</link></term>
	  <listitem>
	    the bitwise arithmetic <function>and</function>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_asin">asin()</link></term>
	  <listitem>
	    returns the arcus sine of its numeric argument
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_atan">atan()</link></term>
	  <listitem>
	    returns the arctangent of its numeric argument
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_bin">bin$()</link></term>
	  <listitem>
	    converts a number into a sequence of binary digits
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_cos">cos()</link></term>
	  <listitem>
	    return the cosine of its single argument
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_dec">dec()</link></term>
	  <listitem>
	    convert a base 2 or base 16 number into decimal form
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_eor">eor()</link></term>
	  <listitem>
	    compute the bitwise <emphasis>exclusive or</emphasis> of its two arguments
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_euler">euler</link></term>
	  <listitem>
	    another name for the constant <function>2.71828182864</function>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_exp">exp()</link></term>
	  <listitem>
	    compute the exponential function of its single argument
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_frac">frac()</link></term>
	  <listitem>
	    return the fractional part of its numeric argument
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_int">int()</link></term>
	  <listitem>
	    return the integer part of its single numeric argument
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_log">log()</link></term>
	  <listitem>
	    compute the natural logarithm
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_max">max()</link></term>
	  <listitem>
	    return the larger of its two arguments
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_min">min()</link></term>
	  <listitem>
	    return the smaller of its two arguments
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_mod">mod()</link></term>
	  <listitem>
	    compute the remainder of a division
	  </listitem>
	</varlistentry>
	
	<varlistentry>
	  <term><link linkend="ref_arithmetic_or">or()</link></term>
	  <listitem>
	    arithmetic or, used for bit-operations
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_pi">pi</link></term>
	  <listitem>
	    a constant with the value <computeroutput>3.14159</computeroutput>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_ran">ran()</link></term>
	  <listitem>
	    return a random number
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_sig">sig()</link></term>
	  <listitem>
	    return the sign of its argument
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_sin">sin()</link></term>
	  <listitem>
	    return the sine of its single argument
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_sqr">sqr()</link></term>
	  <listitem>
	    compute the square of its argument
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_sqrt">sqrt()</link></term>
	  <listitem>
	    compute the square root of its argument
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_tan">tan()</link></term>
	  <listitem>
	    return the tangent of its argument
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_xor">xor()</link></term>
	  <listitem>
	    compute the exclusive or
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_pow">** or ^</link></term>
	  <listitem>
	    raise its first argument to the power of its second
	  </listitem>
	</varlistentry>

      </variablelist>
    </sect1>

    <sect1 renderas="sect2" id="top_conditions">
      <title>Conditions and control structures</title>
      <variablelist>

	<varlistentry>
	  <term><link linkend="ref_logical_and">and</link></term>
	  <listitem>
	    logical and, used in conditions
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_break">break</link></term>
	  <listitem>
	    breaks out of a switch statement or a loop
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_case">case</link></term>
	  <listitem>
	    mark the different cases within a <function><link linkend="ref_switch">switch</link></function>-statement
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_continue">continue</link></term>
	  <listitem>
	    start the next iteration of a <function>for</function>-, <function>do</function>-, <function>repeat</function>- or <function>while</function>-loop
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_default">default</link></term>
	  <listitem>
	    mark the <emphasis>default</emphasis>-branch within a <function><link linkend="ref_switch">switch</link></function>-statement
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_do">do</link></term>
	  <listitem>
	    start a (conditionless) <function>do-loop</function>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_else">else</link></term>
	  <listitem>
	    mark an alternative within an <function>if</function>-statement
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_elsif">elsif</link></term>
	  <listitem>
	    starts an alternate condition within an <function>if</function>-statement
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_end">end</link></term>
	  <listitem>
	    terminate your program
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_endif">endif</link></term>
	  <listitem>
	    ends an <function>if</function>-statement
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_false">false</link></term>
	  <listitem>
	    a constant with the value of 0
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_fi">fi</link></term>
	  <listitem>
	    another name for <function><link linkend="ref_endif">endif</link></function>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_for">for</link></term>
	  <listitem>
	    starts a <function>for</function>-loop
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_gosub">gosub</link></term>
	  <listitem>
	    continue execution at another point within your program (and return later)
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><link linkend="ref_goto">goto</link></term>
	  <listitem>
	    continue execution at another point within your program (and never come back)