null_mutex.h File Reference

Zero-cost semantic placeholder for mutex_like synchronization. More...

#include <chrono>
#include "jh/conceptual/mutex_like.h"

Go to the source code of this file.

Classes
struct	jh::typed::null_mutex_t
	Semantic placeholder for mutex_like types. More...

Namespaces
namespace	jh::typed
	Aggregated entry point for lightweight typing and semantic placeholder utilities.

Variables
null_mutex_t	jh::typed::null_mutex
	Global constant instance of null_mutex_t.

Detailed Description

Zero-cost semantic placeholder for mutex_like synchronization.

Copyright

Copyright 2025 JeongHan-Bae <mastropseudo@gmail.com>
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Full license: GitHub

Author

JeongHan-Bae <mastropseudo@gmail.com>

Defines jh::typed::null_mutex_t — a fully concept-compatible, zero-overhead dummy mutex used to satisfy jh::concepts::mutex_like and related locking concepts.

This type provides all standard locking interfaces (lock(), unlock(), try_lock(), lock_shared(), etc.) as pure no-ops. All try_* functions always return true.

This type exists only for generic compatibility with mutex_like concepts. It carries no runtime state and performs no synchronization.

You should never create separate instances of this type. Always use the global constant jh::typed::null_mutex instead.

Typical usage:

auto s = jh::safe_from("text", typed::null_mutex);
// returns std::shared_ptr<jh::immutable_str>
jh::sync::const_lock guard(typed::null_mutex);  // No-op

Version

1.3.x

Date

2025