Initializing help system before first use

MapBuilder

Build a 1-dimensional map of columns or variables. More...

#include <xpress.hpp>

Public Member Functions

template<typename Iter0 , typename Iter0IsIterable = typename std::enable_if<xpress::is_iterable<Iter0>::value>::type>
  MapBuilder (Iter0 const &iterable1)
  Create a builder that will create a 1-dimensional map of columns or variables from the specified data.
 
auto  build (xpress::objects::XpressProblem *prob) -> std::unordered_map< K1, xpress::objects::Variable >
  Create variables as specified by this builder.
 
auto  build (XPRSProblem *prob) -> std::unordered_map< K1, int >
  Create columns as specified by this builder.
 
template<typename Func0 , typename Func0Invocable = typename std::enable_if<std::is_convertible<typename std::invoke_result<Func0,K1>::type,bool>::value>::type>
auto  withFilter (Func0 newFilter) -> MapBuilder< K1 > &
  Set a filter that selects elements.
 
auto  withLB (double newLb) -> MapBuilder< K1 > &
  Set a constant lower bound for all columns or variables.
 
template<typename Func0 , typename Func0Invocable = typename std::enable_if<std::is_convertible<typename std::invoke_result<Func0,K1>::type,double>::value>::type>
auto  withLB (Func0 newLb) -> MapBuilder< K1 > &
  Set a lower bound that depends on the index.
 
auto  withLimit (double newLimit) -> MapBuilder< K1 > &
  Set a constant limit for all columns or variables.
 
template<typename Func0 , typename Func0Invocable = typename std::enable_if<std::is_convertible<typename std::invoke_result<Func0,K1>::type,double>::value>::type>
auto  withLimit (Func0 newLimit) -> MapBuilder< K1 > &
  Set a limit that depends on the index.
 
template<typename Func0 , typename Func0Invocable = typename std::enable_if<std::is_convertible<typename std::invoke_result<Func0,K1>::type,std::optional<std::string>>::value>::type>
auto  withName (Func0 newName) -> MapBuilder< K1 > &
  Set a name that depends on the index.
 
auto  withName (std::optional< std::string > newName) -> MapBuilder< K1 > &
  Set a constant name for all columns or variables.
 
auto  withType (ColumnType newType) -> MapBuilder< K1 > &
  Set a constant type for all columns or variables.
 
template<typename Func0 , typename Func0Invocable = typename std::enable_if<std::is_convertible<typename std::invoke_result<Func0,K1>::type,ColumnType>::value>::type>
auto  withType (Func0 newType) -> MapBuilder< K1 > &
  Set a type that depends on the index.
 
auto  withUB (double newUb) -> MapBuilder< K1 > &
  Set a constant upper bound for all columns or variables.
 
template<typename Func0 , typename Func0Invocable = typename std::enable_if<std::is_convertible<typename std::invoke_result<Func0,K1>::type,double>::value>::type>
auto  withUB (Func0 newUb) -> MapBuilder< K1 > &
  Set a upper bound that depends on the index.
 

Detailed Description

template<typename K1>
class xpress::VariableBuilder::MapBuilder< K1 >

Build a 1-dimensional map of columns or variables.

Since
44.00

Constructor & Destructor Documentation

MapBuilder()

template<typename K1 >
template<typename Iter0 , typename Iter0IsIterable = typename std::enable_if<xpress::is_iterable<Iter0>::value>::type>
xpress::VariableBuilder::MapBuilder< K1 >::MapBuilder ( Iter0 const & iterable1 )
inline

Create a builder that will create a 1-dimensional map of columns or variables from the specified data.

Parameters
iterable1 Data for the builder.
Template Parameters
Iter0 Something that supports begin() and end() and contains values of type K1.
Since
44.00

Member Function Documentation

build() [1/2]

template<typename K1 >
auto xpress::VariableBuilder::MapBuilder< K1 >::build ( xpress::objects::XpressProblem * prob ) -> std::unordered_map<K1 ,xpress::objects::Variable>
inline

Create variables as specified by this builder.

Parameters
prob The problem in which to create the variables.
Returns
The generated variables.
Since
44.00

build() [2/2]

template<typename K1 >
auto xpress::VariableBuilder::MapBuilder< K1 >::build ( XPRSProblem * prob ) -> std::unordered_map<K1 ,int>
inline

Create columns as specified by this builder.

Parameters
prob The problem in which to create the columns.
Returns
The generated columns.
Since
44.00

withFilter()

template<typename K1 >
template<typename Func0 , typename Func0Invocable = typename std::enable_if<std::is_convertible<typename std::invoke_result<Func0,K1>::type,bool>::value>::type>
auto xpress::VariableBuilder::MapBuilder< K1 >::withFilter ( Func0 newFilter ) -> MapBuilder<K1>&
inline

Set a filter that selects elements.

Parameters
newFilter Element filter
Template Parameters
Func0 auto (K1) -> bool: Maps (K1) to bool.
Returns
Always returns this instance.
Since
44.00

withLB() [1/2]

