Ignore:
File:
1 edited

Legend:

Unmodified
Added
Removed
  • doc/user/user.tex

    rc8771e9 r92c0f81  
    1111%% Created On       : Wed Apr  6 14:53:29 2016
    1212%% Last Modified By : Peter A. Buhr
    13 %% Last Modified On : Mon Nov 27 18:09:59 2017
    14 %% Update Count     : 3143
     13%% Last Modified On : Sun Aug  6 10:24:21 2017
     14%% Update Count     : 3036
    1515%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
    1616
     
    5959\CFAStyle                                                                                               % use default CFA format-style
    6060\lstnewenvironment{C++}[1][]                            % use C++ style
    61 {\lstset{language=C++,moredelim=**[is][\protect\color{red}]{®}{®},#1}}
     61{\lstset{language=C++,moredelim=**[is][\protect\color{red}]{®}{®}#1}}
    6262{}
    6363
     
    777777  case 7:
    778778        ...
    779         ®break®                                         §\C{// explicit end of switch (redundant)
     779        ®break®                                         §\C{// redundant explicit end of switch
    780780  default:
    781781        j = 3;
     
    806806                ®int k = 0;®                    §\C{// allowed at different nesting levels}§
    807807                ...
    808           ®case 2:®                                     §\C{// disallow case in nested statements}§
    809808        }
    810809  ...
     
    963962\end{cfa}
    964963
    965 The components in the "with" clause
    966 
    967   with a, b, c { ... }
    968 
    969 serve 2 purposes: each component provides a type and object. The type must be a
    970 structure type. Enumerations are already opened, and I think a union is opened
    971 to some extent, too. (Or is that just unnamed unions?) The object is the target
    972 that the naked structure-fields apply to. The components are open in "parallel"
    973 at the scope of the "with" clause/statement, so opening "a" does not affect
    974 opening "b", etc. This semantic is different from Pascal, which nests the
    975 openings.
    976 
    977 Having said the above, it seems reasonable to allow a "with" component to be an
    978 expression. The type is the static expression-type and the object is the result
    979 of the expression. Again, the type must be an aggregate. Expressions require
    980 parenthesis around the components.
    981 
    982   with( a, b, c ) { ... }
    983 
    984 Does this now make sense?
    985 
    986 Having written more CFA code, it is becoming clear to me that I *really* want
    987 the "with" to be implemented because I hate having to type all those object
    988 names for fields. It's a great way to drive people away from the language.
    989 
    990964
    991965\section{Exception Handling}
     
    1003977try {
    1004978        f(...);
    1005 } catch( E e ; §boolean-predicate§ ) {                  §\C[8cm]{// termination handler}§
     979} catch( E e : §boolean-predicate§ ) {                  §\C[8cm]{// termination handler}§
    1006980        // recover and continue
    1007 } catchResume( E e ; §boolean-predicate§ ) {    §\C{// resumption handler}\CRT§
     981} catchResume( E e : §boolean-predicate§ ) {    §\C{// resumption handler}\CRT§
    1008982        // repair and return
    1009983} finally {
     
    18981872\end{cfa}
    18991873This syntax allows a prototype declaration to be created by cutting and pasting source text from the routine definition header (or vice versa).
    1900 Like C, it is possible to declare multiple routine-prototypes in a single declaration, where the return type is distributed across \emph{all} routine names in the declaration list (see~\VRef{s:Declarations}), \eg:
    1901 \begin{cfa}
    1902 C :             const double bar1(), bar2( int ), bar3( double );
    1903 §\CFA§: [const double] foo(), foo( int ), foo( double ) { return 3.0; }
    1904 \end{cfa}
    1905 \CFA allows the last routine in the list to define its body.
    1906 
     1874It is possible to declare multiple routine-prototypes in a single declaration, but the entire type specification is distributed across \emph{all} routine names in the declaration list (see~\VRef{s:Declarations}), \eg:
     1875\begin{quote2}
     1876\begin{tabular}{@{}l@{\hspace{3em}}l@{}}
     1877\multicolumn{1}{c@{\hspace{3em}}}{\textbf{\CFA}}        & \multicolumn{1}{c}{\textbf{C}}        \\
     1878\begin{cfa}
     1879[ int ] f( int ), g;
     1880\end{cfa}
     1881&
     1882\begin{cfa}
     1883int f( int ), g( int );
     1884\end{cfa}
     1885\end{tabular}
     1886\end{quote2}
    19071887Declaration qualifiers can only appear at the start of a \CFA routine declaration,\footref{StorageClassSpecifier} \eg:
    19081888\begin{cfa}
     
    22552235\label{s:MRV_Functions}
    22562236
    2257 In C and most programming languages, functions return at most one value;
    2258 however, many operations have multiple outcomes, some exceptional (see~\VRef{s:ExceptionHandling}).
     2237In standard C, functions can return at most one value.
    22592238To emulate functions with multiple return values, \emph{\Index{aggregation}} and/or \emph{\Index{aliasing}} is used.
    2260 
    2261 In the former approach, a record type is created combining all of the return values.
    2262 For example, consider C's \Indexc{div} function, which returns the quotient and remainder for a division of an integer value.
    2263 \begin{cfa}
    2264 typedef struct { int quot, rem; } div_t;        §\C[7cm]{// from include stdlib.h}§
    2265 div_t div( int num, int den );
    2266 div_t qr = div( 13, 5 );                                        §\C{// return quotient/remainder aggregate}§
    2267 printf( "%d %d\n", qr.quot, qr.rem );           §\C{// print quotient/remainder}§
    2268 \end{cfa}
    2269 This approach requires a name for the return type and fields, where \Index{naming} is a common programming-language issue.
    2270 That is, naming creates an association that must be managed when reading and writing code.
    2271 While effective when used sparingly, this approach does not scale when functions need to return multiple combinations of types.
    2272 
    2273 In the latter approach, additional return values are passed as pointer parameters.
    2274 A pointer parameter is assigned inside the routine to emulate a return.
    2275 For example, consider C's \Indexc{modf} function, which returns the integral and fractional part of a floating-point value.
    2276 \begin{cfa}
    2277 double modf( double x, double * i );            §\C{// from include math.h}§
    2278 double intp, frac = modf( 13.5, &intp );        §\C{// return integral and fractional components}§
    2279 printf( "%g %g\n", intp, frac );                        §\C{// print integral/fractional components}§
    2280 \end{cfa}
    2281 This approach requires allocating storage for the return values, which complicates the call site with a sequence of variable declarations leading to the call.
    2282 Also, while a disciplined use of ©const© can give clues about whether a pointer parameter is used as an \Index{out parameter}, it is not obvious from the routine signature whether the callee expects such a parameter to be initialized before the call.
    2283 Furthermore, while many C routines that accept pointers are safe for a ©NULL© argument, there are many C routines that are not null-safe.
    2284 Finally, C does not provide a mechanism to state that a parameter is going to be used as an additional return value, which makes the job of ensuring that a value is returned more difficult for the compiler.
     2239In the former situation, the function designer creates a record type that combines all of the return values into a single type.
     2240For example, consider a function returning the most frequently occurring letter in a string, and its frequency.
     2241This example is complex enough to illustrate that an array is insufficient, since arrays are homogeneous, and demonstrates a potential pitfall that exists with aliasing.
     2242\begin{cfa}
     2243struct mf_ret {
     2244        int freq;
     2245        char ch;
     2246};
     2247
     2248struct mf_ret most_frequent(const char * str) {
     2249        char freqs [26] = { 0 };
     2250        struct mf_ret ret = { 0, 'a' };
     2251        for (int i = 0; str[i] != '\0'; ++i) {
     2252                if (isalpha(str[i])) {        // only count letters
     2253                        int ch = tolower(str[i]);   // convert to lower case
     2254                        int idx = ch-'a';
     2255                        if (++freqs[idx] > ret.freq) {  // update on new max
     2256                          ret.freq = freqs[idx];
     2257                          ret.ch = ch;
     2258                        }
     2259                }
     2260        }
     2261        return ret;
     2262}
     2263
     2264const char * str = "hello world";
     2265struct mf_ret ret = most_frequent(str);
     2266printf("%s -- %d %c\n", str, ret.freq, ret.ch);
     2267\end{cfa}
     2268Of note, the designer must come up with a name for the return type and for each of its fields.
     2269Unnecessary naming is a common programming language issue, introducing verbosity and a complication of the user's mental model.
     2270That is, adding another named type creates another association in the programmer's mind that needs to be kept track of when reading and writing code.
     2271As such, this technique is effective when used sparingly, but can quickly get out of hand if many functions need to return different combinations of types.
     2272
     2273In the latter approach, the designer simulates multiple return values by passing the additional return values as pointer parameters.
     2274The pointer parameters are assigned inside of the routine body to emulate a return.
     2275Using the same example,
     2276\begin{cfa}
     2277int most_frequent(const char * str, char * ret_ch) {
     2278        char freqs [26] = { 0 };
     2279        int ret_freq = 0;
     2280        for (int i = 0; str[i] != '\0'; ++i) {
     2281                if (isalpha(str[i])) {        // only count letters
     2282                        int ch = tolower(str[i]);   // convert to lower case
     2283                        int idx = ch-'a';
     2284                        if (++freqs[idx] > ret_freq) {  // update on new max
     2285                          ret_freq = freqs[idx];
     2286                          *ret_ch = ch;   // assign to out parameter
     2287                        }
     2288                }
     2289        }
     2290        return ret_freq;  // only one value returned directly
     2291}
     2292
     2293const char * str = "hello world";
     2294char ch;                            // pre-allocate return value
     2295int freq = most_frequent(str, &ch); // pass return value as out parameter
     2296printf("%s -- %d %c\n", str, freq, ch);
     2297\end{cfa}
     2298Notably, using this approach, the caller is directly responsible for allocating storage for the additional temporary return values, which complicates the call site with a sequence of variable declarations leading up to the call.
     2299Also, while a disciplined use of ©const© can give clues about whether a pointer parameter is going to be used as an out parameter, it is not immediately obvious from only the routine signature whether the callee expects such a parameter to be initialized before the call.
     2300Furthermore, while many C routines that accept pointers are designed so that it is safe to pass ©NULL© as a parameter, there are many C routines that are not null-safe.
     2301On a related note, C does not provide a standard mechanism to state that a parameter is going to be used as an additional return value, which makes the job of ensuring that a value is returned more difficult for the compiler.
     2302Interestingly, there is a subtle bug in the previous example, in that ©ret_ch© is never assigned for a string that does not contain any letters, which can lead to undefined behaviour.
     2303In this particular case, it turns out that the frequency return value also doubles as an error code, where a frequency of 0 means the character return value should be ignored.
    22852304Still, not every routine with multiple return values should be required to return an error code, and error codes are easily ignored, so this is not a satisfying solution.
    22862305As with the previous approach, this technique can simulate multiple return values, but in practice it is verbose and error prone.
    22872306
    2288 \CFA allows functions to return multiple values by extending the function declaration syntax.
     2307In \CFA, functions can be declared to return multiple values with an extension to the function declaration syntax.
    22892308Multiple return values are declared as a comma-separated list of types in square brackets in the same location that the return type appears in standard C function declarations.
    2290 \begin{cfa}
    2291 [ char, int, double ] f( ... );
    2292 \end{cfa}
    22932309The ability to return multiple values from a function requires a new syntax for the return statement.
    22942310For consistency, the return statement in \CFA accepts a comma-separated list of expressions in square brackets.
    2295 \begin{cfa}
    2296 return [ c, i, d ];
    2297 \end{cfa}
    2298 The expression resolution ensures the correct form is used depending on the values being returned and the return type of the current function.
     2311The expression resolution phase of the \CFA translator ensures that the correct form is used depending on the values being returned and the return type of the current function.
    22992312A multiple-returning function with return type ©T© can return any expression that is implicitly convertible to ©T©.
    2300 
    2301 A common use of a function's output is input to another function.
    2302 \CFA allows this case, without any new syntax;
    2303 a multiple-returning function can be used in any of the contexts where an expression is allowed.
    2304 When a function call is passed as an argument to another call, the best match of actual arguments to formal parameters is evaluated given all possible expression interpretations in the current scope.
    2305 \begin{cfa}
    2306 void g( int, int );                                                     §\C{// 1}§
    2307 void g( double, double );                                       §\C{// 2}§
    2308 g( div( 13, 5 ) );                                                      §\C{// select 1}§
    2309 g( modf( 13.5 ) );                                                      §\C{// select 2}§
    2310 \end{cfa}
    2311 In this case, there are two overloaded ©g© routines.
    2312 Both calls to ©g© expect two arguments that are matched by the two return values from ©div© and ©modf©. respectively, which are fed directly to the first and second parameters of ©g©.
    2313 As well, both calls to ©g© have exact type matches for the two different versions of ©g©, so these exact matches are chosen.
    2314 When type matches are not exact, conversions are used to find a best match.
    2315 
    2316 The previous examples can be rewritten passing the multiple returned-values directly to the ©printf© function call.
    2317 \begin{cfa}
    2318 [ int, int ] div( int x, int y );                       §\C{// from include stdlib}§
    2319 printf( "%d %d\n", div( 13, 5 ) );                      §\C{// print quotient/remainder}§
    2320 
    2321 [ double, double ] modf( double x );            §\C{// from include math}§
    2322 printf( "%g %g\n", modf( 13.5 ) );                      §\C{// print integral/fractional components}§
    2323 \end{cfa}
    2324 This approach provides the benefits of compile-time checking for appropriate return statements as in aggregation, but without the required verbosity of declaring a new named type.
    2325 
    2326 Finally, the addition of multiple-return-value functions necessitates a syntax for retaining the multiple values at the call-site versus their temporary existence during a call.
     2313Using the running example, the ©most_frequent© function can be written using multiple return values as such,
     2314\begin{cfa}
     2315[int, char] most_frequent(const char * str) {
     2316        char freqs [26] = { 0 };
     2317        int ret_freq = 0;
     2318        char ret_ch = 'a';  // arbitrary default value for consistent results
     2319        for (int i = 0; str[i] != '\0'; ++i) {
     2320                if (isalpha(str[i])) {        // only count letters
     2321                        int ch = tolower(str[i]);   // convert to lower case
     2322                        int idx = ch-'a';
     2323                        if (++freqs[idx] > ret_freq) {  // update on new max
     2324                          ret_freq = freqs[idx];
     2325                          ret_ch = ch;
     2326                        }
     2327                }
     2328        }
     2329        return [ret_freq, ret_ch];
     2330}
     2331\end{cfa}
     2332This approach provides the benefits of compile-time checking for appropriate return statements as in aggregation, but without the required verbosity of declaring a new named type, which precludes the bug seen with out-parameters.
     2333
     2334The addition of multiple-return-value functions necessitates a syntax for accepting multiple values at the call-site.
    23272335The simplest mechanism for retaining a return value in C is variable assignment.
    2328 By assigning the multiple return-values into multiple variables, the values can be retrieved later.
     2336By assigning the return value into a variable, its value can be retrieved later at any point in the program.
    23292337As such, \CFA allows assigning multiple values from a function into multiple variables, using a square-bracketed list of lvalue expressions on the left side.
    23302338\begin{cfa}
    2331 int quot, rem;
    2332 [ quot, rem ] = div( 13, 5 );                           §\C{// assign multiple variables}§
    2333 printf( "%d %d\n", quot, rem );                         §\C{// print quotient/remainder}\CRT§
    2334 \end{cfa}
    2335 Here, the multiple return-values are matched in much the same way as passing multiple return-values to multiple parameters in a call.
    2336 
    2337 
    2338 \subsection{Expressions}
    2339 
     2339const char * str = "hello world";
     2340int freq;
     2341char ch;
     2342[freq, ch] = most_frequent(str);  // assign into multiple variables
     2343printf("%s -- %d %c\n", str, freq, ch);
     2344\end{cfa}
     2345It is also common to use a function's output as the input to another function.
     2346\CFA also allows this case, without any new syntax.
     2347When a function call is passed as an argument to another call, the expression resolver attempts to find the best match of actual arguments to formal parameters given all of the possible expression interpretations in the current scope \cite{Bilson03}.
     2348For example,
     2349\begin{cfa}
     2350void process(int);       // (1)
     2351void process(char);      // (2)
     2352void process(int, char); // (3)
     2353void process(char, int); // (4)
     2354
     2355process(most_frequent("hello world"));  // selects (3)
     2356\end{cfa}
     2357In this case, there is only one option for a function named ©most_frequent© that takes a string as input.
     2358This function returns two values, one ©int© and one ©char©.
     2359There are four options for a function named ©process©, but only two that accept two arguments, and of those the best match is (3), which is also an exact match.
     2360This expression first calls ©most_frequent("hello world")©, which produces the values ©3© and ©'l'©, which are fed directly to the first and second parameters of (3), respectively.
     2361
     2362\section{Tuple Expressions}
    23402363Multiple-return-value functions provide \CFA with a new syntax for expressing a combination of expressions in the return statement and a combination of types in a function signature.
    2341 These notions are generalized to provide \CFA with \newterm{tuple expression}s and \newterm{tuple type}s.
     2364These notions can be generalized to provide \CFA with \emph{tuple expressions} and \emph{tuple types}.
    23422365A tuple expression is an expression producing a fixed-size, ordered list of values of heterogeneous types.
    2343 The type of a tuple expression is the tuple of the subexpression types, or a tuple type.
    2344 
     2366The type of a tuple expression is the tuple of the subexpression types, or a \emph{tuple type}.
    23452367In \CFA, a tuple expression is denoted by a comma-separated list of expressions enclosed in square brackets.
    23462368For example, the expression ©[5, 'x', 10.5]© has type ©[int, char, double]©.
     
    23492371The order of evaluation of the components in a tuple expression is unspecified, to allow a compiler the greatest flexibility for program optimization.
    23502372It is, however, guaranteed that each component of a tuple expression is evaluated for side-effects, even if the result is not used.
    2351 Multiple-return-value functions can equivalently be called \newterm{tuple-returning functions}.
    2352 
    2353 
    2354 \subsection{Variables}
    2355 
    2356 The previous call of ©div© still requires the preallocation of multiple return-variables in a manner similar to the aliasing example.
    2357 In \CFA, it is possible to overcome this restriction by declaring a \newterm{tuple variable}.
    2358 \begin{cfa}
    2359 [int, int] ®qr® = div( 13, 5 );                 §\C{// initialize tuple variable}§
    2360 printf( "%d %d\n", ®qr® );                              §\C{// print quotient/remainder}§
    2361 \end{cfa}
    2362 It is now possible to match the multiple return-values to a single variable, in much the same way as \Index{aggregation}.
    2363 As well, the components of the tuple value are passed as separate parameters to ©printf©, allowing direct printing of tuple variables.
    2364 One way to access the individual components of a tuple variable is with assignment.
    2365 \begin{cfa}
    2366 [ quot, rem ] = qr;                                             §\C{// assign multiple variables}§
    2367 \end{cfa}
    2368 
     2373Multiple-return-value functions can equivalently be called \emph{tuple-returning functions}.
     2374
     2375\subsection{Tuple Variables}
     2376The call-site of the ©most_frequent© routine has a notable blemish, in that it required the preallocation of return variables in a manner similar to the aliasing example, since it is impossible to declare multiple variables of different types in the same declaration in standard C.
     2377In \CFA, it is possible to overcome this restriction by declaring a \emph{tuple variable}.
     2378\begin{cfa}[emph=ret, emphstyle=\color{red}]
     2379const char * str = "hello world";
     2380[int, char] ret = most_frequent(str);  // initialize tuple variable
     2381printf("%s -- %d %c\n", str, ret);
     2382\end{cfa}
     2383It is now possible to accept multiple values into a single piece of storage, in much the same way that it was previously possible to pass multiple values from one function call to another.
     2384These variables can be used in any of the contexts where a tuple expression is allowed, such as in the ©printf© function call.
     2385As in the ©process© example, the components of the tuple value are passed as separate parameters to ©printf©, allowing very simple printing of tuple expressions.
     2386One way to access the individual components is with a simple assignment, as in previous examples.
     2387\begin{cfa}
     2388int freq;
     2389char ch;
     2390[freq, ch] = ret;
     2391\end{cfa}
     2392
     2393\begin{sloppypar}
    23692394In addition to variables of tuple type, it is also possible to have pointers to tuples, and arrays of tuples.
    23702395Tuple types can be composed of any types, except for array types, since array assignment is disallowed, which makes tuple assignment difficult when a tuple contains an array.
    23712396\begin{cfa}
    2372 [ double, int ] di;
    2373 [ double, int ] * pdi
    2374 [ double, int ] adi[10];
     2397[double, int] di;
     2398[double, int] * pdi
     2399[double, int] adi[10];
    23752400\end{cfa}
    23762401This examples declares a variable of type ©[double, int]©, a variable of type pointer to ©[double, int]©, and an array of ten ©[double, int]©.
    2377 
    2378 
    2379 \subsection{Indexing}
    2380 
    2381 It is also possible to access a single component of a tuple-valued expression without creating temporary variables.
    2382 Given a tuple-valued expression $e$np and a compile-time constant integer $i$ where $0 \leq i < n$, where $n$ is the number of components in $e$, $e.i$ accesses the $i^{\:th}$ component of $e$, \eg:
     2402\end{sloppypar}
     2403
     2404\subsection{Tuple Indexing}
     2405
     2406At times, it is desirable to access a single component of a tuple-valued expression without creating unnecessary temporary variables to assign to.
     2407Given a tuple-valued expression ©e© and a compile-time constant integer $i$ where $0 \leq i < n$, where $n$ is the number of components in ©e©, ©e.i© accesses the $i$\textsuperscript{th} component of ©e©.
     2408For example,
    23832409\begin{cfa}
    23842410[int, double] x;
     
    23912417p->0 = 5;                                                               §\C{// access int component of tuple pointed-to by p}§
    23922418g( x.1, x.0 );                                                  §\C{// rearrange x to pass to g}§
    2393 double z = [ x, f() ].0.1;                              §\C{// access second component of first component of tuple expression}§
    2394 \end{cfa}
    2395 Tuple-index expressions can occur on any tuple-typed expression, including tuple-returning functions, square-bracketed tuple expressions, and other tuple-index expressions, provided the retrieved component is also a tuple.
     2419double z = [x, f()].0.1;                                §\C{// access second component of first component of tuple expression}§
     2420\end{cfa}
     2421As seen above, tuple-index expressions can occur on any tuple-typed expression, including tuple-returning functions, square-bracketed tuple expressions, and other tuple-index expressions, provided the retrieved component is also a tuple.
    23962422This feature was proposed for \KWC but never implemented \cite[p.~45]{Till89}.
    23972423
    2398 
    23992424\subsection{Flattening and Structuring}
    2400 
    24012425As evident in previous examples, tuples in \CFA do not have a rigid structure.
    24022426In function call contexts, tuples support implicit flattening and restructuring conversions.
     
    24412465There is only a single definition of ©f©, and 3 arguments with only single interpretations.
    24422466First, the argument alternative list ©[5, 10.2], 4© is flattened to produce the argument list ©5, 10.2, 4©.
    2443 Next, the parameter matching algorithm begins, with $P =$© int© and $A =$© int©, which unifies exactly.
    2444 Moving to the next parameter and argument, $P =$© [double, int]© and $A =$© double©.
    2445 This time, the parameter is a tuple type, so the algorithm applies recursively with $P' =$© double© and $A =$© double©, which unifies exactly.
    2446 Then $P' =$© int© and $A =$© double©, which again unifies exactly.
     2467Next, the parameter matching algorithm begins, with $P = $©int© and $A = $©int©, which unifies exactly.
     2468Moving to the next parameter and argument, $P = $©[double, int]© and $A = $©double©.
     2469This time, the parameter is a tuple type, so the algorithm applies recursively with $P' = $©double© and $A = $©double©, which unifies exactly.
     2470Then $P' = $©int© and $A = $©double©, which again unifies exactly.
    24472471At this point, the end of $P'$ has been reached, so the arguments ©10.2, 4© are structured into the tuple expression ©[10.2, 4]©.
    24482472Finally, the end of the parameter list $P$ has also been reached, so the final expression is ©f(5, [10.2, 4])©.
    24492473
    2450 
    2451 \subsection{Assignment}
     2474\section{Tuple Assignment}
    24522475\label{s:TupleAssignment}
    2453 
    2454 An assignment where the left side of the assignment operator has a tuple type is called \newterm{tuple assignment}.
    2455 There are two kinds of tuple assignment depending on whether the right side of the assignment operator has a non-tuple or tuple type, called \newterm[mass assignment]{mass} and \newterm[multiple assignment]{multiple} assignment, respectively.
     2476An assignment where the left side of the assignment operator has a tuple type is called tuple assignment.
     2477There are two kinds of tuple assignment depending on whether the right side of the assignment operator has a tuple type or a non-tuple type, called \emph{Multiple} and \emph{Mass} Assignment, respectively.
    24562478\begin{cfa}
    24572479int x;
    24582480double y;
    24592481[int, double] z;
    2460 [y, x] = 3.14;                                                  §\C{// mass assignment}§
    2461 [x, y] = z;                                                         §\C{// multiple assignment}§
    2462 z = 10;                                                         §\C{// mass assignment}§
    2463 z = [x, y];                                                             §\C{// multiple assignment}§
     2482[y, x] = 3.14;  // mass assignment
     2483[x, y] = z;     // multiple assignment
     2484z = 10;         // mass assignment
     2485z = [x, y];     // multiple assignment
    24642486\end{cfa}
    24652487Let $L_i$ for $i$ in $[0, n)$ represent each component of the flattened left side, $R_i$ represent each component of the flattened right side of a multiple assignment, and $R$ represent the right side of a mass assignment.
     
    24682490For example, the following is invalid because the number of components on the left does not match the number of components on the right.
    24692491\begin{cfa}
    2470 [ int, int ] x, y, z;
    2471 [ x, y ] = z;                                              §\C{// multiple assignment, invalid 4 != 2}§
     2492[int, int] x, y, z;
     2493[x, y] = z;   // multiple assignment, invalid 4 != 2
    24722494\end{cfa}
    24732495Multiple assignment assigns $R_i$ to $L_i$ for each $i$.
     
    24852507\begin{cfa}
    24862508int x = 10, y = 20;
    2487 [ x, y ] = [ y, x ];
     2509[x, y] = [y, x];
    24882510\end{cfa}
    24892511After executing this code, ©x© has the value ©20© and ©y© has the value ©10©.
     
    25042526        int a, b;
    25052527        double c, d;
    2506         [ void ] f( [ int, int ] );
    2507         f( [ c, a ] = [ b, d ] = 1.5 );  // assignments in parameter list
     2528        [void] f([int, int]);
     2529        f([c, a] = [b, d] = 1.5);  // assignments in parameter list
    25082530\end{cfa}
    25092531The tuple expression begins with a mass assignment of ©1.5© into ©[b, d]©, which assigns ©1.5© into ©b©, which is truncated to ©1©, and ©1.5© into ©d©, producing the tuple ©[1, 1.5]© as a result.
     
    25112533Finally, the tuple ©[1, 1]© is used as an expression in the call to ©f©.
    25122534
    2513 
    2514 \subsection{Construction}
    2515 
     2535\subsection{Tuple Construction}
    25162536Tuple construction and destruction follow the same rules and semantics as tuple assignment, except that in the case where there is no right side, the default constructor or destructor is called on each component of the tuple.
    25172537As constructors and destructors did not exist in previous versions of \CFA or in \KWC, this is a primary contribution of this thesis to the design of tuples.
     
    25492569The initialization of ©s© with ©t© works by default because ©t© is flattened into its components, which satisfies the generated field constructor ©?{}(S *, int, double)© to initialize the first two values.
    25502570
    2551 
    2552 \subsection{Member-Access Expression}
     2571\section{Member-Access Tuple Expression}
    25532572\label{s:MemberAccessTuple}
    2554 
    2555 Tuples may be used to select multiple fields of a record by field name.
     2573It is possible to access multiple fields from a single expression using a \emph{Member-Access Tuple Expression}.
    25562574The result is a single tuple-valued expression whose type is the tuple of the types of the members.
    25572575For example,
    25582576\begin{cfa}
    2559 struct S { char x; int y; double z; } s;
     2577struct S { int x; double y; char * z; } s;
    25602578s.[x, y, z];
    25612579\end{cfa}
    2562 Here, the type of ©s.[ x, y, z ]© is ©[ char, int, double ]©.
    2563 A member tuple expression has the form \emph{e}©.[x, y, z];© where \emph{e} is an expression with type ©T©, where ©T© supports member access expressions, and ©x, y, z© are all members of ©T© with types ©T$_x$©, ©T$_y$©, and ©T$_z$© respectively.
    2564 Then the type of \emph{e}©.[x, y, z]© is ©[T$_x$, T$_y$, T$_z$]©.
    2565 
    2566 A member-access tuple may be used anywhere a tuple can be used, \eg:
    2567 \begin{cfa}
    2568 s.[ y, z, x ] = [ 3, 3.2, 'x' ];                §\C{// equivalent to s.x = 'x', s.y = 3, s.z = 3.2}§
    2569 f( s.[ y, z ] );                                                §\C{// equivalent to f( s.y, s.z )}§
    2570 \end{cfa}
    2571 Note, the fields appearing in a record-field tuple may be specified in any order;
    2572 also, it is unnecessary to specify all the fields of a struct in a multiple record-field tuple.
    2573 
    2574 Since tuple-index expressions are a form of member-access expression, it is possible to use tuple-index expressions in conjunction with member-access expressions to restructure a tuple (\eg, rearrange components, drop components, duplicate components, etc.).
    2575 \begin{cfa}
    2576 [ int, int, long, double ] x;
    2577 void f( double, long );
    2578 
    2579 f( x.[ 0, 3 ] );                                                §\C{// f( x.0, x.3 )}§
    2580 x.[ 0, 1 ] = x.[ 1, 0 ];                                §\C{// [ x.0, x.1 ] = [ x.1, x.0 ]}§
    2581 [ long, int, long ] y = x.[ 2, 0, 2 ];
    2582 \end{cfa}
    2583 
    2584 It is possible for a member tuple expression to contain other member access expressions, \eg:
     2580Here, the type of ©s.[x, y, z]© is ©[int, double, char *]©.
     2581A member tuple expression has the form ©a.[x, y, z];© where ©a© is an expression with type ©T©, where ©T© supports member access expressions, and ©x, y, z© are all members of ©T© with types ©T$_x$©, ©T$_y$©, and ©T$_z$© respectively.
     2582Then the type of ©a.[x, y, z]© is ©[T_x, T_y, T_z]©.
     2583
     2584Since tuple index expressions are a form of member-access expression, it is possible to use tuple-index expressions in conjunction with member tuple expressions to manually restructure a tuple (\eg, rearrange components, drop components, duplicate components, etc.).
     2585\begin{cfa}
     2586[int, int, long, double] x;
     2587void f(double, long);
     2588
     2589f(x.[0, 3]);          // f(x.0, x.3)
     2590x.[0, 1] = x.[1, 0];  // [x.0, x.1] = [x.1, x.0]
     2591[long, int, long] y = x.[2, 0, 2];
     2592\end{cfa}
     2593
     2594It is possible for a member tuple expression to contain other member access expressions.
     2595For example,
    25852596\begin{cfa}
    25862597struct A { double i; int j; };
    25872598struct B { int * k; short l; };
    25882599struct C { int x; A y; B z; } v;
    2589 v.[ x, y.[ i, j ], z.k ];
    2590 \end{cfa}
    2591 This expression is equivalent to ©[ v.x, [ v.y.i, v.y.j ], v.z.k ]©.
    2592 That is, the aggregate expression is effectively distributed across the tuple allowing simple and easy access to multiple components in an aggregate without repetition.
     2600v.[x, y.[i, j], z.k];
     2601\end{cfa}
     2602This expression is equivalent to ©[v.x, [v.y.i, v.y.j], v.z.k]©.
     2603That is, the aggregate expression is effectively distributed across the tuple, which allows simple and easy access to multiple components in an aggregate, without repetition.
    25932604It is guaranteed that the aggregate expression to the left of the ©.© in a member tuple expression is evaluated exactly once.
    2594 As such, it is safe to use member tuple expressions on the result of a function with side-effects.
    2595 \begin{cfa}
    2596 [ int, float, double ] f();
    2597 [ double, float ] x = f().[ 2, 1 ];             §\C{// f() called once}§
     2605As such, it is safe to use member tuple expressions on the result of a side-effecting function.
     2606\begin{cfa}
     2607[int, float, double] f();
     2608[double, float] x = f().[2, 1];
    25982609\end{cfa}
    25992610
     
    26012612Since \CFA permits these tuple-access expressions using structures, unions, and tuples, \emph{member tuple expression} or \emph{field tuple expression} is more appropriate.
    26022613
    2603 
    2604 \subsection{Casting}
    2605 
     2614It is possible to extend member-access expressions further.
     2615Currently, a member-access expression whose member is a name requires that the aggregate is a structure or union, while a constant integer member requires the aggregate to be a tuple.
     2616In the interest of orthogonal design, \CFA could apply some meaning to the remaining combinations as well.
     2617For example,
     2618\begin{cfa}
     2619struct S { int x, y; } s;
     2620[S, S] z;
     2621
     2622s.x;  // access member
     2623z.0;  // access component
     2624
     2625s.1;  // ???
     2626z.y;  // ???
     2627\end{cfa}
     2628One possibility is for ©s.1© to select the second member of ©s©.
     2629Under this interpretation, it becomes possible to not only access members of a struct by name, but also by position.
     2630Likewise, it seems natural to open this mechanism to enumerations as well, wherein the left side would be a type, rather than an expression.
     2631One benefit of this interpretation is familiarity, since it is extremely reminiscent of tuple-index expressions.
     2632On the other hand, it could be argued that this interpretation is brittle in that changing the order of members or adding new members to a structure becomes a brittle operation.
     2633This problem is less of a concern with tuples, since modifying a tuple affects only the code that directly uses the tuple, whereas modifying a structure has far reaching consequences for every instance of the structure.
     2634
     2635As for ©z.y©, one interpretation is to extend the meaning of member tuple expressions.
     2636That is, currently the tuple must occur as the member, \ie to the right of the dot.
     2637Allowing tuples to the left of the dot could distribute the member across the elements of the tuple, in much the same way that member tuple expressions distribute the aggregate across the member tuple.
     2638In this example, ©z.y© expands to ©[z.0.y, z.1.y]©, allowing what is effectively a very limited compile-time field-sections map operation, where the argument must be a tuple containing only aggregates having a member named ©y©.
     2639It is questionable how useful this would actually be in practice, since structures often do not have names in common with other structures, and further this could cause maintainability issues in that it encourages programmers to adopt very simple naming conventions to maximize the amount of overlap between different types.
     2640Perhaps more useful would be to allow arrays on the left side of the dot, which would likewise allow mapping a field access across the entire array, producing an array of the contained fields.
     2641The immediate problem with this idea is that C arrays do not carry around their size, which would make it impossible to use this extension for anything other than a simple stack allocated array.
     2642
     2643Supposing this feature works as described, it would be necessary to specify an ordering for the expansion of member-access expressions versus member-tuple expressions.
     2644\begin{cfa}
     2645struct { int x, y; };
     2646[S, S] z;
     2647z.[x, y];  // ???
     2648// => [z.0, z.1].[x, y]
     2649// => [z.0.x, z.0.y, z.1.x, z.1.y]
     2650// or
     2651// => [z.x, z.y]
     2652// => [[z.0, z.1].x, [z.0, z.1].y]
     2653// => [z.0.x, z.1.x, z.0.y, z.1.y]
     2654\end{cfa}
     2655Depending on exactly how the two tuples are combined, different results can be achieved.
     2656As such, a specific ordering would need to be imposed to make this feature useful.
     2657Furthermore, this addition moves a member-tuple expression's meaning from being clear statically to needing resolver support, since the member name needs to be distributed appropriately over each member of the tuple, which could itself be a tuple.
     2658
     2659A second possibility is for \CFA to have named tuples, as they exist in Swift and D.
     2660\begin{cfa}
     2661typedef [int x, int y] Point2D;
     2662Point2D p1, p2;
     2663p1.x + p1.y + p2.x + p2.y;
     2664p1.0 + p1.1 + p2.0 + p2.1;  // equivalent
     2665\end{cfa}
     2666In this simpler interpretation, a tuple type carries with it a list of possibly empty identifiers.
     2667This approach fits naturally with the named return-value feature, and would likely go a long way towards implementing it.
     2668
     2669Ultimately, the first two extensions introduce complexity into the model, with relatively little perceived benefit, and so were dropped from consideration.
     2670Named tuples are a potentially useful addition to the language, provided they can be parsed with a reasonable syntax.
     2671
     2672
     2673\section{Casting}
    26062674In C, the cast operator is used to explicitly convert between types.
    26072675In \CFA, the cast operator has a secondary use, which is type ascription, since it forces the expression resolution algorithm to choose the lowest cost conversion to the target type.
     
    26572725That is, it is invalid to cast ©[int, int]© to ©[int, int, int]©.
    26582726
    2659 
    2660 \subsection{Polymorphism}
    2661 
     2727\section{Polymorphism}
    26622728Due to the implicit flattening and structuring conversions involved in argument passing, ©otype© and ©dtype© parameters are restricted to matching only with non-tuple types.
    26632729The integration of polymorphism, type assertions, and monomorphic specialization of tuple-assertions are a primary contribution of this thesis to the design of tuples.
     
    27122778Until this point, it has been assumed that assertion arguments must match the parameter type exactly, modulo polymorphic specialization (\ie, no implicit conversions are applied to assertion arguments).
    27132779This decision presents a conflict with the flexibility of tuples.
    2714 
    2715 
    2716 \subsubsection{Assertion Inference}
    2717 
     2780\subsection{Assertion Inference}
    27182781\begin{cfa}
    27192782int f([int, double], double);
     
    28392902Unfortunately, C's syntax for subscripts precluded treating them as tuples.
    28402903The C subscript list has the form ©[i][j]...© and not ©[i, j, ...]©.
    2841 Therefore, there is no syntactic way for a routine returning multiple values to specify the different subscript values, \eg ©f[ g() ]© always means a single subscript value because there is only one set of brackets.
     2904Therefore, there is no syntactic way for a routine returning multiple values to specify the different subscript values, \eg ©f[g()]© always means a single subscript value because there is only one set of brackets.
    28422905Fixing this requires a major change to C because the syntactic form ©M[i, j, k]© already has a particular meaning: ©i, j, k© is a comma expression.
    28432906\end{rationale}
     
    28882951
    28892952
    2890 \subsection{Mass Assignment}
     2953\section{Mass Assignment}
    28912954
    28922955\CFA permits assignment to several variables at once using mass assignment~\cite{CLU}.
     
    29282991
    29292992
    2930 \subsection{Multiple Assignment}
     2993\section{Multiple Assignment}
    29312994
    29322995\CFA also supports the assignment of several values at once, known as multiple assignment~\cite{CLU,Galletly96}.
     
    29693032
    29703033
    2971 \subsection{Cascade Assignment}
     3034\section{Cascade Assignment}
    29723035
    29733036As in C, \CFA mass and multiple assignments can be cascaded, producing cascade assignment.
     
    29853048\end{cfa}
    29863049As in C, the rightmost assignment is performed first, \ie assignment parses right to left.
     3050
     3051
     3052\section{Field Tuples}
     3053
     3054Tuples may be used to select multiple fields of a record by field name.
     3055Its general form is:
     3056\begin{cfa}
     3057§\emph{expr}§ . [ §\emph{fieldlist}§ ]
     3058§\emph{expr}§ -> [ §\emph{fieldlist}§ ]
     3059\end{cfa}
     3060\emph{expr} is any expression yielding a value of type record, \eg ©struct©, ©union©.
     3061Each element of \emph{ fieldlist} is an element of the record specified by \emph{expr}.
     3062A record-field tuple may be used anywhere a tuple can be used. An example of the use of a record-field tuple is
     3063the following:
     3064\begin{cfa}
     3065struct s {
     3066        int f1, f2;
     3067        char f3;
     3068        double f4;
     3069} v;
     3070v.[ f3, f1, f2 ] = ['x', 11, 17 ];      §\C{// equivalent to v.f3 = 'x', v.f1 = 11, v.f2 = 17}§
     3071f( v.[ f3, f1, f2 ] );                          §\C{// equivalent to f( v.f3, v.f1, v.f2 )}§
     3072\end{cfa}
     3073Note, the fields appearing in a record-field tuple may be specified in any order;
     3074also, it is unnecessary to specify all the fields of a struct in a multiple record-field tuple.
     3075
     3076If a field of a ©struct© is itself another ©struct©, multiple fields of this subrecord can be specified using a nested record-field tuple, as in the following example:
     3077\begin{cfa}
     3078struct inner {
     3079        int f2, f3;
     3080};
     3081struct outer {
     3082        int f1;
     3083        struct inner i;
     3084        double f4;
     3085} o;
     3086
     3087o.[ f1, i.[ f2, f3 ], f4 ] = [ 11, 12, 13, 3.14159 ];
     3088\end{cfa}
    29873089
    29883090
Note: See TracChangeset for help on using the changeset viewer.