Author: leo Date: Fri Apr 15 03:25:39 2005 New Revision: 7838 Modified: trunk/docs/pdds/pdd02_vtables.pod trunk/docs/pdds/pdd15_objects.pod Log: update pdds to current
Modified: trunk/docs/pdds/pdd02_vtables.pod ============================================================================== --- trunk/docs/pdds/pdd02_vtables.pod (original) +++ trunk/docs/pdds/pdd02_vtables.pod Fri Apr 15 03:25:39 2005 @@ -222,18 +222,9 @@ Return the native floating-point value of the PMC indexed by B<key>. The B<key> parameter is guaranteed not to be NULL for this method. -=item BIGNUM* get_bignum(INTERP, PMC* self) +=item PMC* get_bignum(INTERP, PMC* self) -Return the value of the PMC as a bignum. - -=item BIGNUM* get_bignum_keyed(INTERP, PMC* self, PMC* key) - -=item BIGNUM* get_bignum_keyed_int(INTERP, PMC* self, INTVAL key) - -=item BIGNUM* get_bignum_keyed_str(INTERP, PMC* self, STRING* key) - -Return the bignum value of the PMC indexed by B<key>. -The B<key> parameter is guaranteed not to be NULL for this method. +Return the value of the PMC as a new bignum PMC. =item STRING* get_string(INTERP, PMC* self) @@ -256,16 +247,6 @@ of the PMC: for a scalar, it may be as simple as 0 or "" being false, and any other value being true. -=item INTVAL get_bool_keyed(INTERP, PMC* self, PMC* key) - -=item INTVAL get_bool_keyed_int(INTERP, PMC* self, INTVAL key) - -=item INTVAL get_bool_keyed_str(INTERP, PMC* self, STRING* key) - -Return the constant TRUE if the PMC indexed by B<key> is true, -or FALSE if the PMC indexed by B<key> is false. -The B<key> parameter is guaranteed not to be NULL for this method. - =item PMC* get_pmc(INTERP, PMC* self) Return the PMC for this PMC. While this may seem nonsensical, it's @@ -331,24 +312,9 @@ Sets the PMC indexed by B<key> to the floating-point value passed in B<value>. The B<key> parameter is guaranteed not to be NULL for this method. -=item void set_bignum_native(INTERP, PMC* self, BIGNUM* value) - -Sets the PMC to the passed in bignum value. +=item void set_bignum_int(INTERP, PMC* self, INTVAL value) -=item void set_bignum_same(INTERP, PMC* self, PMC* value) - -Sets the PMC to the bignum value of B<value>. -In this case, B<value> is guaranteed to be of the same type -as B<self> so optimizations may be made. - -=item void set_bignum_keyed(INTERP, PMC* self, PMC* key, BIGNUM* value) - -=item void set_bignum_keyed_int(INTERP, PMC* self, INTVAL key, BIGNUM* value) - -=item void set_bignum_keyed_str(INTERP, PMC* self, STRING* key, BIGNUM* value) - -Sets the PMC indexed by B<key> to the bignum value passed in B<value>. -The B<key> parameter is guaranteed not to be NULL for this method. +Morph the PMC to a BIGNUM PMC with value being the passed in value. =item void set_string_native(INTERP, PMC* self, STRING* value) @@ -378,21 +344,9 @@ Sets the boolean state of the PMC to TRUE if B<value> is TRUE, or FALSE if B<value> is FALSE. -Note that this is currently unimplemented for any PMC, and it is not clear -how it will work in practice. - -=item void set_bool_keyed(INTERP, PMC* self, PMC* key, INTVAL value) - -=item void set_bool_keyed_int(INTERP, PMC* self, INTVAL key, INTVAL value) - -=item void set_bool_keyed_str(INTERP, PMC* self, STRING* key, INTVAL value) - -Keyed versions of set_bool. The B<key> parameter is guaranteed not to be -NULL for this method. - =item void set_pmc(INTERP, PMC* self, PMC* value) -Sets the value of the PMC in B<self> to the value of the PMC in B<value>. +Make the PMC B<self> refer to the PMC B<value>. =item void assign_pmc(INTERP, PMC* self, PMC* value) @@ -431,11 +385,6 @@ Return the floating-point value of the last item on the list, removing that item. -=item BIGNUM* pop_bignum(INTERP, PMC* self) - -Return the bignum value of the last item on the list, -removing that item. - =item STRING* pop_string(INTERP, PMC* self) Return the string value of the last item on the list, @@ -454,10 +403,6 @@ Add the passed in floating-point number to the end of the list. -=item void push_bignum(INTERP, PMC* self, BIGNUM* value) - -Add the passed in bignum to the end of the list. - =item void push_string(INTERP, PMC* self, STRING* value) Add the passed in string to the end of the list. @@ -475,11 +420,6 @@ Return the floating-point value of the first item on the list, removing that item. -=item BIGNUM* shift_bignum(INTERP, PMC* self) - -Return the bignum value of the first item on the list, -removing that item. - =item STRING* shift_string(INTERP, PMC* self) Return the string value of the first item on the list, @@ -498,10 +438,6 @@ Add the passed in floating-point number to the beginning of the list. -=item void unshift_bignum(INTERP, PMC* self, BIGNUM* value) - -Add the passed in bignum to the beginning of the list. - =item void unshift_string(INTERP, PMC* self, STRING* value) Add the passed in string to the beginning of the list. @@ -515,31 +451,34 @@ =item void add_int(INTERP, PMC* self, INTVAL value, PMC* dest) -=item void add_bignum(INTERP, PMC* self, BIGNUM* value, PMC* dest) - =item void add_float(INTERP, PMC* self, FLOATVAL value, PMC* dest) Add B<self> to B<value> and store the result in B<dest>. Note that B<dest> may be equal to B<self>; in that case optimizations I<may> be made. -=item void subtract(INTERP, PMC* self, PMC* value, PMC* dest) - -=item void subtract_int(INTERP, PMC* self, INTVAL value, PMC* dest) +=item PMC* subtract(INTERP, PMC* self, PMC* value, PMC* dest) -=item void subtract_bignum(INTERP, PMC* self, BIGNUM* value, PMC* dest) +=item PMC* subtract_int(INTERP, PMC* self, INTVAL value, PMC* dest) -=item void subtract_float(INTERP, PMC* self, FLOATVAL value, PMC* dest) +=item PMC* subtract_float(INTERP, PMC* self, FLOATVAL value, PMC* dest) +If B<dest> is NULL create a result PMC of an appropriate type. Subtract B<value> from B<self> and store the result in B<dest>. Note that B<dest> may be equal to B<self>; in that case optimizations I<may> be made. +=item void i_subtract(INTERP, PMC* self, PMC* value) + +=item void i_subtract_int(INTERP, PMC* self, INTVAL value) + +=item void i_subtract_float(INTERP, PMC* self, FLOATVAL value) + +Inplace operation B<self -= value>. + =item void multiply(INTERP, PMC* self, PMC* value, PMC* dest) =item void multiply_int(INTERP, PMC* self, INTVAL value, PMC* dest) -=item void multiply_bignum(INTERP, PMC* self, BIGNUM* value, PMC* dest) - =item void multiply_float(INTERP, PMC* self, FLOATVAL value, PMC* dest) Multiply B<value> by B<self> and store the result in B<dest>. Note that @@ -550,8 +489,6 @@ =item void divide_int(INTERP, PMC* self, INTVAL value, PMC* dest) -=item void divide_bignum(INTERP, PMC* self, BIGNUM* value, PMC* dest) - =item void divide_float(INTERP, PMC* self, FLOATVAL value, PMC* dest) Divide B<self> by B<value> and store the result in B<dest>. Note that @@ -562,8 +499,6 @@ =item void modulus_int(INTERP, PMC* self, INTVAL value, PMC* dest) -=item void modulus_bignum(INTERP, PMC* self, BIGNUM* value, PMC* dest) - =item void modulus_float(INTERP, PMC* self, FLOATVAL value, PMC* dest) Divide B<self> by B<value> and store the remainder in B<dest>. Note that @@ -574,8 +509,6 @@ =item void cmodulus_int(INTERP, PMC* self, INTVAL value, PMC* dest) -=item void cmodulus_bignum(INTERP, PMC* self, BIGNUM* value, PMC* dest) - =item void cmodulus_float(INTERP, PMC* self, FLOATVAL value, PMC* dest) Divide B<self> by B<value> and store the remainder in B<dest>. Note that Modified: trunk/docs/pdds/pdd15_objects.pod ============================================================================== --- trunk/docs/pdds/pdd15_objects.pod (original) +++ trunk/docs/pdds/pdd15_objects.pod Fri Apr 15 03:25:39 2005 @@ -627,12 +627,6 @@ Return the extended precision numeric value of the PMC -=item __get_bignum_keyed - -=item __get_bignum_keyed_int - -=item __get_bignum_keyed_str - =item __get_string Return the string value of the PMC @@ -695,18 +689,10 @@ =item __set_number_keyed_str -=item __set_bignum_native +=item __set_bignum_int Set the extended-precision value of this PMC -=item __set_bignum_same - -=item __set_bignum_keyed - -=item __set_bignum_keyed_int - -=item __set_bignum_keyed_str - =item __set_string_native Set the string value of this PMC @@ -723,15 +709,13 @@ Set the true/false value of this PMC -=item __set_bool_keyed +=item __assign_pmc -=item __set_bool_keyed_int - -=item __set_bool_keyed_str +Set the value to the value of the passed in =item __set_pmc -Set the PMC to the PMC passed in +Make the PMC refer to the PMC passed in =item __set_pmc_keyed @@ -756,8 +740,6 @@ =item __pop_float -=item __pop_bignum - =item __pop_string =item __pop_pmc @@ -766,8 +748,6 @@ =item __push_float -=item __push_bignum - =item __push_string =item __push_pmc @@ -776,8 +756,6 @@ =item __shift_float -=item __shift_bignum - =item __shift_string =item __shift_pmc @@ -786,8 +764,6 @@ =item __unshift_float -=item __unshift_bignum - =item __unshift_string =item __unshift_pmc @@ -798,48 +774,36 @@ =item __add_int -=item __add_bignum - =item __add_float =item __subtract =item __subtract_int -=item __subtract_bignum - =item __subtract_float =item __multiply =item __multiply_int -=item __multiply_bignum - =item __multiply_float =item __divide =item __divide_int -=item __divide_bignum - =item __divide_float =item __modulus =item __modulus_int -=item __modulus_bignum - =item __modulus_float =item __cmodulus =item __cmodulus_int -=item __cmodulus_bignum - =item __cmodulus_float =item __neg
