assoc.c File Reference

Simple associvative map operator definitions. More...

#include <sys/types.h>
#include <stdlib.h>
#include <string.h>
#include "rnr/rnrconfig.h"
#include "rnr/dliststr.h"
#include "rnr/log.h"
#include "rnr/new.h"
#include "rnr/assoc.h"

Go to the source code of this file.

Functions
int	NvpName2Val (Nvp_T tbl[], size_t nTblEntries, const char *sName)
	Get the value associated with the name. More...
const char *	NvpVal2Name (Nvp_T tbl[], size_t nTblEntries, int iVal)
	Get the name associated with the value. More...
void *	AssocMapVoidXtoY (AssocMapVoidMapper_T *pMapper, void *px)
	Get the y value associated with the given x value. More...
void *	AssocMapVoidYtoX (AssocMapVoidMapper_T *pMapper, void *py)
	Get the x value associated with the given y value. More...

Detailed Description

Simple associvative map operator definitions.

These associative maps are composed of tables (vectors) of discrete (x, y) points where the x and y may be of any data types.

Package

RoadNarrows Robotics Common Library 1

Library

librnr

File

assoc.c

Author

Robin Knight (robin.nosp@m..kni.nosp@m.ght@r.nosp@m.oadn.nosp@m.arrow.nosp@m.s.co.nosp@m.m)

Copyright

© 2005-2018. RoadNarrows LLC..
http://www.roadnarrows.com
All Rights Reserved

License

MIT

EULA

See the README and EULA files for any copyright and licensing information.

—

Definition in file assoc.c.

Function Documentation

void* AssocMapVoidXtoY	(	AssocMapVoidMapper_T *	pMapper,
		void *	px
	)

Get the y value associated with the given x value.

The table search terminates at the first match or at the end of the table.

Parameters

pMapper	Associative map mapper container.
px	Pointer to X value in table to find.

Returns

The associated y value on success, or the default y value if no x value is found.

Definition at line 123 of file assoc.c.

References CHKPTR, AssocMapVoidMapper_T::m_opXCmp, AssocMapVoidMapper_T::m_pMapDft, AssocMapVoidMapper_T::m_tblAssocMap, AssocMapVoidMapper_T::m_tblSize, NULL, AssocMapVoidPoint_T::x, and AssocMapVoidPoint_T::y.

{
  size_t i;

  CHKPTR(pMapper, NULL);
  CHKPTR(pMapper->m_tblAssocMap, NULL);
  CHKPTR(pMapper->m_pMapDft, NULL);

  if( pMapper->m_opXCmp == NULL )
  {
    return pMapper->m_pMapDft->y;
  }

  for(i=0; i<pMapper->m_tblSize; ++i)
  {
    if( pMapper->m_opXCmp(pMapper->m_tblAssocMap[i].x, px) == 0 )
    {
      return pMapper->m_tblAssocMap[i].y;
    }
  }
  return pMapper->m_pMapDft->y;
}

void* AssocMapVoidYtoX	(	AssocMapVoidMapper_T *	pMapper,
		void *	py
	)

Get the x value associated with the given y value.

The table search terminates at the first match or at the end of the table.

Parameters

pMapper	Associative map mapper container.
py	Pointer to Y value in table to find.

Returns

The associated x value on success, or the default x value if no y value is found.

Definition at line 159 of file assoc.c.

References CHKPTR, AssocMapVoidMapper_T::m_opYCmp, AssocMapVoidMapper_T::m_pMapDft, AssocMapVoidMapper_T::m_tblAssocMap, AssocMapVoidMapper_T::m_tblSize, NULL, AssocMapVoidPoint_T::x, and AssocMapVoidPoint_T::y.

{
  size_t i;

  CHKPTR(pMapper, NULL);
  CHKPTR(pMapper->m_tblAssocMap, NULL);
  CHKPTR(pMapper->m_pMapDft, NULL);

  if( pMapper->m_opYCmp == NULL )
  {
    return pMapper->m_pMapDft->x;
  }

  for(i=0; i<pMapper->m_tblSize; ++i)
  {
    if( pMapper->m_opYCmp(pMapper->m_tblAssocMap[i].y, py) == 0 )
    {
      return pMapper->m_tblAssocMap[i].x;
    }
  }
  return pMapper->m_pMapDft->x;
}

int NvpName2Val	(	Nvp_T	tbl[],
		size_t	nTblEntries,
		const char *	sName
	)

Get the value associated with the name.

The table search terminates at the first match or at the end of nTblEntries entries.

Parameters

tbl[]	Name-Value Pair table
nTblEntries	Number of name-value pair table entries
sName	Name to in table to find.

Returns

The associated value on success, or the first (default) value in the table if the no name match is found.

Definition at line 64 of file assoc.c.

References CHKEXPR_ULONG, and Nvp_T::m_iVal.

Referenced by OptsCvtArgLogLevel(), and test_assoc().

{
  size_t i;

  CHKEXPR_ULONG(nTblEntries, (nTblEntries > 0), 0);

  for(i=0; i<nTblEntries; ++i)
  {
    if( !strcmp(tbl[i].m_sName, sName) )
    {
      return tbl[i].m_iVal;
    }
  }
  return tbl[0].m_iVal;
}

const char* NvpVal2Name	(	Nvp_T	tbl[],
		size_t	nTblEntries,
		int	iVal
	)

Get the name associated with the value.

The table search terminates at the first match or at the end of nTblEntries entries.

Parameters

tbl[]	Name-Value Pair table
nTblEntries	Number of name-value pair table entries
iVal	Value in table to find.

Returns

The associated name on success, or the first (default) value in the table if the no value match is found.

Definition at line 94 of file assoc.c.

References CHKEXPR_ULONG, and Nvp_T::m_sName.

Referenced by AddNewBody(), PrintBody(), test_assoc(), and units_shortname().

{
  size_t i;

  CHKEXPR_ULONG(nTblEntries, (nTblEntries > 0), 0);

  for(i=0; i<nTblEntries; ++i)
  {
    if( tbl[i].m_iVal == iVal )
    {
      return tbl[i].m_sName;
    }
  }
  return tbl[0].m_sName;
}