c
/
gravity-lang
mirror of https://github.com/marcobambini/gravity.git


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150
							<html>
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Gravity: Map</title>
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/normalize/5.0.0/normalize.min.css" />
    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css">
    <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700,800">
    <link rel="stylesheet" href="scripts/highlight/styles/github-gist.css">
    <link rel="stylesheet" href="stylesheets/styles.css">
  </head>
  <body>

	<!-- BEGIN NAVIGATION BAR -->
	<nav class="navbar navbar-default navbar-fixed-top">
		<div class="container">
		<div class="navbar-header">
			<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
				<span class="sr-only">Toggle navigation</span>
				<span class="icon-bar"></span>
				<span class="icon-bar"></span>
				<span class="icon-bar"></span>
			</button>
			<a class="navbar-brand" href="http://gravity-lang.org"><img src="images/logo.png" width="32px" height="36px"></a>
		</div>
		<div id="navbar" class="navbar-collapse collapse">
			<ul class="nav navbar-nav navbar-right">
				<li class="active"><a href="index.html">Gravity</a></li>
				<li><a href="internals/index.html">Internals</a></li>
				<li><a href="https://github.com/marcobambini/gravity">GitHub</a></li>
			</ul>
		</div><!--/.nav-collapse -->
	</div>
	</nav>
	<!-- END NAVIGATION BAR -->

	<div class="container body-container">
		<div class="main-content">
			<div class="row">
       	
       		<!-- BEGIN SIDEBAR -->
       		<div class="col-sm-3 border-right section-left">
				<div saveheight="1" class="sidebar-nav">
				<h4>INTRODUCTION</h4>
				<ul>
					<li><a href="index.html"><span>Introduction</span></a></li>
					<li><a href="getting-started.html"><span>Getting Started</span></a></li>
				</ul>
				<h4>LANGUAGE GUIDE</h4>
				<ul>
					<li><a href="syntax.html"><span>Syntax</span></a></li>
					<li><a href="operators.html"><span>Operators</span></a></li>
					<li><a href="types.html"><span>Types</span></a></li>
					<li><a href="lists.html"><span>Lists</span></a></li>
					<li><a href="maps.html" class="active"><span>Maps</span></a></li>
					<li><a href="enum.html"><span>Enum</span></a></li>
					<li><a href="functions.html"><span>Functions</span></a></li>
					<li><a href="closures.html"><span>Closures</span></a></li>
					<li><a href="classes.html"><span>Classes</span></a></li>
					<li><a href="control-flow.html"><span>Control Flow</span></a></li>
					<li><a href="loops.html"><span>Loops</span></a></li>
					<li><a href="fibers.html"><span>Fibers</span></a></li>
				</ul>
				<h4>ADVANCED</h4>
				<ul>
					<li><a href="api.html"><span>Embedding API</span></a></li>
					<li><a href="system.html"><span>System class</span></a></li>
					<li><a href="unit-test.html"><span>Unit test</span></a></li>
					<li><a href="contributing.html"><span>Contributing</span></a></li>
				</ul>
				</div>
			</div>
			<!-- END SIDEBAR -->

       		<div class="col-sm-9 border-left section-right">
         	<h1 class="section-header">Map</h1><hr>
			
			<p class="section-content">
			Maps are associative containers implemented as pairs each of which maps a key to a value.
			You can create a map by placing a series of comma-separated entries inside square brackets. Each entry is a key and a value separated by a colon:
			</p>
			<pre><code class="swift">
	// create a new map with 4 entries
	var d = ["Mark":1, "Andrew":2, "Paul":3, "Ross":4];
	
	// map has a count property
	var n = d.count;	// n is 4
	
	// create an empty map
	var map = [:];
			</code></pre>
			
			<h4 class="section-h4">Looking up values</h4>
			<p>You can access an element from a list by calling the subscript operator [] on it with the key of the element you want:
			</p>
			<pre><code class="swift">
	var names = ["Mark":1, "Andrew":2, "Paul":3, "Ross":4];
	names["Mark"];		// 1
	names["Andrew"];	// 2
			</code></pre>
			
			<h4 class="section-h4">Iterating elements</h4>
			<p>The subscript operator works well for finding values when you know the key you’re looking for, but sometimes you want to see everything that’s in the map. Since the Map class implements the iterator method (through the keys method), you can easily use it in a for loop:</p> 
			<pre><code class="swift">
	var people = ["Mark":1, "Andrew":2, "Paul":3, "Ross":4];
	for (var name in people.keys()) {
		System.print("Current name is " + name);
	}
			</code></pre>
			
			<h4 class="section-h4">Adding elements</h4>
			<p>An item can be added to a map by simply setting a key/value:</p>
			<pre><code class="swift">
	var people = ["Mark":1, "Andrew":2, "Paul":3, "Ross":4];
	people["Kiara"] = 5;	// people now contains the "Kiara" key with value 5
			</code></pre>
			
			<h4 class="section-h4">Removing elements</h4>
			<p>The remove method has been added to the map class as a conveniente way to remove keys:</p>
			<pre><code class="swift">
	var people = ["Mark":1, "Andrew":2, "Paul":3, "Ross":4];
	people.remove("Paul");
	people.remove("Ross");
	return people.count; // 2 is returned in this case
			</code></pre>
			
         	</div>
       	</div> <!-- /row -->
       </div> <!-- /main-content -->
     </div> <!-- /container -->

	<!-- BEGIN FOOTER -->
	<footer class="navbar-fixed-bottom">
		<div class="container footer">
			<p>
			</p>
		</div>
	</footer>
    <!-- END FOOTER -->
	
	<!-- Bootstrap JS -->
	<script src="https://code.jquery.com/jquery-1.12.4.min.js"></script>
	<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js"></script>
	
	<!-- Highlights JS -->
    <script src="scripts/highlight/highlight.min.js"></script>
    <script>hljs.initHighlightingOnLoad();</script>
    
	</body>
</html>