diff options
| author | Craig Jennings <c@cjennings.net> | 2025-08-14 22:58:58 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2025-08-14 22:58:58 -0500 |
| commit | 82ba818ff456bcd6d56a06226e3f27e98fbb55c3 (patch) | |
| tree | 158cfc17b2f644a10f063cb546752cfaae12c97f /devdocs/elisp/string-conversion.html | |
| parent | 9278ddd4ea1a8b1a4c1edaa8894516e3f48d245b (diff) | |
| download | dotemacs-82ba818ff456bcd6d56a06226e3f27e98fbb55c3.tar.gz dotemacs-82ba818ff456bcd6d56a06226e3f27e98fbb55c3.zip | |
removing all downloaded devdocs files
Diffstat (limited to 'devdocs/elisp/string-conversion.html')
| -rw-r--r-- | devdocs/elisp/string-conversion.html | 43 |
1 files changed, 0 insertions, 43 deletions
diff --git a/devdocs/elisp/string-conversion.html b/devdocs/elisp/string-conversion.html deleted file mode 100644 index a62b76da..00000000 --- a/devdocs/elisp/string-conversion.html +++ /dev/null @@ -1,43 +0,0 @@ - <h3 class="section">Conversion of Characters and Strings</h3> <p>This section describes functions for converting between characters, strings and integers. <code>format</code> (see <a href="formatting-strings">Formatting Strings</a>) and <code>prin1-to-string</code> (see <a href="output-functions">Output Functions</a>) can also convert Lisp objects into strings. <code>read-from-string</code> (see <a href="input-functions">Input Functions</a>) can convert a string representation of a Lisp object into an object. The functions <code>string-to-multibyte</code> and <code>string-to-unibyte</code> convert the text representation of a string (see <a href="converting-representations">Converting Representations</a>). </p> <p>See <a href="documentation">Documentation</a>, for functions that produce textual descriptions of text characters and general input events (<code>single-key-description</code> and <code>text-char-description</code>). These are used primarily for making help messages. </p> <dl> <dt id="number-to-string">Function: <strong>number-to-string</strong> <em>number</em> -</dt> <dd> - <p>This function returns a string consisting of the printed base-ten representation of <var>number</var>. The returned value starts with a minus sign if the argument is negative. </p> <div class="example"> <pre class="example">(number-to-string 256) - ⇒ "256" -</pre> -<pre class="example">(number-to-string -23) - ⇒ "-23" -</pre> -<pre class="example">(number-to-string -23.5) - ⇒ "-23.5" -</pre> -</div> <p><code>int-to-string</code> is a semi-obsolete alias for this function. </p> <p>See also the function <code>format</code> in <a href="formatting-strings">Formatting Strings</a>. </p> -</dd> -</dl> <dl> <dt id="string-to-number">Function: <strong>string-to-number</strong> <em>string &optional base</em> -</dt> <dd> - <p>This function returns the numeric value of the characters in <var>string</var>. If <var>base</var> is non-<code>nil</code>, it must be an integer between 2 and 16 (inclusive), and integers are converted in that base. If <var>base</var> is <code>nil</code>, then base ten is used. Floating-point conversion only works in base ten; we have not implemented other radices for floating-point numbers, because that would be much more work and does not seem useful. </p> <p>The parsing skips spaces and tabs at the beginning of <var>string</var>, then reads as much of <var>string</var> as it can interpret as a number in the given base. (On some systems it ignores other whitespace at the beginning, not just spaces and tabs.) If <var>string</var> cannot be interpreted as a number, this function returns 0. </p> <div class="example"> <pre class="example">(string-to-number "256") - ⇒ 256 -(string-to-number "25 is a perfect square.") - ⇒ 25 -(string-to-number "X256") - ⇒ 0 -(string-to-number "-4.5") - ⇒ -4.5 -(string-to-number "1e5") - ⇒ 100000.0 -</pre> -</div> <p><code>string-to-int</code> is an obsolete alias for this function. </p> -</dd> -</dl> <dl> <dt id="char-to-string">Function: <strong>char-to-string</strong> <em>character</em> -</dt> <dd> - <p>This function returns a new string containing one character, <var>character</var>. This function is semi-obsolete because the function <code>string</code> is more general. See <a href="creating-strings">Creating Strings</a>. </p> -</dd> -</dl> <dl> <dt id="string-to-char">Function: <strong>string-to-char</strong> <em>string</em> -</dt> <dd><p>This function returns the first character in <var>string</var>. This mostly identical to <code>(aref string 0)</code>, except that it returns 0 if the string is empty. (The value is also 0 when the first character of <var>string</var> is the null character, <acronym>ASCII</acronym> code 0.) This function may be eliminated in the future if it does not seem useful enough to retain. </p></dd> -</dl> <p>Here are some other functions that can convert to or from a string: </p> <dl compact> <dt><code>concat</code></dt> <dd> -<p>This function converts a vector or a list into a string. See <a href="creating-strings">Creating Strings</a>. </p> </dd> <dt><code>vconcat</code></dt> <dd> -<p>This function converts a string into a vector. See <a href="vector-functions">Vector Functions</a>. </p> </dd> <dt><code>append</code></dt> <dd> -<p>This function converts a string into a list. See <a href="building-lists">Building Lists</a>. </p> </dd> <dt><code>byte-to-string</code></dt> <dd><p>This function converts a byte of character data into a unibyte string. See <a href="converting-representations">Converting Representations</a>. </p></dd> </dl><div class="_attribution"> - <p class="_attribution-p"> - Copyright © 1990-1996, 1998-2022 Free Software Foundation, Inc. <br>Licensed under the GNU GPL license.<br> - <a href="https://www.gnu.org/software/emacs/manual/html_node/elisp/String-Conversion.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/String-Conversion.html</a> - </p> -</div> |