template<typename K1 >
auto xpress::VariableBuilder::MapBuilder< K1 >::withLB ( double newLb ) -> MapBuilder<K1>&
inline

Set a constant lower bound for all columns or variables.

Parameters
newLb The lower bound for all columns or variables created by this builder.
Returns
Always returns this instance.
Since
44.00

withLB() [2/2]

template<typename K1 >
template<typename Func0 , typename Func0Invocable = typename std::enable_if<std::is_convertible<typename std::invoke_result<Func0,K1>::type,double>::value>::type>
auto xpress::VariableBuilder::MapBuilder< K1 >::withLB ( Func0 newLb ) -> MapBuilder<K1>&
inline

Set a lower bound that depends on the index.

Parameters
newLb The lower bound for all columns or variables created by this builder.
Template Parameters
Func0 auto (K1) -> double: Maps (K1) to double.
Returns
Always returns this instance.
Since
44.00

withLimit() [1/2]

template<typename K1 >
auto xpress::VariableBuilder::MapBuilder< K1 >::withLimit ( double newLimit ) -> MapBuilder<K1>&
inline

Set a constant limit for all columns or variables.

A limit specifies the bounds for semi-continuous/integer columns or variables and the limit for partial integer columns or variables. It does not apply to columns or variables of other types.

Parameters
newLimit The limit for all columns or variables created by this builder.
Returns
Always returns this instance.
Since
44.00

withLimit() [2/2]

template<typename K1 >
template<typename Func0 , typename Func0Invocable = typename std::enable_if<std::is_convertible<typename std::invoke_result<Func0,K1>::type,double>::value>::type>
auto xpress::VariableBuilder::MapBuilder< K1 >::withLimit ( Func0 newLimit ) -> MapBuilder<K1>&
inline

Set a limit that depends on the index.

A limit specifies the bounds for semi-continuous/integer columns or variables and the limit for partial integer columns or variables. It does not apply to columns or variables of other types.

Parameters
newLimit The limit for all columns or variables created by this builder.
Template Parameters
Func0 auto (K1) -> double: Maps (K1) to double.
Returns
Always returns this instance.
Since
44.00

withName() [1/2]

template<typename K1 >
template<typename Func0 , typename Func0Invocable = typename std::enable_if<std::is_convertible<typename std::invoke_result<Func0,K1>::type,std::optional<std::string>>::value>::type>
auto xpress::VariableBuilder::MapBuilder< K1 >::withName ( Func0 newName ) -> MapBuilder<K1>&
inline

Set a name that depends on the index.

Parameters
newName The name for all columns or variables created by this builder.
Template Parameters
Func0 auto (K1) -> std::optional<std::string>: Maps (K1) to std::optional<std::string>.
Returns
Always returns this instance.
Since
44.00

withName() [2/2]

template<typename K1 >
auto xpress::VariableBuilder::MapBuilder< K1 >::withName ( std::optional< std::string > newName ) -> MapBuilder<K1>&
inline

Set a constant name for all columns or variables.

Parameters
newName The name for all columns or variables created by this builder. This must be std::nullopt or a format string that will be invoked with the index as argument.
Returns
Always returns this instance.
Since
44.00

withType() [1/2]

template<typename K1 >
auto xpress::VariableBuilder::MapBuilder< K1 >::withType ( ColumnType newType ) -> MapBuilder<K1>&
inline

Set a constant type for all columns or variables.

Parameters
newType The type for all columns or variables created by this builder.
Returns
Always returns this instance.
Since
44.00

withType() [2/2]

template<typename K1 >
template<typename Func0 , typename Func0Invocable = typename std::enable_if<std::is_convertible<typename std::invoke_result<Func0,K1>::type,ColumnType>::value>::type>
auto xpress::VariableBuilder::MapBuilder< K1 >::withType ( Func0 newType ) -> MapBuilder<K1>&
inline

Set a type that depends on the index.

Parameters
newType The type for all columns or variables created by this builder.
Template Parameters
Func0 auto (K1) -> ColumnType: Maps (K1) to ColumnType.
Returns
Always returns this instance.
Since
44.00

withUB() [1/2]

template<typename K1 >
auto xpress::VariableBuilder::MapBuilder< K1 >::withUB ( double newUb ) -> MapBuilder<K1>&
inline

Set a constant upper bound for all columns or variables.

Parameters
newUb The upper bound for all columns or variables created by this builder.
Returns
Always returns this instance.
Since
44.00

withUB() [2/2]

template<typename K1 >
template<typename Func0 , typename Func0Invocable = typename std::enable_if<std::is_convertible<typename std::invoke_result<Func0,K1>::type,double>::value>::type>
auto xpress::VariableBuilder::MapBuilder< K1 >::withUB ( Func0 newUb ) -> MapBuilder<K1>&
inline

Set a upper bound that depends on the index.

Parameters
newUb The upper bound for all columns or variables created by this builder.
Template Parameters
Func0 auto (K1) -> double: Maps (K1) to double.
Returns
Always returns this instance.
Since
44.00

The documentation for this class was generated from the following file:
  • xpress.hpp

© 2001-2025 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.