This file is indexed.

/usr/include/crystalspace-2.0/ivaria/keyval.h is in libcrystalspace-dev 2.0+dfsg-1build1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
/*
    Copyright (C) 2001 by Jorrit Tyberghein

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.

    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Library General Public License for more details.

    You should have received a copy of the GNU Library General Public
    License along with this library; if not, write to the Free
    Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/

#ifndef __CS_IVARIA_KEYVAL_H__
#define __CS_IVARIA_KEYVAL_H__

/**\file
 * Key/Value pair interface
 */

#include "csutil/scf.h"

struct iObject;
struct iSector;

/**
 * A Key Value pair. This object contains a 'key' string and one or more
 * 'value' strings.  Typically key value pairs are specified in map files
 * (using the \<key\> tag).  They allow a game developer to tag game specific
 * information to any Crystal Space object.
 * 
 * Main creators of instances implementing this interface:
 * - The main loader creates instances of this internally.
 *   
 * Main ways to get pointers to this interface:
 * - scfQueryInterface() from iObject instances you get by
 *   calling iObject::GetIterator() on iObject instances you
 *   get from CS objects (typically using QueryObject()).
 */
struct iKeyValuePair : public virtual iBase
{
  SCF_INTERFACE(iKeyValuePair, 2, 0, 1);

  /// Get the iObject.
  virtual iObject *QueryObject() = 0;

  /// Get the key string of the pair.
  virtual const char *GetKey () const = 0;

  /// Set the key string of the pair
  virtual void SetKey (const char* key) = 0;

  /**
   * Get a value string from the pair.
   */
  virtual const char *GetValue (const char* vname) const = 0;

  /**
   * Get the 'value' string of the pair. This
   * is the same as calling 'GetValue ("value")'.
   */
  virtual const char *GetValue () const = 0;

  /**
   * Set a value string of the pair.
   */
  virtual void SetValue (const char* vname, const char* value) = 0;

  /**
   * Set the value string of the pair. This
   * is the same as calling 'SetValue ("value", value)'.
   */
  virtual void SetValue (const char* value) = 0;

  /**
   * Get a list of the names of values in the pair.
   */
  virtual csRef<iStringArray> GetValueNames () const = 0;

  /**
   * Query whether this pair is an "editor-only" pair.
   * They're marked as such in world files and are normally not kept in
   * memory.
   */
  virtual bool GetEditorOnly () const = 0;
};

#endif // __CS_IVARIA_KEYVAL_H__