.. _file_cif++_row.hpp:

File row.hpp
============

|exhale_lsh| :ref:`Parent directory <dir_cif++>` (``cif++``)

.. |exhale_lsh| unicode:: U+021B0 .. UPWARDS ARROW WITH TIP LEFTWARDS

Definition (``cif++/row.hpp``)
------------------------------


.. toctree::
   :maxdepth: 1

   program_listing_file_cif++_row.hpp.rst



Detailed Description
--------------------

The class :ref:`exhale_class_classcif_1_1row` should be an opaque type. It is used to store the internal data per row in a category. You should use :ref:`exhale_class_classcif_1_1row__handle` to get access to the contents in a row.

One could think of rows as vectors of :ref:`exhale_class_classcif_1_1item`. But internally that's not the case.

You can access the values of stored items by name or index. The return value of operator[] is an :ref:`exhale_struct_structcif_1_1item__handle` object.

:ref:`exhale_class_classcif_1_1category`&atom_site=my_db["atom_site"];
:ref:`exhale_class_classcif_1_1row__handle`rh=atom_site.front();

//byname:
std::stringname=rh["label_atom_id"].as<std::string>();

//byindex:
uint16_tix=atom_site.get_item_ix("label_atom_id");
assert(rh[ix].as<std::string()==name);


There some template magic here to allow easy extracting of data from rows. This can be done using :ref:`exhale_function_namespacecif_1ac3d9a984c107208b0abbabe5f9e05289` e.g.:

std::stringname;
floatx,y,z;

:ref:`exhale_function_namespacecif_1ac3d9a984c107208b0abbabe5f9e05289`(name,x,y,z)=rh.get("label_atom_id","cartn_x","cartn_y","cartn_z");


However, a more modern way uses structured binding:

constauto&[name,x,y,z]=rh.get<std::string,float,float,float>("label_atom_id","cartn_x","cartn_y","cartn_z");





Includes
--------


- ``array``

- ``cif++/item.hpp`` (:ref:`file_cif++_item.hpp`)



Included By
-----------


- :ref:`file_cif++_category.hpp`

- :ref:`file_cif++_condition.hpp`

- :ref:`file_cif++_iterator.hpp`

- :ref:`file_cif++_parser.hpp`




Namespaces
----------


- :ref:`namespace_cif`

- :ref:`namespace_cif__detail`


Classes
-------


- :ref:`exhale_class_classcif_1_1row`

- :ref:`exhale_class_classcif_1_1row__handle`

- :ref:`exhale_class_classcif_1_1row__initializer`


Functions
---------


- :ref:`exhale_function_namespacecif_1ac3d9a984c107208b0abbabe5f9e05289`