From c5d45d6f15e206ac1d1b8e9be4350e35f9fe05db Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Tue, 28 May 2013 18:02:06 -0700 Subject: [PATCH 01/39] Create gh-pages branch via GitHub --- index.html | 71 ++++++++++ javascripts/scale.fix.js | 17 +++ params.json | 1 + stylesheets/pygment_trac.css | 69 ++++++++++ stylesheets/styles.css | 255 +++++++++++++++++++++++++++++++++++ 5 files changed, 413 insertions(+) create mode 100644 index.html create mode 100644 javascripts/scale.fix.js create mode 100644 params.json create mode 100644 stylesheets/pygment_trac.css create mode 100644 stylesheets/styles.css diff --git a/index.html b/index.html new file mode 100644 index 0000000..50740b8 --- /dev/null +++ b/index.html @@ -0,0 +1,71 @@ + + + + + + Objectlayout by ObjectLayout + + + + + + + +
+
+

Objectlayout

+

Java classes designed with optimizable object layout in mind

+ +

View the Project on GitHub ObjectLayout/ObjectLayout

+ + + +
+
+

+Welcome to GitHub Pages.

+ +

This automatic page generator is the easiest way to create beautiful pages for all of your projects. Author your page content here using GitHub Flavored Markdown, select a template crafted by a designer, and publish. After your page is generated, you can check out the new branch:

+ +
$ cd your_repo_root/repo_name
+$ git fetch origin
+$ git checkout gh-pages
+
+ +

If you're using the GitHub for Mac, simply sync your repository and you'll see the new branch.

+ +

+Designer Templates

+ +

We've crafted some handsome templates for you to use. Go ahead and continue to layouts to browse through them. You can easily go back to edit your page before publishing. After publishing your page, you can revisit the page generator and switch to another theme. Your Page content will be preserved if it remained markdown format.

+ +

+Rather Drive Stick?

+ +

If you prefer to not use the automatic generator, push a branch named gh-pages to your repository to create a page manually. In addition to supporting regular HTML content, GitHub Pages support Jekyll, a simple, blog aware static site generator written by our own Tom Preston-Werner. Jekyll makes it easy to create site-wide headers and footers without having to copy them across every page. It also offers intelligent blog support and other advanced templating features.

+ +

+Authors and Contributors

+ +

You can @mention a GitHub username to generate a link to their profile. The resulting <a> element will link to the contributor's GitHub Profile. For example: In 2007, Chris Wanstrath (@defunkt), PJ Hyett (@pjhyett), and Tom Preston-Werner (@mojombo) founded GitHub.

+ +

+Support or Contact

+ +

Having trouble with Pages? Check out the documentation at http://help.github.com/pages or contact support@github.com and we’ll help you sort it out.

+
+ +
+ + + + \ No newline at end of file diff --git a/javascripts/scale.fix.js b/javascripts/scale.fix.js new file mode 100644 index 0000000..87a40ca --- /dev/null +++ b/javascripts/scale.fix.js @@ -0,0 +1,17 @@ +var metas = document.getElementsByTagName('meta'); +var i; +if (navigator.userAgent.match(/iPhone/i)) { + for (i=0; i` element will link to the contributor's GitHub Profile. For example: In 2007, Chris Wanstrath (@defunkt), PJ Hyett (@pjhyett), and Tom Preston-Werner (@mojombo) founded GitHub.\r\n\r\n### Support or Contact\r\nHaving trouble with Pages? Check out the documentation at http://help.github.com/pages or contact support@github.com and we’ll help you sort it out.","google":"","note":"Don't delete this file! It's used internally to help with page regeneration."} \ No newline at end of file diff --git a/stylesheets/pygment_trac.css b/stylesheets/pygment_trac.css new file mode 100644 index 0000000..c6a6452 --- /dev/null +++ b/stylesheets/pygment_trac.css @@ -0,0 +1,69 @@ +.highlight { background: #ffffff; } +.highlight .c { color: #999988; font-style: italic } /* Comment */ +.highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */ +.highlight .k { font-weight: bold } /* Keyword */ +.highlight .o { font-weight: bold } /* Operator */ +.highlight .cm { color: #999988; font-style: italic } /* Comment.Multiline */ +.highlight .cp { color: #999999; font-weight: bold } /* Comment.Preproc */ +.highlight .c1 { color: #999988; font-style: italic } /* Comment.Single */ +.highlight .cs { color: #999999; font-weight: bold; font-style: italic } /* Comment.Special */ +.highlight .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */ +.highlight .gd .x { color: #000000; background-color: #ffaaaa } /* Generic.Deleted.Specific */ +.highlight .ge { font-style: italic } /* Generic.Emph */ +.highlight .gr { color: #aa0000 } /* Generic.Error */ +.highlight .gh { color: #999999 } /* Generic.Heading */ +.highlight .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */ +.highlight .gi .x { color: #000000; background-color: #aaffaa } /* Generic.Inserted.Specific */ +.highlight .go { color: #888888 } /* Generic.Output */ +.highlight .gp { color: #555555 } /* Generic.Prompt */ +.highlight .gs { font-weight: bold } /* Generic.Strong */ +.highlight .gu { color: #800080; font-weight: bold; } /* Generic.Subheading */ +.highlight .gt { color: #aa0000 } /* Generic.Traceback */ +.highlight .kc { font-weight: bold } /* Keyword.Constant */ +.highlight .kd { font-weight: bold } /* Keyword.Declaration */ +.highlight .kn { font-weight: bold } /* Keyword.Namespace */ +.highlight .kp { font-weight: bold } /* Keyword.Pseudo */ +.highlight .kr { font-weight: bold } /* Keyword.Reserved */ +.highlight .kt { color: #445588; font-weight: bold } /* Keyword.Type */ +.highlight .m { color: #009999 } /* Literal.Number */ +.highlight .s { color: #d14 } /* Literal.String */ +.highlight .na { color: #008080 } /* Name.Attribute */ +.highlight .nb { color: #0086B3 } /* Name.Builtin */ +.highlight .nc { color: #445588; font-weight: bold } /* Name.Class */ +.highlight .no { color: #008080 } /* Name.Constant */ +.highlight .ni { color: #800080 } /* Name.Entity */ +.highlight .ne { color: #990000; font-weight: bold } /* Name.Exception */ +.highlight .nf { color: #990000; font-weight: bold } /* Name.Function */ +.highlight .nn { color: #555555 } /* Name.Namespace */ +.highlight .nt { color: #000080 } /* Name.Tag */ +.highlight .nv { color: #008080 } /* Name.Variable */ +.highlight .ow { font-weight: bold } /* Operator.Word */ +.highlight .w { color: #bbbbbb } /* Text.Whitespace */ +.highlight .mf { color: #009999 } /* Literal.Number.Float */ +.highlight .mh { color: #009999 } /* Literal.Number.Hex */ +.highlight .mi { color: #009999 } /* Literal.Number.Integer */ +.highlight .mo { color: #009999 } /* Literal.Number.Oct */ +.highlight .sb { color: #d14 } /* Literal.String.Backtick */ +.highlight .sc { color: #d14 } /* Literal.String.Char */ +.highlight .sd { color: #d14 } /* Literal.String.Doc */ +.highlight .s2 { color: #d14 } /* Literal.String.Double */ +.highlight .se { color: #d14 } /* Literal.String.Escape */ +.highlight .sh { color: #d14 } /* Literal.String.Heredoc */ +.highlight .si { color: #d14 } /* Literal.String.Interpol */ +.highlight .sx { color: #d14 } /* Literal.String.Other */ +.highlight .sr { color: #009926 } /* Literal.String.Regex */ +.highlight .s1 { color: #d14 } /* Literal.String.Single */ +.highlight .ss { color: #990073 } /* Literal.String.Symbol */ +.highlight .bp { color: #999999 } /* Name.Builtin.Pseudo */ +.highlight .vc { color: #008080 } /* Name.Variable.Class */ +.highlight .vg { color: #008080 } /* Name.Variable.Global */ +.highlight .vi { color: #008080 } /* Name.Variable.Instance */ +.highlight .il { color: #009999 } /* Literal.Number.Integer.Long */ + +.type-csharp .highlight .k { color: #0000FF } +.type-csharp .highlight .kt { color: #0000FF } +.type-csharp .highlight .nf { color: #000000; font-weight: normal } +.type-csharp .highlight .nc { color: #2B91AF } +.type-csharp .highlight .nn { color: #000000 } +.type-csharp .highlight .s { color: #A31515 } +.type-csharp .highlight .sc { color: #A31515 } diff --git a/stylesheets/styles.css b/stylesheets/styles.css new file mode 100644 index 0000000..dacf2e1 --- /dev/null +++ b/stylesheets/styles.css @@ -0,0 +1,255 @@ +@import url(https://fonts.googleapis.com/css?family=Lato:300italic,700italic,300,700); + +body { + padding:50px; + font:14px/1.5 Lato, "Helvetica Neue", Helvetica, Arial, sans-serif; + color:#777; + font-weight:300; +} + +h1, h2, h3, h4, h5, h6 { + color:#222; + margin:0 0 20px; +} + +p, ul, ol, table, pre, dl { + margin:0 0 20px; +} + +h1, h2, h3 { + line-height:1.1; +} + +h1 { + font-size:28px; +} + +h2 { + color:#393939; +} + +h3, h4, h5, h6 { + color:#494949; +} + +a { + color:#39c; + font-weight:400; + text-decoration:none; +} + +a small { + font-size:11px; + color:#777; + margin-top:-0.6em; + display:block; +} + +.wrapper { + width:860px; + margin:0 auto; +} + +blockquote { + border-left:1px solid #e5e5e5; + margin:0; + padding:0 0 0 20px; + font-style:italic; +} + +code, pre { + font-family:Monaco, Bitstream Vera Sans Mono, Lucida Console, Terminal; + color:#333; + font-size:12px; +} + +pre { + padding:8px 15px; + background: #f8f8f8; + border-radius:5px; + border:1px solid #e5e5e5; + overflow-x: auto; +} + +table { + width:100%; + border-collapse:collapse; +} + +th, td { + text-align:left; + padding:5px 10px; + border-bottom:1px solid #e5e5e5; +} + +dt { + color:#444; + font-weight:700; +} + +th { + color:#444; +} + +img { + max-width:100%; +} + +header { + width:270px; + float:left; + position:fixed; +} + +header ul { + list-style:none; + height:40px; + + padding:0; + + background: #eee; + background: -moz-linear-gradient(top, #f8f8f8 0%, #dddddd 100%); + background: -webkit-gradient(linear, left top, left bottom, color-stop(0%,#f8f8f8), color-stop(100%,#dddddd)); + background: -webkit-linear-gradient(top, #f8f8f8 0%,#dddddd 100%); + background: -o-linear-gradient(top, #f8f8f8 0%,#dddddd 100%); + background: -ms-linear-gradient(top, #f8f8f8 0%,#dddddd 100%); + background: linear-gradient(top, #f8f8f8 0%,#dddddd 100%); + + border-radius:5px; + border:1px solid #d2d2d2; + box-shadow:inset #fff 0 1px 0, inset rgba(0,0,0,0.03) 0 -1px 0; + width:270px; +} + +header li { + width:89px; + float:left; + border-right:1px solid #d2d2d2; + height:40px; +} + +header ul a { + line-height:1; + font-size:11px; + color:#999; + display:block; + text-align:center; + padding-top:6px; + height:40px; +} + +strong { + color:#222; + font-weight:700; +} + +header ul li + li { + width:88px; + border-left:1px solid #fff; +} + +header ul li + li + li { + border-right:none; + width:89px; +} + +header ul a strong { + font-size:14px; + display:block; + color:#222; +} + +section { + width:500px; + float:right; + padding-bottom:50px; +} + +small { + font-size:11px; +} + +hr { + border:0; + background:#e5e5e5; + height:1px; + margin:0 0 20px; +} + +footer { + width:270px; + float:left; + position:fixed; + bottom:50px; +} + +@media print, screen and (max-width: 960px) { + + div.wrapper { + width:auto; + margin:0; + } + + header, section, footer { + float:none; + position:static; + width:auto; + } + + header { + padding-right:320px; + } + + section { + border:1px solid #e5e5e5; + border-width:1px 0; + padding:20px 0; + margin:0 0 20px; + } + + header a small { + display:inline; + } + + header ul { + position:absolute; + right:50px; + top:52px; + } +} + +@media print, screen and (max-width: 720px) { + body { + word-wrap:break-word; + } + + header { + padding:0; + } + + header ul, header p.view { + position:static; + } + + pre, code { + word-wrap:normal; + } +} + +@media print, screen and (max-width: 480px) { + body { + padding:15px; + } + + header ul { + display:none; + } +} + +@media print { + body { + padding:0.4in; + font-size:12pt; + color:#444; + } +} From 3cfe9e3872f50bc0f08e70df7f7ad4bd93d8c39a Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Tue, 28 May 2013 18:14:26 -0700 Subject: [PATCH 02/39] First pages commit --- index.html | 1 + 1 file changed, 1 insertion(+) create mode 100644 index.html diff --git a/index.html b/index.html new file mode 100644 index 0000000..03f9801 --- /dev/null +++ b/index.html @@ -0,0 +1 @@ +My GitHub Page From d2a2c976c68bbb0078f4dfb4100efbfeda6bd635 Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Tue, 28 May 2013 22:18:23 -0700 Subject: [PATCH 03/39] Updated JavaDoc --- JavaDoc/allclasses-frame.html | 2 +- JavaDoc/allclasses-noframe.html | 2 +- JavaDoc/constant-values.html | 2 +- JavaDoc/deprecated-list.html | 2 +- JavaDoc/help-doc.html | 2 +- JavaDoc/index-files/index-1.html | 2 +- JavaDoc/index-files/index-2.html | 2 +- JavaDoc/index-files/index-3.html | 2 +- JavaDoc/index-files/index-4.html | 2 +- JavaDoc/index-files/index-5.html | 2 +- JavaDoc/index-files/index-6.html | 2 +- JavaDoc/index-files/index-7.html | 4 +-- JavaDoc/index-files/index-8.html | 2 +- JavaDoc/index-files/index-9.html | 2 +- JavaDoc/index.html | 2 +- .../org/ObjectLayout/ConstructorAndArgs.html | 2 +- .../ElementConstructorGenerator.html | 2 +- .../ElementCopyConstructorGenerator.html | 2 +- .../ElementFixedConstructorGenerator.html | 2 +- .../StructuredArray.StructureIterator.html | 2 +- JavaDoc/org/ObjectLayout/StructuredArray.html | 5 ++-- JavaDoc/org/ObjectLayout/package-frame.html | 2 +- JavaDoc/org/ObjectLayout/package-summary.html | 28 ++++++++++++++++++- JavaDoc/org/ObjectLayout/package-tree.html | 2 +- JavaDoc/overview-tree.html | 2 +- 25 files changed, 54 insertions(+), 27 deletions(-) diff --git a/JavaDoc/allclasses-frame.html b/JavaDoc/allclasses-frame.html index 4b85935..33f5d01 100644 --- a/JavaDoc/allclasses-frame.html +++ b/JavaDoc/allclasses-frame.html @@ -2,7 +2,7 @@ - + All Classes diff --git a/JavaDoc/allclasses-noframe.html b/JavaDoc/allclasses-noframe.html index b434bec..7db12d4 100644 --- a/JavaDoc/allclasses-noframe.html +++ b/JavaDoc/allclasses-noframe.html @@ -2,7 +2,7 @@ - + All Classes diff --git a/JavaDoc/constant-values.html b/JavaDoc/constant-values.html index 73010b6..e64806f 100644 --- a/JavaDoc/constant-values.html +++ b/JavaDoc/constant-values.html @@ -2,7 +2,7 @@ - + Constant Field Values diff --git a/JavaDoc/deprecated-list.html b/JavaDoc/deprecated-list.html index 611f220..9ddb60c 100644 --- a/JavaDoc/deprecated-list.html +++ b/JavaDoc/deprecated-list.html @@ -2,7 +2,7 @@ - + Deprecated List diff --git a/JavaDoc/help-doc.html b/JavaDoc/help-doc.html index 9abce44..4424818 100644 --- a/JavaDoc/help-doc.html +++ b/JavaDoc/help-doc.html @@ -2,7 +2,7 @@ - + API Help diff --git a/JavaDoc/index-files/index-1.html b/JavaDoc/index-files/index-1.html index 0ff3292..46fcb7f 100644 --- a/JavaDoc/index-files/index-1.html +++ b/JavaDoc/index-files/index-1.html @@ -2,7 +2,7 @@ - + C-Index diff --git a/JavaDoc/index-files/index-2.html b/JavaDoc/index-files/index-2.html index a7eab10..0793bad 100644 --- a/JavaDoc/index-files/index-2.html +++ b/JavaDoc/index-files/index-2.html @@ -2,7 +2,7 @@ - + E-Index diff --git a/JavaDoc/index-files/index-3.html b/JavaDoc/index-files/index-3.html index 6983a5f..c901f7f 100644 --- a/JavaDoc/index-files/index-3.html +++ b/JavaDoc/index-files/index-3.html @@ -2,7 +2,7 @@ - + G-Index diff --git a/JavaDoc/index-files/index-4.html b/JavaDoc/index-files/index-4.html index 412b5a8..bd6f8ae 100644 --- a/JavaDoc/index-files/index-4.html +++ b/JavaDoc/index-files/index-4.html @@ -2,7 +2,7 @@ - + H-Index diff --git a/JavaDoc/index-files/index-5.html b/JavaDoc/index-files/index-5.html index c9ec9ef..85b3d51 100644 --- a/JavaDoc/index-files/index-5.html +++ b/JavaDoc/index-files/index-5.html @@ -2,7 +2,7 @@ - + I-Index diff --git a/JavaDoc/index-files/index-6.html b/JavaDoc/index-files/index-6.html index 74ecd0d..9fe1c2d 100644 --- a/JavaDoc/index-files/index-6.html +++ b/JavaDoc/index-files/index-6.html @@ -2,7 +2,7 @@ - + N-Index diff --git a/JavaDoc/index-files/index-7.html b/JavaDoc/index-files/index-7.html index daaf649..dcbae4a 100644 --- a/JavaDoc/index-files/index-7.html +++ b/JavaDoc/index-files/index-7.html @@ -2,7 +2,7 @@ - + O-Index @@ -80,7 +80,7 @@

O

-
org.ObjectLayout - package org.ObjectLayout
 
+
org.ObjectLayout - package org.ObjectLayout
ObjectLayout: An optimised memory layout package.
diff --git a/JavaDoc/index-files/index-8.html b/JavaDoc/index-files/index-8.html index 9d93440..0b49143 100644 --- a/JavaDoc/index-files/index-8.html +++ b/JavaDoc/index-files/index-8.html @@ -2,7 +2,7 @@ - + R-Index diff --git a/JavaDoc/index-files/index-9.html b/JavaDoc/index-files/index-9.html index dd43446..b4a4cc6 100644 --- a/JavaDoc/index-files/index-9.html +++ b/JavaDoc/index-files/index-9.html @@ -2,7 +2,7 @@ - + S-Index diff --git a/JavaDoc/index.html b/JavaDoc/index.html index c14e634..c25c727 100644 --- a/JavaDoc/index.html +++ b/JavaDoc/index.html @@ -2,7 +2,7 @@ - + Generated Documentation (Untitled) diff --git a/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html b/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html index ce7f030..dcf389e 100644 --- a/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html +++ b/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html @@ -2,7 +2,7 @@ - + ConstructorAndArgs diff --git a/JavaDoc/org/ObjectLayout/ElementConstructorGenerator.html b/JavaDoc/org/ObjectLayout/ElementConstructorGenerator.html index 10961c3..cf7e351 100644 --- a/JavaDoc/org/ObjectLayout/ElementConstructorGenerator.html +++ b/JavaDoc/org/ObjectLayout/ElementConstructorGenerator.html @@ -2,7 +2,7 @@ - + ElementConstructorGenerator diff --git a/JavaDoc/org/ObjectLayout/ElementCopyConstructorGenerator.html b/JavaDoc/org/ObjectLayout/ElementCopyConstructorGenerator.html index c8bd5c8..c98a641 100644 --- a/JavaDoc/org/ObjectLayout/ElementCopyConstructorGenerator.html +++ b/JavaDoc/org/ObjectLayout/ElementCopyConstructorGenerator.html @@ -2,7 +2,7 @@ - + ElementCopyConstructorGenerator diff --git a/JavaDoc/org/ObjectLayout/ElementFixedConstructorGenerator.html b/JavaDoc/org/ObjectLayout/ElementFixedConstructorGenerator.html index 8c2be3b..ef41724 100644 --- a/JavaDoc/org/ObjectLayout/ElementFixedConstructorGenerator.html +++ b/JavaDoc/org/ObjectLayout/ElementFixedConstructorGenerator.html @@ -2,7 +2,7 @@ - + ElementFixedConstructorGenerator diff --git a/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html b/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html index febf09e..a9bb328 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html +++ b/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html @@ -2,7 +2,7 @@ - + StructuredArray.StructureIterator diff --git a/JavaDoc/org/ObjectLayout/StructuredArray.html b/JavaDoc/org/ObjectLayout/StructuredArray.html index a4d09ee..8d4cea1 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArray.html +++ b/JavaDoc/org/ObjectLayout/StructuredArray.html @@ -2,7 +2,7 @@ - + StructuredArray @@ -361,7 +361,8 @@

 public static <T> StructuredArray<T> newInstance(long length,
                                                  java.lang.Class<T> elementClass,
-                                                 ElementConstructorGenerator<T> constructorGenerator)
+ ElementConstructorGenerator<T> constructorGenerator) + throws java.lang.NoSuchMethodException
Create an array of length elements, each containing an element object of type elementClass. Use constructor and arguments supplied (on a potentially diff --git a/JavaDoc/org/ObjectLayout/package-frame.html b/JavaDoc/org/ObjectLayout/package-frame.html index f92b895..875e346 100644 --- a/JavaDoc/org/ObjectLayout/package-frame.html +++ b/JavaDoc/org/ObjectLayout/package-frame.html @@ -2,7 +2,7 @@ - + org.ObjectLayout diff --git a/JavaDoc/org/ObjectLayout/package-summary.html b/JavaDoc/org/ObjectLayout/package-summary.html index aee11e6..0399e02 100644 --- a/JavaDoc/org/ObjectLayout/package-summary.html +++ b/JavaDoc/org/ObjectLayout/package-summary.html @@ -2,7 +2,7 @@ - + org.ObjectLayout @@ -80,6 +80,12 @@

Package org.ObjectLayout

+ObjectLayout: An optimised memory layout package. +

+See: +
+          Description +

@@ -117,6 +123,26 @@

  +

+

+Package org.ObjectLayout Description +

+ +

+

ObjectLayout: An optimised memory layout package.

+

+ The ObjectLayout package provides some core classes designed with optimised memory layout in mind. + The package classes provide full functionality on all JVMs (of Java SE 5 or above) at reasonable layouts + and execution speeds. However, the classes are carefully designed with semantics that would allow an + optimised JVM to implement them with improved memory layout not directly expressible in Java. +

+ The StructuredArray class is a good example of this design pattern. StructuredArray is carefully designed + to allow a JVM to store it in memory with a layout similar to an array of structs in C-like languages. + When a JVM optimises StructuredArray in such a way, array access benefits from both direct (as opposed + to de-referenced) dead-reckoning index access, as well as from fixed memory strides during streaming + operations. +

+

diff --git a/JavaDoc/org/ObjectLayout/package-tree.html b/JavaDoc/org/ObjectLayout/package-tree.html index 4774ccf..f64c65d 100644 --- a/JavaDoc/org/ObjectLayout/package-tree.html +++ b/JavaDoc/org/ObjectLayout/package-tree.html @@ -2,7 +2,7 @@ - + org.ObjectLayout Class Hierarchy diff --git a/JavaDoc/overview-tree.html b/JavaDoc/overview-tree.html index 834ffd4..04a5b93 100644 --- a/JavaDoc/overview-tree.html +++ b/JavaDoc/overview-tree.html @@ -2,7 +2,7 @@ - + Class Hierarchy From 1d0f261d24261188dc83c1475c34c296d2e5b06c Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Tue, 28 May 2013 22:26:02 -0700 Subject: [PATCH 04/39] Updated --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 9403f83..f89872b 100644 --- a/index.html +++ b/index.html @@ -16,7 +16,7 @@

ObjectLayout

-

A High Dynamic Range (HDR) Histogram

+

An optimised memory layout package

View the Project on GitHub ObjectLayout/ObjectLayout

From 048a089709f6d4ed0446ec7950d7ba8eb3e75e91 Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Tue, 28 May 2013 22:50:54 -0700 Subject: [PATCH 05/39] Updated JavaDoc --- JavaDoc/allclasses-frame.html | 2 +- JavaDoc/allclasses-noframe.html | 2 +- JavaDoc/constant-values.html | 2 +- JavaDoc/deprecated-list.html | 2 +- JavaDoc/help-doc.html | 2 +- JavaDoc/index-files/index-1.html | 2 +- JavaDoc/index-files/index-2.html | 2 +- JavaDoc/index-files/index-3.html | 2 +- JavaDoc/index-files/index-4.html | 2 +- JavaDoc/index-files/index-5.html | 2 +- JavaDoc/index-files/index-6.html | 2 +- JavaDoc/index-files/index-7.html | 2 +- JavaDoc/index-files/index-8.html | 2 +- JavaDoc/index-files/index-9.html | 4 ++-- JavaDoc/index.html | 2 +- JavaDoc/org/ObjectLayout/ConstructorAndArgs.html | 2 +- JavaDoc/org/ObjectLayout/ElementConstructorGenerator.html | 2 +- JavaDoc/org/ObjectLayout/ElementCopyConstructorGenerator.html | 2 +- .../org/ObjectLayout/ElementFixedConstructorGenerator.html | 2 +- .../org/ObjectLayout/StructuredArray.StructureIterator.html | 2 +- JavaDoc/org/ObjectLayout/StructuredArray.html | 4 ++-- JavaDoc/org/ObjectLayout/package-frame.html | 2 +- JavaDoc/org/ObjectLayout/package-summary.html | 4 ++-- JavaDoc/org/ObjectLayout/package-tree.html | 2 +- JavaDoc/overview-tree.html | 2 +- 25 files changed, 28 insertions(+), 28 deletions(-) diff --git a/JavaDoc/allclasses-frame.html b/JavaDoc/allclasses-frame.html index 33f5d01..a0fa00a 100644 --- a/JavaDoc/allclasses-frame.html +++ b/JavaDoc/allclasses-frame.html @@ -2,7 +2,7 @@ - + All Classes diff --git a/JavaDoc/allclasses-noframe.html b/JavaDoc/allclasses-noframe.html index 7db12d4..c2d52e6 100644 --- a/JavaDoc/allclasses-noframe.html +++ b/JavaDoc/allclasses-noframe.html @@ -2,7 +2,7 @@ - + All Classes diff --git a/JavaDoc/constant-values.html b/JavaDoc/constant-values.html index e64806f..cab37db 100644 --- a/JavaDoc/constant-values.html +++ b/JavaDoc/constant-values.html @@ -2,7 +2,7 @@ - + Constant Field Values diff --git a/JavaDoc/deprecated-list.html b/JavaDoc/deprecated-list.html index 9ddb60c..6b715b3 100644 --- a/JavaDoc/deprecated-list.html +++ b/JavaDoc/deprecated-list.html @@ -2,7 +2,7 @@ - + Deprecated List diff --git a/JavaDoc/help-doc.html b/JavaDoc/help-doc.html index 4424818..f3745ae 100644 --- a/JavaDoc/help-doc.html +++ b/JavaDoc/help-doc.html @@ -2,7 +2,7 @@ - + API Help diff --git a/JavaDoc/index-files/index-1.html b/JavaDoc/index-files/index-1.html index 46fcb7f..2ba5591 100644 --- a/JavaDoc/index-files/index-1.html +++ b/JavaDoc/index-files/index-1.html @@ -2,7 +2,7 @@ - + C-Index diff --git a/JavaDoc/index-files/index-2.html b/JavaDoc/index-files/index-2.html index 0793bad..8ca8ccd 100644 --- a/JavaDoc/index-files/index-2.html +++ b/JavaDoc/index-files/index-2.html @@ -2,7 +2,7 @@ - + E-Index diff --git a/JavaDoc/index-files/index-3.html b/JavaDoc/index-files/index-3.html index c901f7f..22da494 100644 --- a/JavaDoc/index-files/index-3.html +++ b/JavaDoc/index-files/index-3.html @@ -2,7 +2,7 @@ - + G-Index diff --git a/JavaDoc/index-files/index-4.html b/JavaDoc/index-files/index-4.html index bd6f8ae..7ad14f4 100644 --- a/JavaDoc/index-files/index-4.html +++ b/JavaDoc/index-files/index-4.html @@ -2,7 +2,7 @@ - + H-Index diff --git a/JavaDoc/index-files/index-5.html b/JavaDoc/index-files/index-5.html index 85b3d51..b9df3f0 100644 --- a/JavaDoc/index-files/index-5.html +++ b/JavaDoc/index-files/index-5.html @@ -2,7 +2,7 @@ - + I-Index diff --git a/JavaDoc/index-files/index-6.html b/JavaDoc/index-files/index-6.html index 9fe1c2d..69f1442 100644 --- a/JavaDoc/index-files/index-6.html +++ b/JavaDoc/index-files/index-6.html @@ -2,7 +2,7 @@ - + N-Index diff --git a/JavaDoc/index-files/index-7.html b/JavaDoc/index-files/index-7.html index dcbae4a..8931a7b 100644 --- a/JavaDoc/index-files/index-7.html +++ b/JavaDoc/index-files/index-7.html @@ -2,7 +2,7 @@ - + O-Index diff --git a/JavaDoc/index-files/index-8.html b/JavaDoc/index-files/index-8.html index 0b49143..c0b2422 100644 --- a/JavaDoc/index-files/index-8.html +++ b/JavaDoc/index-files/index-8.html @@ -2,7 +2,7 @@ - + R-Index diff --git a/JavaDoc/index-files/index-9.html b/JavaDoc/index-files/index-9.html index b4a4cc6..be56704 100644 --- a/JavaDoc/index-files/index-9.html +++ b/JavaDoc/index-files/index-9.html @@ -2,7 +2,7 @@ - + S-Index @@ -93,7 +93,7 @@ Static method in class org.ObjectLayout.StructuredArray
Shallow copy a region of element object contents from one array to the other
StructuredArray<T> - Class in org.ObjectLayout
- An immutable array of (potentially) mutable objects.
StructuredArray.StructureIterator - Class in org.ObjectLayout
Specialised Iterator with the ability to be reset() enabling reuse.
StructuredArray.StructureIterator() - + An array of (potentially) mutable but non-replaceable objects.
StructuredArray.StructureIterator - Class in org.ObjectLayout
Specialised Iterator with the ability to be reset() enabling reuse.
StructuredArray.StructureIterator() - Constructor for class org.ObjectLayout.StructuredArray.StructureIterator
 
diff --git a/JavaDoc/index.html b/JavaDoc/index.html index c25c727..83c1db2 100644 --- a/JavaDoc/index.html +++ b/JavaDoc/index.html @@ -2,7 +2,7 @@ - + Generated Documentation (Untitled) diff --git a/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html b/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html index dcf389e..023d195 100644 --- a/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html +++ b/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html @@ -2,7 +2,7 @@ - + ConstructorAndArgs diff --git a/JavaDoc/org/ObjectLayout/ElementConstructorGenerator.html b/JavaDoc/org/ObjectLayout/ElementConstructorGenerator.html index cf7e351..be826c8 100644 --- a/JavaDoc/org/ObjectLayout/ElementConstructorGenerator.html +++ b/JavaDoc/org/ObjectLayout/ElementConstructorGenerator.html @@ -2,7 +2,7 @@ - + ElementConstructorGenerator diff --git a/JavaDoc/org/ObjectLayout/ElementCopyConstructorGenerator.html b/JavaDoc/org/ObjectLayout/ElementCopyConstructorGenerator.html index c98a641..618292e 100644 --- a/JavaDoc/org/ObjectLayout/ElementCopyConstructorGenerator.html +++ b/JavaDoc/org/ObjectLayout/ElementCopyConstructorGenerator.html @@ -2,7 +2,7 @@ - + ElementCopyConstructorGenerator diff --git a/JavaDoc/org/ObjectLayout/ElementFixedConstructorGenerator.html b/JavaDoc/org/ObjectLayout/ElementFixedConstructorGenerator.html index ef41724..d261670 100644 --- a/JavaDoc/org/ObjectLayout/ElementFixedConstructorGenerator.html +++ b/JavaDoc/org/ObjectLayout/ElementFixedConstructorGenerator.html @@ -2,7 +2,7 @@ - + ElementFixedConstructorGenerator diff --git a/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html b/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html index a9bb328..ca698ee 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html +++ b/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html @@ -2,7 +2,7 @@ - + StructuredArray.StructureIterator diff --git a/JavaDoc/org/ObjectLayout/StructuredArray.html b/JavaDoc/org/ObjectLayout/StructuredArray.html index 8d4cea1..fabd955 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArray.html +++ b/JavaDoc/org/ObjectLayout/StructuredArray.html @@ -2,7 +2,7 @@ - + StructuredArray @@ -105,7 +105,7 @@

- An immutable array of (potentially) mutable objects. + An array of (potentially) mutable but non-replaceable objects.

A structured array contains array element objects of a fixed (at creation time, per array instance) class, and can support elements of any class that provides public constructors. The elements in a StructuredArray diff --git a/JavaDoc/org/ObjectLayout/package-frame.html b/JavaDoc/org/ObjectLayout/package-frame.html index 875e346..22ed38c 100644 --- a/JavaDoc/org/ObjectLayout/package-frame.html +++ b/JavaDoc/org/ObjectLayout/package-frame.html @@ -2,7 +2,7 @@ - + org.ObjectLayout diff --git a/JavaDoc/org/ObjectLayout/package-summary.html b/JavaDoc/org/ObjectLayout/package-summary.html index 0399e02..8ad5c6e 100644 --- a/JavaDoc/org/ObjectLayout/package-summary.html +++ b/JavaDoc/org/ObjectLayout/package-summary.html @@ -2,7 +2,7 @@ - + org.ObjectLayout @@ -118,7 +118,7 @@

StructuredArray<T> - An immutable array of (potentially) mutable objects. + An array of (potentially) mutable but non-replaceable objects.   diff --git a/JavaDoc/org/ObjectLayout/package-tree.html b/JavaDoc/org/ObjectLayout/package-tree.html index f64c65d..ce304c4 100644 --- a/JavaDoc/org/ObjectLayout/package-tree.html +++ b/JavaDoc/org/ObjectLayout/package-tree.html @@ -2,7 +2,7 @@ - + org.ObjectLayout Class Hierarchy diff --git a/JavaDoc/overview-tree.html b/JavaDoc/overview-tree.html index 04a5b93..1178b80 100644 --- a/JavaDoc/overview-tree.html +++ b/JavaDoc/overview-tree.html @@ -2,7 +2,7 @@ - + Class Hierarchy From 0f6f9f09408f480a2bd0adc0be200cf81bcc00b0 Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Wed, 29 May 2013 09:42:53 -0700 Subject: [PATCH 06/39] touchup --- index.html | 83 +++++++++++++++++++++++++++++++----------------------- 1 file changed, 47 insertions(+), 36 deletions(-) diff --git a/index.html b/index.html index f89872b..e7640e2 100644 --- a/index.html +++ b/index.html @@ -1,6 +1,6 @@ - + ObjectLayout by giltene and mjpt777 @@ -11,10 +11,10 @@ - - -
-
+ + +
+

ObjectLayout

An optimised memory layout package

@@ -23,44 +23,55 @@

ObjectLayout

View the Project JavaDoc ObjectLayout.github.com/ObjectLayout/JavaDoc

- + -
-
-

ObjectLayout: An optimised memeory layout package.

+
+
+

ObjectLayout: An optimised memory layout package.

+ +

+ The ObjectLayout package provides some core classes designed with optimised memory layout in mind. +

+

+ This package is motivated by the wish to create ways to express optimised memory layout and + related execution semantics that are not currently directly expressible in Java, and to expose these + semantics to Java applications without requiring any language changes. All ObjectLayout package classes + are expected to provide and support their full functionality on all JVMs (of Java SE 5 or above) at + reasonable layouts and execution speeds. However, the classes are designed with semantics that would + allow an optimised JVM to implement them with improved memory and related execution optimizations. +

+

+ The StructuredArray class is a good example of this design pattern. StructuredArray is carefully + designed to allow a JVM to store it in memory with a layout similar to an array of structs + in C-like languages, and to internally use intrinsic representations for the related StructuredArray + methods, exposing them to common optimizations. When a JVM optimises StructuredArray in such a way, + array access benefits from both direct (as opposed to de-referenced) dead-reckoning index access, as + well as from fixed memory strides during streaming operations. +

-

- The ObjectLayout package provides some core classes designed with optimised memory layout in mind. - the package classes provide full functionality on all JVMs (of Java SE 5 or above) at reasonable layouts - and execution speeds. However, the classes are carefully designed with semantics that would allow an - optimised JVM to implement them with improved memory layout not directly expressable in Java. -

- The StructuredArray class is a good exmple of this design pattern. StucturedArray is carefully designed - to allow a JVM to store it in memory with a layout similar to an array of structs in C-like languages. - When a JVM optimises StructuredArray in such a way, array access benefits from both direct (as opposed to - de-referenced) dead-reckoning index access, as well as from fixed memory strides during streaming operations. +

Authors, Contributors, and License

-

Authors, Contributors, and License

+

+ ObjectLayout was authored by Gil Tene + (@giltene) + and Martin Thompson (@mjpt777) + and placed in the public domain, as explained at + http://creativecommons.org/publicdomain/zero/1.0/ +

-

-ObjectLayout was authored by Gil Tene (@giltene) and Martin Thompson (@mjpt777) and - placed in the public domain, as explained at -http://creativecommons.org/publicdomain/zero/1.0/ -

+

Support or Contact

+

Don't call us, We won't call you.

-

Support or Contact

-

Don't call us, We won't call you.

+
- + +
+ - - - - - + From 6573661a5a4d8c3a996b37b3ef6a976f5b8d34fb Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Wed, 29 May 2013 09:55:50 -0700 Subject: [PATCH 07/39] touchup --- index.html | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/index.html b/index.html index e7640e2..8e10004 100644 --- a/index.html +++ b/index.html @@ -38,12 +38,16 @@

ObjectLayout: An optimised memory layout package.

The ObjectLayout package provides some core classes designed with optimised memory layout in mind.

- This package is motivated by the wish to create ways to express optimised memory layout and - related execution semantics that are not currently directly expressible in Java, and to expose these - semantics to Java applications without requiring any language changes. All ObjectLayout package classes - are expected to provide and support their full functionality on all JVMs (of Java SE 5 or above) at - reasonable layouts and execution speeds. However, the classes are designed with semantics that would - allow an optimised JVM to implement them with improved memory and related execution optimizations. + This package expresses specifically useful memory layout and related execution semantics that can + be leveraged by JVMs to provide optimised behavior related to memory layout that is not (currently) + directly expressible in the Java language. The ObjectLayout package exposes these semantics to Java + applications without requiring any language changes. +

+

+ All ObjectLayout package classes are expected to provide and support their full functionality on + all JVMs (of Java SE 5 or above) at reasonable layouts and execution speeds. However, the classes are + specifically designed with semantics that would allow an optimised JVM to implement them with improved + memory layouts and related execution optimizations.

The StructuredArray class is a good example of this design pattern. StructuredArray is carefully From 7f6c6ac1df03b1829ae52d18d2c316cc492f25f3 Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Wed, 29 May 2013 21:12:21 -0700 Subject: [PATCH 08/39] JavaDoc update --- JavaDoc/allclasses-frame.html | 10 +- JavaDoc/allclasses-noframe.html | 10 +- JavaDoc/constant-values.html | 4 +- JavaDoc/deprecated-list.html | 4 +- JavaDoc/help-doc.html | 4 +- JavaDoc/index-files/index-1.html | 26 +- JavaDoc/index-files/index-2.html | 46 +-- JavaDoc/index-files/index-3.html | 28 +- JavaDoc/index-files/index-4.html | 8 +- JavaDoc/index-files/index-5.html | 8 +- JavaDoc/index-files/index-6.html | 10 +- JavaDoc/index-files/index-7.html | 8 +- JavaDoc/index-files/index-8.html | 22 +- JavaDoc/index-files/index-9.html | 14 +- JavaDoc/index.html | 2 +- .../org/ObjectLayout/ConstructorAndArgs.html | 36 +- .../ConstructorAndArgsLocator.html | 327 +++++++++++++++++ .../CopyConstructorAndArgsLocator.html | 342 ++++++++++++++++++ .../FixedConstructorAndArgsLocator.html | 309 ++++++++++++++++ .../StructuredArray.StructureIterator.html | 8 +- JavaDoc/org/ObjectLayout/StructuredArray.html | 35 +- JavaDoc/org/ObjectLayout/package-frame.html | 10 +- JavaDoc/org/ObjectLayout/package-summary.html | 26 +- JavaDoc/org/ObjectLayout/package-tree.html | 8 +- JavaDoc/overview-tree.html | 8 +- 25 files changed, 1140 insertions(+), 173 deletions(-) create mode 100644 JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html create mode 100644 JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html create mode 100644 JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html diff --git a/JavaDoc/allclasses-frame.html b/JavaDoc/allclasses-frame.html index a0fa00a..cf465ea 100644 --- a/JavaDoc/allclasses-frame.html +++ b/JavaDoc/allclasses-frame.html @@ -2,12 +2,12 @@ - + All Classes - + @@ -23,11 +23,11 @@ ConstructorAndArgs
-ElementConstructorGenerator +ConstructorAndArgsLocator
-ElementCopyConstructorGenerator +CopyConstructorAndArgsLocator
-ElementFixedConstructorGenerator +FixedConstructorAndArgsLocator
StructuredArray
diff --git a/JavaDoc/allclasses-noframe.html b/JavaDoc/allclasses-noframe.html index c2d52e6..56bdcfd 100644 --- a/JavaDoc/allclasses-noframe.html +++ b/JavaDoc/allclasses-noframe.html @@ -2,12 +2,12 @@ - + All Classes - + @@ -23,11 +23,11 @@ ConstructorAndArgs
-ElementConstructorGenerator +ConstructorAndArgsLocator
-ElementCopyConstructorGenerator +CopyConstructorAndArgsLocator
-ElementFixedConstructorGenerator +FixedConstructorAndArgsLocator
StructuredArray
diff --git a/JavaDoc/constant-values.html b/JavaDoc/constant-values.html index cab37db..e3a8a6b 100644 --- a/JavaDoc/constant-values.html +++ b/JavaDoc/constant-values.html @@ -2,12 +2,12 @@ - + Constant Field Values - + diff --git a/JavaDoc/deprecated-list.html b/JavaDoc/deprecated-list.html index 6b715b3..f30cfa7 100644 --- a/JavaDoc/deprecated-list.html +++ b/JavaDoc/deprecated-list.html @@ -2,12 +2,12 @@ - + Deprecated List - + diff --git a/JavaDoc/help-doc.html b/JavaDoc/help-doc.html index f3745ae..82e2e4b 100644 --- a/JavaDoc/help-doc.html +++ b/JavaDoc/help-doc.html @@ -2,12 +2,12 @@ - + API Help - + diff --git a/JavaDoc/index-files/index-1.html b/JavaDoc/index-files/index-1.html index 2ba5591..5236438 100644 --- a/JavaDoc/index-files/index-1.html +++ b/JavaDoc/index-files/index-1.html @@ -2,12 +2,12 @@ - + C-Index - + @@ -76,14 +76,26 @@ -C E G H I N O R S


+C F G H I N O R S

C

-
ConstructorAndArgs<T> - Class in org.ObjectLayout
- Captures a specific constructor and arguments to be passed to it.
ConstructorAndArgs(Constructor<T>, Object[]) - +
ConstructorAndArgs<T> - Class in org.ObjectLayout
Captures a specific constructor and arguments to be passed to it.
ConstructorAndArgs(Constructor<T>, Object[]) - Constructor for class org.ObjectLayout.ConstructorAndArgs -
Create a ConstructorAndArgs instance. +
Create a ConstructorAndArgs instance. +
ConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports a general element construction API for StructuredArray by providing specific constructor + and arguments factory to used for constructing individual array elements during array creation.
ConstructorAndArgsLocator(Class<T>) - +Constructor for class org.ObjectLayout.ConstructorAndArgsLocator +
Used to apply a fixed constructor with a given set of arguments to all element. +
CopyConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports the construction of a new array's individual elements using a copy constructor to copy a source + array's corresponding elements.
CopyConstructorAndArgsLocator(Class<T>, StructuredArray<T>) - +Constructor for class org.ObjectLayout.CopyConstructorAndArgsLocator +
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array +
CopyConstructorAndArgsLocator(Class<T>, StructuredArray<T>, long) - +Constructor for class org.ObjectLayout.CopyConstructorAndArgsLocator +
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset
copyInstance(StructuredArray<T>) - Static method in class org.ObjectLayout.StructuredArray
Copy an array of elements to a newly created array. @@ -142,7 +154,7 @@ -C E G H I N O R S
+C F G H I N O R S
diff --git a/JavaDoc/index-files/index-2.html b/JavaDoc/index-files/index-2.html index 8ca8ccd..9ae41f1 100644 --- a/JavaDoc/index-files/index-2.html +++ b/JavaDoc/index-files/index-2.html @@ -2,12 +2,12 @@ - + -E-Index +F-Index - + @@ -15,7 +15,7 @@ function windowTitle() { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="E-Index"; + parent.document.title="F-Index"; } } @@ -76,33 +76,17 @@ -C E G H I N O R S
-

-E

+C F G H I N O R S
+

+F

-
ElementConstructorGenerator<T> - Class in org.ObjectLayout
- Supports a general element construction API for StructuredArray by providing specific constructor - and arguments generator to used for constructing individual array elements during - array creation.
ElementConstructorGenerator(Class<T>) - -Constructor for class org.ObjectLayout.ElementConstructorGenerator -
Used to apply a fixed constructor with a given set of arguments to all element. -
ElementCopyConstructorGenerator<T> - Class in org.ObjectLayout
Supports the construction of a new array's individual elements using a copy constructor to copy a source - array's corresponding elements
ElementCopyConstructorGenerator(Class<T>, StructuredArray<T>) - -Constructor for class org.ObjectLayout.ElementCopyConstructorGenerator -
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a - source array -
ElementCopyConstructorGenerator(Class<T>, StructuredArray<T>, long) - -Constructor for class org.ObjectLayout.ElementCopyConstructorGenerator -
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a - source array, starting at a given offset -
ElementFixedConstructorGenerator<T> - Class in org.ObjectLayout
- Supports a fixed (cached) constructor and set of arguments for either default construction or construction - with a given fixed set of arguments (repeated for all indexes)
ElementFixedConstructorGenerator(Class<T>) - -Constructor for class org.ObjectLayout.ElementFixedConstructorGenerator -
Used to apply default constructor to all elements -
ElementFixedConstructorGenerator(Class<T>, Class[], Object[]) - -Constructor for class org.ObjectLayout.ElementFixedConstructorGenerator -
Used to apply a fixed constructor with a given set of arguments to all elements +
FixedConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports a fixed (cached) constructor and set of arguments for either default construction or construction + with a given fixed set of arguments (repeated for all indices)
FixedConstructorAndArgsLocator(Class<T>) - +Constructor for class org.ObjectLayout.FixedConstructorAndArgsLocator +
Used to apply default constructor to all elements. +
FixedConstructorAndArgsLocator(Class<T>, Class[], Object[]) - +Constructor for class org.ObjectLayout.FixedConstructorAndArgsLocator +
Used to apply a fixed constructor with a given set of arguments to all elements.

@@ -155,7 +139,7 @@ -C E G H I N O R S
+C F G H I N O R S
diff --git a/JavaDoc/index-files/index-3.html b/JavaDoc/index-files/index-3.html index 22da494..7bfeaa6 100644 --- a/JavaDoc/index-files/index-3.html +++ b/JavaDoc/index-files/index-3.html @@ -2,12 +2,12 @@ - + G-Index - + @@ -76,7 +76,7 @@ -C E G H I N O R S
+C F G H I N O R S

G

@@ -89,24 +89,24 @@
getConstructorArgs() - Method in class org.ObjectLayout.ConstructorAndArgs
  -
getElementClass() - -Method in class org.ObjectLayout.ElementConstructorGenerator +
getElementClass() - +Method in class org.ObjectLayout.ConstructorAndArgsLocator
Get the Class of the elements to be constructed
getElementClass() - Method in class org.ObjectLayout.StructuredArray
Get the Class of elements stored in the array. -
getElementConstructorAndArgsForIndex(long) - -Method in class org.ObjectLayout.ElementConstructorGenerator +
getForIndex(long) - +Method in class org.ObjectLayout.ConstructorAndArgsLocator
Get a ConstructorAndArgs instance to be used in constructing a given element index in a StructuredArray -
getElementConstructorAndArgsForIndex(long) - -Method in class org.ObjectLayout.ElementCopyConstructorGenerator +
getForIndex(long) - +Method in class org.ObjectLayout.CopyConstructorAndArgsLocator
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray -
getElementConstructorAndArgsForIndex(long) - -Method in class org.ObjectLayout.ElementFixedConstructorGenerator + a StructuredArray. +
getForIndex(long) - +Method in class org.ObjectLayout.FixedConstructorAndArgsLocator
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray + a StructuredArray.
getL(long) - Method in class org.ObjectLayout.StructuredArray
Get a reference to an element in the array, using a long index. @@ -165,7 +165,7 @@ -C E G H I N O R S
+C F G H I N O R S
diff --git a/JavaDoc/index-files/index-4.html b/JavaDoc/index-files/index-4.html index 7ad14f4..252e0e4 100644 --- a/JavaDoc/index-files/index-4.html +++ b/JavaDoc/index-files/index-4.html @@ -2,12 +2,12 @@ - + H-Index - + @@ -76,7 +76,7 @@ -C E G H I N O R S
+C F G H I N O R S

H

@@ -135,7 +135,7 @@ -C E G H I N O R S
+C F G H I N O R S
diff --git a/JavaDoc/index-files/index-5.html b/JavaDoc/index-files/index-5.html index b9df3f0..2197c4a 100644 --- a/JavaDoc/index-files/index-5.html +++ b/JavaDoc/index-files/index-5.html @@ -2,12 +2,12 @@ - + I-Index - + @@ -76,7 +76,7 @@ -C E G H I N O R S
+C F G H I N O R S

I

@@ -135,7 +135,7 @@ -C E G H I N O R S
+C F G H I N O R S
diff --git a/JavaDoc/index-files/index-6.html b/JavaDoc/index-files/index-6.html index 69f1442..93d97f5 100644 --- a/JavaDoc/index-files/index-6.html +++ b/JavaDoc/index-files/index-6.html @@ -2,12 +2,12 @@ - + N-Index - + @@ -76,7 +76,7 @@ -C E G H I N O R S
+C F G H I N O R S

N

@@ -84,7 +84,7 @@ Static method in class org.ObjectLayout.StructuredArray
Create an array of length elements, each containing an element object of type elementClass. -
newInstance(long, Class<T>, ElementConstructorGenerator<T>) - +
newInstance(long, Class<T>, ConstructorAndArgsLocator<T>) - Static method in class org.ObjectLayout.StructuredArray
Create an array of length elements, each containing an element object of type elementClass. @@ -147,7 +147,7 @@ -C E G H I N O R S
+C F G H I N O R S
diff --git a/JavaDoc/index-files/index-7.html b/JavaDoc/index-files/index-7.html index 8931a7b..6350842 100644 --- a/JavaDoc/index-files/index-7.html +++ b/JavaDoc/index-files/index-7.html @@ -2,12 +2,12 @@ - + O-Index - + @@ -76,7 +76,7 @@ -C E G H I N O R S
+C F G H I N O R S

O

@@ -132,7 +132,7 @@ -C E G H I N O R S
+C F G H I N O R S
diff --git a/JavaDoc/index-files/index-8.html b/JavaDoc/index-files/index-8.html index c0b2422..9c937ac 100644 --- a/JavaDoc/index-files/index-8.html +++ b/JavaDoc/index-files/index-8.html @@ -2,12 +2,12 @@ - + R-Index - + @@ -76,19 +76,19 @@ -C E G H I N O R S
+C F G H I N O R S

R

-
recycleElementConstructorAndArgs(ConstructorAndArgs) - -Method in class org.ObjectLayout.ElementConstructorGenerator -
Recycle a ConstructorAndArgs instance (place it back in the internal cache if desired). -
recycleElementConstructorAndArgs(ConstructorAndArgs) - -Method in class org.ObjectLayout.ElementCopyConstructorGenerator -
Recycle a ConstructorAndArgs instance (place it back in the internal cache if desired). +
recycle(ConstructorAndArgs) - +Method in class org.ObjectLayout.ConstructorAndArgsLocator +
Recycle a ConstructorAndArgs instance (place it back in the internal cache if desired). +
recycle(ConstructorAndArgs) - +Method in class org.ObjectLayout.CopyConstructorAndArgsLocator +
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired).
remove() - Method in class org.ObjectLayout.StructuredArray.StructureIterator -
Remove operations are not supported on StructuredArrays. +
Remove operation is not supported on StructuredArrays.
reset() - Method in class org.ObjectLayout.StructuredArray.StructureIterator
Reset to the beginning of the collection enabling reuse of the iterator. @@ -144,7 +144,7 @@ -C E G H I N O R S
+C F G H I N O R S
diff --git a/JavaDoc/index-files/index-9.html b/JavaDoc/index-files/index-9.html index be56704..c29b7b6 100644 --- a/JavaDoc/index-files/index-9.html +++ b/JavaDoc/index-files/index-9.html @@ -2,12 +2,12 @@ - + S-Index - + @@ -76,22 +76,22 @@ -C E G H I N O R S
+C F G H I N O R S

S

setConstructor(Constructor<T>) - Method in class org.ObjectLayout.ConstructorAndArgs -
Set the constructor to be indicated in this ConstructorAndArgs. +
Set the constructor to be indicated in this ConstructorAndArgs.
setConstructorArgs(Object[]) - Method in class org.ObjectLayout.ConstructorAndArgs
Set the constructor arguments to be indicated in this ConstructorAndArgs.
shallowCopy(StructuredArray, long, StructuredArray, long, long) - Static method in class org.ObjectLayout.StructuredArray -
Shallow copy a region of element object contents from one array to the other +
Shallow copy a region of element object contents from one array to the other.
shallowCopy(StructuredArray, long, StructuredArray, long, long, boolean) - Static method in class org.ObjectLayout.StructuredArray -
Shallow copy a region of element object contents from one array to the other +
Shallow copy a region of element object contents from one array to the other.
StructuredArray<T> - Class in org.ObjectLayout
An array of (potentially) mutable but non-replaceable objects.
StructuredArray.StructureIterator - Class in org.ObjectLayout
Specialised Iterator with the ability to be reset() enabling reuse.
StructuredArray.StructureIterator() - Constructor for class org.ObjectLayout.StructuredArray.StructureIterator @@ -148,7 +148,7 @@ -C E G H I N O R S
+C F G H I N O R S
diff --git a/JavaDoc/index.html b/JavaDoc/index.html index 83c1db2..52511d0 100644 --- a/JavaDoc/index.html +++ b/JavaDoc/index.html @@ -2,7 +2,7 @@ - + Generated Documentation (Untitled) diff --git a/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html b/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html index 023d195..e0331df 100644 --- a/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html +++ b/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html @@ -2,12 +2,12 @@ - + ConstructorAndArgs - + @@ -54,7 +54,7 @@  PREV CLASS  - NEXT CLASSNEXT CLASS FRAMES    NO FRAMES   @@ -101,11 +101,9 @@

-

- Captures a specific constructor and arguments to be passed to it. Useful for providing - fully customizable, per-element construction behavior for iterative constructors (such as those - used for elements in StructuredArray) -

+Captures a specific constructor and arguments to be passed to it. Useful for providing + fully customizable, per-element construction behavior for iterative constructors (such as those + used for elements in StructuredArray)

@@ -126,7 +124,7 @@

java.lang.Object[] constructorArguments)
-          Create a ConstructorAndArgs instance. +          Create a ConstructorAndArgs instance.   @@ -160,7 +158,7 @@

setConstructor(java.lang.reflect.Constructor<T> constructor)
-          Set the constructor to be indicated in this ConstructorAndArgs. +          Set the constructor to be indicated in this ConstructorAndArgs. @@ -199,12 +197,12 @@

public ConstructorAndArgs(java.lang.reflect.Constructor<T> constructor, java.lang.Object[] constructorArguments)
-
Create a ConstructorAndArgs instance. The presumption is that types in constructorArguments match - those expected by constructor. Obviously exceptions may be generated at construction time if this - is not the case. +
Create a ConstructorAndArgs instance. The presumption is that types in constructorArguments + match those expected by constructor. Obviously exceptions may be generated at construction time if + this is not the case.

-
Parameters:
constructor - Constructor to be indicated in this ConstructorAndArgs
constructorArguments - constructor arguments to be indicated in this ConstructorAndArgs
+
Parameters:
constructor - Constructor to be indicated in this ConstructorAndArgs
constructorArguments - constructor arguments to be indicated in this ConstructorAndArgs

@@ -234,8 +232,8 @@

 public final void setConstructor(java.lang.reflect.Constructor<T> constructor)
-
Set the constructor to be indicated in this ConstructorAndArgs. Enables recycling of ConstructorAndArgs - objects to avoid re-allocation. E.g. in copy construction loops. +
Set the constructor to be indicated in this ConstructorAndArgs. Enables recycling of + ConstructorAndArgs objects to avoid re-allocation. E.g. in copy construction loops.

Parameters:
constructor - Constructor to be indicated in this ConstructorAndArgs
@@ -261,10 +259,10 @@

public final void setConstructorArgs(java.lang.Object[] constructorArgs)
Set the constructor arguments to be indicated in this ConstructorAndArgs. Enables recycling of - ConstructorAndArgs objects to avoid re-allocation. E.g. in copy construction loops. + ConstructorAndArgs objects to avoid re-allocation. E.g. in copy construction loops.

-
Parameters:
constructorArgs - constructor arguments to be indicated in this ConstructorAndArgs
+
Parameters:
constructorArgs - constructor arguments to be indicated in this ConstructorAndArgs

@@ -297,7 +295,7 @@

 PREV CLASS  - NEXT CLASSNEXT CLASS FRAMES    NO FRAMES   diff --git a/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html new file mode 100644 index 0000000..af67d8d --- /dev/null +++ b/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html @@ -0,0 +1,327 @@ + + + + + + +ConstructorAndArgsLocator + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class ConstructorAndArgsLocator<T>

+
+java.lang.Object
+  extended by org.ObjectLayout.ConstructorAndArgsLocator<T>
+
+
+
Type Parameters:
T - type of the element occupying each array slot.
+
+
Direct Known Subclasses:
CopyConstructorAndArgsLocator, FixedConstructorAndArgsLocator
+
+
+
+
public abstract class ConstructorAndArgsLocator<T>
extends java.lang.Object
+ + +

+Supports a general element construction API for StructuredArray by providing specific constructor + and arguments factory to used for constructing individual array elements during array creation. +

+ Subclasses can be created that would provide a fixed constructor (as in FixedConstructorAndArgsLocator), + or to provide arguments and constructor values that would take the array index of the constructed element into account. + An example of this latter pattern can be found in the implementation of a CopyConstructorAndArgsLocator. +

+ +

+


+ +

+ + + + + + + + + + + +
+Constructor Summary
ConstructorAndArgsLocator(java.lang.Class<T> elementClass) + +
+          Used to apply a fixed constructor with a given set of arguments to all element.
+  + + + + + + + + + + + + + + + + + + + +
+Method Summary
+ java.lang.Class<T>getElementClass() + +
+          Get the Class of the elements to be constructed
+abstract  ConstructorAndArgs<T>getForIndex(long index) + +
+          Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray
+ voidrecycle(ConstructorAndArgs constructorAndArgs) + +
+          Recycle a ConstructorAndArgs instance (place it back in the internal cache if desired).
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+ConstructorAndArgsLocator

+
+public ConstructorAndArgsLocator(java.lang.Class<T> elementClass)
+                          throws java.lang.NoSuchMethodException
+
+
Used to apply a fixed constructor with a given set of arguments to all element. +

+

+
Parameters:
elementClass - The element class +
Throws: +
java.lang.NoSuchMethodException - if a constructor matching defaultArgTypes +
java.lang.IllegalArgumentException - if argTypes and args conflict
+
+ + + + + + + + +
+Method Detail
+ +

+getForIndex

+
+public abstract ConstructorAndArgs<T> getForIndex(long index)
+                                           throws java.lang.NoSuchMethodException
+
+
Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray +

+

+
Parameters:
index - The index of the element to be constructed in the target array +
Returns:
ConstructorAndArgs instance to used in element construction +
Throws: +
java.lang.NoSuchMethodException - if expected constructor is not found in element class
+
+
+
+ +

+recycle

+
+public void recycle(ConstructorAndArgs constructorAndArgs)
+
+
Recycle a ConstructorAndArgs instance (place it back in the internal cache if desired). + This is [very] useful for avoiding a re-allocation of a new ConstructorAndArgs and an + associated args array for getForIndex(long) invocation in cases where + the returned ConstructorAndArgs is not constant. +

+ Recycling is optional, and is not guaranteed to occur. It will only be done if it is helpful. + Overriding this method is optional for subclasses. See example in CopyConstructorAndArgsLocator +

+

+
Parameters:
constructorAndArgs - the ConstructorAndArgs instance to recycle
+
+
+
+ +

+getElementClass

+
+public java.lang.Class<T> getElementClass()
+
+
Get the Class of the elements to be constructed +

+

+ +
Returns:
Class of elements to be constructed
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html new file mode 100644 index 0000000..0acd063 --- /dev/null +++ b/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html @@ -0,0 +1,342 @@ + + + + + + +CopyConstructorAndArgsLocator + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class CopyConstructorAndArgsLocator<T>

+
+java.lang.Object
+  extended by org.ObjectLayout.ConstructorAndArgsLocator<T>
+      extended by org.ObjectLayout.CopyConstructorAndArgsLocator<T>
+
+
+
Type Parameters:
T - type of the element occupying each array slot
+
+
+
public class CopyConstructorAndArgsLocator<T>
extends ConstructorAndArgsLocator<T>
+ + +

+Supports the construction of a new array's individual elements using a copy constructor to copy a source + array's corresponding elements. +

+ +

+


+ +

+ + + + + + + + + + + + + + +
+Constructor Summary
CopyConstructorAndArgsLocator(java.lang.Class<T> elementClass, + StructuredArray<T> source) + +
+          Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array
CopyConstructorAndArgsLocator(java.lang.Class<T> elementClass, + StructuredArray<T> source, + long sourceOffset) + +
+          Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset
+  + + + + + + + + + + + + + + + +
+Method Summary
+ ConstructorAndArgs<T>getForIndex(long index) + +
+          Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray.
+ voidrecycle(ConstructorAndArgs constructorAndArgs) + +
+          Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired).
+ + + + + + + +
Methods inherited from class org.ObjectLayout.ConstructorAndArgsLocator
getElementClass
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+CopyConstructorAndArgsLocator

+
+public CopyConstructorAndArgsLocator(java.lang.Class<T> elementClass,
+                                     StructuredArray<T> source)
+                              throws java.lang.NoSuchMethodException
+
+
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array +

+

+
Parameters:
elementClass - The class of the elements to be constructed
source - The source StructuredArray to copy from +
Throws: +
java.lang.NoSuchMethodException
+
+
+ +

+CopyConstructorAndArgsLocator

+
+public CopyConstructorAndArgsLocator(java.lang.Class<T> elementClass,
+                                     StructuredArray<T> source,
+                                     long sourceOffset)
+                              throws java.lang.NoSuchMethodException
+
+
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +

+

+
Parameters:
elementClass - The class of the elements to be constructed
source - The source StructuredArray to copy from
sourceOffset - The beginning index in the source from which to start copying +
Throws: +
java.lang.NoSuchMethodException - if a copy constructor is not found in element class
+
+ + + + + + + + +
+Method Detail
+ +

+getForIndex

+
+public ConstructorAndArgs<T> getForIndex(long index)
+                                  throws java.lang.NoSuchMethodException
+
+
Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray. . +

+

+
Specified by:
getForIndex in class ConstructorAndArgsLocator<T>
+
+
+
Parameters:
index - The index of the element to be constructed in the target array +
Returns:
ConstructorAndArgs instance to used in element construction +
Throws: +
java.lang.NoSuchMethodException - if expected constructor is not found in element class
+
+
+
+ +

+recycle

+
+public void recycle(ConstructorAndArgs constructorAndArgs)
+
+
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired). This is [very] + useful for avoiding a re-allocation of a new ConstructorAndArgs and an associated args array for + getForIndex(long) invocation in cases such as this (where the returned ConstructorAndArgs + is not constant across indices). + Recycling is optional, and is not guaranteed to occur. +

+

+
Overrides:
recycle in class ConstructorAndArgsLocator<T>
+
+
+
Parameters:
constructorAndArgs - the ConstructorAndArgs instance to recycle
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html new file mode 100644 index 0000000..d334810 --- /dev/null +++ b/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html @@ -0,0 +1,309 @@ + + + + + + +FixedConstructorAndArgsLocator + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class FixedConstructorAndArgsLocator<T>

+
+java.lang.Object
+  extended by org.ObjectLayout.ConstructorAndArgsLocator<T>
+      extended by org.ObjectLayout.FixedConstructorAndArgsLocator<T>
+
+
+
Type Parameters:
T - type of the element occupying each array slot
+
+
+
public class FixedConstructorAndArgsLocator<T>
extends ConstructorAndArgsLocator<T>
+ + +

+Supports a fixed (cached) constructor and set of arguments for either default construction or construction + with a given fixed set of arguments (repeated for all indices) +

+ +

+


+ +

+ + + + + + + + + + + + + + +
+Constructor Summary
FixedConstructorAndArgsLocator(java.lang.Class<T> elementClass) + +
+          Used to apply default constructor to all elements.
FixedConstructorAndArgsLocator(java.lang.Class<T> elementClass, + java.lang.Class[] argTypes, + java.lang.Object[] args) + +
+          Used to apply a fixed constructor with a given set of arguments to all elements.
+  + + + + + + + + + + + +
+Method Summary
+ ConstructorAndArgs<T>getForIndex(long index) + +
+          Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray.
+ + + + + + + +
Methods inherited from class org.ObjectLayout.ConstructorAndArgsLocator
getElementClass, recycle
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+FixedConstructorAndArgsLocator

+
+public FixedConstructorAndArgsLocator(java.lang.Class<T> elementClass)
+                               throws java.lang.NoSuchMethodException
+
+
Used to apply default constructor to all elements. +

+

+
Parameters:
elementClass - The element class +
Throws: +
java.lang.NoSuchMethodException - if no default constructor is found for elementClass
+
+
+ +

+FixedConstructorAndArgsLocator

+
+public FixedConstructorAndArgsLocator(java.lang.Class<T> elementClass,
+                                      java.lang.Class[] argTypes,
+                                      java.lang.Object[] args)
+                               throws java.lang.NoSuchMethodException
+
+
Used to apply a fixed constructor with a given set of arguments to all elements. +

+

+
Parameters:
elementClass - The element class
argTypes - The argument types for the element constructor
args - The arguments to be passed to the constructor for all elements +
Throws: +
java.lang.NoSuchMethodException - if a constructor matching argTypes +
java.lang.IllegalArgumentException - if argTypes and args conflict
+
+ + + + + + + + +
+Method Detail
+ +

+getForIndex

+
+public ConstructorAndArgs<T> getForIndex(long index)
+                                  throws java.lang.NoSuchMethodException
+
+
Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray. +

+

+
Specified by:
getForIndex in class ConstructorAndArgsLocator<T>
+
+
+
Parameters:
index - of the element to be constructed in the target array +
Returns:
ConstructorAndArgs instance to used in element construction +
Throws: +
java.lang.NoSuchMethodException - if expected constructor is not found in element class
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html b/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html index ca698ee..176555e 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html +++ b/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html @@ -2,12 +2,12 @@ - + StructuredArray.StructureIterator - + @@ -159,7 +159,7 @@

remove()
-          Remove operations are not supported on StructuredArrays. +          Remove operation is not supported on StructuredArrays. @@ -246,7 +246,7 @@

 public void remove()
-
Remove operations are not supported on StructuredArrays. +
Remove operation is not supported on StructuredArrays.

Specified by:
remove in interface java.util.Iterator<T>
diff --git a/JavaDoc/org/ObjectLayout/StructuredArray.html b/JavaDoc/org/ObjectLayout/StructuredArray.html index fabd955..53a8d4b 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArray.html +++ b/JavaDoc/org/ObjectLayout/StructuredArray.html @@ -2,12 +2,12 @@ - + StructuredArray - + @@ -53,7 +53,7 @@ PREV CLASS  + PREV CLASS   NEXT CLASS FRAMES   @@ -111,13 +111,13 @@

and can support elements of any class that provides public constructors. The elements in a StructuredArray are all allocated and constructed at array creation time, and individual elements cannot be removed or replaced after array creation. Array elements can be accessed using an index-based accessor methods in - the form of get(int)() (for int indexes) or getL(long)() - (for long indexes). Individual element contents can then be accessed and manipulated using any and all + the form of get(int)() (for int indices) or getL(long)() + (for long indices). Individual element contents can then be accessed and manipulated using any and all operations supported by the member element's class.

While simple creation of default-constructed elements and fixed constructor parameters are available through the newInstance factory methods, supporting arbitrary member types requires a wider range of construction - options. The ElementConstructorGenerator API provides for array creation with arbitrary, user-supplied + options. The ConstructorAndArgsLocator API provides for array creation with arbitrary, user-supplied constructors and arguments, either of which can take the element index into account.

StructuredArray is designed with semantics specifically restricted to be consistent with layouts of an @@ -128,7 +128,6 @@

Note: At least for some JVM implementations, get(int)() access may be faster than getL(long)() access. -

@@ -279,9 +278,9 @@

-newInstance(long length, +newInstance(long length, java.lang.Class<T> elementClass, - ElementConstructorGenerator<T> constructorGenerator) + ConstructorAndArgsLocator<T> constructorAndArgsLocator)
          Create an array of length elements, each containing an element object of @@ -297,7 +296,7 @@

long count)
-          Shallow copy a region of element object contents from one array to the other +          Shallow copy a region of element object contents from one array to the other. @@ -310,7 +309,7 @@

boolean allowFinalFieldOverwrite)
-          Shallow copy a region of element object contents from one array to the other +          Shallow copy a region of element object contents from one array to the other.   @@ -356,24 +355,24 @@


-

+

newInstance

 public static <T> StructuredArray<T> newInstance(long length,
                                                  java.lang.Class<T> elementClass,
-                                                 ElementConstructorGenerator<T> constructorGenerator)
+                                                 ConstructorAndArgsLocator<T> constructorAndArgsLocator)
                                       throws java.lang.NoSuchMethodException
Create an array of length elements, each containing an element object of type elementClass. Use constructor and arguments supplied (on a potentially - per element index basis) by the specified constructorGenerator to construct and initialize + per element index basis) by the specified constructorAndArgsLocator to construct and initialize each element.

-
Parameters:
length - of the array to create.
elementClass - of each element in the array
constructorGenerator - produces element constructors [potentially] on a per element basis. +
Parameters:
length - of the array to create.
elementClass - of each element in the array
constructorAndArgsLocator - produces element constructors [potentially] on a per element basis.
Throws:
java.lang.NoSuchMethodException - if the element class does not not support a supplied constructor
@@ -527,7 +526,7 @@

long dstOffset, long count)
-
Shallow copy a region of element object contents from one array to the other +
Shallow copy a region of element object contents from one array to the other.

shallowCopy will copy all fields from each of the source elements to the corresponding fields in each of the corresponding destination elements. If the same array is both the src and dst then the copy will @@ -555,7 +554,7 @@

long count, boolean allowFinalFieldOverwrite)
-
Shallow copy a region of element object contents from one array to the other +
Shallow copy a region of element object contents from one array to the other.

shallowCopy will copy all fields from each of the source elements to the corresponding fields in each of the corresponding destination elements. If the same array is both the src and dst then the copy will @@ -618,7 +617,7 @@

PREV CLASS  + PREV CLASS   NEXT CLASS FRAMES   diff --git a/JavaDoc/org/ObjectLayout/package-frame.html b/JavaDoc/org/ObjectLayout/package-frame.html index 22ed38c..280f9bd 100644 --- a/JavaDoc/org/ObjectLayout/package-frame.html +++ b/JavaDoc/org/ObjectLayout/package-frame.html @@ -2,12 +2,12 @@ - + org.ObjectLayout - + @@ -25,11 +25,11 @@
ConstructorAndArgs
-ElementConstructorGenerator +ConstructorAndArgsLocator
-ElementCopyConstructorGenerator +CopyConstructorAndArgsLocator
-ElementFixedConstructorGenerator +FixedConstructorAndArgsLocator
StructuredArray
diff --git a/JavaDoc/org/ObjectLayout/package-summary.html b/JavaDoc/org/ObjectLayout/package-summary.html index 8ad5c6e..7755ec9 100644 --- a/JavaDoc/org/ObjectLayout/package-summary.html +++ b/JavaDoc/org/ObjectLayout/package-summary.html @@ -2,12 +2,12 @@ - + org.ObjectLayout - + @@ -94,26 +94,22 @@

ConstructorAndArgs<T> - - Captures a specific constructor and arguments to be passed to it. +Captures a specific constructor and arguments to be passed to it. -ElementConstructorGenerator<T> - - Supports a general element construction API for StructuredArray by providing specific constructor - and arguments generator to used for constructing individual array elements during - array creation. +ConstructorAndArgsLocator<T> +Supports a general element construction API for StructuredArray by providing specific constructor + and arguments factory to used for constructing individual array elements during array creation. -ElementCopyConstructorGenerator<T> +CopyConstructorAndArgsLocator<T> Supports the construction of a new array's individual elements using a copy constructor to copy a source - array's corresponding elements + array's corresponding elements. -ElementFixedConstructorGenerator<T> - - Supports a fixed (cached) constructor and set of arguments for either default construction or construction - with a given fixed set of arguments (repeated for all indexes) +FixedConstructorAndArgsLocator<T> +Supports a fixed (cached) constructor and set of arguments for either default construction or construction + with a given fixed set of arguments (repeated for all indices) StructuredArray<T> diff --git a/JavaDoc/org/ObjectLayout/package-tree.html b/JavaDoc/org/ObjectLayout/package-tree.html index ce304c4..d2a1041 100644 --- a/JavaDoc/org/ObjectLayout/package-tree.html +++ b/JavaDoc/org/ObjectLayout/package-tree.html @@ -2,12 +2,12 @@ - + org.ObjectLayout Class Hierarchy - + @@ -87,8 +87,8 @@

  • java.lang.Object diff --git a/JavaDoc/overview-tree.html b/JavaDoc/overview-tree.html index 1178b80..fe2eca5 100644 --- a/JavaDoc/overview-tree.html +++ b/JavaDoc/overview-tree.html @@ -2,12 +2,12 @@ - + Class Hierarchy - + @@ -89,8 +89,8 @@

    • java.lang.Object From 66739301b9cbbbcd2f1f6d9137ceb38e43ac02f0 Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Fri, 31 May 2013 09:15:33 -0700 Subject: [PATCH 09/39] JavaDoc update --- JavaDoc/allclasses-frame.html | 4 +-- JavaDoc/allclasses-noframe.html | 4 +-- JavaDoc/constant-values.html | 4 +-- JavaDoc/deprecated-list.html | 4 +-- JavaDoc/help-doc.html | 4 +-- JavaDoc/index-files/index-1.html | 8 +++-- JavaDoc/index-files/index-2.html | 4 +-- JavaDoc/index-files/index-3.html | 4 +-- JavaDoc/index-files/index-4.html | 4 +-- JavaDoc/index-files/index-5.html | 4 +-- JavaDoc/index-files/index-6.html | 4 +-- JavaDoc/index-files/index-7.html | 4 +-- JavaDoc/index-files/index-8.html | 4 +-- JavaDoc/index-files/index-9.html | 7 ++-- JavaDoc/index.html | 2 +- .../org/ObjectLayout/ConstructorAndArgs.html | 4 +-- .../ConstructorAndArgsLocator.html | 4 +-- .../CopyConstructorAndArgsLocator.html | 33 +++++++++++++++++-- .../FixedConstructorAndArgsLocator.html | 4 +-- .../StructuredArray.StructureIterator.html | 4 +-- JavaDoc/org/ObjectLayout/StructuredArray.html | 7 ++-- JavaDoc/org/ObjectLayout/package-frame.html | 4 +-- JavaDoc/org/ObjectLayout/package-summary.html | 7 ++-- JavaDoc/org/ObjectLayout/package-tree.html | 4 +-- JavaDoc/overview-tree.html | 4 +-- 25 files changed, 85 insertions(+), 55 deletions(-) diff --git a/JavaDoc/allclasses-frame.html b/JavaDoc/allclasses-frame.html index cf465ea..bc46e7e 100644 --- a/JavaDoc/allclasses-frame.html +++ b/JavaDoc/allclasses-frame.html @@ -2,12 +2,12 @@ - + All Classes - + diff --git a/JavaDoc/allclasses-noframe.html b/JavaDoc/allclasses-noframe.html index 56bdcfd..b315ecf 100644 --- a/JavaDoc/allclasses-noframe.html +++ b/JavaDoc/allclasses-noframe.html @@ -2,12 +2,12 @@ - + All Classes - + diff --git a/JavaDoc/constant-values.html b/JavaDoc/constant-values.html index e3a8a6b..4eac6fe 100644 --- a/JavaDoc/constant-values.html +++ b/JavaDoc/constant-values.html @@ -2,12 +2,12 @@ - + Constant Field Values - + diff --git a/JavaDoc/deprecated-list.html b/JavaDoc/deprecated-list.html index f30cfa7..74df6c3 100644 --- a/JavaDoc/deprecated-list.html +++ b/JavaDoc/deprecated-list.html @@ -2,12 +2,12 @@ - + Deprecated List - + diff --git a/JavaDoc/help-doc.html b/JavaDoc/help-doc.html index 82e2e4b..5808379 100644 --- a/JavaDoc/help-doc.html +++ b/JavaDoc/help-doc.html @@ -2,12 +2,12 @@ - + API Help - + diff --git a/JavaDoc/index-files/index-1.html b/JavaDoc/index-files/index-1.html index 5236438..d42a138 100644 --- a/JavaDoc/index-files/index-1.html +++ b/JavaDoc/index-files/index-1.html @@ -2,12 +2,12 @@ - + C-Index - + @@ -94,6 +94,10 @@ source array
      CopyConstructorAndArgsLocator(Class<T>, StructuredArray<T>, long) - Constructor for class org.ObjectLayout.CopyConstructorAndArgsLocator +
      Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +
      CopyConstructorAndArgsLocator(Class<T>, StructuredArray<T>, long, boolean) - +Constructor for class org.ObjectLayout.CopyConstructorAndArgsLocator
      Used to apply a copy constructor to a target array's elements, copying corresponding elements from a source array, starting at a given offset
      copyInstance(StructuredArray<T>) - diff --git a/JavaDoc/index-files/index-2.html b/JavaDoc/index-files/index-2.html index 9ae41f1..dffd38d 100644 --- a/JavaDoc/index-files/index-2.html +++ b/JavaDoc/index-files/index-2.html @@ -2,12 +2,12 @@ - + F-Index - + diff --git a/JavaDoc/index-files/index-3.html b/JavaDoc/index-files/index-3.html index 7bfeaa6..84c1565 100644 --- a/JavaDoc/index-files/index-3.html +++ b/JavaDoc/index-files/index-3.html @@ -2,12 +2,12 @@ - + G-Index - + diff --git a/JavaDoc/index-files/index-4.html b/JavaDoc/index-files/index-4.html index 252e0e4..ca273e6 100644 --- a/JavaDoc/index-files/index-4.html +++ b/JavaDoc/index-files/index-4.html @@ -2,12 +2,12 @@ - + H-Index - + diff --git a/JavaDoc/index-files/index-5.html b/JavaDoc/index-files/index-5.html index 2197c4a..70c1982 100644 --- a/JavaDoc/index-files/index-5.html +++ b/JavaDoc/index-files/index-5.html @@ -2,12 +2,12 @@ - + I-Index - + diff --git a/JavaDoc/index-files/index-6.html b/JavaDoc/index-files/index-6.html index 93d97f5..0fc70c8 100644 --- a/JavaDoc/index-files/index-6.html +++ b/JavaDoc/index-files/index-6.html @@ -2,12 +2,12 @@ - + N-Index - + diff --git a/JavaDoc/index-files/index-7.html b/JavaDoc/index-files/index-7.html index 6350842..fdca159 100644 --- a/JavaDoc/index-files/index-7.html +++ b/JavaDoc/index-files/index-7.html @@ -2,12 +2,12 @@ - + O-Index - + diff --git a/JavaDoc/index-files/index-8.html b/JavaDoc/index-files/index-8.html index 9c937ac..108b2c9 100644 --- a/JavaDoc/index-files/index-8.html +++ b/JavaDoc/index-files/index-8.html @@ -2,12 +2,12 @@ - + R-Index - + diff --git a/JavaDoc/index-files/index-9.html b/JavaDoc/index-files/index-9.html index c29b7b6..f24ed44 100644 --- a/JavaDoc/index-files/index-9.html +++ b/JavaDoc/index-files/index-9.html @@ -2,12 +2,12 @@ - + S-Index - + @@ -92,8 +92,7 @@
      shallowCopy(StructuredArray, long, StructuredArray, long, long, boolean) - Static method in class org.ObjectLayout.StructuredArray
      Shallow copy a region of element object contents from one array to the other. -
      StructuredArray<T> - Class in org.ObjectLayout
      - An array of (potentially) mutable but non-replaceable objects.
      StructuredArray.StructureIterator - Class in org.ObjectLayout
      Specialised Iterator with the ability to be reset() enabling reuse.
      StructuredArray.StructureIterator() - +
      StructuredArray<T> - Class in org.ObjectLayout
      An array of (potentially) mutable but non-replaceable objects.
      StructuredArray.StructureIterator - Class in org.ObjectLayout
      Specialised Iterator with the ability to be reset() enabling reuse.
      StructuredArray.StructureIterator() - Constructor for class org.ObjectLayout.StructuredArray.StructureIterator
       
diff --git a/JavaDoc/index.html b/JavaDoc/index.html index 52511d0..54600d3 100644 --- a/JavaDoc/index.html +++ b/JavaDoc/index.html @@ -2,7 +2,7 @@ - + Generated Documentation (Untitled) diff --git a/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html b/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html index e0331df..f630b69 100644 --- a/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html +++ b/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html @@ -2,12 +2,12 @@ - + ConstructorAndArgs - + diff --git a/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html index af67d8d..3e40fe0 100644 --- a/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + ConstructorAndArgsLocator - + diff --git a/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html index 0acd063..ff5fb43 100644 --- a/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + CopyConstructorAndArgsLocator - + @@ -132,6 +132,16 @@

StructuredArray<T> source, long sourceOffset) +
+          Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset + + +CopyConstructorAndArgsLocator(java.lang.Class<T> elementClass, + StructuredArray<T> source, + long sourceOffset, + boolean keepInternalCachingThreadSafe) +
          Used to apply a copy constructor to a target array's elements, copying corresponding elements from a source array, starting at a given offset @@ -228,6 +238,25 @@

Throws:
java.lang.NoSuchMethodException - if a copy constructor is not found in element class

+
+ +

+CopyConstructorAndArgsLocator

+
+public CopyConstructorAndArgsLocator(java.lang.Class<T> elementClass,
+                                     StructuredArray<T> source,
+                                     long sourceOffset,
+                                     boolean keepInternalCachingThreadSafe)
+                              throws java.lang.NoSuchMethodException
+
+
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +

+

+
Parameters:
elementClass - The class of the elements to be constructed
source - The source StructuredArray to copy from
sourceOffset - The beginning index in the source from which to start copying
keepInternalCachingThreadSafe - Control whether or not internal caching is kept thread-safe +
Throws: +
java.lang.NoSuchMethodException - NoSuchMethodException if a copy constructor is not found in element class
+
diff --git a/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html index d334810..699b394 100644 --- a/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + FixedConstructorAndArgsLocator - + diff --git a/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html b/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html index 176555e..eddf1f0 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html +++ b/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html @@ -2,12 +2,12 @@ - + StructuredArray.StructureIterator - + diff --git a/JavaDoc/org/ObjectLayout/StructuredArray.html b/JavaDoc/org/ObjectLayout/StructuredArray.html index 53a8d4b..cc385b8 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArray.html +++ b/JavaDoc/org/ObjectLayout/StructuredArray.html @@ -2,12 +2,12 @@ - + StructuredArray - + @@ -104,8 +104,7 @@

-

- An array of (potentially) mutable but non-replaceable objects. +An array of (potentially) mutable but non-replaceable objects.

A structured array contains array element objects of a fixed (at creation time, per array instance) class, and can support elements of any class that provides public constructors. The elements in a StructuredArray diff --git a/JavaDoc/org/ObjectLayout/package-frame.html b/JavaDoc/org/ObjectLayout/package-frame.html index 280f9bd..7439d58 100644 --- a/JavaDoc/org/ObjectLayout/package-frame.html +++ b/JavaDoc/org/ObjectLayout/package-frame.html @@ -2,12 +2,12 @@ - + org.ObjectLayout - + diff --git a/JavaDoc/org/ObjectLayout/package-summary.html b/JavaDoc/org/ObjectLayout/package-summary.html index 7755ec9..cc34064 100644 --- a/JavaDoc/org/ObjectLayout/package-summary.html +++ b/JavaDoc/org/ObjectLayout/package-summary.html @@ -2,12 +2,12 @@ - + org.ObjectLayout - + @@ -113,8 +113,7 @@

StructuredArray<T> - - An array of (potentially) mutable but non-replaceable objects. +An array of (potentially) mutable but non-replaceable objects.   diff --git a/JavaDoc/org/ObjectLayout/package-tree.html b/JavaDoc/org/ObjectLayout/package-tree.html index d2a1041..0057cbf 100644 --- a/JavaDoc/org/ObjectLayout/package-tree.html +++ b/JavaDoc/org/ObjectLayout/package-tree.html @@ -2,12 +2,12 @@ - + org.ObjectLayout Class Hierarchy - + diff --git a/JavaDoc/overview-tree.html b/JavaDoc/overview-tree.html index fe2eca5..2703b0a 100644 --- a/JavaDoc/overview-tree.html +++ b/JavaDoc/overview-tree.html @@ -2,12 +2,12 @@ - + Class Hierarchy - + From b68965b3111897eb19163e5ad1d3e63a0b94faa9 Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Fri, 31 May 2013 10:21:02 -0700 Subject: [PATCH 10/39] Updated index page --- index.html | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/index.html b/index.html index 8e10004..b0462c8 100644 --- a/index.html +++ b/index.html @@ -50,7 +50,10 @@

ObjectLayout: An optimised memory layout package.

memory layouts and related execution optimizations.

- The StructuredArray class is a good example of this design pattern. StructuredArray is carefully + The + StructuredArray + class is a good example of this design pattern. StructuredArray is carefully designed to allow a JVM to store it in memory with a layout similar to an array of structs in C-like languages, and to internally use intrinsic representations for the related StructuredArray methods, exposing them to common optimizations. When a JVM optimises StructuredArray in such a way, From 07cfed3a85a5351ff8c66a617453c1011a0dd135 Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Fri, 31 May 2013 10:23:29 -0700 Subject: [PATCH 11/39] Updated index page --- index.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index b0462c8..5bc683f 100644 --- a/index.html +++ b/index.html @@ -39,9 +39,9 @@

ObjectLayout: An optimised memory layout package.

This package expresses specifically useful memory layout and related execution semantics that can - be leveraged by JVMs to provide optimised behavior related to memory layout that is not (currently) - directly expressible in the Java language. The ObjectLayout package exposes these semantics to Java - applications without requiring any language changes. + be leveraged by JVMs to provide optimised behaviors that are not directly expressible in the Java + language. The ObjectLayout package exposes these semantics to Java applications without requiring + any language changes.

All ObjectLayout package classes are expected to provide and support their full functionality on From d8bdca13324d73681d43bc46d4fb711997f4d661 Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Mon, 3 Jun 2013 00:21:06 -0700 Subject: [PATCH 12/39] JavaDoc update --- JavaDoc/allclasses-frame.html | 12 +- JavaDoc/allclasses-noframe.html | 12 +- JavaDoc/constant-values.html | 4 +- JavaDoc/deprecated-list.html | 4 +- JavaDoc/help-doc.html | 4 +- JavaDoc/index-files/index-1.html | 49 +- JavaDoc/index-files/index-10.html | 162 +++ JavaDoc/index-files/index-11.html | 156 +++ JavaDoc/index-files/index-2.html | 58 +- JavaDoc/index-files/index-3.html | 59 +- JavaDoc/index-files/index-4.html | 130 +- JavaDoc/index-files/index-5.html | 23 +- JavaDoc/index-files/index-6.html | 35 +- JavaDoc/index-files/index-7.html | 34 +- JavaDoc/index-files/index-8.html | 64 +- JavaDoc/index-files/index-9.html | 37 +- JavaDoc/index.html | 2 +- .../ArrayConstructorAndArgsLocator.html | 372 ++++++ .../org/ObjectLayout/ConstructorAndArgs.html | 8 +- .../ConstructorAndArgsLocator.html | 22 +- .../CopyConstructorAndArgsLocator.html | 36 +- .../FixedConstructorAndArgsLocator.html | 46 +- ...ensionalCopyConstructorAndArgsLocator.html | 399 +++++++ ...onalStructuredArray.StructureIterator.html | 359 ++++++ .../MultiDimensionalStructuredArray.html | 1060 +++++++++++++++++ .../StructuredArray.StructureIterator.html | 4 +- JavaDoc/org/ObjectLayout/StructuredArray.html | 92 +- JavaDoc/org/ObjectLayout/package-frame.html | 10 +- JavaDoc/org/ObjectLayout/package-summary.html | 18 +- JavaDoc/org/ObjectLayout/package-tree.html | 8 +- JavaDoc/overview-tree.html | 8 +- 31 files changed, 3019 insertions(+), 268 deletions(-) create mode 100644 JavaDoc/index-files/index-10.html create mode 100644 JavaDoc/index-files/index-11.html create mode 100644 JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html create mode 100644 JavaDoc/org/ObjectLayout/MulitDimensionalCopyConstructorAndArgsLocator.html create mode 100644 JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html create mode 100644 JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html diff --git a/JavaDoc/allclasses-frame.html b/JavaDoc/allclasses-frame.html index bc46e7e..5817525 100644 --- a/JavaDoc/allclasses-frame.html +++ b/JavaDoc/allclasses-frame.html @@ -2,12 +2,12 @@ - + All Classes - + @@ -21,7 +21,9 @@ - diff --git a/JavaDoc/allclasses-noframe.html b/JavaDoc/allclasses-noframe.html index b315ecf..db1089a 100644 --- a/JavaDoc/allclasses-noframe.html +++ b/JavaDoc/allclasses-noframe.html @@ -2,12 +2,12 @@ - + All Classes - + @@ -21,7 +21,9 @@
ConstructorAndArgs +ArrayConstructorAndArgsLocator +
+ConstructorAndArgs
ConstructorAndArgsLocator
@@ -29,6 +31,10 @@
FixedConstructorAndArgsLocator
+MulitDimensionalCopyConstructorAndArgsLocator +
+MultiDimensionalStructuredArray +
StructuredArray
- diff --git a/JavaDoc/constant-values.html b/JavaDoc/constant-values.html index 4eac6fe..743bf97 100644 --- a/JavaDoc/constant-values.html +++ b/JavaDoc/constant-values.html @@ -2,12 +2,12 @@ - + Constant Field Values - + diff --git a/JavaDoc/deprecated-list.html b/JavaDoc/deprecated-list.html index 74df6c3..3d15d44 100644 --- a/JavaDoc/deprecated-list.html +++ b/JavaDoc/deprecated-list.html @@ -2,12 +2,12 @@ - + Deprecated List - + diff --git a/JavaDoc/help-doc.html b/JavaDoc/help-doc.html index 5808379..bd9cb27 100644 --- a/JavaDoc/help-doc.html +++ b/JavaDoc/help-doc.html @@ -2,12 +2,12 @@ - + API Help - + diff --git a/JavaDoc/index-files/index-1.html b/JavaDoc/index-files/index-1.html index d42a138..f7d7a3a 100644 --- a/JavaDoc/index-files/index-1.html +++ b/JavaDoc/index-files/index-1.html @@ -2,12 +2,12 @@ - + -C-Index +A-Index - + @@ -15,7 +15,7 @@ function windowTitle() { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="C-Index"; + parent.document.title="A-Index"; } } @@ -76,36 +76,17 @@ -CFGHINORS
-

-C

+ACFGHIMNORS
+

+A

-
ConstructorAndArgs<T> - Class in org.ObjectLayout
Captures a specific constructor and arguments to be passed to it.
ConstructorAndArgs(Constructor<T>, Object[]) - -Constructor for class org.ObjectLayout.ConstructorAndArgs -
Create a ConstructorAndArgs instance. -
ConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports a general element construction API for StructuredArray by providing specific constructor - and arguments factory to used for constructing individual array elements during array creation.
ConstructorAndArgsLocator(Class<T>) - -Constructor for class org.ObjectLayout.ConstructorAndArgsLocator -
Used to apply a fixed constructor with a given set of arguments to all element. -
CopyConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports the construction of a new array's individual elements using a copy constructor to copy a source - array's corresponding elements.
CopyConstructorAndArgsLocator(Class<T>, StructuredArray<T>) - -Constructor for class org.ObjectLayout.CopyConstructorAndArgsLocator -
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a - source array -
CopyConstructorAndArgsLocator(Class<T>, StructuredArray<T>, long) - -Constructor for class org.ObjectLayout.CopyConstructorAndArgsLocator -
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a - source array, starting at a given offset -
CopyConstructorAndArgsLocator(Class<T>, StructuredArray<T>, long, boolean) - -Constructor for class org.ObjectLayout.CopyConstructorAndArgsLocator -
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a - source array, starting at a given offset -
copyInstance(StructuredArray<T>) - -Static method in class org.ObjectLayout.StructuredArray -
Copy an array of elements to a newly created array. -
copyInstance(StructuredArray<T>, long, long) - -Static method in class org.ObjectLayout.StructuredArray -
Copy a range from an array of elements to a newly created array. +
ArrayConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports the construction of a new array's individual elements using a copy constructor to copy a source + array's corresponding elements.
ArrayConstructorAndArgsLocator(Constructor<T>, Object[], int) - +Constructor for class org.ObjectLayout.ArrayConstructorAndArgsLocator +
Used to apply a fixed constructor with a given set of arguments to all elements. +
ArrayConstructorAndArgsLocator(Constructor<T>, Object[], int, boolean) - +Constructor for class org.ObjectLayout.ArrayConstructorAndArgsLocator +
Used to apply a fixed constructor with a given set of arguments to all elements.

@@ -158,7 +139,7 @@ -CFGHINORS
+ACFGHIMNORS
diff --git a/JavaDoc/index-files/index-10.html b/JavaDoc/index-files/index-10.html new file mode 100644 index 0000000..555c720 --- /dev/null +++ b/JavaDoc/index-files/index-10.html @@ -0,0 +1,162 @@ + + + + + + +R-Index + + + + + + + + + + + + +
+ + + + + +
ConstructorAndArgs +ArrayConstructorAndArgsLocator +
+ConstructorAndArgs
ConstructorAndArgsLocator
@@ -29,6 +31,10 @@
FixedConstructorAndArgsLocator
+MulitDimensionalCopyConstructorAndArgsLocator +
+MultiDimensionalStructuredArray +
StructuredArray
+ + + + + + + + + +
+ +
+ + + +A C F G H I M N O R S


+

+R

+
+
recycle(ConstructorAndArgs) - +Method in class org.ObjectLayout.ArrayConstructorAndArgsLocator +
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired). +
recycle(ConstructorAndArgs) - +Method in class org.ObjectLayout.ConstructorAndArgsLocator +
Recycle a ConstructorAndArgs instance (place it back in the internal cache if desired). +
recycle(ConstructorAndArgs) - +Method in class org.ObjectLayout.CopyConstructorAndArgsLocator +
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired). +
recycle(ConstructorAndArgs) - +Method in class org.ObjectLayout.MulitDimensionalCopyConstructorAndArgsLocator +
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired). +
remove() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator +
Remove operation is not supported on MultiDimensionalStructuredArrays. +
remove() - +Method in class org.ObjectLayout.StructuredArray.StructureIterator +
Remove operation is not supported on StructuredArrays. +
reset() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator +
Reset to the beginning of the collection enabling reuse of the iterator. +
reset() - +Method in class org.ObjectLayout.StructuredArray.StructureIterator +
Reset to the beginning of the collection enabling reuse of the iterator. +
+
+ + + + + + + + + + + + + + + +
+ +
+ + + +A C F G H I M N O R S
+ + + diff --git a/JavaDoc/index-files/index-11.html b/JavaDoc/index-files/index-11.html new file mode 100644 index 0000000..cf52102 --- /dev/null +++ b/JavaDoc/index-files/index-11.html @@ -0,0 +1,156 @@ + + + + + + +S-Index + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + +
+ +
+ + + +A C F G H I M N O R S
+

+S

+
+
setConstructor(Constructor<T>) - +Method in class org.ObjectLayout.ConstructorAndArgs +
Set the constructor to be indicated in this ConstructorAndArgs. +
setConstructorArgs(Object[]) - +Method in class org.ObjectLayout.ConstructorAndArgs +
Set the constructor arguments to be indicated in this ConstructorAndArgs. +
shallowCopy(StructuredArray, long, StructuredArray, long, long) - +Static method in class org.ObjectLayout.StructuredArray +
Shallow copy a region of element object contents from one array to the other. +
shallowCopy(StructuredArray, long, StructuredArray, long, long, boolean) - +Static method in class org.ObjectLayout.StructuredArray +
Shallow copy a region of element object contents from one array to the other. +
StructuredArray<T> - Class in org.ObjectLayout
An array of (potentially) mutable but non-replaceable objects.
StructuredArray(ConstructorAndArgsLocator<T>, long, long[]) - +Constructor for class org.ObjectLayout.StructuredArray +
  +
StructuredArray.StructureIterator - Class in org.ObjectLayout
Specialised Iterator with the ability to be reset() enabling reuse.
StructuredArray.StructureIterator() - +Constructor for class org.ObjectLayout.StructuredArray.StructureIterator +
  +
+
+ + + + + + + + + + + + + + + +
+ +
+ + + +A C F G H I M N O R S
+ + + diff --git a/JavaDoc/index-files/index-2.html b/JavaDoc/index-files/index-2.html index dffd38d..7d4fd0b 100644 --- a/JavaDoc/index-files/index-2.html +++ b/JavaDoc/index-files/index-2.html @@ -2,12 +2,12 @@ - + -F-Index +C-Index - + @@ -15,7 +15,7 @@ function windowTitle() { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="F-Index"; + parent.document.title="C-Index"; } } @@ -76,17 +76,45 @@ -C F G H I N O R S
-

-F

+A C F G H I M N O R S
+

+C

-
FixedConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports a fixed (cached) constructor and set of arguments for either default construction or construction - with a given fixed set of arguments (repeated for all indices)
FixedConstructorAndArgsLocator(Class<T>) - -Constructor for class org.ObjectLayout.FixedConstructorAndArgsLocator -
Used to apply default constructor to all elements. -
FixedConstructorAndArgsLocator(Class<T>, Class[], Object[]) - -Constructor for class org.ObjectLayout.FixedConstructorAndArgsLocator -
Used to apply a fixed constructor with a given set of arguments to all elements. +
ConstructorAndArgs<T> - Class in org.ObjectLayout
Captures a specific constructor and arguments to be passed to it.
ConstructorAndArgs(Constructor<T>, Object[]) - +Constructor for class org.ObjectLayout.ConstructorAndArgs +
Create a ConstructorAndArgs instance. +
ConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports a general element construction API for StructuredArray by providing specific constructor + and arguments factory to used for constructing individual array elements during array creation.
ConstructorAndArgsLocator(Class<T>) - +Constructor for class org.ObjectLayout.ConstructorAndArgsLocator +
Used to apply a fixed constructor with a given set of arguments to all element. +
CopyConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports the construction of a new array's individual elements using a copy constructor to copy a source + array's corresponding elements.
CopyConstructorAndArgsLocator(Class<T>, StructuredArray<T>) - +Constructor for class org.ObjectLayout.CopyConstructorAndArgsLocator +
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array +
CopyConstructorAndArgsLocator(Class<T>, StructuredArray<T>, long) - +Constructor for class org.ObjectLayout.CopyConstructorAndArgsLocator +
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +
CopyConstructorAndArgsLocator(Class<T>, StructuredArray<T>, long, boolean) - +Constructor for class org.ObjectLayout.CopyConstructorAndArgsLocator +
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +
copyInstance(MultiDimensionalStructuredArray<T>) - +Static method in class org.ObjectLayout.MultiDimensionalStructuredArray +
Copy an array of elements to a newly created array. +
copyInstance(MultiDimensionalStructuredArray<T>, long[], Long...) - +Static method in class org.ObjectLayout.MultiDimensionalStructuredArray +
Copy a range from an array of elements to a newly created array. +
copyInstance(MultiDimensionalStructuredArray<T>, long[], long[]) - +Static method in class org.ObjectLayout.MultiDimensionalStructuredArray +
Copy a range from an array of elements to a newly created array. +
copyInstance(StructuredArray<T>) - +Static method in class org.ObjectLayout.StructuredArray +
Copy an array of elements to a newly created array. +
copyInstance(StructuredArray<T>, long, long) - +Static method in class org.ObjectLayout.StructuredArray +
Copy a range from an array of elements to a newly created array.

@@ -139,7 +167,7 @@ -C F G H I N O R S
+A C F G H I M N O R S
diff --git a/JavaDoc/index-files/index-3.html b/JavaDoc/index-files/index-3.html index 84c1565..dd8ab28 100644 --- a/JavaDoc/index-files/index-3.html +++ b/JavaDoc/index-files/index-3.html @@ -2,12 +2,12 @@ - + -G-Index +F-Index - + @@ -15,7 +15,7 @@ function windowTitle() { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="G-Index"; + parent.document.title="F-Index"; } } @@ -76,43 +76,20 @@ -C F G H I N O R S
-

-G

+A C F G H I M N O R S
+

+F

-
get(int) - -Method in class org.ObjectLayout.StructuredArray -
Get a reference to an element in the array, using an int index. -
getConstructor() - -Method in class org.ObjectLayout.ConstructorAndArgs -
  -
getConstructorArgs() - -Method in class org.ObjectLayout.ConstructorAndArgs -
  -
getElementClass() - -Method in class org.ObjectLayout.ConstructorAndArgsLocator -
Get the Class of the elements to be constructed -
getElementClass() - -Method in class org.ObjectLayout.StructuredArray -
Get the Class of elements stored in the array. -
getForIndex(long) - -Method in class org.ObjectLayout.ConstructorAndArgsLocator -
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray -
getForIndex(long) - -Method in class org.ObjectLayout.CopyConstructorAndArgsLocator -
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray. -
getForIndex(long) - -Method in class org.ObjectLayout.FixedConstructorAndArgsLocator -
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray. -
getL(long) - -Method in class org.ObjectLayout.StructuredArray -
Get a reference to an element in the array, using a long index. -
getLength() - -Method in class org.ObjectLayout.StructuredArray -
Get the length (number of elements) of the array. +
FixedConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports a fixed (cached) constructor and set of arguments for either default construction or construction + with a given fixed set of arguments (repeated for all indices)
FixedConstructorAndArgsLocator(Class<T>) - +Constructor for class org.ObjectLayout.FixedConstructorAndArgsLocator +
Used to apply default constructor to all elements. +
FixedConstructorAndArgsLocator(Class<T>, Class[], Object[]) - +Constructor for class org.ObjectLayout.FixedConstructorAndArgsLocator +
Used to apply a fixed constructor with a given set of arguments to all elements. +
FixedConstructorAndArgsLocator(Constructor<T>, Object[]) - +Constructor for class org.ObjectLayout.FixedConstructorAndArgsLocator +
Used to apply a fixed constructor with a given set of arguments to all elements.

@@ -165,7 +142,7 @@ -C F G H I N O R S
+A C F G H I M N O R S
diff --git a/JavaDoc/index-files/index-4.html b/JavaDoc/index-files/index-4.html index ca273e6..686973d 100644 --- a/JavaDoc/index-files/index-4.html +++ b/JavaDoc/index-files/index-4.html @@ -2,12 +2,12 @@ - + -H-Index +G-Index - + @@ -15,7 +15,7 @@ function windowTitle() { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="H-Index"; + parent.document.title="G-Index"; } } @@ -76,13 +76,121 @@ -C F G H I N O R S
-

-H

+A C F G H I M N O R S
+

+G

-
hasNext() - -Method in class org.ObjectLayout.StructuredArray.StructureIterator -
+
get(Integer...) - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
Get a reference to an element in the array, using a varargs int indexes. +
get(int, int) - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
  +
get(int, int, int) - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
  +
get(int, int, int, int) - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
  +
get(int) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using an int index. +
getConstructor() - +Method in class org.ObjectLayout.ConstructorAndArgs +
  +
getConstructorArgs() - +Method in class org.ObjectLayout.ConstructorAndArgs +
  +
getCursors() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator +
  +
getElementClass() - +Method in class org.ObjectLayout.ConstructorAndArgsLocator +
Get the Class of the elements to be constructed +
getElementClass() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
Get the Class of elements stored in the array. +
getElementClass() - +Method in class org.ObjectLayout.StructuredArray +
Get the Class of elements stored in the array. +
getForIndex(long) - +Method in class org.ObjectLayout.ArrayConstructorAndArgsLocator +
Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray. +
getForIndex(long) - +Method in class org.ObjectLayout.CopyConstructorAndArgsLocator +
Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray. +
getForIndex(long) - +Method in class org.ObjectLayout.MulitDimensionalCopyConstructorAndArgsLocator +
Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray. +
getForIndexes(long[]) - +Method in class org.ObjectLayout.ArrayConstructorAndArgsLocator +
  +
getForIndexes(long[]) - +Method in class org.ObjectLayout.ConstructorAndArgsLocator +
Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray +
getForIndexes(long[]) - +Method in class org.ObjectLayout.CopyConstructorAndArgsLocator +
  +
getForIndexes(long[]) - +Method in class org.ObjectLayout.FixedConstructorAndArgsLocator +
Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray. +
getForIndexes(long[]) - +Method in class org.ObjectLayout.MulitDimensionalCopyConstructorAndArgsLocator +
  +
getL(long[]) - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
Get a reference to an element in the array, using a long[] index array. +
getL(long[], int) - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
Get a reference to an element in the array, using a long indexes supplied in an array + and indicating a strating point in the array at which the first index should be found. +
getL(Long...) - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
Get a reference to an element in the array, using a varargs long indexes. +
getL(long, long) - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
  +
getL(long, long, long) - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
  +
getL(long, long, long, long) - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
  +
getL(long) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using a long index. +
getLength() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
Get the length (number of elements) of the array. +
getLength() - +Method in class org.ObjectLayout.StructuredArray +
Get the length (number of elements) of the array. +
getLengths() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
Get the lengths (number of elements per dimension) of the array. +
getNumOfDimensions() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
Get the number of dimensions of the array. +
getOfDimensionalStructuredArray(int) - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
  +
getOfMultiDimensionalStructuredArrayL(long) - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
  +
getOfStructuredArray(int) - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
  +
getOfStructuredArrayL(long) - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
  +
getTotalElementCount() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
Get the total number of elements (in all dimensions combined) in this multi-dimensional array.

@@ -135,7 +243,7 @@ -C F G H I N O R S
+A C F G H I M N O R S
diff --git a/JavaDoc/index-files/index-5.html b/JavaDoc/index-files/index-5.html index 70c1982..63d7119 100644 --- a/JavaDoc/index-files/index-5.html +++ b/JavaDoc/index-files/index-5.html @@ -2,12 +2,12 @@ - + -I-Index +H-Index - + @@ -15,7 +15,7 @@ function windowTitle() { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="I-Index"; + parent.document.title="H-Index"; } } @@ -76,12 +76,15 @@ -C F G H I N O R S
-

-I

+A C F G H I M N O R S
+

+H

-
iterator() - -Method in class org.ObjectLayout.StructuredArray +
hasNext() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator +
+
hasNext() - +Method in class org.ObjectLayout.StructuredArray.StructureIterator

@@ -135,7 +138,7 @@ -C F G H I N O R S
+A C F G H I M N O R S
diff --git a/JavaDoc/index-files/index-6.html b/JavaDoc/index-files/index-6.html index 0fc70c8..ed9c637 100644 --- a/JavaDoc/index-files/index-6.html +++ b/JavaDoc/index-files/index-6.html @@ -2,12 +2,12 @@ - + -N-Index +I-Index - + @@ -15,7 +15,7 @@ function windowTitle() { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="N-Index"; + parent.document.title="I-Index"; } } @@ -76,24 +76,15 @@ -C F G H I N O R S
-

-N

+A C F G H I M N O R S
+

+I

-
newInstance(long, Class<T>) - -Static method in class org.ObjectLayout.StructuredArray -
Create an array of length elements, each containing an element object of - type elementClass. -
newInstance(long, Class<T>, ConstructorAndArgsLocator<T>) - -Static method in class org.ObjectLayout.StructuredArray -
Create an array of length elements, each containing an element object of - type elementClass. -
newInstance(long, Class<T>, Class[], Object...) - -Static method in class org.ObjectLayout.StructuredArray -
Create an array of length elements, each containing an element object of - type elementClass. -
next() - -Method in class org.ObjectLayout.StructuredArray.StructureIterator +
iterator() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
+
iterator() - +Method in class org.ObjectLayout.StructuredArray

@@ -147,7 +138,7 @@ -C F G H I N O R S
+A C F G H I M N O R S
diff --git a/JavaDoc/index-files/index-7.html b/JavaDoc/index-files/index-7.html index fdca159..f859936 100644 --- a/JavaDoc/index-files/index-7.html +++ b/JavaDoc/index-files/index-7.html @@ -2,12 +2,12 @@ - + -O-Index +M-Index - + @@ -15,7 +15,7 @@ function windowTitle() { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="O-Index"; + parent.document.title="M-Index"; } } @@ -76,11 +76,27 @@ -C F G H I N O R S
-

-O

+A C F G H I M N O R S
+

+M

-
org.ObjectLayout - package org.ObjectLayout
ObjectLayout: An optimised memory layout package.
+
MulitDimensionalCopyConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports the construction of a new array's individual elements using a copy constructor to copy a source + array's corresponding elements.
MulitDimensionalCopyConstructorAndArgsLocator(Class<T>, MultiDimensionalStructuredArray<T>) - +Constructor for class org.ObjectLayout.MulitDimensionalCopyConstructorAndArgsLocator +
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array +
MulitDimensionalCopyConstructorAndArgsLocator(Class<T>, MultiDimensionalStructuredArray<T>, long[]) - +Constructor for class org.ObjectLayout.MulitDimensionalCopyConstructorAndArgsLocator +
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +
MulitDimensionalCopyConstructorAndArgsLocator(Class<T>, MultiDimensionalStructuredArray<T>, long[], boolean) - +Constructor for class org.ObjectLayout.MulitDimensionalCopyConstructorAndArgsLocator +
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +
MultiDimensionalStructuredArray<T> - Class in org.ObjectLayout
An array of (potentially) mutable but non-replaceable objects.
MultiDimensionalStructuredArray.StructureIterator - Class in org.ObjectLayout
Specialised Iterator with the ability to be MultiDimensionalStructuredArray.StructureIterator.reset() enabling reuse.
MultiDimensionalStructuredArray.StructureIterator() - +Constructor for class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator +
  +


@@ -132,7 +148,7 @@ -C F G H I N O R S
+A C F G H I M N O R S
diff --git a/JavaDoc/index-files/index-8.html b/JavaDoc/index-files/index-8.html index 108b2c9..1a3f205 100644 --- a/JavaDoc/index-files/index-8.html +++ b/JavaDoc/index-files/index-8.html @@ -2,12 +2,12 @@ - + -R-Index +N-Index - + @@ -15,7 +15,7 @@ function windowTitle() { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="R-Index"; + parent.document.title="N-Index"; } } @@ -76,22 +76,48 @@ -C F G H I N O R S
-

-R

+A C F G H I M N O R S
+

+N

-
recycle(ConstructorAndArgs) - -Method in class org.ObjectLayout.ConstructorAndArgsLocator -
Recycle a ConstructorAndArgs instance (place it back in the internal cache if desired). -
recycle(ConstructorAndArgs) - -Method in class org.ObjectLayout.CopyConstructorAndArgsLocator -
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired). -
remove() - +
newInstance(Class<T>, Long...) - +Static method in class org.ObjectLayout.MultiDimensionalStructuredArray +
Create an array of length elements, each containing an element object of + type elementClass. +
newInstance(Class<T>, long[]) - +Static method in class org.ObjectLayout.MultiDimensionalStructuredArray +
Create an array of length elements, each containing an element object of + type elementClass. +
newInstance(Class<T>, long[], Class[], Object...) - +Static method in class org.ObjectLayout.MultiDimensionalStructuredArray +
Create an array of length elements, each containing an element object of + type elementClass. +
newInstance(ConstructorAndArgsLocator<T>, Long...) - +Static method in class org.ObjectLayout.MultiDimensionalStructuredArray +
Create an array of length elements, each containing an element object of + type elementClass. +
newInstance(ConstructorAndArgsLocator<T>, long[]) - +Static method in class org.ObjectLayout.MultiDimensionalStructuredArray +
Create an array of length elements, each containing an element object of + type elementClass. +
newInstance(Class<T>, long) - +Static method in class org.ObjectLayout.StructuredArray +
Create an array of length elements, each containing an element object of + type elementClass. +
newInstance(ConstructorAndArgsLocator<T>, long) - +Static method in class org.ObjectLayout.StructuredArray +
Create an array of length elements, each containing an element object of + type elementClass. +
newInstance(Class<T>, long, Class[], Object...) - +Static method in class org.ObjectLayout.StructuredArray +
Create an array of length elements, each containing an element object of + type elementClass. +
next() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator +
+
next() - Method in class org.ObjectLayout.StructuredArray.StructureIterator -
Remove operation is not supported on StructuredArrays. -
reset() - -Method in class org.ObjectLayout.StructuredArray.StructureIterator -
Reset to the beginning of the collection enabling reuse of the iterator. +

@@ -144,7 +170,7 @@ -C F G H I N O R S
+A C F G H I M N O R S
diff --git a/JavaDoc/index-files/index-9.html b/JavaDoc/index-files/index-9.html index f24ed44..35bf3f8 100644 --- a/JavaDoc/index-files/index-9.html +++ b/JavaDoc/index-files/index-9.html @@ -2,12 +2,12 @@ - + -S-Index +O-Index - + @@ -15,7 +15,7 @@ function windowTitle() { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="S-Index"; + parent.document.title="O-Index"; } } @@ -54,7 +54,7 @@  PREV LETTER  - NEXT LETTERNEXT LETTER
FRAMES    NO FRAMES   @@ -76,26 +76,11 @@ -C F G H I N O R S
-

-S

+A C F G H I M N O R S
+

+O

-
setConstructor(Constructor<T>) - -Method in class org.ObjectLayout.ConstructorAndArgs -
Set the constructor to be indicated in this ConstructorAndArgs. -
setConstructorArgs(Object[]) - -Method in class org.ObjectLayout.ConstructorAndArgs -
Set the constructor arguments to be indicated in this ConstructorAndArgs. -
shallowCopy(StructuredArray, long, StructuredArray, long, long) - -Static method in class org.ObjectLayout.StructuredArray -
Shallow copy a region of element object contents from one array to the other. -
shallowCopy(StructuredArray, long, StructuredArray, long, long, boolean) - -Static method in class org.ObjectLayout.StructuredArray -
Shallow copy a region of element object contents from one array to the other. -
StructuredArray<T> - Class in org.ObjectLayout
An array of (potentially) mutable but non-replaceable objects.
StructuredArray.StructureIterator - Class in org.ObjectLayout
Specialised Iterator with the ability to be reset() enabling reuse.
StructuredArray.StructureIterator() - -Constructor for class org.ObjectLayout.StructuredArray.StructureIterator -
  -
+
org.ObjectLayout - package org.ObjectLayout
ObjectLayout: An optimised memory layout package.

@@ -125,7 +110,7 @@  PREV LETTER  - NEXT LETTERNEXT LETTER
FRAMES    NO FRAMES   @@ -147,7 +132,7 @@ -C F G H I N O R S
+A C F G H I M N O R S
diff --git a/JavaDoc/index.html b/JavaDoc/index.html index 54600d3..a2c9fbc 100644 --- a/JavaDoc/index.html +++ b/JavaDoc/index.html @@ -2,7 +2,7 @@ - + Generated Documentation (Untitled) diff --git a/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html new file mode 100644 index 0000000..de0b35c --- /dev/null +++ b/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html @@ -0,0 +1,372 @@ + + + + + + +ArrayConstructorAndArgsLocator + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class ArrayConstructorAndArgsLocator<T>

+
+java.lang.Object
+  extended by org.ObjectLayout.ConstructorAndArgsLocator<T>
+      extended by org.ObjectLayout.ArrayConstructorAndArgsLocator<T>
+
+
+
Type Parameters:
T - type of the element occupying each array slot
+
+
+
public class ArrayConstructorAndArgsLocator<T>
extends ConstructorAndArgsLocator<T>
+ + +

+Supports the construction of a new array's individual elements using a copy constructor to copy a source + array's corresponding elements. +

+ +

+


+ +

+ + + + + + + + + + + + + + +
+Constructor Summary
ArrayConstructorAndArgsLocator(java.lang.reflect.Constructor<T> constructor, + java.lang.Object[] args, + int containingIndexesIndexInArgs) + +
+          Used to apply a fixed constructor with a given set of arguments to all elements.
ArrayConstructorAndArgsLocator(java.lang.reflect.Constructor<T> constructor, + java.lang.Object[] args, + int containingIndexesIndexInArgs, + boolean keepInternalCachingThreadSafe) + +
+          Used to apply a fixed constructor with a given set of arguments to all elements.
+  + + + + + + + + + + + + + + + + + + + +
+Method Summary
+ ConstructorAndArgs<T>getForIndex(long index) + +
+          Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray.
+ ConstructorAndArgs<T>getForIndexes(long[] indexes) + +
+          Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray
+ voidrecycle(ConstructorAndArgs constructorAndArgs) + +
+          Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired).
+ + + + + + + +
Methods inherited from class org.ObjectLayout.ConstructorAndArgsLocator
getElementClass
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+ArrayConstructorAndArgsLocator

+
+public ArrayConstructorAndArgsLocator(java.lang.reflect.Constructor<T> constructor,
+                                      java.lang.Object[] args,
+                                      int containingIndexesIndexInArgs)
+                               throws java.lang.NoSuchMethodException
+
+
Used to apply a fixed constructor with a given set of arguments to all elements. +

+

+
Parameters:
constructor - The element constructor
args - The arguments to be passed to the constructor for all elements +
Throws: +
java.lang.NoSuchMethodException - if a constructor matching argTypes +
java.lang.IllegalArgumentException - if argTypes and args conflict
+
+
+ +

+ArrayConstructorAndArgsLocator

+
+public ArrayConstructorAndArgsLocator(java.lang.reflect.Constructor<T> constructor,
+                                      java.lang.Object[] args,
+                                      int containingIndexesIndexInArgs,
+                                      boolean keepInternalCachingThreadSafe)
+                               throws java.lang.NoSuchMethodException
+
+
Used to apply a fixed constructor with a given set of arguments to all elements. +

+

+
Parameters:
constructor - The element constructor
args - The arguments to be passed to the constructor for all elements
keepInternalCachingThreadSafe - Control whether or not internal caching is kept thread-safe +
Throws: +
java.lang.NoSuchMethodException - if a constructor matching argTypes +
java.lang.IllegalArgumentException - if argTypes and args conflict
+
+ + + + + + + + +
+Method Detail
+ +

+getForIndex

+
+public ConstructorAndArgs<T> getForIndex(long index)
+                                  throws java.lang.NoSuchMethodException
+
+
Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray. . +

+

+
Parameters:
index - The index of the element to be constructed in the target array +
Returns:
ConstructorAndArgs instance to used in element construction +
Throws: +
java.lang.NoSuchMethodException - if expected constructor is not found in element class
+
+
+
+ +

+getForIndexes

+
+public ConstructorAndArgs<T> getForIndexes(long[] indexes)
+                                    throws java.lang.NoSuchMethodException
+
+
Description copied from class: ConstructorAndArgsLocator
+
Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray +

+

+
Overrides:
getForIndexes in class ConstructorAndArgsLocator<T>
+
+
+
Parameters:
indexes - The indexes of the element to be constructed in the target array +
Returns:
ConstructorAndArgs instance to used in element construction +
Throws: +
java.lang.NoSuchMethodException - if expected constructor is not found in element class
+
+
+
+ +

+recycle

+
+public void recycle(ConstructorAndArgs constructorAndArgs)
+
+
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired). This is [very] + useful for avoiding a re-allocation of a new ConstructorAndArgs and an associated args array for + getForIndex(long) invocation in cases such as this (where the returned ConstructorAndArgs + is not constant across indices). + Recycling is optional, and is not guaranteed to occur. +

+

+
Overrides:
recycle in class ConstructorAndArgsLocator<T>
+
+
+
Parameters:
constructorAndArgs - the ConstructorAndArgs instance to recycle
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html b/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html index f630b69..22b22d7 100644 --- a/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html +++ b/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html @@ -2,12 +2,12 @@ - + ConstructorAndArgs - + @@ -53,7 +53,7 @@ - PREV CLASS  + PREV CLASS   NEXT CLASS FRAMES   @@ -294,7 +294,7 @@

- PREV CLASS  + PREV CLASS   NEXT CLASS FRAMES   diff --git a/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html index 3e40fe0..93f1449 100644 --- a/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + ConstructorAndArgsLocator - + @@ -96,7 +96,7 @@

Type Parameters:
T - type of the element occupying each array slot.
-
Direct Known Subclasses:
CopyConstructorAndArgsLocator, FixedConstructorAndArgsLocator
+
Direct Known Subclasses:
ArrayConstructorAndArgsLocator, CopyConstructorAndArgsLocator, FixedConstructorAndArgsLocator, MulitDimensionalCopyConstructorAndArgsLocator

@@ -151,8 +151,8 @@

-abstract  ConstructorAndArgs<T> -getForIndex(long index) + ConstructorAndArgs<T> +getForIndexes(long[] indexes)
          Get a ConstructorAndArgs instance to be used in constructing a given element index in @@ -214,17 +214,17 @@

-

-getForIndex

+

+getForIndexes

-public abstract ConstructorAndArgs<T> getForIndex(long index)
-                                           throws java.lang.NoSuchMethodException
+public ConstructorAndArgs<T> getForIndexes(long[] indexes) + throws java.lang.NoSuchMethodException
Get a ConstructorAndArgs instance to be used in constructing a given element index in a StructuredArray

-
Parameters:
index - The index of the element to be constructed in the target array +
Parameters:
indexes - The indexes of the element to be constructed in the target array
Returns:
ConstructorAndArgs instance to used in element construction
Throws:
java.lang.NoSuchMethodException - if expected constructor is not found in element class
@@ -239,7 +239,7 @@

Recycle a ConstructorAndArgs instance (place it back in the internal cache if desired). This is [very] useful for avoiding a re-allocation of a new ConstructorAndArgs and an - associated args array for getForIndex(long) invocation in cases where + associated args array for getForIndexes(long[]) invocation in cases where the returned ConstructorAndArgs is not constant.

Recycling is optional, and is not guaranteed to occur. It will only be done if it is helpful. diff --git a/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html index ff5fb43..769b9ba 100644 --- a/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + CopyConstructorAndArgsLocator - + @@ -167,6 +167,15 @@

+ ConstructorAndArgs<T> +getForIndexes(long[] indexes) + +
+          Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray + + +  void recycle(ConstructorAndArgs constructorAndArgs) @@ -278,10 +287,29 @@

a StructuredArray. .

-
Specified by:
getForIndex in class ConstructorAndArgsLocator<T>
+
Parameters:
index - The index of the element to be constructed in the target array +
Returns:
ConstructorAndArgs instance to used in element construction +
Throws: +
java.lang.NoSuchMethodException - if expected constructor is not found in element class

+
+
+ +

+getForIndexes

+
+public ConstructorAndArgs<T> getForIndexes(long[] indexes)
+                                    throws java.lang.NoSuchMethodException
+
+
Description copied from class: ConstructorAndArgsLocator
+
Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray +

-
Parameters:
index - The index of the element to be constructed in the target array +
Overrides:
getForIndexes in class ConstructorAndArgsLocator<T>
+
+
+
Parameters:
indexes - The indexes of the element to be constructed in the target array
Returns:
ConstructorAndArgs instance to used in element construction
Throws:
java.lang.NoSuchMethodException - if expected constructor is not found in element class
diff --git a/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html index 699b394..31c1954 100644 --- a/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + FixedConstructorAndArgsLocator - + @@ -54,7 +54,7 @@  PREV CLASS  - NEXT CLASSNEXT CLASS
FRAMES    NO FRAMES   @@ -130,6 +130,13 @@

java.lang.Class[] argTypes, java.lang.Object[] args) +
+          Used to apply a fixed constructor with a given set of arguments to all elements. + + +FixedConstructorAndArgsLocator(java.lang.reflect.Constructor<T> constructor, + java.lang.Object[] args) +
          Used to apply a fixed constructor with a given set of arguments to all elements. @@ -146,7 +153,7 @@

 ConstructorAndArgs<T> -getForIndex(long index) +getForIndexes(long[] indexes)
          Get a ConstructorAndArgs instance to be used in constructing a given element index in @@ -215,6 +222,23 @@

java.lang.NoSuchMethodException - if a constructor matching argTypes
java.lang.IllegalArgumentException - if argTypes and args conflict

+
+ +

+FixedConstructorAndArgsLocator

+
+public FixedConstructorAndArgsLocator(java.lang.reflect.Constructor<T> constructor,
+                                      java.lang.Object[] args)
+                               throws java.lang.NoSuchMethodException
+
+
Used to apply a fixed constructor with a given set of arguments to all elements. +

+

+
Parameters:
constructor - The element constructor
args - The arguments to be passed to the constructor for all elements +
Throws: +
java.lang.NoSuchMethodException - if a constructor matching argTypes +
java.lang.IllegalArgumentException - if argTypes and args conflict
+
@@ -226,20 +250,20 @@

-

-getForIndex

+

+getForIndexes

-public ConstructorAndArgs<T> getForIndex(long index)
-                                  throws java.lang.NoSuchMethodException
+public ConstructorAndArgs<T> getForIndexes(long[] indexes) + throws java.lang.NoSuchMethodException
Get a ConstructorAndArgs instance to be used in constructing a given element index in a StructuredArray.

-
Specified by:
getForIndex in class ConstructorAndArgsLocator<T>
+
Overrides:
getForIndexes in class ConstructorAndArgsLocator<T>

-
Parameters:
index - of the element to be constructed in the target array +
Parameters:
indexes - of the element to be constructed in the target array
Returns:
ConstructorAndArgs instance to used in element construction
Throws:
java.lang.NoSuchMethodException - if expected constructor is not found in element class
@@ -275,7 +299,7 @@

 PREV CLASS  - NEXT CLASSNEXT CLASS FRAMES    NO FRAMES   diff --git a/JavaDoc/org/ObjectLayout/MulitDimensionalCopyConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/MulitDimensionalCopyConstructorAndArgsLocator.html new file mode 100644 index 0000000..781c39b --- /dev/null +++ b/JavaDoc/org/ObjectLayout/MulitDimensionalCopyConstructorAndArgsLocator.html @@ -0,0 +1,399 @@ + + + + + + +MulitDimensionalCopyConstructorAndArgsLocator + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class MulitDimensionalCopyConstructorAndArgsLocator<T>

+
+java.lang.Object
+  extended by org.ObjectLayout.ConstructorAndArgsLocator<T>
+      extended by org.ObjectLayout.MulitDimensionalCopyConstructorAndArgsLocator<T>
+
+
+
Type Parameters:
T - type of the element occupying each array slot
+
+
+
public class MulitDimensionalCopyConstructorAndArgsLocator<T>
extends ConstructorAndArgsLocator<T>
+ + +

+Supports the construction of a new array's individual elements using a copy constructor to copy a source + array's corresponding elements. +

+ +

+


+ +

+ + + + + + + + + + + + + + + + + +
+Constructor Summary
MulitDimensionalCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass, + MultiDimensionalStructuredArray<T> source) + +
+          Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array
MulitDimensionalCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass, + MultiDimensionalStructuredArray<T> source, + long[] sourceOffsets) + +
+          Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset
MulitDimensionalCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass, + MultiDimensionalStructuredArray<T> source, + long[] sourceOffsets, + boolean keepInternalCachingThreadSafe) + +
+          Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset
+  + + + + + + + + + + + + + + + + + + + +
+Method Summary
+ ConstructorAndArgs<T>getForIndex(long index) + +
+          Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray.
+ ConstructorAndArgs<T>getForIndexes(long[] indexes) + +
+          Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray
+ voidrecycle(ConstructorAndArgs constructorAndArgs) + +
+          Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired).
+ + + + + + + +
Methods inherited from class org.ObjectLayout.ConstructorAndArgsLocator
getElementClass
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+MulitDimensionalCopyConstructorAndArgsLocator

+
+public MulitDimensionalCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass,
+                                                     MultiDimensionalStructuredArray<T> source)
+                                              throws java.lang.NoSuchMethodException
+
+
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array +

+

+
Parameters:
elementClass - The class of the elements to be constructed
source - The source StructuredArray to copy from +
Throws: +
java.lang.NoSuchMethodException
+
+
+ +

+MulitDimensionalCopyConstructorAndArgsLocator

+
+public MulitDimensionalCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass,
+                                                     MultiDimensionalStructuredArray<T> source,
+                                                     long[] sourceOffsets)
+                                              throws java.lang.NoSuchMethodException
+
+
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +

+

+
Parameters:
elementClass - The class of the elements to be constructed
source - The source MultiDimensionalStructuredArray to copy from
sourceOffsets - The beginning index in the source from which to start copying +
Throws: +
java.lang.NoSuchMethodException - if a copy constructor is not found in element class
+
+
+ +

+MulitDimensionalCopyConstructorAndArgsLocator

+
+public MulitDimensionalCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass,
+                                                     MultiDimensionalStructuredArray<T> source,
+                                                     long[] sourceOffsets,
+                                                     boolean keepInternalCachingThreadSafe)
+                                              throws java.lang.NoSuchMethodException
+
+
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +

+

+
Parameters:
elementClass - The class of the elements to be constructed
source - The source MultiDimensionalStructuredArray to copy from
sourceOffsets - The beginning index in the source from which to start copying
keepInternalCachingThreadSafe - Control whether or not internal caching is kept thread-safe +
Throws: +
java.lang.NoSuchMethodException - NoSuchMethodException if a copy constructor is not found in element class
+
+ + + + + + + + +
+Method Detail
+ +

+getForIndex

+
+public ConstructorAndArgs<T> getForIndex(long index)
+                                  throws java.lang.NoSuchMethodException
+
+
Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray. . +

+

+
Parameters:
index - The index of the element to be constructed in the target array +
Returns:
ConstructorAndArgs instance to used in element construction +
Throws: +
java.lang.NoSuchMethodException - if expected constructor is not found in element class
+
+
+
+ +

+getForIndexes

+
+public ConstructorAndArgs<T> getForIndexes(long[] indexes)
+                                    throws java.lang.NoSuchMethodException
+
+
Description copied from class: ConstructorAndArgsLocator
+
Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray +

+

+
Overrides:
getForIndexes in class ConstructorAndArgsLocator<T>
+
+
+
Parameters:
indexes - The indexes of the element to be constructed in the target array +
Returns:
ConstructorAndArgs instance to used in element construction +
Throws: +
java.lang.NoSuchMethodException - if expected constructor is not found in element class
+
+
+
+ +

+recycle

+
+public void recycle(ConstructorAndArgs constructorAndArgs)
+
+
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired). This is [very] + useful for avoiding a re-allocation of a new ConstructorAndArgs and an associated args array for + getForIndex(long) invocation in cases such as this (where the returned ConstructorAndArgs + is not constant across indices). + Recycling is optional, and is not guaranteed to occur. +

+

+
Overrides:
recycle in class ConstructorAndArgsLocator<T>
+
+
+
Parameters:
constructorAndArgs - the ConstructorAndArgs instance to recycle
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html new file mode 100644 index 0000000..7313c8a --- /dev/null +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html @@ -0,0 +1,359 @@ + + + + + + +MultiDimensionalStructuredArray.StructureIterator + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class MultiDimensionalStructuredArray.StructureIterator

+
+java.lang.Object
+  extended by org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator
+
+
+
All Implemented Interfaces:
java.util.Iterator<T>
+
+
+
Enclosing class:
MultiDimensionalStructuredArray<T>
+
+
+
+
public class MultiDimensionalStructuredArray.StructureIterator
extends java.lang.Object
implements java.util.Iterator<T>
+ + +

+Specialised Iterator with the ability to be reset() enabling reuse. +

+ +

+


+ +

+ + + + + + + + + + + +
+Constructor Summary
MultiDimensionalStructuredArray.StructureIterator() + +
+           
+  + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+Method Summary
+ long[]getCursors() + +
+           
+ booleanhasNext() + +
+          
+ Tnext() + +
+          
+ voidremove() + +
+          Remove operation is not supported on MultiDimensionalStructuredArrays.
+ voidreset() + +
+          Reset to the beginning of the collection enabling reuse of the iterator.
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+MultiDimensionalStructuredArray.StructureIterator

+
+public MultiDimensionalStructuredArray.StructureIterator()
+
+
+ + + + + + + + +
+Method Detail
+ +

+hasNext

+
+public boolean hasNext()
+
+
+

+

+
Specified by:
hasNext in interface java.util.Iterator<T>
+
+
+
+
+
+
+ +

+next

+
+public T next()
+
+
+

+

+
Specified by:
next in interface java.util.Iterator<T>
+
+
+
+
+
+
+ +

+remove

+
+public void remove()
+
+
Remove operation is not supported on MultiDimensionalStructuredArrays. +

+

+
Specified by:
remove in interface java.util.Iterator<T>
+
+
+ +
Throws: +
java.lang.UnsupportedOperationException - if called.
+
+
+
+ +

+reset

+
+public void reset()
+
+
Reset to the beginning of the collection enabling reuse of the iterator. +

+

+
+
+
+
+
+
+
+ +

+getCursors

+
+public long[] getCursors()
+
+
+
+
+
+
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html new file mode 100644 index 0000000..e00307f --- /dev/null +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html @@ -0,0 +1,1060 @@ + + + + + + +MultiDimensionalStructuredArray + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class MultiDimensionalStructuredArray<T>

+
+java.lang.Object
+  extended by org.ObjectLayout.MultiDimensionalStructuredArray<T>
+
+
+
Type Parameters:
T - type of the element occupying each array slot.
+
+
All Implemented Interfaces:
java.lang.Iterable<T>
+
+
+
+
public final class MultiDimensionalStructuredArray<T>
extends java.lang.Object
implements java.lang.Iterable<T>
+ + +

+An array of (potentially) mutable but non-replaceable objects. +

+ A structured array contains array element objects of a fixed (at creation time, per array instance) class, + and can support elements of any class that provides public constructors. The elements in a StructuredArray + are all allocated and constructed at array creation time, and individual elements cannot be removed or + replaced after array creation. Array elements can be accessed using an index-based accessor methods in + the form of get(java.lang.Integer...)() (for int indices) or getL(long[])() + (for long indices). Individual element contents can then be accessed and manipulated using any and all + operations supported by the member element's class. +

+ While simple creation of default-constructed elements and fixed constructor parameters are available through + the newInstance factory methods, supporting arbitrary member types requires a wider range of construction + options. The ConstructorAndArgsLocator API provides for array creation with arbitrary, user-supplied + constructors and arguments, either of which can take the element index into account. +

+ StructuredArray is designed with semantics specifically restricted to be consistent with layouts of an + array of structures in C-like languages. While fully functional on all JVM implementation (of Java SE 5 + and above), the semantics are such that a JVM may transparently optimise the implementation to provide a + compact contiguous layout that facilitates consistent stride based memory access and dead-reckoning + (as opposed to de-referenced) access to elements +

+ Note: At least for some JVM implementations, get(java.lang.Integer...)() access may be faster than + getL(long[])() access. +

+ +

+


+ +

+ + + + + + + + + + + +
+Nested Class Summary
+ classMultiDimensionalStructuredArray.StructureIterator + +
+          Specialised Iterator with the ability to be MultiDimensionalStructuredArray.StructureIterator.reset() enabling reuse.
+  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+Method Summary
+static + + + + +
+<T> MultiDimensionalStructuredArray<T>
+
copyInstance(MultiDimensionalStructuredArray<T> source) + +
+          Copy an array of elements to a newly created array.
+static + + + + +
+<T> MultiDimensionalStructuredArray<T>
+
copyInstance(MultiDimensionalStructuredArray<T> source, + long[] sourceOffsets, + java.lang.Long... counts) + +
+          Copy a range from an array of elements to a newly created array.
+static + + + + +
+<T> MultiDimensionalStructuredArray<T>
+
copyInstance(MultiDimensionalStructuredArray<T> source, + long[] sourceOffsets, + long[] counts) + +
+          Copy a range from an array of elements to a newly created array.
+ Tget(java.lang.Integer... indexes) + +
+          Get a reference to an element in the array, using a varargs int indexes.
+ Tget(int index0, + int index1) + +
+           
+ Tget(int index0, + int index1, + int index2) + +
+           
+ Tget(int index0, + int index1, + int index2, + int index3) + +
+           
+ java.lang.Class<T>getElementClass() + +
+          Get the Class of elements stored in the array.
+ TgetL(java.lang.Long... indexes) + +
+          Get a reference to an element in the array, using a varargs long indexes.
+ TgetL(long[] indexes) + +
+          Get a reference to an element in the array, using a long[] index array.
+ TgetL(long[] indexes, + int indexOffset) + +
+          Get a reference to an element in the array, using a long indexes supplied in an array + and indicating a strating point in the array at which the first index should be found.
+ TgetL(long index0, + long index1) + +
+           
+ TgetL(long index0, + long index1, + long index2) + +
+           
+ TgetL(long index0, + long index1, + long index2, + long index3) + +
+           
+ longgetLength() + +
+          Get the length (number of elements) of the array.
+ long[]getLengths() + +
+          Get the lengths (number of elements per dimension) of the array.
+ intgetNumOfDimensions() + +
+          Get the number of dimensions of the array.
+ MultiDimensionalStructuredArray<T>getOfDimensionalStructuredArray(int index) + +
+           
+ MultiDimensionalStructuredArray<T>getOfMultiDimensionalStructuredArrayL(long index) + +
+           
+ StructuredArray<T>getOfStructuredArray(int index) + +
+           
+ StructuredArray<T>getOfStructuredArrayL(long index) + +
+           
+ longgetTotalElementCount() + +
+          Get the total number of elements (in all dimensions combined) in this multi-dimensional array.
+ MultiDimensionalStructuredArray.StructureIteratoriterator() + +
+          
+static + + + + +
+<T> MultiDimensionalStructuredArray<T>
+
newInstance(java.lang.Class<T> elementClass, + java.lang.Long... lengths) + +
+          Create an array of length elements, each containing an element object of + type elementClass.
+static + + + + +
+<T> MultiDimensionalStructuredArray<T>
+
newInstance(java.lang.Class<T> elementClass, + long[] lengths) + +
+          Create an array of length elements, each containing an element object of + type elementClass.
+static + + + + +
+<T> MultiDimensionalStructuredArray<T>
+
newInstance(java.lang.Class<T> elementClass, + long[] lengths, + java.lang.Class[] initArgTypes, + java.lang.Object... initArgs) + +
+          Create an array of length elements, each containing an element object of + type elementClass.
+static + + + + +
+<T> MultiDimensionalStructuredArray<T>
+
newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator, + java.lang.Long... lengths) + +
+          Create an array of length elements, each containing an element object of + type elementClass.
+static + + + + +
+<T> MultiDimensionalStructuredArray<T>
+
newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator, + long[] lengths) + +
+          Create an array of length elements, each containing an element object of + type elementClass.
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Method Detail
+ +

+newInstance

+
+public static <T> MultiDimensionalStructuredArray<T> newInstance(java.lang.Class<T> elementClass,
+                                                                 java.lang.Long... lengths)
+                                                      throws java.lang.NoSuchMethodException
+
+
Create an array of length elements, each containing an element object of + type elementClass. Using the elementClass's default constructor. +

+

+
+
+
+
Parameters:
elementClass - of each element in the array
lengths - of the array dimensions to create. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not not support a supplied constructor
+
+
+
+ +

+newInstance

+
+public static <T> MultiDimensionalStructuredArray<T> newInstance(java.lang.Class<T> elementClass,
+                                                                 long[] lengths)
+                                                      throws java.lang.NoSuchMethodException
+
+
Create an array of length elements, each containing an element object of + type elementClass. Using the elementClass's default constructor. +

+

+
+
+
+
Parameters:
elementClass - of each element in the array
lengths - of the array dimensions to create. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not not support a supplied constructor
+
+
+
+ +

+newInstance

+
+public static <T> MultiDimensionalStructuredArray<T> newInstance(java.lang.Class<T> elementClass,
+                                                                 long[] lengths,
+                                                                 java.lang.Class[] initArgTypes,
+                                                                 java.lang.Object... initArgs)
+                                                      throws java.lang.NoSuchMethodException
+
+
Create an array of length elements, each containing an element object of + type elementClass. Use a fixed (same for all elements) constructor identified by the argument + classes specified in initArgs to construct and initialize each element, passing the remaining + arguments to that constructor. +

+

+
+
+
+
Parameters:
elementClass - of each element in the array
lengths - of the array dimensions to create.
initArgTypes - for selecting the constructor to call for initialising each structure object.
initArgs - to be passed to a constructor for initialising each structure object. +
Throws: +
java.lang.IllegalArgumentException - if initArgTypes and constructor arguments do not match in length +
java.lang.NoSuchMethodException - if initArgTypes does not match a public constructor signature in elementClass
+
+
+
+ +

+newInstance

+
+public static <T> MultiDimensionalStructuredArray<T> newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator,
+                                                                 java.lang.Long... lengths)
+                                                      throws java.lang.NoSuchMethodException
+
+
Create an array of length elements, each containing an element object of + type elementClass. Use constructor and arguments supplied (on a potentially + per element index basis) by the specified constructorAndArgsLocator to construct and initialize + each element. +

+

+
+
+
+
Parameters:
constructorAndArgsLocator - produces element constructors [potentially] on a per element basis.
lengths - of the array dimensions to create. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not not support a supplied constructor
+
+
+
+ +

+newInstance

+
+public static <T> MultiDimensionalStructuredArray<T> newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator,
+                                                                 long[] lengths)
+                                                      throws java.lang.NoSuchMethodException
+
+
Create an array of length elements, each containing an element object of + type elementClass. Use constructor and arguments supplied (on a potentially + per element index basis) by the specified constructorAndArgsLocator to construct and initialize + each element. +

+

+
+
+
+
Parameters:
constructorAndArgsLocator - produces element constructors [potentially] on a per element basis.
lengths - of the array dimensions to create. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not not support a supplied constructor
+
+
+
+ +

+copyInstance

+
+public static <T> MultiDimensionalStructuredArray<T> copyInstance(MultiDimensionalStructuredArray<T> source)
+                                                       throws java.lang.NoSuchMethodException
+
+
Copy an array of elements to a newly created array. Copying of individual elements is done by using + the elementClass copy constructor to construct the individual member elements of the new + array based on the corresponding elements of the source array. +

+

+
+
+
+
Parameters:
source - The array to duplicate. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not have a public copy constructor.
+
+
+
+ +

+copyInstance

+
+public static <T> MultiDimensionalStructuredArray<T> copyInstance(MultiDimensionalStructuredArray<T> source,
+                                                                  long[] sourceOffsets,
+                                                                  java.lang.Long... counts)
+                                                       throws java.lang.NoSuchMethodException
+
+
Copy a range from an array of elements to a newly created array. Copying of individual elements is done + by using the elementClass copy constructor to construct the individual member elements of + the new array based on the corresponding elements of the source array. +

+

+
+
+
+
Parameters:
source - The array to duplicate.
sourceOffsets - offset indexes in source where the region to be copied begins.
counts - the number of elements in each dimension to copy. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not have a public copy constructor.
+
+
+
+ +

+copyInstance

+
+public static <T> MultiDimensionalStructuredArray<T> copyInstance(MultiDimensionalStructuredArray<T> source,
+                                                                  long[] sourceOffsets,
+                                                                  long[] counts)
+                                                       throws java.lang.NoSuchMethodException
+
+
Copy a range from an array of elements to a newly created array. Copying of individual elements is done + by using the elementClass copy constructor to construct the individual member elements of + the new array based on the corresponding elements of the source array. +

+

+
+
+
+
Parameters:
source - The array to duplicate.
sourceOffsets - offset indexes in source where the region to be copied begins.
counts - the number of elements in each dimension to copy. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not have a public copy constructor.
+
+
+
+ +

+getNumOfDimensions

+
+public int getNumOfDimensions()
+
+
Get the number of dimensions of the array. +

+

+
+
+
+ +
Returns:
the number of dimensions of the array.
+
+
+
+ +

+getLengths

+
+public long[] getLengths()
+
+
Get the lengths (number of elements per dimension) of the array. +

+

+
+
+
+ +
Returns:
the number of elements in each dimension in the array.
+
+
+
+ +

+getTotalElementCount

+
+public long getTotalElementCount()
+
+
Get the total number of elements (in all dimensions combined) in this multi-dimensional array. +

+

+
+
+
+ +
Returns:
the total number of elements (in all dimensions combined) in the array.
+
+
+
+ +

+getLength

+
+public long getLength()
+
+
Get the length (number of elements) of the array. +

+

+
+
+
+ +
Returns:
the number of elements in the array.
+
+
+
+ +

+getL

+
+public T getL(long[] indexes)
+
+
Get a reference to an element in the array, using a long[] index array. +

+

+
+
+
+
Parameters:
indexes - The indexes (at each dimension) of the element to retrieve. +
Returns:
a reference to the indexed element.
+
+
+
+ +

+getL

+
+public T getL(long[] indexes,
+              int indexOffset)
+
+
Get a reference to an element in the array, using a long indexes supplied in an array + and indicating a strating point in the array at which the first index should be found. + This form is useful when passing index arrays through multiple levels to avoid construction of + temporary varargs containers or construction of new shorter index arrays. +

+

+
+
+
+
Parameters:
indexes - The indexes (at each dimension) of the element to retrieve.
indexOffset - The beginiing offset in the indexes array related to this arrays contents. +
Returns:
a reference to the indexed element.
+
+
+
+ +

+getL

+
+public T getL(java.lang.Long... indexes)
+
+
Get a reference to an element in the array, using a varargs long indexes. +

+

+
+
+
+
Parameters:
indexes - The indexes (at each dimension) of the element to retrieve. +
Returns:
a reference to the indexed element.
+
+
+
+ +

+get

+
+public T get(java.lang.Integer... indexes)
+
+
Get a reference to an element in the array, using a varargs int indexes. +

+

+
+
+
+
Parameters:
indexes - The indexes (at each dimension) of the element to retrieve. +
Returns:
a reference to the indexed element.
+
+
+
+ +

+getL

+
+public T getL(long index0,
+              long index1)
+
+
+
+
+
+
+
+
+
+ +

+getL

+
+public T getL(long index0,
+              long index1,
+              long index2)
+
+
+
+
+
+
+
+
+
+ +

+getL

+
+public T getL(long index0,
+              long index1,
+              long index2,
+              long index3)
+
+
+
+
+
+
+
+
+
+ +

+get

+
+public T get(int index0,
+             int index1)
+
+
+
+
+
+
+
+
+
+ +

+get

+
+public T get(int index0,
+             int index1,
+             int index2)
+
+
+
+
+
+
+
+
+
+ +

+get

+
+public T get(int index0,
+             int index1,
+             int index2,
+             int index3)
+
+
+
+
+
+
+
+
+
+ +

+getOfStructuredArrayL

+
+public StructuredArray<T> getOfStructuredArrayL(long index)
+
+
+
+
+
+
+
+
+
+ +

+getOfMultiDimensionalStructuredArrayL

+
+public MultiDimensionalStructuredArray<T> getOfMultiDimensionalStructuredArrayL(long index)
+
+
+
+
+
+
+
+
+
+ +

+getOfStructuredArray

+
+public StructuredArray<T> getOfStructuredArray(int index)
+
+
+
+
+
+
+
+
+
+ +

+getOfDimensionalStructuredArray

+
+public MultiDimensionalStructuredArray<T> getOfDimensionalStructuredArray(int index)
+
+
+
+
+
+
+
+
+
+ +

+getElementClass

+
+public java.lang.Class<T> getElementClass()
+
+
Get the Class of elements stored in the array. +

+

+
+
+
+ +
Returns:
the Class of elements stored in the array.
+
+
+
+ +

+iterator

+
+public MultiDimensionalStructuredArray.StructureIterator iterator()
+
+
+

+

+
Specified by:
iterator in interface java.lang.Iterable<T>
+
+
+
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html b/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html index eddf1f0..da57205 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html +++ b/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html @@ -2,12 +2,12 @@ - + StructuredArray.StructureIterator - + diff --git a/JavaDoc/org/ObjectLayout/StructuredArray.html b/JavaDoc/org/ObjectLayout/StructuredArray.html index cc385b8..1950dc3 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArray.html +++ b/JavaDoc/org/ObjectLayout/StructuredArray.html @@ -2,12 +2,12 @@ - + StructuredArray - + @@ -53,7 +53,7 @@ PREV CLASS  + PREV CLASS   NEXT CLASS FRAMES   @@ -74,9 +74,9 @@ - SUMMARY: NESTED | FIELD | CONSTR | METHOD + SUMMARY: NESTED | FIELD | CONSTR | METHOD -DETAIL: FIELD | CONSTR | METHOD +DETAIL: FIELD | CONSTR | METHOD
@@ -151,6 +151,24 @@

  + + + + + + + + + + +
+Constructor Summary
StructuredArray(ConstructorAndArgsLocator<T> constructorAndArgsLocator, + long length, + long[] containingIndexes) + +
+           
@@ -241,8 +259,8 @@

-newInstance(long length, - java.lang.Class<T> elementClass) +newInstance(java.lang.Class<T> elementClass, + long length)
          Create an array of length elements, each containing an element object of @@ -258,8 +276,8 @@

-newInstance(long length, - java.lang.Class<T> elementClass, +newInstance(java.lang.Class<T> elementClass, + long length, java.lang.Class[] initArgTypes, java.lang.Object... initArgs) @@ -277,9 +295,8 @@

-newInstance(long length, - java.lang.Class<T> elementClass, - ConstructorAndArgsLocator<T> constructorAndArgsLocator) +newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator, + long length)
          Create an array of length elements, each containing an element object of @@ -323,6 +340,30 @@

 

+ + + + + + + +
+Constructor Detail
+ +

+StructuredArray

+
+public StructuredArray(ConstructorAndArgsLocator<T> constructorAndArgsLocator,
+                       long length,
+                       long[] containingIndexes)
+                throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+ @@ -333,11 +374,11 @@

-

+

newInstance

-public static <T> StructuredArray<T> newInstance(long length,
-                                                 java.lang.Class<T> elementClass)
+public static <T> StructuredArray<T> newInstance(java.lang.Class<T> elementClass,
+                                                 long length)
                                       throws java.lang.NoSuchMethodException
Create an array of length elements, each containing an element object of @@ -354,12 +395,11 @@


-

+

newInstance

-public static <T> StructuredArray<T> newInstance(long length,
-                                                 java.lang.Class<T> elementClass,
-                                                 ConstructorAndArgsLocator<T> constructorAndArgsLocator)
+public static <T> StructuredArray<T> newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator,
+                                                 long length)
                                       throws java.lang.NoSuchMethodException
Create an array of length elements, each containing an element object of @@ -371,18 +411,18 @@

-
Parameters:
length - of the array to create.
elementClass - of each element in the array
constructorAndArgsLocator - produces element constructors [potentially] on a per element basis. +
Parameters:
length - of the array to create.
constructorAndArgsLocator - produces element constructors [potentially] on a per element basis.
Throws:
java.lang.NoSuchMethodException - if the element class does not not support a supplied constructor

-

+

newInstance

-public static <T> StructuredArray<T> newInstance(long length,
-                                                 java.lang.Class<T> elementClass,
+public static <T> StructuredArray<T> newInstance(java.lang.Class<T> elementClass,
+                                                 long length,
                                                  java.lang.Class[] initArgTypes,
                                                  java.lang.Object... initArgs)
                                       throws java.lang.NoSuchMethodException
@@ -616,7 +656,7 @@

PREV CLASS  + PREV CLASS   NEXT CLASS FRAMES   @@ -637,9 +677,9 @@

- SUMMARY: NESTED | FIELD | CONSTR | METHOD + SUMMARY: NESTED | FIELD | CONSTR | METHOD -DETAIL: FIELD | CONSTR | METHOD +DETAIL: FIELD | CONSTR | METHOD diff --git a/JavaDoc/org/ObjectLayout/package-frame.html b/JavaDoc/org/ObjectLayout/package-frame.html index 7439d58..95a3826 100644 --- a/JavaDoc/org/ObjectLayout/package-frame.html +++ b/JavaDoc/org/ObjectLayout/package-frame.html @@ -2,12 +2,12 @@ - + org.ObjectLayout - + @@ -23,6 +23,8 @@ Classes 
+ArrayConstructorAndArgsLocator +
ConstructorAndArgs
ConstructorAndArgsLocator @@ -31,6 +33,10 @@
FixedConstructorAndArgsLocator
+MulitDimensionalCopyConstructorAndArgsLocator +
+MultiDimensionalStructuredArray +
StructuredArray
diff --git a/JavaDoc/org/ObjectLayout/package-summary.html b/JavaDoc/org/ObjectLayout/package-summary.html index cc34064..378f58a 100644 --- a/JavaDoc/org/ObjectLayout/package-summary.html +++ b/JavaDoc/org/ObjectLayout/package-summary.html @@ -2,12 +2,12 @@ - + org.ObjectLayout - + @@ -93,6 +93,11 @@

Class Summary +ArrayConstructorAndArgsLocator<T> +Supports the construction of a new array's individual elements using a copy constructor to copy a source + array's corresponding elements. + + ConstructorAndArgs<T> Captures a specific constructor and arguments to be passed to it. @@ -112,6 +117,15 @@

with a given fixed set of arguments (repeated for all indices) +MulitDimensionalCopyConstructorAndArgsLocator<T> +Supports the construction of a new array's individual elements using a copy constructor to copy a source + array's corresponding elements. + + +MultiDimensionalStructuredArray<T> +An array of (potentially) mutable but non-replaceable objects. + + StructuredArray<T> An array of (potentially) mutable but non-replaceable objects. diff --git a/JavaDoc/org/ObjectLayout/package-tree.html b/JavaDoc/org/ObjectLayout/package-tree.html index 0057cbf..408ff08 100644 --- a/JavaDoc/org/ObjectLayout/package-tree.html +++ b/JavaDoc/org/ObjectLayout/package-tree.html @@ -2,12 +2,12 @@ - + org.ObjectLayout Class Hierarchy - + @@ -88,7 +88,9 @@

diff --git a/JavaDoc/overview-tree.html b/JavaDoc/overview-tree.html index 2703b0a..1f7594b 100644 --- a/JavaDoc/overview-tree.html +++ b/JavaDoc/overview-tree.html @@ -2,12 +2,12 @@ - + Class Hierarchy - + @@ -90,7 +90,9 @@

From c036066ca804efd45126f12ad8337451f696e9a5 Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Tue, 4 Jun 2013 12:03:54 -0700 Subject: [PATCH 13/39] JavaDoc Update --- JavaDoc/allclasses-frame.html | 4 +- JavaDoc/allclasses-noframe.html | 4 +- JavaDoc/constant-values.html | 4 +- JavaDoc/deprecated-list.html | 4 +- JavaDoc/help-doc.html | 4 +- JavaDoc/index-files/index-1.html | 4 +- JavaDoc/index-files/index-10.html | 7 +- JavaDoc/index-files/index-11.html | 4 +- JavaDoc/index-files/index-12.html | 264 ++++++++ JavaDoc/index-files/index-13.html | 144 +++++ JavaDoc/index-files/index-2.html | 4 +- JavaDoc/index-files/index-3.html | 4 +- JavaDoc/index-files/index-4.html | 43 +- JavaDoc/index-files/index-5.html | 4 +- JavaDoc/index-files/index-6.html | 4 +- JavaDoc/index-files/index-7.html | 4 +- JavaDoc/index-files/index-8.html | 19 +- JavaDoc/index-files/index-9.html | 4 +- JavaDoc/index.html | 2 +- .../ArrayConstructorAndArgsLocator.html | 4 +- .../org/ObjectLayout/ConstructorAndArgs.html | 4 +- .../ConstructorAndArgsLocator.html | 4 +- .../CopyConstructorAndArgsLocator.html | 38 +- .../FixedConstructorAndArgsLocator.html | 4 +- ...ensionalCopyConstructorAndArgsLocator.html | 47 +- ...onalStructuredArray.StructureIterator.html | 4 +- .../MultiDimensionalStructuredArray.html | 197 +++--- ...onalStructuredArrayTest.MockStructure.html | 404 +++++++++++++ ...ArrayTest.MockStructureWithFinalField.html | 223 +++++++ .../MultiDimensionalStructuredArrayTest.html | 562 ++++++++++++++++++ .../StructuredArray.StructureIterator.html | 4 +- JavaDoc/org/ObjectLayout/StructuredArray.html | 4 +- .../StructuredArrayTest.MockStructure.html | 404 +++++++++++++ ...ArrayTest.MockStructureWithFinalField.html | 223 +++++++ .../org/ObjectLayout/StructuredArrayTest.html | 540 +++++++++++++++++ JavaDoc/org/ObjectLayout/package-frame.html | 4 +- JavaDoc/org/ObjectLayout/package-summary.html | 4 +- JavaDoc/org/ObjectLayout/package-tree.html | 4 +- JavaDoc/overview-tree.html | 4 +- 39 files changed, 2986 insertions(+), 227 deletions(-) create mode 100644 JavaDoc/index-files/index-12.html create mode 100644 JavaDoc/index-files/index-13.html create mode 100644 JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.MockStructure.html create mode 100644 JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.MockStructureWithFinalField.html create mode 100644 JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.html create mode 100644 JavaDoc/org/ObjectLayout/StructuredArrayTest.MockStructure.html create mode 100644 JavaDoc/org/ObjectLayout/StructuredArrayTest.MockStructureWithFinalField.html create mode 100644 JavaDoc/org/ObjectLayout/StructuredArrayTest.html diff --git a/JavaDoc/allclasses-frame.html b/JavaDoc/allclasses-frame.html index 5817525..ee08e4d 100644 --- a/JavaDoc/allclasses-frame.html +++ b/JavaDoc/allclasses-frame.html @@ -2,12 +2,12 @@ - + All Classes - + diff --git a/JavaDoc/allclasses-noframe.html b/JavaDoc/allclasses-noframe.html index db1089a..b8e1d90 100644 --- a/JavaDoc/allclasses-noframe.html +++ b/JavaDoc/allclasses-noframe.html @@ -2,12 +2,12 @@ - + All Classes - + diff --git a/JavaDoc/constant-values.html b/JavaDoc/constant-values.html index 743bf97..88c5074 100644 --- a/JavaDoc/constant-values.html +++ b/JavaDoc/constant-values.html @@ -2,12 +2,12 @@ - + Constant Field Values - + diff --git a/JavaDoc/deprecated-list.html b/JavaDoc/deprecated-list.html index 3d15d44..0d0e445 100644 --- a/JavaDoc/deprecated-list.html +++ b/JavaDoc/deprecated-list.html @@ -2,12 +2,12 @@ - + Deprecated List - + diff --git a/JavaDoc/help-doc.html b/JavaDoc/help-doc.html index bd9cb27..5efd216 100644 --- a/JavaDoc/help-doc.html +++ b/JavaDoc/help-doc.html @@ -2,12 +2,12 @@ - + API Help - + diff --git a/JavaDoc/index-files/index-1.html b/JavaDoc/index-files/index-1.html index f7d7a3a..ec6826b 100644 --- a/JavaDoc/index-files/index-1.html +++ b/JavaDoc/index-files/index-1.html @@ -2,12 +2,12 @@ - + A-Index - + diff --git a/JavaDoc/index-files/index-10.html b/JavaDoc/index-files/index-10.html index 555c720..4e66713 100644 --- a/JavaDoc/index-files/index-10.html +++ b/JavaDoc/index-files/index-10.html @@ -2,12 +2,12 @@ - + R-Index - + @@ -91,7 +91,8 @@
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired).
recycle(ConstructorAndArgs) - Method in class org.ObjectLayout.MulitDimensionalCopyConstructorAndArgsLocator -
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired). +
Recycle an ConstructorAndArgs instance (place it back in the internal cache if + desired).
remove() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator
Remove operation is not supported on MultiDimensionalStructuredArrays. diff --git a/JavaDoc/index-files/index-11.html b/JavaDoc/index-files/index-11.html index cf52102..4467e4e 100644 --- a/JavaDoc/index-files/index-11.html +++ b/JavaDoc/index-files/index-11.html @@ -2,12 +2,12 @@ - + S-Index - + diff --git a/JavaDoc/index-files/index-12.html b/JavaDoc/index-files/index-12.html new file mode 100644 index 0000000..4049c8e --- /dev/null +++ b/JavaDoc/index-files/index-12.html @@ -0,0 +1,264 @@ + + + + + + +S-Index + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + +
+ +
+ + + +A C E F G H I M N O R S T
+

+S

+
+
setConstructor(Constructor<T>) - +Method in class org.ObjectLayout.ConstructorAndArgs +
Set the constructor to be indicated in this ConstructorAndArgs. +
setConstructorArgs(Object[]) - +Method in class org.ObjectLayout.ConstructorAndArgs +
Set the constructor arguments to be indicated in this ConstructorAndArgs. +
setIndex(long) - +Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest.MockStructure +
  +
setIndex(long) - +Method in class org.ObjectLayout.StructuredArrayTest.MockStructure +
  +
setTestValue(long) - +Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest.MockStructure +
  +
setTestValue(long) - +Method in class org.ObjectLayout.StructuredArrayTest.MockStructure +
  +
shallowCopy(StructuredArray, long, StructuredArray, long, long) - +Static method in class org.ObjectLayout.StructuredArray +
Shallow copy a region of element object contents from one array to the other. +
shallowCopy(StructuredArray, long, StructuredArray, long, long, boolean) - +Static method in class org.ObjectLayout.StructuredArray +
Shallow copy a region of element object contents from one array to the other. +
shouldConstructArrayElementsViaElementConstructorGenerator() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest +
  +
shouldConstructArrayElementsViaElementConstructorGenerator() - +Method in class org.ObjectLayout.StructuredArrayTest +
  +
shouldConstructArrayOfGivenDirectLengths() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest +
  +
shouldConstructArrayOfGivenLength() - +Method in class org.ObjectLayout.StructuredArrayTest +
  +
shouldConstructArrayOfGivenLengthAndInitValues() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest +
  +
shouldConstructArrayOfGivenLengthAndInitValues() - +Method in class org.ObjectLayout.StructuredArrayTest +
  +
shouldConstructArrayOfGivenLengthsLongArray() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest +
  +
shouldConstructArrayOfGivenLengthsPrimitiveLongArray() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest +
  +
shouldConstructCopyOfArray() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest +
  +
shouldConstructCopyOfArray() - +Method in class org.ObjectLayout.StructuredArrayTest +
  +
shouldConstructCopyOfArrayRange() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest +
  +
shouldConstructCopyOfArrayRange() - +Method in class org.ObjectLayout.StructuredArrayTest +
  +
shouldCopyEvenWithFinalFields() - +Method in class org.ObjectLayout.StructuredArrayTest +
  +
shouldCopyRegionLeftInArray() - +Method in class org.ObjectLayout.StructuredArrayTest +
  +
shouldCopyRegionRightInArray() - +Method in class org.ObjectLayout.StructuredArrayTest +
  +
shouldIterateOverArray() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest +
  +
shouldIterateOverArray() - +Method in class org.ObjectLayout.StructuredArrayTest +
  +
shouldIterateOverArrayAndResetAgain() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest +
  +
shouldIterateOverArrayAndResetAgain() - +Method in class org.ObjectLayout.StructuredArrayTest +
  +
shouldSetAndGetCorrectValueAtGivenIndex() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest +
  +
shouldSetAndGetCorrectValueAtGivenIndex() - +Method in class org.ObjectLayout.StructuredArrayTest +
  +
shouldThrowExceptionWhenFinalFieldWouldBeCopied() - +Method in class org.ObjectLayout.StructuredArrayTest +
  +
shouldThrowIncompatibleTypeExceptionForGetOfAnArrayInsteadOfElement() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest +
  +
shouldThrowIncompatibleTypeExceptionForGetOfWrongMultiDimensionalStructuredArrayType() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest +
  +
shouldThrowIncompatibleTypeExceptionForGetOfWrongStructuredArrayType() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest +
  +
shouldThrowOutOfBoundExceptionForAccessesOutOfBounds() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest +
  +
shouldThrowOutOfBoundExceptionForAccessesOutOfBounds() - +Method in class org.ObjectLayout.StructuredArrayTest +
  +
StructuredArray<T> - Class in org.ObjectLayout
An array of (potentially) mutable but non-replaceable objects.
StructuredArray(ConstructorAndArgsLocator<T>, long, long[]) - +Constructor for class org.ObjectLayout.StructuredArray +
  +
StructuredArray.StructureIterator - Class in org.ObjectLayout
Specialised Iterator with the ability to be StructuredArray.StructureIterator.reset() enabling reuse.
StructuredArray.StructureIterator() - +Constructor for class org.ObjectLayout.StructuredArray.StructureIterator +
  +
StructuredArrayTest - Class in org.ObjectLayout
 
StructuredArrayTest() - +Constructor for class org.ObjectLayout.StructuredArrayTest +
  +
StructuredArrayTest.MockStructure - Class in org.ObjectLayout
 
StructuredArrayTest.MockStructure() - +Constructor for class org.ObjectLayout.StructuredArrayTest.MockStructure +
  +
StructuredArrayTest.MockStructure(long, long) - +Constructor for class org.ObjectLayout.StructuredArrayTest.MockStructure +
  +
StructuredArrayTest.MockStructure(StructuredArrayTest.MockStructure) - +Constructor for class org.ObjectLayout.StructuredArrayTest.MockStructure +
  +
StructuredArrayTest.MockStructureWithFinalField - Class in org.ObjectLayout
 
StructuredArrayTest.MockStructureWithFinalField() - +Constructor for class org.ObjectLayout.StructuredArrayTest.MockStructureWithFinalField +
  +
+
+ + + + + + + + + + + + + + + +
+ +
+ + + +A C E F G H I M N O R S T
+ + + diff --git a/JavaDoc/index-files/index-13.html b/JavaDoc/index-files/index-13.html new file mode 100644 index 0000000..aa315b8 --- /dev/null +++ b/JavaDoc/index-files/index-13.html @@ -0,0 +1,144 @@ + + + + + + +T-Index + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + +
+ +
+ + + +A C E F G H I M N O R S T
+

+T

+
+
toString() - +Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest.MockStructure +
  +
toString() - +Method in class org.ObjectLayout.StructuredArrayTest.MockStructure +
  +
+
+ + + + + + + + + + + + + + + +
+ +
+ + + +A C E F G H I M N O R S T
+ + + diff --git a/JavaDoc/index-files/index-2.html b/JavaDoc/index-files/index-2.html index 7d4fd0b..86d51dd 100644 --- a/JavaDoc/index-files/index-2.html +++ b/JavaDoc/index-files/index-2.html @@ -2,12 +2,12 @@ - + C-Index - + diff --git a/JavaDoc/index-files/index-3.html b/JavaDoc/index-files/index-3.html index dd8ab28..ec90657 100644 --- a/JavaDoc/index-files/index-3.html +++ b/JavaDoc/index-files/index-3.html @@ -2,12 +2,12 @@ - + F-Index - + diff --git a/JavaDoc/index-files/index-4.html b/JavaDoc/index-files/index-4.html index 686973d..6cf00cb 100644 --- a/JavaDoc/index-files/index-4.html +++ b/JavaDoc/index-files/index-4.html @@ -2,12 +2,12 @@ - + G-Index - + @@ -85,13 +85,13 @@
Get a reference to an element in the array, using a varargs int indexes.
get(int, int) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
  +
Get a reference to an element in the array, using 2 int indexes.
get(int, int, int) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
  +
Get a reference to an element in the array, using 3 int indexes.
get(int, int, int, int) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
  +
Get a reference to an element in the array, using 4 int indexes.
get(int) - Method in class org.ObjectLayout.StructuredArray
Get a reference to an element in the array, using an int index. @@ -115,14 +115,6 @@
Get the Class of elements stored in the array.
getForIndex(long) - Method in class org.ObjectLayout.ArrayConstructorAndArgsLocator -
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray. -
getForIndex(long) - -Method in class org.ObjectLayout.CopyConstructorAndArgsLocator -
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray. -
getForIndex(long) - -Method in class org.ObjectLayout.MulitDimensionalCopyConstructorAndArgsLocator
Get a ConstructorAndArgs instance to be used in constructing a given element index in a StructuredArray.
getForIndexes(long[]) - @@ -134,33 +126,34 @@ a StructuredArray
getForIndexes(long[]) - Method in class org.ObjectLayout.CopyConstructorAndArgsLocator -
  +
Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray.
getForIndexes(long[]) - Method in class org.ObjectLayout.FixedConstructorAndArgsLocator
Get a ConstructorAndArgs instance to be used in constructing a given element index in a StructuredArray.
getForIndexes(long[]) - Method in class org.ObjectLayout.MulitDimensionalCopyConstructorAndArgsLocator -
  +
Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray.
getL(long[]) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
Get a reference to an element in the array, using a long[] index array.
getL(long[], int) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get a reference to an element in the array, using a long indexes supplied in an array - and indicating a strating point in the array at which the first index should be found. +
Get a reference to an element in the array, using long indexes supplied in an array.
getL(Long...) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
Get a reference to an element in the array, using a varargs long indexes.
getL(long, long) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
  +
Get a reference to an element in the array, using 2 long indexes.
getL(long, long, long) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
  +
Get a reference to an element in the array, using 3 long indexes.
getL(long, long, long, long) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
  +
Get a reference to an element in the array, using 4 long indexes.
getL(long) - Method in class org.ObjectLayout.StructuredArray
Get a reference to an element in the array, using a long index. @@ -176,18 +169,18 @@
getNumOfDimensions() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
Get the number of dimensions of the array. -
getOfDimensionalStructuredArray(int) - +
getOfMultiDimensionalStructuredArray(int) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
  +
Get a reference to a MultiDimensionalStructuredArray element in this array, using a int index.
getOfMultiDimensionalStructuredArrayL(long) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
  +
Get a reference to a StructuredArray element in this array, using a int index.
getOfStructuredArray(int) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
  +
Get a reference to a MultiDimensionalStructuredArray element in this array, using a long index.
getOfStructuredArrayL(long) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
  +
Get a reference to a StructuredArray element in this array, using a long index.
getTotalElementCount() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
Get the total number of elements (in all dimensions combined) in this multi-dimensional array. diff --git a/JavaDoc/index-files/index-5.html b/JavaDoc/index-files/index-5.html index 63d7119..e48ed3e 100644 --- a/JavaDoc/index-files/index-5.html +++ b/JavaDoc/index-files/index-5.html @@ -2,12 +2,12 @@ - + H-Index - + diff --git a/JavaDoc/index-files/index-6.html b/JavaDoc/index-files/index-6.html index ed9c637..8f477e0 100644 --- a/JavaDoc/index-files/index-6.html +++ b/JavaDoc/index-files/index-6.html @@ -2,12 +2,12 @@ - + I-Index - + diff --git a/JavaDoc/index-files/index-7.html b/JavaDoc/index-files/index-7.html index f859936..7dac0cf 100644 --- a/JavaDoc/index-files/index-7.html +++ b/JavaDoc/index-files/index-7.html @@ -2,12 +2,12 @@ - + M-Index - + diff --git a/JavaDoc/index-files/index-8.html b/JavaDoc/index-files/index-8.html index 1a3f205..e5e779d 100644 --- a/JavaDoc/index-files/index-8.html +++ b/JavaDoc/index-files/index-8.html @@ -2,12 +2,12 @@ - + N-Index - + @@ -82,24 +82,19 @@
newInstance(Class<T>, Long...) - Static method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Create an array of length elements, each containing an element object of - type elementClass. +
Create a multi dimensional array of elements.
newInstance(Class<T>, long[]) - Static method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Create an array of length elements, each containing an element object of - type elementClass. +
Create a multi dimensional array of elements.
newInstance(Class<T>, long[], Class[], Object...) - Static method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Create an array of length elements, each containing an element object of - type elementClass. +
Create a multi dimensional array of elements.
newInstance(ConstructorAndArgsLocator<T>, Long...) - Static method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Create an array of length elements, each containing an element object of - type elementClass. +
Create a multi dimensional array of elements.
newInstance(ConstructorAndArgsLocator<T>, long[]) - Static method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Create an array of length elements, each containing an element object of - type elementClass. +
Create a multi dimensional array of elements.
newInstance(Class<T>, long) - Static method in class org.ObjectLayout.StructuredArray
Create an array of length elements, each containing an element object of diff --git a/JavaDoc/index-files/index-9.html b/JavaDoc/index-files/index-9.html index 35bf3f8..908f313 100644 --- a/JavaDoc/index-files/index-9.html +++ b/JavaDoc/index-files/index-9.html @@ -2,12 +2,12 @@ - + O-Index - + diff --git a/JavaDoc/index.html b/JavaDoc/index.html index a2c9fbc..2950f1b 100644 --- a/JavaDoc/index.html +++ b/JavaDoc/index.html @@ -2,7 +2,7 @@ - + Generated Documentation (Untitled) diff --git a/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html index de0b35c..26e60d2 100644 --- a/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + ArrayConstructorAndArgsLocator - + diff --git a/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html b/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html index 22b22d7..56628fd 100644 --- a/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html +++ b/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html @@ -2,12 +2,12 @@ - + ConstructorAndArgs - + diff --git a/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html index 93f1449..8989cb2 100644 --- a/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + ConstructorAndArgsLocator - + diff --git a/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html index 769b9ba..d212851 100644 --- a/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + CopyConstructorAndArgsLocator - + @@ -159,20 +159,11 @@

 ConstructorAndArgs<T> -getForIndex(long index) - -
-          Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray. - - - - ConstructorAndArgs<T> getForIndexes(long[] indexes)
          Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray + a StructuredArray. @@ -277,39 +268,20 @@

-

-getForIndex

-
-public ConstructorAndArgs<T> getForIndex(long index)
-                                  throws java.lang.NoSuchMethodException
-
-
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray. . -

-

-
Parameters:
index - The index of the element to be constructed in the target array -
Returns:
ConstructorAndArgs instance to used in element construction -
Throws: -
java.lang.NoSuchMethodException - if expected constructor is not found in element class
-
-
-
-

getForIndexes

 public ConstructorAndArgs<T> getForIndexes(long[] indexes)
                                     throws java.lang.NoSuchMethodException
-
Description copied from class: ConstructorAndArgsLocator
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray + a StructuredArray. (supports only 1 dimensional array copies). .

Overrides:
getForIndexes in class ConstructorAndArgsLocator<T>
-
Parameters:
indexes - The indexes of the element to be constructed in the target array +
Parameters:
indexes - The index of the element to be constructed in the target array (supports only 1 dimensional copies)
Returns:
ConstructorAndArgs instance to used in element construction
Throws:
java.lang.NoSuchMethodException - if expected constructor is not found in element class
diff --git a/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html index 31c1954..8f09290 100644 --- a/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + FixedConstructorAndArgsLocator - + diff --git a/JavaDoc/org/ObjectLayout/MulitDimensionalCopyConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/MulitDimensionalCopyConstructorAndArgsLocator.html index 781c39b..ab5cf7c 100644 --- a/JavaDoc/org/ObjectLayout/MulitDimensionalCopyConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/MulitDimensionalCopyConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + MulitDimensionalCopyConstructorAndArgsLocator - + @@ -159,20 +159,11 @@

 ConstructorAndArgs<T> -getForIndex(long index) - -
-          Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray. - - - - ConstructorAndArgs<T> getForIndexes(long[] indexes)
          Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray + a StructuredArray. @@ -180,7 +171,8 @@

recycle(ConstructorAndArgs constructorAndArgs)
-          Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired). +          Recycle an ConstructorAndArgs instance (place it back in the internal cache if + desired).   @@ -277,33 +269,14 @@

-

-getForIndex

-
-public ConstructorAndArgs<T> getForIndex(long index)
-                                  throws java.lang.NoSuchMethodException
-
-
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray. . -

-

-
Parameters:
index - The index of the element to be constructed in the target array -
Returns:
ConstructorAndArgs instance to used in element construction -
Throws: -
java.lang.NoSuchMethodException - if expected constructor is not found in element class
-
-
-
-

getForIndexes

 public ConstructorAndArgs<T> getForIndexes(long[] indexes)
                                     throws java.lang.NoSuchMethodException
-
Description copied from class: ConstructorAndArgsLocator
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray + a StructuredArray. .

Overrides:
getForIndexes in class ConstructorAndArgsLocator<T>
@@ -322,10 +295,10 @@

 public void recycle(ConstructorAndArgs constructorAndArgs)
-
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired). This is [very] - useful for avoiding a re-allocation of a new ConstructorAndArgs and an associated args array for - getForIndex(long) invocation in cases such as this (where the returned ConstructorAndArgs - is not constant across indices). +
Recycle an ConstructorAndArgs instance (place it back in the internal cache if + desired). This is [very] useful for avoiding a re-allocation of a new ConstructorAndArgs + and an associated args array for getForIndexes(long[]) invocation in cases such as this (where the + returned ConstructorAndArgs is not constant across indices). Recycling is optional, and is not guaranteed to occur.

diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html index 7313c8a..4c1333b 100644 --- a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html @@ -2,12 +2,12 @@ - + MultiDimensionalStructuredArray.StructureIterator - + diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html index e00307f..88d9361 100644 --- a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html @@ -2,12 +2,12 @@ - + MultiDimensionalStructuredArray - + @@ -223,7 +223,7 @@

int index1)
-            +          Get a reference to an element in the array, using 2 int indexes. @@ -233,7 +233,7 @@

int index2)
-            +          Get a reference to an element in the array, using 3 int indexes. @@ -244,7 +244,7 @@

int index3)
-            +          Get a reference to an element in the array, using 4 int indexes. @@ -277,8 +277,7 @@

int indexOffset)
-          Get a reference to an element in the array, using a long indexes supplied in an array - and indicating a strating point in the array at which the first index should be found. +          Get a reference to an element in the array, using long indexes supplied in an array. @@ -287,7 +286,7 @@

long index1)
-            +          Get a reference to an element in the array, using 2 long indexes. @@ -297,7 +296,7 @@

long index2)
-            +          Get a reference to an element in the array, using 3 long indexes. @@ -308,7 +307,7 @@

long index3)
-            +          Get a reference to an element in the array, using 4 long indexes. @@ -337,10 +336,10 @@

 MultiDimensionalStructuredArray<T> -getOfDimensionalStructuredArray(int index) +getOfMultiDimensionalStructuredArray(int index)
-            +          Get a reference to a MultiDimensionalStructuredArray element in this array, using a int index. @@ -348,7 +347,7 @@

getOfMultiDimensionalStructuredArrayL(long index)
-            +          Get a reference to a StructuredArray element in this array, using a int index. @@ -356,7 +355,7 @@

getOfStructuredArray(int index)
-            +          Get a reference to a MultiDimensionalStructuredArray element in this array, using a long index. @@ -364,7 +363,7 @@

getOfStructuredArrayL(long index)
-            +          Get a reference to a StructuredArray element in this array, using a long index. @@ -396,8 +395,7 @@

java.lang.Long... lengths)
-          Create an array of length elements, each containing an element object of - type elementClass. +          Create a multi dimensional array of elements. @@ -413,8 +411,7 @@

long[] lengths)
-          Create an array of length elements, each containing an element object of - type elementClass. +          Create a multi dimensional array of elements. @@ -432,8 +429,7 @@

java.lang.Object... initArgs)
-          Create an array of length elements, each containing an element object of - type elementClass. +          Create a multi dimensional array of elements. @@ -449,8 +445,7 @@

java.lang.Long... lengths)
-          Create an array of length elements, each containing an element object of - type elementClass. +          Create a multi dimensional array of elements. @@ -466,8 +461,7 @@

long[] lengths)
-          Create an array of length elements, each containing an element object of - type elementClass. +          Create a multi dimensional array of elements.   @@ -499,8 +493,10 @@

java.lang.Long... lengths) throws java.lang.NoSuchMethodException
-
Create an array of length elements, each containing an element object of - type elementClass. Using the elementClass's default constructor. +
Create a multi dimensional array of elements. Each dimension of the array will be of a length designated + in the lengths parameters passed. Each element of the array will consist of + an object of type elementClass. Elements will be constructed Using the + elementClass's default constructor.

@@ -520,8 +516,10 @@

long[] lengths) throws java.lang.NoSuchMethodException
-
Create an array of length elements, each containing an element object of - type elementClass. Using the elementClass's default constructor. +
Create a multi dimensional array of elements. Each dimension of the array will be of a length designated + in the lengths[] passed. Each element of the array will consist of + an object of type elementClass. Elements will be constructed Using the + elementClass's default constructor.

@@ -543,10 +541,11 @@

java.lang.Object... initArgs) throws java.lang.NoSuchMethodException
-
Create an array of length elements, each containing an element object of - type elementClass. Use a fixed (same for all elements) constructor identified by the argument - classes specified in initArgs to construct and initialize each element, passing the remaining - arguments to that constructor. +
Create a multi dimensional array of elements. Each dimension of the array will be of a length designated + in the lengths[] passed. Each element of the array will consist of + an object of type elementClass. Elements will be constructed using a fixed (same for all elements) + constructor identified by the argument classes specified in initArgTypes to construct and + initialize each element, passing the initArgs arguments to that constructor.

@@ -567,10 +566,11 @@

java.lang.Long... lengths) throws java.lang.NoSuchMethodException
-
Create an array of length elements, each containing an element object of - type elementClass. Use constructor and arguments supplied (on a potentially - per element index basis) by the specified constructorAndArgsLocator to construct and initialize - each element. +
Create a multi dimensional array of elements. Each dimension of the array will be of a length designated + in the lengths arguments passed. Each element of the array will consist of + an object of type elementClass. Elements will be constructed using the constructor and arguments + supplied (on a potentially per element index basis) by the specified constructorAndArgsLocator. + to construct and initialize each element.

@@ -590,10 +590,11 @@

long[] lengths) throws java.lang.NoSuchMethodException
-
Create an array of length elements, each containing an element object of - type elementClass. Use constructor and arguments supplied (on a potentially - per element index basis) by the specified constructorAndArgsLocator to construct and initialize - each element. +
Create a multi dimensional array of elements. Each dimension of the array will be of a length designated + in the lengths[] passed. Each element of the array will consist of + an object of type elementClass. Elements will be constructed using the constructor and arguments + supplied (on a potentially per element index basis) by the specified constructorAndArgsLocator. + to construct and initialize each element.

@@ -643,7 +644,7 @@

-
Parameters:
source - The array to duplicate.
sourceOffsets - offset indexes in source where the region to be copied begins.
counts - the number of elements in each dimension to copy. +
Parameters:
source - The array to copy from.
sourceOffsets - offset indexes for each dimension, indicating where the source region to be copied begins.
counts - the number of elements in each dimension to copy.
Throws:
java.lang.NoSuchMethodException - if the element class does not have a public copy constructor.
@@ -666,7 +667,7 @@

-
Parameters:
source - The array to duplicate.
sourceOffsets - offset indexes in source where the region to be copied begins.
counts - the number of elements in each dimension to copy. +
Parameters:
source - The array to copy from.
sourceOffsets - offset indexes for each dimension, indicating where the source region to be copied begins.
counts - the number of elements in each dimension to copy.
Throws:
java.lang.NoSuchMethodException - if the element class does not have a public copy constructor.
@@ -764,8 +765,8 @@

public T getL(long[] indexes, int indexOffset)
-
Get a reference to an element in the array, using a long indexes supplied in an array - and indicating a strating point in the array at which the first index should be found. +
Get a reference to an element in the array, using long indexes supplied in an array. + indexOffset indicates the starting point in the array at which the first index should be found. This form is useful when passing index arrays through multiple levels to avoid construction of temporary varargs containers or construction of new shorter index arrays.

@@ -773,7 +774,7 @@

-
Parameters:
indexes - The indexes (at each dimension) of the element to retrieve.
indexOffset - The beginiing offset in the indexes array related to this arrays contents. +
Parameters:
indexes - The indexes (at each dimension) of the element to retrieve.
indexOffset - The beginning offset in the indexes array related to this arrays contents.
Returns:
a reference to the indexed element.
@@ -817,13 +818,19 @@

getL

 public T getL(long index0,
-              long index1)
+ long index1) + throws java.lang.ClassCastException
+
Get a reference to an element in the array, using 2 long indexes. +

-
+
Parameters:
index0 -
index1 - +
Returns:
the element at [index0, index1] +
Throws: +
java.lang.ClassCastException - if number of indexes does not match number of dimensions in the array

@@ -833,13 +840,19 @@

 public T getL(long index0,
               long index1,
-              long index2)
+ long index2) + throws java.lang.ClassCastException
+
Get a reference to an element in the array, using 3 long indexes. +

-
+
Parameters:
index0 -
index1 -
index2 - +
Returns:
the element at [index0, index1, index2] +
Throws: +
java.lang.ClassCastException - if number of indexes does not match number of dimensions in the array


@@ -850,13 +863,19 @@

public T getL(long index0, long index1, long index2, - long index3) + long index3) + throws java.lang.ClassCastException
+
Get a reference to an element in the array, using 4 long indexes. +

-
+
Parameters:
index0 -
index1 -
index2 -
index3 - +
Returns:
the element at [index0, index1, index2, index3] +
Throws: +
java.lang.ClassCastException - if number of indexes does not match number of dimensions in the array


@@ -865,13 +884,19 @@

get

 public T get(int index0,
-             int index1)
+ int index1) + throws java.lang.ClassCastException
+
Get a reference to an element in the array, using 2 int indexes. +

-
+
Parameters:
index0 -
index1 - +
Returns:
the element at [index0, index1] +
Throws: +
java.lang.ClassCastException - if number of indexes does not match number of dimensions in the array


@@ -881,13 +906,19 @@

 public T get(int index0,
              int index1,
-             int index2)
+ int index2) + throws java.lang.ClassCastException
+
Get a reference to an element in the array, using 3 int indexes. +

-
+
Parameters:
index0 -
index1 -
index2 - +
Returns:
the element at [index0, index1, index2] +
Throws: +
java.lang.ClassCastException - if number of indexes does not match number of dimensions in the array


@@ -898,13 +929,19 @@

public T get(int index0, int index1, int index2, - int index3) + int index3) + throws java.lang.ClassCastException
+
Get a reference to an element in the array, using 4 int indexes. +

-
+
Parameters:
index0 -
index1 -
index2 -
index3 - +
Returns:
the element at [index0, index1, index2, index3] +
Throws: +
java.lang.ClassCastException - if number of indexes does not match number of dimensions in the array


@@ -912,13 +949,19 @@

getOfStructuredArrayL

-public StructuredArray<T> getOfStructuredArrayL(long index)
+public StructuredArray<T> getOfStructuredArrayL(long index) + throws java.lang.ClassCastException
+
Get a reference to a StructuredArray element in this array, using a long index. +

-
+
Parameters:
index - +
Returns:
a reference to the StructuredArray located in element [index] of this array +
Throws: +
java.lang.ClassCastException - if array has more than two dimensions

@@ -926,13 +969,19 @@

getOfMultiDimensionalStructuredArrayL

-public MultiDimensionalStructuredArray<T> getOfMultiDimensionalStructuredArrayL(long index)
+public MultiDimensionalStructuredArray<T> getOfMultiDimensionalStructuredArrayL(long index) + throws java.lang.ClassCastException
+
Get a reference to a StructuredArray element in this array, using a int index. +

-
+
Parameters:
index - +
Returns:
a reference to the StructuredArray located in element [index] of this array +
Throws: +
java.lang.ClassCastException - if array has only two dimensions

@@ -940,27 +989,39 @@

getOfStructuredArray

-public StructuredArray<T> getOfStructuredArray(int index)
+public StructuredArray<T> getOfStructuredArray(int index) + throws java.lang.ClassCastException
+
Get a reference to a MultiDimensionalStructuredArray element in this array, using a long index. +

-
+
Parameters:
index - +
Returns:
a reference to the StructuredArray located in element [index] of this array +
Throws: +
java.lang.ClassCastException - if array has more than two dimensions


-

-getOfDimensionalStructuredArray

+

+getOfMultiDimensionalStructuredArray

-public MultiDimensionalStructuredArray<T> getOfDimensionalStructuredArray(int index)
+public MultiDimensionalStructuredArray<T> getOfMultiDimensionalStructuredArray(int index) + throws java.lang.ClassCastException
+
Get a reference to a MultiDimensionalStructuredArray element in this array, using a int index. +

-
+
Parameters:
index - +
Returns:
a reference to the StructuredArray located in element [index] of this array +
Throws: +
java.lang.ClassCastException - if array has only two dimensions

diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.MockStructure.html b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.MockStructure.html new file mode 100644 index 0000000..d55fe0c --- /dev/null +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.MockStructure.html @@ -0,0 +1,404 @@ + + + + + + +MultiDimensionalStructuredArrayTest.MockStructure + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class MultiDimensionalStructuredArrayTest.MockStructure

+
+java.lang.Object
+  extended by org.ObjectLayout.MultiDimensionalStructuredArrayTest.MockStructure
+
+
+
Enclosing class:
MultiDimensionalStructuredArrayTest
+
+
+
+
public static class MultiDimensionalStructuredArrayTest.MockStructure
extends java.lang.Object
+ + +

+


+ +

+ + + + + + + + + + + + + + + + + +
+Constructor Summary
MultiDimensionalStructuredArrayTest.MockStructure() + +
+           
MultiDimensionalStructuredArrayTest.MockStructure(long index, + long testValue) + +
+           
MultiDimensionalStructuredArrayTest.MockStructure(MultiDimensionalStructuredArrayTest.MockStructure src) + +
+           
+  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+Method Summary
+ booleanequals(java.lang.Object o) + +
+           
+ longgetIndex() + +
+           
+ longgetTestValue() + +
+           
+ inthashCode() + +
+           
+ voidsetIndex(long index) + +
+           
+ voidsetTestValue(long testValue) + +
+           
+ java.lang.StringtoString() + +
+           
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+MultiDimensionalStructuredArrayTest.MockStructure

+
+public MultiDimensionalStructuredArrayTest.MockStructure()
+
+
+
+ +

+MultiDimensionalStructuredArrayTest.MockStructure

+
+public MultiDimensionalStructuredArrayTest.MockStructure(long index,
+                                                         long testValue)
+
+
+
+ +

+MultiDimensionalStructuredArrayTest.MockStructure

+
+public MultiDimensionalStructuredArrayTest.MockStructure(MultiDimensionalStructuredArrayTest.MockStructure src)
+
+
+ + + + + + + + +
+Method Detail
+ +

+getIndex

+
+public long getIndex()
+
+
+
+
+
+
+ +

+setIndex

+
+public void setIndex(long index)
+
+
+
+
+
+
+ +

+getTestValue

+
+public long getTestValue()
+
+
+
+
+
+
+ +

+setTestValue

+
+public void setTestValue(long testValue)
+
+
+
+
+
+
+ +

+equals

+
+public boolean equals(java.lang.Object o)
+
+
+
Overrides:
equals in class java.lang.Object
+
+
+
+
+
+
+ +

+hashCode

+
+public int hashCode()
+
+
+
Overrides:
hashCode in class java.lang.Object
+
+
+
+
+
+
+ +

+toString

+
+public java.lang.String toString()
+
+
+
Overrides:
toString in class java.lang.Object
+
+
+
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.MockStructureWithFinalField.html b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.MockStructureWithFinalField.html new file mode 100644 index 0000000..dcec076 --- /dev/null +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.MockStructureWithFinalField.html @@ -0,0 +1,223 @@ + + + + + + +MultiDimensionalStructuredArrayTest.MockStructureWithFinalField + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class MultiDimensionalStructuredArrayTest.MockStructureWithFinalField

+
+java.lang.Object
+  extended by org.ObjectLayout.MultiDimensionalStructuredArrayTest.MockStructureWithFinalField
+
+
+
Enclosing class:
MultiDimensionalStructuredArrayTest
+
+
+
+
public static class MultiDimensionalStructuredArrayTest.MockStructureWithFinalField
extends java.lang.Object
+ + +

+


+ +

+ + + + + + + + + + + +
+Constructor Summary
MultiDimensionalStructuredArrayTest.MockStructureWithFinalField() + +
+           
+  + + + + + + + +
+Method Summary
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+MultiDimensionalStructuredArrayTest.MockStructureWithFinalField

+
+public MultiDimensionalStructuredArrayTest.MockStructureWithFinalField()
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.html b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.html new file mode 100644 index 0000000..8dff2b0 --- /dev/null +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.html @@ -0,0 +1,562 @@ + + + + + + +MultiDimensionalStructuredArrayTest + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class MultiDimensionalStructuredArrayTest

+
+java.lang.Object
+  extended by org.ObjectLayout.MultiDimensionalStructuredArrayTest
+
+
+
+
public class MultiDimensionalStructuredArrayTest
extends java.lang.Object
+ + +

+


+ +

+ + + + + + + + + + + + + + + +
+Nested Class Summary
+static classMultiDimensionalStructuredArrayTest.MockStructure + +
+           
+static classMultiDimensionalStructuredArrayTest.MockStructureWithFinalField + +
+           
+  + + + + + + + + + + +
+Constructor Summary
MultiDimensionalStructuredArrayTest() + +
+           
+  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+Method Summary
+ voidshouldConstructArrayElementsViaElementConstructorGenerator() + +
+           
+ voidshouldConstructArrayOfGivenDirectLengths() + +
+           
+ voidshouldConstructArrayOfGivenLengthAndInitValues() + +
+           
+ voidshouldConstructArrayOfGivenLengthsLongArray() + +
+           
+ voidshouldConstructArrayOfGivenLengthsPrimitiveLongArray() + +
+           
+ voidshouldConstructCopyOfArray() + +
+           
+ voidshouldConstructCopyOfArrayRange() + +
+           
+ voidshouldIterateOverArray() + +
+           
+ voidshouldIterateOverArrayAndResetAgain() + +
+           
+ voidshouldSetAndGetCorrectValueAtGivenIndex() + +
+           
+ voidshouldThrowIncompatibleTypeExceptionForGetOfAnArrayInsteadOfElement() + +
+           
+ voidshouldThrowIncompatibleTypeExceptionForGetOfWrongMultiDimensionalStructuredArrayType() + +
+           
+ voidshouldThrowIncompatibleTypeExceptionForGetOfWrongStructuredArrayType() + +
+           
+ voidshouldThrowOutOfBoundExceptionForAccessesOutOfBounds() + +
+           
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+MultiDimensionalStructuredArrayTest

+
+public MultiDimensionalStructuredArrayTest()
+
+
+ + + + + + + + +
+Method Detail
+ +

+shouldConstructArrayOfGivenDirectLengths

+
+public void shouldConstructArrayOfGivenDirectLengths()
+                                              throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldConstructArrayOfGivenLengthsLongArray

+
+public void shouldConstructArrayOfGivenLengthsLongArray()
+                                                 throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldConstructArrayOfGivenLengthsPrimitiveLongArray

+
+public void shouldConstructArrayOfGivenLengthsPrimitiveLongArray()
+                                                          throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldConstructArrayOfGivenLengthAndInitValues

+
+public void shouldConstructArrayOfGivenLengthAndInitValues()
+                                                    throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldConstructArrayElementsViaElementConstructorGenerator

+
+public void shouldConstructArrayElementsViaElementConstructorGenerator()
+                                                                throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldSetAndGetCorrectValueAtGivenIndex

+
+public void shouldSetAndGetCorrectValueAtGivenIndex()
+                                             throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldIterateOverArray

+
+public void shouldIterateOverArray()
+                            throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldIterateOverArrayAndResetAgain

+
+public void shouldIterateOverArrayAndResetAgain()
+                                         throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldConstructCopyOfArray

+
+public void shouldConstructCopyOfArray()
+                                throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldConstructCopyOfArrayRange

+
+public void shouldConstructCopyOfArrayRange()
+                                     throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldThrowOutOfBoundExceptionForAccessesOutOfBounds

+
+public void shouldThrowOutOfBoundExceptionForAccessesOutOfBounds()
+                                                          throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldThrowIncompatibleTypeExceptionForGetOfAnArrayInsteadOfElement

+
+public void shouldThrowIncompatibleTypeExceptionForGetOfAnArrayInsteadOfElement()
+                                                                         throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldThrowIncompatibleTypeExceptionForGetOfWrongStructuredArrayType

+
+public void shouldThrowIncompatibleTypeExceptionForGetOfWrongStructuredArrayType()
+                                                                          throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldThrowIncompatibleTypeExceptionForGetOfWrongMultiDimensionalStructuredArrayType

+
+public void shouldThrowIncompatibleTypeExceptionForGetOfWrongMultiDimensionalStructuredArrayType()
+                                                                                          throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html b/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html index da57205..b0c50c7 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html +++ b/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html @@ -2,12 +2,12 @@ - + StructuredArray.StructureIterator - + diff --git a/JavaDoc/org/ObjectLayout/StructuredArray.html b/JavaDoc/org/ObjectLayout/StructuredArray.html index 1950dc3..ef737e0 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArray.html +++ b/JavaDoc/org/ObjectLayout/StructuredArray.html @@ -2,12 +2,12 @@ - + StructuredArray - + diff --git a/JavaDoc/org/ObjectLayout/StructuredArrayTest.MockStructure.html b/JavaDoc/org/ObjectLayout/StructuredArrayTest.MockStructure.html new file mode 100644 index 0000000..c926da2 --- /dev/null +++ b/JavaDoc/org/ObjectLayout/StructuredArrayTest.MockStructure.html @@ -0,0 +1,404 @@ + + + + + + +StructuredArrayTest.MockStructure + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class StructuredArrayTest.MockStructure

+
+java.lang.Object
+  extended by org.ObjectLayout.StructuredArrayTest.MockStructure
+
+
+
Enclosing class:
StructuredArrayTest
+
+
+
+
public static class StructuredArrayTest.MockStructure
extends java.lang.Object
+ + +

+


+ +

+ + + + + + + + + + + + + + + + + +
+Constructor Summary
StructuredArrayTest.MockStructure() + +
+           
StructuredArrayTest.MockStructure(long index, + long testValue) + +
+           
StructuredArrayTest.MockStructure(StructuredArrayTest.MockStructure src) + +
+           
+  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+Method Summary
+ booleanequals(java.lang.Object o) + +
+           
+ longgetIndex() + +
+           
+ longgetTestValue() + +
+           
+ inthashCode() + +
+           
+ voidsetIndex(long index) + +
+           
+ voidsetTestValue(long testValue) + +
+           
+ java.lang.StringtoString() + +
+           
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+StructuredArrayTest.MockStructure

+
+public StructuredArrayTest.MockStructure()
+
+
+
+ +

+StructuredArrayTest.MockStructure

+
+public StructuredArrayTest.MockStructure(long index,
+                                         long testValue)
+
+
+
+ +

+StructuredArrayTest.MockStructure

+
+public StructuredArrayTest.MockStructure(StructuredArrayTest.MockStructure src)
+
+
+ + + + + + + + +
+Method Detail
+ +

+getIndex

+
+public long getIndex()
+
+
+
+
+
+
+ +

+setIndex

+
+public void setIndex(long index)
+
+
+
+
+
+
+ +

+getTestValue

+
+public long getTestValue()
+
+
+
+
+
+
+ +

+setTestValue

+
+public void setTestValue(long testValue)
+
+
+
+
+
+
+ +

+equals

+
+public boolean equals(java.lang.Object o)
+
+
+
Overrides:
equals in class java.lang.Object
+
+
+
+
+
+
+ +

+hashCode

+
+public int hashCode()
+
+
+
Overrides:
hashCode in class java.lang.Object
+
+
+
+
+
+
+ +

+toString

+
+public java.lang.String toString()
+
+
+
Overrides:
toString in class java.lang.Object
+
+
+
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/StructuredArrayTest.MockStructureWithFinalField.html b/JavaDoc/org/ObjectLayout/StructuredArrayTest.MockStructureWithFinalField.html new file mode 100644 index 0000000..418acb4 --- /dev/null +++ b/JavaDoc/org/ObjectLayout/StructuredArrayTest.MockStructureWithFinalField.html @@ -0,0 +1,223 @@ + + + + + + +StructuredArrayTest.MockStructureWithFinalField + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class StructuredArrayTest.MockStructureWithFinalField

+
+java.lang.Object
+  extended by org.ObjectLayout.StructuredArrayTest.MockStructureWithFinalField
+
+
+
Enclosing class:
StructuredArrayTest
+
+
+
+
public static class StructuredArrayTest.MockStructureWithFinalField
extends java.lang.Object
+ + +

+


+ +

+ + + + + + + + + + + +
+Constructor Summary
StructuredArrayTest.MockStructureWithFinalField() + +
+           
+  + + + + + + + +
+Method Summary
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+StructuredArrayTest.MockStructureWithFinalField

+
+public StructuredArrayTest.MockStructureWithFinalField()
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/StructuredArrayTest.html b/JavaDoc/org/ObjectLayout/StructuredArrayTest.html new file mode 100644 index 0000000..ec4433e --- /dev/null +++ b/JavaDoc/org/ObjectLayout/StructuredArrayTest.html @@ -0,0 +1,540 @@ + + + + + + +StructuredArrayTest + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class StructuredArrayTest

+
+java.lang.Object
+  extended by org.ObjectLayout.StructuredArrayTest
+
+
+
+
public class StructuredArrayTest
extends java.lang.Object
+ + +

+


+ +

+ + + + + + + + + + + + + + + +
+Nested Class Summary
+static classStructuredArrayTest.MockStructure + +
+           
+static classStructuredArrayTest.MockStructureWithFinalField + +
+           
+  + + + + + + + + + + +
+Constructor Summary
StructuredArrayTest() + +
+           
+  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+Method Summary
+ voidshouldConstructArrayElementsViaElementConstructorGenerator() + +
+           
+ voidshouldConstructArrayOfGivenLength() + +
+           
+ voidshouldConstructArrayOfGivenLengthAndInitValues() + +
+           
+ voidshouldConstructCopyOfArray() + +
+           
+ voidshouldConstructCopyOfArrayRange() + +
+           
+ voidshouldCopyEvenWithFinalFields() + +
+           
+ voidshouldCopyRegionLeftInArray() + +
+           
+ voidshouldCopyRegionRightInArray() + +
+           
+ voidshouldIterateOverArray() + +
+           
+ voidshouldIterateOverArrayAndResetAgain() + +
+           
+ voidshouldSetAndGetCorrectValueAtGivenIndex() + +
+           
+ voidshouldThrowExceptionWhenFinalFieldWouldBeCopied() + +
+           
+ voidshouldThrowOutOfBoundExceptionForAccessesOutOfBounds() + +
+           
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+StructuredArrayTest

+
+public StructuredArrayTest()
+
+
+ + + + + + + + +
+Method Detail
+ +

+shouldConstructArrayOfGivenLength

+
+public void shouldConstructArrayOfGivenLength()
+                                       throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldConstructArrayOfGivenLengthAndInitValues

+
+public void shouldConstructArrayOfGivenLengthAndInitValues()
+                                                    throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldConstructArrayElementsViaElementConstructorGenerator

+
+public void shouldConstructArrayElementsViaElementConstructorGenerator()
+                                                                throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldSetAndGetCorrectValueAtGivenIndex

+
+public void shouldSetAndGetCorrectValueAtGivenIndex()
+                                             throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldIterateOverArray

+
+public void shouldIterateOverArray()
+                            throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldIterateOverArrayAndResetAgain

+
+public void shouldIterateOverArrayAndResetAgain()
+                                         throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldConstructCopyOfArray

+
+public void shouldConstructCopyOfArray()
+                                throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldConstructCopyOfArrayRange

+
+public void shouldConstructCopyOfArrayRange()
+                                     throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldCopyRegionLeftInArray

+
+public void shouldCopyRegionLeftInArray()
+                                 throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldCopyRegionRightInArray

+
+public void shouldCopyRegionRightInArray()
+                                  throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldThrowOutOfBoundExceptionForAccessesOutOfBounds

+
+public void shouldThrowOutOfBoundExceptionForAccessesOutOfBounds()
+                                                          throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldCopyEvenWithFinalFields

+
+public void shouldCopyEvenWithFinalFields()
+                                   throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldThrowExceptionWhenFinalFieldWouldBeCopied

+
+public void shouldThrowExceptionWhenFinalFieldWouldBeCopied()
+                                                     throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/package-frame.html b/JavaDoc/org/ObjectLayout/package-frame.html index 95a3826..4a6880c 100644 --- a/JavaDoc/org/ObjectLayout/package-frame.html +++ b/JavaDoc/org/ObjectLayout/package-frame.html @@ -2,12 +2,12 @@ - + org.ObjectLayout - + diff --git a/JavaDoc/org/ObjectLayout/package-summary.html b/JavaDoc/org/ObjectLayout/package-summary.html index 378f58a..c575691 100644 --- a/JavaDoc/org/ObjectLayout/package-summary.html +++ b/JavaDoc/org/ObjectLayout/package-summary.html @@ -2,12 +2,12 @@ - + org.ObjectLayout - + diff --git a/JavaDoc/org/ObjectLayout/package-tree.html b/JavaDoc/org/ObjectLayout/package-tree.html index 408ff08..7c7912a 100644 --- a/JavaDoc/org/ObjectLayout/package-tree.html +++ b/JavaDoc/org/ObjectLayout/package-tree.html @@ -2,12 +2,12 @@ - + org.ObjectLayout Class Hierarchy - + diff --git a/JavaDoc/overview-tree.html b/JavaDoc/overview-tree.html index 1f7594b..9396939 100644 --- a/JavaDoc/overview-tree.html +++ b/JavaDoc/overview-tree.html @@ -2,12 +2,12 @@ - + Class Hierarchy - + From 8578c534e43364c152890510b20bd2eddd8b188f Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Sat, 8 Jun 2013 09:12:07 -0700 Subject: [PATCH 14/39] JavaDoc update --- JavaDoc/allclasses-frame.html | 10 +- JavaDoc/allclasses-noframe.html | 10 +- JavaDoc/constant-values.html | 4 +- JavaDoc/deprecated-list.html | 4 +- JavaDoc/help-doc.html | 4 +- JavaDoc/index-files/index-1.html | 8 +- JavaDoc/index-files/index-10.html | 22 +- JavaDoc/index-files/index-11.html | 14 +- JavaDoc/index-files/index-12.html | 160 +-- JavaDoc/index-files/index-2.html | 17 +- JavaDoc/index-files/index-3.html | 8 +- JavaDoc/index-files/index-4.html | 80 +- JavaDoc/index-files/index-5.html | 11 +- JavaDoc/index-files/index-6.html | 11 +- JavaDoc/index-files/index-7.html | 22 +- JavaDoc/index-files/index-8.html | 38 +- JavaDoc/index-files/index-9.html | 8 +- JavaDoc/index.html | 2 +- .../ArrayConstructorAndArgsLocator.html | 4 +- .../org/ObjectLayout/ConstructorAndArgs.html | 4 +- .../ConstructorAndArgsLocator.html | 6 +- .../CopyConstructorAndArgsLocator.html | 4 +- .../FixedConstructorAndArgsLocator.html | 8 +- ...ensionalCopyConstructorAndArgsLocator.html | 372 +++++ ...onalStructuredArray.StructureIterator.html | 4 +- .../MultiDimensionalStructuredArray.html | 16 +- .../StructuredArray.StructureIterator.html | 8 +- JavaDoc/org/ObjectLayout/StructuredArray.html | 4 +- .../UnifiedCopyConstructorAndArgsLocator.html | 372 +++++ ...fiedStructuredArray.StructureIterator.html | 359 +++++ .../ObjectLayout/UnifiedStructuredArray.html | 1238 +++++++++++++++++ JavaDoc/org/ObjectLayout/package-frame.html | 12 +- JavaDoc/org/ObjectLayout/package-summary.html | 15 +- JavaDoc/org/ObjectLayout/package-tree.html | 8 +- JavaDoc/overview-tree.html | 8 +- 35 files changed, 2625 insertions(+), 250 deletions(-) create mode 100644 JavaDoc/org/ObjectLayout/MultiDimensionalCopyConstructorAndArgsLocator.html create mode 100644 JavaDoc/org/ObjectLayout/UnifiedCopyConstructorAndArgsLocator.html create mode 100644 JavaDoc/org/ObjectLayout/UnifiedStructuredArray.StructureIterator.html create mode 100644 JavaDoc/org/ObjectLayout/UnifiedStructuredArray.html diff --git a/JavaDoc/allclasses-frame.html b/JavaDoc/allclasses-frame.html index ee08e4d..43cfc36 100644 --- a/JavaDoc/allclasses-frame.html +++ b/JavaDoc/allclasses-frame.html @@ -2,12 +2,12 @@ - + All Classes - + @@ -31,12 +31,16 @@
FixedConstructorAndArgsLocator
-MulitDimensionalCopyConstructorAndArgsLocator +MultiDimensionalCopyConstructorAndArgsLocator
MultiDimensionalStructuredArray
StructuredArray
+UnifiedCopyConstructorAndArgsLocator +
+UnifiedStructuredArray +
diff --git a/JavaDoc/allclasses-noframe.html b/JavaDoc/allclasses-noframe.html index b8e1d90..9381bd5 100644 --- a/JavaDoc/allclasses-noframe.html +++ b/JavaDoc/allclasses-noframe.html @@ -2,12 +2,12 @@ - + All Classes - + @@ -31,12 +31,16 @@
FixedConstructorAndArgsLocator
-MulitDimensionalCopyConstructorAndArgsLocator +MultiDimensionalCopyConstructorAndArgsLocator
MultiDimensionalStructuredArray
StructuredArray
+UnifiedCopyConstructorAndArgsLocator +
+UnifiedStructuredArray +
diff --git a/JavaDoc/constant-values.html b/JavaDoc/constant-values.html index 88c5074..d4aae82 100644 --- a/JavaDoc/constant-values.html +++ b/JavaDoc/constant-values.html @@ -2,12 +2,12 @@ - + Constant Field Values - + diff --git a/JavaDoc/deprecated-list.html b/JavaDoc/deprecated-list.html index 0d0e445..dfa4ad9 100644 --- a/JavaDoc/deprecated-list.html +++ b/JavaDoc/deprecated-list.html @@ -2,12 +2,12 @@ - + Deprecated List - + diff --git a/JavaDoc/help-doc.html b/JavaDoc/help-doc.html index 5efd216..4273f31 100644 --- a/JavaDoc/help-doc.html +++ b/JavaDoc/help-doc.html @@ -2,12 +2,12 @@ - + API Help - + diff --git a/JavaDoc/index-files/index-1.html b/JavaDoc/index-files/index-1.html index ec6826b..ed148fb 100644 --- a/JavaDoc/index-files/index-1.html +++ b/JavaDoc/index-files/index-1.html @@ -2,12 +2,12 @@ - + A-Index - + @@ -76,7 +76,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U

A

@@ -139,7 +139,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U
diff --git a/JavaDoc/index-files/index-10.html b/JavaDoc/index-files/index-10.html index 4e66713..993b001 100644 --- a/JavaDoc/index-files/index-10.html +++ b/JavaDoc/index-files/index-10.html @@ -2,12 +2,12 @@ - + R-Index - + @@ -76,7 +76,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U

R

@@ -89,8 +89,12 @@
recycle(ConstructorAndArgs) - Method in class org.ObjectLayout.CopyConstructorAndArgsLocator
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired). -
recycle(ConstructorAndArgs) - -Method in class org.ObjectLayout.MulitDimensionalCopyConstructorAndArgsLocator +
recycle(ConstructorAndArgs) - +Method in class org.ObjectLayout.MultiDimensionalCopyConstructorAndArgsLocator +
Recycle an ConstructorAndArgs instance (place it back in the internal cache if + desired). +
recycle(ConstructorAndArgs) - +Method in class org.ObjectLayout.UnifiedCopyConstructorAndArgsLocator
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired).
remove() - @@ -99,12 +103,18 @@
remove() - Method in class org.ObjectLayout.StructuredArray.StructureIterator
Remove operation is not supported on StructuredArrays. +
remove() - +Method in class org.ObjectLayout.UnifiedStructuredArray.StructureIterator +
Remove operation is not supported on UnifiedStructuredArrays.
reset() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator
Reset to the beginning of the collection enabling reuse of the iterator.
reset() - Method in class org.ObjectLayout.StructuredArray.StructureIterator
Reset to the beginning of the collection enabling reuse of the iterator. +
reset() - +Method in class org.ObjectLayout.UnifiedStructuredArray.StructureIterator +
Reset to the beginning of the collection enabling reuse of the iterator.

@@ -157,7 +167,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U
diff --git a/JavaDoc/index-files/index-11.html b/JavaDoc/index-files/index-11.html index 4467e4e..2bf4a1c 100644 --- a/JavaDoc/index-files/index-11.html +++ b/JavaDoc/index-files/index-11.html @@ -2,12 +2,12 @@ - + S-Index - + @@ -54,7 +54,7 @@  PREV LETTER  - NEXT LETTERNEXT LETTER FRAMES    NO FRAMES   @@ -76,7 +76,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U

S

@@ -95,7 +95,7 @@
StructuredArray<T> - Class in org.ObjectLayout
An array of (potentially) mutable but non-replaceable objects.
StructuredArray(ConstructorAndArgsLocator<T>, long, long[]) - Constructor for class org.ObjectLayout.StructuredArray
  -
StructuredArray.StructureIterator - Class in org.ObjectLayout
Specialised Iterator with the ability to be reset() enabling reuse.
StructuredArray.StructureIterator() - +
StructuredArray.StructureIterator - Class in org.ObjectLayout
Specialised Iterator with the ability to be StructuredArray.StructureIterator.reset() enabling reuse.
StructuredArray.StructureIterator() - Constructor for class org.ObjectLayout.StructuredArray.StructureIterator
 
@@ -128,7 +128,7 @@  PREV LETTER  - NEXT LETTERNEXT LETTER
FRAMES    NO FRAMES   @@ -150,7 +150,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U
diff --git a/JavaDoc/index-files/index-12.html b/JavaDoc/index-files/index-12.html index 4049c8e..17e85e7 100644 --- a/JavaDoc/index-files/index-12.html +++ b/JavaDoc/index-files/index-12.html @@ -2,12 +2,12 @@ - + -S-Index +U-Index - + @@ -15,7 +15,7 @@ function windowTitle() { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="S-Index"; + parent.document.title="U-Index"; } } @@ -54,7 +54,7 @@  PREV LETTER  - NEXT LETTER + NEXT LETTER
FRAMES    NO FRAMES   @@ -76,135 +76,25 @@ -A C E F G H I M N O R S T
-

-S

+A C F G H I M N O R S U
+

+U

-
setConstructor(Constructor<T>) - -Method in class org.ObjectLayout.ConstructorAndArgs -
Set the constructor to be indicated in this ConstructorAndArgs. -
setConstructorArgs(Object[]) - -Method in class org.ObjectLayout.ConstructorAndArgs -
Set the constructor arguments to be indicated in this ConstructorAndArgs. -
setIndex(long) - -Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest.MockStructure -
  -
setIndex(long) - -Method in class org.ObjectLayout.StructuredArrayTest.MockStructure -
  -
setTestValue(long) - -Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest.MockStructure -
  -
setTestValue(long) - -Method in class org.ObjectLayout.StructuredArrayTest.MockStructure -
  -
shallowCopy(StructuredArray, long, StructuredArray, long, long) - -Static method in class org.ObjectLayout.StructuredArray -
Shallow copy a region of element object contents from one array to the other. -
shallowCopy(StructuredArray, long, StructuredArray, long, long, boolean) - -Static method in class org.ObjectLayout.StructuredArray -
Shallow copy a region of element object contents from one array to the other. -
shouldConstructArrayElementsViaElementConstructorGenerator() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest -
  -
shouldConstructArrayElementsViaElementConstructorGenerator() - -Method in class org.ObjectLayout.StructuredArrayTest -
  -
shouldConstructArrayOfGivenDirectLengths() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest -
  -
shouldConstructArrayOfGivenLength() - -Method in class org.ObjectLayout.StructuredArrayTest -
  -
shouldConstructArrayOfGivenLengthAndInitValues() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest -
  -
shouldConstructArrayOfGivenLengthAndInitValues() - -Method in class org.ObjectLayout.StructuredArrayTest -
  -
shouldConstructArrayOfGivenLengthsLongArray() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest -
  -
shouldConstructArrayOfGivenLengthsPrimitiveLongArray() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest -
  -
shouldConstructCopyOfArray() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest -
  -
shouldConstructCopyOfArray() - -Method in class org.ObjectLayout.StructuredArrayTest -
  -
shouldConstructCopyOfArrayRange() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest -
  -
shouldConstructCopyOfArrayRange() - -Method in class org.ObjectLayout.StructuredArrayTest -
  -
shouldCopyEvenWithFinalFields() - -Method in class org.ObjectLayout.StructuredArrayTest -
  -
shouldCopyRegionLeftInArray() - -Method in class org.ObjectLayout.StructuredArrayTest -
  -
shouldCopyRegionRightInArray() - -Method in class org.ObjectLayout.StructuredArrayTest -
  -
shouldIterateOverArray() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest -
  -
shouldIterateOverArray() - -Method in class org.ObjectLayout.StructuredArrayTest -
  -
shouldIterateOverArrayAndResetAgain() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest -
  -
shouldIterateOverArrayAndResetAgain() - -Method in class org.ObjectLayout.StructuredArrayTest -
  -
shouldSetAndGetCorrectValueAtGivenIndex() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest -
  -
shouldSetAndGetCorrectValueAtGivenIndex() - -Method in class org.ObjectLayout.StructuredArrayTest -
  -
shouldThrowExceptionWhenFinalFieldWouldBeCopied() - -Method in class org.ObjectLayout.StructuredArrayTest -
  -
shouldThrowIncompatibleTypeExceptionForGetOfAnArrayInsteadOfElement() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest -
  -
shouldThrowIncompatibleTypeExceptionForGetOfWrongMultiDimensionalStructuredArrayType() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest -
  -
shouldThrowIncompatibleTypeExceptionForGetOfWrongStructuredArrayType() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest -
  -
shouldThrowOutOfBoundExceptionForAccessesOutOfBounds() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArrayTest -
  -
shouldThrowOutOfBoundExceptionForAccessesOutOfBounds() - -Method in class org.ObjectLayout.StructuredArrayTest -
  -
StructuredArray<T> - Class in org.ObjectLayout
An array of (potentially) mutable but non-replaceable objects.
StructuredArray(ConstructorAndArgsLocator<T>, long, long[]) - -Constructor for class org.ObjectLayout.StructuredArray -
  -
StructuredArray.StructureIterator - Class in org.ObjectLayout
Specialised Iterator with the ability to be StructuredArray.StructureIterator.reset() enabling reuse.
StructuredArray.StructureIterator() - -Constructor for class org.ObjectLayout.StructuredArray.StructureIterator -
  -
StructuredArrayTest - Class in org.ObjectLayout
 
StructuredArrayTest() - -Constructor for class org.ObjectLayout.StructuredArrayTest -
  -
StructuredArrayTest.MockStructure - Class in org.ObjectLayout
 
StructuredArrayTest.MockStructure() - -Constructor for class org.ObjectLayout.StructuredArrayTest.MockStructure -
  -
StructuredArrayTest.MockStructure(long, long) - -Constructor for class org.ObjectLayout.StructuredArrayTest.MockStructure -
  -
StructuredArrayTest.MockStructure(StructuredArrayTest.MockStructure) - -Constructor for class org.ObjectLayout.StructuredArrayTest.MockStructure -
  -
StructuredArrayTest.MockStructureWithFinalField - Class in org.ObjectLayout
 
StructuredArrayTest.MockStructureWithFinalField() - -Constructor for class org.ObjectLayout.StructuredArrayTest.MockStructureWithFinalField +
UnifiedCopyConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports the construction of a new array's individual elements using a copy constructor to copy a source + array's corresponding elements.
UnifiedCopyConstructorAndArgsLocator(Class<T>, UnifiedStructuredArray<T>) - +Constructor for class org.ObjectLayout.UnifiedCopyConstructorAndArgsLocator +
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array +
UnifiedCopyConstructorAndArgsLocator(Class<T>, UnifiedStructuredArray<T>, long[]) - +Constructor for class org.ObjectLayout.UnifiedCopyConstructorAndArgsLocator +
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +
UnifiedCopyConstructorAndArgsLocator(Class<T>, UnifiedStructuredArray<T>, long[], boolean) - +Constructor for class org.ObjectLayout.UnifiedCopyConstructorAndArgsLocator +
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +
UnifiedStructuredArray<T> - Class in org.ObjectLayout
An array of (potentially) mutable but non-replaceable objects.
UnifiedStructuredArray.StructureIterator - Class in org.ObjectLayout
Specialised Iterator with the ability to be reset() enabling reuse.
UnifiedStructuredArray.StructureIterator() - +Constructor for class org.ObjectLayout.UnifiedStructuredArray.StructureIterator
 

@@ -236,7 +126,7 @@  PREV LETTER  - NEXT LETTER + NEXT LETTER
FRAMES    NO FRAMES   @@ -258,7 +148,7 @@ -A C E F G H I M N O R S T
+A C F G H I M N O R S U
diff --git a/JavaDoc/index-files/index-2.html b/JavaDoc/index-files/index-2.html index 86d51dd..e0d827d 100644 --- a/JavaDoc/index-files/index-2.html +++ b/JavaDoc/index-files/index-2.html @@ -2,12 +2,12 @@ - + C-Index - + @@ -76,7 +76,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U

C

@@ -115,6 +115,15 @@
copyInstance(StructuredArray<T>, long, long) - Static method in class org.ObjectLayout.StructuredArray
Copy a range from an array of elements to a newly created array. +
copyInstance(UnifiedStructuredArray<T>) - +Static method in class org.ObjectLayout.UnifiedStructuredArray +
Copy an array of elements to a newly created array. +
copyInstance(UnifiedStructuredArray<T>, long[], Long...) - +Static method in class org.ObjectLayout.UnifiedStructuredArray +
Copy a range from an array of elements to a newly created array. +
copyInstance(UnifiedStructuredArray<T>, long[], long[]) - +Static method in class org.ObjectLayout.UnifiedStructuredArray +
Copy a range from an array of elements to a newly created array.

@@ -167,7 +176,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U
diff --git a/JavaDoc/index-files/index-3.html b/JavaDoc/index-files/index-3.html index ec90657..6f67f25 100644 --- a/JavaDoc/index-files/index-3.html +++ b/JavaDoc/index-files/index-3.html @@ -2,12 +2,12 @@ - + F-Index - + @@ -76,7 +76,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U

F

@@ -142,7 +142,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U
diff --git a/JavaDoc/index-files/index-4.html b/JavaDoc/index-files/index-4.html index 6cf00cb..83adcdb 100644 --- a/JavaDoc/index-files/index-4.html +++ b/JavaDoc/index-files/index-4.html @@ -2,12 +2,12 @@ - + G-Index - + @@ -76,7 +76,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U

G

@@ -95,6 +95,21 @@
get(int) - Method in class org.ObjectLayout.StructuredArray
Get a reference to an element in the array, using an int index. +
get(Integer...) - +Method in class org.ObjectLayout.UnifiedStructuredArray +
Get a reference to an element in the array, using a varargs int indexes. +
get(int, int) - +Method in class org.ObjectLayout.UnifiedStructuredArray +
Get a reference to an element in the array, using 2 int indexes. +
get(int, int, int) - +Method in class org.ObjectLayout.UnifiedStructuredArray +
Get a reference to an element in the array, using 3 int indexes. +
get(int, int, int, int) - +Method in class org.ObjectLayout.UnifiedStructuredArray +
Get a reference to an element in the array, using 4 int indexes. +
get(int) - +Method in class org.ObjectLayout.UnifiedStructuredArray +
Get a reference to an element in the array, using an int index.
getConstructor() - Method in class org.ObjectLayout.ConstructorAndArgs
  @@ -104,6 +119,9 @@
getCursors() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator
  +
getCursors() - +Method in class org.ObjectLayout.UnifiedStructuredArray.StructureIterator +
 
getElementClass() - Method in class org.ObjectLayout.ConstructorAndArgsLocator
Get the Class of the elements to be constructed @@ -113,6 +131,9 @@
getElementClass() - Method in class org.ObjectLayout.StructuredArray
Get the Class of elements stored in the array. +
getElementClass() - +Method in class org.ObjectLayout.UnifiedStructuredArray +
Get the Class of elements stored in the array.
getForIndex(long) - Method in class org.ObjectLayout.ArrayConstructorAndArgsLocator
Get a ConstructorAndArgs instance to be used in constructing a given element index in @@ -132,8 +153,12 @@ Method in class org.ObjectLayout.FixedConstructorAndArgsLocator
Get a ConstructorAndArgs instance to be used in constructing a given element index in a StructuredArray. -
getForIndexes(long[]) - -Method in class org.ObjectLayout.MulitDimensionalCopyConstructorAndArgsLocator +
getForIndexes(long[]) - +Method in class org.ObjectLayout.MultiDimensionalCopyConstructorAndArgsLocator +
Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray. +
getForIndexes(long[]) - +Method in class org.ObjectLayout.UnifiedCopyConstructorAndArgsLocator
Get a ConstructorAndArgs instance to be used in constructing a given element index in a StructuredArray.
getL(long[]) - @@ -157,33 +182,72 @@
getL(long) - Method in class org.ObjectLayout.StructuredArray
Get a reference to an element in the array, using a long index. +
getL(long[]) - +Method in class org.ObjectLayout.UnifiedStructuredArray +
Get a reference to an element in the array, using a long[] index array. +
getL(long[], int) - +Method in class org.ObjectLayout.UnifiedStructuredArray +
Get a reference to an element in the array, using long indexes supplied in an array. +
getL(Long...) - +Method in class org.ObjectLayout.UnifiedStructuredArray +
Get a reference to an element in the array, using a varargs long indexes. +
getL(long, long) - +Method in class org.ObjectLayout.UnifiedStructuredArray +
Get a reference to an element in the array, using 2 long indexes. +
getL(long, long, long) - +Method in class org.ObjectLayout.UnifiedStructuredArray +
Get a reference to an element in the array, using 3 long indexes. +
getL(long, long, long, long) - +Method in class org.ObjectLayout.UnifiedStructuredArray +
Get a reference to an element in the array, using 4 long indexes. +
getL(long) - +Method in class org.ObjectLayout.UnifiedStructuredArray +
Get a reference to an element in the array, using a long index.
getLength() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
Get the length (number of elements) of the array.
getLength() - Method in class org.ObjectLayout.StructuredArray
Get the length (number of elements) of the array. +
getLength() - +Method in class org.ObjectLayout.UnifiedStructuredArray +
Get the length (number of elements) of the array.
getLengths() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
Get the lengths (number of elements per dimension) of the array. +
getLengths() - +Method in class org.ObjectLayout.UnifiedStructuredArray +
Get the lengths (number of elements per dimension) of the array.
getNumOfDimensions() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
Get the number of dimensions of the array. +
getNumOfDimensions() - +Method in class org.ObjectLayout.UnifiedStructuredArray +
Get the number of dimensions of the array.
getOfMultiDimensionalStructuredArray(int) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
Get a reference to a MultiDimensionalStructuredArray element in this array, using a int index.
getOfMultiDimensionalStructuredArrayL(long) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get a reference to a StructuredArray element in this array, using a int index. +
Get a reference to a StructuredArray element in this array, using a long index.
getOfStructuredArray(int) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get a reference to a MultiDimensionalStructuredArray element in this array, using a long index. +
Get a reference to a MultiDimensionalStructuredArray element in this array, using a int index.
getOfStructuredArrayL(long) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
Get a reference to a StructuredArray element in this array, using a long index. +
getOfUnifiedStructuredArray(int) - +Method in class org.ObjectLayout.UnifiedStructuredArray +
Get a reference to a UnifiedStructuredArray element in this array, using a int index. +
getOfUnifiedStructuredArrayL(long) - +Method in class org.ObjectLayout.UnifiedStructuredArray +
Get a reference to a UnifiedStructuredArray element in this array, using a long index.
getTotalElementCount() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
Get the total number of elements (in all dimensions combined) in this multi-dimensional array. +
getTotalElementCount() - +Method in class org.ObjectLayout.UnifiedStructuredArray +
Get the total number of elements (in all dimensions combined) in this multi-dimensional array.

@@ -236,7 +300,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U
diff --git a/JavaDoc/index-files/index-5.html b/JavaDoc/index-files/index-5.html index e48ed3e..1c1efa1 100644 --- a/JavaDoc/index-files/index-5.html +++ b/JavaDoc/index-files/index-5.html @@ -2,12 +2,12 @@ - + H-Index - + @@ -76,7 +76,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U

H

@@ -86,6 +86,9 @@
hasNext() - Method in class org.ObjectLayout.StructuredArray.StructureIterator
+
hasNext() - +Method in class org.ObjectLayout.UnifiedStructuredArray.StructureIterator +

@@ -138,7 +141,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U
diff --git a/JavaDoc/index-files/index-6.html b/JavaDoc/index-files/index-6.html index 8f477e0..24aa9fd 100644 --- a/JavaDoc/index-files/index-6.html +++ b/JavaDoc/index-files/index-6.html @@ -2,12 +2,12 @@ - + I-Index - + @@ -76,7 +76,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U

I

@@ -86,6 +86,9 @@
iterator() - Method in class org.ObjectLayout.StructuredArray
+
iterator() - +Method in class org.ObjectLayout.UnifiedStructuredArray +

@@ -138,7 +141,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U
diff --git a/JavaDoc/index-files/index-7.html b/JavaDoc/index-files/index-7.html index 7dac0cf..0984812 100644 --- a/JavaDoc/index-files/index-7.html +++ b/JavaDoc/index-files/index-7.html @@ -2,12 +2,12 @@ - + M-Index - + @@ -76,21 +76,21 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U

M

-
MulitDimensionalCopyConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports the construction of a new array's individual elements using a copy constructor to copy a source - array's corresponding elements.
MulitDimensionalCopyConstructorAndArgsLocator(Class<T>, MultiDimensionalStructuredArray<T>) - -Constructor for class org.ObjectLayout.MulitDimensionalCopyConstructorAndArgsLocator +
MultiDimensionalCopyConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports the construction of a new array's individual elements using a copy constructor to copy a source + array's corresponding elements.
MultiDimensionalCopyConstructorAndArgsLocator(Class<T>, MultiDimensionalStructuredArray<T>) - +Constructor for class org.ObjectLayout.MultiDimensionalCopyConstructorAndArgsLocator
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a source array -
MulitDimensionalCopyConstructorAndArgsLocator(Class<T>, MultiDimensionalStructuredArray<T>, long[]) - -Constructor for class org.ObjectLayout.MulitDimensionalCopyConstructorAndArgsLocator +
MultiDimensionalCopyConstructorAndArgsLocator(Class<T>, MultiDimensionalStructuredArray<T>, long[]) - +Constructor for class org.ObjectLayout.MultiDimensionalCopyConstructorAndArgsLocator
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a source array, starting at a given offset -
MulitDimensionalCopyConstructorAndArgsLocator(Class<T>, MultiDimensionalStructuredArray<T>, long[], boolean) - -Constructor for class org.ObjectLayout.MulitDimensionalCopyConstructorAndArgsLocator +
MultiDimensionalCopyConstructorAndArgsLocator(Class<T>, MultiDimensionalStructuredArray<T>, long[], boolean) - +Constructor for class org.ObjectLayout.MultiDimensionalCopyConstructorAndArgsLocator
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a source array, starting at a given offset
MultiDimensionalStructuredArray<T> - Class in org.ObjectLayout
An array of (potentially) mutable but non-replaceable objects.
MultiDimensionalStructuredArray.StructureIterator - Class in org.ObjectLayout
Specialised Iterator with the ability to be MultiDimensionalStructuredArray.StructureIterator.reset() enabling reuse.
MultiDimensionalStructuredArray.StructureIterator() - @@ -148,7 +148,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U
diff --git a/JavaDoc/index-files/index-8.html b/JavaDoc/index-files/index-8.html index e5e779d..30c1a7d 100644 --- a/JavaDoc/index-files/index-8.html +++ b/JavaDoc/index-files/index-8.html @@ -2,12 +2,12 @@ - + N-Index - + @@ -76,7 +76,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U

N

@@ -107,12 +107,42 @@ Static method in class org.ObjectLayout.StructuredArray
Create an array of length elements, each containing an element object of type elementClass. +
newInstance(Class<T>, long) - +Static method in class org.ObjectLayout.UnifiedStructuredArray +
Create an array of length elements, each containing an element object of + type elementClass. +
newInstance(ConstructorAndArgsLocator<T>, long) - +Static method in class org.ObjectLayout.UnifiedStructuredArray +
Create an array of length elements, each containing an element object of + type elementClass. +
newInstance(Class<T>, long, Class[], Object...) - +Static method in class org.ObjectLayout.UnifiedStructuredArray +
Create an array of length elements, each containing an element object of + type elementClass. +
newInstance(Class, Long...) - +Static method in class org.ObjectLayout.UnifiedStructuredArray +
Create a multi dimensional array of elements. +
newInstance(Class<T>, long[]) - +Static method in class org.ObjectLayout.UnifiedStructuredArray +
Create a multi dimensional array of elements. +
newInstance(Class<T>, long[], Class[], Object...) - +Static method in class org.ObjectLayout.UnifiedStructuredArray +
Create a multi dimensional array of elements. +
newInstance(ConstructorAndArgsLocator<T>, Long...) - +Static method in class org.ObjectLayout.UnifiedStructuredArray +
Create a multi dimensional array of elements. +
newInstance(ConstructorAndArgsLocator<T>, long[]) - +Static method in class org.ObjectLayout.UnifiedStructuredArray +
Create a multi dimensional array of elements.
next() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator
next() - Method in class org.ObjectLayout.StructuredArray.StructureIterator
+
next() - +Method in class org.ObjectLayout.UnifiedStructuredArray.StructureIterator +

@@ -165,7 +195,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U
diff --git a/JavaDoc/index-files/index-9.html b/JavaDoc/index-files/index-9.html index 908f313..8693d28 100644 --- a/JavaDoc/index-files/index-9.html +++ b/JavaDoc/index-files/index-9.html @@ -2,12 +2,12 @@ - + O-Index - + @@ -76,7 +76,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U

O

@@ -132,7 +132,7 @@ -A C F G H I M N O R S
+A C F G H I M N O R S U
diff --git a/JavaDoc/index.html b/JavaDoc/index.html index 2950f1b..7a9fd5b 100644 --- a/JavaDoc/index.html +++ b/JavaDoc/index.html @@ -2,7 +2,7 @@ - + Generated Documentation (Untitled) diff --git a/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html index 26e60d2..880e24f 100644 --- a/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + ArrayConstructorAndArgsLocator - + diff --git a/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html b/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html index 56628fd..e7c4699 100644 --- a/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html +++ b/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html @@ -2,12 +2,12 @@ - + ConstructorAndArgs - + diff --git a/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html index 8989cb2..1e05704 100644 --- a/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + ConstructorAndArgsLocator - + @@ -96,7 +96,7 @@

Type Parameters:
T - type of the element occupying each array slot.
-
Direct Known Subclasses:
ArrayConstructorAndArgsLocator, CopyConstructorAndArgsLocator, FixedConstructorAndArgsLocator, MulitDimensionalCopyConstructorAndArgsLocator
+
Direct Known Subclasses:
ArrayConstructorAndArgsLocator, CopyConstructorAndArgsLocator, FixedConstructorAndArgsLocator, MultiDimensionalCopyConstructorAndArgsLocator, UnifiedCopyConstructorAndArgsLocator

diff --git a/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html index d212851..478f6f1 100644 --- a/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + CopyConstructorAndArgsLocator - + diff --git a/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html index 8f09290..49619a2 100644 --- a/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + FixedConstructorAndArgsLocator - + @@ -54,7 +54,7 @@  PREV CLASS  - NEXT CLASSNEXT CLASS FRAMES    NO FRAMES   @@ -299,7 +299,7 @@

 PREV CLASS  - NEXT CLASSNEXT CLASS FRAMES    NO FRAMES   diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalCopyConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/MultiDimensionalCopyConstructorAndArgsLocator.html new file mode 100644 index 0000000..05f5cbe --- /dev/null +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalCopyConstructorAndArgsLocator.html @@ -0,0 +1,372 @@ + + + + + + +MultiDimensionalCopyConstructorAndArgsLocator + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class MultiDimensionalCopyConstructorAndArgsLocator<T>

+
+java.lang.Object
+  extended by org.ObjectLayout.ConstructorAndArgsLocator<T>
+      extended by org.ObjectLayout.MultiDimensionalCopyConstructorAndArgsLocator<T>
+
+
+
Type Parameters:
T - type of the element occupying each array slot
+
+
+
public class MultiDimensionalCopyConstructorAndArgsLocator<T>
extends ConstructorAndArgsLocator<T>
+ + +

+Supports the construction of a new array's individual elements using a copy constructor to copy a source + array's corresponding elements. +

+ +

+


+ +

+ + + + + + + + + + + + + + + + + +
+Constructor Summary
MultiDimensionalCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass, + MultiDimensionalStructuredArray<T> source) + +
+          Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array
MultiDimensionalCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass, + MultiDimensionalStructuredArray<T> source, + long[] sourceOffsets) + +
+          Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset
MultiDimensionalCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass, + MultiDimensionalStructuredArray<T> source, + long[] sourceOffsets, + boolean keepInternalCachingThreadSafe) + +
+          Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset
+  + + + + + + + + + + + + + + + +
+Method Summary
+ ConstructorAndArgs<T>getForIndexes(long[] indexes) + +
+          Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray.
+ voidrecycle(ConstructorAndArgs constructorAndArgs) + +
+          Recycle an ConstructorAndArgs instance (place it back in the internal cache if + desired).
+ + + + + + + +
Methods inherited from class org.ObjectLayout.ConstructorAndArgsLocator
getElementClass
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+MultiDimensionalCopyConstructorAndArgsLocator

+
+public MultiDimensionalCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass,
+                                                     MultiDimensionalStructuredArray<T> source)
+                                              throws java.lang.NoSuchMethodException
+
+
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array +

+

+
Parameters:
elementClass - The class of the elements to be constructed
source - The source StructuredArray to copy from +
Throws: +
java.lang.NoSuchMethodException
+
+
+ +

+MultiDimensionalCopyConstructorAndArgsLocator

+
+public MultiDimensionalCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass,
+                                                     MultiDimensionalStructuredArray<T> source,
+                                                     long[] sourceOffsets)
+                                              throws java.lang.NoSuchMethodException
+
+
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +

+

+
Parameters:
elementClass - The class of the elements to be constructed
source - The source MultiDimensionalStructuredArray to copy from
sourceOffsets - The beginning index in the source from which to start copying +
Throws: +
java.lang.NoSuchMethodException - if a copy constructor is not found in element class
+
+
+ +

+MultiDimensionalCopyConstructorAndArgsLocator

+
+public MultiDimensionalCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass,
+                                                     MultiDimensionalStructuredArray<T> source,
+                                                     long[] sourceOffsets,
+                                                     boolean keepInternalCachingThreadSafe)
+                                              throws java.lang.NoSuchMethodException
+
+
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +

+

+
Parameters:
elementClass - The class of the elements to be constructed
source - The source MultiDimensionalStructuredArray to copy from
sourceOffsets - The beginning index in the source from which to start copying
keepInternalCachingThreadSafe - Control whether or not internal caching is kept thread-safe +
Throws: +
java.lang.NoSuchMethodException - NoSuchMethodException if a copy constructor is not found in element class
+
+ + + + + + + + +
+Method Detail
+ +

+getForIndexes

+
+public ConstructorAndArgs<T> getForIndexes(long[] indexes)
+                                    throws java.lang.NoSuchMethodException
+
+
Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray. . +

+

+
Overrides:
getForIndexes in class ConstructorAndArgsLocator<T>
+
+
+
Parameters:
indexes - The indexes of the element to be constructed in the target array +
Returns:
ConstructorAndArgs instance to used in element construction +
Throws: +
java.lang.NoSuchMethodException - if expected constructor is not found in element class
+
+
+
+ +

+recycle

+
+public void recycle(ConstructorAndArgs constructorAndArgs)
+
+
Recycle an ConstructorAndArgs instance (place it back in the internal cache if + desired). This is [very] useful for avoiding a re-allocation of a new ConstructorAndArgs + and an associated args array for getForIndexes(long[]) invocation in cases such as this (where the + returned ConstructorAndArgs is not constant across indices). + Recycling is optional, and is not guaranteed to occur. +

+

+
Overrides:
recycle in class ConstructorAndArgsLocator<T>
+
+
+
Parameters:
constructorAndArgs - the ConstructorAndArgs instance to recycle
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html index 4c1333b..2cfd6fc 100644 --- a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html @@ -2,12 +2,12 @@ - + MultiDimensionalStructuredArray.StructureIterator - + diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html index 88d9361..ef375fa 100644 --- a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html @@ -2,12 +2,12 @@ - + MultiDimensionalStructuredArray - + @@ -53,7 +53,7 @@ PREV CLASS  + PREV CLASS   NEXT CLASS FRAMES   @@ -347,7 +347,7 @@

getOfMultiDimensionalStructuredArrayL(long index)
-          Get a reference to a StructuredArray element in this array, using a int index. +          Get a reference to a StructuredArray element in this array, using a long index. @@ -355,7 +355,7 @@

getOfStructuredArray(int index)
-          Get a reference to a MultiDimensionalStructuredArray element in this array, using a long index. +          Get a reference to a MultiDimensionalStructuredArray element in this array, using a int index. @@ -972,7 +972,7 @@

public MultiDimensionalStructuredArray<T> getOfMultiDimensionalStructuredArrayL(long index) throws java.lang.ClassCastException
-
Get a reference to a StructuredArray element in this array, using a int index. +
Get a reference to a StructuredArray element in this array, using a long index.

@@ -992,7 +992,7 @@

public StructuredArray<T> getOfStructuredArray(int index) throws java.lang.ClassCastException
-
Get a reference to a MultiDimensionalStructuredArray element in this array, using a long index. +
Get a reference to a MultiDimensionalStructuredArray element in this array, using a int index.

@@ -1086,7 +1086,7 @@

PREV CLASS  + PREV CLASS   NEXT CLASS FRAMES   diff --git a/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html b/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html index b0c50c7..02398f4 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html +++ b/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html @@ -2,12 +2,12 @@ - + StructuredArray.StructureIterator - + @@ -54,7 +54,7 @@  PREV CLASS  - NEXT CLASSNEXT CLASS FRAMES    NO FRAMES   @@ -303,7 +303,7 @@

 PREV CLASS  - NEXT CLASSNEXT CLASS FRAMES    NO FRAMES   diff --git a/JavaDoc/org/ObjectLayout/StructuredArray.html b/JavaDoc/org/ObjectLayout/StructuredArray.html index ef737e0..6d3776a 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArray.html +++ b/JavaDoc/org/ObjectLayout/StructuredArray.html @@ -2,12 +2,12 @@ - + StructuredArray - + diff --git a/JavaDoc/org/ObjectLayout/UnifiedCopyConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/UnifiedCopyConstructorAndArgsLocator.html new file mode 100644 index 0000000..b7b9cf8 --- /dev/null +++ b/JavaDoc/org/ObjectLayout/UnifiedCopyConstructorAndArgsLocator.html @@ -0,0 +1,372 @@ + + + + + + +UnifiedCopyConstructorAndArgsLocator + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class UnifiedCopyConstructorAndArgsLocator<T>

+
+java.lang.Object
+  extended by org.ObjectLayout.ConstructorAndArgsLocator<T>
+      extended by org.ObjectLayout.UnifiedCopyConstructorAndArgsLocator<T>
+
+
+
Type Parameters:
T - type of the element occupying each array slot
+
+
+
public class UnifiedCopyConstructorAndArgsLocator<T>
extends ConstructorAndArgsLocator<T>
+ + +

+Supports the construction of a new array's individual elements using a copy constructor to copy a source + array's corresponding elements. +

+ +

+


+ +

+ + + + + + + + + + + + + + + + + +
+Constructor Summary
UnifiedCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass, + UnifiedStructuredArray<T> source) + +
+          Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array
UnifiedCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass, + UnifiedStructuredArray<T> source, + long[] sourceOffsets) + +
+          Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset
UnifiedCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass, + UnifiedStructuredArray<T> source, + long[] sourceOffsets, + boolean keepInternalCachingThreadSafe) + +
+          Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset
+  + + + + + + + + + + + + + + + +
+Method Summary
+ ConstructorAndArgs<T>getForIndexes(long[] indexes) + +
+          Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray.
+ voidrecycle(ConstructorAndArgs constructorAndArgs) + +
+          Recycle an ConstructorAndArgs instance (place it back in the internal cache if + desired).
+ + + + + + + +
Methods inherited from class org.ObjectLayout.ConstructorAndArgsLocator
getElementClass
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+UnifiedCopyConstructorAndArgsLocator

+
+public UnifiedCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass,
+                                            UnifiedStructuredArray<T> source)
+                                     throws java.lang.NoSuchMethodException
+
+
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array +

+

+
Parameters:
elementClass - The class of the elements to be constructed
source - The source StructuredArray to copy from +
Throws: +
java.lang.NoSuchMethodException
+
+
+ +

+UnifiedCopyConstructorAndArgsLocator

+
+public UnifiedCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass,
+                                            UnifiedStructuredArray<T> source,
+                                            long[] sourceOffsets)
+                                     throws java.lang.NoSuchMethodException
+
+
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +

+

+
Parameters:
elementClass - The class of the elements to be constructed
source - The source MultiDimensionalStructuredArray to copy from
sourceOffsets - The beginning index in the source from which to start copying +
Throws: +
java.lang.NoSuchMethodException - if a copy constructor is not found in element class
+
+
+ +

+UnifiedCopyConstructorAndArgsLocator

+
+public UnifiedCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass,
+                                            UnifiedStructuredArray<T> source,
+                                            long[] sourceOffsets,
+                                            boolean keepInternalCachingThreadSafe)
+                                     throws java.lang.NoSuchMethodException
+
+
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +

+

+
Parameters:
elementClass - The class of the elements to be constructed
source - The source MultiDimensionalStructuredArray to copy from
sourceOffsets - The beginning index in the source from which to start copying
keepInternalCachingThreadSafe - Control whether or not internal caching is kept thread-safe +
Throws: +
java.lang.NoSuchMethodException - NoSuchMethodException if a copy constructor is not found in element class
+
+ + + + + + + + +
+Method Detail
+ +

+getForIndexes

+
+public ConstructorAndArgs<T> getForIndexes(long[] indexes)
+                                    throws java.lang.NoSuchMethodException
+
+
Get a ConstructorAndArgs instance to be used in constructing a given element index in + a StructuredArray. . +

+

+
Overrides:
getForIndexes in class ConstructorAndArgsLocator<T>
+
+
+
Parameters:
indexes - The indexes of the element to be constructed in the target array +
Returns:
ConstructorAndArgs instance to used in element construction +
Throws: +
java.lang.NoSuchMethodException - if expected constructor is not found in element class
+
+
+
+ +

+recycle

+
+public void recycle(ConstructorAndArgs constructorAndArgs)
+
+
Recycle an ConstructorAndArgs instance (place it back in the internal cache if + desired). This is [very] useful for avoiding a re-allocation of a new ConstructorAndArgs + and an associated args array for getForIndexes(long[]) invocation in cases such as this (where the + returned ConstructorAndArgs is not constant across indices). + Recycling is optional, and is not guaranteed to occur. +

+

+
Overrides:
recycle in class ConstructorAndArgsLocator<T>
+
+
+
Parameters:
constructorAndArgs - the ConstructorAndArgs instance to recycle
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.StructureIterator.html b/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.StructureIterator.html new file mode 100644 index 0000000..ae5f8be --- /dev/null +++ b/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.StructureIterator.html @@ -0,0 +1,359 @@ + + + + + + +UnifiedStructuredArray.StructureIterator + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class UnifiedStructuredArray.StructureIterator

+
+java.lang.Object
+  extended by org.ObjectLayout.UnifiedStructuredArray.StructureIterator
+
+
+
All Implemented Interfaces:
java.util.Iterator<T>
+
+
+
Enclosing class:
UnifiedStructuredArray<T>
+
+
+
+
public class UnifiedStructuredArray.StructureIterator
extends java.lang.Object
implements java.util.Iterator<T>
+ + +

+Specialised Iterator with the ability to be reset() enabling reuse. +

+ +

+


+ +

+ + + + + + + + + + + +
+Constructor Summary
UnifiedStructuredArray.StructureIterator() + +
+           
+  + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+Method Summary
+ long[]getCursors() + +
+           
+ booleanhasNext() + +
+          
+ Tnext() + +
+          
+ voidremove() + +
+          Remove operation is not supported on UnifiedStructuredArrays.
+ voidreset() + +
+          Reset to the beginning of the collection enabling reuse of the iterator.
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+UnifiedStructuredArray.StructureIterator

+
+public UnifiedStructuredArray.StructureIterator()
+
+
+ + + + + + + + +
+Method Detail
+ +

+hasNext

+
+public boolean hasNext()
+
+
+

+

+
Specified by:
hasNext in interface java.util.Iterator<T>
+
+
+
+
+
+
+ +

+next

+
+public T next()
+
+
+

+

+
Specified by:
next in interface java.util.Iterator<T>
+
+
+
+
+
+
+ +

+remove

+
+public void remove()
+
+
Remove operation is not supported on UnifiedStructuredArrays. +

+

+
Specified by:
remove in interface java.util.Iterator<T>
+
+
+ +
Throws: +
java.lang.UnsupportedOperationException - if called.
+
+
+
+ +

+reset

+
+public void reset()
+
+
Reset to the beginning of the collection enabling reuse of the iterator. +

+

+
+
+
+
+
+
+
+ +

+getCursors

+
+public long[] getCursors()
+
+
+
+
+
+
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.html b/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.html new file mode 100644 index 0000000..29c6e7c --- /dev/null +++ b/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.html @@ -0,0 +1,1238 @@ + + + + + + +UnifiedStructuredArray + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class UnifiedStructuredArray<T>

+
+java.lang.Object
+  extended by org.ObjectLayout.UnifiedStructuredArray<T>
+
+
+
Type Parameters:
T - type of the element occupying each array slot.
+
+
All Implemented Interfaces:
java.lang.Iterable<T>
+
+
+
+
public final class UnifiedStructuredArray<T>
extends java.lang.Object
implements java.lang.Iterable<T>
+ + +

+An array of (potentially) mutable but non-replaceable objects. +

+ A structured array contains array element objects of a fixed (at creation time, per array instance) class, + and can support elements of any class that provides public constructors. The elements in a StructuredArray + are all allocated and constructed at array creation time, and individual elements cannot be removed or + replaced after array creation. Array elements can be accessed using an index-based accessor methods in + the form of get(java.lang.Integer...)() (for int indices) or getL(long[])() + (for long indices). Individual element contents can then be accessed and manipulated using any and all + operations supported by the member element's class. +

+ While simple creation of default-constructed elements and fixed constructor parameters are available through + the newInstance factory methods, supporting arbitrary member types requires a wider range of construction + options. The ConstructorAndArgsLocator API provides for array creation with arbitrary, user-supplied + constructors and arguments, either of which can take the element index into account. +

+ StructuredArray is designed with semantics specifically restricted to be consistent with layouts of an + array of structures in C-like languages. While fully functional on all JVM implementation (of Java SE 5 + and above), the semantics are such that a JVM may transparently optimise the implementation to provide a + compact contiguous layout that facilitates consistent stride based memory access and dead-reckoning + (as opposed to de-referenced) access to elements +

+ Note: At least for some JVM implementations, get(java.lang.Integer...)() access may be faster than + getL(long[])() access. +

+ +

+


+ +

+ + + + + + + + + + + +
+Nested Class Summary
+ classUnifiedStructuredArray.StructureIterator + +
+          Specialised Iterator with the ability to be UnifiedStructuredArray.StructureIterator.reset() enabling reuse.
+  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+Method Summary
+static + + + + +
+<T> UnifiedStructuredArray<T>
+
copyInstance(UnifiedStructuredArray<T> source) + +
+          Copy an array of elements to a newly created array.
+static + + + + +
+<T> UnifiedStructuredArray<T>
+
copyInstance(UnifiedStructuredArray<T> source, + long[] sourceOffsets, + java.lang.Long... counts) + +
+          Copy a range from an array of elements to a newly created array.
+static + + + + +
+<T> UnifiedStructuredArray<T>
+
copyInstance(UnifiedStructuredArray<T> source, + long[] sourceOffsets, + long[] counts) + +
+          Copy a range from an array of elements to a newly created array.
+ Tget(int index) + +
+          Get a reference to an element in the array, using an int index.
+ Tget(java.lang.Integer... indexes) + +
+          Get a reference to an element in the array, using a varargs int indexes.
+ Tget(int index0, + int index1) + +
+          Get a reference to an element in the array, using 2 int indexes.
+ Tget(int index0, + int index1, + int index2) + +
+          Get a reference to an element in the array, using 3 int indexes.
+ Tget(int index0, + int index1, + int index2, + int index3) + +
+          Get a reference to an element in the array, using 4 int indexes.
+ java.lang.Class<T>getElementClass() + +
+          Get the Class of elements stored in the array.
+ TgetL(java.lang.Long... indexes) + +
+          Get a reference to an element in the array, using a varargs long indexes.
+ TgetL(long index) + +
+          Get a reference to an element in the array, using a long index.
+ TgetL(long[] indexes) + +
+          Get a reference to an element in the array, using a long[] index array.
+ TgetL(long[] indexes, + int indexOffset) + +
+          Get a reference to an element in the array, using long indexes supplied in an array.
+ TgetL(long index0, + long index1) + +
+          Get a reference to an element in the array, using 2 long indexes.
+ TgetL(long index0, + long index1, + long index2) + +
+          Get a reference to an element in the array, using 3 long indexes.
+ TgetL(long index0, + long index1, + long index2, + long index3) + +
+          Get a reference to an element in the array, using 4 long indexes.
+ longgetLength() + +
+          Get the length (number of elements) of the array.
+ long[]getLengths() + +
+          Get the lengths (number of elements per dimension) of the array.
+ intgetNumOfDimensions() + +
+          Get the number of dimensions of the array.
+ UnifiedStructuredArray<T>getOfUnifiedStructuredArray(int index) + +
+          Get a reference to a UnifiedStructuredArray element in this array, using a int index.
+ UnifiedStructuredArray<T>getOfUnifiedStructuredArrayL(long index) + +
+          Get a reference to a UnifiedStructuredArray element in this array, using a long index.
+ longgetTotalElementCount() + +
+          Get the total number of elements (in all dimensions combined) in this multi-dimensional array.
+ UnifiedStructuredArray.StructureIteratoriterator() + +
+          
+static + + + + +
+<T> UnifiedStructuredArray<T>
+
newInstance(java.lang.Class<T> elementClass, + long length) + +
+          Create an array of length elements, each containing an element object of + type elementClass.
+static + + + + +
+<T> UnifiedStructuredArray<T>
+
newInstance(java.lang.Class<T> elementClass, + long[] lengths) + +
+          Create a multi dimensional array of elements.
+static + + + + +
+<T> UnifiedStructuredArray<T>
+
newInstance(java.lang.Class<T> elementClass, + long[] lengths, + java.lang.Class[] initArgTypes, + java.lang.Object... initArgs) + +
+          Create a multi dimensional array of elements.
+static + + + + +
+<T> UnifiedStructuredArray<T>
+
newInstance(java.lang.Class<T> elementClass, + long length, + java.lang.Class[] initArgTypes, + java.lang.Object... initArgs) + +
+          Create an array of length elements, each containing an element object of + type elementClass.
+static + + + + +
+<T> UnifiedStructuredArray<T>
+
newInstance(java.lang.Class elementClass, + java.lang.Long... lengths) + +
+          Create a multi dimensional array of elements.
+static + + + + +
+<T> UnifiedStructuredArray<T>
+
newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator, + java.lang.Long... lengths) + +
+          Create a multi dimensional array of elements.
+static + + + + +
+<T> UnifiedStructuredArray<T>
+
newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator, + long length) + +
+          Create an array of length elements, each containing an element object of + type elementClass.
+static + + + + +
+<T> UnifiedStructuredArray<T>
+
newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator, + long[] lengths) + +
+          Create a multi dimensional array of elements.
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Method Detail
+ +

+newInstance

+
+public static <T> UnifiedStructuredArray<T> newInstance(java.lang.Class<T> elementClass,
+                                                        long length)
+                                             throws java.lang.NoSuchMethodException
+
+
Create an array of length elements, each containing an element object of + type elementClass. Using the elementClass's default constructor. +

+

+
+
+
+
Parameters:
length - of the array to create.
elementClass - of each element in the array +
Throws: +
java.lang.NoSuchMethodException - if the element class does not have a public default constructor
+
+
+
+ +

+newInstance

+
+public static <T> UnifiedStructuredArray<T> newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator,
+                                                        long length)
+                                             throws java.lang.NoSuchMethodException
+
+
Create an array of length elements, each containing an element object of + type elementClass. Use constructor and arguments supplied (on a potentially + per element index basis) by the specified constructorAndArgsLocator to construct and initialize + each element. +

+

+
+
+
+
Parameters:
length - of the array to create.
constructorAndArgsLocator - produces element constructors [potentially] on a per element basis. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not not support a supplied constructor
+
+
+
+ +

+newInstance

+
+public static <T> UnifiedStructuredArray<T> newInstance(java.lang.Class<T> elementClass,
+                                                        long length,
+                                                        java.lang.Class[] initArgTypes,
+                                                        java.lang.Object... initArgs)
+                                             throws java.lang.NoSuchMethodException
+
+
Create an array of length elements, each containing an element object of + type elementClass. Use a fixed (same for all elements) constructor identified by the argument + classes specified in initArgs to construct and initialize each element, passing the remaining + arguments to that constructor. +

+

+
+
+
+
Parameters:
length - of the array to create.
elementClass - of each element in the array
initArgTypes - for selecting the constructor to call for initialising each structure object.
initArgs - to be passed to a constructor for initialising each structure object. +
Throws: +
java.lang.IllegalArgumentException - if initArgTypes and constructor arguments do not match in length +
java.lang.NoSuchMethodException - if initArgTypes does not match a public constructor signature in elementClass
+
+
+
+ +

+newInstance

+
+public static <T> UnifiedStructuredArray<T> newInstance(java.lang.Class elementClass,
+                                                        java.lang.Long... lengths)
+                                             throws java.lang.NoSuchMethodException
+
+
Create a multi dimensional array of elements. Each dimension of the array will be of a length designated + in the lengths parameters passed. Each element of the array will consist of + an object of type elementClass. Elements will be constructed Using the + elementClass's default constructor. +

+

+
+
+
+
Parameters:
elementClass - of each element in the array
lengths - of the array dimensions to create. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not not support a supplied constructor
+
+
+
+ +

+newInstance

+
+public static <T> UnifiedStructuredArray<T> newInstance(java.lang.Class<T> elementClass,
+                                                        long[] lengths)
+                                             throws java.lang.NoSuchMethodException
+
+
Create a multi dimensional array of elements. Each dimension of the array will be of a length designated + in the lengths[] passed. Each element of the array will consist of + an object of type elementClass. Elements will be constructed Using the + elementClass's default constructor. +

+

+
+
+
+
Parameters:
elementClass - of each element in the array
lengths - of the array dimensions to create. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not not support a supplied constructor
+
+
+
+ +

+newInstance

+
+public static <T> UnifiedStructuredArray<T> newInstance(java.lang.Class<T> elementClass,
+                                                        long[] lengths,
+                                                        java.lang.Class[] initArgTypes,
+                                                        java.lang.Object... initArgs)
+                                             throws java.lang.NoSuchMethodException
+
+
Create a multi dimensional array of elements. Each dimension of the array will be of a length designated + in the lengths[] passed. Each element of the array will consist of + an object of type elementClass. Elements will be constructed using a fixed (same for all elements) + constructor identified by the argument classes specified in initArgTypes to construct and + initialize each element, passing the initArgs arguments to that constructor. +

+

+
+
+
+
Parameters:
elementClass - of each element in the array
lengths - of the array dimensions to create.
initArgTypes - for selecting the constructor to call for initialising each structure object.
initArgs - to be passed to a constructor for initialising each structure object. +
Throws: +
java.lang.IllegalArgumentException - if initArgTypes and constructor arguments do not match in length +
java.lang.NoSuchMethodException - if initArgTypes does not match a public constructor signature in elementClass
+
+
+
+ +

+newInstance

+
+public static <T> UnifiedStructuredArray<T> newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator,
+                                                        java.lang.Long... lengths)
+                                             throws java.lang.NoSuchMethodException
+
+
Create a multi dimensional array of elements. Each dimension of the array will be of a length designated + in the lengths arguments passed. Each element of the array will consist of + an object of type elementClass. Elements will be constructed using the constructor and arguments + supplied (on a potentially per element index basis) by the specified constructorAndArgsLocator. + to construct and initialize each element. +

+

+
+
+
+
Parameters:
constructorAndArgsLocator - produces element constructors [potentially] on a per element basis.
lengths - of the array dimensions to create. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not not support a supplied constructor
+
+
+
+ +

+newInstance

+
+public static <T> UnifiedStructuredArray<T> newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator,
+                                                        long[] lengths)
+                                             throws java.lang.NoSuchMethodException
+
+
Create a multi dimensional array of elements. Each dimension of the array will be of a length designated + in the lengths[] passed. Each element of the array will consist of + an object of type elementClass. Elements will be constructed using the constructor and arguments + supplied (on a potentially per element index basis) by the specified constructorAndArgsLocator. + to construct and initialize each element. +

+

+
+
+
+
Parameters:
constructorAndArgsLocator - produces element constructors [potentially] on a per element basis.
lengths - of the array dimensions to create. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not not support a supplied constructor
+
+
+
+ +

+copyInstance

+
+public static <T> UnifiedStructuredArray<T> copyInstance(UnifiedStructuredArray<T> source)
+                                              throws java.lang.NoSuchMethodException
+
+
Copy an array of elements to a newly created array. Copying of individual elements is done by using + the elementClass copy constructor to construct the individual member elements of the new + array based on the corresponding elements of the source array. +

+

+
+
+
+
Parameters:
source - The array to duplicate. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not have a public copy constructor.
+
+
+
+ +

+copyInstance

+
+public static <T> UnifiedStructuredArray<T> copyInstance(UnifiedStructuredArray<T> source,
+                                                         long[] sourceOffsets,
+                                                         java.lang.Long... counts)
+                                              throws java.lang.NoSuchMethodException
+
+
Copy a range from an array of elements to a newly created array. Copying of individual elements is done + by using the elementClass copy constructor to construct the individual member elements of + the new array based on the corresponding elements of the source array. +

+

+
+
+
+
Parameters:
source - The array to copy from.
sourceOffsets - offset indexes for each dimension, indicating where the source region to be copied begins.
counts - the number of elements in each dimension to copy. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not have a public copy constructor.
+
+
+
+ +

+copyInstance

+
+public static <T> UnifiedStructuredArray<T> copyInstance(UnifiedStructuredArray<T> source,
+                                                         long[] sourceOffsets,
+                                                         long[] counts)
+                                              throws java.lang.NoSuchMethodException
+
+
Copy a range from an array of elements to a newly created array. Copying of individual elements is done + by using the elementClass copy constructor to construct the individual member elements of + the new array based on the corresponding elements of the source array. +

+

+
+
+
+
Parameters:
source - The array to copy from.
sourceOffsets - offset indexes for each dimension, indicating where the source region to be copied begins.
counts - the number of elements in each dimension to copy. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not have a public copy constructor.
+
+
+
+ +

+getNumOfDimensions

+
+public int getNumOfDimensions()
+
+
Get the number of dimensions of the array. +

+

+
+
+
+ +
Returns:
the number of dimensions of the array.
+
+
+
+ +

+getLengths

+
+public long[] getLengths()
+
+
Get the lengths (number of elements per dimension) of the array. +

+

+
+
+
+ +
Returns:
the number of elements in each dimension in the array.
+
+
+
+ +

+getTotalElementCount

+
+public long getTotalElementCount()
+
+
Get the total number of elements (in all dimensions combined) in this multi-dimensional array. +

+

+
+
+
+ +
Returns:
the total number of elements (in all dimensions combined) in the array.
+
+
+
+ +

+getLength

+
+public long getLength()
+
+
Get the length (number of elements) of the array. +

+

+
+
+
+ +
Returns:
the number of elements in the array.
+
+
+
+ +

+getL

+
+public T getL(long[] indexes)
+
+
Get a reference to an element in the array, using a long[] index array. +

+

+
+
+
+
Parameters:
indexes - The indexes (at each dimension) of the element to retrieve. +
Returns:
a reference to the indexed element.
+
+
+
+ +

+getL

+
+public T getL(long[] indexes,
+              int indexOffset)
+
+
Get a reference to an element in the array, using long indexes supplied in an array. + indexOffset indicates the starting point in the array at which the first index should be found. + This form is useful when passing index arrays through multiple levels to avoid construction of + temporary varargs containers or construction of new shorter index arrays. +

+

+
+
+
+
Parameters:
indexes - The indexes (at each dimension) of the element to retrieve.
indexOffset - The beginning offset in the indexes array related to this arrays contents. +
Returns:
a reference to the indexed element.
+
+
+
+ +

+getL

+
+public T getL(java.lang.Long... indexes)
+
+
Get a reference to an element in the array, using a varargs long indexes. +

+

+
+
+
+
Parameters:
indexes - The indexes (at each dimension) of the element to retrieve. +
Returns:
a reference to the indexed element.
+
+
+
+ +

+get

+
+public T get(java.lang.Integer... indexes)
+
+
Get a reference to an element in the array, using a varargs int indexes. +

+

+
+
+
+
Parameters:
indexes - The indexes (at each dimension) of the element to retrieve. +
Returns:
a reference to the indexed element.
+
+
+
+ +

+getL

+
+public T getL(long index0,
+              long index1)
+       throws java.lang.ClassCastException
+
+
Get a reference to an element in the array, using 2 long indexes. +

+

+
+
+
+
Parameters:
index0 -
index1 - +
Returns:
the element at [index0, index1] +
Throws: +
java.lang.ClassCastException - if number of indexes does not match number of dimensions in the array
+
+
+
+ +

+getL

+
+public T getL(long index0,
+              long index1,
+              long index2)
+       throws java.lang.ClassCastException
+
+
Get a reference to an element in the array, using 3 long indexes. +

+

+
+
+
+
Parameters:
index0 -
index1 -
index2 - +
Returns:
the element at [index0, index1, index2] +
Throws: +
java.lang.ClassCastException - if number of indexes does not match number of dimensions in the array
+
+
+
+ +

+getL

+
+public T getL(long index0,
+              long index1,
+              long index2,
+              long index3)
+       throws java.lang.ClassCastException
+
+
Get a reference to an element in the array, using 4 long indexes. +

+

+
+
+
+
Parameters:
index0 -
index1 -
index2 -
index3 - +
Returns:
the element at [index0, index1, index2, index3] +
Throws: +
java.lang.ClassCastException - if number of indexes does not match number of dimensions in the array
+
+
+
+ +

+get

+
+public T get(int index0,
+             int index1)
+      throws java.lang.ClassCastException
+
+
Get a reference to an element in the array, using 2 int indexes. +

+

+
+
+
+
Parameters:
index0 -
index1 - +
Returns:
the element at [index0, index1] +
Throws: +
java.lang.ClassCastException - if number of indexes does not match number of dimensions in the array
+
+
+
+ +

+get

+
+public T get(int index0,
+             int index1,
+             int index2)
+      throws java.lang.ClassCastException
+
+
Get a reference to an element in the array, using 3 int indexes. +

+

+
+
+
+
Parameters:
index0 -
index1 -
index2 - +
Returns:
the element at [index0, index1, index2] +
Throws: +
java.lang.ClassCastException - if number of indexes does not match number of dimensions in the array
+
+
+
+ +

+get

+
+public T get(int index0,
+             int index1,
+             int index2,
+             int index3)
+      throws java.lang.ClassCastException
+
+
Get a reference to an element in the array, using 4 int indexes. +

+

+
+
+
+
Parameters:
index0 -
index1 -
index2 -
index3 - +
Returns:
the element at [index0, index1, index2, index3] +
Throws: +
java.lang.ClassCastException - if number of indexes does not match number of dimensions in the array
+
+
+
+ +

+getOfUnifiedStructuredArrayL

+
+public UnifiedStructuredArray<T> getOfUnifiedStructuredArrayL(long index)
+                                                       throws java.lang.ClassCastException
+
+
Get a reference to a UnifiedStructuredArray element in this array, using a long index. +

+

+
+
+
+
Parameters:
index - +
Returns:
a reference to the UnifiedStructuredArray located in element [index] of this array +
Throws: +
java.lang.ClassCastException - if array has less than two dimensions
+
+
+
+ +

+getOfUnifiedStructuredArray

+
+public UnifiedStructuredArray<T> getOfUnifiedStructuredArray(int index)
+                                                      throws java.lang.ClassCastException
+
+
Get a reference to a UnifiedStructuredArray element in this array, using a int index. +

+

+
+
+
+
Parameters:
index - +
Returns:
a reference to the UnifiedStructuredArray located in element [index] of this array +
Throws: +
java.lang.ClassCastException - if array has less than two dimensions
+
+
+
+ +

+getL

+
+public T getL(long index)
+
+
Get a reference to an element in the array, using a long index. +

+

+
+
+
+
Parameters:
index - of the element to retrieve. +
Returns:
a reference to the indexed element.
+
+
+
+ +

+get

+
+public T get(int index)
+
+
Get a reference to an element in the array, using an int index. +

+

+
+
+
+
Parameters:
index - of the element to retrieve. +
Returns:
a reference to the indexed element.
+
+
+
+ +

+getElementClass

+
+public java.lang.Class<T> getElementClass()
+
+
Get the Class of elements stored in the array. +

+

+
+
+
+ +
Returns:
the Class of elements stored in the array.
+
+
+
+ +

+iterator

+
+public UnifiedStructuredArray.StructureIterator iterator()
+
+
+

+

+
Specified by:
iterator in interface java.lang.Iterable<T>
+
+
+
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/package-frame.html b/JavaDoc/org/ObjectLayout/package-frame.html index 4a6880c..9cfde69 100644 --- a/JavaDoc/org/ObjectLayout/package-frame.html +++ b/JavaDoc/org/ObjectLayout/package-frame.html @@ -2,12 +2,12 @@ - + org.ObjectLayout - + @@ -33,11 +33,15 @@
FixedConstructorAndArgsLocator
-MulitDimensionalCopyConstructorAndArgsLocator +MultiDimensionalCopyConstructorAndArgsLocator
MultiDimensionalStructuredArray
-StructuredArray
+StructuredArray +
+UnifiedCopyConstructorAndArgsLocator +
+UnifiedStructuredArray diff --git a/JavaDoc/org/ObjectLayout/package-summary.html b/JavaDoc/org/ObjectLayout/package-summary.html index c575691..5c349ed 100644 --- a/JavaDoc/org/ObjectLayout/package-summary.html +++ b/JavaDoc/org/ObjectLayout/package-summary.html @@ -2,12 +2,12 @@ - + org.ObjectLayout - + @@ -117,7 +117,7 @@

with a given fixed set of arguments (repeated for all indices) -MulitDimensionalCopyConstructorAndArgsLocator<T> +MultiDimensionalCopyConstructorAndArgsLocator<T> Supports the construction of a new array's individual elements using a copy constructor to copy a source array's corresponding elements. @@ -129,6 +129,15 @@

StructuredArray<T> An array of (potentially) mutable but non-replaceable objects. + +UnifiedCopyConstructorAndArgsLocator<T> +Supports the construction of a new array's individual elements using a copy constructor to copy a source + array's corresponding elements. + + +UnifiedStructuredArray<T> +An array of (potentially) mutable but non-replaceable objects. +   diff --git a/JavaDoc/org/ObjectLayout/package-tree.html b/JavaDoc/org/ObjectLayout/package-tree.html index 7c7912a..e1147a8 100644 --- a/JavaDoc/org/ObjectLayout/package-tree.html +++ b/JavaDoc/org/ObjectLayout/package-tree.html @@ -2,12 +2,12 @@ - + org.ObjectLayout Class Hierarchy - + @@ -88,11 +88,13 @@


diff --git a/JavaDoc/overview-tree.html b/JavaDoc/overview-tree.html index 9396939..7373e27 100644 --- a/JavaDoc/overview-tree.html +++ b/JavaDoc/overview-tree.html @@ -2,12 +2,12 @@ - + Class Hierarchy - + @@ -90,11 +90,13 @@


From af09dbeaa449da01025ea5f8d103cc8e03269f51 Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Sun, 9 Jun 2013 23:32:55 -0700 Subject: [PATCH 15/39] JavaDoc update --- JavaDoc/allclasses-frame.html | 4 +- JavaDoc/allclasses-noframe.html | 4 +- JavaDoc/constant-values.html | 4 +- JavaDoc/deprecated-list.html | 4 +- JavaDoc/help-doc.html | 4 +- JavaDoc/index-files/index-1.html | 4 +- JavaDoc/index-files/index-10.html | 4 +- JavaDoc/index-files/index-11.html | 4 +- JavaDoc/index-files/index-12.html | 4 +- JavaDoc/index-files/index-2.html | 4 +- JavaDoc/index-files/index-3.html | 4 +- JavaDoc/index-files/index-4.html | 4 +- JavaDoc/index-files/index-5.html | 4 +- JavaDoc/index-files/index-6.html | 4 +- JavaDoc/index-files/index-7.html | 4 +- JavaDoc/index-files/index-8.html | 4 +- JavaDoc/index-files/index-9.html | 4 +- JavaDoc/index.html | 2 +- .../ArrayConstructorAndArgsLocator.html | 4 +- .../org/ObjectLayout/ConstructorAndArgs.html | 4 +- .../ConstructorAndArgsLocator.html | 4 +- .../CopyConstructorAndArgsLocator.html | 4 +- .../FixedConstructorAndArgsLocator.html | 4 +- ...ensionalCopyConstructorAndArgsLocator.html | 4 +- ...onalStructuredArray.StructureIterator.html | 4 +- .../MultiDimensionalStructuredArray.html | 4 +- .../StructuredArray.StructureIterator.html | 4 +- JavaDoc/org/ObjectLayout/StructuredArray.html | 4 +- .../UnifiedCopyConstructorAndArgsLocator.html | 4 +- ...fiedStructuredArray.StructureIterator.html | 4 +- .../ObjectLayout/UnifiedStructuredArray.html | 52 +++++++++++++------ JavaDoc/org/ObjectLayout/package-frame.html | 4 +- JavaDoc/org/ObjectLayout/package-summary.html | 4 +- JavaDoc/org/ObjectLayout/package-tree.html | 4 +- JavaDoc/overview-tree.html | 4 +- 35 files changed, 103 insertions(+), 83 deletions(-) diff --git a/JavaDoc/allclasses-frame.html b/JavaDoc/allclasses-frame.html index 43cfc36..6c0d7a5 100644 --- a/JavaDoc/allclasses-frame.html +++ b/JavaDoc/allclasses-frame.html @@ -2,12 +2,12 @@ - + All Classes - + diff --git a/JavaDoc/allclasses-noframe.html b/JavaDoc/allclasses-noframe.html index 9381bd5..6a4ba68 100644 --- a/JavaDoc/allclasses-noframe.html +++ b/JavaDoc/allclasses-noframe.html @@ -2,12 +2,12 @@ - + All Classes - + diff --git a/JavaDoc/constant-values.html b/JavaDoc/constant-values.html index d4aae82..82ed09f 100644 --- a/JavaDoc/constant-values.html +++ b/JavaDoc/constant-values.html @@ -2,12 +2,12 @@ - + Constant Field Values - + diff --git a/JavaDoc/deprecated-list.html b/JavaDoc/deprecated-list.html index dfa4ad9..9bb22d8 100644 --- a/JavaDoc/deprecated-list.html +++ b/JavaDoc/deprecated-list.html @@ -2,12 +2,12 @@ - + Deprecated List - + diff --git a/JavaDoc/help-doc.html b/JavaDoc/help-doc.html index 4273f31..8188a36 100644 --- a/JavaDoc/help-doc.html +++ b/JavaDoc/help-doc.html @@ -2,12 +2,12 @@ - + API Help - + diff --git a/JavaDoc/index-files/index-1.html b/JavaDoc/index-files/index-1.html index ed148fb..63855e7 100644 --- a/JavaDoc/index-files/index-1.html +++ b/JavaDoc/index-files/index-1.html @@ -2,12 +2,12 @@ - + A-Index - + diff --git a/JavaDoc/index-files/index-10.html b/JavaDoc/index-files/index-10.html index 993b001..c22c2e0 100644 --- a/JavaDoc/index-files/index-10.html +++ b/JavaDoc/index-files/index-10.html @@ -2,12 +2,12 @@ - + R-Index - + diff --git a/JavaDoc/index-files/index-11.html b/JavaDoc/index-files/index-11.html index 2bf4a1c..ce36d81 100644 --- a/JavaDoc/index-files/index-11.html +++ b/JavaDoc/index-files/index-11.html @@ -2,12 +2,12 @@ - + S-Index - + diff --git a/JavaDoc/index-files/index-12.html b/JavaDoc/index-files/index-12.html index 17e85e7..4e14e01 100644 --- a/JavaDoc/index-files/index-12.html +++ b/JavaDoc/index-files/index-12.html @@ -2,12 +2,12 @@ - + U-Index - + diff --git a/JavaDoc/index-files/index-2.html b/JavaDoc/index-files/index-2.html index e0d827d..a7d443c 100644 --- a/JavaDoc/index-files/index-2.html +++ b/JavaDoc/index-files/index-2.html @@ -2,12 +2,12 @@ - + C-Index - + diff --git a/JavaDoc/index-files/index-3.html b/JavaDoc/index-files/index-3.html index 6f67f25..3d65b83 100644 --- a/JavaDoc/index-files/index-3.html +++ b/JavaDoc/index-files/index-3.html @@ -2,12 +2,12 @@ - + F-Index - + diff --git a/JavaDoc/index-files/index-4.html b/JavaDoc/index-files/index-4.html index 83adcdb..3ba9503 100644 --- a/JavaDoc/index-files/index-4.html +++ b/JavaDoc/index-files/index-4.html @@ -2,12 +2,12 @@ - + G-Index - + diff --git a/JavaDoc/index-files/index-5.html b/JavaDoc/index-files/index-5.html index 1c1efa1..95b4629 100644 --- a/JavaDoc/index-files/index-5.html +++ b/JavaDoc/index-files/index-5.html @@ -2,12 +2,12 @@ - + H-Index - + diff --git a/JavaDoc/index-files/index-6.html b/JavaDoc/index-files/index-6.html index 24aa9fd..fc97279 100644 --- a/JavaDoc/index-files/index-6.html +++ b/JavaDoc/index-files/index-6.html @@ -2,12 +2,12 @@ - + I-Index - + diff --git a/JavaDoc/index-files/index-7.html b/JavaDoc/index-files/index-7.html index 0984812..c7a60fe 100644 --- a/JavaDoc/index-files/index-7.html +++ b/JavaDoc/index-files/index-7.html @@ -2,12 +2,12 @@ - + M-Index - + diff --git a/JavaDoc/index-files/index-8.html b/JavaDoc/index-files/index-8.html index 30c1a7d..251aeee 100644 --- a/JavaDoc/index-files/index-8.html +++ b/JavaDoc/index-files/index-8.html @@ -2,12 +2,12 @@ - + N-Index - + diff --git a/JavaDoc/index-files/index-9.html b/JavaDoc/index-files/index-9.html index 8693d28..cc08ee9 100644 --- a/JavaDoc/index-files/index-9.html +++ b/JavaDoc/index-files/index-9.html @@ -2,12 +2,12 @@ - + O-Index - + diff --git a/JavaDoc/index.html b/JavaDoc/index.html index 7a9fd5b..cad3744 100644 --- a/JavaDoc/index.html +++ b/JavaDoc/index.html @@ -2,7 +2,7 @@ - + Generated Documentation (Untitled) diff --git a/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html index 880e24f..d4479a7 100644 --- a/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + ArrayConstructorAndArgsLocator - + diff --git a/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html b/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html index e7c4699..bb0c5d8 100644 --- a/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html +++ b/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html @@ -2,12 +2,12 @@ - + ConstructorAndArgs - + diff --git a/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html index 1e05704..712841e 100644 --- a/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + ConstructorAndArgsLocator - + diff --git a/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html index 478f6f1..15d7ba1 100644 --- a/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + CopyConstructorAndArgsLocator - + diff --git a/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html index 49619a2..b9bd661 100644 --- a/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + FixedConstructorAndArgsLocator - + diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalCopyConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/MultiDimensionalCopyConstructorAndArgsLocator.html index 05f5cbe..02c3406 100644 --- a/JavaDoc/org/ObjectLayout/MultiDimensionalCopyConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalCopyConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + MultiDimensionalCopyConstructorAndArgsLocator - + diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html index 2cfd6fc..a42c032 100644 --- a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html @@ -2,12 +2,12 @@ - + MultiDimensionalStructuredArray.StructureIterator - + diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html index ef375fa..ef793c5 100644 --- a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html @@ -2,12 +2,12 @@ - + MultiDimensionalStructuredArray - + diff --git a/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html b/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html index 02398f4..b477fc6 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html +++ b/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html @@ -2,12 +2,12 @@ - + StructuredArray.StructureIterator - + diff --git a/JavaDoc/org/ObjectLayout/StructuredArray.html b/JavaDoc/org/ObjectLayout/StructuredArray.html index 6d3776a..21631b6 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArray.html +++ b/JavaDoc/org/ObjectLayout/StructuredArray.html @@ -2,12 +2,12 @@ - + StructuredArray - + diff --git a/JavaDoc/org/ObjectLayout/UnifiedCopyConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/UnifiedCopyConstructorAndArgsLocator.html index b7b9cf8..c8501c2 100644 --- a/JavaDoc/org/ObjectLayout/UnifiedCopyConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/UnifiedCopyConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + UnifiedCopyConstructorAndArgsLocator - + diff --git a/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.StructureIterator.html b/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.StructureIterator.html index ae5f8be..1805b32 100644 --- a/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.StructureIterator.html +++ b/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.StructureIterator.html @@ -2,12 +2,12 @@ - + UnifiedStructuredArray.StructureIterator - + diff --git a/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.html b/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.html index 29c6e7c..d69f65c 100644 --- a/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.html +++ b/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.html @@ -2,12 +2,12 @@ - + UnifiedStructuredArray - + @@ -877,7 +877,9 @@

Parameters:
indexes - The indexes (at each dimension) of the element to retrieve. -
Returns:
a reference to the indexed element.
+
Returns:
a reference to the indexed element. +
Throws: +
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array


@@ -898,7 +900,9 @@

Parameters:
indexes - The indexes (at each dimension) of the element to retrieve.
indexOffset - The beginning offset in the indexes array related to this arrays contents. -
Returns:
a reference to the indexed element.
+
Returns:
a reference to the indexed element. +
Throws: +
java.lang.NullPointerException - if number of relevant indexes does not match number of dimensions in the array


@@ -915,7 +919,9 @@

Parameters:
indexes - The indexes (at each dimension) of the element to retrieve. -
Returns:
a reference to the indexed element.
+
Returns:
a reference to the indexed element. +
Throws: +
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array


@@ -932,7 +938,9 @@

Parameters:
indexes - The indexes (at each dimension) of the element to retrieve. -
Returns:
a reference to the indexed element.
+
Returns:
a reference to the indexed element. +
Throws: +
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array


@@ -953,7 +961,8 @@

Parameters:
index0 -
index1 -
Returns:
the element at [index0, index1]
Throws: -
java.lang.ClassCastException - if number of indexes does not match number of dimensions in the array +
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array +
java.lang.ClassCastException

@@ -975,7 +984,8 @@

Parameters:
index0 -
index1 -
index2 -
Returns:
the element at [index0, index1, index2]
Throws: -
java.lang.ClassCastException - if number of indexes does not match number of dimensions in the array +
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array +
java.lang.ClassCastException

@@ -998,7 +1008,8 @@

Parameters:
index0 -
index1 -
index2 -
index3 -
Returns:
the element at [index0, index1, index2, index3]
Throws: -
java.lang.ClassCastException - if number of indexes does not match number of dimensions in the array +
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array +
java.lang.ClassCastException

@@ -1019,7 +1030,8 @@

Parameters:
index0 -
index1 -
Returns:
the element at [index0, index1]
Throws: -
java.lang.ClassCastException - if number of indexes does not match number of dimensions in the array +
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array +
java.lang.ClassCastException

@@ -1041,7 +1053,8 @@

Parameters:
index0 -
index1 -
index2 -
Returns:
the element at [index0, index1, index2]
Throws: -
java.lang.ClassCastException - if number of indexes does not match number of dimensions in the array +
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array +
java.lang.ClassCastException

@@ -1064,7 +1077,8 @@

Parameters:
index0 -
index1 -
index2 -
index3 -
Returns:
the element at [index0, index1, index2, index3]
Throws: -
java.lang.ClassCastException - if number of indexes does not match number of dimensions in the array +
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array +
java.lang.ClassCastException

@@ -1084,7 +1098,8 @@

Parameters:
index -
Returns:
a reference to the UnifiedStructuredArray located in element [index] of this array
Throws: -
java.lang.ClassCastException - if array has less than two dimensions +
java.lang.NullPointerException - if array has less than two dimensions +
java.lang.ClassCastException

@@ -1104,7 +1119,8 @@

Parameters:
index -
Returns:
a reference to the UnifiedStructuredArray located in element [index] of this array
Throws: -
java.lang.ClassCastException - if array has less than two dimensions +
java.lang.NullPointerException - if array has less than two dimensions +
java.lang.ClassCastException

@@ -1121,7 +1137,9 @@

Parameters:
index - of the element to retrieve. -
Returns:
a reference to the indexed element.
+
Returns:
a reference to the indexed element. +
Throws: +
java.lang.NullPointerException - if array has more than one dimensions

@@ -1138,7 +1156,9 @@

Parameters:
index - of the element to retrieve. -
Returns:
a reference to the indexed element.
+
Returns:
a reference to the indexed element. +
Throws: +
java.lang.NullPointerException - if array has more than one dimensions

diff --git a/JavaDoc/org/ObjectLayout/package-frame.html b/JavaDoc/org/ObjectLayout/package-frame.html index 9cfde69..e4dbca7 100644 --- a/JavaDoc/org/ObjectLayout/package-frame.html +++ b/JavaDoc/org/ObjectLayout/package-frame.html @@ -2,12 +2,12 @@ - + org.ObjectLayout - + diff --git a/JavaDoc/org/ObjectLayout/package-summary.html b/JavaDoc/org/ObjectLayout/package-summary.html index 5c349ed..d7b91e5 100644 --- a/JavaDoc/org/ObjectLayout/package-summary.html +++ b/JavaDoc/org/ObjectLayout/package-summary.html @@ -2,12 +2,12 @@ - + org.ObjectLayout - + diff --git a/JavaDoc/org/ObjectLayout/package-tree.html b/JavaDoc/org/ObjectLayout/package-tree.html index e1147a8..a73502f 100644 --- a/JavaDoc/org/ObjectLayout/package-tree.html +++ b/JavaDoc/org/ObjectLayout/package-tree.html @@ -2,12 +2,12 @@ - + org.ObjectLayout Class Hierarchy - + diff --git a/JavaDoc/overview-tree.html b/JavaDoc/overview-tree.html index 7373e27..0326514 100644 --- a/JavaDoc/overview-tree.html +++ b/JavaDoc/overview-tree.html @@ -2,12 +2,12 @@ - + Class Hierarchy - + From 2098c5562b7520a13ae04f6311eef8b300b721e2 Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Sun, 9 Jun 2013 23:54:54 -0700 Subject: [PATCH 16/39] JavaDoc update --- JavaDoc/allclasses-frame.html | 2 +- JavaDoc/allclasses-noframe.html | 2 +- JavaDoc/constant-values.html | 2 +- JavaDoc/deprecated-list.html | 2 +- JavaDoc/help-doc.html | 2 +- JavaDoc/index-files/index-1.html | 2 +- JavaDoc/index-files/index-10.html | 2 +- JavaDoc/index-files/index-11.html | 8 +- JavaDoc/index-files/index-12.html | 2 +- JavaDoc/index-files/index-13.html | 15 +- JavaDoc/index-files/index-14.html | 169 +++++ JavaDoc/index-files/index-2.html | 2 +- JavaDoc/index-files/index-3.html | 2 +- JavaDoc/index-files/index-4.html | 2 +- JavaDoc/index-files/index-5.html | 2 +- JavaDoc/index-files/index-6.html | 2 +- JavaDoc/index-files/index-7.html | 2 +- JavaDoc/index-files/index-8.html | 2 +- JavaDoc/index-files/index-9.html | 2 +- JavaDoc/index.html | 2 +- .../ArrayConstructorAndArgsLocator.html | 2 +- .../org/ObjectLayout/ConstructorAndArgs.html | 2 +- .../ConstructorAndArgsLocator.html | 2 +- .../CopyConstructorAndArgsLocator.html | 2 +- .../FixedConstructorAndArgsLocator.html | 2 +- ...ensionalCopyConstructorAndArgsLocator.html | 2 +- ...onalStructuredArray.StructureIterator.html | 2 +- .../MultiDimensionalStructuredArray.html | 2 +- ...onalStructuredArrayTest.MockStructure.html | 4 +- ...ArrayTest.MockStructureWithFinalField.html | 4 +- .../MultiDimensionalStructuredArrayTest.html | 4 +- .../StructuredArray.StructureIterator.html | 2 +- JavaDoc/org/ObjectLayout/StructuredArray.html | 2 +- .../StructuredArrayTest.MockStructure.html | 4 +- ...ArrayTest.MockStructureWithFinalField.html | 8 +- .../org/ObjectLayout/StructuredArrayTest.html | 4 +- .../UnifiedCopyConstructorAndArgsLocator.html | 2 +- ...fiedStructuredArray.StructureIterator.html | 2 +- .../ObjectLayout/UnifiedStructuredArray.html | 133 +++- ...fiedStructuredArrayTest.MockStructure.html | 404 +++++++++++ ...ArrayTest.MockStructureWithFinalField.html | 223 ++++++ .../UnifiedStructuredArrayTest.html | 650 ++++++++++++++++++ JavaDoc/org/ObjectLayout/package-frame.html | 2 +- JavaDoc/org/ObjectLayout/package-summary.html | 2 +- JavaDoc/org/ObjectLayout/package-tree.html | 2 +- JavaDoc/overview-tree.html | 2 +- 46 files changed, 1609 insertions(+), 87 deletions(-) create mode 100644 JavaDoc/index-files/index-14.html create mode 100644 JavaDoc/org/ObjectLayout/UnifiedStructuredArrayTest.MockStructure.html create mode 100644 JavaDoc/org/ObjectLayout/UnifiedStructuredArrayTest.MockStructureWithFinalField.html create mode 100644 JavaDoc/org/ObjectLayout/UnifiedStructuredArrayTest.html diff --git a/JavaDoc/allclasses-frame.html b/JavaDoc/allclasses-frame.html index 6c0d7a5..1063d74 100644 --- a/JavaDoc/allclasses-frame.html +++ b/JavaDoc/allclasses-frame.html @@ -2,7 +2,7 @@ - + All Classes diff --git a/JavaDoc/allclasses-noframe.html b/JavaDoc/allclasses-noframe.html index 6a4ba68..fcf4dc2 100644 --- a/JavaDoc/allclasses-noframe.html +++ b/JavaDoc/allclasses-noframe.html @@ -2,7 +2,7 @@ - + All Classes diff --git a/JavaDoc/constant-values.html b/JavaDoc/constant-values.html index 82ed09f..1996d5f 100644 --- a/JavaDoc/constant-values.html +++ b/JavaDoc/constant-values.html @@ -2,7 +2,7 @@ - + Constant Field Values diff --git a/JavaDoc/deprecated-list.html b/JavaDoc/deprecated-list.html index 9bb22d8..6b8ffc2 100644 --- a/JavaDoc/deprecated-list.html +++ b/JavaDoc/deprecated-list.html @@ -2,7 +2,7 @@ - + Deprecated List diff --git a/JavaDoc/help-doc.html b/JavaDoc/help-doc.html index 8188a36..14e00f7 100644 --- a/JavaDoc/help-doc.html +++ b/JavaDoc/help-doc.html @@ -2,7 +2,7 @@ - + API Help diff --git a/JavaDoc/index-files/index-1.html b/JavaDoc/index-files/index-1.html index 63855e7..bb9c8f0 100644 --- a/JavaDoc/index-files/index-1.html +++ b/JavaDoc/index-files/index-1.html @@ -2,7 +2,7 @@ - + A-Index diff --git a/JavaDoc/index-files/index-10.html b/JavaDoc/index-files/index-10.html index c22c2e0..53649a8 100644 --- a/JavaDoc/index-files/index-10.html +++ b/JavaDoc/index-files/index-10.html @@ -2,7 +2,7 @@ - + R-Index diff --git a/JavaDoc/index-files/index-11.html b/JavaDoc/index-files/index-11.html index ce36d81..7483452 100644 --- a/JavaDoc/index-files/index-11.html +++ b/JavaDoc/index-files/index-11.html @@ -2,7 +2,7 @@ - + S-Index @@ -92,6 +92,12 @@
shallowCopy(StructuredArray, long, StructuredArray, long, long, boolean) - Static method in class org.ObjectLayout.StructuredArray
Shallow copy a region of element object contents from one array to the other. +
shallowCopy(UnifiedStructuredArray, long, UnifiedStructuredArray, long, long) - +Static method in class org.ObjectLayout.UnifiedStructuredArray +
Shallow copy a region of element object contents from one array to the other. +
shallowCopy(UnifiedStructuredArray, long, UnifiedStructuredArray, long, long, boolean) - +Static method in class org.ObjectLayout.UnifiedStructuredArray +
Shallow copy a region of element object contents from one array to the other.
StructuredArray<T> - Class in org.ObjectLayout
An array of (potentially) mutable but non-replaceable objects.
StructuredArray(ConstructorAndArgsLocator<T>, long, long[]) - Constructor for class org.ObjectLayout.StructuredArray
  diff --git a/JavaDoc/index-files/index-12.html b/JavaDoc/index-files/index-12.html index 4e14e01..3313292 100644 --- a/JavaDoc/index-files/index-12.html +++ b/JavaDoc/index-files/index-12.html @@ -2,7 +2,7 @@ - + U-Index diff --git a/JavaDoc/index-files/index-13.html b/JavaDoc/index-files/index-13.html index aa315b8..ee4bdc5 100644 --- a/JavaDoc/index-files/index-13.html +++ b/JavaDoc/index-files/index-13.html @@ -2,12 +2,12 @@ - + T-Index - + @@ -54,7 +54,7 @@  PREV LETTER  - NEXT LETTERNEXT LETTER FRAMES    NO FRAMES   @@ -76,7 +76,7 @@ -A C E F G H I M N O R S T
+A C E F G H I M N O R S T U

T

@@ -86,6 +86,9 @@
toString() - Method in class org.ObjectLayout.StructuredArrayTest.MockStructure
  +
toString() - +Method in class org.ObjectLayout.UnifiedStructuredArrayTest.MockStructure +
 

@@ -116,7 +119,7 @@  PREV LETTER  - NEXT LETTERNEXT LETTER
FRAMES    NO FRAMES   @@ -138,7 +141,7 @@ -A C E F G H I M N O R S T
+A C E F G H I M N O R S T U
diff --git a/JavaDoc/index-files/index-14.html b/JavaDoc/index-files/index-14.html new file mode 100644 index 0000000..3bba3ff --- /dev/null +++ b/JavaDoc/index-files/index-14.html @@ -0,0 +1,169 @@ + + + + + + +U-Index + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + +
+ +
+ + + +A C E F G H I M N O R S T U
+

+U

+
+
UnifiedCopyConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports the construction of a new array's individual elements using a copy constructor to copy a source + array's corresponding elements.
UnifiedCopyConstructorAndArgsLocator(Class<T>, UnifiedStructuredArray<T>) - +Constructor for class org.ObjectLayout.UnifiedCopyConstructorAndArgsLocator +
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array +
UnifiedCopyConstructorAndArgsLocator(Class<T>, UnifiedStructuredArray<T>, long[]) - +Constructor for class org.ObjectLayout.UnifiedCopyConstructorAndArgsLocator +
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +
UnifiedCopyConstructorAndArgsLocator(Class<T>, UnifiedStructuredArray<T>, long[], boolean) - +Constructor for class org.ObjectLayout.UnifiedCopyConstructorAndArgsLocator +
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +
UnifiedStructuredArray<T> - Class in org.ObjectLayout
An array of (potentially) mutable but non-replaceable objects.
UnifiedStructuredArray.StructureIterator - Class in org.ObjectLayout
Specialised Iterator with the ability to be UnifiedStructuredArray.StructureIterator.reset() enabling reuse.
UnifiedStructuredArray.StructureIterator() - +Constructor for class org.ObjectLayout.UnifiedStructuredArray.StructureIterator +
  +
UnifiedStructuredArrayTest - Class in org.ObjectLayout
 
UnifiedStructuredArrayTest() - +Constructor for class org.ObjectLayout.UnifiedStructuredArrayTest +
  +
UnifiedStructuredArrayTest.MockStructure - Class in org.ObjectLayout
 
UnifiedStructuredArrayTest.MockStructure() - +Constructor for class org.ObjectLayout.UnifiedStructuredArrayTest.MockStructure +
  +
UnifiedStructuredArrayTest.MockStructure(long, long) - +Constructor for class org.ObjectLayout.UnifiedStructuredArrayTest.MockStructure +
  +
UnifiedStructuredArrayTest.MockStructure(UnifiedStructuredArrayTest.MockStructure) - +Constructor for class org.ObjectLayout.UnifiedStructuredArrayTest.MockStructure +
  +
UnifiedStructuredArrayTest.MockStructureWithFinalField - Class in org.ObjectLayout
 
UnifiedStructuredArrayTest.MockStructureWithFinalField() - +Constructor for class org.ObjectLayout.UnifiedStructuredArrayTest.MockStructureWithFinalField +
  +
+
+ + + + + + + + + + + + + + + +
+ +
+ + + +A C E F G H I M N O R S T U
+ + + diff --git a/JavaDoc/index-files/index-2.html b/JavaDoc/index-files/index-2.html index a7d443c..e45406b 100644 --- a/JavaDoc/index-files/index-2.html +++ b/JavaDoc/index-files/index-2.html @@ -2,7 +2,7 @@ - + C-Index diff --git a/JavaDoc/index-files/index-3.html b/JavaDoc/index-files/index-3.html index 3d65b83..d0e13a9 100644 --- a/JavaDoc/index-files/index-3.html +++ b/JavaDoc/index-files/index-3.html @@ -2,7 +2,7 @@ - + F-Index diff --git a/JavaDoc/index-files/index-4.html b/JavaDoc/index-files/index-4.html index 3ba9503..d1a5f83 100644 --- a/JavaDoc/index-files/index-4.html +++ b/JavaDoc/index-files/index-4.html @@ -2,7 +2,7 @@ - + G-Index diff --git a/JavaDoc/index-files/index-5.html b/JavaDoc/index-files/index-5.html index 95b4629..97bf978 100644 --- a/JavaDoc/index-files/index-5.html +++ b/JavaDoc/index-files/index-5.html @@ -2,7 +2,7 @@ - + H-Index diff --git a/JavaDoc/index-files/index-6.html b/JavaDoc/index-files/index-6.html index fc97279..0bcc4fd 100644 --- a/JavaDoc/index-files/index-6.html +++ b/JavaDoc/index-files/index-6.html @@ -2,7 +2,7 @@ - + I-Index diff --git a/JavaDoc/index-files/index-7.html b/JavaDoc/index-files/index-7.html index c7a60fe..93afb0d 100644 --- a/JavaDoc/index-files/index-7.html +++ b/JavaDoc/index-files/index-7.html @@ -2,7 +2,7 @@ - + M-Index diff --git a/JavaDoc/index-files/index-8.html b/JavaDoc/index-files/index-8.html index 251aeee..de3e0f6 100644 --- a/JavaDoc/index-files/index-8.html +++ b/JavaDoc/index-files/index-8.html @@ -2,7 +2,7 @@ - + N-Index diff --git a/JavaDoc/index-files/index-9.html b/JavaDoc/index-files/index-9.html index cc08ee9..7699804 100644 --- a/JavaDoc/index-files/index-9.html +++ b/JavaDoc/index-files/index-9.html @@ -2,7 +2,7 @@ - + O-Index diff --git a/JavaDoc/index.html b/JavaDoc/index.html index cad3744..675c6fe 100644 --- a/JavaDoc/index.html +++ b/JavaDoc/index.html @@ -2,7 +2,7 @@ - + Generated Documentation (Untitled) diff --git a/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html index d4479a7..6dc8a14 100644 --- a/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html @@ -2,7 +2,7 @@ - + ArrayConstructorAndArgsLocator diff --git a/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html b/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html index bb0c5d8..a785edc 100644 --- a/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html +++ b/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html @@ -2,7 +2,7 @@ - + ConstructorAndArgs diff --git a/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html index 712841e..0c4f370 100644 --- a/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html @@ -2,7 +2,7 @@ - + ConstructorAndArgsLocator diff --git a/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html index 15d7ba1..d391138 100644 --- a/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html @@ -2,7 +2,7 @@ - + CopyConstructorAndArgsLocator diff --git a/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html index b9bd661..59c45a5 100644 --- a/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html @@ -2,7 +2,7 @@ - + FixedConstructorAndArgsLocator diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalCopyConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/MultiDimensionalCopyConstructorAndArgsLocator.html index 02c3406..f8aade9 100644 --- a/JavaDoc/org/ObjectLayout/MultiDimensionalCopyConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalCopyConstructorAndArgsLocator.html @@ -2,7 +2,7 @@ - + MultiDimensionalCopyConstructorAndArgsLocator diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html index a42c032..c08931f 100644 --- a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html @@ -2,7 +2,7 @@ - + MultiDimensionalStructuredArray.StructureIterator diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html index ef793c5..5c10218 100644 --- a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html @@ -2,7 +2,7 @@ - + MultiDimensionalStructuredArray diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.MockStructure.html b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.MockStructure.html index d55fe0c..3779082 100644 --- a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.MockStructure.html +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.MockStructure.html @@ -2,12 +2,12 @@ - + MultiDimensionalStructuredArrayTest.MockStructure - + diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.MockStructureWithFinalField.html b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.MockStructureWithFinalField.html index dcec076..4ef32c0 100644 --- a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.MockStructureWithFinalField.html +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.MockStructureWithFinalField.html @@ -2,12 +2,12 @@ - + MultiDimensionalStructuredArrayTest.MockStructureWithFinalField - + diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.html b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.html index 8dff2b0..fc2ad52 100644 --- a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.html +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.html @@ -2,12 +2,12 @@ - + MultiDimensionalStructuredArrayTest - + diff --git a/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html b/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html index b477fc6..0b14c11 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html +++ b/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html @@ -2,7 +2,7 @@ - + StructuredArray.StructureIterator diff --git a/JavaDoc/org/ObjectLayout/StructuredArray.html b/JavaDoc/org/ObjectLayout/StructuredArray.html index 21631b6..f87d004 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArray.html +++ b/JavaDoc/org/ObjectLayout/StructuredArray.html @@ -2,7 +2,7 @@ - + StructuredArray diff --git a/JavaDoc/org/ObjectLayout/StructuredArrayTest.MockStructure.html b/JavaDoc/org/ObjectLayout/StructuredArrayTest.MockStructure.html index c926da2..ad02a51 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArrayTest.MockStructure.html +++ b/JavaDoc/org/ObjectLayout/StructuredArrayTest.MockStructure.html @@ -2,12 +2,12 @@ - + StructuredArrayTest.MockStructure - + diff --git a/JavaDoc/org/ObjectLayout/StructuredArrayTest.MockStructureWithFinalField.html b/JavaDoc/org/ObjectLayout/StructuredArrayTest.MockStructureWithFinalField.html index 418acb4..7c92c44 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArrayTest.MockStructureWithFinalField.html +++ b/JavaDoc/org/ObjectLayout/StructuredArrayTest.MockStructureWithFinalField.html @@ -2,12 +2,12 @@ - + StructuredArrayTest.MockStructureWithFinalField - + @@ -54,7 +54,7 @@  PREV CLASS  - NEXT CLASSNEXT CLASS
FRAMES    NO FRAMES   @@ -189,7 +189,7 @@

 PREV CLASS  - NEXT CLASSNEXT CLASS FRAMES    NO FRAMES   diff --git a/JavaDoc/org/ObjectLayout/StructuredArrayTest.html b/JavaDoc/org/ObjectLayout/StructuredArrayTest.html index ec4433e..aa922e8 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArrayTest.html +++ b/JavaDoc/org/ObjectLayout/StructuredArrayTest.html @@ -2,12 +2,12 @@ - + StructuredArrayTest - + diff --git a/JavaDoc/org/ObjectLayout/UnifiedCopyConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/UnifiedCopyConstructorAndArgsLocator.html index c8501c2..f3ad289 100644 --- a/JavaDoc/org/ObjectLayout/UnifiedCopyConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/UnifiedCopyConstructorAndArgsLocator.html @@ -2,7 +2,7 @@ - + UnifiedCopyConstructorAndArgsLocator diff --git a/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.StructureIterator.html b/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.StructureIterator.html index 1805b32..56a48e7 100644 --- a/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.StructureIterator.html +++ b/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.StructureIterator.html @@ -2,7 +2,7 @@ - + UnifiedStructuredArray.StructureIterator diff --git a/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.html b/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.html index d69f65c..b55b9e7 100644 --- a/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.html +++ b/JavaDoc/org/ObjectLayout/UnifiedStructuredArray.html @@ -2,7 +2,7 @@ - + UnifiedStructuredArray @@ -516,6 +516,31 @@


          Create a multi dimensional array of elements. + + +static void +shallowCopy(UnifiedStructuredArray src, + long srcOffset, + UnifiedStructuredArray dst, + long dstOffset, + long count) + +
+          Shallow copy a region of element object contents from one array to the other. + + + +static void +shallowCopy(UnifiedStructuredArray src, + long srcOffset, + UnifiedStructuredArray dst, + long dstOffset, + long count, + boolean allowFinalFieldOverwrite) + +
+          Shallow copy a region of element object contents from one array to the other. +   @@ -949,8 +974,7 @@

getL

 public T getL(long index0,
-              long index1)
-       throws java.lang.ClassCastException
+ long index1)
Get a reference to an element in the array, using 2 long indexes.

@@ -961,8 +985,7 @@

Parameters:
index0 -
index1 -
Returns:
the element at [index0, index1]
Throws: -
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array -
java.lang.ClassCastException

+
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array

@@ -972,8 +995,7 @@

 public T getL(long index0,
               long index1,
-              long index2)
-       throws java.lang.ClassCastException
+ long index2)
Get a reference to an element in the array, using 3 long indexes.

@@ -984,8 +1006,7 @@

Parameters:
index0 -
index1 -
index2 -
Returns:
the element at [index0, index1, index2]
Throws: -
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array -
java.lang.ClassCastException

+
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array

@@ -996,8 +1017,7 @@

public T getL(long index0, long index1, long index2, - long index3) - throws java.lang.ClassCastException + long index3)
Get a reference to an element in the array, using 4 long indexes.

@@ -1008,8 +1028,7 @@

Parameters:
index0 -
index1 -
index2 -
index3 -
Returns:
the element at [index0, index1, index2, index3]
Throws: -
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array -
java.lang.ClassCastException

+
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array

@@ -1018,8 +1037,7 @@

get

 public T get(int index0,
-             int index1)
-      throws java.lang.ClassCastException
+ int index1)
Get a reference to an element in the array, using 2 int indexes.

@@ -1030,8 +1048,7 @@

Parameters:
index0 -
index1 -
Returns:
the element at [index0, index1]
Throws: -
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array -
java.lang.ClassCastException

+
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array

@@ -1041,8 +1058,7 @@

 public T get(int index0,
              int index1,
-             int index2)
-      throws java.lang.ClassCastException
+ int index2)
Get a reference to an element in the array, using 3 int indexes.

@@ -1053,8 +1069,7 @@

Parameters:
index0 -
index1 -
index2 -
Returns:
the element at [index0, index1, index2]
Throws: -
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array -
java.lang.ClassCastException

+
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array

@@ -1065,8 +1080,7 @@

public T get(int index0, int index1, int index2, - int index3) - throws java.lang.ClassCastException + int index3)
Get a reference to an element in the array, using 4 int indexes.

@@ -1077,8 +1091,7 @@

Parameters:
index0 -
index1 -
index2 -
index3 -
Returns:
the element at [index0, index1, index2, index3]
Throws: -
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array -
java.lang.ClassCastException

+
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array

@@ -1086,8 +1099,7 @@

getOfUnifiedStructuredArrayL

-public UnifiedStructuredArray<T> getOfUnifiedStructuredArrayL(long index)
-                                                       throws java.lang.ClassCastException
+public UnifiedStructuredArray<T> getOfUnifiedStructuredArrayL(long index)
Get a reference to a UnifiedStructuredArray element in this array, using a long index.

@@ -1098,8 +1110,7 @@

Parameters:
index -
Returns:
a reference to the UnifiedStructuredArray located in element [index] of this array
Throws: -
java.lang.NullPointerException - if array has less than two dimensions -
java.lang.ClassCastException

+
java.lang.NullPointerException - if array has less than two dimensions

@@ -1107,8 +1118,7 @@

getOfUnifiedStructuredArray

-public UnifiedStructuredArray<T> getOfUnifiedStructuredArray(int index)
-                                                      throws java.lang.ClassCastException
+public UnifiedStructuredArray<T> getOfUnifiedStructuredArray(int index)
Get a reference to a UnifiedStructuredArray element in this array, using a int index.

@@ -1119,8 +1129,7 @@

Parameters:
index -
Returns:
a reference to the UnifiedStructuredArray located in element [index] of this array
Throws: -
java.lang.NullPointerException - if array has less than two dimensions -
java.lang.ClassCastException

+
java.lang.NullPointerException - if array has less than two dimensions

@@ -1194,6 +1203,64 @@

+
+ +

+shallowCopy

+
+public static void shallowCopy(UnifiedStructuredArray src,
+                               long srcOffset,
+                               UnifiedStructuredArray dst,
+                               long dstOffset,
+                               long count)
+
+
Shallow copy a region of element object contents from one array to the other. +

+ shallowCopy will copy all fields from each of the source elements to the corresponding fields in each + of the corresponding destination elements. If the same array is both the src and dst then the copy will + happen as if a temporary intermediate array was used. +

+

+
+
+
+
Parameters:
src - array to copy.
srcOffset - offset index in src where the region begins.
dst - array into which the copy should occur.
dstOffset - offset index in the dst where the region begins.
count - of structure elements to copy. +
Throws: +
java.lang.IllegalStateException - if final fields are discovered. +
java.lang.ArrayStoreException - if the element classes in src and dst are not identical.
+
+
+
+ +

+shallowCopy

+
+public static void shallowCopy(UnifiedStructuredArray src,
+                               long srcOffset,
+                               UnifiedStructuredArray dst,
+                               long dstOffset,
+                               long count,
+                               boolean allowFinalFieldOverwrite)
+
+
Shallow copy a region of element object contents from one array to the other. +

+ shallowCopy will copy all fields from each of the source elements to the corresponding fields in each + of the corresponding destination elements. If the same array is both the src and dst then the copy will + happen as if a temporary intermediate array was used. + + If allowFinalFieldOverwrite is specified as true, even final fields will be copied. +

+

+
+
+
+
Parameters:
src - array to copy.
srcOffset - offset index in src where the region begins.
dst - array into which the copy should occur.
dstOffset - offset index in the dst where the region begins.
count - of structure elements to copy.
allowFinalFieldOverwrite - allow final fields to be overwritten during a copy operation. +
Throws: +
java.lang.IllegalArgumentException - if final fields are discovered and all allowFinalFieldOverwrite is not true. +
java.lang.IllegalArgumentException - if source or destination arrays have more than one dimension. +
java.lang.ArrayStoreException - if the element classes in src and dst are not identical.
+
+

diff --git a/JavaDoc/org/ObjectLayout/UnifiedStructuredArrayTest.MockStructure.html b/JavaDoc/org/ObjectLayout/UnifiedStructuredArrayTest.MockStructure.html new file mode 100644 index 0000000..b0cc8fa --- /dev/null +++ b/JavaDoc/org/ObjectLayout/UnifiedStructuredArrayTest.MockStructure.html @@ -0,0 +1,404 @@ + + + + + + +UnifiedStructuredArrayTest.MockStructure + + + + + + + + + + + + +
+ + + + + +
+ + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class UnifiedStructuredArrayTest.MockStructure

+
+java.lang.Object
+  extended by org.ObjectLayout.UnifiedStructuredArrayTest.MockStructure
+
+
+
Enclosing class:
UnifiedStructuredArrayTest
+
+
+
+
public static class UnifiedStructuredArrayTest.MockStructure
extends java.lang.Object
+ + +

+


+ +

+ + + + + + + + + + + + + + + + + +
+Constructor Summary
UnifiedStructuredArrayTest.MockStructure() + +
+           
UnifiedStructuredArrayTest.MockStructure(long index, + long testValue) + +
+           
UnifiedStructuredArrayTest.MockStructure(UnifiedStructuredArrayTest.MockStructure src) + +
+           
+  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+Method Summary
+ booleanequals(java.lang.Object o) + +
+           
+ longgetIndex() + +
+           
+ longgetTestValue() + +
+           
+ inthashCode() + +
+           
+ voidsetIndex(long index) + +
+           
+ voidsetTestValue(long testValue) + +
+           
+ java.lang.StringtoString() + +
+           
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+UnifiedStructuredArrayTest.MockStructure

+
+public UnifiedStructuredArrayTest.MockStructure()
+
+
+
+ +

+UnifiedStructuredArrayTest.MockStructure

+
+public UnifiedStructuredArrayTest.MockStructure(long index,
+                                                long testValue)
+
+
+
+ +

+UnifiedStructuredArrayTest.MockStructure

+
+public UnifiedStructuredArrayTest.MockStructure(UnifiedStructuredArrayTest.MockStructure src)
+
+
+ + + + + + + + +
+Method Detail
+ +

+getIndex

+
+public long getIndex()
+
+
+
+
+
+
+ +

+setIndex

+
+public void setIndex(long index)
+
+
+
+
+
+
+ +

+getTestValue

+
+public long getTestValue()
+
+
+
+
+
+
+ +

+setTestValue

+
+public void setTestValue(long testValue)
+
+
+
+
+
+
+ +

+equals

+
+public boolean equals(java.lang.Object o)
+
+
+
Overrides:
equals in class java.lang.Object
+
+
+
+
+
+
+ +

+hashCode

+
+public int hashCode()
+
+
+
Overrides:
hashCode in class java.lang.Object
+
+
+
+
+
+
+ +

+toString

+
+public java.lang.String toString()
+
+
+
Overrides:
toString in class java.lang.Object
+
+
+
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/UnifiedStructuredArrayTest.MockStructureWithFinalField.html b/JavaDoc/org/ObjectLayout/UnifiedStructuredArrayTest.MockStructureWithFinalField.html new file mode 100644 index 0000000..2aadda0 --- /dev/null +++ b/JavaDoc/org/ObjectLayout/UnifiedStructuredArrayTest.MockStructureWithFinalField.html @@ -0,0 +1,223 @@ + + + + + + +UnifiedStructuredArrayTest.MockStructureWithFinalField + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class UnifiedStructuredArrayTest.MockStructureWithFinalField

+
+java.lang.Object
+  extended by org.ObjectLayout.UnifiedStructuredArrayTest.MockStructureWithFinalField
+
+
+
Enclosing class:
UnifiedStructuredArrayTest
+
+
+
+
public static class UnifiedStructuredArrayTest.MockStructureWithFinalField
extends java.lang.Object
+ + +

+


+ +

+ + + + + + + + + + + +
+Constructor Summary
UnifiedStructuredArrayTest.MockStructureWithFinalField() + +
+           
+  + + + + + + + +
+Method Summary
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+UnifiedStructuredArrayTest.MockStructureWithFinalField

+
+public UnifiedStructuredArrayTest.MockStructureWithFinalField()
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/UnifiedStructuredArrayTest.html b/JavaDoc/org/ObjectLayout/UnifiedStructuredArrayTest.html new file mode 100644 index 0000000..c5509a4 --- /dev/null +++ b/JavaDoc/org/ObjectLayout/UnifiedStructuredArrayTest.html @@ -0,0 +1,650 @@ + + + + + + +UnifiedStructuredArrayTest + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class UnifiedStructuredArrayTest

+
+java.lang.Object
+  extended by org.ObjectLayout.UnifiedStructuredArrayTest
+
+
+
+
public class UnifiedStructuredArrayTest
extends java.lang.Object
+ + +

+


+ +

+ + + + + + + + + + + + + + + +
+Nested Class Summary
+static classUnifiedStructuredArrayTest.MockStructure + +
+           
+static classUnifiedStructuredArrayTest.MockStructureWithFinalField + +
+           
+  + + + + + + + + + + +
+Constructor Summary
UnifiedStructuredArrayTest() + +
+           
+  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+Method Summary
+ voidshouldConstructArrayElementsViaElementConstructorGenerator() + +
+           
+ voidshouldConstructArrayOfGivenDirectLengths() + +
+           
+ voidshouldConstructArrayOfGivenLengthAndInitValues() + +
+           
+ voidshouldConstructArrayOfGivenLengthsLongArray() + +
+           
+ voidshouldConstructArrayOfGivenLengthsPrimitiveLongArray() + +
+           
+ voidshouldConstructCopyOfArray() + +
+           
+ voidshouldConstructCopyOfArrayRange() + +
+           
+ voidshouldCopyEvenWithFinalFields() + +
+           
+ voidshouldCopyRegionLeftInArray() + +
+           
+ voidshouldCopyRegionRightInArray() + +
+           
+ voidshouldIterateOverArray() + +
+           
+ voidshouldIterateOverArrayAndResetAgain() + +
+           
+ voidshouldNotThrowIncompatibleTypeExceptionForGetsOfProperTypes() + +
+           
+ voidshouldSetAndGetCorrectValueAtGivenIndex() + +
+           
+ voidshouldThrowExceptionWhenFinalFieldWouldBeCopied() + +
+           
+ voidshouldThrowIncompatibleTypeExceptionForGetOfAnArrayInsteadOfElement() + +
+           
+ voidshouldThrowIncompatibleTypeExceptionForGetOfAnElementInsteadOfArray() + +
+           
+ voidshouldThrowOutOfBoundExceptionForAccessesOutOfBounds() + +
+           
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+UnifiedStructuredArrayTest

+
+public UnifiedStructuredArrayTest()
+
+
+ + + + + + + + +
+Method Detail
+ +

+shouldConstructArrayOfGivenDirectLengths

+
+public void shouldConstructArrayOfGivenDirectLengths()
+                                              throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldConstructArrayOfGivenLengthsLongArray

+
+public void shouldConstructArrayOfGivenLengthsLongArray()
+                                                 throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldConstructArrayOfGivenLengthsPrimitiveLongArray

+
+public void shouldConstructArrayOfGivenLengthsPrimitiveLongArray()
+                                                          throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldConstructArrayOfGivenLengthAndInitValues

+
+public void shouldConstructArrayOfGivenLengthAndInitValues()
+                                                    throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldConstructArrayElementsViaElementConstructorGenerator

+
+public void shouldConstructArrayElementsViaElementConstructorGenerator()
+                                                                throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldSetAndGetCorrectValueAtGivenIndex

+
+public void shouldSetAndGetCorrectValueAtGivenIndex()
+                                             throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldIterateOverArray

+
+public void shouldIterateOverArray()
+                            throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldIterateOverArrayAndResetAgain

+
+public void shouldIterateOverArrayAndResetAgain()
+                                         throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldConstructCopyOfArray

+
+public void shouldConstructCopyOfArray()
+                                throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldConstructCopyOfArrayRange

+
+public void shouldConstructCopyOfArrayRange()
+                                     throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldThrowOutOfBoundExceptionForAccessesOutOfBounds

+
+public void shouldThrowOutOfBoundExceptionForAccessesOutOfBounds()
+                                                          throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldThrowIncompatibleTypeExceptionForGetOfAnElementInsteadOfArray

+
+public void shouldThrowIncompatibleTypeExceptionForGetOfAnElementInsteadOfArray()
+                                                                         throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldThrowIncompatibleTypeExceptionForGetOfAnArrayInsteadOfElement

+
+public void shouldThrowIncompatibleTypeExceptionForGetOfAnArrayInsteadOfElement()
+                                                                         throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldNotThrowIncompatibleTypeExceptionForGetsOfProperTypes

+
+public void shouldNotThrowIncompatibleTypeExceptionForGetsOfProperTypes()
+                                                                 throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldCopyRegionLeftInArray

+
+public void shouldCopyRegionLeftInArray()
+                                 throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldCopyRegionRightInArray

+
+public void shouldCopyRegionRightInArray()
+                                  throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldCopyEvenWithFinalFields

+
+public void shouldCopyEvenWithFinalFields()
+                                   throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldThrowExceptionWhenFinalFieldWouldBeCopied

+
+public void shouldThrowExceptionWhenFinalFieldWouldBeCopied()
+                                                     throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/package-frame.html b/JavaDoc/org/ObjectLayout/package-frame.html index e4dbca7..48ac790 100644 --- a/JavaDoc/org/ObjectLayout/package-frame.html +++ b/JavaDoc/org/ObjectLayout/package-frame.html @@ -2,7 +2,7 @@ - + org.ObjectLayout diff --git a/JavaDoc/org/ObjectLayout/package-summary.html b/JavaDoc/org/ObjectLayout/package-summary.html index d7b91e5..47c8422 100644 --- a/JavaDoc/org/ObjectLayout/package-summary.html +++ b/JavaDoc/org/ObjectLayout/package-summary.html @@ -2,7 +2,7 @@ - + org.ObjectLayout diff --git a/JavaDoc/org/ObjectLayout/package-tree.html b/JavaDoc/org/ObjectLayout/package-tree.html index a73502f..6e24733 100644 --- a/JavaDoc/org/ObjectLayout/package-tree.html +++ b/JavaDoc/org/ObjectLayout/package-tree.html @@ -2,7 +2,7 @@ - + org.ObjectLayout Class Hierarchy diff --git a/JavaDoc/overview-tree.html b/JavaDoc/overview-tree.html index 0326514..b8ecdb1 100644 --- a/JavaDoc/overview-tree.html +++ b/JavaDoc/overview-tree.html @@ -2,7 +2,7 @@ - + Class Hierarchy From 160b01c925c1c6d8a770fbeda14e312ee75db630 Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Wed, 12 Jun 2013 09:08:19 -0500 Subject: [PATCH 17/39] JavaDoc update --- JavaDoc/allclasses-frame.html | 10 +- JavaDoc/allclasses-noframe.html | 10 +- JavaDoc/constant-values.html | 4 +- JavaDoc/deprecated-list.html | 4 +- JavaDoc/help-doc.html | 4 +- JavaDoc/index-files/index-1.html | 8 +- JavaDoc/index-files/index-10.html | 30 +- JavaDoc/index-files/index-11.html | 46 +- JavaDoc/index-files/index-2.html | 30 +- JavaDoc/index-files/index-3.html | 8 +- JavaDoc/index-files/index-4.html | 130 +-- JavaDoc/index-files/index-5.html | 14 +- JavaDoc/index-files/index-6.html | 14 +- JavaDoc/index-files/index-7.html | 8 +- JavaDoc/index-files/index-8.html | 58 +- JavaDoc/index-files/index-9.html | 8 +- JavaDoc/index.html | 2 +- .../ArrayConstructorAndArgsLocator.html | 4 +- .../org/ObjectLayout/ConstructorAndArgs.html | 4 +- .../ConstructorAndArgsLocator.html | 10 +- .../CopyConstructorAndArgsLocator.html | 39 +- .../FixedConstructorAndArgsLocator.html | 4 +- ...ensionalCopyConstructorAndArgsLocator.html | 10 +- ...onalStructuredArray.StructureIterator.html | 8 +- .../MultiDimensionalStructuredArray.html | 36 +- ...ensionalCopyConstructorAndArgsLocator.html | 371 ++++++++ ...onalStructuredArray.StructureIterator.html | 337 +++++++ .../SingleDimensionalStructuredArray.html | 691 ++++++++++++++ .../StructuredArray.StructureIterator.html | 30 +- JavaDoc/org/ObjectLayout/StructuredArray.html | 892 +++++++++++++++--- JavaDoc/org/ObjectLayout/package-frame.html | 10 +- JavaDoc/org/ObjectLayout/package-summary.html | 16 +- JavaDoc/org/ObjectLayout/package-tree.html | 10 +- JavaDoc/overview-tree.html | 10 +- 34 files changed, 2480 insertions(+), 390 deletions(-) create mode 100644 JavaDoc/org/ObjectLayout/SingleDimensionalCopyConstructorAndArgsLocator.html create mode 100644 JavaDoc/org/ObjectLayout/SingleDimensionalStructuredArray.StructureIterator.html create mode 100644 JavaDoc/org/ObjectLayout/SingleDimensionalStructuredArray.html diff --git a/JavaDoc/allclasses-frame.html b/JavaDoc/allclasses-frame.html index 1063d74..45096ab 100644 --- a/JavaDoc/allclasses-frame.html +++ b/JavaDoc/allclasses-frame.html @@ -2,12 +2,12 @@ - + All Classes - + @@ -35,11 +35,11 @@
MultiDimensionalStructuredArray
-StructuredArray +SingleDimensionalCopyConstructorAndArgsLocator
-UnifiedCopyConstructorAndArgsLocator +SingleDimensionalStructuredArray
-UnifiedStructuredArray +StructuredArray
diff --git a/JavaDoc/allclasses-noframe.html b/JavaDoc/allclasses-noframe.html index fcf4dc2..0a3077e 100644 --- a/JavaDoc/allclasses-noframe.html +++ b/JavaDoc/allclasses-noframe.html @@ -2,12 +2,12 @@ - + All Classes - + @@ -35,11 +35,11 @@
MultiDimensionalStructuredArray
-StructuredArray +SingleDimensionalCopyConstructorAndArgsLocator
-UnifiedCopyConstructorAndArgsLocator +SingleDimensionalStructuredArray
-UnifiedStructuredArray +StructuredArray
diff --git a/JavaDoc/constant-values.html b/JavaDoc/constant-values.html index 1996d5f..37d3455 100644 --- a/JavaDoc/constant-values.html +++ b/JavaDoc/constant-values.html @@ -2,12 +2,12 @@ - + Constant Field Values - + diff --git a/JavaDoc/deprecated-list.html b/JavaDoc/deprecated-list.html index 6b8ffc2..2f66c69 100644 --- a/JavaDoc/deprecated-list.html +++ b/JavaDoc/deprecated-list.html @@ -2,12 +2,12 @@ - + Deprecated List - + diff --git a/JavaDoc/help-doc.html b/JavaDoc/help-doc.html index 14e00f7..a2722d5 100644 --- a/JavaDoc/help-doc.html +++ b/JavaDoc/help-doc.html @@ -2,12 +2,12 @@ - + API Help - + diff --git a/JavaDoc/index-files/index-1.html b/JavaDoc/index-files/index-1.html index bb9c8f0..78788ff 100644 --- a/JavaDoc/index-files/index-1.html +++ b/JavaDoc/index-files/index-1.html @@ -2,12 +2,12 @@ - + A-Index - + @@ -76,7 +76,7 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S

A

@@ -139,7 +139,7 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S
diff --git a/JavaDoc/index-files/index-10.html b/JavaDoc/index-files/index-10.html index 53649a8..cfaa9de 100644 --- a/JavaDoc/index-files/index-10.html +++ b/JavaDoc/index-files/index-10.html @@ -2,12 +2,12 @@ - + R-Index - + @@ -76,7 +76,7 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S

R

@@ -88,33 +88,33 @@
Recycle a ConstructorAndArgs instance (place it back in the internal cache if desired).
recycle(ConstructorAndArgs) - Method in class org.ObjectLayout.CopyConstructorAndArgsLocator -
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired). -
recycle(ConstructorAndArgs) - -Method in class org.ObjectLayout.MultiDimensionalCopyConstructorAndArgsLocator
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired). -
recycle(ConstructorAndArgs) - -Method in class org.ObjectLayout.UnifiedCopyConstructorAndArgsLocator +
recycle(ConstructorAndArgs) - +Method in class org.ObjectLayout.MultiDimensionalCopyConstructorAndArgsLocator
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired). +
recycle(ConstructorAndArgs) - +Method in class org.ObjectLayout.SingleDimensionalCopyConstructorAndArgsLocator +
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired).
remove() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator
Remove operation is not supported on MultiDimensionalStructuredArrays. +
remove() - +Method in class org.ObjectLayout.SingleDimensionalStructuredArray.StructureIterator +
Remove operation is not supported on SingleDimensionalStructuredArrays.
remove() - Method in class org.ObjectLayout.StructuredArray.StructureIterator
Remove operation is not supported on StructuredArrays. -
remove() - -Method in class org.ObjectLayout.UnifiedStructuredArray.StructureIterator -
Remove operation is not supported on UnifiedStructuredArrays.
reset() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator
Reset to the beginning of the collection enabling reuse of the iterator. +
reset() - +Method in class org.ObjectLayout.SingleDimensionalStructuredArray.StructureIterator +
Reset to the beginning of the collection enabling reuse of the iterator.
reset() - Method in class org.ObjectLayout.StructuredArray.StructureIterator
Reset to the beginning of the collection enabling reuse of the iterator. -
reset() - -Method in class org.ObjectLayout.UnifiedStructuredArray.StructureIterator -
Reset to the beginning of the collection enabling reuse of the iterator.

@@ -167,7 +167,7 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S
diff --git a/JavaDoc/index-files/index-11.html b/JavaDoc/index-files/index-11.html index 7483452..2a4d244 100644 --- a/JavaDoc/index-files/index-11.html +++ b/JavaDoc/index-files/index-11.html @@ -2,12 +2,12 @@ - + S-Index - + @@ -54,7 +54,7 @@  PREV LETTER  - NEXT LETTER + NEXT LETTER
FRAMES    NO FRAMES   @@ -76,7 +76,7 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S

S

@@ -86,22 +86,38 @@
setConstructorArgs(Object[]) - Method in class org.ObjectLayout.ConstructorAndArgs
Set the constructor arguments to be indicated in this ConstructorAndArgs. +
shallowCopy(SingleDimensionalStructuredArray, long, SingleDimensionalStructuredArray, long, long) - +Static method in class org.ObjectLayout.SingleDimensionalStructuredArray +
Shallow copy a region of element object contents from one array to the other. +
shallowCopy(SingleDimensionalStructuredArray, long, SingleDimensionalStructuredArray, long, long, boolean) - +Static method in class org.ObjectLayout.SingleDimensionalStructuredArray +
Shallow copy a region of element object contents from one array to the other.
shallowCopy(StructuredArray, long, StructuredArray, long, long) - Static method in class org.ObjectLayout.StructuredArray
Shallow copy a region of element object contents from one array to the other.
shallowCopy(StructuredArray, long, StructuredArray, long, long, boolean) - Static method in class org.ObjectLayout.StructuredArray
Shallow copy a region of element object contents from one array to the other. -
shallowCopy(UnifiedStructuredArray, long, UnifiedStructuredArray, long, long) - -Static method in class org.ObjectLayout.UnifiedStructuredArray -
Shallow copy a region of element object contents from one array to the other. -
shallowCopy(UnifiedStructuredArray, long, UnifiedStructuredArray, long, long, boolean) - -Static method in class org.ObjectLayout.UnifiedStructuredArray -
Shallow copy a region of element object contents from one array to the other. -
StructuredArray<T> - Class in org.ObjectLayout
An array of (potentially) mutable but non-replaceable objects.
StructuredArray(ConstructorAndArgsLocator<T>, long, long[]) - -Constructor for class org.ObjectLayout.StructuredArray +
SingleDimensionalCopyConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports the construction of a new array's individual elements using a copy constructor to copy a source + array's corresponding elements.
SingleDimensionalCopyConstructorAndArgsLocator(Class<T>, SingleDimensionalStructuredArray<T>) - +Constructor for class org.ObjectLayout.SingleDimensionalCopyConstructorAndArgsLocator +
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array +
SingleDimensionalCopyConstructorAndArgsLocator(Class<T>, SingleDimensionalStructuredArray<T>, long) - +Constructor for class org.ObjectLayout.SingleDimensionalCopyConstructorAndArgsLocator +
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +
SingleDimensionalCopyConstructorAndArgsLocator(Class<T>, SingleDimensionalStructuredArray<T>, long, boolean) - +Constructor for class org.ObjectLayout.SingleDimensionalCopyConstructorAndArgsLocator +
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +
SingleDimensionalStructuredArray<T> - Class in org.ObjectLayout
An array of (potentially) mutable but non-replaceable objects.
SingleDimensionalStructuredArray(ConstructorAndArgsLocator<T>, long, long[]) - +Constructor for class org.ObjectLayout.SingleDimensionalStructuredArray +
  +
SingleDimensionalStructuredArray.StructureIterator - Class in org.ObjectLayout
Specialised Iterator with the ability to be SingleDimensionalStructuredArray.StructureIterator.reset() enabling reuse.
SingleDimensionalStructuredArray.StructureIterator() - +Constructor for class org.ObjectLayout.SingleDimensionalStructuredArray.StructureIterator
  -
StructuredArray.StructureIterator - Class in org.ObjectLayout
Specialised Iterator with the ability to be StructuredArray.StructureIterator.reset() enabling reuse.
StructuredArray.StructureIterator() - +
StructuredArray<T> - Class in org.ObjectLayout
An array of (potentially) mutable but non-replaceable objects.
StructuredArray.StructureIterator - Class in org.ObjectLayout
Specialised Iterator with the ability to be reset() enabling reuse.
StructuredArray.StructureIterator() - Constructor for class org.ObjectLayout.StructuredArray.StructureIterator
 
@@ -134,7 +150,7 @@  PREV LETTER  - NEXT LETTER + NEXT LETTER
FRAMES    NO FRAMES   @@ -156,7 +172,7 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S
diff --git a/JavaDoc/index-files/index-2.html b/JavaDoc/index-files/index-2.html index e45406b..80eec58 100644 --- a/JavaDoc/index-files/index-2.html +++ b/JavaDoc/index-files/index-2.html @@ -2,12 +2,12 @@ - + C-Index - + @@ -76,7 +76,7 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S

C

@@ -92,11 +92,11 @@ Constructor for class org.ObjectLayout.CopyConstructorAndArgsLocator
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a source array -
CopyConstructorAndArgsLocator(Class<T>, StructuredArray<T>, long) - +
CopyConstructorAndArgsLocator(Class<T>, StructuredArray<T>, long[]) - Constructor for class org.ObjectLayout.CopyConstructorAndArgsLocator
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a source array, starting at a given offset -
CopyConstructorAndArgsLocator(Class<T>, StructuredArray<T>, long, boolean) - +
CopyConstructorAndArgsLocator(Class<T>, StructuredArray<T>, long[], boolean) - Constructor for class org.ObjectLayout.CopyConstructorAndArgsLocator
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a source array, starting at a given offset @@ -109,20 +109,20 @@
copyInstance(MultiDimensionalStructuredArray<T>, long[], long[]) - Static method in class org.ObjectLayout.MultiDimensionalStructuredArray
Copy a range from an array of elements to a newly created array. +
copyInstance(SingleDimensionalStructuredArray<T>) - +Static method in class org.ObjectLayout.SingleDimensionalStructuredArray +
Copy an array of elements to a newly created array. +
copyInstance(SingleDimensionalStructuredArray<T>, long, long) - +Static method in class org.ObjectLayout.SingleDimensionalStructuredArray +
Copy a range from an array of elements to a newly created array.
copyInstance(StructuredArray<T>) - Static method in class org.ObjectLayout.StructuredArray
Copy an array of elements to a newly created array. -
copyInstance(StructuredArray<T>, long, long) - +
copyInstance(StructuredArray<T>, long[], Long...) - Static method in class org.ObjectLayout.StructuredArray
Copy a range from an array of elements to a newly created array. -
copyInstance(UnifiedStructuredArray<T>) - -Static method in class org.ObjectLayout.UnifiedStructuredArray -
Copy an array of elements to a newly created array. -
copyInstance(UnifiedStructuredArray<T>, long[], Long...) - -Static method in class org.ObjectLayout.UnifiedStructuredArray -
Copy a range from an array of elements to a newly created array. -
copyInstance(UnifiedStructuredArray<T>, long[], long[]) - -Static method in class org.ObjectLayout.UnifiedStructuredArray +
copyInstance(StructuredArray<T>, long[], long[]) - +Static method in class org.ObjectLayout.StructuredArray
Copy a range from an array of elements to a newly created array.

@@ -176,7 +176,7 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S
diff --git a/JavaDoc/index-files/index-3.html b/JavaDoc/index-files/index-3.html index d0e13a9..cb776e7 100644 --- a/JavaDoc/index-files/index-3.html +++ b/JavaDoc/index-files/index-3.html @@ -2,12 +2,12 @@ - + F-Index - + @@ -76,7 +76,7 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S

F

@@ -142,7 +142,7 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S
diff --git a/JavaDoc/index-files/index-4.html b/JavaDoc/index-files/index-4.html index d1a5f83..24cb2fc 100644 --- a/JavaDoc/index-files/index-4.html +++ b/JavaDoc/index-files/index-4.html @@ -2,12 +2,12 @@ - + G-Index - + @@ -76,7 +76,7 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S

G

@@ -92,24 +92,45 @@
get(int, int, int, int) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
Get a reference to an element in the array, using 4 int indexes. +
get(int) - +Method in class org.ObjectLayout.SingleDimensionalStructuredArray +
Get a reference to an element in the array, using an int index. +
get(long[]) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using a long[] index array. +
get(long[], int) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using long indexes supplied in an array. +
get(Long...) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using a varargs long indexes. +
get(Integer...) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using a varargs int indexes. +
get(long) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using a long index. +
get(long, long) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using 2 long indexes. +
get(long, long, long) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using 3 long indexes. +
get(long, long, long, long) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using 4 long indexes.
get(int) - Method in class org.ObjectLayout.StructuredArray
Get a reference to an element in the array, using an int index. -
get(Integer...) - -Method in class org.ObjectLayout.UnifiedStructuredArray -
Get a reference to an element in the array, using a varargs int indexes. -
get(int, int) - -Method in class org.ObjectLayout.UnifiedStructuredArray +
get(int, int) - +Method in class org.ObjectLayout.StructuredArray
Get a reference to an element in the array, using 2 int indexes. -
get(int, int, int) - -Method in class org.ObjectLayout.UnifiedStructuredArray +
get(int, int, int) - +Method in class org.ObjectLayout.StructuredArray
Get a reference to an element in the array, using 3 int indexes. -
get(int, int, int, int) - -Method in class org.ObjectLayout.UnifiedStructuredArray +
get(int, int, int, int) - +Method in class org.ObjectLayout.StructuredArray
Get a reference to an element in the array, using 4 int indexes. -
get(int) - -Method in class org.ObjectLayout.UnifiedStructuredArray -
Get a reference to an element in the array, using an int index.
getConstructor() - Method in class org.ObjectLayout.ConstructorAndArgs
  @@ -119,21 +140,24 @@
getCursors() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator
  -
getCursors() - -Method in class org.ObjectLayout.UnifiedStructuredArray.StructureIterator +
getCursors() - +Method in class org.ObjectLayout.StructuredArray.StructureIterator
  +
getDimensionCount() - +Method in class org.ObjectLayout.StructuredArray +
Get the number of dimensions of the array.
getElementClass() - Method in class org.ObjectLayout.ConstructorAndArgsLocator
Get the Class of the elements to be constructed
getElementClass() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
Get the Class of elements stored in the array. +
getElementClass() - +Method in class org.ObjectLayout.SingleDimensionalStructuredArray +
Get the Class of elements stored in the array.
getElementClass() - Method in class org.ObjectLayout.StructuredArray
Get the Class of elements stored in the array. -
getElementClass() - -Method in class org.ObjectLayout.UnifiedStructuredArray -
Get the Class of elements stored in the array.
getForIndex(long) - Method in class org.ObjectLayout.ArrayConstructorAndArgsLocator
Get a ConstructorAndArgs instance to be used in constructing a given element index in @@ -156,11 +180,11 @@
getForIndexes(long[]) - Method in class org.ObjectLayout.MultiDimensionalCopyConstructorAndArgsLocator
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray. -
getForIndexes(long[]) - -Method in class org.ObjectLayout.UnifiedCopyConstructorAndArgsLocator + a MultiDimensionalStructuredArray. +
getForIndexes(long[]) - +Method in class org.ObjectLayout.SingleDimensionalCopyConstructorAndArgsLocator
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray. + a SingleDimensionalStructuredArray.
getL(long[]) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
Get a reference to an element in the array, using a long[] index array. @@ -179,74 +203,50 @@
getL(long, long, long, long) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
Get a reference to an element in the array, using 4 long indexes. -
getL(long) - -Method in class org.ObjectLayout.StructuredArray -
Get a reference to an element in the array, using a long index. -
getL(long[]) - -Method in class org.ObjectLayout.UnifiedStructuredArray -
Get a reference to an element in the array, using a long[] index array. -
getL(long[], int) - -Method in class org.ObjectLayout.UnifiedStructuredArray -
Get a reference to an element in the array, using long indexes supplied in an array. -
getL(Long...) - -Method in class org.ObjectLayout.UnifiedStructuredArray -
Get a reference to an element in the array, using a varargs long indexes. -
getL(long, long) - -Method in class org.ObjectLayout.UnifiedStructuredArray -
Get a reference to an element in the array, using 2 long indexes. -
getL(long, long, long) - -Method in class org.ObjectLayout.UnifiedStructuredArray -
Get a reference to an element in the array, using 3 long indexes. -
getL(long, long, long, long) - -Method in class org.ObjectLayout.UnifiedStructuredArray -
Get a reference to an element in the array, using 4 long indexes. -
getL(long) - -Method in class org.ObjectLayout.UnifiedStructuredArray +
getL(long) - +Method in class org.ObjectLayout.SingleDimensionalStructuredArray
Get a reference to an element in the array, using a long index.
getLength() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
Get the length (number of elements) of the array. +
getLength() - +Method in class org.ObjectLayout.SingleDimensionalStructuredArray +
Get the length (number of elements) of the array.
getLength() - Method in class org.ObjectLayout.StructuredArray
Get the length (number of elements) of the array. -
getLength() - -Method in class org.ObjectLayout.UnifiedStructuredArray -
Get the length (number of elements) of the array.
getLengths() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
Get the lengths (number of elements per dimension) of the array. -
getLengths() - -Method in class org.ObjectLayout.UnifiedStructuredArray +
getLengths() - +Method in class org.ObjectLayout.StructuredArray
Get the lengths (number of elements per dimension) of the array.
getNumOfDimensions() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
Get the number of dimensions of the array. -
getNumOfDimensions() - -Method in class org.ObjectLayout.UnifiedStructuredArray -
Get the number of dimensions of the array.
getOfMultiDimensionalStructuredArray(int) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
Get a reference to a MultiDimensionalStructuredArray element in this array, using a int index.
getOfMultiDimensionalStructuredArrayL(long) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get a reference to a StructuredArray element in this array, using a long index. +
Get a reference to a SingleDimensionalStructuredArray element in this array, using a long index.
getOfStructuredArray(int) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
Get a reference to a MultiDimensionalStructuredArray element in this array, using a int index.
getOfStructuredArrayL(long) - Method in class org.ObjectLayout.MultiDimensionalStructuredArray +
Get a reference to a SingleDimensionalStructuredArray element in this array, using a long index. +
getSubArray(long) - +Method in class org.ObjectLayout.StructuredArray
Get a reference to a StructuredArray element in this array, using a long index. -
getOfUnifiedStructuredArray(int) - -Method in class org.ObjectLayout.UnifiedStructuredArray -
Get a reference to a UnifiedStructuredArray element in this array, using a int index. -
getOfUnifiedStructuredArrayL(long) - -Method in class org.ObjectLayout.UnifiedStructuredArray -
Get a reference to a UnifiedStructuredArray element in this array, using a long index. +
getSubArray(int) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to a StructuredArray element in this array, using a int index.
getTotalElementCount() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
Get the total number of elements (in all dimensions combined) in this multi-dimensional array. -
getTotalElementCount() - -Method in class org.ObjectLayout.UnifiedStructuredArray +
getTotalElementCount() - +Method in class org.ObjectLayout.StructuredArray
Get the total number of elements (in all dimensions combined) in this multi-dimensional array.

@@ -300,7 +300,7 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S
diff --git a/JavaDoc/index-files/index-5.html b/JavaDoc/index-files/index-5.html index 97bf978..a71a8d7 100644 --- a/JavaDoc/index-files/index-5.html +++ b/JavaDoc/index-files/index-5.html @@ -2,12 +2,12 @@ - + H-Index - + @@ -76,19 +76,19 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S

H

hasNext() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator
+
hasNext() - +Method in class org.ObjectLayout.SingleDimensionalStructuredArray.StructureIterator +
hasNext() - Method in class org.ObjectLayout.StructuredArray.StructureIterator
-
hasNext() - -Method in class org.ObjectLayout.UnifiedStructuredArray.StructureIterator -

@@ -141,7 +141,7 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S
diff --git a/JavaDoc/index-files/index-6.html b/JavaDoc/index-files/index-6.html index 0bcc4fd..df75c50 100644 --- a/JavaDoc/index-files/index-6.html +++ b/JavaDoc/index-files/index-6.html @@ -2,12 +2,12 @@ - + I-Index - + @@ -76,19 +76,19 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S

I

iterator() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray
+
iterator() - +Method in class org.ObjectLayout.SingleDimensionalStructuredArray +
iterator() - Method in class org.ObjectLayout.StructuredArray
-
iterator() - -Method in class org.ObjectLayout.UnifiedStructuredArray -

@@ -141,7 +141,7 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S
diff --git a/JavaDoc/index-files/index-7.html b/JavaDoc/index-files/index-7.html index 93afb0d..8ccb773 100644 --- a/JavaDoc/index-files/index-7.html +++ b/JavaDoc/index-files/index-7.html @@ -2,12 +2,12 @@ - + M-Index - + @@ -76,7 +76,7 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S

M

@@ -148,7 +148,7 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S
diff --git a/JavaDoc/index-files/index-8.html b/JavaDoc/index-files/index-8.html index de3e0f6..6928d8f 100644 --- a/JavaDoc/index-files/index-8.html +++ b/JavaDoc/index-files/index-8.html @@ -2,12 +2,12 @@ - + N-Index - + @@ -76,7 +76,7 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S

N

@@ -95,54 +95,54 @@
newInstance(ConstructorAndArgsLocator<T>, long[]) - Static method in class org.ObjectLayout.MultiDimensionalStructuredArray
Create a multi dimensional array of elements. -
newInstance(Class<T>, long) - -Static method in class org.ObjectLayout.StructuredArray +
newInstance(Class<T>, long) - +Static method in class org.ObjectLayout.SingleDimensionalStructuredArray
Create an array of length elements, each containing an element object of type elementClass. -
newInstance(ConstructorAndArgsLocator<T>, long) - -Static method in class org.ObjectLayout.StructuredArray +
newInstance(ConstructorAndArgsLocator<T>, long) - +Static method in class org.ObjectLayout.SingleDimensionalStructuredArray
Create an array of length elements, each containing an element object of type elementClass. -
newInstance(Class<T>, long, Class[], Object...) - -Static method in class org.ObjectLayout.StructuredArray +
newInstance(Class<T>, long, Class[], Object...) - +Static method in class org.ObjectLayout.SingleDimensionalStructuredArray
Create an array of length elements, each containing an element object of type elementClass. -
newInstance(Class<T>, long) - -Static method in class org.ObjectLayout.UnifiedStructuredArray +
newInstance(Class<T>, long) - +Static method in class org.ObjectLayout.StructuredArray
Create an array of length elements, each containing an element object of type elementClass. -
newInstance(ConstructorAndArgsLocator<T>, long) - -Static method in class org.ObjectLayout.UnifiedStructuredArray +
newInstance(ConstructorAndArgsLocator<T>, long) - +Static method in class org.ObjectLayout.StructuredArray
Create an array of length elements, each containing an element object of type elementClass. -
newInstance(Class<T>, long, Class[], Object...) - -Static method in class org.ObjectLayout.UnifiedStructuredArray +
newInstance(Class<T>, long, Class[], Object...) - +Static method in class org.ObjectLayout.StructuredArray
Create an array of length elements, each containing an element object of type elementClass. -
newInstance(Class, Long...) - -Static method in class org.ObjectLayout.UnifiedStructuredArray +
newInstance(Class<T>, Long...) - +Static method in class org.ObjectLayout.StructuredArray
Create a multi dimensional array of elements. -
newInstance(Class<T>, long[]) - -Static method in class org.ObjectLayout.UnifiedStructuredArray +
newInstance(Class<T>, long[]) - +Static method in class org.ObjectLayout.StructuredArray
Create a multi dimensional array of elements. -
newInstance(Class<T>, long[], Class[], Object...) - -Static method in class org.ObjectLayout.UnifiedStructuredArray +
newInstance(Class<T>, long[], Class[], Object...) - +Static method in class org.ObjectLayout.StructuredArray
Create a multi dimensional array of elements. -
newInstance(ConstructorAndArgsLocator<T>, Long...) - -Static method in class org.ObjectLayout.UnifiedStructuredArray +
newInstance(ConstructorAndArgsLocator<T>, Long...) - +Static method in class org.ObjectLayout.StructuredArray
Create a multi dimensional array of elements. -
newInstance(ConstructorAndArgsLocator<T>, long[]) - -Static method in class org.ObjectLayout.UnifiedStructuredArray +
newInstance(ConstructorAndArgsLocator<T>, long[]) - +Static method in class org.ObjectLayout.StructuredArray
Create a multi dimensional array of elements.
next() - Method in class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator
+
next() - +Method in class org.ObjectLayout.SingleDimensionalStructuredArray.StructureIterator +
next() - Method in class org.ObjectLayout.StructuredArray.StructureIterator
-
next() - -Method in class org.ObjectLayout.UnifiedStructuredArray.StructureIterator -

@@ -195,7 +195,7 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S
diff --git a/JavaDoc/index-files/index-9.html b/JavaDoc/index-files/index-9.html index 7699804..becaa86 100644 --- a/JavaDoc/index-files/index-9.html +++ b/JavaDoc/index-files/index-9.html @@ -2,12 +2,12 @@ - + O-Index - + @@ -76,7 +76,7 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S

O

@@ -132,7 +132,7 @@ -A C F G H I M N O R S U
+A C F G H I M N O R S
diff --git a/JavaDoc/index.html b/JavaDoc/index.html index 675c6fe..03820a9 100644 --- a/JavaDoc/index.html +++ b/JavaDoc/index.html @@ -2,7 +2,7 @@ - + Generated Documentation (Untitled) diff --git a/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html index 6dc8a14..347df96 100644 --- a/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + ArrayConstructorAndArgsLocator - + diff --git a/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html b/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html index a785edc..8dc18de 100644 --- a/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html +++ b/JavaDoc/org/ObjectLayout/ConstructorAndArgs.html @@ -2,12 +2,12 @@ - + ConstructorAndArgs - + diff --git a/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html index 0c4f370..0dc6b58 100644 --- a/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + ConstructorAndArgsLocator - + @@ -96,7 +96,7 @@

Type Parameters:
T - type of the element occupying each array slot.
-
Direct Known Subclasses:
ArrayConstructorAndArgsLocator, CopyConstructorAndArgsLocator, FixedConstructorAndArgsLocator, MultiDimensionalCopyConstructorAndArgsLocator, UnifiedCopyConstructorAndArgsLocator
+
Direct Known Subclasses:
ArrayConstructorAndArgsLocator, CopyConstructorAndArgsLocator, FixedConstructorAndArgsLocator, MultiDimensionalCopyConstructorAndArgsLocator, SingleDimensionalCopyConstructorAndArgsLocator

@@ -109,7 +109,7 @@

Subclasses can be created that would provide a fixed constructor (as in FixedConstructorAndArgsLocator), or to provide arguments and constructor values that would take the array index of the constructed element into account. - An example of this latter pattern can be found in the implementation of a CopyConstructorAndArgsLocator. + An example of this latter pattern can be found in the implementation of a SingleDimensionalCopyConstructorAndArgsLocator.

@@ -243,7 +243,7 @@

the returned ConstructorAndArgs is not constant.

Recycling is optional, and is not guaranteed to occur. It will only be done if it is helpful. - Overriding this method is optional for subclasses. See example in CopyConstructorAndArgsLocator + Overriding this method is optional for subclasses. See example in SingleDimensionalCopyConstructorAndArgsLocator

Parameters:
constructorAndArgs - the ConstructorAndArgs instance to recycle
diff --git a/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html index d391138..29cc59a 100644 --- a/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + CopyConstructorAndArgsLocator - + @@ -128,18 +128,18 @@

source array -CopyConstructorAndArgsLocator(java.lang.Class<T> elementClass, +CopyConstructorAndArgsLocator(java.lang.Class<T> elementClass, StructuredArray<T> source, - long sourceOffset) + long[] sourceOffsets)
          Used to apply a copy constructor to a target array's elements, copying corresponding elements from a source array, starting at a given offset -CopyConstructorAndArgsLocator(java.lang.Class<T> elementClass, +CopyConstructorAndArgsLocator(java.lang.Class<T> elementClass, StructuredArray<T> source, - long sourceOffset, + long[] sourceOffsets, boolean keepInternalCachingThreadSafe)
@@ -171,7 +171,8 @@

recycle(ConstructorAndArgs constructorAndArgs)
-          Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired). +          Recycle an ConstructorAndArgs instance (place it back in the internal cache if + desired).   @@ -222,30 +223,30 @@


-

+

CopyConstructorAndArgsLocator

 public CopyConstructorAndArgsLocator(java.lang.Class<T> elementClass,
                                      StructuredArray<T> source,
-                                     long sourceOffset)
+                                     long[] sourceOffsets)
                               throws java.lang.NoSuchMethodException
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a source array, starting at a given offset

-
Parameters:
elementClass - The class of the elements to be constructed
source - The source StructuredArray to copy from
sourceOffset - The beginning index in the source from which to start copying +
Parameters:
elementClass - The class of the elements to be constructed
source - The source MultiDimensionalStructuredArray to copy from
sourceOffsets - The beginning index in the source from which to start copying
Throws:
java.lang.NoSuchMethodException - if a copy constructor is not found in element class

-

+

CopyConstructorAndArgsLocator

 public CopyConstructorAndArgsLocator(java.lang.Class<T> elementClass,
                                      StructuredArray<T> source,
-                                     long sourceOffset,
+                                     long[] sourceOffsets,
                                      boolean keepInternalCachingThreadSafe)
                               throws java.lang.NoSuchMethodException
@@ -253,7 +254,7 @@

source array, starting at a given offset

-
Parameters:
elementClass - The class of the elements to be constructed
source - The source StructuredArray to copy from
sourceOffset - The beginning index in the source from which to start copying
keepInternalCachingThreadSafe - Control whether or not internal caching is kept thread-safe +
Parameters:
elementClass - The class of the elements to be constructed
source - The source MultiDimensionalStructuredArray to copy from
sourceOffsets - The beginning index in the source from which to start copying
keepInternalCachingThreadSafe - Control whether or not internal caching is kept thread-safe
Throws:
java.lang.NoSuchMethodException - NoSuchMethodException if a copy constructor is not found in element class

@@ -275,13 +276,13 @@

throws java.lang.NoSuchMethodException
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray. (supports only 1 dimensional array copies). . + a StructuredArray. .

Overrides:
getForIndexes in class ConstructorAndArgsLocator<T>
-
Parameters:
indexes - The index of the element to be constructed in the target array (supports only 1 dimensional copies) +
Parameters:
indexes - The indexes of the element to be constructed in the target array
Returns:
ConstructorAndArgs instance to used in element construction
Throws:
java.lang.NoSuchMethodException - if expected constructor is not found in element class
@@ -294,10 +295,10 @@

 public void recycle(ConstructorAndArgs constructorAndArgs)
-
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired). This is [very] - useful for avoiding a re-allocation of a new ConstructorAndArgs and an associated args array for - getForIndex(long) invocation in cases such as this (where the returned ConstructorAndArgs - is not constant across indices). +
Recycle an ConstructorAndArgs instance (place it back in the internal cache if + desired). This is [very] useful for avoiding a re-allocation of a new ConstructorAndArgs + and an associated args array for getForIndexes(long[]) invocation in cases such as this (where the + returned ConstructorAndArgs is not constant across indices). Recycling is optional, and is not guaranteed to occur.

diff --git a/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html index 59c45a5..17c8483 100644 --- a/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + FixedConstructorAndArgsLocator - + diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalCopyConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/MultiDimensionalCopyConstructorAndArgsLocator.html index f8aade9..b19e39a 100644 --- a/JavaDoc/org/ObjectLayout/MultiDimensionalCopyConstructorAndArgsLocator.html +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalCopyConstructorAndArgsLocator.html @@ -2,12 +2,12 @@ - + MultiDimensionalCopyConstructorAndArgsLocator - + @@ -163,7 +163,7 @@


          Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray. + a MultiDimensionalStructuredArray. @@ -217,7 +217,7 @@

source array

-
Parameters:
elementClass - The class of the elements to be constructed
source - The source StructuredArray to copy from +
Parameters:
elementClass - The class of the elements to be constructed
source - The source MultiDimensionalStructuredArray to copy from
Throws:
java.lang.NoSuchMethodException

@@ -276,7 +276,7 @@

throws java.lang.NoSuchMethodException
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray. . + a MultiDimensionalStructuredArray. .

Overrides:
getForIndexes in class ConstructorAndArgsLocator<T>
diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html index c08931f..513bdd6 100644 --- a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html @@ -2,12 +2,12 @@ - + MultiDimensionalStructuredArray.StructureIterator - + @@ -54,7 +54,7 @@  PREV CLASS  - NEXT CLASSNEXT CLASS
FRAMES    NO FRAMES   @@ -325,7 +325,7 @@

 PREV CLASS  - NEXT CLASSNEXT CLASS FRAMES    NO FRAMES   diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html index 5c10218..d873d80 100644 --- a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html +++ b/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html @@ -2,12 +2,12 @@ - + MultiDimensionalStructuredArray - + @@ -107,7 +107,7 @@

An array of (potentially) mutable but non-replaceable objects.

A structured array contains array element objects of a fixed (at creation time, per array instance) class, - and can support elements of any class that provides public constructors. The elements in a StructuredArray + and can support elements of any class that provides public constructors. The elements in a MultiDimensionalStructuredArray are all allocated and constructed at array creation time, and individual elements cannot be removed or replaced after array creation. Array elements can be accessed using an index-based accessor methods in the form of get(java.lang.Integer...)() (for int indices) or getL(long[])() @@ -119,7 +119,7 @@

options. The ConstructorAndArgsLocator API provides for array creation with arbitrary, user-supplied constructors and arguments, either of which can take the element index into account.

- StructuredArray is designed with semantics specifically restricted to be consistent with layouts of an + MultiDimensionalStructuredArray is designed with semantics specifically restricted to be consistent with layouts of an array of structures in C-like languages. While fully functional on all JVM implementation (of Java SE 5 and above), the semantics are such that a JVM may transparently optimise the implementation to provide a compact contiguous layout that facilitates consistent stride based memory access and dead-reckoning @@ -347,11 +347,11 @@

getOfMultiDimensionalStructuredArrayL(long index)
-          Get a reference to a StructuredArray element in this array, using a long index. +          Get a reference to a SingleDimensionalStructuredArray element in this array, using a long index. - StructuredArray<T> + SingleDimensionalStructuredArray<T>
getOfStructuredArray(int index)
@@ -359,11 +359,11 @@

- StructuredArray<T> + SingleDimensionalStructuredArray<T> getOfStructuredArrayL(long index)
-          Get a reference to a StructuredArray element in this array, using a long index. +          Get a reference to a SingleDimensionalStructuredArray element in this array, using a long index. @@ -949,17 +949,17 @@

getOfStructuredArrayL

-public StructuredArray<T> getOfStructuredArrayL(long index)
-                                         throws java.lang.ClassCastException
+public SingleDimensionalStructuredArray<T> getOfStructuredArrayL(long index) + throws java.lang.ClassCastException
-
Get a reference to a StructuredArray element in this array, using a long index. +
Get a reference to a SingleDimensionalStructuredArray element in this array, using a long index.

Parameters:
index - -
Returns:
a reference to the StructuredArray located in element [index] of this array +
Returns:
a reference to the SingleDimensionalStructuredArray located in element [index] of this array
Throws:
java.lang.ClassCastException - if array has more than two dimensions
@@ -972,14 +972,14 @@

public MultiDimensionalStructuredArray<T> getOfMultiDimensionalStructuredArrayL(long index) throws java.lang.ClassCastException
-
Get a reference to a StructuredArray element in this array, using a long index. +
Get a reference to a SingleDimensionalStructuredArray element in this array, using a long index.

Parameters:
index - -
Returns:
a reference to the StructuredArray located in element [index] of this array +
Returns:
a reference to the SingleDimensionalStructuredArray located in element [index] of this array
Throws:
java.lang.ClassCastException - if array has only two dimensions
@@ -989,8 +989,8 @@

getOfStructuredArray

-public StructuredArray<T> getOfStructuredArray(int index)
-                                        throws java.lang.ClassCastException
+public SingleDimensionalStructuredArray<T> getOfStructuredArray(int index) + throws java.lang.ClassCastException
Get a reference to a MultiDimensionalStructuredArray element in this array, using a int index.

@@ -999,7 +999,7 @@

Parameters:
index - -
Returns:
a reference to the StructuredArray located in element [index] of this array +
Returns:
a reference to the SingleDimensionalStructuredArray located in element [index] of this array
Throws:
java.lang.ClassCastException - if array has more than two dimensions
@@ -1019,7 +1019,7 @@

Parameters:
index - -
Returns:
a reference to the StructuredArray located in element [index] of this array +
Returns:
a reference to the SingleDimensionalStructuredArray located in element [index] of this array
Throws:
java.lang.ClassCastException - if array has only two dimensions
diff --git a/JavaDoc/org/ObjectLayout/SingleDimensionalCopyConstructorAndArgsLocator.html b/JavaDoc/org/ObjectLayout/SingleDimensionalCopyConstructorAndArgsLocator.html new file mode 100644 index 0000000..52890b9 --- /dev/null +++ b/JavaDoc/org/ObjectLayout/SingleDimensionalCopyConstructorAndArgsLocator.html @@ -0,0 +1,371 @@ + + + + + + +SingleDimensionalCopyConstructorAndArgsLocator + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class SingleDimensionalCopyConstructorAndArgsLocator<T>

+
+java.lang.Object
+  extended by org.ObjectLayout.ConstructorAndArgsLocator<T>
+      extended by org.ObjectLayout.SingleDimensionalCopyConstructorAndArgsLocator<T>
+
+
+
Type Parameters:
T - type of the element occupying each array slot
+
+
+
public class SingleDimensionalCopyConstructorAndArgsLocator<T>
extends ConstructorAndArgsLocator<T>
+ + +

+Supports the construction of a new array's individual elements using a copy constructor to copy a source + array's corresponding elements. +

+ +

+


+ +

+ + + + + + + + + + + + + + + + + +
+Constructor Summary
SingleDimensionalCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass, + SingleDimensionalStructuredArray<T> source) + +
+          Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array
SingleDimensionalCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass, + SingleDimensionalStructuredArray<T> source, + long sourceOffset) + +
+          Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset
SingleDimensionalCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass, + SingleDimensionalStructuredArray<T> source, + long sourceOffset, + boolean keepInternalCachingThreadSafe) + +
+          Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset
+  + + + + + + + + + + + + + + + +
+Method Summary
+ ConstructorAndArgs<T>getForIndexes(long[] indexes) + +
+          Get a ConstructorAndArgs instance to be used in constructing a given element index in + a SingleDimensionalStructuredArray.
+ voidrecycle(ConstructorAndArgs constructorAndArgs) + +
+          Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired).
+ + + + + + + +
Methods inherited from class org.ObjectLayout.ConstructorAndArgsLocator
getElementClass
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+SingleDimensionalCopyConstructorAndArgsLocator

+
+public SingleDimensionalCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass,
+                                                      SingleDimensionalStructuredArray<T> source)
+                                               throws java.lang.NoSuchMethodException
+
+
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array +

+

+
Parameters:
elementClass - The class of the elements to be constructed
source - The source SingleDimensionalStructuredArray to copy from +
Throws: +
java.lang.NoSuchMethodException
+
+
+ +

+SingleDimensionalCopyConstructorAndArgsLocator

+
+public SingleDimensionalCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass,
+                                                      SingleDimensionalStructuredArray<T> source,
+                                                      long sourceOffset)
+                                               throws java.lang.NoSuchMethodException
+
+
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +

+

+
Parameters:
elementClass - The class of the elements to be constructed
source - The source SingleDimensionalStructuredArray to copy from
sourceOffset - The beginning index in the source from which to start copying +
Throws: +
java.lang.NoSuchMethodException - if a copy constructor is not found in element class
+
+
+ +

+SingleDimensionalCopyConstructorAndArgsLocator

+
+public SingleDimensionalCopyConstructorAndArgsLocator(java.lang.Class<T> elementClass,
+                                                      SingleDimensionalStructuredArray<T> source,
+                                                      long sourceOffset,
+                                                      boolean keepInternalCachingThreadSafe)
+                                               throws java.lang.NoSuchMethodException
+
+
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a + source array, starting at a given offset +

+

+
Parameters:
elementClass - The class of the elements to be constructed
source - The source SingleDimensionalStructuredArray to copy from
sourceOffset - The beginning index in the source from which to start copying
keepInternalCachingThreadSafe - Control whether or not internal caching is kept thread-safe +
Throws: +
java.lang.NoSuchMethodException - NoSuchMethodException if a copy constructor is not found in element class
+
+ + + + + + + + +
+Method Detail
+ +

+getForIndexes

+
+public ConstructorAndArgs<T> getForIndexes(long[] indexes)
+                                    throws java.lang.NoSuchMethodException
+
+
Get a ConstructorAndArgs instance to be used in constructing a given element index in + a SingleDimensionalStructuredArray. (supports only 1 dimensional array copies). . +

+

+
Overrides:
getForIndexes in class ConstructorAndArgsLocator<T>
+
+
+
Parameters:
indexes - The index of the element to be constructed in the target array (supports only 1 dimensional copies) +
Returns:
ConstructorAndArgs instance to used in element construction +
Throws: +
java.lang.NoSuchMethodException - if expected constructor is not found in element class
+
+
+
+ +

+recycle

+
+public void recycle(ConstructorAndArgs constructorAndArgs)
+
+
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired). This is [very] + useful for avoiding a re-allocation of a new ConstructorAndArgs and an associated args array for + getForIndex(long) invocation in cases such as this (where the returned ConstructorAndArgs + is not constant across indices). + Recycling is optional, and is not guaranteed to occur. +

+

+
Overrides:
recycle in class ConstructorAndArgsLocator<T>
+
+
+
Parameters:
constructorAndArgs - the ConstructorAndArgs instance to recycle
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/SingleDimensionalStructuredArray.StructureIterator.html b/JavaDoc/org/ObjectLayout/SingleDimensionalStructuredArray.StructureIterator.html new file mode 100644 index 0000000..74505ab --- /dev/null +++ b/JavaDoc/org/ObjectLayout/SingleDimensionalStructuredArray.StructureIterator.html @@ -0,0 +1,337 @@ + + + + + + +SingleDimensionalStructuredArray.StructureIterator + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class SingleDimensionalStructuredArray.StructureIterator

+
+java.lang.Object
+  extended by org.ObjectLayout.SingleDimensionalStructuredArray.StructureIterator
+
+
+
All Implemented Interfaces:
java.util.Iterator<T>
+
+
+
Enclosing class:
SingleDimensionalStructuredArray<T>
+
+
+
+
public class SingleDimensionalStructuredArray.StructureIterator
extends java.lang.Object
implements java.util.Iterator<T>
+ + +

+Specialised Iterator with the ability to be reset() enabling reuse. +

+ +

+


+ +

+ + + + + + + + + + + +
+Constructor Summary
SingleDimensionalStructuredArray.StructureIterator() + +
+           
+  + + + + + + + + + + + + + + + + + + + + + + + +
+Method Summary
+ booleanhasNext() + +
+          
+ Tnext() + +
+          
+ voidremove() + +
+          Remove operation is not supported on SingleDimensionalStructuredArrays.
+ voidreset() + +
+          Reset to the beginning of the collection enabling reuse of the iterator.
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+SingleDimensionalStructuredArray.StructureIterator

+
+public SingleDimensionalStructuredArray.StructureIterator()
+
+
+ + + + + + + + +
+Method Detail
+ +

+hasNext

+
+public boolean hasNext()
+
+
+

+

+
Specified by:
hasNext in interface java.util.Iterator<T>
+
+
+
+
+
+
+ +

+next

+
+public T next()
+
+
+

+

+
Specified by:
next in interface java.util.Iterator<T>
+
+
+
+
+
+
+ +

+remove

+
+public void remove()
+
+
Remove operation is not supported on SingleDimensionalStructuredArrays. +

+

+
Specified by:
remove in interface java.util.Iterator<T>
+
+
+ +
Throws: +
java.lang.UnsupportedOperationException - if called.
+
+
+
+ +

+reset

+
+public void reset()
+
+
Reset to the beginning of the collection enabling reuse of the iterator. +

+

+
+
+
+
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/SingleDimensionalStructuredArray.html b/JavaDoc/org/ObjectLayout/SingleDimensionalStructuredArray.html new file mode 100644 index 0000000..83d9aa5 --- /dev/null +++ b/JavaDoc/org/ObjectLayout/SingleDimensionalStructuredArray.html @@ -0,0 +1,691 @@ + + + + + + +SingleDimensionalStructuredArray + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+ +org.ObjectLayout +
+Class SingleDimensionalStructuredArray<T>

+
+java.lang.Object
+  extended by org.ObjectLayout.SingleDimensionalStructuredArray<T>
+
+
+
Type Parameters:
T - type of the element occupying each array slot.
+
+
All Implemented Interfaces:
java.lang.Iterable<T>
+
+
+
+
public final class SingleDimensionalStructuredArray<T>
extends java.lang.Object
implements java.lang.Iterable<T>
+ + +

+An array of (potentially) mutable but non-replaceable objects. +

+ A structured array contains array element objects of a fixed (at creation time, per array instance) class, + and can support elements of any class that provides public constructors. The elements in a SingleDimensionalStructuredArray + are all allocated and constructed at array creation time, and individual elements cannot be removed or + replaced after array creation. Array elements can be accessed using an index-based accessor methods in + the form of get(int)() (for int indices) or getL(long)() + (for long indices). Individual element contents can then be accessed and manipulated using any and all + operations supported by the member element's class. +

+ While simple creation of default-constructed elements and fixed constructor parameters are available through + the newInstance factory methods, supporting arbitrary member types requires a wider range of construction + options. The ConstructorAndArgsLocator API provides for array creation with arbitrary, user-supplied + constructors and arguments, either of which can take the element index into account. +

+ SingleDimensionalStructuredArray is designed with semantics specifically restricted to be consistent with layouts of an + array of structures in C-like languages. While fully functional on all JVM implementation (of Java SE 5 + and above), the semantics are such that a JVM may transparently optimise the implementation to provide a + compact contiguous layout that facilitates consistent stride based memory access and dead-reckoning + (as opposed to de-referenced) access to elements +

+ Note: At least for some JVM implementations, get(int)() access may be faster than + getL(long)() access. +

+ +

+


+ +

+ + + + + + + + + + + +
+Nested Class Summary
+ classSingleDimensionalStructuredArray.StructureIterator + +
+          Specialised Iterator with the ability to be SingleDimensionalStructuredArray.StructureIterator.reset() enabling reuse.
+  + + + + + + + + + + +
+Constructor Summary
SingleDimensionalStructuredArray(ConstructorAndArgsLocator<T> constructorAndArgsLocator, + long length, + long[] containingIndexes) + +
+           
+  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+Method Summary
+static + + + + +
+<T> SingleDimensionalStructuredArray<T>
+
copyInstance(SingleDimensionalStructuredArray<T> source) + +
+          Copy an array of elements to a newly created array.
+static + + + + +
+<T> SingleDimensionalStructuredArray<T>
+
copyInstance(SingleDimensionalStructuredArray<T> source, + long sourceOffset, + long count) + +
+          Copy a range from an array of elements to a newly created array.
+ Tget(int index) + +
+          Get a reference to an element in the array, using an int index.
+ java.lang.Class<T>getElementClass() + +
+          Get the Class of elements stored in the array.
+ TgetL(long index) + +
+          Get a reference to an element in the array, using a long index.
+ longgetLength() + +
+          Get the length (number of elements) of the array.
+ SingleDimensionalStructuredArray.StructureIteratoriterator() + +
+          
+static + + + + +
+<T> SingleDimensionalStructuredArray<T>
+
newInstance(java.lang.Class<T> elementClass, + long length) + +
+          Create an array of length elements, each containing an element object of + type elementClass.
+static + + + + +
+<T> SingleDimensionalStructuredArray<T>
+
newInstance(java.lang.Class<T> elementClass, + long length, + java.lang.Class[] initArgTypes, + java.lang.Object... initArgs) + +
+          Create an array of length elements, each containing an element object of + type elementClass.
+static + + + + +
+<T> SingleDimensionalStructuredArray<T>
+
newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator, + long length) + +
+          Create an array of length elements, each containing an element object of + type elementClass.
+static voidshallowCopy(SingleDimensionalStructuredArray src, + long srcOffset, + SingleDimensionalStructuredArray dst, + long dstOffset, + long count) + +
+          Shallow copy a region of element object contents from one array to the other.
+static voidshallowCopy(SingleDimensionalStructuredArray src, + long srcOffset, + SingleDimensionalStructuredArray dst, + long dstOffset, + long count, + boolean allowFinalFieldOverwrite) + +
+          Shallow copy a region of element object contents from one array to the other.
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+SingleDimensionalStructuredArray

+
+public SingleDimensionalStructuredArray(ConstructorAndArgsLocator<T> constructorAndArgsLocator,
+                                        long length,
+                                        long[] containingIndexes)
+                                 throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+ + + + + + + + +
+Method Detail
+ +

+newInstance

+
+public static <T> SingleDimensionalStructuredArray<T> newInstance(java.lang.Class<T> elementClass,
+                                                                  long length)
+                                                       throws java.lang.NoSuchMethodException
+
+
Create an array of length elements, each containing an element object of + type elementClass. Using the elementClass's default constructor. +

+

+
+
+
+
Parameters:
length - of the array to create.
elementClass - of each element in the array +
Throws: +
java.lang.NoSuchMethodException - if the element class does not have a public default constructor
+
+
+
+ +

+newInstance

+
+public static <T> SingleDimensionalStructuredArray<T> newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator,
+                                                                  long length)
+                                                       throws java.lang.NoSuchMethodException
+
+
Create an array of length elements, each containing an element object of + type elementClass. Use constructor and arguments supplied (on a potentially + per element index basis) by the specified constructorAndArgsLocator to construct and initialize + each element. +

+

+
+
+
+
Parameters:
length - of the array to create.
constructorAndArgsLocator - produces element constructors [potentially] on a per element basis. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not not support a supplied constructor
+
+
+
+ +

+newInstance

+
+public static <T> SingleDimensionalStructuredArray<T> newInstance(java.lang.Class<T> elementClass,
+                                                                  long length,
+                                                                  java.lang.Class[] initArgTypes,
+                                                                  java.lang.Object... initArgs)
+                                                       throws java.lang.NoSuchMethodException
+
+
Create an array of length elements, each containing an element object of + type elementClass. Use a fixed (same for all elements) constructor identified by the argument + classes specified in initArgs to construct and initialize each element, passing the remaining + arguments to that constructor. +

+

+
+
+
+
Parameters:
length - of the array to create.
elementClass - of each element in the array
initArgTypes - for selecting the constructor to call for initialising each structure object.
initArgs - to be passed to a constructor for initialising each structure object. +
Throws: +
java.lang.IllegalArgumentException - if initArgTypes and constructor arguments do not match in length +
java.lang.NoSuchMethodException - if initArgTypes does not match a public constructor signature in elementClass
+
+
+
+ +

+copyInstance

+
+public static <T> SingleDimensionalStructuredArray<T> copyInstance(SingleDimensionalStructuredArray<T> source)
+                                                        throws java.lang.NoSuchMethodException
+
+
Copy an array of elements to a newly created array. Copying of individual elements is done by using + the elementClass copy constructor to construct the individual member elements of the new + array based on the corresponding elements of the source array. +

+

+
+
+
+
Parameters:
source - The array to duplicate. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not have a public copy constructor.
+
+
+
+ +

+copyInstance

+
+public static <T> SingleDimensionalStructuredArray<T> copyInstance(SingleDimensionalStructuredArray<T> source,
+                                                                   long sourceOffset,
+                                                                   long count)
+                                                        throws java.lang.NoSuchMethodException
+
+
Copy a range from an array of elements to a newly created array. Copying of individual elements is done + by using the elementClass copy constructor to construct the individual member elements of + the new array based on the corresponding elements of the source array. +

+

+
+
+
+
Parameters:
source - The array to duplicate.
sourceOffset - offset index in source where the region to be copied begins.
count - of elements to copy. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not have a public copy constructor.
+
+
+
+ +

+getLength

+
+public long getLength()
+
+
Get the length (number of elements) of the array. +

+

+
+
+
+ +
Returns:
the number of elements in the array.
+
+
+
+ +

+getL

+
+public T getL(long index)
+
+
Get a reference to an element in the array, using a long index. +

+

+
+
+
+
Parameters:
index - of the element to retrieve. +
Returns:
a reference to the indexed element.
+
+
+
+ +

+get

+
+public T get(int index)
+
+
Get a reference to an element in the array, using an int index. +

+

+
+
+
+
Parameters:
index - of the element to retrieve. +
Returns:
a reference to the indexed element.
+
+
+
+ +

+getElementClass

+
+public java.lang.Class<T> getElementClass()
+
+
Get the Class of elements stored in the array. +

+

+
+
+
+ +
Returns:
the Class of elements stored in the array.
+
+
+
+ +

+shallowCopy

+
+public static void shallowCopy(SingleDimensionalStructuredArray src,
+                               long srcOffset,
+                               SingleDimensionalStructuredArray dst,
+                               long dstOffset,
+                               long count)
+
+
Shallow copy a region of element object contents from one array to the other. +

+ shallowCopy will copy all fields from each of the source elements to the corresponding fields in each + of the corresponding destination elements. If the same array is both the src and dst then the copy will + happen as if a temporary intermediate array was used. +

+

+
+
+
+
Parameters:
src - array to copy.
srcOffset - offset index in src where the region begins.
dst - array into which the copy should occur.
dstOffset - offset index in the dst where the region begins.
count - of structure elements to copy. +
Throws: +
java.lang.IllegalStateException - if final fields are discovered. +
java.lang.ArrayStoreException - if the element classes in src and dst are not identical.
+
+
+
+ +

+shallowCopy

+
+public static void shallowCopy(SingleDimensionalStructuredArray src,
+                               long srcOffset,
+                               SingleDimensionalStructuredArray dst,
+                               long dstOffset,
+                               long count,
+                               boolean allowFinalFieldOverwrite)
+
+
Shallow copy a region of element object contents from one array to the other. +

+ shallowCopy will copy all fields from each of the source elements to the corresponding fields in each + of the corresponding destination elements. If the same array is both the src and dst then the copy will + happen as if a temporary intermediate array was used. + + If allowFinalFieldOverwrite is specified as true, even final fields will be copied. +

+

+
+
+
+
Parameters:
src - array to copy.
srcOffset - offset index in src where the region begins.
dst - array into which the copy should occur.
dstOffset - offset index in the dst where the region begins.
count - of structure elements to copy.
allowFinalFieldOverwrite - allow final fields to be overwritten during a copy operation. +
Throws: +
java.lang.IllegalStateException - if final fields are discovered and all allowFinalFieldOverwrite is not true. +
java.lang.ArrayStoreException - if the element classes in src and dst are not identical.
+
+
+
+ +

+iterator

+
+public SingleDimensionalStructuredArray.StructureIterator iterator()
+
+
+

+

+
Specified by:
iterator in interface java.lang.Iterable<T>
+
+
+
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html b/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html index 0b14c11..2e2e834 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html +++ b/JavaDoc/org/ObjectLayout/StructuredArray.StructureIterator.html @@ -2,12 +2,12 @@ - + StructuredArray.StructureIterator - + @@ -54,7 +54,7 @@  PREV CLASS  - NEXT CLASS + NEXT CLASS
FRAMES    NO FRAMES   @@ -139,6 +139,14 @@

+ long[] +getCursors() + +
+            + + +  boolean hasNext() @@ -273,6 +281,20 @@

+
+ +

+getCursors

+
+public long[] getCursors()
+
+
+
+
+
+
+
+

@@ -303,7 +325,7 @@

 PREV CLASS  - NEXT CLASS + NEXT CLASS FRAMES    NO FRAMES   diff --git a/JavaDoc/org/ObjectLayout/StructuredArray.html b/JavaDoc/org/ObjectLayout/StructuredArray.html index f87d004..322fb1c 100644 --- a/JavaDoc/org/ObjectLayout/StructuredArray.html +++ b/JavaDoc/org/ObjectLayout/StructuredArray.html @@ -2,12 +2,12 @@ - + StructuredArray - + @@ -53,7 +53,7 @@ PREV CLASS  + PREV CLASS   NEXT CLASS FRAMES   @@ -74,9 +74,9 @@ - SUMMARY: NESTED | FIELD | CONSTR | METHOD + SUMMARY: NESTED | FIELD | CONSTR | METHOD -DETAIL: FIELD | CONSTR | METHOD +DETAIL: FIELD | CONSTR | METHOD @@ -110,8 +110,8 @@

and can support elements of any class that provides public constructors. The elements in a StructuredArray are all allocated and constructed at array creation time, and individual elements cannot be removed or replaced after array creation. Array elements can be accessed using an index-based accessor methods in - the form of get(int)() (for int indices) or getL(long)() - (for long indices). Individual element contents can then be accessed and manipulated using any and all + the form of get(long[])() using either int or + long indices. Individual element contents can then be accessed and manipulated using any and all operations supported by the member element's class.

While simple creation of default-constructed elements and fixed constructor parameters are available through @@ -124,9 +124,6 @@

and above), the semantics are such that a JVM may transparently optimise the implementation to provide a compact contiguous layout that facilitates consistent stride based memory access and dead-reckoning (as opposed to de-referenced) access to elements -

- Note: At least for some JVM implementations, get(int)() access may be faster than - getL(long)() access.

@@ -151,24 +148,6 @@

  - - - - - - - - - - -
-Constructor Summary
StructuredArray(ConstructorAndArgsLocator<T> constructorAndArgsLocator, - long length, - long[] containingIndexes) - -
-           
@@ -202,9 +181,26 @@

-copyInstance(StructuredArray<T> source, - long sourceOffset, - long count) +copyInstance(StructuredArray<T> source, + long[] sourceOffsets, + java.lang.Long... counts) + +
+          Copy a range from an array of elements to a newly created array. + + + +static + + + + +
+<T> StructuredArray<T>
+
+copyInstance(StructuredArray<T> source, + long[] sourceOffsets, + long[] counts)
          Copy a range from an array of elements to a newly created array. @@ -219,22 +215,123 @@

- java.lang.Class<T> -getElementClass() + T +get(java.lang.Integer... indexes)
-          Get the Class of elements stored in the array. +          Get a reference to an element in the array, using a varargs int indexes. + + + + T +get(int index0, + int index1) + +
+          Get a reference to an element in the array, using 2 int indexes. + + + + T +get(int index0, + int index1, + int index2) + +
+          Get a reference to an element in the array, using 3 int indexes. + + + + T +get(int index0, + int index1, + int index2, + int index3) + +
+          Get a reference to an element in the array, using 4 int indexes.  T -getL(long index) +get(java.lang.Long... indexes) + +
+          Get a reference to an element in the array, using a varargs long indexes. + + + + T +get(long index)
          Get a reference to an element in the array, using a long index. + T +get(long[] indexes) + +
+          Get a reference to an element in the array, using a long[] index array. + + + + T +get(long[] indexes, + int indexOffset) + +
+          Get a reference to an element in the array, using long indexes supplied in an array. + + + + T +get(long index0, + long index1) + +
+          Get a reference to an element in the array, using 2 long indexes. + + + + T +get(long index0, + long index1, + long index2) + +
+          Get a reference to an element in the array, using 3 long indexes. + + + + T +get(long index0, + long index1, + long index2, + long index3) + +
+          Get a reference to an element in the array, using 4 long indexes. + + + + int +getDimensionCount() + +
+          Get the number of dimensions of the array. + + + + java.lang.Class<T> +getElementClass() + +
+          Get the Class of elements stored in the array. + + +  long getLength() @@ -243,6 +340,38 @@

+ long[] +getLengths() + +
+          Get the lengths (number of elements per dimension) of the array. + + + + StructuredArray<T> +getSubArray(int index) + +
+          Get a reference to a StructuredArray element in this array, using a int index. + + + + StructuredArray<T> +getSubArray(long index) + +
+          Get a reference to a StructuredArray element in this array, using a long index. + + + + long +getTotalElementCount() + +
+          Get the total number of elements (in all dimensions combined) in this multi-dimensional array. + + +  StructuredArray.StructureIterator iterator() @@ -259,6 +388,22 @@

+newInstance(java.lang.Class<T> elementClass, + java.lang.Long... lengths) + +
+          Create a multi dimensional array of elements. + + + +static + + + + +
+<T> StructuredArray<T>
+
newInstance(java.lang.Class<T> elementClass, long length) @@ -276,6 +421,40 @@

+newInstance(java.lang.Class<T> elementClass, + long[] lengths) + +
+          Create a multi dimensional array of elements. + + + +static + + + + +
+<T> StructuredArray<T>
+
+newInstance(java.lang.Class<T> elementClass, + long[] lengths, + java.lang.Class[] initArgTypes, + java.lang.Object... initArgs) + +
+          Create a multi dimensional array of elements. + + + +static + + + + +
+<T> StructuredArray<T>
+
newInstance(java.lang.Class<T> elementClass, long length, java.lang.Class[] initArgTypes, @@ -295,6 +474,22 @@

+newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator, + java.lang.Long... lengths) + +
+          Create a multi dimensional array of elements. + + + +static + + + + +
+<T> StructuredArray<T>
+
newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator, long length) @@ -304,6 +499,22 @@

+static + + + + +
+<T> StructuredArray<T>
+
+newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator, + long[] lengths) + +
+          Create a multi dimensional array of elements. + + + static void shallowCopy(StructuredArray src, long srcOffset, @@ -340,30 +551,6 @@

 

- - - - - - - -
-Constructor Detail
- -

-StructuredArray

-
-public StructuredArray(ConstructorAndArgsLocator<T> constructorAndArgsLocator,
-                       long length,
-                       long[] containingIndexes)
-                throws java.lang.NoSuchMethodException
-
-
- -
Throws: -
java.lang.NoSuchMethodException
-
- @@ -444,104 +631,568 @@


-

-copyInstance

+

+newInstance

-public static <T> StructuredArray<T> copyInstance(StructuredArray<T> source)
-                                       throws java.lang.NoSuchMethodException
+public static <T> StructuredArray<T> newInstance(java.lang.Class<T> elementClass, + java.lang.Long... lengths) + throws java.lang.NoSuchMethodException
-
Copy an array of elements to a newly created array. Copying of individual elements is done by using - the elementClass copy constructor to construct the individual member elements of the new - array based on the corresponding elements of the source array. +
Create a multi dimensional array of elements. Each dimension of the array will be of a length designated + in the lengths parameters passed. Each element of the array will consist of + an object of type elementClass. Elements will be constructed Using the + elementClass's default constructor.

-
Parameters:
source - The array to duplicate. +
Parameters:
elementClass - of each element in the array
lengths - of the array dimensions to create.
Throws: -
java.lang.NoSuchMethodException - if the element class does not have a public copy constructor.
+
java.lang.NoSuchMethodException - if the element class does not not support a supplied constructor


-

-copyInstance

+

+newInstance

-public static <T> StructuredArray<T> copyInstance(StructuredArray<T> source,
-                                                  long sourceOffset,
-                                                  long count)
-                                       throws java.lang.NoSuchMethodException
+public static <T> StructuredArray<T> newInstance(java.lang.Class<T> elementClass, + long[] lengths) + throws java.lang.NoSuchMethodException
-
Copy a range from an array of elements to a newly created array. Copying of individual elements is done - by using the elementClass copy constructor to construct the individual member elements of - the new array based on the corresponding elements of the source array. +
Create a multi dimensional array of elements. Each dimension of the array will be of a length designated + in the lengths[] passed. Each element of the array will consist of + an object of type elementClass. Elements will be constructed Using the + elementClass's default constructor.

-
Parameters:
source - The array to duplicate.
sourceOffset - offset index in source where the region to be copied begins.
count - of elements to copy. +
Parameters:
elementClass - of each element in the array
lengths - of the array dimensions to create.
Throws: -
java.lang.NoSuchMethodException - if the element class does not have a public copy constructor.
+
java.lang.NoSuchMethodException - if the element class does not not support a supplied constructor

-

-getLength

+

+newInstance

-public long getLength()
+public static <T> StructuredArray<T> newInstance(java.lang.Class<T> elementClass, + long[] lengths, + java.lang.Class[] initArgTypes, + java.lang.Object... initArgs) + throws java.lang.NoSuchMethodException
-
Get the length (number of elements) of the array. +
Create a multi dimensional array of elements. Each dimension of the array will be of a length designated + in the lengths[] passed. Each element of the array will consist of + an object of type elementClass. Elements will be constructed using a fixed (same for all elements) + constructor identified by the argument classes specified in initArgTypes to construct and + initialize each element, passing the initArgs arguments to that constructor.

- -
Returns:
the number of elements in the array.
+
Parameters:
elementClass - of each element in the array
lengths - of the array dimensions to create.
initArgTypes - for selecting the constructor to call for initialising each structure object.
initArgs - to be passed to a constructor for initialising each structure object. +
Throws: +
java.lang.IllegalArgumentException - if initArgTypes and constructor arguments do not match in length +
java.lang.NoSuchMethodException - if initArgTypes does not match a public constructor signature in elementClass

-

-getL

+

+newInstance

-public T getL(long index)
+public static <T> StructuredArray<T> newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator, + java.lang.Long... lengths) + throws java.lang.NoSuchMethodException
-
Get a reference to an element in the array, using a long index. +
Create a multi dimensional array of elements. Each dimension of the array will be of a length designated + in the lengths arguments passed. Each element of the array will consist of + an object of type elementClass. Elements will be constructed using the constructor and arguments + supplied (on a potentially per element index basis) by the specified constructorAndArgsLocator. + to construct and initialize each element.

-
Parameters:
index - of the element to retrieve. -
Returns:
a reference to the indexed element.
+
Parameters:
constructorAndArgsLocator - produces element constructors [potentially] on a per element basis.
lengths - of the array dimensions to create. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not not support a supplied constructor

-

-get

+

+newInstance

-public T get(int index)
+public static <T> StructuredArray<T> newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator, + long[] lengths) + throws java.lang.NoSuchMethodException
-
Get a reference to an element in the array, using an int index. +
Create a multi dimensional array of elements. Each dimension of the array will be of a length designated + in the lengths[] passed. Each element of the array will consist of + an object of type elementClass. Elements will be constructed using the constructor and arguments + supplied (on a potentially per element index basis) by the specified constructorAndArgsLocator. + to construct and initialize each element.

-
Parameters:
index - of the element to retrieve. -
Returns:
a reference to the indexed element.
+
Parameters:
constructorAndArgsLocator - produces element constructors [potentially] on a per element basis.
lengths - of the array dimensions to create. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not not support a supplied constructor

-

-getElementClass

-
+

+copyInstance

+
+public static <T> StructuredArray<T> copyInstance(StructuredArray<T> source)
+                                       throws java.lang.NoSuchMethodException
+
+
Copy an array of elements to a newly created array. Copying of individual elements is done by using + the elementClass copy constructor to construct the individual member elements of the new + array based on the corresponding elements of the source array. +

+

+
+
+
+
Parameters:
source - The array to duplicate. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not have a public copy constructor.
+
+
+
+ +

+copyInstance

+
+public static <T> StructuredArray<T> copyInstance(StructuredArray<T> source,
+                                                  long[] sourceOffsets,
+                                                  java.lang.Long... counts)
+                                       throws java.lang.NoSuchMethodException
+
+
Copy a range from an array of elements to a newly created array. Copying of individual elements is done + by using the elementClass copy constructor to construct the individual member elements of + the new array based on the corresponding elements of the source array. +

+

+
+
+
+
Parameters:
source - The array to copy from.
sourceOffsets - offset indexes for each dimension, indicating where the source region to be copied begins.
counts - the number of elements in each dimension to copy. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not have a public copy constructor.
+
+
+
+ +

+copyInstance

+
+public static <T> StructuredArray<T> copyInstance(StructuredArray<T> source,
+                                                  long[] sourceOffsets,
+                                                  long[] counts)
+                                       throws java.lang.NoSuchMethodException
+
+
Copy a range from an array of elements to a newly created array. Copying of individual elements is done + by using the elementClass copy constructor to construct the individual member elements of + the new array based on the corresponding elements of the source array. +

+

+
+
+
+
Parameters:
source - The array to copy from.
sourceOffsets - offset indexes for each dimension, indicating where the source region to be copied begins.
counts - the number of elements in each dimension to copy. +
Throws: +
java.lang.NoSuchMethodException - if the element class does not have a public copy constructor.
+
+
+
+ +

+getDimensionCount

+
+public int getDimensionCount()
+
+
Get the number of dimensions of the array. +

+

+
+
+
+ +
Returns:
the number of dimensions of the array.
+
+
+
+ +

+getLengths

+
+public long[] getLengths()
+
+
Get the lengths (number of elements per dimension) of the array. +

+

+
+
+
+ +
Returns:
the number of elements in each dimension in the array.
+
+
+
+ +

+getTotalElementCount

+
+public long getTotalElementCount()
+
+
Get the total number of elements (in all dimensions combined) in this multi-dimensional array. +

+

+
+
+
+ +
Returns:
the total number of elements (in all dimensions combined) in the array.
+
+
+
+ +

+getLength

+
+public long getLength()
+
+
Get the length (number of elements) of the array. +

+

+
+
+
+ +
Returns:
the number of elements in the array.
+
+
+
+ +

+get

+
+public T get(long[] indexes)
+      throws java.lang.IllegalArgumentException
+
+
Get a reference to an element in the array, using a long[] index array. +

+

+
+
+
+
Parameters:
indexes - The indexes (at each dimension) of the element to retrieve. +
Returns:
a reference to the indexed element. +
Throws: +
java.lang.IllegalArgumentException - if number of indexes does not match number of dimensions in the array
+
+
+
+ +

+get

+
+public T get(long[] indexes,
+             int indexOffset)
+      throws java.lang.IllegalArgumentException
+
+
Get a reference to an element in the array, using long indexes supplied in an array. + indexOffset indicates the starting point in the array at which the first index should be found. + This form is useful when passing index arrays through multiple levels to avoid construction of + temporary varargs containers or construction of new shorter index arrays. +

+

+
+
+
+
Parameters:
indexes - The indexes (at each dimension) of the element to retrieve.
indexOffset - The beginning offset in the indexes array related to this arrays contents. +
Returns:
a reference to the indexed element. +
Throws: +
java.lang.IllegalArgumentException - if number of relevant indexes does not match number of dimensions in the array
+
+
+
+ +

+get

+
+public T get(java.lang.Long... indexes)
+      throws java.lang.IllegalArgumentException
+
+
Get a reference to an element in the array, using a varargs long indexes. +

+

+
+
+
+
Parameters:
indexes - The indexes (at each dimension) of the element to retrieve. +
Returns:
a reference to the indexed element. +
Throws: +
java.lang.IllegalArgumentException - if number of indexes does not match number of dimensions in the array
+
+
+
+ +

+get

+
+public T get(java.lang.Integer... indexes)
+      throws java.lang.IllegalArgumentException
+
+
Get a reference to an element in the array, using a varargs int indexes. +

+

+
+
+
+
Parameters:
indexes - The indexes (at each dimension) of the element to retrieve. +
Returns:
a reference to the indexed element. +
Throws: +
java.lang.IllegalArgumentException - if number of indexes does not match number of dimensions in the array
+
+
+
+ +

+get

+
+public T get(long index)
+      throws java.lang.IllegalArgumentException
+
+
Get a reference to an element in the array, using a long index. +

+

+
+
+
+
Parameters:
index - of the element to retrieve. +
Returns:
a reference to the indexed element. +
Throws: +
java.lang.IllegalArgumentException - if array has more than one dimensions
+
+
+
+ +

+get

+
+public T get(long index0,
+             long index1)
+      throws java.lang.IllegalArgumentException
+
+
Get a reference to an element in the array, using 2 long indexes. +

+

+
+
+
+
Parameters:
index0 - the first index (in the first array dimension) of the element to retrieve
index1 - the second index (in the second array dimension) of the element to retrieve +
Returns:
the element at [index0, index1] +
Throws: +
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array +
java.lang.IllegalArgumentException
+
+
+
+ +

+get

+
+public T get(long index0,
+             long index1,
+             long index2)
+      throws java.lang.IllegalArgumentException
+
+
Get a reference to an element in the array, using 3 long indexes. +

+

+
+
+
+
Parameters:
index0 - the first index (in the first array dimension) of the element to retrieve
index1 - the second index (in the second array dimension) of the element to retrieve
index2 - the third index (in the third array dimension) of the element to retrieve +
Returns:
the element at [index0, index1, index2] +
Throws: +
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array +
java.lang.IllegalArgumentException
+
+
+
+ +

+get

+
+public T get(long index0,
+             long index1,
+             long index2,
+             long index3)
+      throws java.lang.IllegalArgumentException
+
+
Get a reference to an element in the array, using 4 long indexes. +

+

+
+
+
+
Parameters:
index0 - the first index (in the first array dimension) of the element to retrieve
index1 - the second index (in the second array dimension) of the element to retrieve
index2 - the third index (in the third array dimension) of the element to retrieve
index3 - the fourth index (in the fourth array dimension) of the element to retrieve +
Returns:
the element at [index0, index1, index2, index3] +
Throws: +
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array +
java.lang.IllegalArgumentException
+
+
+
+ +

+get

+
+public T get(int index)
+      throws java.lang.IllegalArgumentException
+
+
Get a reference to an element in the array, using an int index. +

+

+
+
+
+
Parameters:
index - of the element to retrieve. +
Returns:
a reference to the indexed element. +
Throws: +
java.lang.NullPointerException - if array has more than one dimensions +
java.lang.IllegalArgumentException
+
+
+
+ +

+get

+
+public T get(int index0,
+             int index1)
+      throws java.lang.IllegalArgumentException
+
+
Get a reference to an element in the array, using 2 int indexes. +

+

+
+
+
+
Parameters:
index0 - the first index (in the first array dimension) of the element to retrieve
index1 - the second index (in the second array dimension) of the element to retrieve +
Returns:
the element at [index0, index1] +
Throws: +
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array +
java.lang.IllegalArgumentException
+
+
+
+ +

+get

+
+public T get(int index0,
+             int index1,
+             int index2)
+      throws java.lang.IllegalArgumentException
+
+
Get a reference to an element in the array, using 3 int indexes. +

+

+
+
+
+
Parameters:
index0 - the first index (in the first array dimension) of the element to retrieve
index1 - the second index (in the second array dimension) of the element to retrieve
index2 - the third index (in the third array dimension) of the element to retrieve +
Returns:
the element at [index0, index1, index2] +
Throws: +
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array +
java.lang.IllegalArgumentException
+
+
+
+ +

+get

+
+public T get(int index0,
+             int index1,
+             int index2,
+             int index3)
+      throws java.lang.IllegalArgumentException
+
+
Get a reference to an element in the array, using 4 int indexes. +

+

+
+
+
+
Parameters:
index0 - the first index (in the first array dimension) of the element to retrieve
index1 - the second index (in the second array dimension) of the element to retrieve
index2 - the third index (in the third array dimension) of the element to retrieve
index3 - the fourth index (in the fourth array dimension) of the element to retrieve +
Returns:
the element at [index0, index1, index2, index3] +
Throws: +
java.lang.NullPointerException - if number of indexes does not match number of dimensions in the array +
java.lang.IllegalArgumentException
+
+
+
+ +

+getSubArray

+
+public StructuredArray<T> getSubArray(long index)
+                               throws java.lang.IllegalArgumentException
+
+
Get a reference to a StructuredArray element in this array, using a long index. +

+

+
+
+
+
Parameters:
index - (in this array's first dimension) of the StructuredArray to retrieve +
Returns:
a reference to the StructuredArray located at [index] in the first dimension of this array +
Throws: +
java.lang.IllegalArgumentException - if array has less than two dimensions
+
+
+
+ +

+getSubArray

+
+public StructuredArray<T> getSubArray(int index)
+                               throws java.lang.IllegalArgumentException
+
+
Get a reference to a StructuredArray element in this array, using a int index. +

+

+
+
+
+
Parameters:
index - (in this array's first dimension) of the StructuredArray to retrieve +
Returns:
a reference to the StructuredArray located at [index] in the first dimension of this array +
Throws: +
java.lang.IllegalArgumentException - if array has less than two dimensions
+
+
+
+ +

+getElementClass

+
 public java.lang.Class<T> getElementClass()
Get the Class of elements stored in the array. @@ -556,6 +1207,22 @@


+

+iterator

+
+public StructuredArray.StructureIterator iterator()
+
+
+

+

+
Specified by:
iterator in interface java.lang.Iterable<T>
+
+
+
+
+
+
+

shallowCopy

@@ -607,26 +1274,11 @@ 

Parameters:
src - array to copy.
srcOffset - offset index in src where the region begins.
dst - array into which the copy should occur.
dstOffset - offset index in the dst where the region begins.
count - of structure elements to copy.
allowFinalFieldOverwrite - allow final fields to be overwritten during a copy operation.
Throws: -
java.lang.IllegalStateException - if final fields are discovered and all allowFinalFieldOverwrite is not true. +
java.lang.IllegalArgumentException - if source or destination arrays have more than one dimension, or + if final fields are discovered and all allowFinalFieldOverwrite is not true.
java.lang.ArrayStoreException - if the element classes in src and dst are not identical.
-
- -

-iterator

-
-public StructuredArray.StructureIterator iterator()
-
-
-

-

-
Specified by:
iterator in interface java.lang.Iterable<T>
-
-
-
-
-

@@ -656,7 +1308,7 @@

PREV CLASS  + PREV CLASS   NEXT CLASS FRAMES   @@ -677,9 +1329,9 @@

- SUMMARY: NESTED | FIELD | CONSTR | METHOD + SUMMARY: NESTED | FIELD | CONSTR | METHOD -DETAIL: FIELD | CONSTR | METHOD +DETAIL: FIELD | CONSTR | METHOD diff --git a/JavaDoc/org/ObjectLayout/package-frame.html b/JavaDoc/org/ObjectLayout/package-frame.html index 48ac790..301d24f 100644 --- a/JavaDoc/org/ObjectLayout/package-frame.html +++ b/JavaDoc/org/ObjectLayout/package-frame.html @@ -2,12 +2,12 @@ - + org.ObjectLayout - + @@ -37,11 +37,11 @@
MultiDimensionalStructuredArray
-StructuredArray +SingleDimensionalCopyConstructorAndArgsLocator
-UnifiedCopyConstructorAndArgsLocator +SingleDimensionalStructuredArray
-UnifiedStructuredArray +StructuredArray diff --git a/JavaDoc/org/ObjectLayout/package-summary.html b/JavaDoc/org/ObjectLayout/package-summary.html index 47c8422..4243f01 100644 --- a/JavaDoc/org/ObjectLayout/package-summary.html +++ b/JavaDoc/org/ObjectLayout/package-summary.html @@ -2,12 +2,12 @@ - + org.ObjectLayout - + @@ -126,16 +126,16 @@

An array of (potentially) mutable but non-replaceable objects. -StructuredArray<T> -An array of (potentially) mutable but non-replaceable objects. - - -UnifiedCopyConstructorAndArgsLocator<T> +SingleDimensionalCopyConstructorAndArgsLocator<T> Supports the construction of a new array's individual elements using a copy constructor to copy a source array's corresponding elements. -UnifiedStructuredArray<T> +SingleDimensionalStructuredArray<T> +An array of (potentially) mutable but non-replaceable objects. + + +StructuredArray<T> An array of (potentially) mutable but non-replaceable objects. diff --git a/JavaDoc/org/ObjectLayout/package-tree.html b/JavaDoc/org/ObjectLayout/package-tree.html index 6e24733..9f81857 100644 --- a/JavaDoc/org/ObjectLayout/package-tree.html +++ b/JavaDoc/org/ObjectLayout/package-tree.html @@ -2,12 +2,12 @@ - + org.ObjectLayout Class Hierarchy - + @@ -88,13 +88,13 @@


diff --git a/JavaDoc/overview-tree.html b/JavaDoc/overview-tree.html index b8ecdb1..10ee478 100644 --- a/JavaDoc/overview-tree.html +++ b/JavaDoc/overview-tree.html @@ -2,12 +2,12 @@ - + Class Hierarchy - + @@ -90,13 +90,13 @@


From 72907be06181869300976ab2fc3bf235cc5f58cb Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Sat, 29 Jun 2013 18:29:43 -0700 Subject: [PATCH 18/39] Updated JavaDoc --- JavaDoc/allclasses-frame.html | 22 +- JavaDoc/allclasses-noframe.html | 22 +- JavaDoc/constant-values.html | 4 +- JavaDoc/deprecated-list.html | 4 +- JavaDoc/help-doc.html | 4 +- JavaDoc/index-files/index-1.html | 18 +- JavaDoc/index-files/index-2.html | 51 +-- JavaDoc/index-files/index-3.html | 114 +++++- JavaDoc/index-files/index-4.html | 185 +-------- JavaDoc/index-files/index-5.html | 26 +- JavaDoc/index-files/index-6.html | 53 ++- JavaDoc/index-files/index-7.html | 34 +- JavaDoc/index-files/index-8.html | 93 ++--- JavaDoc/index-files/index-9.html | 47 ++- JavaDoc/index.html | 2 +- .../ArrayCtorAndArgsProvider.html | 372 ++++++++++++++++++ .../ObjectLayout/CopyCtorAndArgsProvider.html | 372 ++++++++++++++++++ JavaDoc/org/ObjectLayout/CtorAndArgs.html | 329 ++++++++++++++++ .../org/ObjectLayout/CtorAndArgsProvider.html | 327 +++++++++++++++ .../SingletonCtorAndArgsProvider.html | 333 ++++++++++++++++ .../StructuredArray.StructureIterator.html | 4 +- JavaDoc/org/ObjectLayout/StructuredArray.html | 84 ++-- JavaDoc/org/ObjectLayout/package-frame.html | 22 +- JavaDoc/org/ObjectLayout/package-summary.html | 42 +- JavaDoc/org/ObjectLayout/package-tree.html | 12 +- JavaDoc/overview-tree.html | 12 +- 26 files changed, 2073 insertions(+), 515 deletions(-) create mode 100644 JavaDoc/org/ObjectLayout/ArrayCtorAndArgsProvider.html create mode 100644 JavaDoc/org/ObjectLayout/CopyCtorAndArgsProvider.html create mode 100644 JavaDoc/org/ObjectLayout/CtorAndArgs.html create mode 100644 JavaDoc/org/ObjectLayout/CtorAndArgsProvider.html create mode 100644 JavaDoc/org/ObjectLayout/SingletonCtorAndArgsProvider.html diff --git a/JavaDoc/allclasses-frame.html b/JavaDoc/allclasses-frame.html index 45096ab..ca535a4 100644 --- a/JavaDoc/allclasses-frame.html +++ b/JavaDoc/allclasses-frame.html @@ -2,12 +2,12 @@ - + All Classes - + @@ -21,23 +21,15 @@ - -
ArrayConstructorAndArgsLocator +ArrayCtorAndArgsProvider
-ConstructorAndArgs +CopyCtorAndArgsProvider
-ConstructorAndArgsLocator +CtorAndArgs
-CopyConstructorAndArgsLocator +CtorAndArgsProvider
-FixedConstructorAndArgsLocator -
-MultiDimensionalCopyConstructorAndArgsLocator -
-MultiDimensionalStructuredArray -
-SingleDimensionalCopyConstructorAndArgsLocator -
-SingleDimensionalStructuredArray +SingletonCtorAndArgsProvider
StructuredArray
diff --git a/JavaDoc/allclasses-noframe.html b/JavaDoc/allclasses-noframe.html index 0a3077e..5dbb208 100644 --- a/JavaDoc/allclasses-noframe.html +++ b/JavaDoc/allclasses-noframe.html @@ -2,12 +2,12 @@ - + All Classes - + @@ -21,23 +21,15 @@ - + NEXT LETTER + NEXT LETTER - +          Get a reference to an element in the array, using a varargs int indices. - +          Get a reference to an element in the array, using a varargs long indices. - @@ -278,11 +278,11 @@

- +          Get a reference to an element in the array, using long indices supplied in an array.
ArrayConstructorAndArgsLocator +ArrayCtorAndArgsProvider
-ConstructorAndArgs +CopyCtorAndArgsProvider
-ConstructorAndArgsLocator +CtorAndArgs
-CopyConstructorAndArgsLocator +CtorAndArgsProvider
-FixedConstructorAndArgsLocator -
-MultiDimensionalCopyConstructorAndArgsLocator -
-MultiDimensionalStructuredArray -
-SingleDimensionalCopyConstructorAndArgsLocator -
-SingleDimensionalStructuredArray +SingletonCtorAndArgsProvider
StructuredArray
diff --git a/JavaDoc/constant-values.html b/JavaDoc/constant-values.html index 37d3455..2a23565 100644 --- a/JavaDoc/constant-values.html +++ b/JavaDoc/constant-values.html @@ -2,12 +2,12 @@ - + Constant Field Values - + diff --git a/JavaDoc/deprecated-list.html b/JavaDoc/deprecated-list.html index 2f66c69..34801a4 100644 --- a/JavaDoc/deprecated-list.html +++ b/JavaDoc/deprecated-list.html @@ -2,12 +2,12 @@ - + Deprecated List - + diff --git a/JavaDoc/help-doc.html b/JavaDoc/help-doc.html index a2722d5..79f6683 100644 --- a/JavaDoc/help-doc.html +++ b/JavaDoc/help-doc.html @@ -2,12 +2,12 @@ - + API Help - + diff --git a/JavaDoc/index-files/index-1.html b/JavaDoc/index-files/index-1.html index 78788ff..c24dd87 100644 --- a/JavaDoc/index-files/index-1.html +++ b/JavaDoc/index-files/index-1.html @@ -2,12 +2,12 @@ - + A-Index - + @@ -76,16 +76,16 @@ -A C F G H I M N O R S
+A C G H I N O R S

A

-
ArrayConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports the construction of a new array's individual elements using a copy constructor to copy a source - array's corresponding elements.
ArrayConstructorAndArgsLocator(Constructor<T>, Object[], int) - -Constructor for class org.ObjectLayout.ArrayConstructorAndArgsLocator +
ArrayCtorAndArgsProvider<T> - Class in org.ObjectLayout
Supports the construction of a new array's individual elements using a copy constructor to copy a source + array's corresponding elements.
ArrayCtorAndArgsProvider(Constructor<T>, Object[], int) - +Constructor for class org.ObjectLayout.ArrayCtorAndArgsProvider
Used to apply a fixed constructor with a given set of arguments to all elements. -
ArrayConstructorAndArgsLocator(Constructor<T>, Object[], int, boolean) - -Constructor for class org.ObjectLayout.ArrayConstructorAndArgsLocator +
ArrayCtorAndArgsProvider(Constructor<T>, Object[], int, boolean) - +Constructor for class org.ObjectLayout.ArrayCtorAndArgsProvider
Used to apply a fixed constructor with a given set of arguments to all elements.

@@ -139,7 +139,7 @@ -A C F G H I M N O R S
+A C G H I N O R S
diff --git a/JavaDoc/index-files/index-2.html b/JavaDoc/index-files/index-2.html index 80eec58..31464a6 100644 --- a/JavaDoc/index-files/index-2.html +++ b/JavaDoc/index-files/index-2.html @@ -2,12 +2,12 @@ - + C-Index - + @@ -76,45 +76,23 @@ -A C F G H I M N O R S
+A C G H I N O R S

C

-
ConstructorAndArgs<T> - Class in org.ObjectLayout
Captures a specific constructor and arguments to be passed to it.
ConstructorAndArgs(Constructor<T>, Object[]) - -Constructor for class org.ObjectLayout.ConstructorAndArgs -
Create a ConstructorAndArgs instance. -
ConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports a general element construction API for StructuredArray by providing specific constructor - and arguments factory to used for constructing individual array elements during array creation.
ConstructorAndArgsLocator(Class<T>) - -Constructor for class org.ObjectLayout.ConstructorAndArgsLocator -
Used to apply a fixed constructor with a given set of arguments to all element. -
CopyConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports the construction of a new array's individual elements using a copy constructor to copy a source - array's corresponding elements.
CopyConstructorAndArgsLocator(Class<T>, StructuredArray<T>) - -Constructor for class org.ObjectLayout.CopyConstructorAndArgsLocator +
CopyCtorAndArgsProvider<T> - Class in org.ObjectLayout
Supports the construction of a new array's individual elements using a copy constructor to copy a source + array's corresponding elements.
CopyCtorAndArgsProvider(Class<T>, StructuredArray<T>) - +Constructor for class org.ObjectLayout.CopyCtorAndArgsProvider
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a source array -
CopyConstructorAndArgsLocator(Class<T>, StructuredArray<T>, long[]) - -Constructor for class org.ObjectLayout.CopyConstructorAndArgsLocator +
CopyCtorAndArgsProvider(Class<T>, StructuredArray<T>, long[]) - +Constructor for class org.ObjectLayout.CopyCtorAndArgsProvider
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a source array, starting at a given offset -
CopyConstructorAndArgsLocator(Class<T>, StructuredArray<T>, long[], boolean) - -Constructor for class org.ObjectLayout.CopyConstructorAndArgsLocator +
CopyCtorAndArgsProvider(Class<T>, StructuredArray<T>, long[], boolean) - +Constructor for class org.ObjectLayout.CopyCtorAndArgsProvider
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a source array, starting at a given offset -
copyInstance(MultiDimensionalStructuredArray<T>) - -Static method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Copy an array of elements to a newly created array. -
copyInstance(MultiDimensionalStructuredArray<T>, long[], Long...) - -Static method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Copy a range from an array of elements to a newly created array. -
copyInstance(MultiDimensionalStructuredArray<T>, long[], long[]) - -Static method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Copy a range from an array of elements to a newly created array. -
copyInstance(SingleDimensionalStructuredArray<T>) - -Static method in class org.ObjectLayout.SingleDimensionalStructuredArray -
Copy an array of elements to a newly created array. -
copyInstance(SingleDimensionalStructuredArray<T>, long, long) - -Static method in class org.ObjectLayout.SingleDimensionalStructuredArray -
Copy a range from an array of elements to a newly created array.
copyInstance(StructuredArray<T>) - Static method in class org.ObjectLayout.StructuredArray
Copy an array of elements to a newly created array. @@ -124,6 +102,13 @@
copyInstance(StructuredArray<T>, long[], long[]) - Static method in class org.ObjectLayout.StructuredArray
Copy a range from an array of elements to a newly created array. +
CtorAndArgs<T> - Class in org.ObjectLayout
Captures a specific constructor and arguments to be passed to it.
CtorAndArgs(Constructor<T>, Object[]) - +Constructor for class org.ObjectLayout.CtorAndArgs +
Create a CtorAndArgs instance. +
CtorAndArgsProvider<T> - Class in org.ObjectLayout
Supports a general element construction API for StructuredArray by providing specific constructor + and arguments factory to used for constructing individual array elements during array creation.
CtorAndArgsProvider(Class<T>) - +Constructor for class org.ObjectLayout.CtorAndArgsProvider +
Used to apply a fixed constructor with a given set of arguments to all element.

@@ -176,7 +161,7 @@ -A C F G H I M N O R S
+A C G H I N O R S
diff --git a/JavaDoc/index-files/index-3.html b/JavaDoc/index-files/index-3.html index cb776e7..b588144 100644 --- a/JavaDoc/index-files/index-3.html +++ b/JavaDoc/index-files/index-3.html @@ -2,12 +2,12 @@ - + -F-Index +G-Index - + @@ -15,7 +15,7 @@ function windowTitle() { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="F-Index"; + parent.document.title="G-Index"; } } @@ -76,20 +76,98 @@ -A C F G H I M N O R S
-

-F

+A C G H I N O R S
+

+G

-
FixedConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports a fixed (cached) constructor and set of arguments for either default construction or construction - with a given fixed set of arguments (repeated for all indices)
FixedConstructorAndArgsLocator(Class<T>) - -Constructor for class org.ObjectLayout.FixedConstructorAndArgsLocator -
Used to apply default constructor to all elements. -
FixedConstructorAndArgsLocator(Class<T>, Class[], Object[]) - -Constructor for class org.ObjectLayout.FixedConstructorAndArgsLocator -
Used to apply a fixed constructor with a given set of arguments to all elements. -
FixedConstructorAndArgsLocator(Constructor<T>, Object[]) - -Constructor for class org.ObjectLayout.FixedConstructorAndArgsLocator -
Used to apply a fixed constructor with a given set of arguments to all elements. +
get(long[]) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using a long[] index array. +
get(long[], int) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using long indices supplied in an array. +
get(Long...) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using a varargs long indices. +
get(Integer...) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using a varargs int indices. +
get(long) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using a long index. +
get(long, long) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using 2 long indexes. +
get(long, long, long) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using 3 long indexes. +
get(long, long, long, long) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using 4 long indexes. +
get(int) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using an int index. +
get(int, int) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using 2 int indexes. +
get(int, int, int) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using 3 int indexes. +
get(int, int, int, int) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to an element in the array, using 4 int indexes. +
getArgs() - +Method in class org.ObjectLayout.CtorAndArgs +
  +
getConstructor() - +Method in class org.ObjectLayout.CtorAndArgs +
  +
getCursors() - +Method in class org.ObjectLayout.StructuredArray.StructureIterator +
  +
getDimensionCount() - +Method in class org.ObjectLayout.StructuredArray +
Get the number of dimensions of the array. +
getElementClass() - +Method in class org.ObjectLayout.CtorAndArgsProvider +
Get the Class of the elements to be constructed +
getElementClass() - +Method in class org.ObjectLayout.StructuredArray +
Get the Class of elements stored in the array. +
getForIndex(long) - +Method in class org.ObjectLayout.ArrayCtorAndArgsProvider +
Get a CtorAndArgs instance to be used in constructing a given element index in + a StructuredArray. +
getForIndices(long[]) - +Method in class org.ObjectLayout.ArrayCtorAndArgsProvider +
  +
getForIndices(long[]) - +Method in class org.ObjectLayout.CopyCtorAndArgsProvider +
Get a CtorAndArgs instance to be used in constructing a given element index in + a StructuredArray. +
getForIndices(long[]) - +Method in class org.ObjectLayout.CtorAndArgsProvider +
Get a CtorAndArgs instance to be used in constructing a given element index in + a StructuredArray +
getForIndices(long[]) - +Method in class org.ObjectLayout.SingletonCtorAndArgsProvider +
Get a CtorAndArgs instance to be used in constructing a given element index in + a StructuredArray. +
getLength() - +Method in class org.ObjectLayout.StructuredArray +
Get the length (number of elements) of the array. +
getLengths() - +Method in class org.ObjectLayout.StructuredArray +
Get the lengths (number of elements per dimension) of the array. +
getSubArray(long) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to a StructuredArray element in this array, using a long index. +
getSubArray(int) - +Method in class org.ObjectLayout.StructuredArray +
Get a reference to a StructuredArray element in this array, using a int index. +
getTotalElementCount() - +Method in class org.ObjectLayout.StructuredArray +
Get the total number of elements (in all dimensions combined) in this multi-dimensional array.

@@ -142,7 +220,7 @@ -A C F G H I M N O R S
+A C G H I N O R S
diff --git a/JavaDoc/index-files/index-4.html b/JavaDoc/index-files/index-4.html index 24cb2fc..e4931b7 100644 --- a/JavaDoc/index-files/index-4.html +++ b/JavaDoc/index-files/index-4.html @@ -2,12 +2,12 @@ - + -G-Index +H-Index - + @@ -15,7 +15,7 @@ function windowTitle() { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="G-Index"; + parent.document.title="H-Index"; } } @@ -76,178 +76,13 @@ -A C F G H I M N O R S
-

-G

+A C G H I N O R S
+

+H

-
get(Integer...) - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get a reference to an element in the array, using a varargs int indexes. -
get(int, int) - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get a reference to an element in the array, using 2 int indexes. -
get(int, int, int) - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get a reference to an element in the array, using 3 int indexes. -
get(int, int, int, int) - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get a reference to an element in the array, using 4 int indexes. -
get(int) - -Method in class org.ObjectLayout.SingleDimensionalStructuredArray -
Get a reference to an element in the array, using an int index. -
get(long[]) - -Method in class org.ObjectLayout.StructuredArray -
Get a reference to an element in the array, using a long[] index array. -
get(long[], int) - -Method in class org.ObjectLayout.StructuredArray -
Get a reference to an element in the array, using long indexes supplied in an array. -
get(Long...) - -Method in class org.ObjectLayout.StructuredArray -
Get a reference to an element in the array, using a varargs long indexes. -
get(Integer...) - -Method in class org.ObjectLayout.StructuredArray -
Get a reference to an element in the array, using a varargs int indexes. -
get(long) - -Method in class org.ObjectLayout.StructuredArray -
Get a reference to an element in the array, using a long index. -
get(long, long) - -Method in class org.ObjectLayout.StructuredArray -
Get a reference to an element in the array, using 2 long indexes. -
get(long, long, long) - -Method in class org.ObjectLayout.StructuredArray -
Get a reference to an element in the array, using 3 long indexes. -
get(long, long, long, long) - -Method in class org.ObjectLayout.StructuredArray -
Get a reference to an element in the array, using 4 long indexes. -
get(int) - -Method in class org.ObjectLayout.StructuredArray -
Get a reference to an element in the array, using an int index. -
get(int, int) - -Method in class org.ObjectLayout.StructuredArray -
Get a reference to an element in the array, using 2 int indexes. -
get(int, int, int) - -Method in class org.ObjectLayout.StructuredArray -
Get a reference to an element in the array, using 3 int indexes. -
get(int, int, int, int) - -Method in class org.ObjectLayout.StructuredArray -
Get a reference to an element in the array, using 4 int indexes. -
getConstructor() - -Method in class org.ObjectLayout.ConstructorAndArgs -
  -
getConstructorArgs() - -Method in class org.ObjectLayout.ConstructorAndArgs -
  -
getCursors() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator -
  -
getCursors() - +
hasNext() - Method in class org.ObjectLayout.StructuredArray.StructureIterator -
  -
getDimensionCount() - -Method in class org.ObjectLayout.StructuredArray -
Get the number of dimensions of the array. -
getElementClass() - -Method in class org.ObjectLayout.ConstructorAndArgsLocator -
Get the Class of the elements to be constructed -
getElementClass() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get the Class of elements stored in the array. -
getElementClass() - -Method in class org.ObjectLayout.SingleDimensionalStructuredArray -
Get the Class of elements stored in the array. -
getElementClass() - -Method in class org.ObjectLayout.StructuredArray -
Get the Class of elements stored in the array. -
getForIndex(long) - -Method in class org.ObjectLayout.ArrayConstructorAndArgsLocator -
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray. -
getForIndexes(long[]) - -Method in class org.ObjectLayout.ArrayConstructorAndArgsLocator -
  -
getForIndexes(long[]) - -Method in class org.ObjectLayout.ConstructorAndArgsLocator -
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray -
getForIndexes(long[]) - -Method in class org.ObjectLayout.CopyConstructorAndArgsLocator -
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray. -
getForIndexes(long[]) - -Method in class org.ObjectLayout.FixedConstructorAndArgsLocator -
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a StructuredArray. -
getForIndexes(long[]) - -Method in class org.ObjectLayout.MultiDimensionalCopyConstructorAndArgsLocator -
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a MultiDimensionalStructuredArray. -
getForIndexes(long[]) - -Method in class org.ObjectLayout.SingleDimensionalCopyConstructorAndArgsLocator -
Get a ConstructorAndArgs instance to be used in constructing a given element index in - a SingleDimensionalStructuredArray. -
getL(long[]) - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get a reference to an element in the array, using a long[] index array. -
getL(long[], int) - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get a reference to an element in the array, using long indexes supplied in an array. -
getL(Long...) - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get a reference to an element in the array, using a varargs long indexes. -
getL(long, long) - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get a reference to an element in the array, using 2 long indexes. -
getL(long, long, long) - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get a reference to an element in the array, using 3 long indexes. -
getL(long, long, long, long) - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get a reference to an element in the array, using 4 long indexes. -
getL(long) - -Method in class org.ObjectLayout.SingleDimensionalStructuredArray -
Get a reference to an element in the array, using a long index. -
getLength() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get the length (number of elements) of the array. -
getLength() - -Method in class org.ObjectLayout.SingleDimensionalStructuredArray -
Get the length (number of elements) of the array. -
getLength() - -Method in class org.ObjectLayout.StructuredArray -
Get the length (number of elements) of the array. -
getLengths() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get the lengths (number of elements per dimension) of the array. -
getLengths() - -Method in class org.ObjectLayout.StructuredArray -
Get the lengths (number of elements per dimension) of the array. -
getNumOfDimensions() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get the number of dimensions of the array. -
getOfMultiDimensionalStructuredArray(int) - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get a reference to a MultiDimensionalStructuredArray element in this array, using a int index. -
getOfMultiDimensionalStructuredArrayL(long) - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get a reference to a SingleDimensionalStructuredArray element in this array, using a long index. -
getOfStructuredArray(int) - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get a reference to a MultiDimensionalStructuredArray element in this array, using a int index. -
getOfStructuredArrayL(long) - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get a reference to a SingleDimensionalStructuredArray element in this array, using a long index. -
getSubArray(long) - -Method in class org.ObjectLayout.StructuredArray -
Get a reference to a StructuredArray element in this array, using a long index. -
getSubArray(int) - -Method in class org.ObjectLayout.StructuredArray -
Get a reference to a StructuredArray element in this array, using a int index. -
getTotalElementCount() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Get the total number of elements (in all dimensions combined) in this multi-dimensional array. -
getTotalElementCount() - -Method in class org.ObjectLayout.StructuredArray -
Get the total number of elements (in all dimensions combined) in this multi-dimensional array. +

@@ -300,7 +135,7 @@ -A C F G H I M N O R S
+A C G H I N O R S
diff --git a/JavaDoc/index-files/index-5.html b/JavaDoc/index-files/index-5.html index a71a8d7..ae29ae5 100644 --- a/JavaDoc/index-files/index-5.html +++ b/JavaDoc/index-files/index-5.html @@ -2,12 +2,12 @@ - + -H-Index +I-Index - + @@ -15,7 +15,7 @@ function windowTitle() { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="H-Index"; + parent.document.title="I-Index"; } } @@ -76,18 +76,12 @@ -A C F G H I M N O R S
-

-H

+A C G H I N O R S
+

+I

-
hasNext() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator -
-
hasNext() - -Method in class org.ObjectLayout.SingleDimensionalStructuredArray.StructureIterator -
-
hasNext() - -Method in class org.ObjectLayout.StructuredArray.StructureIterator +
iterator() - +Method in class org.ObjectLayout.StructuredArray

@@ -141,7 +135,7 @@ -A C F G H I M N O R S
+A C G H I N O R S
diff --git a/JavaDoc/index-files/index-6.html b/JavaDoc/index-files/index-6.html index df75c50..4e1cfc3 100644 --- a/JavaDoc/index-files/index-6.html +++ b/JavaDoc/index-files/index-6.html @@ -2,12 +2,12 @@ - + -I-Index +N-Index - + @@ -15,7 +15,7 @@ function windowTitle() { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="I-Index"; + parent.document.title="N-Index"; } } @@ -76,18 +76,39 @@ -A C F G H I M N O R S
-

-I

+A C G H I N O R S
+

+N

-
iterator() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray -
-
iterator() - -Method in class org.ObjectLayout.SingleDimensionalStructuredArray -
-
iterator() - -Method in class org.ObjectLayout.StructuredArray +
newInstance(Class<T>, long) - +Static method in class org.ObjectLayout.StructuredArray +
Create an array of length elements, each containing an element object of + type elementClass. +
newInstance(CtorAndArgsProvider<T>, long) - +Static method in class org.ObjectLayout.StructuredArray +
Create an array of length elements, each containing an element object of + type elementClass. +
newInstance(Class<T>, long, Class[], Object...) - +Static method in class org.ObjectLayout.StructuredArray +
Create an array of length elements, each containing an element object of + type elementClass. +
newInstance(Class<T>, Long...) - +Static method in class org.ObjectLayout.StructuredArray +
Create a multi dimensional array of elements. +
newInstance(Class<T>, long[]) - +Static method in class org.ObjectLayout.StructuredArray +
Create a multi dimensional array of elements. +
newInstance(Class<T>, long[], Class[], Object...) - +Static method in class org.ObjectLayout.StructuredArray +
Create a multi dimensional array of elements. +
newInstance(CtorAndArgsProvider<T>, Long...) - +Static method in class org.ObjectLayout.StructuredArray +
Create a multi dimensional array of elements. +
newInstance(CtorAndArgsProvider<T>, long[]) - +Static method in class org.ObjectLayout.StructuredArray +
Create a multi dimensional array of elements. +
next() - +Method in class org.ObjectLayout.StructuredArray.StructureIterator

@@ -141,7 +162,7 @@ -A C F G H I M N O R S
+A C G H I N O R S
diff --git a/JavaDoc/index-files/index-7.html b/JavaDoc/index-files/index-7.html index 8ccb773..1487a65 100644 --- a/JavaDoc/index-files/index-7.html +++ b/JavaDoc/index-files/index-7.html @@ -2,12 +2,12 @@ - + -M-Index +O-Index - + @@ -15,7 +15,7 @@ function windowTitle() { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="M-Index"; + parent.document.title="O-Index"; } } @@ -76,27 +76,11 @@ -A C F G H I M N O R S
-

-M

+A C G H I N O R S
+

+O

-
MultiDimensionalCopyConstructorAndArgsLocator<T> - Class in org.ObjectLayout
Supports the construction of a new array's individual elements using a copy constructor to copy a source - array's corresponding elements.
MultiDimensionalCopyConstructorAndArgsLocator(Class<T>, MultiDimensionalStructuredArray<T>) - -Constructor for class org.ObjectLayout.MultiDimensionalCopyConstructorAndArgsLocator -
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a - source array -
MultiDimensionalCopyConstructorAndArgsLocator(Class<T>, MultiDimensionalStructuredArray<T>, long[]) - -Constructor for class org.ObjectLayout.MultiDimensionalCopyConstructorAndArgsLocator -
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a - source array, starting at a given offset -
MultiDimensionalCopyConstructorAndArgsLocator(Class<T>, MultiDimensionalStructuredArray<T>, long[], boolean) - -Constructor for class org.ObjectLayout.MultiDimensionalCopyConstructorAndArgsLocator -
Used to apply a copy constructor to a target array's elements, copying corresponding elements from a - source array, starting at a given offset -
MultiDimensionalStructuredArray<T> - Class in org.ObjectLayout
An array of (potentially) mutable but non-replaceable objects.
MultiDimensionalStructuredArray.StructureIterator - Class in org.ObjectLayout
Specialised Iterator with the ability to be MultiDimensionalStructuredArray.StructureIterator.reset() enabling reuse.
MultiDimensionalStructuredArray.StructureIterator() - -Constructor for class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator -
  -
+
org.ObjectLayout - package org.ObjectLayout
ObjectLayout: An optimised memory layout package.
@@ -148,7 +132,7 @@ -A C F G H I M N O R S
+A C G H I N O R S
diff --git a/JavaDoc/index-files/index-8.html b/JavaDoc/index-files/index-8.html index 6928d8f..1b3745b 100644 --- a/JavaDoc/index-files/index-8.html +++ b/JavaDoc/index-files/index-8.html @@ -2,12 +2,12 @@ - + -N-Index +R-Index - + @@ -15,7 +15,7 @@ function windowTitle() { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="N-Index"; + parent.document.title="R-Index"; } } @@ -76,73 +76,26 @@ -A C F G H I M N O R S
-

-N

+A C G H I N O R S
+

+R

-
newInstance(Class<T>, Long...) - -Static method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Create a multi dimensional array of elements. -
newInstance(Class<T>, long[]) - -Static method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Create a multi dimensional array of elements. -
newInstance(Class<T>, long[], Class[], Object...) - -Static method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Create a multi dimensional array of elements. -
newInstance(ConstructorAndArgsLocator<T>, Long...) - -Static method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Create a multi dimensional array of elements. -
newInstance(ConstructorAndArgsLocator<T>, long[]) - -Static method in class org.ObjectLayout.MultiDimensionalStructuredArray -
Create a multi dimensional array of elements. -
newInstance(Class<T>, long) - -Static method in class org.ObjectLayout.SingleDimensionalStructuredArray -
Create an array of length elements, each containing an element object of - type elementClass. -
newInstance(ConstructorAndArgsLocator<T>, long) - -Static method in class org.ObjectLayout.SingleDimensionalStructuredArray -
Create an array of length elements, each containing an element object of - type elementClass. -
newInstance(Class<T>, long, Class[], Object...) - -Static method in class org.ObjectLayout.SingleDimensionalStructuredArray -
Create an array of length elements, each containing an element object of - type elementClass. -
newInstance(Class<T>, long) - -Static method in class org.ObjectLayout.StructuredArray -
Create an array of length elements, each containing an element object of - type elementClass. -
newInstance(ConstructorAndArgsLocator<T>, long) - -Static method in class org.ObjectLayout.StructuredArray -
Create an array of length elements, each containing an element object of - type elementClass. -
newInstance(Class<T>, long, Class[], Object...) - -Static method in class org.ObjectLayout.StructuredArray -
Create an array of length elements, each containing an element object of - type elementClass. -
newInstance(Class<T>, Long...) - -Static method in class org.ObjectLayout.StructuredArray -
Create a multi dimensional array of elements. -
newInstance(Class<T>, long[]) - -Static method in class org.ObjectLayout.StructuredArray -
Create a multi dimensional array of elements. -
newInstance(Class<T>, long[], Class[], Object...) - -Static method in class org.ObjectLayout.StructuredArray -
Create a multi dimensional array of elements. -
newInstance(ConstructorAndArgsLocator<T>, Long...) - -Static method in class org.ObjectLayout.StructuredArray -
Create a multi dimensional array of elements. -
newInstance(ConstructorAndArgsLocator<T>, long[]) - -Static method in class org.ObjectLayout.StructuredArray -
Create a multi dimensional array of elements. -
next() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator -
-
next() - -Method in class org.ObjectLayout.SingleDimensionalStructuredArray.StructureIterator -
-
next() - +
recycle(CtorAndArgs) - +Method in class org.ObjectLayout.ArrayCtorAndArgsProvider +
Recycle an CtorAndArgs instance (place it back in the internal cache if desired). +
recycle(CtorAndArgs) - +Method in class org.ObjectLayout.CopyCtorAndArgsProvider +
Recycle an CtorAndArgs instance (place it back in the internal cache if + desired). +
recycle(CtorAndArgs) - +Method in class org.ObjectLayout.CtorAndArgsProvider +
Recycle a CtorAndArgs instance (place it back in the internal cache if desired). +
remove() - Method in class org.ObjectLayout.StructuredArray.StructureIterator -
+
Remove operation is not supported on StructuredArrays. +
reset() - +Method in class org.ObjectLayout.StructuredArray.StructureIterator +
Reset to the beginning of the collection enabling reuse of the iterator.

@@ -195,7 +148,7 @@ -A C F G H I M N O R S
+A C G H I N O R S
diff --git a/JavaDoc/index-files/index-9.html b/JavaDoc/index-files/index-9.html index becaa86..73e27b9 100644 --- a/JavaDoc/index-files/index-9.html +++ b/JavaDoc/index-files/index-9.html @@ -2,12 +2,12 @@ - + -O-Index +S-Index - + @@ -15,7 +15,7 @@ function windowTitle() { if (location.href.indexOf('is-external=true') == -1) { - parent.document.title="O-Index"; + parent.document.title="S-Index"; } } @@ -54,7 +54,7 @@
 Tget(java.lang.Integer... indexes) +get(java.lang.Integer... indices)
-          Get a reference to an element in the array, using a varargs int indexes.
@@ -254,10 +254,10 @@

 Tget(java.lang.Long... indexes) +get(java.lang.Long... indices)
-          Get a reference to an element in the array, using a varargs long indexes.
@@ -270,7 +270,7 @@

 Tget(long[] indexes) +get(long[] indices)
          Get a reference to an element in the array, using a long[] index array.
 Tget(long[] indexes, +get(long[] indices, int indexOffset)
-          Get a reference to an element in the array, using long indexes supplied in an array.
@@ -474,7 +474,7 @@

newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator, +newInstance(CtorAndArgsProvider<T> ctorAndArgsProvider, java.lang.Long... lengths)
@@ -490,7 +490,7 @@

-newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator, +newInstance(CtorAndArgsProvider<T> ctorAndArgsProvider, long length)
@@ -507,7 +507,7 @@

-newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator, +newInstance(CtorAndArgsProvider<T> ctorAndArgsProvider, long[] lengths)
@@ -582,23 +582,23 @@


-

+

newInstance

-public static <T> StructuredArray<T> newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator,
+public static <T> StructuredArray<T> newInstance(CtorAndArgsProvider<T> ctorAndArgsProvider,
                                                  long length)
                                       throws java.lang.NoSuchMethodException
Create an array of length elements, each containing an element object of type elementClass. Use constructor and arguments supplied (on a potentially - per element index basis) by the specified constructorAndArgsLocator to construct and initialize + per element index basis) by the specified ctorAndArgsProvider to construct and initialize each element.

-
Parameters:
length - of the array to create.
constructorAndArgsLocator - produces element constructors [potentially] on a per element basis. +
Parameters:
length - of the array to create.
ctorAndArgsProvider - produces element constructors [potentially] on a per element basis.
Throws:
java.lang.NoSuchMethodException - if the element class does not not support a supplied constructor
@@ -704,48 +704,48 @@


-

+

newInstance

-public static <T> StructuredArray<T> newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator,
+public static <T> StructuredArray<T> newInstance(CtorAndArgsProvider<T> ctorAndArgsProvider,
                                                  java.lang.Long... lengths)
                                       throws java.lang.NoSuchMethodException
Create a multi dimensional array of elements. Each dimension of the array will be of a length designated in the lengths arguments passed. Each element of the array will consist of an object of type elementClass. Elements will be constructed using the constructor and arguments - supplied (on a potentially per element index basis) by the specified constructorAndArgsLocator. + supplied (on a potentially per element index basis) by the specified ctorAndArgsProvider. to construct and initialize each element.

-
Parameters:
constructorAndArgsLocator - produces element constructors [potentially] on a per element basis.
lengths - of the array dimensions to create. +
Parameters:
ctorAndArgsProvider - produces element constructors [potentially] on a per element basis.
lengths - of the array dimensions to create.
Throws:
java.lang.NoSuchMethodException - if the element class does not not support a supplied constructor

-

+

newInstance

-public static <T> StructuredArray<T> newInstance(ConstructorAndArgsLocator<T> constructorAndArgsLocator,
+public static <T> StructuredArray<T> newInstance(CtorAndArgsProvider<T> ctorAndArgsProvider,
                                                  long[] lengths)
                                       throws java.lang.NoSuchMethodException
Create a multi dimensional array of elements. Each dimension of the array will be of a length designated in the lengths[] passed. Each element of the array will consist of an object of type elementClass. Elements will be constructed using the constructor and arguments - supplied (on a potentially per element index basis) by the specified constructorAndArgsLocator. + supplied (on a potentially per element index basis) by the specified ctorAndArgsProvider. to construct and initialize each element.

-
Parameters:
constructorAndArgsLocator - produces element constructors [potentially] on a per element basis.
lengths - of the array dimensions to create. +
Parameters:
ctorAndArgsProvider - produces element constructors [potentially] on a per element basis.
lengths - of the array dimensions to create.
Throws:
java.lang.NoSuchMethodException - if the element class does not not support a supplied constructor
@@ -890,7 +890,7 @@

get

-public T get(long[] indexes)
+public T get(long[] indices)
       throws java.lang.IllegalArgumentException
Get a reference to an element in the array, using a long[] index array. @@ -899,10 +899,10 @@

-
Parameters:
indexes - The indexes (at each dimension) of the element to retrieve. +
Parameters:
indices - The indices (at each dimension) of the element to retrieve.
Returns:
a reference to the indexed element.
Throws: -
java.lang.IllegalArgumentException - if number of indexes does not match number of dimensions in the array
+
java.lang.IllegalArgumentException - if number of indices does not match number of dimensions in the array

@@ -910,11 +910,11 @@

get

-public T get(long[] indexes,
+public T get(long[] indices,
              int indexOffset)
       throws java.lang.IllegalArgumentException
-
Get a reference to an element in the array, using long indexes supplied in an array. +
Get a reference to an element in the array, using long indices supplied in an array. indexOffset indicates the starting point in the array at which the first index should be found. This form is useful when passing index arrays through multiple levels to avoid construction of temporary varargs containers or construction of new shorter index arrays. @@ -923,10 +923,10 @@

-
Parameters:
indexes - The indexes (at each dimension) of the element to retrieve.
indexOffset - The beginning offset in the indexes array related to this arrays contents. +
Parameters:
indices - The indices (at each dimension) of the element to retrieve.
indexOffset - The beginning offset in the indices array related to this arrays contents.
Returns:
a reference to the indexed element.
Throws: -
java.lang.IllegalArgumentException - if number of relevant indexes does not match number of dimensions in the array
+
java.lang.IllegalArgumentException - if number of relevant indices does not match number of dimensions in the array

@@ -934,19 +934,19 @@

get

-public T get(java.lang.Long... indexes)
+public T get(java.lang.Long... indices)
       throws java.lang.IllegalArgumentException
-
Get a reference to an element in the array, using a varargs long indexes. +
Get a reference to an element in the array, using a varargs long indices.

-
Parameters:
indexes - The indexes (at each dimension) of the element to retrieve. +
Parameters:
indices - The indices (at each dimension) of the element to retrieve.
Returns:
a reference to the indexed element.
Throws: -
java.lang.IllegalArgumentException - if number of indexes does not match number of dimensions in the array
+
java.lang.IllegalArgumentException - if number of indices does not match number of dimensions in the array

@@ -954,19 +954,19 @@

get

-public T get(java.lang.Integer... indexes)
+public T get(java.lang.Integer... indices)
       throws java.lang.IllegalArgumentException
-
Get a reference to an element in the array, using a varargs int indexes. +
Get a reference to an element in the array, using a varargs int indices.

-
Parameters:
indexes - The indexes (at each dimension) of the element to retrieve. +
Parameters:
indices - The indices (at each dimension) of the element to retrieve.
Returns:
a reference to the indexed element.
Throws: -
java.lang.IllegalArgumentException - if number of indexes does not match number of dimensions in the array
+
java.lang.IllegalArgumentException - if number of indices does not match number of dimensions in the array

@@ -1308,7 +1308,7 @@

PREV CLASS  + PREV CLASS   NEXT CLASS FRAMES   diff --git a/JavaDoc/org/ObjectLayout/package-frame.html b/JavaDoc/org/ObjectLayout/package-frame.html index 301d24f..601096e 100644 --- a/JavaDoc/org/ObjectLayout/package-frame.html +++ b/JavaDoc/org/ObjectLayout/package-frame.html @@ -2,12 +2,12 @@ - + org.ObjectLayout - + @@ -23,23 +23,15 @@ Classes 
-ArrayConstructorAndArgsLocator +ArrayCtorAndArgsProvider
-ConstructorAndArgs +CopyCtorAndArgsProvider
-ConstructorAndArgsLocator +CtorAndArgs
-CopyConstructorAndArgsLocator +CtorAndArgsProvider
-FixedConstructorAndArgsLocator -
-MultiDimensionalCopyConstructorAndArgsLocator -
-MultiDimensionalStructuredArray -
-SingleDimensionalCopyConstructorAndArgsLocator -
-SingleDimensionalStructuredArray +SingletonCtorAndArgsProvider
StructuredArray
diff --git a/JavaDoc/org/ObjectLayout/package-summary.html b/JavaDoc/org/ObjectLayout/package-summary.html index 4243f01..7d99160 100644 --- a/JavaDoc/org/ObjectLayout/package-summary.html +++ b/JavaDoc/org/ObjectLayout/package-summary.html @@ -2,12 +2,12 @@ - + org.ObjectLayout - + @@ -93,46 +93,28 @@

Class Summary -ArrayConstructorAndArgsLocator<T> +ArrayCtorAndArgsProvider<T> Supports the construction of a new array's individual elements using a copy constructor to copy a source array's corresponding elements. -ConstructorAndArgs<T> -Captures a specific constructor and arguments to be passed to it. - - -ConstructorAndArgsLocator<T> -Supports a general element construction API for StructuredArray by providing specific constructor - and arguments factory to used for constructing individual array elements during array creation. - - -CopyConstructorAndArgsLocator<T> -Supports the construction of a new array's individual elements using a copy constructor to copy a source - array's corresponding elements. - - -FixedConstructorAndArgsLocator<T> -Supports a fixed (cached) constructor and set of arguments for either default construction or construction - with a given fixed set of arguments (repeated for all indices) - - -MultiDimensionalCopyConstructorAndArgsLocator<T> +CopyCtorAndArgsProvider<T> Supports the construction of a new array's individual elements using a copy constructor to copy a source array's corresponding elements. -MultiDimensionalStructuredArray<T> -An array of (potentially) mutable but non-replaceable objects. +CtorAndArgs<T> +Captures a specific constructor and arguments to be passed to it. -SingleDimensionalCopyConstructorAndArgsLocator<T> -Supports the construction of a new array's individual elements using a copy constructor to copy a source - array's corresponding elements. +CtorAndArgsProvider<T> +Supports a general element construction API for StructuredArray by providing specific constructor + and arguments factory to used for constructing individual array elements during array creation. -SingleDimensionalStructuredArray<T> -An array of (potentially) mutable but non-replaceable objects. +SingletonCtorAndArgsProvider<T> +Supports a single (cached) constructor and set of arguments for either default construction or construction + with a given fixed set of arguments (repeated for all indices) StructuredArray<T> diff --git a/JavaDoc/org/ObjectLayout/package-tree.html b/JavaDoc/org/ObjectLayout/package-tree.html index 9f81857..ceb4c7f 100644 --- a/JavaDoc/org/ObjectLayout/package-tree.html +++ b/JavaDoc/org/ObjectLayout/package-tree.html @@ -2,12 +2,12 @@ - + org.ObjectLayout Class Hierarchy - + @@ -87,12 +87,8 @@

  • java.lang.Object diff --git a/JavaDoc/overview-tree.html b/JavaDoc/overview-tree.html index 10ee478..8843ec6 100644 --- a/JavaDoc/overview-tree.html +++ b/JavaDoc/overview-tree.html @@ -2,12 +2,12 @@ - + Class Hierarchy - + @@ -89,12 +89,8 @@

    • java.lang.Object From 29b0aa61924981ada1265ec50aa7d9ebec8c7593 Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Thu, 6 Feb 2014 10:19:29 -0800 Subject: [PATCH 19/39] Fixing link to project --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 5bc683f..68521e0 100644 --- a/index.html +++ b/index.html @@ -18,7 +18,7 @@

      ObjectLayout

      An optimised memory layout package

      -

      +

      View the Project on GitHub ObjectLayout/ObjectLayout

      From 1649f89e93c2a2398cdb1ea284bb554a57274985 Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Thu, 13 Feb 2014 11:54:10 -0800 Subject: [PATCH 20/39] Fixing link to project --- index.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/index.html b/index.html index 68521e0..8854212 100644 --- a/index.html +++ b/index.html @@ -18,7 +18,7 @@

      ObjectLayout

      An optimised memory layout package

      -

      +

      View the Project on GitHub ObjectLayout/ObjectLayout

      @@ -27,7 +27,7 @@

      ObjectLayout

      From 55cc023a7bae060472968b717ff06f1daad9ab6e Mon Sep 17 00:00:00 2001 From: Gil Tene Date: Sat, 7 Jun 2014 20:27:38 -0700 Subject: [PATCH 21/39] Updated JavaDoc --- JavaDoc/StructuredArrayOfAtomicLong.html | 309 ++++ JavaDoc/StructuredArrayOfAtomicLongTest.html | 463 ++++++ JavaDoc/StructuredArrayOfPoint.html | 413 +++++ ...t.html => StructuredArrayOfPointTest.html} | 214 +-- JavaDoc/allclasses-frame.html | 28 +- JavaDoc/allclasses-noframe.html | 28 +- JavaDoc/constant-values.html | 14 +- JavaDoc/deprecated-list.html | 14 +- JavaDoc/help-doc.html | 20 +- JavaDoc/index-files/index-1.html | 21 +- JavaDoc/index-files/index-10.html | 55 +- JavaDoc/index-files/index-11.html | 260 +++- JavaDoc/index-files/index-12.html | 52 +- JavaDoc/index-files/index-13.html | 147 -- JavaDoc/index-files/index-14.html | 169 --- JavaDoc/index-files/index-2.html | 29 +- JavaDoc/index-files/index-3.html | 116 +- JavaDoc/index-files/index-4.html | 129 +- JavaDoc/index-files/index-5.html | 36 +- JavaDoc/index-files/index-6.html | 58 +- JavaDoc/index-files/index-7.html | 31 +- JavaDoc/index-files/index-8.html | 132 +- JavaDoc/index-files/index-9.html | 57 +- JavaDoc/index.html | 45 +- .../ArrayConstructorAndArgsLocator.html | 372 ----- .../ArrayCtorAndArgsProvider.html | 10 +- .../org/ObjectLayout/ConstructorAndArgs.html | 329 ---- .../ConstructorAndArgsLocator.html | 327 ---- .../CopyConstructorAndArgsLocator.html | 372 ----- .../ObjectLayout/CopyCtorAndArgsProvider.html | 10 +- JavaDoc/org/ObjectLayout/CtorAndArgs.html | 10 +- .../org/ObjectLayout/CtorAndArgsProvider.html | 14 +- .../ElementConstructorGenerator.html | 328 ---- .../ElementCopyConstructorGenerator.html | 342 ----- .../ElementFixedConstructorGenerator.html | 311 ---- .../FixedConstructorAndArgsLocator.html | 333 ----- ...nalField.html => IntrinsifiedObjects.html} | 137 +- ...ensionalCopyConstructorAndArgsLocator.html | 372 ----- ...ensionalCopyConstructorAndArgsLocator.html | 372 ----- ...onalStructuredArray.StructureIterator.html | 359 ----- .../MultiDimensionalStructuredArray.html | 1121 -------------- ...onalStructuredArrayTest.MockStructure.html | 404 ----- ...ensionalCopyConstructorAndArgsLocator.html | 371 ----- ...onalStructuredArray.StructureIterator.html | 337 ----- .../SingleDimensionalStructuredArray.html | 691 --------- .../SingletonCtorAndArgsProvider.html | 14 +- .../StructuredArray.StructureIterator.html | 14 +- JavaDoc/org/ObjectLayout/StructuredArray.html | 808 +++++++--- ...tructuredArrayPerfTest.MockStructure.html} | 80 +- ...PerfTest.MockStructureWithFinalField.html} | 46 +- ...rfTest.StructuredArrayOfMockStructure.html | 287 ++++ ...ator.html => StructuredArrayPerfTest.html} | 185 +-- .../StructuredArrayTest.MockStructure.html | 10 +- ...ArrayTest.MockStructureWithFinalField.html | 14 +- .../org/ObjectLayout/StructuredArrayTest.html | 136 +- .../StructuredArrayWithLongIndex.html | 556 ------- .../UnifiedCopyConstructorAndArgsLocator.html | 372 ----- .../ObjectLayout/UnifiedStructuredArray.html | 1325 ----------------- .../UnifiedStructuredArrayTest.html | 650 -------- JavaDoc/org/ObjectLayout/package-frame.html | 22 +- JavaDoc/org/ObjectLayout/package-summary.html | 47 +- JavaDoc/org/ObjectLayout/package-tree.html | 23 +- JavaDoc/overview-frame.html | 44 + JavaDoc/overview-summary.html | 149 ++ JavaDoc/overview-tree.html | 16 +- JavaDoc/package-frame.html | 38 + JavaDoc/package-list | 1 + JavaDoc/package-summary.html | 157 ++ JavaDoc/package-tree.html | 154 ++ 69 files changed, 3921 insertions(+), 10989 deletions(-) create mode 100644 JavaDoc/StructuredArrayOfAtomicLong.html create mode 100644 JavaDoc/StructuredArrayOfAtomicLongTest.html create mode 100644 JavaDoc/StructuredArrayOfPoint.html rename JavaDoc/{org/ObjectLayout/MultiDimensionalStructuredArrayTest.html => StructuredArrayOfPointTest.html} (61%) delete mode 100644 JavaDoc/index-files/index-13.html delete mode 100644 JavaDoc/index-files/index-14.html delete mode 100644 JavaDoc/org/ObjectLayout/ArrayConstructorAndArgsLocator.html delete mode 100644 JavaDoc/org/ObjectLayout/ConstructorAndArgs.html delete mode 100644 JavaDoc/org/ObjectLayout/ConstructorAndArgsLocator.html delete mode 100644 JavaDoc/org/ObjectLayout/CopyConstructorAndArgsLocator.html delete mode 100644 JavaDoc/org/ObjectLayout/ElementConstructorGenerator.html delete mode 100644 JavaDoc/org/ObjectLayout/ElementCopyConstructorGenerator.html delete mode 100644 JavaDoc/org/ObjectLayout/ElementFixedConstructorGenerator.html delete mode 100644 JavaDoc/org/ObjectLayout/FixedConstructorAndArgsLocator.html rename JavaDoc/org/ObjectLayout/{UnifiedStructuredArrayTest.MockStructureWithFinalField.html => IntrinsifiedObjects.html} (51%) delete mode 100644 JavaDoc/org/ObjectLayout/MulitDimensionalCopyConstructorAndArgsLocator.html delete mode 100644 JavaDoc/org/ObjectLayout/MultiDimensionalCopyConstructorAndArgsLocator.html delete mode 100644 JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.StructureIterator.html delete mode 100644 JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArray.html delete mode 100644 JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.MockStructure.html delete mode 100644 JavaDoc/org/ObjectLayout/SingleDimensionalCopyConstructorAndArgsLocator.html delete mode 100644 JavaDoc/org/ObjectLayout/SingleDimensionalStructuredArray.StructureIterator.html delete mode 100644 JavaDoc/org/ObjectLayout/SingleDimensionalStructuredArray.html rename JavaDoc/org/ObjectLayout/{UnifiedStructuredArrayTest.MockStructure.html => StructuredArrayPerfTest.MockStructure.html} (68%) rename JavaDoc/org/ObjectLayout/{MultiDimensionalStructuredArrayTest.MockStructureWithFinalField.html => StructuredArrayPerfTest.MockStructureWithFinalField.html} (71%) create mode 100644 JavaDoc/org/ObjectLayout/StructuredArrayPerfTest.StructuredArrayOfMockStructure.html rename JavaDoc/org/ObjectLayout/{UnifiedStructuredArray.StructureIterator.html => StructuredArrayPerfTest.html} (56%) delete mode 100644 JavaDoc/org/ObjectLayout/StructuredArrayWithLongIndex.html delete mode 100644 JavaDoc/org/ObjectLayout/UnifiedCopyConstructorAndArgsLocator.html delete mode 100644 JavaDoc/org/ObjectLayout/UnifiedStructuredArray.html delete mode 100644 JavaDoc/org/ObjectLayout/UnifiedStructuredArrayTest.html create mode 100644 JavaDoc/overview-frame.html create mode 100644 JavaDoc/overview-summary.html create mode 100644 JavaDoc/package-frame.html create mode 100644 JavaDoc/package-summary.html create mode 100644 JavaDoc/package-tree.html diff --git a/JavaDoc/StructuredArrayOfAtomicLong.html b/JavaDoc/StructuredArrayOfAtomicLong.html new file mode 100644 index 0000000..105c140 --- /dev/null +++ b/JavaDoc/StructuredArrayOfAtomicLong.html @@ -0,0 +1,309 @@ + + + + + + +StructuredArrayOfAtomicLong + + + + + + + + + + + + +
      + + + + + + + + + + + + + + + + + + + +
      + +
      + + + +
      + +

      +Class StructuredArrayOfAtomicLong

      +
      +java.lang.Object
      +  extended by org.ObjectLayout.StructuredArray<java.util.concurrent.atomic.AtomicLong>
      +      extended by StructuredArrayOfAtomicLong
      +
      +
      +
      All Implemented Interfaces:
      java.lang.Iterable<java.util.concurrent.atomic.AtomicLong>
      +
      +
      +
      +
      public class StructuredArrayOfAtomicLong
      extends StructuredArray<java.util.concurrent.atomic.AtomicLong>
      +

+ +

+A simple, minimalistic example of a non-generic subclass of StructuredArray. +

+ +

+


+ +

+ + + + + + + +
+Nested Class Summary
+ + + + + + + +
Nested classes/interfaces inherited from class org.ObjectLayout.StructuredArray
StructuredArray.StructureIterator
+  + + + + + + + + + + + +
+Constructor Summary
StructuredArrayOfAtomicLong() + +
+           
+  + + + + + + + + + + + + + + + +
+Method Summary
+ java.util.concurrent.atomic.AtomicLongget(long index) + +
+          Get a reference to an element in a single dimensional array, using a long index.
+static StructuredArrayOfAtomicLongnewInstance(long length) + +
+           
+ + + + + + + +
Methods inherited from class org.ObjectLayout.StructuredArray
copyInstance, copyInstance, get, get, get, get, get, get, get, get, get, getDimensionCount, getElementClass, getLength, getLengths, getSubArray, getSubArray, getTotalElementCount, iterator, newInstance, newInstance, newInstance, newInstance, newInstance, newInstance, newSubclassInstance, newSubclassInstance, newSubclassInstance, newSubclassInstance, newSubclassInstance, newSubclassInstance, newSubclassInstance, newSubclassInstance, newSubclassInstance, newSubclassInstance, newSubclassInstance, newSubclassInstance, shallowCopy, shallowCopy
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+StructuredArrayOfAtomicLong

+
+public StructuredArrayOfAtomicLong()
+
+
+ + + + + + + + +
+Method Detail
+ +

+newInstance

+
+public static StructuredArrayOfAtomicLong newInstance(long length)
+
+
+
+
+
+
+ +

+get

+
+public java.util.concurrent.atomic.AtomicLong get(long index)
+
+
Description copied from class: StructuredArray
+
Get a reference to an element in a single dimensional array, using a long index. +

+

+
Overrides:
get in class StructuredArray<java.util.concurrent.atomic.AtomicLong>
+
+
+
Parameters:
index - of the element to retrieve. +
Returns:
a reference to the indexed element.
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/StructuredArrayOfAtomicLongTest.html b/JavaDoc/StructuredArrayOfAtomicLongTest.html new file mode 100644 index 0000000..36a2232 --- /dev/null +++ b/JavaDoc/StructuredArrayOfAtomicLongTest.html @@ -0,0 +1,463 @@ + + + + + + +StructuredArrayOfAtomicLongTest + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+Class StructuredArrayOfAtomicLongTest

+
+java.lang.Object
+  extended by StructuredArrayOfAtomicLongTest
+
+
+
+
public class StructuredArrayOfAtomicLongTest
extends java.lang.Object
+
+ +

+


+ +

+ + + + + + + + + + + +
+Constructor Summary
StructuredArrayOfAtomicLongTest() + +
+           
+  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+Method Summary
+ longaccessArrayElementValue(StructuredArrayOfAtomicLong array, + long index) + +
+           
+ voidshouldCopyRegionLeftInArray() + +
+           
+ voidshouldCopyRegionRightInArray() + +
+           
+ voidshouldFailToConstructDirectly() + +
+           
+ voidshouldInitializeToCorrectValues() + +
+           
+ voidshouldIterateOverArray() + +
+           
+ voidshouldIterateOverArrayAndResetAgain() + +
+           
+ voidshouldNotThrowIncompatibleTypeExceptionForGetsOfProperTypes() + +
+           
+ voidshouldThrowIncompatibleTypeExceptionForGetOfAnArrayInsteadOfElement() + +
+           
+ voidshouldThrowIncompatibleTypeExceptionForGetOfAnElementInsteadOfArray() + +
+           
+ voidshouldThrowOutOfBoundExceptionForAccessesOutOfBounds() + +
+           
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+StructuredArrayOfAtomicLongTest

+
+public StructuredArrayOfAtomicLongTest()
+
+
+ + + + + + + + +
+Method Detail
+ +

+shouldInitializeToCorrectValues

+
+public void shouldInitializeToCorrectValues()
+
+
+
+
+
+
+ +

+shouldIterateOverArray

+
+public void shouldIterateOverArray()
+
+
+
+
+
+
+ +

+shouldIterateOverArrayAndResetAgain

+
+public void shouldIterateOverArrayAndResetAgain()
+                                         throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldThrowOutOfBoundExceptionForAccessesOutOfBounds

+
+public void shouldThrowOutOfBoundExceptionForAccessesOutOfBounds()
+                                                          throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldThrowIncompatibleTypeExceptionForGetOfAnElementInsteadOfArray

+
+public void shouldThrowIncompatibleTypeExceptionForGetOfAnElementInsteadOfArray()
+                                                                         throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldThrowIncompatibleTypeExceptionForGetOfAnArrayInsteadOfElement

+
+public void shouldThrowIncompatibleTypeExceptionForGetOfAnArrayInsteadOfElement()
+                                                                         throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldNotThrowIncompatibleTypeExceptionForGetsOfProperTypes

+
+public void shouldNotThrowIncompatibleTypeExceptionForGetsOfProperTypes()
+                                                                 throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldCopyRegionLeftInArray

+
+public void shouldCopyRegionLeftInArray()
+                                 throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldCopyRegionRightInArray

+
+public void shouldCopyRegionRightInArray()
+                                  throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldFailToConstructDirectly

+
+public void shouldFailToConstructDirectly()
+                                   throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+accessArrayElementValue

+
+public long accessArrayElementValue(StructuredArrayOfAtomicLong array,
+                                    long index)
+
+
+
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/StructuredArrayOfPoint.html b/JavaDoc/StructuredArrayOfPoint.html new file mode 100644 index 0000000..e9b3f62 --- /dev/null +++ b/JavaDoc/StructuredArrayOfPoint.html @@ -0,0 +1,413 @@ + + + + + + +StructuredArrayOfPoint + + + + + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ +

+Class StructuredArrayOfPoint

+
+java.lang.Object
+  extended by org.ObjectLayout.StructuredArray<java.awt.Point>
+      extended by StructuredArrayOfPoint
+
+
+
All Implemented Interfaces:
java.lang.Iterable<java.awt.Point>
+
+
+
+
public class StructuredArrayOfPoint
extends StructuredArray<java.awt.Point>
+ + +

+


+ +

+ + + + + + + +
+Nested Class Summary
+ + + + + + + +
Nested classes/interfaces inherited from class org.ObjectLayout.StructuredArray
StructuredArray.StructureIterator
+  + + + + + + + + + + + +
+Constructor Summary
StructuredArrayOfPoint() + +
+           
+  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+Method Summary
+ StructuredArrayOfPointgetSubArray(int index) + +
+          Get a reference to a StructuredArray element in this array, using a int index.
+static StructuredArrayOfPointnewInstance(CtorAndArgsProvider<java.awt.Point> ctorAndArgsProvider, + long... lengths) + +
+           
+static StructuredArrayOfPointnewInstance(CtorAndArgsProvider<java.awt.Point> ctorAndArgsProvider, + long length) + +
+           
+static StructuredArrayOfPointnewInstance(long... lengths) + +
+           
+static StructuredArrayOfPointnewInstance(long length) + +
+           
+static StructuredArrayOfPointnewInstance(long[] lengths, + java.lang.Class[] elementConstructorArgTypes, + java.lang.Object... elementConstructorArgs) + +
+           
+static StructuredArrayOfPointnewInstance(long length, + long initialElementValue) + +
+           
+ + + + + + + +
Methods inherited from class org.ObjectLayout.StructuredArray
copyInstance, copyInstance, get, get, get, get, get, get, get, get, get, get, getDimensionCount, getElementClass, getLength, getLengths, getSubArray, getTotalElementCount, iterator, newInstance, newInstance, newInstance, newInstance, newInstance, newInstance, newSubclassInstance, newSubclassInstance, newSubclassInstance, newSubclassInstance, newSubclassInstance, newSubclassInstance, newSubclassInstance, newSubclassInstance, newSubclassInstance, newSubclassInstance, newSubclassInstance, newSubclassInstance, shallowCopy, shallowCopy
+ + + + + + + +
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
+  +

+ + + + + + + + +
+Constructor Detail
+ +

+StructuredArrayOfPoint

+
+public StructuredArrayOfPoint()
+
+
+ + + + + + + + +
+Method Detail
+ +

+newInstance

+
+public static StructuredArrayOfPoint newInstance(long length)
+
+
+
+
+
+
+ +

+newInstance

+
+public static StructuredArrayOfPoint newInstance(long length,
+                                                 long initialElementValue)
+
+
+
+
+
+
+ +

+newInstance

+
+public static StructuredArrayOfPoint newInstance(CtorAndArgsProvider<java.awt.Point> ctorAndArgsProvider,
+                                                 long length)
+
+
+
+
+
+
+ +

+newInstance

+
+public static StructuredArrayOfPoint newInstance(long... lengths)
+
+
+
+
+
+
+ +

+newInstance

+
+public static StructuredArrayOfPoint newInstance(long[] lengths,
+                                                 java.lang.Class[] elementConstructorArgTypes,
+                                                 java.lang.Object... elementConstructorArgs)
+
+
+
+
+
+
+ +

+newInstance

+
+public static StructuredArrayOfPoint newInstance(CtorAndArgsProvider<java.awt.Point> ctorAndArgsProvider,
+                                                 long... lengths)
+
+
+
+
+
+
+ +

+getSubArray

+
+public StructuredArrayOfPoint getSubArray(int index)
+                                   throws java.lang.IllegalArgumentException
+
+
Description copied from class: StructuredArray
+
Get a reference to a StructuredArray element in this array, using a int index. +

+

+
Overrides:
getSubArray in class StructuredArray<java.awt.Point>
+
+
+
Parameters:
index - (in this array's first dimension) of the StructuredArray to retrieve +
Returns:
a reference to the StructuredArray located at [index] in the first dimension of this array +
Throws: +
java.lang.IllegalArgumentException - if array has less than two dimensions
+
+
+ +
+ + + + + + + + + + + + + + + + + + + +
+ +
+ + + +
+ + + diff --git a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.html b/JavaDoc/StructuredArrayOfPointTest.html similarity index 61% rename from JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.html rename to JavaDoc/StructuredArrayOfPointTest.html index fc2ad52..04fe36c 100644 --- a/JavaDoc/org/ObjectLayout/MultiDimensionalStructuredArrayTest.html +++ b/JavaDoc/StructuredArrayOfPointTest.html @@ -2,20 +2,20 @@ - + -MultiDimensionalStructuredArrayTest +StructuredArrayOfPointTest - + - + @@ -37,12 +37,13 @@ - + + - - - + + +
@@ -53,20 +54,20 @@ PREV CLASS  - NEXT CLASSPREV CLASS  + NEXT CLASS - FRAMES   - NO FRAMES   + FRAMES   + NO FRAMES     @@ -74,7 +75,7 @@ - SUMMARY: NESTED | FIELD | CONSTR | METHOD + SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD @@ -85,49 +86,21 @@

- -org.ObjectLayout -
-Class MultiDimensionalStructuredArrayTest

+Class StructuredArrayOfPointTest

 java.lang.Object
-  extended by org.ObjectLayout.MultiDimensionalStructuredArrayTest
+  extended by StructuredArrayOfPointTest
 

-
public class MultiDimensionalStructuredArrayTest
extends java.lang.Object
+
public class StructuredArrayOfPointTest
extends java.lang.Object


- - - - - - - - - - - - - - - -
-Nested Class Summary
-static classMultiDimensionalStructuredArrayTest.MockStructure -
-           
-static classMultiDimensionalStructuredArrayTest.MockStructureWithFinalField - -
-           
@@ -137,7 +110,7 @@

Constructor Summary -MultiDimensionalStructuredArrayTest() +StructuredArrayOfPointTest()
            @@ -155,7 +128,7 @@

 void -shouldConstructArrayElementsViaElementConstructorGenerator() +shouldConstructArrayElementsViaElementConstructorGenerator()
            @@ -163,7 +136,7 @@

 void -shouldConstructArrayOfGivenDirectLengths() +shouldConstructArrayOfGivenDirectLengths()
            @@ -171,7 +144,7 @@

 void -shouldConstructArrayOfGivenLengthAndInitValues() +shouldConstructArrayOfGivenLengthAndInitValues()
            @@ -179,7 +152,7 @@

 void -shouldConstructArrayOfGivenLengthsLongArray() +shouldConstructArrayOfGivenLengthsPrimitiveLongArray()
            @@ -187,7 +160,7 @@

 void -shouldConstructArrayOfGivenLengthsPrimitiveLongArray() +shouldConstructCopyOfArray()
            @@ -195,7 +168,7 @@

 void -shouldConstructCopyOfArray() +shouldConstructCopyOfArrayRange()
            @@ -203,7 +176,7 @@

 void -shouldConstructCopyOfArrayRange() +shouldCopyRegionLeftInArray()
            @@ -211,7 +184,7 @@

 void -shouldIterateOverArray() +shouldCopyRegionRightInArray()
            @@ -219,7 +192,7 @@

 void -shouldIterateOverArrayAndResetAgain() +shouldFailToConstructDirectly()
            @@ -227,7 +200,7 @@

 void -shouldSetAndGetCorrectValueAtGivenIndex() +shouldIterateOverArray()
            @@ -235,7 +208,7 @@

 void -shouldThrowIncompatibleTypeExceptionForGetOfAnArrayInsteadOfElement() +shouldIterateOverArrayAndResetAgain()
            @@ -243,7 +216,7 @@

 void -shouldThrowIncompatibleTypeExceptionForGetOfWrongMultiDimensionalStructuredArrayType() +shouldNotThrowIncompatibleTypeExceptionForGetsOfProperTypes()
            @@ -251,7 +224,7 @@

 void -shouldThrowIncompatibleTypeExceptionForGetOfWrongStructuredArrayType() +shouldSetAndGetCorrectValueAtGivenIndex()
            @@ -259,7 +232,23 @@

 void -shouldThrowOutOfBoundExceptionForAccessesOutOfBounds() +shouldThrowIncompatibleTypeExceptionForGetOfAnArrayInsteadOfElement() + +
+            + + + + void +shouldThrowIncompatibleTypeExceptionForGetOfAnElementInsteadOfArray() + +
+            + + + + void +shouldThrowOutOfBoundExceptionForAccessesOutOfBounds()
            @@ -287,10 +276,10 @@

-

-MultiDimensionalStructuredArrayTest

+

+StructuredArrayOfPointTest

-public MultiDimensionalStructuredArrayTest()
+public StructuredArrayOfPointTest()
@@ -318,20 +307,6 @@


-

-shouldConstructArrayOfGivenLengthsLongArray

-
-public void shouldConstructArrayOfGivenLengthsLongArray()
-                                                 throws java.lang.NoSuchMethodException
-
-
- -
Throws: -
java.lang.NoSuchMethodException
-
-
-
-

shouldConstructArrayOfGivenLengthsPrimitiveLongArray

@@ -458,6 +433,20 @@ 


+

+shouldThrowIncompatibleTypeExceptionForGetOfAnElementInsteadOfArray

+
+public void shouldThrowIncompatibleTypeExceptionForGetOfAnElementInsteadOfArray()
+                                                                         throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+

shouldThrowIncompatibleTypeExceptionForGetOfAnArrayInsteadOfElement

@@ -472,11 +461,39 @@ 


-

-shouldThrowIncompatibleTypeExceptionForGetOfWrongStructuredArrayType

+

+shouldNotThrowIncompatibleTypeExceptionForGetsOfProperTypes

+
+public void shouldNotThrowIncompatibleTypeExceptionForGetsOfProperTypes()
+                                                                 throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldCopyRegionLeftInArray

+
+public void shouldCopyRegionLeftInArray()
+                                 throws java.lang.NoSuchMethodException
+
+
+ +
Throws: +
java.lang.NoSuchMethodException
+
+
+
+ +

+shouldCopyRegionRightInArray

-public void shouldThrowIncompatibleTypeExceptionForGetOfWrongStructuredArrayType()
-                                                                          throws java.lang.NoSuchMethodException
+public void shouldCopyRegionRightInArray() + throws java.lang.NoSuchMethodException
@@ -486,11 +503,11 @@


-

-shouldThrowIncompatibleTypeExceptionForGetOfWrongMultiDimensionalStructuredArrayType

+

+shouldFailToConstructDirectly

-public void shouldThrowIncompatibleTypeExceptionForGetOfWrongMultiDimensionalStructuredArrayType()
-                                                                                          throws java.lang.NoSuchMethodException
+public void shouldFailToConstructDirectly() + throws java.lang.NoSuchMethodException
@@ -511,12 +528,13 @@

- + + - - - + + +
@@ -527,20 +545,20 @@

PREV CLASS  - NEXT CLASSPREV CLASS  + NEXT CLASS - FRAMES   - NO FRAMES   + FRAMES   + NO FRAMES     @@ -548,7 +566,7 @@

- SUMMARY: NESTED | FIELD | CONSTR | METHOD + SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD diff --git a/JavaDoc/allclasses-frame.html b/JavaDoc/allclasses-frame.html index ca535a4..d3b14c8 100644 --- a/JavaDoc/allclasses-frame.html +++ b/JavaDoc/allclasses-frame.html @@ -2,12 +2,12 @@ - + All Classes - + @@ -29,10 +29,34 @@
CtorAndArgsProvider
+IntrinsifiedObjects +
SingletonCtorAndArgsProvider
StructuredArray
+StructuredArrayOfAtomicLong +
+StructuredArrayOfAtomicLongTest +
+StructuredArrayOfPoint +
+StructuredArrayOfPointTest +
+StructuredArrayPerfTest +
+StructuredArrayPerfTest.MockStructure +
+StructuredArrayPerfTest.MockStructureWithFinalField +
+StructuredArrayPerfTest.StructuredArrayOfMockStructure +
+StructuredArrayTest +
+StructuredArrayTest.MockStructure +
+StructuredArrayTest.MockStructureWithFinalField +
diff --git a/JavaDoc/allclasses-noframe.html b/JavaDoc/allclasses-noframe.html index 5dbb208..4ff5957 100644 --- a/JavaDoc/allclasses-noframe.html +++ b/JavaDoc/allclasses-noframe.html @@ -2,12 +2,12 @@ - + All Classes - + @@ -29,10 +29,34 @@
CtorAndArgsProvider
+IntrinsifiedObjects +
SingletonCtorAndArgsProvider
StructuredArray
+StructuredArrayOfAtomicLong +
+StructuredArrayOfAtomicLongTest +
+StructuredArrayOfPoint +
+StructuredArrayOfPointTest +
+StructuredArrayPerfTest +
+StructuredArrayPerfTest.MockStructure +
+StructuredArrayPerfTest.MockStructureWithFinalField +
+StructuredArrayPerfTest.StructuredArrayOfMockStructure +
+StructuredArrayTest +
+StructuredArrayTest.MockStructure +
+StructuredArrayTest.MockStructureWithFinalField +
diff --git a/JavaDoc/constant-values.html b/JavaDoc/constant-values.html index 2a23565..d768c20 100644 --- a/JavaDoc/constant-values.html +++ b/JavaDoc/constant-values.html @@ -2,12 +2,12 @@ - + Constant Field Values - + @@ -37,9 +37,10 @@ - + + - + @@ -97,9 +98,10 @@

- + + - + diff --git a/JavaDoc/deprecated-list.html b/JavaDoc/deprecated-list.html index 34801a4..b569c32 100644 --- a/JavaDoc/deprecated-list.html +++ b/JavaDoc/deprecated-list.html @@ -2,12 +2,12 @@ - + Deprecated List - + @@ -37,9 +37,10 @@
- + + - + @@ -97,9 +98,10 @@

- + + - + diff --git a/JavaDoc/help-doc.html b/JavaDoc/help-doc.html index 79f6683..86491c5 100644 --- a/JavaDoc/help-doc.html +++ b/JavaDoc/help-doc.html @@ -2,12 +2,12 @@ - + API Help - + @@ -37,9 +37,10 @@
- + + - + @@ -82,6 +83,12 @@

How This API Document Is Organized

This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.

+Overview

+
+ +

+The Overview page is the front page of this API document and provides a list of all packages with a summary for each. This page can also contain an overall description of the set of packages.

+

Package

@@ -164,9 +171,10 @@

- + + - + diff --git a/JavaDoc/index-files/index-1.html b/JavaDoc/index-files/index-1.html index c24dd87..a06fd40 100644 --- a/JavaDoc/index-files/index-1.html +++ b/JavaDoc/index-files/index-1.html @@ -2,12 +2,12 @@ - + A-Index - + @@ -37,9 +37,10 @@
- + + - + @@ -76,10 +77,13 @@ -ACGHINORS
+ACEGHIMNORST

A

+
accessArrayElementValue(StructuredArrayOfAtomicLong, long) - +Method in class StructuredArrayOfAtomicLongTest +
 
ArrayCtorAndArgsProvider<T> - Class in org.ObjectLayout
Supports the construction of a new array's individual elements using a copy constructor to copy a source array's corresponding elements.
ArrayCtorAndArgsProvider(Constructor<T>, Object[], int) - Constructor for class org.ObjectLayout.ArrayCtorAndArgsProvider @@ -100,9 +104,10 @@
- + + - + @@ -139,7 +144,7 @@ -ACGHINORS
+ACEGHIMNORST
diff --git a/JavaDoc/index-files/index-10.html b/JavaDoc/index-files/index-10.html index cfaa9de..7445cbc 100644 --- a/JavaDoc/index-files/index-10.html +++ b/JavaDoc/index-files/index-10.html @@ -2,12 +2,12 @@ - + R-Index - + @@ -37,9 +37,10 @@
- + + - + @@ -76,42 +77,23 @@ -ACFGHIMNORS
+ACEGHIMNORST

R

-
recycle(ConstructorAndArgs) - -Method in class org.ObjectLayout.ArrayConstructorAndArgsLocator -
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired). -
recycle(ConstructorAndArgs) - -Method in class org.ObjectLayout.ConstructorAndArgsLocator -
Recycle a ConstructorAndArgs instance (place it back in the internal cache if desired). -
recycle(ConstructorAndArgs) - -Method in class org.ObjectLayout.CopyConstructorAndArgsLocator -
Recycle an ConstructorAndArgs instance (place it back in the internal cache if +
recycle(CtorAndArgs) - +Method in class org.ObjectLayout.ArrayCtorAndArgsProvider +
Recycle an CtorAndArgs instance (place it back in the internal cache if desired). +
recycle(CtorAndArgs) - +Method in class org.ObjectLayout.CopyCtorAndArgsProvider +
Recycle an CtorAndArgs instance (place it back in the internal cache if desired). -
recycle(ConstructorAndArgs) - -Method in class org.ObjectLayout.MultiDimensionalCopyConstructorAndArgsLocator -
Recycle an ConstructorAndArgs instance (place it back in the internal cache if - desired). -
recycle(ConstructorAndArgs) - -Method in class org.ObjectLayout.SingleDimensionalCopyConstructorAndArgsLocator -
Recycle an ConstructorAndArgs instance (place it back in the internal cache if desired). -
remove() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator -
Remove operation is not supported on MultiDimensionalStructuredArrays. -
remove() - -Method in class org.ObjectLayout.SingleDimensionalStructuredArray.StructureIterator -
Remove operation is not supported on SingleDimensionalStructuredArrays. +
recycle(CtorAndArgs) - +Method in class org.ObjectLayout.CtorAndArgsProvider +
Recycle a CtorAndArgs instance (place it back in the internal cache if desired).
remove() - Method in class org.ObjectLayout.StructuredArray.StructureIterator
Remove operation is not supported on StructuredArrays. -
reset() - -Method in class org.ObjectLayout.MultiDimensionalStructuredArray.StructureIterator -
Reset to the beginning of the collection enabling reuse of the iterator. -
reset() - -Method in class org.ObjectLayout.SingleDimensionalStructuredArray.StructureIterator -
Reset to the beginning of the collection enabling reuse of the iterator.
reset() - Method in class org.ObjectLayout.StructuredArray.StructureIterator
Reset to the beginning of the collection enabling reuse of the iterator. @@ -128,9 +110,10 @@
- + + - + @@ -167,7 +150,7 @@ -ACFGHIMNORS
+ACEGHIMNORST
diff --git a/JavaDoc/index-files/index-11.html b/JavaDoc/index-files/index-11.html index 2a4d244..74329d7 100644 --- a/JavaDoc/index-files/index-11.html +++ b/JavaDoc/index-files/index-11.html @@ -2,12 +2,12 @@ - + S-Index - + @@ -37,9 +37,10 @@
- + + - + @@ -54,7 +55,7 @@ + NEXT LETTER - +
Constructor and Description
CtorAndArgsProvider(java.lang.Class<T> elementClass) -
Used to apply a fixed constructor with a given set of arguments to all element.
-
CtorAndArgsProvider() 
@@ -145,26 +153,20 @@

Method Summary

Method and Description -java.lang.Class<T> -getElementClass() -
Get the Class of the elements to be constructed
- - - CtorAndArgs<T> getForIndex(long... index)
Get a CtorAndArgs instance to be used in constructing a given element index in a StructuredArray
- + CtorAndArgs<T> getForIndex(long index)
Get a CtorAndArgs instance to be used in constructing a given element index in a StructuredArray
- + void recycle(CtorAndArgs<T> ctorAndArgs)
Recycle a CtorAndArgs instance (place it back in the internal cache if desired).
@@ -192,19 +194,13 @@

Methods inherited from class java.lang.Object

Constructor Detail

- +
  • CtorAndArgsProvider

    -
    public CtorAndArgsProvider(java.lang.Class<T> elementClass)
    -                    throws java.lang.NoSuchMethodException
    -
    Used to apply a fixed constructor with a given set of arguments to all element.
    -
    Parameters:
    elementClass - The element class
    -
    Throws:
    -
    java.lang.NoSuchMethodException - if a constructor matching defaultArgTypes
    -
    java.lang.IllegalArgumentException - if argTypes and args conflict
    +
    public CtorAndArgsProvider()
@@ -225,7 +221,10 @@

getForIndex

throws java.lang.NoSuchMethodException
Get a CtorAndArgs instance to be used in constructing a given element index in a StructuredArray
-
Parameters:
index - The index of the element to be constructed in the target array.
+
+
Specified by:
+
getForIndex in interface SingleDimensionalCtorAndArgsProvider<T>
+
Parameters:
index - The index of the element to be constructed in the target array.
Returns:
CtorAndArgs instance to used in element construction
Throws:
java.lang.NoSuchMethodException - if expected constructor is not found in element class
@@ -241,7 +240,10 @@

getForIndex

throws java.lang.NoSuchMethodException
Get a CtorAndArgs instance to be used in constructing a given element index in a StructuredArray
-
Parameters:
index - The index of the element to be constructed in the target array (one value per dimension).
+
+
Specified by:
+
getForIndex in interface MultiDimensionalCtorAndArgsProvider<T>
+
Parameters:
index - The index of the element to be constructed in the target array (one value per dimension).
Returns:
CtorAndArgs instance to used in element construction
Throws:
java.lang.NoSuchMethodException - if expected constructor is not found in element class
@@ -250,7 +252,7 @@

getForIndex

-
    +
    • recycle

      public void recycle(CtorAndArgs<T> ctorAndArgs)
      @@ -264,17 +266,6 @@

      recycle

      Parameters:
      ctorAndArgs - the CtorAndArgs instance to recycle
    - - - -
      -
    • -

      getElementClass

      -
      public java.lang.Class<T> getElementClass()
      -
      Get the Class of the elements to be constructed
      -
      Returns:
      Class of elements to be constructed
      -
    • -
@@ -300,7 +291,7 @@

getElementClass

+ + @@ -249,7 +250,7 @@

createIntrinsicObject

- +
  • newSubclassInstance

    public static <T,S extends StructuredArray<T>> S newSubclassInstance(java.lang.Class<S> arrayClass,
    -                                                     CtorAndArgsProvider<T> ctorAndArgsProvider,
    +                                                     java.lang.Class<T> elementClass,
    +                                                     SingleDimensionalCtorAndArgsProvider<T> ctorAndArgsProvider,
                                                          long length)
    Create an arrayClass array of length elements, each containing an element object of type elementClass. Use constructor and arguments supplied (on a potentially @@ -593,14 +598,15 @@

    newSubclassInstance

    Parameters:
    arrayClass - of the array to create.
    length - of the array to create.
    ctorAndArgsProvider - produces element constructors [potentially] on a per element basis.
- +
  • newSubclassInstance

    public static <T,S extends StructuredArray<T>> S newSubclassInstance(CtorAndArgs<S> arrayCtorAndArgs,
    -                                                     CtorAndArgsProvider<T> ctorAndArgsProvider,
    +                                                     java.lang.Class<T> elementClass,
    +                                                     SingleDimensionalCtorAndArgsProvider<T> ctorAndArgsProvider,
                                                          long length)
    Create an arrayCtorAndArgs.getConstructor().getDeclaringClass() array of length elements of type elementClass. Use constructor and arguments @@ -779,14 +785,14 @@

    newSubclassInstance

    java.lang.IllegalArgumentException - if elementConstructorArgTypes and constructor arguments do not match in length
- +
  • newInstance

    public static <T> StructuredArray<T> newInstance(java.lang.Class<T> elementClass,
    -                                 CtorAndArgsProvider<T> ctorAndArgsProvider,
    +                                 MultiDimensionalCtorAndArgsProvider<T> ctorAndArgsProvider,
                                      long... lengths)
                                           throws java.lang.NoSuchMethodException
    Create a multi dimensional array of elements of type elementClass. Each dimension of the array @@ -798,14 +804,15 @@

    newInstance

    java.lang.NoSuchMethodException - if the element class does not not support a supplied constructor
- +
  • newSubclassInstance

    public static <T,S extends StructuredArray<T>> S newSubclassInstance(java.lang.Class<S> arrayClass,
    -                                                     CtorAndArgsProvider<T> ctorAndArgsProvider,
    +                                                     java.lang.Class<T> elementClass,
    +                                                     MultiDimensionalCtorAndArgsProvider<T> ctorAndArgsProvider,
                                                          long... lengths)
    Create a multi dimensional arrayClass array of elements of type elementClass. Each dimension of the array will be of a length designated in the lengths[] passed. Elements @@ -814,14 +821,15 @@

    newSubclassInstance

    Parameters:
    arrayClass - of the array to create.
    ctorAndArgsProvider - produces element constructors [potentially] on a per element basis.
    lengths - of the array dimensions to create.
- +
- + + +
  • shallowCopy

    -
    public static void shallowCopy(StructuredArray src,
    -               long srcOffset,
    -               StructuredArray dst,
    -               long dstOffset,
    -               long count)
    +
    public static <S extends StructuredArray<T>,T> void shallowCopy(S src,
    +                                                long srcOffset,
    +                                                S dst,
    +                                                long dstOffset,
    +                                                long count)
    Shallow copy a region of element object contents from one array to the other.

    shallowCopy will copy all fields from each of the source elements to the corresponding fields in each of the corresponding destination elements. If the same array is both the src and dst then the copy will happen as if a temporary intermediate array was used.

    -
    Parameters:
    src - array to copy.
    srcOffset - offset index in src where the region begins.
    dst - array into which the copy should occur.
    dstOffset - offset index in the dst where the region begins.
    count - of structure elements to copy.
    +
    Type Parameters:
    S - The class of the arrays
    T - The class of the array elements
    Parameters:
    src - array to copy
    srcOffset - offset index in src where the region begins
    dst - array into which the copy should occur
    dstOffset - offset index in the dst where the region begins
    count - of structure elements to copy
    Throws:
    -
    java.lang.IllegalStateException - if final fields are discovered.
    -
    java.lang.ArrayStoreException - if the element classes in src and dst are not identical.
    +
    java.lang.IllegalArgumentException - if the source and destination array element types are not identical, or if + the source or destination arrays have nested StructuredArrays within them, or if final fields are discovered + and all allowFinalFieldOverwrite is not true.
- + + +
  • shallowCopy

    -
    public static void shallowCopy(StructuredArray src,
    -               long srcOffset,
    -               StructuredArray dst,
    -               long dstOffset,
    -               long count,
    -               boolean allowFinalFieldOverwrite)
    +
    public static <S extends StructuredArray<T>,T> void shallowCopy(S src,
    +                                                long srcOffset,
    +                                                S dst,
    +                                                long dstOffset,
    +                                                long count,
    +                                                boolean allowFinalFieldOverwrite)
    Shallow copy a region of element object contents from one array to the other.

    shallowCopy will copy all fields from each of the source elements to the corresponding fields in each @@ -1143,11 +691,11 @@

    shallowCopy

    happen as if a temporary intermediate array was used. If allowFinalFieldOverwrite is specified as true, even final fields will be copied.
    -
    Parameters:
    src - array to copy.
    srcOffset - offset index in src where the region begins.
    dst - array into which the copy should occur.
    dstOffset - offset index in the dst where the region begins.
    count - of structure elements to copy.
    allowFinalFieldOverwrite - allow final fields to be overwritten during a copy operation.
    +
    Type Parameters:
    S - The class of the arrays
    T - The class of the array elements
    Parameters:
    src - array to copy
    srcOffset - offset index in src where the region begins
    dst - array into which the copy should occur
    dstOffset - offset index in the dst where the region begins
    count - of structure elements to copy.
    allowFinalFieldOverwrite - allow final fields to be overwritten during a copy operation.
    Throws:
    -
    java.lang.IllegalArgumentException - if source or destination arrays have more than one dimension, or - if final fields are discovered and all allowFinalFieldOverwrite is not true.
    -
    java.lang.ArrayStoreException - if the element classes in src and dst are not identical.
    +
    java.lang.IllegalArgumentException - if the source and destination array element types are not identical, or if + the source or destination arrays have nested StructuredArrays within them, or if final fields are discovered + and all allowFinalFieldOverwrite is not true.
@@ -1164,7 +712,8 @@

shallowCopy

@@ -213,15 +226,26 @@

getArray

  • getContainingContext

    public ConstructionContext<StructuredArray<T>> getContainingContext()
    +
    Get the containing context. The containing context will be non-null if the array this context + relates to is nested in another StructuredArray.
    +
    Returns:
    the containing context
  • - +
    • -

      getCookie

      -
      public java.lang.Object getCookie()
      +

      getContextCookie

      +
      public java.lang.Object getContextCookie()
      +
      Get the construction context cookie object.The construction context cookie of the outermost + array is taken from the (optionally supplied) StructuredArrayBuilder used in instantiating + the array (via StructuredArrayBuilder.getContextCookie()). The + construction context cookie for nested arrays (if those exist) is taken from the CtorAndArgs + used to construct the nested array, such that a CtorAndArgsProvider can receive + and propagate an appropriate contextCookie. A good example of context cookie in use can be found in the + implementation of CopyCtorAndArgsProvider.
      +
      Returns:
      the construction context cookie
    @@ -238,8 +262,7 @@

    getCookie

    @@ -256,11 +268,11 @@

    getForContext

  • recycle

    public void recycle(CtorAndArgs<T> ctorAndArgs)
    -
    Recycle an CtorAndArgs instance (place it back in the internal cache if - desired). This is [very] useful for avoiding a re-allocation of a new CtorAndArgs - and an associated args array for getForContext(ConstructionContext) invocation in - cases such as this (where the returned CtorAndArgs is not constant across indices). - Recycling is optional, and is not guaranteed to occur.
    +
    Recycle a CtorAndArgs instance (place it back in the internal cache if + it's model is appropriate). This is [very] useful for avoiding a re-allocation of a + new CtorAndArgs and an associated args array for each getForContext(ConstructionContext) + invocation in cases such as this, where the returned CtorAndArgs is not constant across indices, + but where a cached instance can be mutated to fit the purpose. Recycling is not guaranteed to occur.
    Overrides:
    recycle in class AbstractCtorAndArgsProvider<T>
    @@ -281,8 +293,7 @@

    recycle

    @@ -322,8 +321,7 @@

    setContextCookie

    @@ -227,6 +272,8 @@

    get

    set

    public void set(int index,
            byte value)
    +
    set the value of an element in the array.
    +
    Parameters:
    index - the index of the element to set
    value - the value to assign to the element
  • @@ -252,8 +299,7 @@

    newInstance

    @@ -252,8 +299,7 @@

    newInstance

    @@ -227,6 +272,8 @@

    get

    set

    public void set(int index,
            double value)
    +
    set the value of an element in the array.
    +
    Parameters:
    index - the index of the element to set
    value - the value to assign to the element
    @@ -252,8 +299,7 @@

    newInstance

    @@ -252,8 +299,7 @@

    newInstance

    @@ -227,6 +272,8 @@

    get

    set

    public void set(int index,
            int value)
    +
    set the value of an element in the array.
    +
    Parameters:
    index - the index of the element to set
    value - the value to assign to the element
    @@ -252,8 +299,7 @@

    newInstance

    @@ -227,6 +274,8 @@

    get

    set

    public void set(int index,
            long value)
    +
    set the value of an element in the array.
    +
    Parameters:
    index - the index of the element to set
    value - the value to assign to the element
    @@ -236,6 +285,9 @@

    set

  • newInstance

    public static PrimitiveLongArray newInstance(int length)
    +
    Create a new instance of PrimitiveLongArray with a given length.
    +
    Parameters:
    length - the length of the array.
    +
    Returns:
    a new instance of PrimitiveLongArray with the given length
  • @@ -252,8 +304,7 @@

    newInstance

    @@ -252,8 +299,7 @@

    newInstance

    @@ -238,6 +288,9 @@

    set

  • newInstance

    public static <T> ReferenceArray<T> newInstance(int length)
    +
    Create a new instance of ReferenceArray with a given length.
    +
    Type Parameters:
    T - the reference type
    Parameters:
    length - the length of the array
    +
    Returns:
    A newly created ReferenceArray
  • @@ -254,8 +307,7 @@

    newInstance

    @@ -191,12 +194,22 @@

    Constructor Detail

    -
      +
      • StructuredArray.ElementIterator

        public StructuredArray.ElementIterator()
      + + + +
        +
      • +

        StructuredArray.ElementIterator

        +
        public StructuredArray.ElementIterator(long offset,
        +                               long length)
        +
      • +
    @@ -279,8 +292,7 @@

    getCursor

    +
      +
    • +

      StructuredArrayBuilder

      +
      public StructuredArrayBuilder(java.lang.Class<S> arrayClass,
      +                      StructuredArrayBuilder subArrayBuilder,
      +                      long length)
      +
      Constructs a new StructuredArrayBuilder object for creating an array of type S with + elements of type T, and the given length. Used when T extends StructuredArray, such that the + arrays instantiated by this builder would include nested StructuredArrays.
      +
      Parameters:
      arrayClass - The class of the array to be built by this builder
      subArrayBuilder - The builder used for creating individual array elements (which are themselves + StructuredArrays)
      length - The length of the array to be build by this builder
      +
    • +
    + + +
    • StructuredArrayBuilder

      public StructuredArrayBuilder(java.lang.Class<S> arrayClass,
      -                      StructuredArrayBuilder<A2,T2> subArrayBuilder,
      +                      PrimitiveArrayBuilder subArrayBuilder,
                             long length)
      +
      Constructs a new StructuredArrayBuilder object for creating an array of type S with + elements of type T, and the given length. Used when T extends PrimitiveArray, such that the + arrays instantiated by this builder would include elements that are PrimitiveArrays.
      +
      Parameters:
      arrayClass - The class of the array to be built by this builder
      subArrayBuilder - The builder used for creating individual array elements (which are themselves + subclassable PrimitiveArrays)
      length - The length of the array to be build by this builder
    @@ -258,6 +402,16 @@

    Method Detail

  • elementCtorAndArgsProvider

    public StructuredArrayBuilder<S,T> elementCtorAndArgsProvider(CtorAndArgsProvider<T> ctorAndArgsProvider)
    +
    Set the CtorAndArgsProvider used for determining the constructor and construction + arguments used for each element in the array. The provider may use the specific element's + construction context in determining the construction parameters. + + Note: This method overlaps in purpose with the alternate methods for controlling element + construction. Namely elementCtorAndArgs(CtorAndArgs) and + elementCtorAndArgs(Constructor, Object...).
    +
    Parameters:
    ctorAndArgsProvider - The provider used for determining the constructor and construction + arguments used for each element in instantiated arrays
    +
    Returns:
    The builder
  • @@ -267,6 +421,14 @@

    elementCtorAndArgsProvider

  • elementCtorAndArgs

    public StructuredArrayBuilder<S,T> elementCtorAndArgs(CtorAndArgs<T> ctorAndArgs)
    +
    Set the CtorAndArgs to be used for all elements in the array. All elements will be constructed with + the same constructor and the same arguments. + + Note: This method overlaps in purpose with the alternate methods for controlling element + construction. Namely elementCtorAndArgsProvider(CtorAndArgsProvider) and + elementCtorAndArgs(Constructor, Object...).
    +
    Parameters:
    ctorAndArgs - The constructor and arguments used for all elements in arrays
    +
    Returns:
    The builder
  • @@ -277,6 +439,14 @@

    elementCtorAndArgs

    elementCtorAndArgs

    public StructuredArrayBuilder<S,T> elementCtorAndArgs(java.lang.reflect.Constructor<T> constructor,
                                                  java.lang.Object... args)
    +
    Set the Constructor and construction arguments to be used for all elements in the array. + All elements will be constructed with the same constructor and the same arguments. + + Note: This method overlaps in purpose with the alternate methods for controlling element + construction. Namely elementCtorAndArgsProvider(CtorAndArgsProvider) and + elementCtorAndArgs(CtorAndArgs).
    +
    Parameters:
    constructor - The constructor used for all elements in arrays
    args - The construction arguments supplied for the constructor, used for all elements in the array
    +
    Returns:
    The builder
    @@ -286,6 +456,11 @@

    elementCtorAndArgs

  • arrayCtorAndArgs

    public StructuredArrayBuilder<S,T> arrayCtorAndArgs(CtorAndArgs<S> arrayCtorAndArgs)
    +
    Set the CtorAndArgs to be used in constructing arrays. + Setting the means for array construction is Required if the array class (S) does not support a + default constructor, or if a non-default construction of the array instance is needed.
    +
    Parameters:
    arrayCtorAndArgs - The constructor and arguments used for constructing arrays
    +
    Returns:
    The builder
  • @@ -296,6 +471,11 @@

    arrayCtorAndArgs

    arrayCtorAndArgs

    public StructuredArrayBuilder<S,T> arrayCtorAndArgs(java.lang.reflect.Constructor<S> constructor,
                                                java.lang.Object... args)
    +
    Set the Constructor and construction arguments to be used in constructing arrays. + Setting the means for array construction is Required if the array class (S) does not support a + default constructor, or if a non-default construction of the array instance is needed.
    +
    Parameters:
    constructor - The constructor used for constructing arrays
    args - The construction arguments supplied for the constructor
    +
    Returns:
    The builder
    @@ -305,18 +485,11 @@

    arrayCtorAndArgs

  • contextCookie

    public StructuredArrayBuilder<S,T> contextCookie(java.lang.Object contextCookie)
    -
  • - - - - -
      -
    • -

      resolve

      -
      public StructuredArrayBuilder<S,T> resolve(boolean resolveArrayCtorAndArgs)
      -                                                               throws java.lang.NoSuchMethodException
      -
      Throws:
      -
      java.lang.NoSuchMethodException
      +
      Set the (opaque) contextCookie object associated with this builder. This contextCookie object will be + set in ConstructionContext object passed to the element + CtorAndArgsProvider provider for each element in instantiated arrays.
      +
      Parameters:
      contextCookie - the contextCookie object
      +
      Returns:
      The builder
    @@ -327,8 +500,13 @@

    resolve

    resolve

    public StructuredArrayBuilder<S,T> resolve()
                                                                    throws java.lang.NoSuchMethodException
    -
    Throws:
    -
    java.lang.NoSuchMethodException
    +
    Resolve any not-yet-resolved constructor information needed by this builder. Calling resolve() is not + necessary ahead of building, but it is useful for ensuring resolution works ahead of actual building + attempts.
    +
    Returns:
    This builder
    +
    Throws:
    +
    java.lang.NoSuchMethodException - if the array constructor or element constructor fail to resolve given + the current information in the builder
    @@ -339,8 +517,11 @@

    resolve

    build

    public S build()
                                        throws java.lang.NoSuchMethodException
    -
    Throws:
    -
    java.lang.NoSuchMethodException
    +
    Build a StructuredArray according to the information captured in this builder
    +
    Returns:
    A newly instantiated StructuredArray
    +
    Throws:
    +
    java.lang.NoSuchMethodException - if the array constructor or element constructor fail to resolve given + the current information in the builder
    @@ -350,15 +531,34 @@

    build

  • getArrayModel

    public StructuredArrayModel<S,T> getArrayModel()
    +
    Get the StructuredArrayModel that describes the arrays built by this builder
    +
    Returns:
    The StructuredArrayModel that describes the arrays built by this builder
    +
  • + + + + + - + @@ -368,6 +568,12 @@

    getSubArrayBuilder

  • getArrayCtorAndArgs

    public CtorAndArgs<S> getArrayCtorAndArgs()
    +
    Get the CtorAndArgs describing the constructor and arguments used to instantiate arrays with + this builder. May be null if non of arrayCtorAndArgs, + resolve() or + build() have been called yet.
    +
    Returns:
    The CtorAndArgs describing the constructor and arguments used to instantiate arrays with + this builder.
  • @@ -377,6 +583,14 @@

    getArrayCtorAndArgs

  • getElementCtorAndArgsProvider

    public CtorAndArgsProvider<T> getElementCtorAndArgsProvider()
    +
    Get the CtorAndArgsProvider which provides the constructor and arguments used to construct + individual elements of arrays instantiated with this builder. May be null if non of + elementCtorAndArgsProvider, + elementCtorAndArgs(org.ObjectLayout.CtorAndArgs<T>), + resolve(boolean) or + build() have been called yet.
    +
    Returns:
    The CtorAndArgsProvider which provides the constructor and arguments used to construct + individual elements of arrays instantiated with this builder
  • @@ -386,6 +600,10 @@

    getElementCtorAndArgsProvider

  • getContextCookie

    public java.lang.Object getContextCookie()
    +
    +
    Returns:
    The (opaque) contextCookie object associated with this builder
  • @@ -402,8 +620,7 @@

    getContextCookie

    @@ -213,7 +229,7 @@

    StructuredArrayModel

    -
      +
      • StructuredArrayModel

        public StructuredArrayModel(java.lang.Class<S> arrayClass,
        @@ -223,6 +239,19 @@ 

        StructuredArrayModel

        Type Parameters:
        A2 - The class of the StructuredArray modeled by the subArrayModel
        T2 - The class of the elements in the StructuredArray modeled by the subArrayModel
        Parameters:
        arrayClass - The class of the StructuredArray modeled by the model
        subArrayModel - The model describing the structure of the elements of the array being modeled
        length - The length of the StructuredArray modeled by the model
      + + + +
        +
      • +

        StructuredArrayModel

        +
        public StructuredArrayModel(java.lang.Class<S> arrayClass,
        +                    PrimitiveArrayModel<A2> subArrayModel,
        +                    long length)
        +
        Create a model of a StructuredArray instance with elements that are themselves subclassable PrimitiveArrays
        +
        Type Parameters:
        A2 - The class of the PrimitiveArray modeled by the subArrayModel
        Parameters:
        arrayClass - The class of the StructuredArray modeled by the model
        subArrayModel - The model describing the structure of the elements of the array being modeled
        length - The length of the StructuredArray modeled by the model
        +
      • +
    @@ -254,7 +283,7 @@

    equals

    • getArrayClass

      -
      public java.lang.Class<S> getArrayClass()
      +
      public final java.lang.Class<S> getArrayClass()
      Get the class of the StructuredArray modeled by this model
      Returns:
      the class of the StructuredArray modeled by this model
    • @@ -265,7 +294,7 @@

      getArrayClass

      • getElementClass

        -
        public java.lang.Class<T> getElementClass()
        +
        public final java.lang.Class<T> getElementClass()
        Get the class of the elements in the StructuredArray modeled by the model
        Returns:
        the class of the elements in the StructuredArray modeled by the model
      • @@ -276,7 +305,7 @@

        getElementClass

        • getSubArrayModel

          -
          public StructuredArrayModel getSubArrayModel()
          +
          public final org.ObjectLayout.intrinsifiable.AbstractArrayModel getSubArrayModel()
          Get the model describing the structure of the elements of the array being modeled
          Returns:
          the model describing the structure of the elements of the array being modeled
        • @@ -287,7 +316,7 @@

          getSubArrayModel

          • getLength

            -
            public long getLength()
            +
            public final long getLength()
            Get the length of the StructuredArray modeled by the model
            Returns:
            The length of the StructuredArray modeled by the model
          • @@ -306,8 +335,7 @@

            getLength

            + + + +
              +
            • +

              getElementClass

              +
              public java.lang.Class<T> getElementClass()
              +
              Get the Class of elements stored in the array.
              +
              +
              Overrides:
              +
              getElementClass in class org.ObjectLayout.intrinsifiable.AbstractStructuredArray<T>
              +
              Returns:
              the Class of elements stored in the array.
              +
            • +
            @@ -568,20 +607,6 @@

            get

            java.lang.IllegalArgumentException
          - - - -
            -
          • -

            getElementClass

            -
            public java.lang.Class<T> getElementClass()
            -
            Get the Class of elements stored in the array.
            -
            -
            Overrides:
            -
            getElementClass in class org.ObjectLayout.intrinsifiable.AbstractStructuredArray<T>
            -
            Returns:
            the Class of elements stored in the array.
            -
          • -
          @@ -662,7 +687,8 @@

          shallowCopy

          + + + +
            +
          • +

            StructuredArrayBuilder

            +
            public StructuredArrayBuilder(StructuredArrayModel<S,T> arrayModel)
            +
            Constructs a new StructuredArrayBuilder object for creating arrays of the given array model.
            +
            Parameters:
            arrayModel - The model of the array to be built by this builder
            +
          • +
          @@ -499,13 +516,13 @@

          contextCookie

        • resolve

          public StructuredArrayBuilder<S,T> resolve()
          -                                                               throws java.lang.NoSuchMethodException
          + throws java.lang.IllegalArgumentException
          Resolve any not-yet-resolved constructor information needed by this builder. Calling resolve() is not necessary ahead of building, but it is useful for ensuring resolution works ahead of actual building attempts.
          Returns:
          This builder
          Throws:
          -
          java.lang.NoSuchMethodException - if the array constructor or element constructor fail to resolve given +
          java.lang.IllegalArgumentException - if the array constructor or element constructor fail to resolve given the current information in the builder
        @@ -516,11 +533,11 @@

        resolve

      • build

        public S build()
        -                                   throws java.lang.NoSuchMethodException
        + throws java.lang.IllegalArgumentException
        Build a StructuredArray according to the information captured in this builder
        Returns:
        A newly instantiated StructuredArray
        Throws:
        -
        java.lang.NoSuchMethodException - if the array constructor or element constructor fail to resolve given +
        java.lang.IllegalArgumentException - if the array constructor or element constructor fail to resolve given the current information in the builder
      @@ -620,7 +637,8 @@

      getContextCookie