libguile/chars.c

   1 /*      Copyright (C) 1995,1996,1998, 2000 Free Software Foundation, Inc.
   2  *
   3  * This program is free software; you can redistribute it and/or modify
   4  * it under the terms of the GNU General Public License as published by
   5  * the Free Software Foundation; either version 2, or (at your option)
   6  * any later version.
   7  *
   8  * This program is distributed in the hope that it will be useful,
   9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  11  * GNU General Public License for more details.
  12  *
  13  * You should have received a copy of the GNU General Public License
  14  * along with this software; see the file COPYING.  If not, write to
  15  * the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
  16  * Boston, MA 02111-1307 USA
  17  *
  18  * As a special exception, the Free Software Foundation gives permission
  19  * for additional uses of the text contained in its release of GUILE.
  20  *
  21  * The exception is that, if you link the GUILE library with other files
  22  * to produce an executable, this does not by itself cause the
  23  * resulting executable to be covered by the GNU General Public License.
  24  * Your use of that executable is in no way restricted on account of
  25  * linking the GUILE library code into it.
  26  *
  27  * This exception does not however invalidate any other reasons why
  28  * the executable file might be covered by the GNU General Public License.
  29  *
  30  * This exception applies only to the code released by the
  31  * Free Software Foundation under the name GUILE.  If you copy
  32  * code from other Free Software Foundation releases into a copy of
  33  * GUILE, as the General Public License permits, the exception does
  34  * not apply to the code that you add in this way.  To avoid misleading
  35  * anyone as to the status of such modified files, you must delete
  36  * this exception notice from them.
  37  *
  38  * If you write modifications of your own for GUILE, it is your choice
  39  * whether to permit this exception to apply to your modifications.
  40  * If you do not wish that, delete this exception notice.  */
  41
  42 /* Software engineering face-lift by Greg J. Badros, 11-Dec-1999,
  43    gjb@cs.washington.edu, http://www.cs.washington.edu/homes/gjb */
  44
  45 \f
  46
  47 #include <stdio.h>
  48 #include <ctype.h>
  49 #include "libguile/_scm.h"
  50 #include "libguile/validate.h"
  51
  52 #include "libguile/chars.h"
  53 \f
  54
  55 SCM_DEFINE (scm_char_p, "char?", 1, 0, 0,
  56             (SCM x),
  57             "Return @code{#t} iff @var{x} is a character, else @code{#f}.")
  58 #define FUNC_NAME s_scm_char_p
  59 {
  60   return SCM_BOOL(SCM_CHARP(x));
  61 }
  62 #undef FUNC_NAME
  63
  64 SCM_DEFINE1 (scm_char_eq_p, "char=?", scm_tc7_rpsubr,
  65              (SCM x, SCM y),
  66              "Return @code{#t} iff @var{x} is the same character as @var{y}, else @code{#f}.")
  67 #define FUNC_NAME s_scm_char_eq_p
  68 {
  69   SCM_VALIDATE_CHAR (1, x);
  70   SCM_VALIDATE_CHAR (2, y);
  71   return SCM_BOOL (SCM_EQ_P (x, y));
  72 }
  73 #undef FUNC_NAME
  74
  75
  76 SCM_DEFINE1 (scm_char_less_p, "char<?", scm_tc7_rpsubr,
  77              (SCM x, SCM y),
  78              "Return @code{#t} iff @var{x} is less than @var{y} in the ASCII sequence,\n"
  79              "else @code{#f}.")
  80 #define FUNC_NAME s_scm_char_less_p
  81 {
  82   SCM_VALIDATE_CHAR (1,x);
  83   SCM_VALIDATE_CHAR (2,y);
  84   return SCM_BOOL(SCM_CHAR(x) < SCM_CHAR(y));
  85 }
  86 #undef FUNC_NAME
  87
  88 SCM_DEFINE1 (scm_char_leq_p, "char<=?", scm_tc7_rpsubr,
  89              (SCM x, SCM y),
  90              "Return @code{#t} iff @var{x} is less than or equal to @var{y} in the\n"
  91              "ASCII sequence, else @code{#f}.")
  92 #define FUNC_NAME s_scm_char_leq_p
  93 {
  94   SCM_VALIDATE_CHAR (1,x);
  95   SCM_VALIDATE_CHAR (2,y);
  96   return SCM_BOOL(SCM_CHAR(x) <= SCM_CHAR(y));
  97 }
  98 #undef FUNC_NAME
  99
 100 SCM_DEFINE1 (scm_char_gr_p, "char>?", scm_tc7_rpsubr,
 101              (SCM x, SCM y),
 102              "Return @code{#t} iff @var{x} is greater than @var{y} in the ASCII\n"
 103              "sequence, else @code{#f}.")
 104 #define FUNC_NAME s_scm_char_gr_p
 105 {
 106   SCM_VALIDATE_CHAR (1,x);
 107   SCM_VALIDATE_CHAR (2,y);
 108   return SCM_BOOL(SCM_CHAR(x) > SCM_CHAR(y));
 109 }
 110 #undef FUNC_NAME
 111
 112 SCM_DEFINE1 (scm_char_geq_p, "char>=?", scm_tc7_rpsubr,
 113              (SCM x, SCM y),
 114              "Return @code{#t} iff @var{x} is greater than or equal to @var{y} in the\n"
 115              "ASCII sequence, else @code{#f}.")
 116 #define FUNC_NAME s_scm_char_geq_p
 117 {
 118   SCM_VALIDATE_CHAR (1,x);
 119   SCM_VALIDATE_CHAR (2,y);
 120   return SCM_BOOL(SCM_CHAR(x) >= SCM_CHAR(y));
 121 }
 122 #undef FUNC_NAME
 123
 124 SCM_DEFINE1 (scm_char_ci_eq_p, "char-ci=?", scm_tc7_rpsubr,
 125              (SCM x, SCM y),
 126              "Return @code{#t} iff @var{x} is the same character as @var{y} ignoring\n"
 127              "case, else @code{#f}.")
 128 #define FUNC_NAME s_scm_char_ci_eq_p
 129 {
 130   SCM_VALIDATE_CHAR (1,x);
 131   SCM_VALIDATE_CHAR (2,y);
 132   return SCM_BOOL(scm_upcase(SCM_CHAR(x))==scm_upcase(SCM_CHAR(y)));
 133 }
 134 #undef FUNC_NAME
 135
 136 SCM_DEFINE1 (scm_char_ci_less_p, "char-ci<?", scm_tc7_rpsubr,
 137              (SCM x, SCM y),
 138              "Return @code{#t} iff @var{x} is less than @var{y} in the ASCII sequence\n"
 139              "ignoring case, else @code{#f}.")
 140 #define FUNC_NAME s_scm_char_ci_less_p
 141 {
 142   SCM_VALIDATE_CHAR (1,x);
 143   SCM_VALIDATE_CHAR (2,y);
 144   return SCM_BOOL((scm_upcase(SCM_CHAR(x))) < scm_upcase(SCM_CHAR(y)));
 145 }
 146 #undef FUNC_NAME
 147
 148 SCM_DEFINE1 (scm_char_ci_leq_p, "char-ci<=?", scm_tc7_rpsubr,
 149              (SCM x, SCM y),
 150              "Return @code{#t} iff @var{x} is less than or equal to @var{y} in the\n"
 151              "ASCII sequence ignoring case, else @code{#f}.")
 152 #define FUNC_NAME s_scm_char_ci_leq_p
 153 {
 154   SCM_VALIDATE_CHAR (1,x);
 155   SCM_VALIDATE_CHAR (2,y);
 156   return SCM_BOOL(scm_upcase(SCM_CHAR(x)) <= scm_upcase(SCM_CHAR(y)));
 157 }
 158 #undef FUNC_NAME
 159
 160 SCM_DEFINE1 (scm_char_ci_gr_p, "char-ci>?", scm_tc7_rpsubr,
 161              (SCM x, SCM y),
 162              "Return @code{#t} iff @var{x} is greater than @var{y} in the ASCII\n"
 163              "sequence ignoring case, else @code{#f}.")
 164 #define FUNC_NAME s_scm_char_ci_gr_p
 165 {
 166   SCM_VALIDATE_CHAR (1,x);
 167   SCM_VALIDATE_CHAR (2,y);
 168   return SCM_BOOL(scm_upcase(SCM_CHAR(x)) > scm_upcase(SCM_CHAR(y)));
 169 }
 170 #undef FUNC_NAME
 171
 172 SCM_DEFINE1 (scm_char_ci_geq_p, "char-ci>=?", scm_tc7_rpsubr,
 173              (SCM x, SCM y),
 174              "Return @code{#t} iff @var{x} is greater than or equal to @var{y} in the\n"
 175              "ASCII sequence ignoring case, else @code{#f}.")
 176 #define FUNC_NAME s_scm_char_ci_geq_p
 177 {
 178   SCM_VALIDATE_CHAR (1,x);
 179   SCM_VALIDATE_CHAR (2,y);
 180   return SCM_BOOL(scm_upcase(SCM_CHAR(x)) >= scm_upcase(SCM_CHAR(y)));
 181 }
 182 #undef FUNC_NAME
 183
 184
 185 SCM_DEFINE (scm_char_alphabetic_p, "char-alphabetic?", 1, 0, 0,
 186            (SCM chr),
 187             "Return @code{#t} iff @var{chr} is alphabetic, else @code{#f}.\n"
 188             "Alphabetic means the same thing as the isalpha C library function.")
 189 #define FUNC_NAME s_scm_char_alphabetic_p
 190 {
 191   SCM_VALIDATE_CHAR (1,chr);
 192   return SCM_BOOL(isascii(SCM_CHAR(chr)) && isalpha(SCM_CHAR(chr)));
 193 }
 194 #undef FUNC_NAME
 195
 196 SCM_DEFINE (scm_char_numeric_p, "char-numeric?", 1, 0, 0,
 197            (SCM chr),
 198             "Return @code{#t} iff @var{chr} is numeric, else @code{#f}.\n"
 199             "Numeric means the same thing as the isdigit C library function.")
 200 #define FUNC_NAME s_scm_char_numeric_p
 201 {
 202   SCM_VALIDATE_CHAR (1,chr);
 203   return SCM_BOOL(isascii(SCM_CHAR(chr)) && isdigit(SCM_CHAR(chr)));
 204 }
 205 #undef FUNC_NAME
 206
 207 SCM_DEFINE (scm_char_whitespace_p, "char-whitespace?", 1, 0, 0,
 208            (SCM chr),
 209             "Return @code{#t} iff @var{chr} is whitespace, else @code{#f}.\n"
 210             "Whitespace means the same thing as the isspace C library function.")
 211 #define FUNC_NAME s_scm_char_whitespace_p
 212 {
 213   SCM_VALIDATE_CHAR (1,chr);
 214   return SCM_BOOL(isascii(SCM_CHAR(chr)) && isspace(SCM_CHAR(chr)));
 215 }
 216 #undef FUNC_NAME
 217
 218
 219
 220 SCM_DEFINE (scm_char_upper_case_p, "char-upper-case?", 1, 0, 0,
 221            (SCM chr),
 222             "Return @code{#t} iff @var{chr} is uppercase, else @code{#f}.\n"
 223             "Uppercase means the same thing as the isupper C library function.")
 224 #define FUNC_NAME s_scm_char_upper_case_p
 225 {
 226   SCM_VALIDATE_CHAR (1,chr);
 227   return SCM_BOOL(isascii(SCM_CHAR(chr)) && isupper(SCM_CHAR(chr)));
 228 }
 229 #undef FUNC_NAME
 230
 231
 232 SCM_DEFINE (scm_char_lower_case_p, "char-lower-case?", 1, 0, 0,
 233            (SCM chr),
 234             "Return @code{#t} iff @var{chr} is lowercase, else @code{#f}.\n"
 235             "Lowercase means the same thing as the islower C library function.")
 236 #define FUNC_NAME s_scm_char_lower_case_p
 237 {
 238   SCM_VALIDATE_CHAR (1,chr);
 239   return SCM_BOOL(isascii(SCM_CHAR(chr)) && islower(SCM_CHAR(chr)));
 240 }
 241 #undef FUNC_NAME
 242
 243
 244
 245 SCM_DEFINE (scm_char_is_both_p, "char-is-both?", 1, 0, 0,
 246             (SCM chr),
 247             "Return @code{#t} iff @var{chr} is either uppercase or lowercase, else @code{#f}.\n"
 248             "Uppercase and lowercase are as defined by the isupper and islower\n"
 249             "C library functions.")
 250 #define FUNC_NAME s_scm_char_is_both_p
 251 {
 252   SCM_VALIDATE_CHAR (1,chr);
 253   return SCM_BOOL(isascii(SCM_CHAR(chr)) && (isupper(SCM_CHAR(chr)) || islower(SCM_CHAR(chr))));
 254 }
 255 #undef FUNC_NAME
 256
 257
 258
 259
 260 SCM_DEFINE (scm_char_to_integer, "char->integer", 1, 0, 0,
 261             (SCM chr),
 262             "Return the number corresponding to ordinal position of @var{chr} in the\n"
 263             "ASCII sequence.")
 264 #define FUNC_NAME s_scm_char_to_integer
 265 {
 266   SCM_VALIDATE_CHAR (1,chr);
 267   return scm_ulong2num((unsigned long)SCM_CHAR(chr));
 268 }
 269 #undef FUNC_NAME
 270
 271
 272
 273 SCM_DEFINE (scm_integer_to_char, "integer->char", 1, 0, 0,
 274            (SCM n),
 275             "Return the character at position @var{n} in the ASCII sequence.")
 276 #define FUNC_NAME s_scm_integer_to_char
 277 {
 278   SCM_VALIDATE_INUM_RANGE (1, n, 0, 256);
 279   return SCM_MAKE_CHAR (SCM_INUM (n));
 280 }
 281 #undef FUNC_NAME
 282
 283
 284 SCM_DEFINE (scm_char_upcase, "char-upcase", 1, 0, 0,
 285            (SCM chr),
 286             "Return the uppercase character version of @var{chr}.")
 287 #define FUNC_NAME s_scm_char_upcase
 288 {
 289   SCM_VALIDATE_CHAR (1,chr);
 290   return SCM_MAKE_CHAR(scm_upcase(SCM_CHAR(chr)));
 291 }
 292 #undef FUNC_NAME
 293
 294
 295 SCM_DEFINE (scm_char_downcase, "char-downcase", 1, 0, 0,
 296            (SCM chr),
 297             "Return the lowercase character version of @var{chr}.")
 298 #define FUNC_NAME s_scm_char_downcase
 299 {
 300   SCM_VALIDATE_CHAR (1,chr);
 301   return SCM_MAKE_CHAR(scm_downcase(SCM_CHAR(chr)));
 302 }
 303 #undef FUNC_NAME
 304
 305 \f
 306
 307
 308
 309 static unsigned char scm_upcase_table[SCM_CHAR_CODE_LIMIT];
 310 static unsigned char scm_downcase_table[SCM_CHAR_CODE_LIMIT];
 311 static const unsigned char scm_lowers[] = "abcdefghijklmnopqrstuvwxyz";
 312 static const unsigned char scm_uppers[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
 313
 314
 315 void
 316 scm_tables_prehistory ()
 317 {
 318   int i;
 319   for (i = 0; i < SCM_CHAR_CODE_LIMIT; i++)
 320     scm_upcase_table[i] = scm_downcase_table[i] = i;
 321   for (i = 0; i < (int) (sizeof scm_lowers / sizeof (scm_lowers[0])); i++)
 322     {
 323       scm_upcase_table[scm_lowers[i]] = scm_uppers[i];
 324       scm_downcase_table[scm_uppers[i]] = scm_lowers[i];
 325     }
 326 }
 327
 328
 329 int
 330 scm_upcase (unsigned int c)
 331 {
 332   if (c < sizeof (scm_upcase_table))
 333     return scm_upcase_table[c];
 334   else
 335     return c;
 336 }
 337
 338
 339 int
 340 scm_downcase (unsigned int c)
 341 {
 342   if (c < sizeof (scm_downcase_table))
 343     return scm_downcase_table[c];
 344   else
 345     return c;
 346 }
 347
 348
 349 #ifdef _DCC
 350 # define ASCII
 351 #else
 352 # if (('\n'=='\025') && (' '=='\100') && ('a'=='\201') && ('A'=='\301'))
 353 #  define EBCDIC
 354 # endif /*  (('\n'=='\025') && (' '=='\100') && ('a'=='\201') && ('A'=='\301')) */
 355 # if (('\n'=='\012') && (' '=='\040') && ('a'=='\141') && ('A'=='\101'))
 356 #  define ASCII
 357 # endif /*  (('\n'=='\012') && (' '=='\040') && ('a'=='\141') && ('A'=='\101')) */
 358 #endif /* def _DCC */
 359
 360
 361 #ifdef EBCDIC
 362 char *const scm_charnames[] =
 363 {
 364   "nul","soh","stx","etx", "pf", "ht", "lc","del",
 365    0   , 0   ,"smm", "vt", "ff", "cr", "so", "si",
 366   "dle","dc1","dc2","dc3","res", "nl", "bs", "il",
 367   "can", "em", "cc", 0   ,"ifs","igs","irs","ius",
 368    "ds","sos", "fs", 0   ,"byp", "lf","eob","pre",
 369    0   , 0   , "sm", 0   , 0   ,"enq","ack","bel",
 370    0   , 0   ,"syn", 0   , "pn", "rs", "uc","eot",
 371    0   , 0   , 0   , 0   ,"dc4","nak", 0   ,"sub",
 372    "space", scm_s_newline, "tab", "backspace", "return", "page", "null"};
 373
 374 const char scm_charnums[] =
 375 "\000\001\002\003\004\005\006\007\
 376 \010\011\012\013\014\015\016\017\
 377 \020\021\022\023\024\025\026\027\
 378 \030\031\032\033\034\035\036\037\
 379 \040\041\042\043\044\045\046\047\
 380 \050\051\052\053\054\055\056\057\
 381 \060\061\062\063\064\065\066\067\
 382 \070\071\072\073\074\075\076\077\
 383  \n\t\b\r\f\0";
 384 #endif /* def EBCDIC */
 385 #ifdef ASCII
 386 char *const scm_charnames[] =
 387 {
 388   "nul","soh","stx","etx","eot","enq","ack","bel",
 389    "bs", "ht", "newline", "vt", "np", "cr", "so", "si",
 390   "dle","dc1","dc2","dc3","dc4","nak","syn","etb",
 391   "can", "em","sub","esc", "fs", "gs", "rs", "us",
 392   "space", "nl", "tab", "backspace", "return", "page", "null", "del"};
 393 const char scm_charnums[] =
 394 "\000\001\002\003\004\005\006\007\
 395 \010\011\012\013\014\015\016\017\
 396 \020\021\022\023\024\025\026\027\
 397 \030\031\032\033\034\035\036\037\
 398  \n\t\b\r\f\0\177";
 399 #endif /* def ASCII */
 400
 401 int scm_n_charnames = sizeof (scm_charnames) / sizeof (char *);
 402
 403
 404 \f
 405
 406
 407 void
 408 scm_init_chars ()
 409 {
 410 #ifndef SCM_MAGIC_SNARFER
 411 #include "libguile/chars.x"
 412 #endif
 413 }
 414
 415
 416 /*
 417   Local Variables:
 418   c-file-style: "gnu"
 419   End:
 420 */