comparison src/fns.c @ 61433:74a256d5f3ec

(Fstring_as_multibyte, Fstring_to_multibyte): Docstring fixes.

61432:7279141eb80e

/* Random utility Lisp functions.
   Copyright (C) 1985, 86, 87, 93, 94, 95, 97, 98, 99, 2000, 2001, 02, 03, 2004
   Free Software Foundation, Inc.

This file is part of GNU Emacs.

GNU Emacs is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by

       doc: /* Return a multibyte string with the same individual bytes as STRING.
If STRING is multibyte, the result is STRING itself.
Otherwise it is a newly created string, with no text properties.
If STRING is unibyte and contains an individual 8-bit byte (i.e. not
part of a multibyte form), it is converted to the corresponding
multibyte character of charset `eight-bit-control' or `eight-bit-graphic'.  */)
     (string)
     Lisp_Object string;
{
  CHECK_STRING (string);

If STRING is multibyte, the result is STRING itself.
Otherwise it is a newly created string, with no text properties.
Characters 0200 through 0237 are converted to eight-bit-control
characters of the same character code.  Characters 0240 through 0377
are converted to eight-bit-graphic characters of the same character
codes.  */)
     (string)
     Lisp_Object string;
{
  CHECK_STRING (string);

61433:74a256d5f3ec

/* Random utility Lisp functions.
   Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1997, 1998, 1999, 2000,
     2001, 2002, 2003, 2004, 2005  Free Software Foundation, Inc.

This file is part of GNU Emacs.

GNU Emacs is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by

       doc: /* Return a multibyte string with the same individual bytes as STRING.
If STRING is multibyte, the result is STRING itself.
Otherwise it is a newly created string, with no text properties.
If STRING is unibyte and contains an individual 8-bit byte (i.e. not
part of a multibyte form), it is converted to the corresponding
multibyte character of charset `eight-bit-control' or `eight-bit-graphic'.
Beware, this often doesn't really do what you think it does.
It is similar to (decode-coding-string STRING 'emacs-mule-unix).
If you're not sure, whether to use `string-as-multibyte' or
`string-to-multibyte', use `string-to-multibyte'.  Beware:
   (aref (string-as-multibyte "\201") 0) -> 129 (aka ?\201)
   (aref (string-as-multibyte "\300") 0) -> 192 (aka ?\300)
   (aref (string-as-multibyte "\300\201") 0) -> 192 (aka ?\300)
   (aref (string-as-multibyte "\300\201") 1) -> 129 (aka ?\201)
but
   (aref (string-as-multibyte "\201\300") 0) -> 2240
   (aref (string-as-multibyte "\201\300") 1) -> <error>  */)
     (string)
     Lisp_Object string;
{
  CHECK_STRING (string);

If STRING is multibyte, the result is STRING itself.
Otherwise it is a newly created string, with no text properties.
Characters 0200 through 0237 are converted to eight-bit-control
characters of the same character code.  Characters 0240 through 0377
are converted to eight-bit-graphic characters of the same character
codes.
This is similar to (decode-coding-string STRING 'binary)  */)
     (string)
     Lisp_Object string;
{
  CHECK_STRING (string);