annotate netinstall/netio.h @ 4678:b5e1d4f6b66f

Make #'floor, #'ceiling, #'round, #'truncate conform to Common Lisp. lisp/ChangeLog addition: 2009-08-11 Aidan Kehoe <kehoea@parhasard.net> * cl-extra.el (ceiling*, floor*, round*, truncate*): Implement these in terms of the C functions; mark them as obsolete. (mod*, rem*): Use #'nth-value with the C functions, not #'nth with the CL emulation functions. man/ChangeLog addition: 2009-08-11 Aidan Kehoe <kehoea@parhasard.net> * lispref/numbers.texi (Bigfloat Basics): Correct this documentation (ignoring for the moment that it breaks off in mid-sentence). tests/ChangeLog addition: 2009-08-11 Aidan Kehoe <kehoea@parhasard.net> * automated/lisp-tests.el: Test the new Common Lisp-compatible rounding functions available in C. (generate-rounding-output): Provide a function useful for generating the data for the rounding functions tests. src/ChangeLog addition: 2009-08-11 Aidan Kehoe <kehoea@parhasard.net> * floatfns.c (ROUNDING_CONVERT, CONVERT_WITH_NUMBER_TYPES) (CONVERT_WITHOUT_NUMBER_TYPES, MAYBE_TWO_ARGS_BIGNUM) (MAYBE_ONE_ARG_BIGNUM, MAYBE_TWO_ARGS_RATIO) (MAYBE_ONE_ARG_RATIO, MAYBE_TWO_ARGS_BIGFLOAT) (MAYBE_ONE_ARG_BIGFLOAT, MAYBE_EFF, MAYBE_CHAR_OR_MARKER): New macros, used in the implementation of the rounding functions. (ceiling_two_fixnum, ceiling_two_bignum, ceiling_two_ratio) (ceiling_two_bigfloat, ceiling_one_ratio, ceiling_one_bigfloat) (ceiling_two_float, ceiling_one_float, ceiling_one_mundane_arg) (floor_two_fixnum, floor_two_bignum, floor_two_ratio) (floor_two_bigfloat, floor_one_ratio, floor_one_bigfloat) (floor_two_float, floor_one_mundane_arg, round_two_fixnum) (round_two_bignum_1, round_two_bignum, round_two_ratio) (round_one_bigfloat_1, round_two_bigfloat, round_one_ratio) (round_one_bigfloat, round_two_float, round_one_float) (round_one_mundane_arg, truncate_two_fixnum) (truncate_two_bignum, truncate_two_ratio, truncate_two_bigfloat) (truncate_one_ratio, truncate_one_bigfloat, truncate_two_float) (truncate_one_float, truncate_one_mundane_arg): New functions, used in the implementation of the rounding functions. (Fceiling, Ffloor, Fround, Ftruncate, Ffceiling, Fffloor) (Ffround, Fftruncate): Revise to fully support Common Lisp conventions. This means: -- All functions have optional DIVISOR arguments -- All functions return multiple values; see #'values -- All functions do their arithmetic with the correct number types according to the contamination rules. -- #'round and #'fround always round towards the even number in ambiguous cases. * doprnt.c (emacs_doprnt_1): * number.c (internal_coerce_number): Call Ftruncate with two arguments, not one. * floatfns.c (Ffloat): Correct this, if NUMBER is a bignum. * lisp.h: Declare Ftruncate as taking two arguments. * number.c: Provide scratch_ratio2, init it appropriately. * number.h: Make scratch_ratio2 available. * number.h (BIGFLOAT_ARITH_RETURN): * number.h (BIGFLOAT_ARITH_RETURN1): Correct these functions.
author Aidan Kehoe <kehoea@parhasard.net>
date Tue, 11 Aug 2009 17:59:23 +0100
parents 3078fd1074e8
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
448
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
1 /*
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
2 * Copyright (c) 2000, Red Hat, Inc.
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
3 *
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
4 * This program is free software; you can redistribute it and/or modify
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
5 * it under the terms of the GNU General Public License as published by
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
6 * the Free Software Foundation; either version 2 of the License, or
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
7 * (at your option) any later version.
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
8 *
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
9 * A copy of the GNU General Public License can be found at
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
10 * http://www.gnu.org/
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
11 *
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
12 * Written by DJ Delorie <dj@cygnus.com>
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
13 *
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
14 */
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
15
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
16 /* This is the parent class for all the access methods known to setup
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
17 (i.e. ways to download files from the internet or other sources */
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
18
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
19 class NetIO {
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
20 protected:
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
21 NetIO (char *url);
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
22 void set_url (char *url);
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
23
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
24 public:
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
25 /* if nonzero, this is the estimated total file size */
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
26 int file_size;
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
27 /* broken down url FYI */
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
28 char *url;
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
29 char *proto;
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
30 char *host;
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
31 int port;
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
32 char *path;
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
33 virtual ~NetIO ();
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
34
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
35 /* The user calls this function to create a suitable accessor for
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
36 the given URL. It uses the network setup state in state.h. If
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
37 anything fails, either the return values is NULL or the returned
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
38 object is !ok() */
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
39 static NetIO * open (char *url);
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
40
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
41 /* If !ok() that means the transfer isn't happening. */
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
42 virtual int ok ();
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
43
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
44 /* Read `nbytes' bytes from the file. Returns zero when the file
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
45 is complete. */
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
46 virtual int read (char *buf, int nbytes);
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
47
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
48 /* Helper functions for http/ftp protocols. Both return nonzero for
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
49 "cancel", zero for "ok". They set net_proxy_user, etc, in
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
50 state.h */
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
51 int get_auth ();
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
52 int get_proxy_auth ();
3078fd1074e8 Import from CVS: tag r21-2-39
cvs
parents:
diff changeset
53 };