File: Combination-allocation.html

package info (click to toggle)
gsl-ref-html 2.3-1
  • links: PTS
  • area: non-free
  • in suites: bullseye, buster, sid
  • size: 6,876 kB
  • ctags: 4,574
  • sloc: makefile: 35
file content (119 lines) | stat: -rw-r--r-- 6,098 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 The GSL Team.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with the
Invariant Sections being "GNU General Public License" and "Free Software
Needs Free Documentation", the Front-Cover text being "A GNU Manual",
and with the Back-Cover Text being (a) (see below). A copy of the
license is included in the section entitled "GNU Free Documentation
License".

(a) The Back-Cover Text is: "You have the freedom to copy and modify this
GNU Manual." -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Scientific Library &ndash; Reference Manual: Combination allocation</title>

<meta name="description" content="GNU Scientific Library &ndash; Reference Manual: Combination allocation">
<meta name="keywords" content="GNU Scientific Library &ndash; Reference Manual: Combination allocation">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Function-Index.html#Function-Index" rel="index" title="Function Index">
<link href="Combinations.html#Combinations" rel="up" title="Combinations">
<link href="Accessing-combination-elements.html#Accessing-combination-elements" rel="next" title="Accessing combination elements">
<link href="The-Combination-struct.html#The-Combination-struct" rel="previous" title="The Combination struct">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Combination-allocation"></a>
<div class="header">
<p>
Next: <a href="Accessing-combination-elements.html#Accessing-combination-elements" accesskey="n" rel="next">Accessing combination elements</a>, Previous: <a href="The-Combination-struct.html#The-Combination-struct" accesskey="p" rel="previous">The Combination struct</a>, Up: <a href="Combinations.html#Combinations" accesskey="u" rel="up">Combinations</a> &nbsp; [<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Combination-allocation-1"></a>
<h3 class="section">10.2 Combination allocation</h3>

<dl>
<dt><a name="index-gsl_005fcombination_005falloc"></a>Function: <em>gsl_combination *</em> <strong>gsl_combination_alloc</strong> <em>(size_t <var>n</var>, size_t <var>k</var>)</em></dt>
<dd><p>This function allocates memory for a new combination with parameters
<var>n</var>, <var>k</var>.  The combination is not initialized and its elements
are undefined.  Use the function <code>gsl_combination_calloc</code> if you
want to create a combination which is initialized to the
lexicographically first combination. A null pointer is returned if
insufficient memory is available to create the combination.
</p></dd></dl>

<dl>
<dt><a name="index-gsl_005fcombination_005fcalloc"></a>Function: <em>gsl_combination *</em> <strong>gsl_combination_calloc</strong> <em>(size_t <var>n</var>, size_t <var>k</var>)</em></dt>
<dd><p>This function allocates memory for a new combination with parameters
<var>n</var>, <var>k</var> and initializes it to the lexicographically first
combination. A null pointer is returned if insufficient memory is
available to create the combination.
</p></dd></dl>

<dl>
<dt><a name="index-gsl_005fcombination_005finit_005ffirst"></a>Function: <em>void</em> <strong>gsl_combination_init_first</strong> <em>(gsl_combination * <var>c</var>)</em></dt>
<dd><p>This function initializes the combination <var>c</var> to the
lexicographically first combination, i.e.  <em>(0,1,2,&hellip;,k-1)</em>.
</p></dd></dl>

<dl>
<dt><a name="index-gsl_005fcombination_005finit_005flast"></a>Function: <em>void</em> <strong>gsl_combination_init_last</strong> <em>(gsl_combination * <var>c</var>)</em></dt>
<dd><p>This function initializes the combination <var>c</var> to the
lexicographically last combination, i.e.  <em>(n-k,n-k+1,&hellip;,n-1)</em>.
</p></dd></dl>

<dl>
<dt><a name="index-gsl_005fcombination_005ffree"></a>Function: <em>void</em> <strong>gsl_combination_free</strong> <em>(gsl_combination * <var>c</var>)</em></dt>
<dd><p>This function frees all the memory used by the combination <var>c</var>.
</p></dd></dl>

<dl>
<dt><a name="index-gsl_005fcombination_005fmemcpy"></a>Function: <em>int</em> <strong>gsl_combination_memcpy</strong> <em>(gsl_combination * <var>dest</var>, const gsl_combination * <var>src</var>)</em></dt>
<dd><p>This function copies the elements of the combination <var>src</var> into the
combination <var>dest</var>.  The two combinations must have the same size.
</p></dd></dl>





</body>
</html>